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

# Desktop 0.15.4 与 Agent 0.15.1 发布准备

日期：2026-09-29。用户确认两个补丁版本，提交并推送两个远端；
候选 CI 和生产构建成功后自动打标签发布，不构建 LoongArch。

## 范围与说明

- Desktop 已发布基线为 `v0.15.3`（`3c9229ac7a57071fc955adb1095c499ffdfd006a`）。
  本轮源码截止 `9c88ca20f3c62ca29b9aca179dc191b460db37d8`，开始时工作区干净。
- 三个提交包含系统任务 Token 统计、Runtime/模型分层和宣传稿归档。
  正式功能说明以实现为准；用途模型和旧全局 provider 移除仍为规划。
- Agent 基线为已发布 `agent-v0.15.0`。本轮 Continue helper 识别首次历史封装、
  去除保存消息中的工作模式前缀，因此发布新 Agent 0.15.1，不覆盖旧产物。
  Node 24.19.0、OpenCode 1.18.29、Continue 1.5.47 和协议锁保持不变。
- 正文仅维护在 Desktop 0.15.4 JSON 条目及 Agent 0.15.1 Markdown；
  已发布版本正文保留。FEATURES 中修正旧的简化选择描述，并同步用量、版本和限制。

## 数据与兼容

schema 49 在既有 SQLite 事务中迁移项目与会话选择，不引入额外恢复系统。
已读迁移指南并核对合成 schema 48 数据迁移回归；本轮不改写用户原库。
关闭应用后备份完整数据库及相邻 `notes/`，旧客户端不能打开升级后的库，
降级需要恢复完整升级前备份。远程先升级 Desktop 0.15.4，再更新 Agent 0.15.1。
统计无法补算历史未记录的调用或缺失的供应商 usage。

## 验证

- `npm run typecheck`、`npm run lint`、`npm run release:notes:verify` 通过。
- 10 个聚焦文件、221 项通过：包含数据库迁移/用量分类、选择解析、选择器、
  Activity UI、后台用量记录和 Continue helper。
- 当前源码隔离 Agent 在共享 Linux x64 Host 验证 OpenCode 与 Continue Ask、Execute、
  空闲进程回收及冷启动历史恢复。成功场景每个 Runtime 两次真实模型请求。
  OpenCode 原模型连接前三次尝试未完成，第三次脱敏诊断明确为上游 `ECONNRESET`；
  随后测试显式使用 Continue 已配置且成功的模型连接，未修改用户设置或产品回退规则。
  本轮共 7 次上游请求分发尝试，4 次成功、3 次未完成；不推断失败尝试的计费情况。
  所有探针结束时归属进程为 0，用户设置只在临时加密副本中读取，测试副本已清理。
- 既有开发记录缺少完整 UI 目测及全仓通过结果，保留边界，不将局部通过冒充全量。
  完整测试与生产构建交由精确提交 CI；不执行本地生产构建、打包或安装包启动。

## 首轮候选 CI

`ed47e2c` 已同步两个远端。Agent `36580699297` 三平台验证通过。
Desktop `36580699255` 为 5,472 通过、52 跳过、1 失败，生产构建未执行，
尚未创建任何本轮发布标签。问答测试在 Runtime 就绪前点击仍禁用的发送按钮，
没有产生首个请求；按现有异步同步机制等待按钮可用，保留全部问答与重载断言。
该修正仅影响测试和发布记录，运行时源码、锁文件及双语发布说明不变。
修正后完整 `App.test.tsx` 314 项通过，类型检查与 lint 再次通过。

## 发布前界面修正

用户要求移除会话 Runtime 按钮图标与名称间的圆点，并确认继续提交、推送和发布。
删除专用覆盖标记 class 及其伪元素样式，保留菜单内来源提示和恢复默认操作，
同步双语说明及选择设计。完整 App 与样式回归共 351 项通过，类型检查和 lint 通过。
该改动仅在 Renderer，不影响 Agent 或桌面至 Agent 协议，无需新增真实模型请求。
此前中断的测试不计为通过；本条结果来自重新执行。最终新提交仍须等待独立 CI。