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 已完成。
• 任务协调阶段：类型检查、666 项全量测试及真实 Hermes 隔离协议验收通过。真实协议验证包含持久成员、组队、具体成员分派、成员不继承组队工具、管理员验收、目标完成、原会话结果及双管理员并发工具隔离。
• Web 验证任务状态、结果跳转和独立文字/附件草稿；iOS 验证任务进度、停止和结构化任务跳转；Android API 31 模拟器验证对应工作流。测试日志在本轮工具记录中，后续完整交付仍需重新核对最终代码。
• 下一阶段必须继续执行节点、受控 Worker、VM、临时助手、资源租约、文件/产物搬运、后台常驻、更新回退等未完成项。当前 App 安装包是桌面基础快照，不是最终完整平台交付。
• Runner 阶段：新增独立执行节点、管理员注册/配置下载/停用入口，以及打包 CLI。最终类型检查和 680 项全量测试通过（1 项真实协议测试按需跳过）；独立打包 Runner 的 13 项协议/CLI 测试通过；浏览器注册流程通过并核对桌面/窄屏截图。
• 单独启用 HERMES_TEAM_RUNNER=1 后，真实 Hermes 隔离协议验收通过，包含原生工具创建成员、组队、结构化分派、验收、完成、结果回传和双管理员工具隔离。执行细节和当前限制见 docs/runner.md。这是传输层验收，尚非 VM 或真实模型自主决策验收。
• 桌面 Runner 阶段：App 新增原生配置导入、系统加密存储、私有进程传参、自动启动与有界重连。开发 App 的 4 项生命周期/凭据测试通过；打包 arm64 App 的真实生命周期测试再次通过，覆盖配置导入、服务崩溃后的重新连接、窗口关闭保留连接、退出清理与再次打开自动连接。
• 此次打包验收使用 /tmp/yaoyao-runner-package-130917f/mac-arm64/夭夭.app，为临时 ad-hoc 签名测试包，严格签名检查通过。未替换 desktop-release 中较早的开发证书快照，也未安装、部署、公证或发布。服务全量 680 项通过；配置与 Runner 定向 23 项通过。