核心用法
publora-bluesky 是 Publora 平台针对 Bluesky（AT Protocol）的 API 封装技能，允许用户通过程序化方式发布或定时推送内容到 Bluesky 社交网络。
主要功能：
- 发布纯文本帖文（Skeet）：支持最多 300 字符，链接不计入字数限制
- 定时发布：通过
scheduledTime参数实现未来时间点自动发布 - 多媒体支持：最多 4 张图片（单张 ≤1MB，JPEG/PNG/WebP，最大 2000×2000px），或 3 分钟视频（≤100MB，MP4 格式）
- 智能识别：自动检测 #话题标签、@提及 和 URL，生成符合 AT Protocol 的 facets
认证方式：需先在 Publora 仪表板连接 Bluesky 账号，使用 应用专用密码（App Password）而非主密码，获取 DID 格式的平台 ID（如 bluesky-did:plc:abc123），并以 x-publora-key: sk_YOUR_KEY 请求头调用 API。
---
显著优点
| 优势 | 说明 |
|------|------|
| 链接不计字数 | 300 字符限制仅针对纯文本，URL 可完整保留 |
| 自动 facets 生成 | 无需手动处理 AT Protocol 的复杂数据结构 |
| 严格的媒体规范前置 | 明确的 1MB/图、2000px 尺寸限制，减少上传失败 |
| 标准 REST API | 与 Publora 其他平台接口一致，降低多平台接入成本 |
---
潜在缺点与局限性
- 图片压缩要求高：1MB 硬限制对高质量摄影内容不友好，需预处理
- 视频需邮箱验证：首次上传视频前必须完成 Bluesky 邮箱验证
- 速率限制：3000 请求/5 分钟，高频运营需注意队列管理
- 平台生态较新：Bluesky 功能迭代快，API 行为可能随协议更新变化
- 依赖 Publora 服务层：非直连 AT Protocol，Publora 服务中断会影响可用性
---
适合人群
- 需要在 Bluesky 批量发布或跨平台同步内容的社交媒体运营者
- 构建自动化内容工作流的开发者/技术团队
- 已将其他平台（Twitter/X、LinkedIn 等）接入 Publora 的多平台用户
---
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|----------|----------|----------|
| 认证泄露 | API Key 或 App Password 硬编码泄露 | 使用环境变量/密钥管理器，定期轮换 |
| 内容违规 | 自动化发布违反 Bluesky 社区准则 | 加入内容审核层，避免敏感话题自动发布 |
| 速率超限 | 429 错误导致发布中断 | 实现指数退避重试机制 |
| 媒体处理失败 | 图片>1MB 或视频格式不符导致 `JOB_STATE_FAILED` | 上传前严格校验文件大小与格式 |
| 第三方依赖 | Publora 服务可用性风险 | 监控 API 健康状态，准备降级方案 |