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

63 lines
3.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.1 / ds-bot 0.3.2-sansheng.2)
日期:2026-11-14
状态:**候选版本**。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。
## 1. 产物
| 包 | 版本 | 文件 |
| --- | --- | --- |
| `dsh-sansheng-sansheng` | 0.2.1 | `dist/dsh-sansheng-sansheng-0.2.1.tgz` |
| `ds-bot`(上游 0.3.2 + M-01–M-05) | 0.3.2-sansheng.2 | `dist/ds-bot-0.3.2-sansheng.2.tgz` |
云端预发布:`v0.2.0-sansheng`,https://git.qyhhh.top/DeepsSeekHarness/dsh-sansheng-liubu/releases/tag/v0.2.0-sansheng (两个 tarball 已作为 release assets 上传)。
构建命令(在包目录运行):
```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)。
- 两个包必须一起升级:`sansheng` 依赖 `ds-bot` 的 M-01 运行时句柄、M-04 投递边界、M-05 记忆域。
仅升级 `sansheng` 会导致项目隔离与自动返工不可用;仅升级 `ds-bot` 不影响上游行为,但新工作台无入口。
## 3. 安装 / 升级(用户自行执行)
1. 备份(用 Git,不建 backup 目录):确认日常 profile 的 `package.json` 与 `cordis.patch.yml` 已在 Git 控。
2. 停旧包:从 `dsh.profile.bundles` 移除 `dsh-sansheng-liubu-mode`(不要让旧十席与新方案同时注册入口)。
3. 安装两个 tarball:
```powershell
dsh plugin --profile desktop add <绝对路径>\dsh-sansheng-sansheng-0.2.1.tgz <绝对路径>\ds-bot-0.3.2-sansheng.2.tgz
```
4. 确认 `dsh.profile.bundles` 含 `dsh-sansheng-sansheng` 与 `ds-bot`。
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。
- `workspace-groups-remote` 项目树右键菜单未在真实测试 profile 复现(DS Bot 页面占据左栏);组件级 contextMenus 测试通过。用户日常环境若项目树可见,右键「三省六部」应可用;若不可用,用左栏底部「三省」入口。
- 深色模式、窄屏、长消息/连续工具流未截图验证。
- 项目树适配采用宿主原生 `contextMenus` + `sidebar.footer.action` + 右栏页签;不使用私有 DOM。
- `ds-bot` 补丁需在升级上游后重放(见 `ds-bot/PATCHES.md` 升级步骤)。