diff --git a/FEATURES.md b/FEATURES.md index 391d9c96..f5d6bc73 100644 --- a/FEATURES.md +++ b/FEATURES.md @@ -322,7 +322,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.13.3`, while the current Desktop release candidate is `0.13.12`; formal + `0.13.3`, while the current Desktop release candidate is `0.13.13`; 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 @@ -748,7 +748,9 @@ records are listed separately and do not introduce another feature status. - [x] **Supervisor reviews, story graphs, and activity**: Review a selected scope and period, inspect saved result graphs and sources, confirm or revise entities, and preview local knowledge entity writes. Sidebar feedback follows or pins a - Conversation or Task and opens its matching result. Activity combines heartbeat + Conversation or Task and opens its matching result. It shows target names with + compact pin/refresh buttons and preserves long-title readability and keyboard + focus in narrow sidebars. Activity combines heartbeat and downstream review stages, including failures and links to older results. Automatic stages process only new, changed, or unprocessed source portions; no-change checks skip model calls. Manual review reprocesses bounded history. @@ -843,9 +845,12 @@ records are listed separately and do not introduce another feature status. ### Open source, builds, and releases -- Current source candidates are Desktop `0.13.12` and Agent `0.13.3`, with +- The current Desktop candidate is `0.13.13`; published Agent `0.13.3` is unchanged, 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.13.13` reduces repeated activity-history reads during streaming saves + and fixes supervision feedback sidebar controls and target names. It adds no + database format migration over `0.13.12` and requires no Host update. - Desktop `0.13.12` adds Supervisor reviews, graphs, activity, and automatic incremental processing, reduces streaming activity writes, and improves Mermaid, usage totals, conversation duration, Git, notes, and notifications. Database @@ -857,8 +862,8 @@ records are listed separately and do not introduce another feature status. and lint. The full local suite is not rerun at the user's request; full main-branch CI, its production build, native packaging, and publication verification remain pending. No local production build or packaging is part of this preparation. - Existing Linux x64 lifecycle evidence used eight real provider requests and - incremental-review evidence used three; neither covers the complete native matrix. + Desktop `0.13.12` and Agent `0.13.3` have completed their native release jobs; + this does not replace development-time real-Host scenario coverage. - Validation records remain separate from implementation status. Current-source storage validation covers real local and Linux x64 Host tool workloads, concurrent projects/conversations, cancellation, and lossless database migration. diff --git a/FEATURES.zh-CN.md b/FEATURES.zh-CN.md index 46719753..d33c57f5 100644 --- a/FEATURES.zh-CN.md +++ b/FEATURES.zh-CN.md @@ -50,7 +50,7 @@ - [x] **高效直连模型工作区工具**:直连模型使用随包 ripgrep 紧凑地发现文件和搜索内容,按行分页读取大型 UTF-8 文件,并在 Execute 中应用多文件补丁。Ask 可以搜索和读取,但不能应用补丁或运行命令;用户无需另行安装 ripgrep。可处理的读取或搜索错误允许模型调整参数后继续,部分搜索结果保留并明确提示覆盖不完整。 - [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.13.3`、Desktop `0.13.12`;详细运行边界和 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.13.3`,Desktop 候选为 `0.13.13`;详细运行边界和 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。 @@ -141,10 +141,11 @@ ### 开源、构建与发布 -- 当前源码候选为 Desktop `0.13.12`、Agent `0.13.3`,OpenCode 固定为 `1.18.29`、Continue 为 `1.5.47`;正式发布状态以独立发布渠道为准。 +- 当前 Desktop 候选为 `0.13.13`,已发布的 Agent `0.13.3` 保持不变,OpenCode 固定为 `1.18.29`、Continue 为 `1.5.47`;正式发布状态以独立发布渠道为准。 +- Desktop `0.13.13` 减少流式活动历史保存时的重复读取,并修复监督反馈侧栏的紧凑固定/刷新按钮、目标名称和窄栏长标题显示。相较 `0.13.12` 不新增数据库格式迁移,无需更新 Host 环境。 - Desktop `0.13.12` 增加监督者回顾、图谱、活动和自动增量处理,减少流式活动写入,并改善 Mermaid、用量汇总、会话时长、Git、笔记和通知。数据库升级至 schema 46,回退旧客户端需使用升级前完整备份。 - Agent `0.13.3` 回收空闲 Runtime,并使被替换的 Agent 等已有工作结束后退出;复合包要求 Desktop `0.13.12`,请先升级 Desktop,再更新 Host 环境。Node 保持 `24.19.0`。 -- 发布准备执行定向回归、发布说明校验、类型检查及 lint。按用户要求不重跑本地全量测试;完整主分支 CI、生产构建、原生打包及公开发布核验待完成,本轮不做本地生产构建或打包。既有 Linux x64 生命周期验证使用 8 次真实请求,增量回顾验证使用 3 次,均不代表完整原生平台矩阵已验收。 +- 发布准备执行定向回归、发布说明校验、类型检查及 lint。按用户要求不重跑本地全量测试;本轮候选的完整主分支 CI、生产构建、原生打包及公开发布核验待完成,不做本地生产构建或打包。Desktop `0.13.12` 和 Agent `0.13.3` 已完成原生发布流程,但不替代开发期真实 Host 场景覆盖。 - 验证记录与功能状态分开。存储已有本地及 Linux x64 Host 真实工具任务、多项目多会话、取消和无损迁移验证;进程复用有 Windows 完整 App 与 Linux x64 Host 证据,PPTX OCR 与空闲内存释放有 Windows 真实文件证据。图片工具已有真实服务商生成/编辑及 Host 传输证据,这些记录未覆盖完整界面自然语言调用和本地/远程切换。候选仍需主分支 CI 及原生发布打包,详见[Runtime 验证记录](./docs/features/assistant-workbar/progress.md)与[图片工具验证记录](./docs/features/conversation-media-generation/progress.md)。 - 发布准备前,`9836a4c` 已通过本地 4,858 项测试(67 项跳过)、完整类型检查和 lint;真实服务商画布分析仍未验证。该提交的三个原生 Agent CI 构建通过;桌面 CI `35485936807` 为 4,875 项通过、8 项 Electron 测试失败,均因 Linux 沙箱辅助程序未配置,在页面断言前退出。候选配置该程序并在 Xvfb 下运行测试,不关闭沙箱;候选本地验证、主分支 CI 与原生标签打包分别记录,不在发布准备中运行本地生产构建或打包。 - [x] **0BSD 开源许可**:原创代码可自由使用、复制、修改、分发和商用;第三方组件和资源仍遵循各自许可证。 diff --git a/docs/development/release-preparation-0.13.13.md b/docs/development/release-preparation-0.13.13.md new file mode 100644 index 00000000..9cf5a337 --- /dev/null +++ b/docs/development/release-preparation-0.13.13.md @@ -0,0 +1,37 @@ +# Desktop 0.13.13 Preparation + +Prepared on 2026-09-23 from `b16fc90`, relative to published Desktop `v0.13.12`. +This is a Desktop-only release; Agent remains at published `0.13.3`. +No LoongArch preview is requested. + +## Scope and isolation + +- `bf8ff7f` reduces repeated activity-history reads during streaming saves. +- `b16fc90` restores compact supervision feedback controls and target names. +- The candidate is prepared in a separate worktree. The user's uncommitted + supervision timeout tests in the original worktree are explicitly excluded. +- Desktop and both root lockfile versions are `0.13.13`. Both feature matrices + and bilingual release notes were reviewed against this range. +- Database schema and Agent/Runtime contracts are unchanged. The activity + comparison cache belongs to Desktop persistence; it does not modify the + deployed Agent, model bridge, or remote Runtime lifecycle. + +## Validation + +- Six focused files passed 192 tests: activity-history I/O, AssistantDatabase, + storage upgrades, sidebar interactions, SupervisionCard, and the Supervisor + Electron layout fixture. +- Re-running `tests/supervisor-layout.electron.test.ts` with + `GOODBUDDY_SUPERVISOR_SIDEBAR=1` passed its additional sidebar scenario: + 480, 300, and 200 pixel widths in both themes, no horizontal overflow, + compact 34px buttons, visible keyboard focus, and no raw target ID in body text. +- `npm run release:notes:verify`, `npm run typecheck`, and `npm run lint` passed. +- Ten consecutive activity saves performed one full-history scan. WAL and SQL + counters are not installed-application physical disk throughput measurements. +- No real model requests, local full-suite rerun, production build, packaging, + or packaged-app probe were performed. UI validation uses production + components with isolated fixtures, not a real user database. + +The candidate must pass complete main-branch CI and its production build before +an unused annotated `v0.13.13` tag is pushed to both remotes. Native six-platform +packaging and public GitHub/OSS verification remain subsequent release steps. diff --git a/docs/features/assistant-workbar/execution-history-storage.md b/docs/features/assistant-workbar/execution-history-storage.md index 1d2b50a4..cf31a2df 100644 --- a/docs/features/assistant-workbar/execution-history-storage.md +++ b/docs/features/assistant-workbar/execution-history-storage.md @@ -33,6 +33,17 @@ 的缓存引用,不影响其他会话。若事务随后回滚或仍收到该任务的后续事件,按已提交记录重建。 释放引用不等于进程 RSS 立即下降,垃圾回收和 Runtime 自身会话缓存另按生命周期回收。 +## 活动历史连续保存 + +活动历史在桌面 `AssistantDatabase` 中按变化记录写入,保留记录顺序和重复 ID 的独立位置。 +连续保存使用最近一次成功提交的记录作为比较基准,不再逐次读取整份历史。关闭数据库、 +清空数据或检测到其他 SQLite 连接提交后重新读取;事务失败不更新比较缓存,重试仍基于已提交内容。 +本次优化不改变数据库 schema 或完整快照 IPC,也不改变 Agent、Runtime 和远程模型桥。 +本机与远程任务的桌面活动记录共用此保存路径,Host 不需要更新。 + +WAL 增长与 SQL 全历史扫描次数的定向验证见 [BUILD.md](../../../BUILD.md); +这些指标不等于安装后应用的物理磁盘吞吐测量。 + ## 会话列表读取与前端保留 列表读取与数据库存储是两个不同层次。`messages.metadata_json` 继续保留完整过程, diff --git a/docs/features/conversation-supervision/progress.md b/docs/features/conversation-supervision/progress.md index fe51668a..e39e20df 100644 --- a/docs/features/conversation-supervision/progress.md +++ b/docs/features/conversation-supervision/progress.md @@ -18,6 +18,19 @@ ## 验证证据 +### 2026-09-23 Desktop 0.13.13 侧栏布局回归 + +- 固定目标与刷新改用标题旁的共享图标按钮;目标显示会话/任务名称,缺失名称使用未命名文案。 + 对应 US-S25,行为见[会话侧栏](./ui-design.md#会话侧栏),未改变监督运行或取消逻辑。 +- `RightAssistantSidebar.resize.test.tsx` 66 项和 `SupervisionCard.test.tsx` 4 项通过。 + `tests/supervisor-layout.electron.test.ts` 的常规工作区场景通过,额外设置 + `GOODBUDDY_SUPERVISOR_SIDEBAR=1` 后的侧栏场景也通过:480/300/200px、 + 浅深主题、长标题、34px 按钮、键盘焦点与无横向溢出,共 6 种布局。 +- 完整 typecheck、lint 通过,真实模型调用 0 次。使用隔离组件 fixture,不代表真实 + 用户数据库端到端验收;发布验证范围见[候选记录](../../development/release-preparation-0.13.13.md)。 + +### 既有实现验证 + - `npx vitest run src/renderer/src/SupervisorWorkspace.test.tsx src/renderer/src/HeartbeatCenter.test.tsx`:17 个测试通过,覆盖统一页签、无计划手动回顾、加载状态、图谱真实连线与来源过滤。 - `npx vitest run src/main/assistant/supervisor-service.test.ts src/main/assistant/assistant-database.test.ts src/main/application-settings-store.test.ts src/renderer/src/ApplicationCenter.test.tsx`:166 个测试通过。 - `npm run typecheck`:通过。 diff --git a/docs/features/conversation-supervision/ui-design.md b/docs/features/conversation-supervision/ui-design.md index b003bc9e..c639343c 100644 --- a/docs/features/conversation-supervision/ui-design.md +++ b/docs/features/conversation-supervision/ui-design.md @@ -34,6 +34,11 @@ ## 会话侧栏 +监督反馈标题右侧使用共享紧凑图标按钮固定/取消固定目标与刷新回顾;固定状态通过 +`aria-pressed` 和按钮高亮表达。目标正文显示会话或任务名称,名称缺失时使用“未命名会话” +或“未命名任务”,原始 ID 仅作为悬停补充。无目标时禁用固定和刷新,读取中禁用刷新; +窄侧栏中的长标题换行,按钮保留可见键盘焦点。 + 仅在应用已启用时挂载监督面板及固定目标控件;关闭或设置尚未加载时不挂载,也不发起面板查询。任务列表仍按原规则显示。 右侧通用助手工作栏中的监督卡片展示“监督反馈”,沿用现有[工作栏设计](../assistant-workbar/prd.md)的布局和执行边界。当前支持 Conversation/Task:有选中任务时跟随任务,否则跟随会话;“固定监督目标”保存当前目标,切换聊天后保持,取消固定恢复跟随。卡片显示目标、结果真实范围、回顾区间和摘要,可刷新并查看匹配来源;无目标或无匹配结果显示空态。Experiment 尚未接入。 diff --git a/package-lock.json b/package-lock.json index 2a2f13b4..5ea09048 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "goodbuddy", - "version": "0.13.12", + "version": "0.13.13", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "goodbuddy", - "version": "0.13.12", + "version": "0.13.13", "license": "0BSD", "dependencies": { "@agentclientprotocol/sdk": "0.25.1", diff --git a/package.json b/package.json index 293e7e7b..b0da0f01 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "goodbuddy", - "version": "0.13.12", + "version": "0.13.13", "private": true, "description": "Secure desktop AI workspace with controlled Agent Runtimes", "desktopName": "GoodBuddy", diff --git a/resources/release-notes.json b/resources/release-notes.json index 49f56965..3caf7317 100644 --- a/resources/release-notes.json +++ b/resources/release-notes.json @@ -1,6 +1,34 @@ { "formatVersion": 1, "releases": [ + { + "version": "0.13.13", + "releasedAt": "2026-09-23", + "notes": { + "zh-CN": { + "highlights": [], + "features": [], + "fixes": [ + "**减少流式活动历史的重复读取**:活动历史较多时,连续保存流式更新不再每次重新读取整份历史。保留已有记录与顺序,保存失败后仍可重试。", + "**修复监督反馈侧栏布局**:固定目标与刷新操作使用标题旁的紧凑按钮,目标显示会话或任务名称。长标题和窄侧栏下保持内容可读,并保留键盘焦点提示。" + ], + "notices": [ + "本次仅更新 Desktop,Agent 保持 **0.13.3**,无需因此更新 Host 环境。从 Desktop 0.13.12 升级不新增数据库格式迁移。" + ] + }, + "en-US": { + "highlights": [], + "features": [], + "fixes": [ + "**Reduce repeated activity-history reads during streaming**: With a large activity history, consecutive streaming saves no longer reread the entire history on every update. Existing records and ordering are preserved, and failed saves remain retryable.", + "**Fix the supervision feedback sidebar layout**: Pin and refresh actions now use compact buttons beside the heading, and targets show conversation or task names. Long titles remain readable in narrow sidebars, with visible keyboard focus." + ], + "notices": [ + "This release updates Desktop only. Agent remains at **0.13.3**, with no Host update required for these fixes; upgrading from Desktop 0.13.12 adds no database format migration." + ] + } + } + }, { "version": "0.13.12", "releasedAt": "2026-09-23",