核心功能
Publora Bluesky Skill 是专为 AT Protocol 生态设计的社交媒体发布工具,通过 Publora 中间件 API 实现与 Bluesky 平台的无缝对接。该 Skill 解决了 Bluesky 原生 API 较为复杂、 facets(富文本标记)处理繁琐的痛点,为开发者提供简洁的 RESTful 接口。
核心用法
1. 即时发布:通过 create-post 端点发送纯文本或带媒体内容
2. 定时调度:支持 ISO 8601 格式的 scheduledTime 参数实现预约发布
3. 媒体上传:分三步完成图片上传(创建帖子→获取上传 URL→PUT 上传),支持 JPEG/PNG/WebP/GIF/TIFF/BMP 格式自动转码
4. 自动 facets 生成:Publora 自动识别 #话题标签、@提及 和 URL,生成符合 AT Protocol 规范的字节级 facets,正确处理 emoji 和多字节字符
显著优点
- 开发友好:屏蔽 AT Protocol 复杂的 lexicon 和 facets 计算细节
- 格式兼容性强:自动将所有图片格式转为 JPEG,内置压缩建议(80-85% 质量)
- 多平台统一管理:与 Publora 其他平台 Skill 共享认证体系和调度逻辑
- 字节级精确处理:自动计算多字节字符偏移,避免 facets 错位导致的显示异常
潜在局限与风险
- 字符计数差异:Publora 的
content.length验证将链接计入 300 字符限制,而 Bluesky 原生排除链接 URL;需在撰写内容时预留冗余 - 无障碍支持缺陷:
altTexts参数被 API 静默忽略,图片替代文本只能通过 Publora Dashboard 手动添加 - 已知连接测试 Bug:
test-connection端点因验证逻辑错误始终返回失败,但不影响实际发帖功能 - 严格的媒体限制:单图 ~976 KB、视频 3 分钟/100 MB、日限 25 视频/10 GB,超出即失败
- 依赖中间件风险:Publora 服务可用性直接影响功能,且 API 变更可能存在滞后适配
适合人群
- 需要批量管理多平台社交媒体内容的运营团队
- 构建自动化内容分发系统的开发者(RSS 同步、博客交叉发布等)
- 希望快速集成 Bluesky 而无需深入 AT Protocol 技术细节的项目
常规风险提示
- 认证安全:必须使用 Bluesky App Password 而非主密码,建议定期轮换
- 速率控制:5 分钟 3000 请求的限制需客户端实现退避重试(429 处理)
- 视频上传前置条件:首次视频上传前需完成 Bluesky 邮箱验证
- DID 稳定性:平台 ID 绑定 DID(
bluesky-did:plc:xxx),账号迁移或 DID 变更需重新配置