80 lines
5.5 KiB
Markdown
80 lines
5.5 KiB
Markdown
# 发布说明(候选版本 v0.2.3 / ds-bot 0.3.2-sansheng.3)
|
||
|
||
日期:2026-11-14
|
||
状态:**候选版本**。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。
|
||
|
||
## 1. 产物
|
||
|
||
| 包 | 版本 | 文件 |
|
||
| --- | --- | --- |
|
||
| `dsh-sansheng-sansheng` | 0.2.3 | `dist/dsh-sansheng-sansheng-0.2.3.tgz` |
|
||
| `ds-bot`(上游 0.3.2 + M-01–M-06) | 0.3.2-sansheng.3 | `dist/ds-bot-0.3.2-sansheng.3.tgz` |
|
||
|
||
云端发布:**未执行**。按审查报告“不授权推送或发布”的约束,v0.2.3 只在本地构建了两个 tarball;待用户明确授权后再推送/开 PR/合并/发布。此前 `v0.2.2-sansheng` 仍是在线候选版本。
|
||
|
||
### 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)。
|
||
- 两个包必须一起升级:`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.3.tgz <绝对路径>\ds-bot-0.3.2-sansheng.3.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。
|
||
- Q04 记忆边界为源码级修复 + governance 回归;没有 ds-bot 整模块/真实宿主注入测试。
|
||
- Q08 只覆盖当前已知写工具(write/edit/apply_patch/shell/pwsh 等);第三方工具若绕过这些入口仍可能不受根租约约束,进程崩溃后的租约只能等过期。
|
||
- 真实模型 E2E(E01–E04)、深色/窄屏、长消息/连续工具流仍缺;不把 144 项单测写成真实 DSH E2E 全通过。
|
||
- `workspace-groups-remote` 项目树右键菜单未在真实测试 profile 复现(DS Bot 页面占据左栏);组件级 contextMenus 测试通过。用户日常环境若项目树可见,右键「三省六部」应可用;若不可用,用左栏底部「三省」入口。
|
||
- 深色模式、窄屏、长消息/连续工具流未截图验证。
|
||
- 项目树适配采用宿主原生 `contextMenus` + `sidebar.footer.action` + 右栏页签;不使用私有 DOM。
|
||
- `ds-bot` 补丁需在升级上游后重放(见 `ds-bot/PATCHES.md` 升级步骤)。
|