goodbuddy/docs/development/release-preparation-0.15.11.md

# Desktop 0.15.11 / Agent 0.15.4 发布准备

日期：2026-10-04。基线为已发布的 `v0.15.10`，冻结源码
`ea3d607fdd16fe24bc4be6a172884ef4d14ef244`。中断后按用户最新要求纳入
全部已提交改动，开始准备时工作区干净；不纳入随后出现的未提交工作。
标准六平台 Desktop、三平台 Agent，不含 LoongArch。

## 范围与升级边界

- 无模式执行：删除 Ask/Execute、安全设置分类及通用 toolApproval，
  普通请求使用启用能力和执行账号权限，内部文本任务保持无工具。
  旧 Ask 会话不再有产品只读隔离，必须在发布说明中明确。
- schema 59 增加状态计时和会话汇总索引，不扫描旧历史补算时长；
  schema 60 按已知 JSON 路径分批清理工作模式，并删除三列。
  保留正文、图片、稳定引用、远程去重身份；损坏元数据可见失败并保留已提交批次。
  Runtime 设置 22 清理顶层 toolApproval，保持加密凭据字节，不递归删除同名用户字段。
- 升级前关闭应用，备份完整数据目录（数据库、相邻 notes 与设置），
  大库可能耗时，回退须恢复升级前备份。0.15.10 的 NORMAL/FULL 边界不变。
- 远程 runtime/acp 能力从 5 升到 6，新增工作区 importFile 动作及时间字段；
  Continue helper 采用原生 agent。Agent 必须升级 0.15.4，最低 Desktop 0.15.11；
  wire major/minor 保持 2.0，Node/OpenCode/Continue 锁不变。
  更新前处理活动任务，不声称覆盖旧操作跨版本恢复。
- 工作区分块导入二进制与空文件，同名不覆盖，失败项独立反馈；按名称和时间排序。
  每目录最多读取 500 条，排序只覆盖已读条目，无传输中取消和百分比。
  移除成果页不删除数据库成果，不自动把会话附件或图片复制到项目目录。
- 图片仅消息引用也可发现，生成关闭时仍可保存；远程专家保持父请求执行空间。
- 项目菜单默认全部项目、归档恢复和明确进入，新本地项目必选目录、
  远程目录符号链接、OCR 提供方与 PPTX 图片位置诊断、完整输入缓存率。
- 回顾来源初始化和续跑移到 Worker；不宣称最后发布大事务已移出 Main。
  历史选择与布局统一，真实区间按主故事着色，空档中性、无归属事件保留；
  消息密度来自当前消息/小时桶，非历史快照，不补造故事归属。

## 证据与限制

审阅开发记录和临时原始验证说明：

- `docs/features/unified-execution/progress.md` 与临时
  `opencode/unified-execution-host/validation.md`：13 次真实文本请求。
  OpenCode/Continue 无模式、原生工具、detach、controller 恢复、重放、
  取消和续发检查；Continue 首次原生工具尝试暴露 readonly helper，
  改为 agent 后工具及取消场景通过，每轮所属残留进程为零。
- 临时 `opencode/expert-image-validation.md`：12 次真实文本请求，
  包含两次预算不足的准备尝试各 2 次及最终两个 Runtime 各 4 次。
  Host 保存、冲突、显式覆盖及替换 PNG 字节一致，桌面保存次数为零。
  这些是已有开发证据，累计 25 次文本请求、0 次真实图片生成；
  本次发布准备未新增提供方请求。
- 工作区 Host 探针：当前源码 Desktop 访问层、协议方法和真实文件系统，
  700001 字节二进制及空文件、同名冲突、时间与归属通过，模型调用零。
  不等于已安装签名 Agent 完整 attach/传输矩阵。
- 图片保存 Host 探针验证 SQLite 重开和仅 artifactIds 引用图片的分块保存；
  专家验证使用测试 PNG，不是提供方图片生成。
- 监督图谱定向测试、真实只读备份和 Electron 几何验证见监督进度；
  真实样本是点事件，不冒充真实持续区间着色证据。新增样式不影响 Agent。
- schema 60 合成迁移及真实 Worker 夹具通过，但用户生产旧库完整迁移取样、
  外部委派服务兼容性和跨版本旧远程操作恢复尚未覆盖。
  各性能数值仅限原报告路径、数据和机器，不作为普遍速度承诺。

## 已有 CI 与准备状态

`e205e909` 的 Desktop CI `37202987733`：6032 通过、56 跳过、3 失败；
Agent CI `37202987727` 通过。失败为监督旧 inline-error 断言、
窄栏 Escape 后状态未就绪、文件导入默认五秒超时及其清理竞态。
这些定向修正已经包含在 `ea3d607f`：改查通知回调的语气和消息，
等侧栏 inert 后再改变尺寸，导入多块真实文件测试专用 15 秒。
不跳过场景，不减少数据，不删除保存、冲突、键盘或布局断言。
最新开发验证不是本次精确候选全量 CI，不记为全绿。

按用户要求，不跑本地测试套件、类型检查、lint 或生产构建；
只校验发布元数据后推送，由 main CI 验证和构建。
通过后创建新不可变双版本标签，跟进原生打包和独立发布；
不下载、哈希或启动 Desktop 安装包，不发布宣传文章。
双语 FEATURES 与发布说明同步权限、迁移、配套升级和验收边界。

### 精确候选首轮 CI

`245e296a`：Desktop `37211139053` 为 6038 通过、56 跳过、2 失败，
Agent `37211139043` 通过；生产构建未执行。
App 旧测试仍假定回顾表单默认展开，改为点击“新回顾”后保留原按钮断言。
覆盖层堆栈通过仅编译测试 driver（不运行应用或生产构建）定位到窄转宽后的
侧栏按钮，先前 Escape 等待已通过；补齐宽高与 CSS 过渡结束后再原生点击。
保留 hit-test、侧栏 inert 和后续归档/弹层操作断言，等待下一轮 CI 验证。

`29af4090` 的 CI `37212673749`：上轮两项通过，6039 通过、56 跳过，
仅工作区导入 Electron 探针失败（Renderer 脚本执行异常）。
探针取消选择后按旧名称查询按钮并直接读 disabled，导入中的临时名称会使
查询为空；改为等待匹配按钮存在且可用，点击也使用同一就绪条件，并在脚本
异常中保留执行表达式和原始 cause。字节核对、同名保护、取消和旧图片保留
断言均保留；此为探针时序修正，不宣称修复产品导入故障。

`4e72aa04` 的 CI `37213768876`：导入及此前修正项通过，6039 通过、
56 跳过，唯一失败为活动分页等价测试默认五秒超时。该测试四个种子、
三种筛选分别渲染新旧组件共 24 次；仅将此项设为 15 秒，完整快照、
分组、数量、标题、状态和清空计数对比不变。