Files
goodbuddy/docs/features/remote-host/README.md
T
mesalogo 83a48a4079 fix: reclaim idle remote runtimes and retire replaced agents
Remote tasks could leave idle Runtime processes behind, and replaced Agent
installations lacked a drain-and-exit lifecycle. Keep the current Agent
resident, let displaced Agents finish existing work and reconnect for its
results, then retire them without restarting obsolete installations.

Reclaim Runtime processes when their last active task finishes, preserve
pending questions and shared active tasks, and restore conversation history
when the next turn starts. Remove the Remote Projects technical preview label
from settings, errors, tests, and current documentation; the feature remains
disabled by default.

Validation recorded during implementation: 213 lifecycle tests and 28 focused
UI/IPC tests passed, as did SettingsPanel and lint. Linux x64 real-Host checks
used 8 provider requests. Broader tests and final typecheck encountered
unrelated concurrent changes; details and coverage limits are documented.

Release note: 远程任务结束后自动释放空闲运行进程,下一轮对话恢复历史;更新后的旧 Agent 等待已有任务完成再退出,当前 Agent 保持常驻。远程项目移除“技术预览”标识,仍默认关闭。
2026-09-23 17:37:14 +08:00

1.3 KiB

远程主机与远程执行

本功能负责 SSH Host 管理、Host Key、远程环境安装、GoodBuddy Agent、签名 Runtime、 远程 Workspace 和 Ask/Execute 生产路径。

文档导航

文档 权威职责
远程主机与 Agent 技术设计 当前产品语义、Agent、Runtime、Workspace、协议、生命周期和验证事实
远程环境准备技术设计 Host 下载、GoodBuddy 传输、安装事务、更新和恢复边界
执行清单验证记录 远程 OC/CN 原生清单、CN 开发包安装、取消及断线重放的实测结果与剩余验收

现有文档包含产品、功能逻辑和进度事实,后续修改远程功能时再按标准职责拆分。

跨会话共享 OpenCode 进程、ACP 连接与模型桥的实现设计,见 Runtime 进程复用技术设计。 当前实现尚未发布;验收状态见工作栏进度。

更新退役、任务完成后 Runtime 回收和下一轮历史恢复的当前源码验证,见 2026-09-23 生命周期验证。