多设备内容发布系统任务后台使用文档API 文档

开发节奏

开发节奏

开发会话处于活动状态时,主负责人按 TODO.md 推进范围明确的任务:检查现状、实现、验证、更新文档和待办。只有存在互不依赖的工作且能清晰分工时才委派;本次素材限额、缓存清理、任务超时和设备隔离均由主负责人实现与复核。

不会在服务器创建自动修改源码或无人值守编码的定时任务。所谓周期是开发会话内的工作分段,不代表 Codex 会话可在无用户输入时自动恢复。

周期 1 — Control Agent 和连接安全(完成)

  • 实现 HTTPS 向外轮询、逐节点 Bearer Token、任务 lease、素材下载和状态/附件回传。
  • 加入设备任务互斥、账号/平台映射校验、安全确认、macOS LaunchAgent 和 Windows 任务计划模板。
  • 增加安全 webhook 与基础后台文档。
  • Mac + vivo V2324A 的 ADB 传输任务在服务器完成,状态为 TRANSFER_TEST_PASSED。未启动平台 App、未发布内容。

周期 2 — Agent 素材限额和缓存保留(完成)

  • 限制每项素材 5 GiB、每任务总计 8 GiB、每任务最多 20 个素材;下载使用 .part 临时文件并在失败时删除本次部分文件。
  • 只清理超过 168 小时的成功、失败、取消和传输测试终态任务素材目录。
  • 不删除 NEEDS_HUMAN 诊断、截图、日志、数据库或服务器源素材;阻止缓存符号链接逃逸。
  • 自动测试:40 项通过;Mac 实机通过的是 ADB 传输,不是平台发布。

周期 3 — Agent 超时与设备隔离(完成)

  • 设置远程 UI 任务执行时限,并在每个 UI 步骤前后检查取消信号。
  • 超时报告 NEEDS_HUMAN,将设备隔离状态持久化到本机,并在 Dashboard 显示隔离原因。
  • 人工检查设备后,通过明确的本机命令解除隔离。
  • 默认时限 900 秒,保留 5 秒协作停止窗口;超时错误诊断上传,设备卡片显示隔离原因。
  • 自动测试覆盖超时状态、隔离持久化、心跳排除隔离设备、已置位取消信号在 UI 操作前阻止后续步骤。
  • 平台/Appium 实机流程尚未运行。若点击操作本身阻塞或超时,结果仍不确定,必须人工检查;Agent 不会自动重试。

周期 4 — UI 异常识别与状态审计(下一项)

  • 在每个操作前检查页面层级,识别登录失效、验证码、人脸验证、风控和异常弹窗。
  • 校验服务端任务状态转换和重试上限,记录可追踪的状态审计事件。

后续范围见 TODO.md。所有真实平台 App 操作都需要授权测试设备上的实测;模拟成功不视为真实发布成功。