# 发布说明(候选版本 v0.2.2 / ds-bot 0.3.2-sansheng.2) 日期:2026-11-14 状态:**候选版本**。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。 ## 1. 产物 | 包 | 版本 | 文件 | | --- | --- | --- | | `dsh-sansheng-sansheng` | 0.2.2 | `dist/dsh-sansheng-sansheng-0.2.2.tgz` | | `ds-bot`(上游 0.3.2 + M-01–M-06) | 0.3.2-sansheng.2 | `dist/ds-bot-0.3.2-sansheng.2.tgz` | 云端预发布:`v0.2.2-sansheng`,https://git.qyhhh.top/DeepsSeekHarness/dsh-sansheng-liubu/releases/tag/v0.2.2-sansheng (两个 tarball 已作为 release assets 上传)。 ### v0.2.2 变更 - 角色卡模型下拉:`/sansheng/state` 返回可用模型目录,角色卡直接切换本项目该角色模型(无 API Key 时显示默认模型,不伪造可选项)。 - Q11:模型配置先全部解析校验,再应用;任一无效零修改,中途失败/保存失败回滚 runtime 模型。 - Q12:项目切换请求按上下文签名缓存,切到 B 后失败不会显示 A 的旧卡片与可操作内容。 构建命令(在包目录运行): ```powershell node 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` 升级步骤)。