Publora Bluesky

核心用法

publora-bluesky 是基于 Publora 平台的 Bluesky 社交发布技能，允许用户通过 API 直接发布或定时推送内容到 Bluesky 去中心化社交网络。该技能采用 bluesky-did:plc:xxx 格式的平台 ID（非数字 ID），需配合 publora 核心技能完成认证配置。

主要功能

• 文本发布：严格 300 字符限制，超限即报错
• 图片支持：单帖最多 4 张图片（JPEG 优先，WebP 自动转码），支持 altTexts 无障碍描述
• 富文本自动解析：#hashtag 和 https://URL 自动转为 Bluesky AT Protocol 可点击 facets，无需手动计算字节偏移
• 定时发布：ISO 8601 格式 scheduledTime 字段支持未来时间排期

认证机制

• 必须使用 Bluesky 生成的 App Password（设置 → App Passwords），严禁使用主密码，符合 Bluesky 安全最佳实践
• 通过 x-publora-key API 密钥鉴权

典型工作流

1. 创建图文 post 获取 postGroupId
2. 每张图片单独调用 get-upload-url（共用一个 postGroupId）
3. 直传 S3 完成图片绑定

显著优点

• 协议层封装完善：自动处理 AT Protocol 复杂的字节偏移计算，开发者只需写纯文本
• 多图发布友好：altTexts 数组按位置映射，兼顾无障碍与内容结构化
• 安全合规：强制 App Password，避免主密码泄露风险

潜在局限与风险

• 无视频支持：当前版本仅支持图文，视频发布不可用
• 严格字符限制：300 字符硬顶，中文、英文、emoji 混合时需注意实际字节占用
• 多图上传繁琐：每张图需独立获取上传 URL，代码量较单层 API 多
• 平台绑定：完全依赖 Publora 服务可用性，存在第三方中转延迟或故障风险

适合人群

• 需要程序化管理 Bluesky 账号的内容创作者、SaaS 团队、社交媒体运营工具开发者
• 希望避免直接对接 AT Protocol 复杂性的快速集成场景

常规风险

• 密钥泄露：x-publora-key 与 Bluesky App Password 需妥善保管，建议环境变量注入
• 定时任务漂移：依赖 Publora 调度系统，极端情况下可能出现秒级延迟
• WebP 转码质量：自动转 JPEG 可能导致色彩偏移，对品牌色敏感需预检