文档目录 5 / 9
ICEONIX 文档 05 / 09

平台发布与任务队列

冰爪使用本机 Safari 完成上传、填表、提交与结果验证。App 是唯一控制 Safari 的执行端;来自界面、Hermes、CLI 或 MCP 的任务都会进入同一个本地持久化队列,串行执行。

当前视频平台

以下视频发布链路已经端到端验证并持续维护:

  • 微信视频号
  • 抖音
  • 小红书
  • B站
  • 快手
  • YouTube

图文驱动已覆盖多个平台,但不同平台的限制和成熟度不同。微信公众号文章只上传到草稿箱,最终群发必须在公众号后台人工确认。

发布前检查平台登录

  1. 打开“社交平台”。
  2. 点击目标平台的“点击检测”或“检查更新”。
  3. 需要登录时点击“立即登录”,在 Safari 完成扫码或验证。
  4. 回到冰爪,确认状态为“已就绪”。

平台页面改版、Cookie 过期或异地验证都可能让登录失效。冰爪会定时检查状态,也可以手动“立即检查”。

手动发布视频

  1. 点击 App 中的“发布”。
  2. 选择本地视频。
  3. 填写标题、通用文案和最多四个标签。
  4. 选择目标平台。
  5. 根据平台填写原创、B站分区与声明,以及抖音、小红书、快手内容声明。
  6. 检查确认对话框后提交。

任务会先创建为本地项目,再进入队列。多平台任务按平台串行执行;一个平台失败不会覆盖其它平台的成功结果。

平台专属字段

项目可以保存通用字段和平台专属字段,包括:

  • 通用标题、正文、标签和原创声明
  • 每个平台独立文案
  • B站分区、创作声明、转载 / 自制类型和合集
  • 抖音、小红书、快手内容声明
  • 合集 / 系列预设与集数

发布前仍应在预览和确认界面核对平台要求。平台后台临时新增的低频字段不一定由冰爪自动处理。

dry-run 测试模式

开启全局 dry-run 后,任务会完成登录检查、打开 Safari、上传文件和填写字段,但跳过最终发布点击。它适合:

  • 首次安装后验证权限
  • 平台页面改版后回归
  • 检查标题、文案、声明和分区映射
  • Agent 自动化正式执行前预演

dry-run 仍会把素材上传到平台编辑页面;不要拿无权使用的内容测试。

队列状态

状态含义与操作
等待确认任务需要用户确认后才能继续
已计划等待设定时间
排队中等待唯一执行器领取,可置顶、暂停或取消
已暂停保留任务但不执行,可继续或取消
执行中正在控制 Safari,可查看当前平台和步骤
部分成功一些平台成功、一些失败,可只重试未成功平台
已阻塞 / 失败修正权限、登录或字段后重试
需要检查执行被意外中断,必须先人工核对平台结果
已完成 / 已取消可从最近任务中移除记录

“需要检查”为什么不能自动重试

如果 App、Safari、网络或 Mac 在最终提交附近中断,冰爪无法确定平台是否已经收到发布请求。此时自动重试可能造成重复内容。

处理方法:

  1. 打开涉及的平台创作者后台。
  2. 检查内容是否已经提交、审核中或发布成功。
  3. 确认未完成后,回到队列点击“已检查,重试未完成平台”。
  4. 如果已完成,则不要再次提交;按实际结果整理项目状态。

普通失败和部分成功的“重试”只领取未成功平台,成功平台不会重复发布。

定时与自动监测

  • App 项目和 iceonix.json 可以使用冰爪本地定时与发布时间窗口。
  • Hermes 创建的未来任务由 Hermes 到点后调用,冰爪收到后立即执行或排队。
  • iCloud 自动监测默认关闭,只有你主动开启后才会扫描 status: ready 项目。

发布时不要同时操作同一个 Safari 标签页,也不要让另一个自动化工具控制 Safari。