dsh-sansheng-liubu/docs/verification/04-release.md

113 lines
9.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 发布说明(候选版本 v0.2.8 · 单包 `ds-bot-sansheng`)
日期:2026-11-14
状态:**候选版本**。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。
## 1. 产物
| 包 | 版本 | 文件 |
| --- | --- | --- |
| `ds-bot-sansheng`(DS Bot 0.3.2 底座 + 三省六部治理层) | 0.2.8 | `dist/ds-bot-sansheng-0.2.8.tgz` |
云端发布:**已发布预发布 `v0.2.8-sansheng`**(2026-11-14)。分支 `feat/dsbot` 已推送至 Gitea;单包 asset `ds-bot-sansheng-0.2.8.tgz` 已上传。发布页:https://git.qyhhh.top/DeepsSeekHarness/dsh-sansheng-liubu/releases/tag/v0.2.8-sansheng 。历史 `v0.2.7-sansheng` 保留为双包/zip 记录,日常 desktop profile 未由实施方修改。
### v0.2.8 变更(单包)
- 新增 `scripts/build-combined.mjs`:把 `ds-bot` 与 `dsh-sansheng-sansheng` 合并成一个可安装包 `ds-bot-sansheng`;宿主半同一补丁挂载两行,客户端半先应用三省六部再应用 DS-Bot。
- 独立测试 profile 安装单包并启动 Web:无未激活插件;`__SANSENG_WORKBENCH__=true`;原生项目树/聊天保留;右栏「角色」页签可打开;控制台无页面错误。
- 旧的两个包仍可继续使用;单包用于“只需更新一个包”的场景。DS-Bot 上游升级后需重新运行构建脚本。
### v0.2.7 变更(第四轮复审)
- R4-01/R4-02:后台 job 改用非消费式 `ctx.jobs.events` 观察终态,不再调用 `wait` 抑制原生完成通知;只在订阅到终态或订阅前 `get` 为终态时释放租约。
- R4-02:文件类写工具按实际目标路径追加租约,父子嵌套根写同一文件会互斥;目标越出项目工作根直接拒绝。
- R4-03:registry 严格校验 version/rooms/bots/updatedAt 与映射值;非法 schema 标 broken、阻止启动对账和 provision,且不覆盖坏 registry。
- R4-04:真实 catalog 的 needsKey 先于 available 判断,服务端不再放行缺凭据模型。
- R4-05:补偿前检查 runtime 是否仍是本次写入值,不覆盖用户新选择;恢复 appliedModel/appliedEffort 存在性;群 Session 失败改为抛错;默认模型恢复不覆盖等待期间的用户选择。
- R4-06:三省卸载撤销 `__SANSENG_WORKBENCH__`、发 `sansheng:workbench-gone`、清理样式;DS-Bot 晚收到 ready 时释放设置壳并恢复原 surface 偏好。
### v0.2.6 变更(Q08 后台 job)
- 写工具结果里出现后台 job id 且宿主提供 `ctx.jobs` 时,根租约不再随工具调用返回而释放,而是交给 `jobs.wait`,job 完成/终止后才释放;无 jobs 服务或同步失败时仍按原路径释放。
- 新增 Q08e 回归:后台 job 未结束前租约保留,结束后释放。
### v0.2.5 变更(第三轮复审补充)
- Q04 真实 memory 模块集成测试:peer stub loader 加载 ds-bot `memory.js`,验证被拒群记忆不进入 `agent/pre-step` 注入、显式 recall 返回拒绝,允许后才读取;同时避免注入空的群快照消息。
- UI01–UI03:三省客户端写入 `__SANSENG_WORKBENCH__` 标记;DS-Bot 进入原生共存模式,不安装全局 shell/conversation/主题/导航,不替换设置入口,不因缺少 TeamSidebar 重挂,不折叠宿主右栏。正向/反向加载顺序通过标记事件处理。
- Q01/Q02:主状态缺失但 registry 有证据时 health=missing + writable=false;启动对账/provision/事务拒绝覆盖 registry;registry 自身损坏单独记录,双文件故障时治理和门禁显式拒绝。
- Q08:工作根租约用 realpath 去 junction 别名,提交与写工具共用根锁,长工具每 5 分钟续租;后台 job 生命周期仍未覆盖。
- Q11:整段 runtime→Store→补偿按项目串行;失败角色本身也进入补偿,保留 model/appliedModel 是否存在;补偿失败写 `config-recovery.jsonl` 和事件。
- Q12:切换项目立即刷新唤醒、节流补 trailing;请求 12s 超时;Hook 保留 loading,加载中不显示初始化入口。
- Q13:DS-Bot 暴露 `availabilityOf`,配置/创建项目时服务端拒绝 needsKey 或不在目录的模型。
- 2026-11-13/14 的 v0.2.3 修复继续保留。
- Q01/Q02:Store 严格校验 v2/v3 schema;错误 JSON/schema/未来版本/空主状态进 broken,保留 registry;governance 对 registry 中的受治理 Bot/群在 broken/missing 时拒绝投递、记忆读写/注入。
- Q03:用户专属工具改为 `actor.kind === 'user'` 正向允许;unknown 不能 provision/bind/config/control/reconcile/lease。
- Q04:记忆补丁覆盖显式 recall、默认读取、群快照注入、autoRecall、memoryUpdate、目标 Bot 写入;Main 身份也不能绕过项目归属。
- Q05:派发意图/ in_flight 落盘失败时停止原生执行;原生已执行但回执失败标 unknown,不宣称成功。
- Q06/G06:事务在 draft 上落盘,成功后才发布;guard 通过后 observer 在 `next()` 前用最新 reviews/成果复核。
- Q07:truncated/missing/读取不完整的成果不能用于 stage_pass/goal_pass;缺失目录不再被 verify 当通过。
- Q08:真实写工具(write/edit/apply_patch/shell/pwsh 等)按规范化工作根独占;提交快照租约成功/失败都释放。
- Q09:HTTP/tool 核实校验 dispatch.projectId;状态更新与审计事件同一事务。
- Q10:重复 draft/start 不再把“目标本来就在该状态”记成 confirmed。
- Q11/Q12:保留 v0.2.2 的模型配置原子性与跨项目缓存隔离;Q12 增加切换时立即清空旧项目可操作数据。
- Q13:模型目录保留 `needsKey`,未配置凭据的选项禁用并标注。
构建命令(在包目录运行):
```powershell
node <path-to-pnpm.cjs> pack --pack-destination ..\dist
```
## 2. 兼容性
- 宿主:DeepSeek Harness 0.2.2-rc.3(本机真实宿主冒烟版本);0.2.x 同代接口按 `docs/p0` 记录。
- Node:>= 22(本机 24.21.0)。
- 单包 `ds-bot-sansheng` 内含 DS-Bot 与三省六部,二者版本一起发布;不再需要分别升级两个包。
- 旧双包布局仍可继续使用;不要在同一个 profile 同时启用单包与旧的两个包,否则会重复注册 Bot 行、右栏页签和工具。
## 3. 安装 / 升级(用户自行执行)
1. 备份(用 Git,不建 backup 目录):确认日常 profile 的 `package.json` 与 `cordis.patch.yml` 已在 Git 控。
2. 从 `dsh.profile.bundles` 移除旧的 `ds-bot` 与 `dsh-sansheng-sansheng`(若之前用的是双包布局)。
3. 安装单包:
```powershell
dsh plugin --profile desktop add <绝对路径>\ds-bot-sansheng-0.2.8.tgz
```
4. 确认 `dsh.profile.bundles` 含 `ds-bot-sansheng`,且不再含旧的 `ds-bot` / `dsh-sansheng-sansheng`。
5. 彻底重启 DSH(插件宿主半改动只有重启生效)。
6. 自检:
- 启动日志没有“未激活插件”;
- 打开任一项目会话,左栏底部出现「三省」;点击后在右栏看到「角色」页签;
- 未绑定项目显示「此项目尚未初始化」;初始化表单默认折叠;
- 已绑定项目显示三张角色卡,点击卡片打开对应 Bot 真实会话;
- `GET /sansheng/health` 返回 `governance: true`。
## 4. 回退
- 从 `dsh.profile.bundles` 移除两个新包,恢复升级前的 `package.json`/`cordis.patch.yml`(Git 回退)。
- 旧十席工作台可继续使用;新旧不要同时启用。
- `sansheng` 自己的状态文件保留在 `$DSH_HOME/sansheng/`,回退不删除;旧版不读 v3 字段时请先备份该目录(不属于用户数据迁移,只是回退保险)。
## 5. 数据迁移
- `sansheng` v2 → v3:只补 `seq/artifacts/leases/submissionSeq/delivery/schemaVersion`,保留旧 `projects/reviews/dispatches/reworks/events`。
- 旧十席数据、DS Bot `state.json`、旧工作目录均不迁移、不删除。
- 旧审查记录的 `digest` 被当作 `reviewSubjectDigest` 的兼容别名读取;新记录同时写两者。
## 6. 已知限制(必须随版本说明)
- 真实模型 E2E(E01–E04)未执行;隔离测试 profile 无 API key。
- Q04 记忆边界有真实 memory.js 集成测试(peer stub loader),覆盖群快照/显式 recall;真实模型/宿主记忆注入仍未做。
- Q08 已覆盖已知写工具、同根/junction 别名、提交与写工具共用根锁、过期租约接管、后台 job `ctx.jobs.events`、文件目标/嵌套根;shell 命令内部写和未知第三方工具仍可能绕过目标锁。
- Q11 有真实 `selectSessionModel` 串行/失败恢复、群 Session 失败、默认模型并发和 runtime CAS 回归;固定模型完整恢复未在真实宿主注入;sidecar 在 Store 完全不可写时也可能失败。
- Q12 有真实 `useSanshengState` Hook 级测试(mini React hooks);真实浏览器像素时间线仍未自动化。
- UI01–UI03 在隔离测试 profile 的浅色/深色 1440×900、窄屏 900×700 验证;三省卸载单测通过;DS-Bot 先加载的完整浏览器 disable/再启用未操作验证。
- 真实模型 E2E(E01–E04)、长消息/连续工具流仍缺;不把 154 项单测写成真实 DSH E2E 全通过。
- `workspace-groups-remote` 项目树右键菜单未在真实测试 profile 复现(DS Bot 页面占据左栏);组件级 contextMenus 测试通过。用户日常环境若项目树可见,右键「三省六部」应可用;若不可用,用左栏底部「三省」入口。
- 长消息/连续工具流未截图验证。
- 项目树适配采用宿主原生 `contextMenus` + `sidebar.footer.action` + 右栏页签;不使用私有 DOM。
- `ds-bot` 补丁需在升级上游后重放(见 `ds-bot/PATCHES.md` 升级步骤)。