# 发布说明(候选版本 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 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` 升级步骤)。