7.4 KiB
发布说明(候选版本 v0.2.5 / ds-bot 0.3.2-sansheng.5)
日期:2026-11-14 状态:候选版本。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。
1. 产物
| 包 | 版本 | 文件 |
|---|---|---|
dsh-sansheng-sansheng |
0.2.5 | dist/dsh-sansheng-sansheng-0.2.5.tgz |
ds-bot(上游 0.3.2 + M-01–M-06) |
0.3.2-sansheng.5 | dist/ds-bot-0.3.2-sansheng.5.tgz |
云端发布:未执行。按审查报告“不授权推送或发布”的约束,v0.2.5 只在本地构建了两个 tarball;待用户明确授权后再推送/开 PR/合并/发布。此前 v0.2.2-sansheng 仍是在线候选版本。
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,未配置凭据的选项禁用并标注。
构建命令(在包目录运行):
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. 安装 / 升级(用户自行执行)
- 备份(用 Git,不建 backup 目录):确认日常 profile 的
package.json与cordis.patch.yml已在 Git 控。 - 停旧包:从
dsh.profile.bundles移除dsh-sansheng-liubu-mode(不要让旧十席与新方案同时注册入口)。 - 安装两个 tarball:
dsh plugin --profile desktop add <绝对路径>\dsh-sansheng-sansheng-0.2.4.tgz <绝对路径>\ds-bot-0.3.2-sansheng.4.tgz - 确认
dsh.profile.bundles含dsh-sansheng-sansheng与ds-bot。 - 彻底重启 DSH(插件宿主半改动只有重启生效)。
- 自检:
- 打开任一项目会话,左栏底部出现「三省」;点击后在右栏看到「角色」页签。
- 未绑定项目显示「此项目尚未初始化」;初始化表单默认折叠。
- 已绑定项目显示三张角色卡,点击卡片打开对应 Bot 真实会话。
GET /sansheng/health返回governance: true。
4. 回退
- 从
dsh.profile.bundles移除两个新包,恢复升级前的package.json/cordis.patch.yml(Git 回退)。 - 旧十席工作台可继续使用;新旧不要同时启用。
sansheng自己的状态文件保留在$DSH_HOME/sansheng/,回退不删除;旧版不读 v3 字段时请先备份该目录(不属于用户数据迁移,只是回退保险)。
5. 数据迁移
sanshengv2 → 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 返回后仍会释放租约,第三方工具若绕过这些入口仍可能不受根租约约束。
- Q11 真实
selectModel/忙碌会话故障注入未执行;补偿失败 sidecarconfig-recovery.jsonl在 Store 完全不可写时也可能失败。 - Q12 有真实
useSanshengStateHook 级测试(mini React hooks);真实浏览器像素时间线仍未自动化。 - UI01–UI03 在隔离测试 profile 的浅色 1440×900、深色 1440×900、窄屏 900×700 验证;Bot 详情/终端/文件交叉打开、DS-Bot 先加载顺序仍未操作。
- 真实模型 E2E(E01–E04)、长消息/连续工具流仍缺;不把 154 项单测写成真实 DSH E2E 全通过。
workspace-groups-remote项目树右键菜单未在真实测试 profile 复现(DS Bot 页面占据左栏);组件级 contextMenus 测试通过。用户日常环境若项目树可见,右键「三省六部」应可用;若不可用,用左栏底部「三省」入口。- 长消息/连续工具流未截图验证。
- 项目树适配采用宿主原生
contextMenus+sidebar.footer.action+ 右栏页签;不使用私有 DOM。 ds-bot补丁需在升级上游后重放(见ds-bot/PATCHES.md升级步骤)。