goodbuddy/docs/features/remote-host/runtime-checklist-validation.md

远程执行清单验证记录

日期：2026-09-18。对应 CL-P1、CL-P3、CL-P4；需求与统一契约见 执行清单设计。 本记录包含远程 Agent 到 Main Runtime 的事件验证，以及后续 Windows 完整桌面到 Linux CN 的安装、清单展示、保存、重启和取消验证；各阶段覆盖范围分别列出。

OC 实现与原生证据

共享 Linux x64 经 192.168.0.23 连接，使用已保存的 SSH 凭据和固定 Host Key。 未使用 VPN 路由，不计作第二台 Host。Agent 由当前源码构建到专用测试目录，复用该机 受管 Node 24.19.0 和签名 OC 包；manifest 与二进制 --version 均为 1.18.29。

真实模型按提示两次调用 todowrite：先写入一个 in_progress/high 条目，再写入 todos: []。未适配时两次工具均成功，ACP 只有 tool_call/tool_call_update， 没有 plan。上游同版本 acp/event.ts 也未处理 todo.updated，因此不能把 ACP 类型定义当作部署证据。

现有 opencode-subagent-plugin.ts 将精确原生 todo.updated 放入既有 ACP metadata， 由 Agent 原 Session 分派、operation 归属和 semantic transcript 传递。 acp-remote-runtime.ts 在工具截断之前消费该结构并校验 RuntimeChecklist。 原 Session 与当前 Prompt 不符、无效条目均不替换清单。工具活动保留；正文及泛化 工具名不触发更新。cancelled 原样保留，避免 ACP plan 只允许三种状态造成信息损失。 标准 OC plan.entries 的结构化转换也有测试，但本版本的真实成功路径使用插件原生事件。

共享 Host 结果

最终源码复验目录为 /root/tmp/gb-acp-recovery-4bLjbp，首次通过目录为 /root/tmp/gb-acp-recovery-SJbdZQ。首次清单抵达桌面运行时后，在其 semantic checkpoint 被消费前关闭 attach。随后恢复同一 controller、binding 和 operation，设置 remoteRecoveryOnly: true，没有再次提交 Prompt。

验证项	结果
原生清单新增	sequence 1，todo.updated，一个 in_progress/high 条目
未 ACK 清单重放	重连后仍为 sequence 1，内容相同
原生清空	sequence 5，todos: []，映射为 {source:'opencode',items:[]}
重连后完成	两份清单、工具活动和终态继续到达
额外模型调用	重连未重发 Prompt；该次总计 3 个真实 provider 请求
清理	Agent 停止后，测试目录所属残留进程 0；临时上传及运行目录已删除

更长条目、取消状态、非法输入、子 Session、标准空 plan、工具活动不重复生成清单、 相同 provenance 重放，由单元测试覆盖。远程真实模型的长清单、取消及连续多轮隔离 本次未实测，不能将单元测试记为真实 Host 验收。

一次较早的重放探测在 done 后才断开，之前已 ACK 的记录被正常裁剪，故不能从 sequence 0 重新读取整段历史。该次断言失败后，改为验证未 ACK 边界；产品未增加 历史快照或另一套重连机制。已 ACK 内容的恢复仍依赖 Main 已提交的消息。

另复现 OC 冷启动超过默认 15 秒控制超时：连续五次请求未进入 provider。 将 runtime/startPrompt 控制等待提高到至少 30 秒后，原生初始化、建会话和模型选择 完成。对应测试模拟 20 秒启动，确认仅提交一次 start；其他控制请求时限保持原设置。

模型调用口径

统计为测试 Agent 中实际向非 loopback provider 发出的 HTTP 请求，不将 ACP Prompt 次数、工具调用、内部 /session 路由请求或重连计作模型调用。读取已有 OC 模型配置， 测试未打印凭据或端点。

探测	实际模型请求
五次冷启动定位	0
提高启动等待后的原始 ACP 观察	3
输出工具状态、确认两次 todowrite 成功	3
插件接入后在 done 边界重放，断言失败	3
最终未 ACK 边界断线重放通过	3
最终源码再次复验未 ACK 边界	3
CN Linux 包与命令入口探测	0
合计	15

五次进入 provider 的 OC 探测均返回三个 HTTP 200；无受控假 provider 调用。

CN 部署与生命周期

已从 npm 获取固定 @continuedev/cli@1.5.47 工件，压缩包为 17,945,195 bytes， 并在 Host 校验 SHA-512：

gtpewV3RoIOD9dyTtKIBi1SY0VOHRu3Ehe7C/mmnswm+j34MPyrcQhQaWj/m+jdfGO4fNIKdrgGIlLso1ULDFw==

在 /root/tmp/gb-checklist-upload-44f47e99-94e2-4e35-8efb-ef80b7a830ca 解包， 以受管 Node 24.19.0 执行 dist/cn.js --version 得到 1.5.47；serve --help 确认 HTTP /state、/message 入口。acp --help 返回普通顶层帮助，并非 ACP 子命令；工件 src/index.ts 有 serve 注册、没有 acp 注册。探测未启动模型会话， 没有把包入口可运行记为远程 CN 功能完成。测试工件已从 Host 清理。 日志留存复验目录为 /root/tmp/gb-checklist-upload-424f412c-cf2a-4857-810f-48da03285821， 同样通过并清理，模型请求仍为 0。

以下为同日后续实施结果，取代最初调查时的未实现清单。

路径	当前实现
受管工件	lock 固定 @continuedev/cli@1.5.47、SHA-512 和 lib/continue/dist/cn.js；组包保存 payload、manifest、签名和许可文本
工件安装	Runtime 与复合 Agent 包校验接受 CN；桌面按 descriptor 的 Runtime ID 选择 payload，Host 复用 prepare/commit 和 Runtime registry
Agent 启动	continue-acp-helper.ts 在 Host 上复用 ContinueHostAdapter，启动 Node 驱动的 CN HTTP 宿主，对既有 Agent 提供 ACP Session 接口
模型桥	Main 选择 CN 模型 profile，Agent gateway 保留逐 operation 的模型配置；CN 请求携带 Session/operation 路由头，配置中使用桥接占位凭据
清单	宿主在原始参数层提取成功的 Checklist.checklist，经 _meta.goodbuddyChecklist 和原 semantic transcript 输出统一 checklist 事件
项目及聊天	创建、保存、安装激活、Main Runtime 工厂和聊天菜单均接受 CN；项目默认值与历史 CN 选择保持；安装身份必须匹配选择
生命周期	ACP cancel 取消本轮宿主，已有 attach、transcript/ACK 负责断线恢复；后续 Prompt 可在同一对话继续

最终复验目录为 /root/tmp/gb-cn-runtime-EALG99。开发复合包为 188,609,399 bytes， 使用临时签名身份和隔离 trust registry，没有更改应用或 Host 的正式信任配置。 桌面验包函数、Host prepare/commit、安装后 Agent bootstrap/health 与 CN runtime activate 均通过。随后当前源码 Agent 使用该安装得到的 CN payload 执行下列场景：

场景	实测结果
Execute 原生清单	sequence 3 为一个 pending 条目，sequence 6 为显式空列表
未 ACK 断线重连	同一 binding/operation 重放原 sequence 3，再收到空清单；不重发 Prompt
取消	新一轮产生清单后取消，Main 返回 RemotePromptCancelledError；清单不改写为完成
同对话续发	切换 Ask 后返回 RECOVERED，没有旧清单事件
回收	Agent 停止后测试所属进程 0；隔离目录和上传目录已删除

本轮实际向外部 provider 发出的 HTTP 请求数为 17：首次取消探针 5 次，修正探针对 预期取消异常的处理后 6 次，最终安装包复验 6 次。三轮分别取得 4、5、5 个 HTTP 200， 各有 1 次请求在取得响应前取消。安装探针的四次排错运行均为 0 次；重连没有额外提交。 此前已有 cn-runtime-live.log 记录过 3 次 CN 请求，属于接手前证据，不计入本轮 17 次， 也不并入上方原 OC 阶段的 15 次。本轮全部 CN 进程均运行于 Linux Host。

安装排错包括复用旧缓存时缺少 Koffi CJS 文件，以及探针把安装器 CLI 一起内联后污染 relay stdout。当前组包实现已包含 Koffi CJS 文件；探针改为单独导入安装器模块。 这些运行未进入模型。最终日志为临时目录中的 cn-runtime-live.log。

本阶段验证从 Main 受管 Runtime 工厂进入。后续完整桌面与联合开发包结果见下节。 CN 的 Linux arm64/macOS arm64 尚未实测；本轮没有提交或发布 Agent 包。

2026-09-19 联合包与完整桌面验收

默认 Agent 组包与 CI 构建已同时包含 OC 1.18.29、CN 1.5.47。描述符保留主 Runtime， 通过 additionalRuntimes 描述随包安装的 CN；目录、桌面验包、Host 安装和资源加载 均校验该列表。单 Runtime 包仍可读取，已有发布包无需迁移。联合包专项测试为 31 passed、1 skipped，包含生产安装器对单包及联合包的安装回归。

完整桌面使用当前生产 Main、Preload 和 Renderer，隔离 profile 与开发签名 registry， 保留 sandbox/context isolation。连接由既有凭据和固定 Host Key 到 192.168.0.23， 再转发至同机专属 SSH 服务；该服务将 HOME 限定在 /root/tmp/gb-joint-ui-2oQ87z/home。 本地 loopback 地址仅为 SSH 转发入口，CN 进程实际运行于 Linux。原生文件选择对话框 由测试驱动返回开发包路径；其后的导入、验签、传输和安装均走生产 IPC。

桌面完成联合包导入和“由 GoodBuddy 传输”安装后，通过实际项目表单创建 CN 远程项目， 选择 Execute，在真实输入框发送清单请求。两次 Checklist 更新后，顶部显示一项完成、 一项待办，工具活动仍可见；保存和退出重启后，原项目保留这两项状态。

重启续发首次实测失败：CN 内存原生会话已退出，但旧 ready binding 仍引用其 Session； 随后恢复同一个 start 请求又重复递增序号。修复后冷打开 CN ready binding 会从现有 对话历史新建原生会话，未确认 start 的恢复保持原 operation 和序号。相邻 4 文件 167 passed、1 skipped；新构建的真实桌面已验证重启续发成功、清单出现后点击停止、 取消条目仍为待办，以及随后返回 REMOTE_CN_RESUMED 且不显示旧轮清单。

测试启动器曾遗漏托盘资源，以及误清除托管 Node 所需的 ELECTRON_RUN_AS_NODE，导致 前一次构建未刷新产物；修复启动器后核对产物包含源码修复，再进行上述成功复验。 这两项是临时驱动问题。最初测试计数钩子未覆盖远端模型出口，改从隔离 Agent 的 model-calls.sqlite 读取 operation、dispatch 状态及取消结果，仅导出计数，不读取凭据。

首轮全量测试为 4707 passed、67 skipped、1 failed；失败为本地 OpenCode 压缩返回 compacted: false。随后单独复验该文件及远程 ACP、项目选择、顶部清单，共 136 passed。 不将专项复验写成一次全量全绿。类型检查和 lint 已通过。

完整桌面截图位于批准临时目录的 joint-cn-real-before-restart.png 和 joint-cn-cancelled.png，均已打开审阅。窗口中状态与内容对齐，取消后保留待办， 输入框仍可使用。UI 驱动为 joint-desktop.cjs、joint-scenario.ps1；共享 Host 及隔离 profile 由 joint-ui-host.ts 管理。

补充真实长清单测试收到 55 项、5,601 字符的条目正文，数据库读取数量和字符数一致。 随后成功调用空字符串清单，顶部隐藏；再次退出重启并打开原项目，保存的空数组仍有效， 没有复活旧清单。自动断言摘要保存在批准临时目录的 joint-final-evidence.json，覆盖 SSH 项目身份、CN 选择、长清单落库、取消保留待办、取消后续发和清空后的重启状态。

本轮新增模型请求以隔离 Agent gateway 调用账本为准，共 16 次，15 次 completed， 1 次 outcome-unknown/cancelled。三轮创建并更新两项清单分别 3 次；取消场景 2 次； 取消后续发 1 次；55 项长清单 2 次；清空 2 次。旧会话失败和启动排错未新增 gateway dispatch。本轮 16 次与上文 CN 17 次、早期 OC 15 次分别记录，不重复累计。

清理后已用原固定身份重新连接 Host，确认测试目录不存在、所属进程为 0；本地隔离 profile 及其加密测试凭据已删除。正式 Host 安装、应用配置和业务文件未改动。最终 typecheck、lint、差异检查通过。尚未执行 Linux arm64/macOS arm64 真机与多远程 会话同时生成清单的完整桌面矩阵；隔离与去重仍有定向测试覆盖，不据此扩大真机结论。

测试与复查路径

源码相邻测试：7 个文件，185 passed、6 skipped。覆盖 ACP Runtime、协议通道、 managed Runtime、原生插件、Agent-owned Prompt、ACP connection 和 model bridge。

npx vitest run src/main/agent/acp-remote-runtime.test.ts src/agent-daemon/opencode-subagent-plugin.test.ts src/main/remote-agent/protocol-remote-runtime-channel.test.ts src/main/remote-agent/managed-remote-acp-runtime.test.ts src/agent-daemon/agent-owned-acp-prompt.test.ts src/agent-daemon/agent-acp-connection.test.ts src/agent-daemon/model-bridge.test.ts
npm run typecheck
npm run lint

Typecheck、lint 通过。npm test 在 240 秒时超时，未得到全量完成结果；此前 src/renderer/src/App.test.tsx 两项 Magic Notes 测试因 pdfjs 的 DOMMatrix is not defined 失败。本次未修改该 Renderer 路径。

本机临时探测目录为 C:\Users\jiang\AppData\Local\Temp\opencode，保留这些脚本供复查：

• checklist-host-driver.ts：读取既有凭据、SSH 固定身份、部署源码 Agent、清单及断线断言。
• checklist-host-build.cjs、checklist-host-run.cjs：构建和 Electron 执行入口；--verify 跑 OC，--cn-only 跑 CN 无模型探测。
• checklist-host-daemon.ts：只记录原生 ACP 初始化阶段名称的诊断包装。
• checklist-cn-probe.cjs：CN 工件完整性与 Linux CLI 入口验证。
• 复用 acp-recovery-host-build.cjs、acp-recovery-host-daemon.ts 和 image-host-agent.ts，没有复制凭据文件。

最终 stdout 证据分别为该目录的 checklist-oc-final.log 和 checklist-cn-final.log。 文档审校扫描无阻断项；复核项为测试范围列举及必要的未验证边界，按事实保留。

构建顺序为先运行 acp-recovery-host-build.cjs，再运行 checklist-host-build.cjs， 最后运行 checklist-host-run.cjs --verify。真实 OC 探测会调用模型；早期 --cn-only 探测只检查 CN 入口，不调用模型。

后续 CN 全路径复验使用 cn-runtime-build.cjs 构建当前源码与临时签名复合包，再运行 checklist-host-run.cjs --continue --verify --lifecycle。该命令会发出真实模型请求， 与前述只运行 version/help 的 --cn-only 不同。cn-runtime-daemon.ts 在隔离 Home 调用桌面验包及 Host 安装器，验证 CLI 激活，然后使用当前源码 Agent 持有模型轮次； provider HTTP 请求计数在 Agent gateway 的外部 fetch 层完成。

后续专项验证：远程相关 27 个测试文件、374 项通过；新增 CN 复合包测试经过桌面完整 验包与生产安装器的 prepare/commit。全量运行完成，4665 passed、67 skipped、6 failed； 其中一项是运行期间新增 CN 测试尚未修正的归档名，随后专项复验通过。其余五项为 ActivityPanel.test.tsx 与 activity-store.test.ts 的引用复用断言，本轮未修改对应实现。 这两个文件在并行工作区继续更新后重新运行，39 项全部通过；全量运行中的失败项均已 经后续专项复验，但没有重新运行全部测试来取得同一最终快照的全绿报告。 最终另复验项目选择、顶部清单和安装管理 3 文件、41 项通过；App 远程 Runtime 选择与 继承 3 项通过。npm run typecheck、npm run lint 均通过。中文审校扫描阻断项为 0， 复核项为测试列举、请求数分项与必要验收边界，按事实保留。