release: prepare Desktop 0.15.2 and Agent 0.15.0
Cross-platform packages / Validate source (push) Canceled after 0s
Cross-platform packages / Authorize desktop packaging (push) Canceled after 0s
Cross-platform packages / linux arm64 (push) Canceled after 0s
Cross-platform packages / macos arm64 (push) Canceled after 0s
Cross-platform packages / windows arm64 (push) Canceled after 0s
Cross-platform packages / linux x64 (push) Canceled after 0s
Cross-platform packages / macos x64 (push) Canceled after 0s
Cross-platform packages / windows x64 (push) Canceled after 0s
Cross-platform packages / Publish GitHub and OSS release (push) Canceled after 0s
GoodBuddy Agents / Validate Agent source (push) Canceled after 0s
GoodBuddy Agents / Build darwin arm64 Agent (push) Canceled after 0s
GoodBuddy Agents / Build linux arm64 Agent (push) Canceled after 0s
GoodBuddy Agents / Build linux x64 Agent (push) Canceled after 0s

Add bilingual notes for Story Graph reads, full follow-up editing, note capture, diagnostics and website updates. Preserve published 0.15.1 history and include reviewed Host/cloud plans as explicitly unimplemented documentation. Agent remains 0.15.0 and requires Desktop 0.15.2. Typecheck, lint, notes and website validation passed; current-source Host runtime checks made four real model requests. User requested full-suite validation in CI rather than waiting for the interrupted local run.
This commit is contained in:
mesalogo
2026-09-28 12:55:10 +08:00
parent 0cdf04261a
commit 76e781a0a8
15 changed files with 325 additions and 16 deletions
+18 -6
View File
@@ -330,7 +330,7 @@ records are listed separately and do not introduce another feature status.
failure, Agent `SIGKILL`/restart, and recovery from a reopened Desktop SQLite
database. Successful tool START/END events appear exactly once, with no
Prompt, provider, or tool replay observed. The current Agent source lock is
`0.15.0`, paired with the current Desktop release candidate `0.15.1`; formal
`0.15.0`, paired with the current Desktop release candidate `0.15.2`; formal
publication status follows the separate Agent and Desktop
release channels. Previous macOS validation covered native package installation,
detached lifecycle, Attach, real Ask/Execute, and cancellation of tools in
@@ -920,15 +920,21 @@ records are listed separately and do not introduce another feature status.
### Open source, builds, and releases
- The current Desktop candidate is `0.15.1` and the Agent candidate is `0.15.0`, with
- The current Desktop candidate is `0.15.2` and the Agent candidate is `0.15.0`, with
OpenCode pinned to `1.18.29` and Continue to `1.5.47`. Publication status follows the independent
Desktop and Agent release channels.
- Desktop `0.15.1` carries forward the unpublished `0.15.0` Obsidian integration, conversation capture into Magic
Notes, and preview local native clients, plus knowledge, Supervisor, and UI
fixes. Schema 48 adds conversation-source metadata; older clients require a
complete pre-upgrade backup for rollback. Agent `0.15.0` requires Desktop
`0.15.1`, retains Node `24.19.0`, and updates remote telemetry opt-out and
`0.15.2`, retains Node `24.19.0`, and updates remote telemetry opt-out and
disabled Continue update-check behavior without adding remote client shortcuts.
- Desktop `0.15.1` completed all six native release targets and GitHub/OSS publication.
Desktop `0.15.2` adds read-only Story Graph tools and a fully editable
Supervisor follow-up message, simplifies note capture, and improves exit diagnostics.
Remote Story Graph requires the paired Agent `0.15.0`; planned Host and cloud
management applications remain unimplemented. Current candidate evidence is in the
[0.15.2 preparation record](./docs/development/release-preparation-0.15.2.md).
- Desktop `0.13.15` carries forward the unpublished `0.13.14` changes to paged Supervisor reviews and resume behavior,
native ripgrep searches, to-do layouts, and explicit remote follow-up after an
uncertain result. Database schema 47 requires a complete pre-upgrade backup
@@ -1031,9 +1037,15 @@ records are listed separately and do not introduce another feature status.
offline GoodBuddy transfer release acceptance. Until these gates pass, this
path must not be described as published or as having passed formal release
acceptance.
- [ ] **Multi-cloud remote sandbox Agents** (planned): Manages dedicated Linux
sandboxes through cloud-provider APIs and SSH Agents. Credentials remain in
Main, and high-risk control-plane operations receive separate confirmation.
- [ ] **Host and cloud environment management** (planned): Move host management
into App Center with a list/detail workspace. A sibling cloud application
reuses host connections and remote execution. The first-version adapter plan
covers AWS, Azure, Alibaba Cloud, Tencent Cloud, VMware vCenter / vSphere,
and ZStack, delivered in batches with real instance discovery, import, and
execution acceptance. Instance creation, start/stop, deletion, and network
orchestration follow later. Provider APIs are not implemented; existing cloud
servers can already be added manually when SSH requirements are met. See the
[product scope](./docs/features/remote-host/prd.md).
## Roadmap Principles
+5 -4
View File
@@ -52,7 +52,7 @@
- [x] **高效直连模型工作区工具**:直连模型使用随包 ripgrep 的原生参数发现文件和搜索内容,按行分页读取大型 UTF-8 文件,并在 Execute 中应用多文件补丁。Ask 限于工作区只读搜索和读取,Execute 按当前账号权限搜索;用户无需另行安装 ripgrep。搜索保留原生输出与退出码,大结果通过 `output_read` 完整续读,可处理的参数错误允许模型调整后继续。
- [x] **长上下文与工具输出分页**:历史消息、长回复和文档解析文本不再采用旧的固定截断限制。直连模型可分页续读已保存的搜索、命令和 Subagent 输出;所选模型的上下文窗口及传输边界仍然有效。
- [x] **OpenCode 与 Continue**:使用隔离子进程、环境变量白名单、统一配置、取消、启动与控制请求时限、有界流式输出和活动记录;共享进程回收逻辑保留 Windows 完整进程树终止,并对采用独立进程组的 POSIX 子进程执行组回收。聊天状态检查使用一次性探测 Runtime 并在返回后立即回收,不进入按模型与项目隔离的执行 Runtime 缓存;本机 GoodBuddy 管理的 OpenCode 在该被动检查中只确认所选路径和模型凭据,不启动用后即毁的 Server,设置中的显式连接测试和原生能力清单仍执行完整启动及健康检查,原生能力清单随后与首次实际请求复用同一个执行 Runtime,不再重复冷启动;执行 Runtime 仍按项目复用,但 OpenCode 配置依赖和按内容摘要生成的 Skill 快照在所有本机项目间全局复用,会话数据、工具输出及请求级 MCP 状态继续隔离。本机 GoodBuddy 管理的 OpenCode 只对同一会话内的请求保持顺序,不同会话即使属于同一项目也可并行,不同项目同样可并行;请求级动态 MCP 通过默认通配禁用和当前请求精确放行保持隔离。托管的本机和远端 OpenCode 跳过界面未使用的自动 Git 快照,避免同步差异计算拖住会话,文件工具、子代理与工作区 Git 差异保留;Continue 持续排空不用展示的宿主 stdout,防止控制台输出填满管道。这些调整随新启动的 Runtime 生效,不改写外部 OpenCode Server 配置。OpenCode 与 Continue 不再按固定工具调用数或活动数中止单次运行,已观察到的工具与 Subagent 活动全部保留在本地会话,不再在原生任务继续执行时丢弃后续详情。交互提问只由前台对话回答,定时任务、远程通道和委派等后台执行遇到提问时会立即失败并提示改为前台运行,避免无限等待。本机 OpenCode 启动时直接使用已选择的绝对路径,不预先检查文件或运行 `--version`,路径失效时由实际启动返回错误;托管 Linux ARM Host 激活 Runtime 时复用准备阶段已验证的 registry 和 manifest,不重新哈希或检查完整 OpenCode 二进制。
- [x] **托管 SSH OpenCode 与 Continue**:该能力由“设置 > 平台功能”中的独立“远程项目”页签控制并默认关闭;关闭时不影响本地项目、普通桌面功能或桌面发布。支持 Linux x64、Linux arm64 和 macOS arm64 Host,不支持 Intel Mac;通过 SSH 按需启动 detached Agent,不要求开机服务。Ask 在 Runtime 工具边界保持只读,Execute 使用所选 SSH 账号的完整权限。Agent 持有 Prompt、模型和工具轮次、Runtime 进程及语义 transcript,Desktop 断开后重新 Attach 原操作而不重发 Prompt;模型凭据仅在当前操作内存中使用,不写入 Renderer、SSH 参数、环境或磁盘。当前 Agent 可以常驻,更新替换的旧 Agent 排空活动任务后退出。任务完成后回收空闲 Runtime,共享进程仍有任务或待答问题时保留;下一轮重建 Runtime 并恢复对话历史。设置页按平台和架构显示包状态,用户显式下载、更新或导入/导出包含 Agent、固定 Node、OpenCode 和 Continue 的签名 `.gbagent`;三个目标共用一个签名 catalog,继续校验签名和 SHA-256。Continue 需要更新后的联合包与配套 Desktop。首次发布混合 catalog 前需先升级 Desktop,旧版 Linux-only 目录读取器无法解析包含 Darwin 的目录。历史 macOS OpenCode 原生安装、生命周期、Attach、真实 Ask/Execute 和独立进程组工具取消已在真实 Host 验证,不代表 Continue 的同等实机覆盖。当前 Agent 源码锁为 `0.15.0`,配套 Desktop 候选为 `0.15.1`;详细运行边界和 Linux 历史回归证据见[远程主机技术设计](docs/features/remote-host/technical-design.md),正式发布状态以独立发布渠道为准。
- [x] **托管 SSH OpenCode 与 Continue**:该能力由“设置 > 平台功能”中的独立“远程项目”页签控制并默认关闭;关闭时不影响本地项目、普通桌面功能或桌面发布。支持 Linux x64、Linux arm64 和 macOS arm64 Host,不支持 Intel Mac;通过 SSH 按需启动 detached Agent,不要求开机服务。Ask 在 Runtime 工具边界保持只读,Execute 使用所选 SSH 账号的完整权限。Agent 持有 Prompt、模型和工具轮次、Runtime 进程及语义 transcript,Desktop 断开后重新 Attach 原操作而不重发 Prompt;模型凭据仅在当前操作内存中使用,不写入 Renderer、SSH 参数、环境或磁盘。当前 Agent 可以常驻,更新替换的旧 Agent 排空活动任务后退出。任务完成后回收空闲 Runtime,共享进程仍有任务或待答问题时保留;下一轮重建 Runtime 并恢复对话历史。设置页按平台和架构显示包状态,用户显式下载、更新或导入/导出包含 Agent、固定 Node、OpenCode 和 Continue 的签名 `.gbagent`;三个目标共用一个签名 catalog,继续校验签名和 SHA-256。Continue 需要更新后的联合包与配套 Desktop。首次发布混合 catalog 前需先升级 Desktop,旧版 Linux-only 目录读取器无法解析包含 Darwin 的目录。历史 macOS OpenCode 原生安装、生命周期、Attach、真实 Ask/Execute 和独立进程组工具取消已在真实 Host 验证,不代表 Continue 的同等实机覆盖。当前 Agent 源码锁为 `0.15.0`,配套 Desktop 候选为 `0.15.2`;详细运行边界和 Linux 历史回归证据见[远程主机技术设计](docs/features/remote-host/technical-design.md),正式发布状态以独立发布渠道为准。
- [x] **SSH Host 手动环境准备源码链路**:Host Key、认证和系统探针成功后先保存 Host,并只读探测共享 Agent/Runtime;保存 Host、打开项目都不自动安装。Host 卡片只有一个按版本事实显示“安装远程环境”“更新远程环境”或“重新安装”的主按钮,次级 SegmentedControl 选择默认且不持久化的“自动”、Host 下载或 GoodBuddy 传输;“版本匹配”badge 不等同环境健康。自动模式只在 operation/prepare 前探测并择一,显式选择保持有效,任何 prepare、commit 或 adoption 失败都不跨 acquisition 自动 fallback。两种方式把同一签名 compound `.gbagent` 交付到固定 staging 后,共用 control-plane prepare、commit、Agent activate/health、Runtime activate、finalize 与显式 cleanup。GoodBuddy 路径可在同一次操作下载并验证缺失候选、缓存并取得 lease,再有界流式 SFTP 上传一个归档和其中已验证的 bootstrap Node,不把约 294 MiB 整包读入 Main `Buffer`;Host 在解包时完成一次完整 payload 校验。未完成操作只记录暂存 cleanup 所需的 operation ID;下次更新尽力清理旧暂存后重新 prepare,不保存远端 metadata 副本,也不让 cleanup 失败阻塞新更新或回滚健康环境。已有项目在实际使用 Workspace/Runtime 时按需解析 Host current identity 并执行固定 `attach-or-bootstrap`,注册后的 health、capabilities 和 prompt 启动不扫描完整 payload。详见 [设计说明](./docs/features/remote-host/environment-provisioning-technical-design.md)。
- **SSH Host 环境准备验证记录**:当前源码已在隔离 Linux x64 环境通过包安装、Ask/Execute、原生子代理工作区外写入、重连及 stop/bootstrap。现有记录未覆盖 Host 卡片的完整 GitHub、北京镜像、Linux x64/arm64、取消和离线 GoodBuddy 传输矩阵,候选 CI/原生打包与系统休眠唤醒也尚未验证;开发记录不代表版本已经发布。
- [x] **远程工作区与长任务更新**:Agent `0.11.23` 新增远程文件/Git 管理和可选模型限额,随包 Runtime 不再施加固定十分钟 Prompt 时限;无限请求时长仍保留独立连接超时。请先升级 Desktop 至 `0.12.11`,再下载并更新 Host 上的 Agent。
@@ -153,8 +153,9 @@
### 开源、构建与发布
- 当前 Desktop 候选为 `0.15.1`,Agent 候选为 `0.15.0`,OpenCode 固定为 `1.18.29`、Continue 为 `1.5.47`;正式发布状态以独立发布渠道为准。
- Desktop `0.15.1` 承接未发布的 `0.15.0` Obsidian 接入、会话采集到魔法笔记和预览中的本地原生客户端,并修复知识库、监督者与界面操作。schema 48 新增会话来源元数据,回退旧客户端需使用升级前完整备份。Agent `0.15.0` 要求 Desktop `0.15.1`,保留 Node `24.19.0`,补齐远程遥测关闭配置及 Continue 跳过已关闭的更新检查,不新增远程客户端快捷入口。
- 当前 Desktop 候选为 `0.15.2`,Agent 候选为 `0.15.0`,OpenCode 固定为 `1.18.29`、Continue 为 `1.5.47`;正式发布状态以独立发布渠道为准。
- Desktop `0.15.1` 已完成六平台原生打包及 GitHub/OSS 发布。Desktop `0.15.2` 新增 Story Graph 只读工具和完整可编辑的监督讨论消息,简化笔记采集并补充退出诊断;远程图谱读取需配套 Agent `0.15.0`。主机与云环境管理应用仍为待实现规划,当前候选证据见[0.15.2 发布准备](./docs/development/release-preparation-0.15.2.md)。
- Desktop `0.15.1` 承接未发布的 `0.15.0` Obsidian 接入、会话采集到魔法笔记和预览中的本地原生客户端,并修复知识库、监督者与界面操作。schema 48 新增会话来源元数据,回退旧客户端需使用升级前完整备份。Agent `0.15.0` 要求 Desktop `0.15.2`,保留 Node `24.19.0`,补齐远程遥测关闭配置及 Continue 跳过已关闭的更新检查,不新增远程客户端快捷入口。
- Desktop `0.13.15` 承接未发布的 `0.13.14`,改善监督者分页回顾与续跑、ripgrep 原生搜索、待办布局和远程结果未知后的显式续聊。数据库升级至 schema 47,回退旧客户端需使用升级前完整备份。
- Desktop `0.13.16` 分离结构升级与旧历史回收,移除回顾固定时长自动暂停,并改善监督者布局。相较 `0.13.15` 不新增 schema 变更,也不要求更新 Agent。
- Agent `0.13.3` 回收空闲 Runtime,并使被替换的 Agent 等已有工作结束后退出;复合包要求 Desktop `0.13.12`,请先升级 Desktop,再更新 Host 环境。Node 保持 `24.19.0`。
@@ -177,7 +178,7 @@
- [ ] **Headless Runtime API**(规划中):提供本机优先的任务、事件、状态和成果 API,以及有范围、有效期、限流和撤销能力的令牌。
- [ ] **GoodBuddy Team Hub**(规划中):以可选服务提供组织、RBAC、项目共享、远程 Agent、策略下发和租户审计。
- **SSH 主机与远程执行空间验证记录**:主机 CRUD、Host Key、加密凭据、Project UI、Workspace、OpenCode ACP v5、Agent-owned Prompt/gateway/transcript、Ask 只读、Execute 完整账号权限、取消、detached Agent 精确重连和 release-only 双架构资源校验已经接线。Linux x64 当前源码已用真实模型与工具通过 detach、进程结束、relay 丢失、并发、取消、Provider 异常、Agent 重启和 Desktop SQLite 恢复矩阵;当前源码测试签名 Agent `0.11.17` 又通过两个并发 Ask 读取、一次 Execute 写入并读回,以及 6 次带自定义 Header 和 Body 的真实受管网关模型请求,未发现 Provider 请求重放,隔离 Agent state 中也没有 API Key 或自定义请求值。公开 signing key registry 已供应。控制面直连源码不等待新 installer-bearing 包;现有记录未覆盖当前 Linux x64/arm64 正式签名工件的完整公开核对及 GitHub/北京镜像、双架构和离线 GoodBuddy 传输矩阵,发布结果另行记录。
- [ ] **多云远程沙盒 Agent**(规划中):通过云厂商 API 和 SSH Agent 管理专用 Linux 沙盒;凭据留在 Main 进程,高风险控制面操作单独确认。
- [ ] **主机管理与云环境管理**(规划中):主机管理迁入应用中心,提供列表与详情工作页面;云环境管理作为同级应用,复用主机连接和执行能力。首版适配计划覆盖 AWS、Azure、阿里云、腾讯云、VMware vCenter / vSphere、ZStack,分批完成已有实例发现、接入及真实执行验收;实例创建、启停、销毁和网络编排后续交付。平台 API 尚未实现,现有云主机可按 SSH 条件手工接入。详见[产品范围](./docs/features/remote-host/prd.md)。
## 规划原则
@@ -0,0 +1,39 @@
# Desktop 0.15.2 与 Agent 0.15.0 发布准备
日期:2026-09-28。用户要求包含当前本地工作、推送双远端,等待候选 CI 和生产构建通过后打标签;
确认同时发布 Agent 0.15.0,不构建 LoongArch。沿用此前自行审核候选和双语说明的授权。
## 发布范围
- Desktop 基线为已发布的 `v0.15.1`(`4e5239256d42c856bb1420d87c4a338f17867b80`)。
[发布 CI 36368878429](https://github.com/mesalogo/goodbuddy/actions/runs/36368878429)
六个原生目标和 GitHub/OSS 发布全部成功,0.15.1 的历史说明保留。
- 新源码截止 `66f77b83c2b6ebe0018a6c5c2bc72e1b4c1e43b1`:
renderer 退出诊断、笔记采集界面、双语网站及 Story Graph 只读工具与完整讨论草稿。
- Agent 0.15.0 尚未发布,基线仍为 `agent-v0.13.4`。
既有遥测和 Continue 更新检查修复保留,补充远程 Story Graph 工具;
最低 Desktop 版本由当前 manifest 派生为 0.15.2。三个原生目标和 Runtime 锁不变。
- 当前未提交的功能矩阵、主机/云环境设计和宣传文稿一并审核纳入。
云平台适配与主机入口迁移明确为待实现规划,不进入发布功能说明。
宣传稿保持草稿和原核查截止点,不代表已对外发布。
- 正式双语正文仅维护在 `resources/release-notes.json` 的 0.15.2 条目和
`resources/agent-release-notes/0.15.0.md`。两份 FEATURES 已对照实现与规划核对。
## 验证边界
Story Graph 已有开发期证据见
[监督者验证进度](../features/conversation-supervision/progress.md#2026-09-28-story-graph-只读工具):
真实 Linux Host 上的 OpenCode/Continue Ask、Execute 调用与禁用检查通过;
推理为本机确定性响应,10 次请求含 2 次标题生成,外部付费请求 0 次。
不将这些证据称为真实模型建议质量验证,也不宣称历史重建、跨范围事实合并或大库性能已验收。
本轮类型、lint、双语说明及网站静态校验通过。按当前源码重建隔离 Agent 探针,
在共享 Linux x64 Host 经固定身份完成 OpenCode/Continue Ask、Execute、空闲进程回收、
冷启动历史恢复和遥测关闭环境检查;每个 Runtime 2 次真实模型请求,共 **4 次**,
没有重试或假模型调用,结束时归属进程均为 0。该补充检查不等于真实模型图谱建议质量验收。
准备期间另有 `0cdf042` 宣传稿提交,已核对只有三份文档变化,产品源码仍截止 `66f77b8`,
一并纳入完整候选。用户随后中断本地全量步骤,明确要求直接推送等待 CI;
本地全量不记为通过,由精确候选的主分支 CI 执行完整测试和生产构建,通过后才打标签。
不运行本地生产构建、安装包打包或安装包启动;使用既有隔离 Host 目录,不更改生产 Agent。
schema 保持 48;从旧版升级应备份完整数据库和相邻 `notes/`,不能用旧客户端打开升级后的库。
@@ -23,6 +23,10 @@
## 文档导航
待实现的应用扩展见 [FR-17](./prd.md#fr-17-主机管理与云环境管理待实现):
主机管理从设置中心迁入独立工作页面,云环境管理作为同级应用;业务定义由
[远程主机功能文档](../remote-host/README.md)维护。上文四应用描述仍为当前实现。
现有 `heartbeat` 入口承载监督者工作回顾与故事线图谱,可管理启用、常驻和排序。应用默认关闭;完整执行边界见[应用启停与执行](../conversation-supervision/logic-design.md#应用启停与执行)。未来市场复用同一应用身份,不增加平级重复入口,目标定义见[监督者产品设计](../conversation-supervision/supervisor-prd.md)。
| 文档 | 权威职责 |
@@ -264,3 +264,14 @@ Modal 只有服务列表,显示名称、简短状态、引擎、模型、资
资源监控仍是只读系统工具,本机推理监控聚焦本地服务状态。该项独立于商店接入生产源码,支持 OCR 空闲加载与释放、内置向量进程启动/停止/重启;TTS 显示不可用。后端保留请求登记及原有取消能力,供执行路径和服务影响校验使用。各引擎边界见
[技术清单](./technical-design.md#111-本机推理任务与执行服务),验证范围见[实施进度](./progress.md)。
原首期资源监控的 GoodBuddy 桌面进程统计范围不因此扩大。
### FR-17 主机管理与云环境管理(待实现)
2026-09-28 确认新增两个同级应用:“主机管理”和“云环境管理”。主机管理从设置中心迁入,
两个应用均从应用菜单、管理应用和常驻入口打开主内容区独立页面,不嵌入管理 Modal。
应用中心负责通用应用配置,业务操作在各自页面完成。
导航扩展须保留已有应用排序、常驻偏好和远程能力启用值;取消主机常驻不影响云环境使用
主机能力。两个应用的能力依赖、迁移范围及产品验收由
[主机与云环境 PRD](../remote-host/prd.md)和[功能逻辑](../remote-host/logic-design.md)定义,
业务页面布局见[界面设计](../remote-host/ui-design.md)。该项尚未实现,不改变上文四应用的当前状态描述。
+4
View File
@@ -664,6 +664,10 @@ SSH/远程项目操作;已有 Host、项目和凭据保持不变。若当前
启用后,设置中心显示“主机与远程执行”分类,管理:
> 上述入口为当前实现。2026-09-28 已确认后续迁入应用中心的“主机管理”,并新增同级
> “云环境管理”;范围、能力依赖及验收见[主机与云环境 PRD](../remote-host/prd.md)。
> 本节保留现有行为,入口迁移尚未实现。
- 主机名称、地址、端口和用户名。
- 认证方式和凭据配置状态。
- Host Key 算法与 SHA-256 指纹。
+10 -1
View File
@@ -3,15 +3,24 @@
本功能负责 SSH Host 管理、Host Key、远程环境安装、GoodBuddy Agent、签名 Runtime、
远程 Workspace 和 Ask/Execute 生产路径。
2026-09-28 新增待实现方向:主机管理迁入应用中心,与“云环境管理”成为同级应用;
云平台发现已有实例,接入执行时复用 SSH 主机。产品范围见 [PRD](./prd.md)。
本文中的平台连接指云账号或私有化 API 连接,云实例指平台中的虚拟机,主机指 GoodBuddy
保存的 SSH 连接目标;三者不等同。现有实现和历史验收仍以下列技术文档为准。
## 文档导航
| 文档 | 权威职责 |
| --- | --- |
| [产品需求](./prd.md) | 应用迁移、六平台适配范围、分期与产品验收;待实现 |
| [功能逻辑](./logic-design.md) | 平台、实例、主机关系,独立状态、依赖和删除规则;待实现 |
| [界面设计](./ui-design.md) | 独立工作页面、主机列表与详情、云实例接入和响应式交互;待实现 |
| [远程主机与 Agent 技术设计](./technical-design.md) | 当前产品语义、Agent、Runtime、Workspace、协议、生命周期和验证事实 |
| [远程环境准备技术设计](./environment-provisioning-technical-design.md) | Host 下载、GoodBuddy 传输、安装事务、更新和恢复边界 |
| [执行清单验证记录](./runtime-checklist-validation.md) | 远程 OC/CN 原生清单、CN 开发包安装、取消及断线重放的实测结果与剩余验收 |
现有文档包含产品、功能逻辑和进度事实,后续修改远程功能时再按标准职责拆分。
既有技术文档保留当前 SSH 行为及历史进度;新增 PRD、逻辑和 UI 文档只定义本次待实现范围,
不替代已有验证事实。验收场景随 PRD 维护,本次不单独创建 User Stories 或进度占位文档。
跨会话共享 OpenCode 进程、ACP 连接与模型桥的实现设计,见
[Runtime 进程复用技术设计](../assistant-workbar/runtime-process-reuse-technical-design.md#6-ssh-opencode-与-agent)。
+50
View File
@@ -0,0 +1,50 @@
# 主机与云环境功能逻辑
状态:2026-09-28 设计,待实现。对应[产品需求 FR-RH-1 至 FR-RH-6](./prd.md),验收场景使用其中的 AC-RH 编号。
## 对象与关联
| 对象 | 所有权与关系 |
| --- | --- |
| 平台连接 | 云环境管理负责平台类型、账号或 API 端点、凭据引用与查询范围 |
| 云实例 | 以平台连接及该平台稳定资源标识定位,保留必要的账号、区域或私有化资源范围;不能仅靠名称或 IP 判定同一实例 |
| 主机 | 主机管理负责 SSH 地址、账号、认证、Host Key 和执行环境;可选关联云实例 |
| 远程项目 | 继续引用主机与远端目录,执行空间保持 local / ssh |
首版一个云实例最多关联一个受管主机,一个主机最多关联一个云实例;一个主机可被多个项目引用。重复导入显示已关联主机;关联已有主机须由用户选择并验证连接目标,不能根据相同 IP 自动合并。平台凭据和 SSH 凭据分别管理,不复制到项目中。(FR-RH-3、FR-RH-5;AC-RH-3)
## 导入与状态
发现实例后先展示平台返回的事实。用户选择“接入主机”,选定地址和认证配置,复用主机验证流程,成功后保存主机与关联;失败或取消不留下半成品主机,也不改变已有有效关联。保存成功不自动安装环境,由用户显式触发。(FR-RH-2、FR-RH-3;AC-RH-2 至 AC-RH-4)
| 状态维度 | 来源与显示规则 |
| --- | --- |
| 实例运行状态 | 平台 API 查询结果;查询失败显示错误及上次成功时间,不能推断为已删除 |
| SSH 连通性 | 所选主机的连接检查;未检查、成功、失败与检查时间独立显示 |
| 执行环境 | Agent / Runtime 实际检查和安装结果;版本匹配不等于环境健康 |
进入主机页面只读取本地记录,不逐台连接 SSH。云资源刷新只查询平台 API,不顺带验证 SSH 或安装环境。变更连接目标后按现有规则重新验证,不用旧结果宣称新目标就绪。平台报告实例消失时保留主机及项目,显示关联异常并允许用户处理,不自动清理数据。(FR-RH-4;AC-RH-1、AC-RH-4)
## 导航与能力依赖
常驻只控制导航捷径,取消常驻不停止任务、禁用能力或删除数据。应用中心的主机管理设置承载共享远程能力启用状态,迁移保留原 `remoteProjectsEnabled` 值;旧设置不再维护第二个独立开关。云环境应用的启用单独控制云管理入口和新平台操作。(FR-RH-1、FR-RH-4、FR-RH-6)
| 操作 | 目标行为 |
| --- | --- |
| 打开云环境但远程能力未启用 | 允许配置平台及查询实例;接入主机时提供就地启用,保存成功后继续 |
| 取消主机常驻 | 云环境仍可引用主机,已有关联和运行不变 |
| 关闭共享远程能力 | 沿用现有远程项目停用语义,保留主机、凭据和项目;云资源浏览仍可用,依赖操作显示原因与启用入口 |
| 关闭云环境应用 | 保留平台配置和主机关联;已接入的 SSH 主机及远程项目继续可用 |
| 切换业务页面 | 保留搜索、选择与正在进行的操作状态,遵守未保存编辑离开检查 |
能力启用与校验须同时覆盖 UI 和 Main,不能仅移动开关或隐藏按钮。(AC-RH-5)
## 删除语义
移除主机沿用现有本地引用项目及关联数据删除确认,移除成功后清除云实例到该主机的关联,实例重新显示为未接入。操作不连接远端删除目录,也不调用实例销毁 API。
移除平台连接前列出关联主机;确认后移除平台凭据及关联,保留 SSH 主机、凭据和项目,使其继续作为独立主机使用。远端实例生命周期操作属于后续功能,须在云环境页面独立定义影响及结果。(FR-RH-5;AC-RH-6)
## 完整性与待定事项
本文覆盖导航迁移、发现与导入、状态来源、依赖关闭、重复关联及删除。各平台适配顺序、支持版本和验收环境待确认;私钥与私网连接方案属于后续技术选型。实例创建、销毁、网络编排及批量操作不在首版范围,不能从本设计推导其行为。
+62
View File
@@ -0,0 +1,62 @@
# 主机管理与云环境管理产品需求
状态:2026-09-28 确认产品方向,待实现。本次仅更新文档;现有 SSH 实现与验证范围见[技术设计](./technical-design.md)。
## 目标与范围
主机管理从设置中心迁入应用中心,在主内容区提供独立工作页面。云环境管理作为同级应用,管理公有云及私有化平台中的虚拟机,接入远程执行时复用主机管理。
首版围绕已有虚拟机完成“连接平台 → 发现实例 → 接入主机 → 验证 SSH → 安装远程环境 → 创建项目 → 执行任务”。先交付主机管理入口迁移与页面调整,再分批接入平台适配器。
| 平台范围 | 接入目标 |
| --- | --- |
| AWS | 已有 EC2 实例 |
| Azure | 已有 Virtual Machines |
| 阿里云 | 已有 ECS 实例 |
| 腾讯云 | 已有 CVM 实例 |
| VMware | 先聚焦 vCenter / vSphere 管理的虚拟机 |
| ZStack | 已有云主机 |
六个平台纳入首版适配计划,逐批实现和验收,不把手工 SSH 接入计为平台 API 已适配。候选顺序为阿里云、腾讯云加一个私有化平台,再补其余平台;私有化平台优先级按真实客户与测试环境确定,该顺序尚未锁定。各平台支持版本、认证方式和可验收环境须在对应适配器开发前确认。
首版不包含自动创建、销毁虚拟机、网络编排、镜像管理和计费管理;已有实例启停作为后续增量。现有云服务器仍可手工通过 SSH 接入,受网络、认证和远端操作系统支持范围限制。
## 功能要求
### FR-RH-1 应用入口
应用中心分别提供“主机管理”和“云环境管理”,打开独立主内容区页面,支持排序与常驻。应用中心只负责访问和通用应用设置,主机和云资源操作位于业务页面。迁移后移除设置中心内的重复主机管理表单;旧入口可提供跳转。
### FR-RH-2 主机工作页面
主机作为全局资源,提供可搜索、按来源及状态筛选的列表与所选主机详情。保留现有新增、编辑、验证、Host Key、凭据管理、安装、更新、重装及删除能力。详情包含概览、连接配置、执行环境和关联项目。来源为手工添加或关联平台,不要求手工主机填写云字段。
### FR-RH-3 云平台连接与已有实例接入
一个平台连接管理多台实例。用户可先浏览云资源,再选择实例创建主机或关联已有主机。实例接入须选定可达地址和认证方式,经 SSH 验证后才成为可用主机;仅查询到实例不代表接入成功。认证或连接失败保留平台及实例上下文,允许修正后重试。
### FR-RH-4 依赖与状态
云环境浏览不要求存在主机;安装环境、创建远程项目和远程执行复用主机能力。云实例运行状态、SSH 连通性、执行环境就绪状态独立呈现,并显示检查时间或未检查状态。启用、常驻及共享远程能力的规则由[功能逻辑](./logic-design.md)定义。
### FR-RH-5 资源关联与删除
已接入实例可跳转至对应主机,主机可回到平台实例。移除本机主机记录、移除平台连接与销毁云实例是独立动作,不能相互隐式触发。主机删除沿用现有引用项目影响确认及本地数据清理语义,明确不会删除远端内容。
### FR-RH-6 迁移与接入条件
升级保留已有 Host ID、凭据、Host Key、项目引用、功能启用状态及原有应用导航偏好。私钥认证和私网连接路径属于云接入前的补齐项;在对应能力实际交付前,页面必须说明可用认证与网络条件,不能将平台 API 可达等同于 SSH 可达。具体私钥保存方式和跳板连接方案另行技术设计,不因本文而宣称已经支持。
## 产品验收
| 场景 | 操作与预期结果 |
| --- | --- |
| AC-RH-1 已有用户升级 | 打开主机管理,原有主机及项目引用可用;导航排序和原启用偏好保留,不自动连接远端 |
| AC-RH-2 主机维护 | 从应用中心新增主机,完成验证、显式安装环境并创建远程项目;取消或失败可重试,页面跳转不重复安装 |
| AC-RH-3 云实例导入 | 已配置平台连接时发现并选择实例,验证后创建或关联主机,进入同一主机详情;重复导入定位已有记录 |
| AC-RH-4 网络或认证失败 | 实例运行中但 SSH 不通或认证失败时,分别显示实例状态和连接错误;不显示执行就绪,不安装环境 |
| AC-RH-5 导航与依赖 | 取消主机常驻不影响云环境或执行能力;云环境接入流程可就地启用所需远程能力,无须寻找设置开关 |
| AC-RH-6 移除关联资源 | 删除主机前列出受影响的本地项目;完成后云实例仍存在,云列表显示未接入。移除平台连接不删除主机和远端资源 |
| AC-RH-7 页面与权限 | 窄窗口和键盘可完成列表、详情和返回;平台账号仅有查询权限时仍可发现和导入实例,不要求实例生命周期权限 |
每个平台必须通过真实 API 发现已有实例,并完成 SSH、环境安装、项目创建和真实任务执行的生产路径验收,才可标记该适配器已交付。UI、模拟响应和单独 SSH 测试不能替代平台验收。
@@ -55,6 +55,9 @@ Agent `0.11.23` 提供,显式请求期限与取消仍有效。当前问答源
## 产品语义
本节记录现有实现。2026-09-28 确认的应用中心迁移与云环境管理目标见
[PRD](./prd.md)、[功能逻辑](./logic-design.md)及[UI 设计](./ui-design.md),尚未接入源码。
远程 Host 与项目能力默认关闭。用户在“设置 > 平台功能”的独立
“远程项目”页签启用开关后,Renderer 才显示 SSH Host 管理、托管 SSH 项目创建和已保存
远程项目;Main 在 IPC 边界执行同一开关校验,避免隐藏界面被绕过。关闭开关不删除 Host、
@@ -73,6 +76,30 @@ profile 和凭据作为有界、逐 Prompt 的控制消息交给 Agent;该凭
## 组件
### 应用迁移与云平台接入计划(待实现)
实现顺序对应 FR-RH-1 至 FR-RH-6:
1. 从 `SshHostsSettingsSection` 提取独立主机工作页面,接入 `ApplicationCenter` 和 `App`
页面导航;复用现有 SSH 服务、验证弹窗、安装操作及通知,完成列表与详情改版。
2. 扩展应用标识、排序、常驻和配置读取。读取已发布四应用配置时保留原相对顺序及偏好,
新入口追加且默认不常驻;云管理初始关闭,共享远程能力继承 `remoteProjectsEnabled`。
配置工具公开契约、默认值、持久化、Preload 和 Main 校验同步修改,不能仅扩展 Renderer。
3. 按功能逻辑整理能力依赖,将共享远程开关的设置入口迁入应用中心。保留旧值、Host ID、
加密凭据、Host Key 与项目引用;不为页面迁移重建主机或修改 Agent 协议。
4. 云平台适配器在 Main 中查询真实 API,凭据复用加密存储;Renderer 仅接收脱敏配置、
实例快照与操作结果。采用满足首批平台发现和导入的最小接口,不预建资源编排框架。
平台连接和实例关联采用独立记录,SSH 主机仍为执行目标,项目继续使用 `local / ssh`。
5. 确认首批平台版本及测试环境,补齐需要的私钥和私网连接路径,逐个验收发现、导入、
SSH 验证、环境安装和真实任务执行。具体存储字段、迁移及适配 API 在实施时细化;
变更已发布存储前遵守[数据库迁移规范](../../development/database-migrations.md)。
验证覆盖已有用户配置读取、重复实例关联、状态来源、平台查询失败、SSH 不通、删除影响、
能力依赖与页面离开。平台 API 测试与原有远程 Agent 测试分别记录;导航迁移通过不代表
云平台适配完成。新增能力交付前,本文件以下 SSH 组件及历史记录继续描述现有实现。
### 现有远程执行组件
桌面保存托管 SSH 子任务事件时,共用
[执行记录差量存储](../assistant-workbar/execution-history-storage.md)。
Agent transcript 与公共 Runtime 事件不改变;桌面的来源去重、消息投影事务和恢复序号
+44
View File
@@ -0,0 +1,44 @@
# 主机管理与云环境界面设计
状态:2026-09-28 设计,待实现。范围见[PRD](./prd.md),状态及依赖遵守[功能逻辑](./logic-design.md)。视觉、页面壳层和组件遵守[统一界面设计系统](../../../UI-DESIGN.md)。
## 应用入口
应用中心新增“主机管理”和“云环境管理”两个同级应用。应用菜单、管理应用中的“打开”和常驻侧栏入口进入同一主内容区页面,关闭来源菜单或管理 Modal,不在应用中心 Modal 内管理主机。业务页面使用全局范围标识;打开页面不切换当前项目、不连接主机或执行安装。
通用启用、常驻和排序遵守[应用导航设计](../application-tool-navigation/ui-design.md)。设置中心移除主机操作表单,保留必要的迁移跳转;共享远程能力开关归入主机管理的应用设置。Agent 包下载、导入等现有全局包管理暂留原位置,主机执行环境页提供相关入口,不复制包状态存储。
## 主机页面
页面使用共享 `dashboard` 壳层。标题区显示“主机管理”、全局范围和主操作“添加主机”。工具栏提供名称或地址搜索、来源筛选、连接状态筛选。列表显示名称、地址、来源、SSH 状态和执行环境摘要,避免每行展开安装表单。
宽窗口使用列表与详情两栏,点击主机只更新详情,不重排列或滚动列表。详情使用共享 `PageTabs`:
| 页签 | 内容与操作 |
| --- | --- |
| 概览 | 名称、来源、系统架构、独立状态及检查时间;关联云实例时提供“查看云实例” |
| 连接配置 | 地址、端口、用户名、认证配置状态、Host Key;编辑与重新验证复用既有流程,不回显凭据 |
| 执行环境 | Agent / Runtime 版本、检查结果、安装进度;保留安装、更新、重装及既有下载方式选择 |
| 关联项目 | 所有引用该主机的项目,明确归档状态;提供打开项目和创建远程项目 |
云关联字段按需显示,手工主机不出现必填平台、区域和实例 ID。删除主机置于次要操作,确认内容列出本地项目影响及远端资源保留范围。
未选择主机时提示选择列表项;没有主机时提供添加入口;搜索无结果时提供清除筛选。连接失败、安装失败和数据读取失败分别显示原因与对应重试操作。用户主动检查所选主机时才连接远端,不能因列表渲染而检查全部主机。
## 云环境页面
标题区显示“云环境管理”、全局范围及“添加平台连接”。通过平台连接和适用的区域或资源范围筛选实例,列表展示名称、平台、位置、实例状态、地址和接入状态。刷新明确针对当前查询范围,并显示上次成功时间。
未接入实例提供“接入主机”,进入地址与认证选择,再完成现有验证向导。已接入实例提供“打开主机”;关联已有主机时可搜索选择,明确展示目标后验证。两个页面之间往返恢复来源筛选、所选记录和滚动位置。
实例运行、SSH 连接和环境就绪分别显示文字状态。只读平台账号可以查询实例并接入 SSH;权限不足时说明失败操作,不把整个平台笼统标为不可用。平台 API 可达但 SSH 不通时保留资源详情与修正连接的入口。
首版不展示尚未实现的创建、销毁或网络编排按钮。各适配器随真实能力交付,不能用不可操作的平台卡片代替接入功能。
## 响应式与交互
两栏无法满足共享最小宽度时改为单面板,选择主机进入详情并提供“返回主机列表”,返回恢复筛选、滚动和列表项焦点。页签可横向滚动,搜索与筛选换行,长地址和错误信息折行,页面不整体横向溢出。
列表项及操作使用语义按钮,提供可访问名称和可见焦点;页签沿用 `tablist`、`tab`、`tabpanel`、方向键及 Home/End。弹窗遵守共享焦点恢复及未保存编辑规则。通知使用全局应用通知,进行中的安装进度保留在对应主机,页面切换不重启操作。
验收对应 AC-RH-1 至 AC-RH-7,覆盖浅深主题、窄窗口、键盘操作、空列表、长名称、认证失败及安装取消;具体实施记录需附真实 UI 验证结果。
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "goodbuddy",
"version": "0.15.1",
"version": "0.15.2",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "goodbuddy",
"version": "0.15.1",
"version": "0.15.2",
"license": "0BSD",
"dependencies": {
"@agentclientprotocol/sdk": "0.25.1",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "goodbuddy",
"version": "0.15.1",
"version": "0.15.2",
"private": true,
"description": "Secure desktop AI workspace with controlled Agent Runtimes",
"desktopName": "GoodBuddy",
+10 -2
View File
@@ -1,5 +1,9 @@
# GoodBuddy Agent 0.15.0 更新内容
## 功能更新
- **远程 Agent 可查阅故事图谱**:配套 Desktop 启用监督者并分配 Story Graph 后,远程 OpenCode、Continue 可在 Ask 或 Execute 中搜索已保存决定、读取变化过程和来源片段。工具仅只读,不生成新回顾、不修改依据,也不提供完整历史重建或跨范围事实合并。
## 问题修复
- **远程 Runtime 遵循遥测关闭设置**:通过更新后的 Host 环境启动 OpenCode 或 Continue 时,Agent 与模型桥统一传入遥测关闭配置。保留模型、MCP 和用户主动联网能力,不把关闭遥测变成禁止正常联网。
@@ -7,12 +11,16 @@
## 使用说明
- 请先升级 **GoodBuddy Desktop 0.15.1**,再下载并更新 Host 环境。此版本不提供远程原生客户端快捷入口,已有进程不会热更新。
- 请先升级 **GoodBuddy Desktop 0.15.2**,再下载并更新 Host 环境。此版本不提供远程原生客户端快捷入口,已有进程不会热更新。
- 提供 Linux x64、Linux arm64 和 macOS arm64 包,继续使用 Node **24.19.0**、OpenCode **1.18.29** 和 Continue **1.5.47**。
- Ask 保持只读,Execute 使用所选 SSH 账号的权限。Agent 独立发布,不替代桌面端 Latest。
# What's New in GoodBuddy Agent 0.15.0
## Features
- **Remote agents can consult Story Graph**: With Supervisor enabled and Story Graph assigned in the matching Desktop, remote OpenCode and Continue can search saved decisions and read their evolution and source fragments in Ask or Execute. These read-only tools do not generate reviews, modify evidence, reconstruct complete history, or merge facts across scopes.
## Bug Fixes
- **Remote Runtimes respect telemetry opt-out**: OpenCode and Continue launched through the updated Host environment receive consistent telemetry opt-out settings from the Agent and model bridge. Model, MCP, and user-requested networking remain available rather than being blocked alongside telemetry.
@@ -20,6 +28,6 @@
## Usage Notes
- Upgrade to **GoodBuddy Desktop 0.15.1** before downloading and updating the Host environment. This release does not provide remote native-client shortcuts, and existing processes are not hot-updated.
- Upgrade to **GoodBuddy Desktop 0.15.2** before downloading and updating the Host environment. This release does not provide remote native-client shortcuts, and existing processes are not hot-updated.
- Packages cover Linux x64, Linux arm64, and macOS arm64, retaining Node **24.19.0**, OpenCode **1.18.29**, and Continue **1.5.47**.
- Ask stays read-only and Execute uses the selected SSH account's permissions. Agent releases remain separate and do not replace Desktop Latest.
+38
View File
@@ -1,6 +1,44 @@
{
"formatVersion": 1,
"releases": [
{
"version": "0.15.2",
"releasedAt": "2026-09-28",
"notes": {
"zh-CN": {
"highlights": [],
"features": [
"**让 Agent 查阅故事图谱**:启用监督者并分配 Story Graph 工具后,可让模型查找已保存的决定、变化过程和来源片段,在继续工作前核对已有依据。支持直连模型、本地 DeepSeek Harness,以及本地和远程 OpenCode、Continue;读取不修改图谱,也不代表完整历史重建或跨范围事实合并。"
],
"fixes": [
"**继续讨论前编辑完整消息**:从监督结果继续讨论时,可查看并修改即将发送的完整上下文和问题,并确认目标会话。发送以编辑后的可见内容为准,不会重新附加已删除的上下文。",
"**简化笔记采集界面**:采集和快速追加面板移除重复标签、范围提示及重复入口,保留内容编辑、目标选择和必要的校验错误。输入框仍有可访问名称,保存行为和来源关联不变。",
"**保留窗口异常退出线索**:诊断日志现在记录渲染进程退出原因和退出码,便于排查窗口异常。此项改善诊断信息,不代表已修复所有导致窗口退出的问题。",
"**下载与入门信息更容易查找**:双语网站调整产品介绍、使用场景和设置问答,下载入口紧接首页介绍。移动端展示同步优化,DeepSeek Harness 与 LoongArch 仍保留预览标识。"
],
"notices": [
"远程 Story Graph 需要配套更新 Desktop **0.15.2** 和 Agent **0.15.0**,先升级桌面端,再更新 Host。",
"数据库保持 schema 48;从更早版本升级前仍应备份完整用户数据,包括数据库和相邻 `notes/` 目录。"
]
},
"en-US": {
"highlights": [],
"features": [
"**Let agents consult Story Graph**: Enable Supervisor and assign the Story Graph tools to let agents look up saved decisions, their evolution, and source fragments before continuing work. Supports direct models, local DeepSeek Harness, and local or remote OpenCode and Continue; reads do not modify the graph or provide complete historical reconstruction or cross-scope fact merging."
],
"fixes": [
"**Edit the complete follow-up message**: Continuing from Supervisor results now shows the full context and question for editing, together with the destination conversation. Sending uses the visible draft without reattaching context you removed.",
"**Simpler note capture controls**: Capture and quick-append panels remove repeated labels, scope hints, and duplicate entry points while retaining editing, destination selection, and actionable validation errors. Inputs keep accessible names, and saving and source links behave as before.",
"**Retain window-exit diagnostics**: Diagnostic logs now retain renderer exit reasons and exit codes to help investigate unexpected window exits. This improves diagnostics rather than claiming to fix every underlying cause.",
"**Clearer downloads and setup guidance**: The bilingual website refreshes product explanations, usage scenarios, and setup FAQs, with downloads immediately after the introduction. Mobile layouts improve while DeepSeek Harness and LoongArch retain their preview labels."
],
"notices": [
"Remote Story Graph requires Desktop **0.15.2** and Agent **0.15.0**. Upgrade Desktop before updating Hosts.",
"The database remains on schema 48. Before upgrading from older versions, back up complete user data, including the database and adjacent `notes/` directory."
]
}
}
},
{
"version": "0.15.1",
"releasedAt": "2026-09-28",