核心用法
Publora Twitter Skill 是专为 X/Twitter 平台设计的 API 集成工具，基于 Publora 基础设施提供完整的推文发布与调度能力。
基础功能
- 即时发布：通过
create-post端点发送单条推文，需配置x-publora-key头部认证 - 定时调度：支持 ISO 8601 格式的
scheduledTime参数，实现未来时间自动发布 - 线程管理：自动识别超长内容并智能拆分，提供三种拆分模式：
- 自动段落/句子拆分（带
(1/N)标记） - 手动
---分隔符精确定义切分点 - 显式
[n/m]标记保留原有格式
媒体处理
- 图片：最多 4 张，单张 5MB，自动转换为 PNG（宽度上限 1000px）
- 视频：MP4/MOV 格式，120秒/512MB 限制（⚠️ 比原生应用 2:20 更严格）
- 线程限制：仅首条推文可附带媒体，后续为纯文本
字符计算规则
- 标准字符 = 1
- Emoji = 2 字符
- URL = 字面长度（不应用 Twitter 的 23 字符缩短规则）
- Premium 账户自动识别 25,000 字符扩展限制
显著优点
| 优势 | 说明 |
|------|------|
自动化工作流 | 与 Publora 工作区/Webhook 深度集成，支持跨平台内容同步 |
智能拆分 | 语义级线程切分，保持段落完整性优于机械截断 |
格式统一 | 自动图片转 PNG 避免兼容性问题 |
Premium 感知 | API 自动适配账户类型，无需手动配置字符限制 |
潜在缺点与局限性
硬性限制
- ❌ Starter 计划不可用 — Twitter/X 强制要求 Pro/Premium 订阅
- 🔒 视频 120 秒上限（API 层限制，不可绕过）
- 🚫 URL 不缩短导致字符消耗高于原生体验
- 📛 线程中媒体仅首条可用，限制视觉叙事连续性
设计约束
- 图片强制转换可能损失 JPEG 质量优势场景
- Emoji 双字符计数对视觉密集型内容构成隐形限制
- GIF 被归类为视频而非图片，需遵循视频容量规则
适合人群
- SaaS/产品团队：build-in-public 策略的自动化执行
- 内容创作者：多平台同步发布的 Twitter 端点
- 社群运营：定时活动预告、AMA 线程管理
- 开发者工具集成：需要将发布能力嵌入自有产品的技术团队
常规风险
| 风险类型 | 具体场景 | 缓解建议 |
|----------|----------|----------|
认证泄露 | sk_YOUR_KEY 硬编码或日志暴露 | 使用环境变量/密钥管理服务 |
计划误配 | Starter 用户调用导致权限错误 | 集成前验证订阅状态 |
视频失败 | 2:00-2:20 区间视频被 API 拒绝 | 预处理阶段强制 120s 截断校验 |
字符溢出 | URL 未缩短导致意外截断 | 本地预计算时采用字面长度规则 |
时区混淆 | scheduledTime 未使用 UTC | 强制 Z 后缀或明确时区转换 |
> 集成建议：生产环境建议配合 Publora 的 webhook 回执实现发布状态闭环监控，避免静默失败。