yaoyao/docs/agent-platform-implementation.md

多 Agent、电脑环境与 macOS App 落地记录

目标：完成本线程确认的整体方案。macOS App、Web、执行节点和电脑服务源码共同维护在 hermes-yaoyao；移动客户端继续使用各自仓库。当前工作分支为 feat/bot-agent-teams。

本文用于保留完整范围和验收证据，不以某个局部功能完成代替整体完成。未经证据核对的项目保持待完成。

完整交付范围

桌面与服务

• macOS App 复用 Vue 界面，打包所需服务运行时，打开 App 自动启动或连接正确的服务。
• 单实例、数据目录独占、身份/版本验证；兼容已有服务，不误停外部实例。
• 关闭窗口保留任务、菜单栏恢复窗口、明确退出时安全停止自己管理的进程。
• Hermes 检测与托管、服务启动进度、可恢复错误、日志、崩溃恢复与睡眠唤醒核对。
• 可选后台常驻与开机启动；正常安装不强制开启。
• 本机凭据保护、受限桌面通信、受信任页面与外部页面隔离。
• arm64 App/安装包、签名完整性、更新与回退流程；公证和发布状态独立核实。

团队执行

• 基础自主创建 Agent、团队、启动和查询任务，以及按轮次授权（ac62d07）。
• 持久 Agent、临时助手、团队角色分离；记录创建来源与可恢复生命周期。
• 子任务负责人、依赖、验收条件、产物归属、结构化分派和计划调整。
• 成功/失败结果自动回到原会话，忙碌时排队；归档、停止、撤权后不复活旧任务。
• 区分执行结束与目标完成；复核、返工、等待用户、受阻状态可追踪。
• 持久投递与去重、重启修复、自动唤醒/递归/配额限制。
• Agent、桌面和共享写入资源的并发限制；取消只影响所属任务。

执行节点与电脑

• Hermes 侧 Runner、版本/能力协商、受控工具传输，覆盖默认 Docker 部署与远程节点。
• 权限取账号、Agent、任务、节点、电脑能力的交集；模型不能指定真实调用身份或凭据。
• 电脑 Provider 统一接口与离线一致性测试；Docker、Podman和远程节点支持。
• 独立电脑环境与受控 Hermes Worker；终端、文件、浏览器和子进程不会退回宿主执行。
• 按需启动、资源上限、持久工作区、浏览器资料、产物导出和空闲清理。
• 画面查看/控制分离、人工接管/交还、递增租约版本、旧请求拒绝。
• 环境重建、数据恢复、更新维护、在途操作不确定性处理。
• 可选可信团队共享环境、多桌面、独立浏览器资料及一致保存。
• 扩展提供商适配边界，能力不足时明确降级，不伪装为同等隔离。

跨端与验收

• Web、macOS、iOS、Android 共享权限/状态/事件协议，按平台提供入口和安全降级。
• 原始聊天展示回传结果、团队展示分派与产物、电脑面板支持查看与接管。
• 隔离环境下完成启动、重启、撤权、重复请求、并发、停止竞态和数据恢复测试。
• 真实打包 App 及真实电脑环境验收；脚本模型与真实模型证据分别记录。
• 所有实现以中文 Git 提交；正式服务部署、安装、公证和发布的状态明确区分。

实施顺序

1. 桌面托管与服务身份/生命周期基础。
2. 持久团队分派、结果回传与资源调度。
3. 执行节点及隔离电脑 Provider、Hermes Worker。
4. 共享桌面、跨端、后台服务、更新恢复及最终交付验收。

当前证据

• 起点：Web ac62d07，iOS 5908a2b；此前自主组队分支的验收见 docs/bot-agent-teams.md。
• 桌面基础：开发启动与打包后 App 均通过 desktop/lifecycle.test.mjs，实际测试服务启动、窗口关闭后存活、强制结束服务后的恢复、外部连接不误停服务、退出清理。
• 2026-09-08 首个桌面快照：arm64 App，开发证书签名；严格签名验证和 DMG 校验通过。DMG SHA-256：611995fea080455da3a87a561cb5a7465a70e7437a91b948d45ce346822b0095。这是阶段产物，尚未公证、发布或替换正式服务。
• 桌面基础对应服务全量测试 652 项通过；任务协调器正在继续实现，不能据此宣称后续任务或 VM 已完成。