fix: prevent managed runtime stalls during file changes

Automatic native Git snapshot diffs could block concurrent OpenCode sessions after broad rewrites or line-ending conversions. Managed desktop and Agent profiles now skip snapshots that GoodBuddy does not use, while preserving file tools, native subagents, workspace Git operations, and Ask/Execute rules. Drain otherwise-unused Continue utility-host stdout to prevent console output from filling the pipe and blocking requests. Correct the lifecycle regression's body observer to watch the underlying reader rather than a buffered wrapper. Prepare Desktop 0.12.10 and Agent 0.11.22 with aligned bilingual notes and feature documentation. Existing runtimes require restart or Agent update. Full desktop UI before/after and Linux Agent production-path checks passed; 3626 tests passed, with 61 existing platform/manual skips. Release note: 修复批量文件改写或换行转换后的托管 OpenCode 并行停顿，以及 Continue 控制台输出阻塞；本机升级重启后生效，远程项目请配套更新 Agent。
2026-09-09 03:07:55 +08:00
parent 177ab2140e
commit 5a77dfdb93
20 changed files with 198 additions and 28 deletions
@@ -9,7 +9,7 @@
 | [通用助手工作栏与执行空间 PRD](./prd.md) | 工作栏整体产品范围、执行空间和各工作面板归属 |
 | [多终端页签 PRD](./terminal-tabs-prd.md) | 多终端 Tab、目标选择、关闭确认和终端生命周期 |
 | [实现与验证进度](./progress.md) | 工作区与 Runtime 相关改动的实现事实、验证证据与剩余阻塞 |
-| [Runtime 交互边界](./runtime-interactions.md) | 原生权限、结构化问答、后台拒绝、终端交互及消息底部请求状态的适配范围 |
+| [Runtime 交互边界](./runtime-interactions.md) | 原生权限、结构化问答、后台拒绝、终端交互、托管 Runtime 并行与输出及消息底部请求状态的适配范围 |

 当前尚未拆出独立 User Stories、功能逻辑、UI 设计和技术设计文档；相关内容仍保留在
 两份现有 PRD 中，后续实际维护该功能时按职责拆分。
@@ -1,5 +1,35 @@
 # 工作栏实现与验证进度

+## 2026-09-09 托管 Runtime 并行阻塞
+
+- Windows 完整隔离测试程序通过界面发送 OpenCode 原生双子代理、直连与 Continue 文件
+  任务；随后三路上游请求在 917 ms 内发出并重叠，全部完成。普通并发没有复现全局排队。
+- 在同一程序中，让真实模型执行一次 4,000 行、约 98 KB 文件的 CRLF → LF 转换，
+  同时运行另一个会话。原生进程的无凭据存活探针两次延迟 3,301 ms、3,085 ms；
+  原生热线程持续使用 CPU，而 Main 没有同步满载。操作不是模拟事件或直接调用
+  Runtime 的脚本，模型请求来自实际输入框和发送按钮。
+- 托管 OpenCode 关闭未消费的自动 Git 快照后，完整程序重复相同操作和并行会话，
+  90 秒观察中的最大原生探针延迟为 210 ms，没有超过 500 ms 的探针，两条请求均完成。
+  该对照验证已复现的快照阻塞得到消除，不声称已经证明历史 90–125 秒事件的唯一原因。
+- Continue 的实际 Electron 原生宿主在不排空 stdout 时被注入的 128 KiB 输出阻塞；
+  使用当前生产适配器后，输出在 5 ms 内完成，20 次状态读取全部成功，最大 5 ms。
+  这证明管道修复有效，不代表普通启动约 640 字节的输出就是历史卡顿原因。
+- 修复版完整程序再次完成原生双子代理与 Continue 文件任务，实际请求重叠，三个页面
+  都通过计数按钮功能检查。Windows 诊断与程序验证合计 40 次成功模型调用；
+  另一次 UI 请求返回账户额度不足的 402，用户充值后才继续，没有把失败当成通过。
+- 当前源码 Linux x64 Agent 经桌面生产管理链路完成 Ask 读取和 Execute 换行转换，
+  共 4 次成功模型调用；最终原生配置确认 `snapshot: false` 且权限仍为 `ask`/`allow`。
+  此验证覆盖实际 Agent、模型桥、工具完成和关闭，不量化 Linux 提速，也未注入取消。
+- 定向回归先验证 7 项失败，再验证 124 项通过、5 项 Windows 平台跳过；
+  全项目类型检查和修改文件 lint 已通过。首次全量回归为 3625 通过、1 失败、61 跳过；
+  失败来自生命周期测试的包装流在底层 reader 关闭后仍计数为打开，已通过独立流实验
+  复现并改为观察 `reader.closed`，没有因此修改生产取消逻辑。最终候选全量回归为
+  3626 通过、0 失败、61 跳过，`npm run typecheck`、`npm run lint`、
+  `npm run release:notes:verify`、差异空白与文档相对链接检查通过。本机和远端的
+  测试进程已回收，安装版和正式 Host 环境未改动；正式发布仍需候选 CI 与资产核实。
+  运行策略见
+  [托管 Runtime 并行与输出](./runtime-interactions.md#托管-runtime-的并行与输出)。
+
 ## 2026-09-08 消息底部请求状态

 - 已接入本机 OpenCode 父会话的原生重试等待及开始事件；直连模型把退避等待与实际发起
@@ -22,6 +22,20 @@ ACP 已提供相同业务问答接口。
  使用其非交互参数，或由用户在终端完成；不能把权限确认和业务决策混为一谈。Shell
  工具保留其现有取消与超时，不新增日志解析或通用交互代理。

+## 托管 Runtime 的并行与输出
+
+- 本机和 Agent 管理的 OpenCode 启动配置都显式设置 `snapshot: false`。GoodBuddy 不消费
+  原生自动 Git 快照、快照差异摘要或快照撤销；关闭这条内部路径，避免大行级差异的同步
+  计算阻塞同一原生进程中的其他会话。
+- 文件工具、Shell、原生子代理、工作区 Git 状态和单文件差异保持可用；不新增全局会话
+  队列、请求重放或总执行截止时间。外部 OpenCode Server 的配置不由 GoodBuddy 改写，
+  已运行的旧原生进程也不会热更新配置。
+- Continue 使用 HTTP 传递响应和状态；Electron UtilityProcess 启动后持续排空不用展示的
+  stdout，避免控制台输出填满管道后阻塞宿主。stderr 的有界错误处理、请求取消与进程
+  回收保持不变，不把诊断输出复制进聊天或持久日志。
+- 远端最终启动配置由[远程主机技术设计](../remote-host/technical-design.md)定义，
+  模型桥生成最终配置时同样保留上述快照策略。
+
 ## 消息底部请求状态

 - 状态属于当前请求，不与顶部 Runtime 的连接中、就绪、不可用混为一谈。提交后先显示
@@ -2,7 +2,7 @@

 ## 状态

-本文记录截至 2026-09-05 的当前代码实现，不定义额外的信任框架。“新增 Host 只探测、Host 卡片手动准备
+本文记录截至 2026-09-09 的当前代码实现，不定义额外的信任框架。“新增 Host 只探测、Host 卡片手动准备
 Agent/Runtime、Host 直接从 GitHub/北京镜像下载、项目始终使用 Host current 环境”已经完成源码接线，
 详细事务与验收边界见
 [SSH Host 远程环境准备与直连下载设计](./environment-provisioning-technical-design.md)；
@@ -11,8 +11,9 @@ Agent/Runtime、Host 直接从 GitHub/北京镜像下载、项目始终使用 Ho
 Linux x64/arm64、取消和离线 GoodBuddy 传输的真实 Host 验收。
 Windows 到 Linux x64 的安装、Agent-owned Prompt、Agent 本地模型 gateway、断线恢复、
 同一 OpenCode Session 续接、取消和终态清理已经使用真实模型与工具验证。Agent
-`0.11.14` 已通过独立 workflow 发布 Linux x64/arm64 复合包和签名累计目录；当前未发布
-Agent 源码 lock 为已发布的 `0.11.21`，Desktop 候选为 `0.12.8`；本次桌面打包修复不重发 Agent。
+`0.11.14` 已通过独立 workflow 发布 Linux x64/arm64 复合包和签名累计目录；当前源码
+候选为 Agent `0.11.22`、Desktop `0.12.10`，包含托管 OpenCode 自动快照策略修复。
+正式发布状态以 Agent 与 Desktop 独立发布渠道为准。
 现有源码显示本地与远端 OpenCode 原生 Task，并取消 GoodBuddy 对生产 Prompt 的
 固定墙钟总时限。失败的 `agent-v0.11.3` 保持不可变且未发布。

@@ -67,6 +68,10 @@ Detached GoodBuddy Agent
 - Host 地址、用户或 Host Key generation 变化时关闭旧连接，并定向退役依赖旧 Host identity 的 Workspace 和 Runtime 会话。下一次选择使用 Host 管理的当前连接记录解析 current Agent/Runtime，不读取项目中的旧 revision 或组件 identity；当前 registry、连接或 capability 无效时才要求显式修复。

 ## Agent 安装与生命周期
+- 托管 OpenCode 的直接 ACP profile 与模型桥最终配置都设置 `snapshot: false`，避免
+  GoodBuddy 不使用的自动 Git 快照摘要阻塞原生执行；策略和保留的文件、Git、子代理能力
+  见 [Runtime 并行与输出边界](../assistant-workbar/runtime-interactions.md#托管-runtime-的并行与输出)。
+  此设置随新启动的 Agent Runtime 生效，不改写用户仓库或已运行进程的配置。

 - Agent bundle 通过 manifest、Ed25519 签名、payload digest、平台和架构校验。
 - 外层 `agent-package.json` 描述符上限为 4 MiB，覆盖包含 OpenCode 离线依赖的实际包
@@ -347,6 +352,14 @@ Execute 直接启动已签名 Runtime：

 ## Agent 开发期间的真实 Host 验证

+2026-09-09 已在隔离 Linux x64 Host 验证当前源码的快照配置修复：桌面
+`ManagedRemoteExecutionServices` 经 managed ACP、真实 detached Agent 和模型桥启动
+OpenCode `1.18.29`，Ask 完成原生读取，Execute 完成 4,000 行文件的 CRLF → LF 转换。
+4 次实际 Provider 请求全部为 HTTP 200，最终原生配置在两种模式均为 `snapshot: false`，
+权限仍为 `ask`/`allow`，transcript ACK 分别为 15/15 和 12/12。测试 Agent、模型桥、
+Runtime 与 relay 均已回收，原有 Host registry 未改变。这是实际链路和关闭验证，
+不是 Linux 前后性能对照，也未注入取消；不代替正式发布资产校验。
+
 任何会改变已部署 GoodBuddy Agent 或桌面到 Agent 生产链路的源码改动，都必须在开发期间
 使用共享 Linux x64 真实测试 Host 验证。适用范围包括 Agent daemon、Agent protocol
 及共享 contract、Agent 组包与安装、attach/update、Runtime 启动与进程归属、Workspace、