chore: preserve final documents before project reset

This commit is contained in:
qyh15 2026-11-14 20:17:04 +08:00
parent 79ecd4fe70
commit 233ee7636b
1 changed files with 595 additions and 0 deletions

View File

@ -0,0 +1,595 @@
# 三省六部工作台:实施后独立审查与修复方案
## 第四轮复审:eb82c92 / v0.2.6(当前结论)
审查日期:2026-11-14。固定 HEAD:`eb82c921623e845ea9b281861d6f1e9b37837a1f`;相对第三轮 `1ee90d1` 变更 33 文件,+986/-118。版本:sansheng 0.2.6 / ds-bot 0.3.2-sansheng.6。以下结论取代历史报告的当前状态,不把旧问题机械地全部维持未修。
**结论:共存模式、恢复保护、切换状态和事务都有实质改善,但仍不能正式验收。新增后台 job 等待机制会与 DSH 自动完成通知冲突,是本轮最需要优先处理的宿主回归。** 完整测试 **159/159 通过,0 失败/取消/跳过**;首次 PowerShell 合并输出出现 exit 1,已用独立 dot reporter 重跑并明确取得 `NODE_EXIT=0`,不能把壳层异常当测试失败,也不能忽略未核查的非零退出。
本轮只更新报告。主审检查 UI/客户端和真实 DSH job 源码,两名独立审查分别检查模型与恢复/租约;动态反例均使用真实仓库模块加内存宿主或独占临时目录,未改日常 profile、安装包、真实会话,未启动 Electron、未发模型请求。代码契约证据不冒充真实浏览器 E2E。
### 已修与未关闭范围
| 项目 | 本轮判断 |
|---|---|
| Q01/Q02 上轮具体反例 | missing 主状态+有效 registry 的启动覆盖、主状态/registry 双坏 JSON 放行均已修;错误 registry schema 仍残留 |
| Q03/Q05/Q06/Q07/Q09/Q10 | 维持第三轮限定范围的关闭;Q06 不扩大为完整原生提交点 TOCTOU 证明 |
| Q04 | 新增真实 memory 模块+peer stub 的读取/注入集成测试通过;比上轮纯 governance 测试更强,仍非真实宿主多项目记忆 E2E |
| Q08 | junction 实际根、同步续租、提交共用 root lease 已补;后台 wait 与宿主通知冲突、wait 非终态释放、实际目标/嵌套根互斥仍未闭合 |
| Q11 | 当前失败角色纳入补偿、同项目配置串行、失败 sidecar、成功文案已修;未固定模型恢复、原生设置并发和群 Session 部分失败仍不一致 |
| Q12 | 原迟到失败、节流丢切换和 loading=false 反例可以关闭;真实 Hook 测试通过,增加请求超时与 trailing wake |
| Q13 | 前端禁用保持有效;真实 availabilityOf 实现仍把 needsKey=true 当可用,服务端未关闭 |
| UI01 | 首先识别共存模式时不再安装全局 shell/conversation;晚启用时设置层不退出,禁用标记不清理,仍部分修复 |
| UI02/UI03 | 共存状态下已加入跳过侧栏自检、禁止折叠宿主栏的检查,原机制反例在该条件下可关闭;未宣称所有加载/禁用切换 E2E 完成 |
### R4-01 · P1 · 为持租注册的 jobs.wait 抑制原生后台完成通知
**位置与证据**:[observer 后台分支](<../sansheng/src/observe.js#L183>) 调用 `jobs.wait(jobId,24h,sessionId)`,Promise 完成后只释放锁。安装中的 [dsh-jobs-local settled 实现](<C:/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-jobs-local/lib/index.js#L791>) 在结算时将 `awaited` 设为 waiter 数量大于零;[dsh-tool-jobs 通知订阅](<C:/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-tool-jobs/lib/index.js#L359>) 对 `event.awaited` 直接 return,不调用 deliverSettlement。
**影响条件**:当该新 waiter 被宿主接受并在 job 完成时仍存在,原生自动完成通知/唤醒会被抑制,而三省插件没有替代交付。模型可以主动读取 job_output,但不能继续依赖自动完成通知;这会改变正常 DSH 后台任务行为,不只是极端故障。证据为本机真实宿主源码调用链,未在用户会话启动后台写任务。
**修复**:不要用具有“结果有人接收”语义的 wait 做旁路锁监控。使用宿主支持的非消费式生命周期事件,并保留会话归属校验;处理订阅与任务已完成的竞争窗口。添加真实 job service 与通知订阅组合测试,断言锁保持到终态、原生通知恰好一次且正确唤醒。
### R4-02 · P1 · wait 返回并不等于任务结束,失败/超时路径仍提前释放
[observer](<../sansheng/src/observe.js#L189>) 忽略 wait 的返回状态,catch 吞错误,finally 无条件释放。宿主 [waitJob](<C:/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-jobs-local/lib/index.js#L662>) 在超时后 resolve 并返回当前 JobView,可能仍为 running/stopping,而不是保证终态。
本轮真实 observer+契约合法的内存替身返回 `{status:'running'}`,得到 `WAIT_TIMEOUT_RUNNING leaseReleased=true`。在当前 24 小时等待预算到期、或 wait 因权限/未知 job 失败时,后台进程可能还活着,第二写者却可进入。新增测试替身只返回 completed,未覆盖此契约。
**修复**:仅在确认 terminal 状态或真实停止后释放;观察失败应进入可查询的不确定状态,不能自动视为完成。续租已经实现,故不再沿用“正常长任务必定 30 分钟过期”的旧说法;但续租失败/返回 ok=false 被吞时,仍需防止租约到期后活跃旧执行与新持有者并行。
**Q08 仍有目标范围问题**:[observeWrite](<../sansheng/src/observe.js#L160>) 只以 project.workDir 加锁,不读 write/edit 的 file_path 或 pwsh.workdir;两个不同项目根写同一绝对目标、父子嵌套根覆盖同一文件,仍拿不同键。realpath/junction 修复只关闭相同物理根别名。unknown/冲突/无 workDir 仍直接 next。应验证工具实际允许的路径范围,并按重叠物理目标或明确禁止越界的策略互斥。
### R4-03 · P1 · registry 的合法 JSON、错误 schema 仍被当健康空登记
[registry 解析](<../sansheng/src/store.js#L219>) 仅要求顶层 object,将错误 rooms/bots 类型回退为空对象,仍标 registryStatus=ok;缺版本和映射值校验。真实 Store 临时目录复现:主状态缺失,registry 为 `{"version":1,"rooms":[],"bots":[]}`,得到 `registryStatus=ok,registryEntries=0,writable=true`,team 记忆 allow=true;启动 reconcile 返回 0 后 health=ok,登记又被覆盖。
上轮“有效 registry+主状态缺失”和“双非法 JSON”的修复有效,不能回退评价为完全未修;残留是同类 schema 边界未扩展到 registry。应完整验证版本、必需字段、rooms/bots 类型及映射值;非法对象标 broken,阻止启动对账/provision,明确区分首次安装。新增 null/数组/字段缺失/映射错误/未来版本矩阵,并走真实 apply 启动链。
### R4-04 · P2 · Q13 可用性检查被真实 catalog 的语义绕过
[availabilityOf](<../ds-bot/src/host/models.js#L327>) 先 `entries.some(ref)` 就返回 available=true;真实 catalog 保留 needsKey,answerable 只排除 refused 路由。所以下方 needsKey 检查对仍在目录的缺 key 模型不可达。
本轮真实 models+roster+provision 内存复现:`catalog.needsKey=true`、`availabilityOf={available:true}`、`updateProjectConfig.ok=true`,Bot/Session 均被设为该模型。新的 provision 预检查接线已经有了,但依赖函数实现错误。测试手工替换 availabilityOf 返回正确拒绝,未测到真实语义。
**修复**:先查匹配条目的 needsKey 再返回 available;区分目录失败、ref 不存在、拒绝路由。补真实三个模块组合测试,不能仅 stub 本次待验证的函数。新建项目与更新模型都要走同一正确检查。
### R4-05 · P2 · Q11 部分补偿仍报告成功,但实际 Session/用户设置不一致
本轮已关闭“当前失败角色完全漏补偿”的控制流,也关闭两个 sansheng_config 请求之间的旧并发反例;保留这些修复。真实 models+roster+provision 的内存故障注入仍确认:
1. **未固定模型恢复不完整**:[restoreRuntimeModel](<../sansheng/src/provision.js#L304>) 仍依赖普通 updateBot。旧 model/appliedModel 都不存在时,补偿删除 model,但 Session/appliedModel 留在新值;旧 model 缺失而 appliedModel 有值时,补偿把它变成固定模型;旧自有 model:undefined 时,真实 roster 忽略 undefined,全部保留新值。三个分支都可返回 recoveryRequired=false 和已回滚。
2. **原生 DS-Bot 设置不参与项目锁**:项目请求应用 new,提交 Store 的窗口内真实 rt.updateBot 成功改为 user,随后 Store 失败,旧补偿又恢复 old,撤销用户成功修改。需要 runtime 版本/CAS,而不只是当前模块的项目锁。
3. **群 Session 失败仍吞掉**:[applyModel](<../ds-bot/src/host/models.js#L257>) 对群 selectModel 失败只 warn,仍推进 appliedModel;实际本人 Session/Store=new、群 Session=old,配置服务返回成功,不触发 sidecar。
4. **原生默认模型并发**:[selectSessionModel](<../ds-bot/src/host/models.js#L227>) 的普通串行恢复有宿主契约依据,不应指责必然乱序;但它无条件写回旧默认,用户在 await 窗口里的原生默认选择仍可被覆盖。该机制早已存在,本轮内存调度复现,不是新引入或真实 profile 已被修改。
**修复**:以真实 runtime 恢复契约保存字段存在性与 Session 选择,恢复后读取实际值验证;补偿需验证版本归属;聚合本人/群应用结果,部分失败明确 recoveryRequired。sidecar 目前只捕获抛错,不能捕获这种静默不一致。新增真实 selectSessionModel 串行测试有价值,但不能替代这些场景。
### R4-06 · P2 · 原生共存模式的晚加载与卸载仍不完整
**已有效部分**:三省先激活时,DS-Bot 初始化 Agent 模式,不装 shell/conversation/settings shell;晚激活事件也会切换 Agent;verifySidebar 和右栏监听加入共存检查,避免上轮错误重挂/折叠。
**晚加载残留复现**:提取执行真实 [共存事件 effect](<../ds-bot/client.js#L29394>) 与 [settings-shell effect](<../ds-bot/client.js#L29554>),最小 ctx 服务替身先让 DS-Bot 安装,再发三省 ready。结果 `mode=agent,settingsInstalled=1,settingsDisposed=0`。事件只切 surface,独立 settings effect 已安装的 sidebar.settings/settings.trigger 注入和相关快捷键并未退出;其卸载仅发生在 DS-Bot 自身 effect dispose。DS-Bot 先加载时的自动导航也可能早于 ready 事件,事后切 Agent 不能证明从未改过当前会话。
**卸载残留复现**:真实三省 apply 注册完成后执行 ctx 捕获的全部 disposer,`__SANSENG_WORKBENCH__` 仍为 true,事件只有 workbench-ready。[标记写入](<../sansheng/client.js#L1157>) 不在 effect 生命周期内,未发布撤销,也不恢复此前模式。CSS 同样缺清理。应使用可订阅、可撤销的能力声明,进入共存时退出已装设置层;禁用时按清晰规则恢复用户原偏好,不能留下全局永久开关。
**修复验收**:DS-Bot→三省、三省→DS-Bot,两种加载顺序;禁用/重新启用各一次;原生设置入口及快捷键归属不变,普通会话不自动跳转,标记/事件/样式清理可验证。不是再加一张静态截图即可关闭。
### 视觉证据与下一轮重点
已查看实施方 [原生共存截图](<verification/evidence/host-native-coexistence.png>)、[深色截图](<verification/evidence/host-dark.png>)、[900×700 窄屏截图](<verification/evidence/host-narrow.png>):原生品牌/更多入口、聊天新会话界面和右侧三卡可见,深色跟随也可见。较前轮有明确进展。画面为新会话欢迎态,不能证明已有会话长工具流、忙碌切换、正反加载顺序或 disable 清理;原生欢迎态输入框在中部并不构成输入框漂移缺陷。
下一轮优先:**R4-01/02 后台任务契约与通知 → R4-03 registry schema → R4-04/05 真实 runtime 配置回归 → R4-06 生命周期共存**。修正验收矩阵中 Q08/Q11/Q13 的“已修”绝对表述。保持用户要求的左侧宿主项目树、中间原生聊天、右侧角色卡/折叠 Bot 列表;E01–E04 与 H01–H08 仍应按实际证据验收,不以测试数量代替。
---
## 第三轮复审:1ee90d1 / v0.2.3(历史记录)
审查时间:2026-11-14,Asia/Shanghai。固定 HEAD:`1ee90d1a42a99e7c487e2be75fefbde229935495`;相对 `7746edb` 变更 28 文件,+929/-138。包版本为 sansheng 0.2.3 / ds-bot 0.3.2-sansheng.3。以下更新取代第二轮的当前状态判断;历史复现继续保留。
**结论:有实质修复,但仍不通过正式验收,尤其 UI/DSH 共存问题未修。** 本轮独立运行 **144/144 测试全部通过**;客户端、observer、Store、DS-Bot memory 的语法检查通过。只更新本报告,没有修改业务代码、profile、安装目录或真实会话,也没有推送。现有测试与新增截图不能证明所有 Q 项已关闭。
### 本轮关闭情况
| 问题 | 当前判断 | 依据与范围 |
|---|---|---|
| UI01 / UI02 / UI03 | 未修 | DS-Bot 客户端与 bundle patch 相对上轮无任何差异;全局模式接管、错误重挂、右栏争用机制原样保留 |
| Q01 / Q02 | 部分修复,P1 未关闭 | schema 校验与 intact registry 拒绝已补;主状态缺失后的启动对账仍自动覆盖 registry;双文件故障仍按 unbound 放行 |
| Q03 | 原复现可关闭 | 管理工具与 provision 明确要求 user,unknown 不再等同用户 |
| Q04 | 原跨域路径静态修复;集成验证不足 | group 读取/注入与 targetBotId 检查已补;新增测试主要调用 governance,并非完整 memory 实际入口集成 |
| Q05 | 原复现可关闭 | begin/inflight 落盘失败阻止 next;原生已返回而回执写失败标 unknown |
| Q06 | 原“落盘前脏读”可关闭 | 草稿提交后发布;observer 增加 next 前复核。不是完整原生提交点 TOCTOU 证明;公开对象可变性另有局限 |
| Q07 | 原 missing/truncated 反例可关闭 | 成果验证、review、gate 增加不完整快照拒绝 |
| Q08 | 部分修复,P1 未关闭 | 同文本工作根的同步名单工具已加锁;后台作业、TTL、真实根别名、目标路径及提交互斥仍不完整 |
| Q09 | 原复现可关闭 | dispatch 核实按所属项目校验,事件和状态同事务 |
| Q10 | 原复现可关闭 | 重复 draft/start 不再凭 after.status 判 confirmed |
| Q11 | 部分修复,P2 未关闭 | 仅新增回滚失败文本事件,失败角色漏补偿、未固定模型语义与并发补偿原机制未改 |
| Q12 | 部分修复,P2 未关闭 | 迟到异常检查已补;hook 节流仍丢切换,loading 又被强制写 false |
| Q13 | 前端已修,服务端未修,P2 未关闭 | needsKey 保留且选项禁用;实际配置服务仍接受 needsKey=true 的模型 |
### 本轮最关键 P1:主状态缺失时,正常启动会清除治理登记
**位置**:[启动 load 后立即对账](<../sansheng/index.js#L42>)、[missing 分支](<../sansheng/src/store.js#L197>)、[transact 无健康写保护](<../sansheng/src/store.js#L259>)、[启动对账事务](<../sansheng/src/store.js#L497>)。
**真实 Store 临时目录复现(独立审查 agent 执行)**:先建立项目 A 并保存有效 registry,仅移除该临时测试的主状态文件,再创建新 Store。
1. load 后:`health=missing`,registry 仍有 RA→A、AL/AS/AG→A,治理暂时拒绝。
2. 调用启动时必经的 `reconcileDispatches(newBootId)`,返回 0(没有任何待恢复记录)。
3. transact 仍写入空主状态与空 registry,发布 `health=ok`。
4. 此后 A 的 team 记忆检查返回 allow;此前受治理的 A 群失去项目绑定,目标门禁按未绑定路径放行。
**这不是只有手动新建项目才触发的边缘情况,正常启动流程就会触发。** 现有 Q01b 测试只断言 load 后身份保留,漏了紧随其后的启动对账。合法 saveProject(B) 同样能覆盖遗失 A 的 registry。
**修复**:将“首次安装无状态”与“主状态缺失但有治理证据”设为不同健康状态;后一状态的 transact、启动对账、provision 均必须拒绝写入,直到明确完成恢复,不能由一次空事务重置为 ok。加入真实 apply 启动链测试,断言零待恢复记录也不会覆盖登记。
**Q02 补充反例**:主 state 与 registry 都损坏时,registry 异常在 [load](<../sansheng/src/store.js#L212>) 被吞为“无提示”,governance/门禁仍把主体降级为 unbound。临时目录中真实治理和 gate 都出现 ALLOW。应跟踪 registry 自身健康,双文件故障须显式不可判定;不能用正常未绑定语义静默处理。该结论不表示本轮实际改坏过用户文件。
### Q08:新租约只覆盖工具调用时段,尚未覆盖真实写作业生命周期
[observeWrite](<../sansheng/src/observe.js#L160>) 现在在 next 前取 root lease、finally 释放,修复同步名单工具和成果提交普通结束后的留锁。但源码仍有以下边界,未执行真实后台写作业:
- pwsh 等返回后台 jobId 时,工具调用返回不等于进程停止写入;finally 此时已释放,第二个写者可进入。同步长任务超过默认 30 分钟 TTL 也没有续租。
- 根键只根据 project.workDir 的 resolve/大小写规范化计算,没有 realpath;junction 别名、不同名义根下指向同一绝对目标文件仍可分别加锁。必须覆盖用户 farm/junction 的实际使用方式。
- unknown、身份冲突、无 workDir 分支直接 next;这些路径不受租约保护。成果提交仍用 project lease,写工具用 root lease,两者不互斥,不能阻止采集快照时并发修改。
**修复**:以实际允许的文件根/目标路径和真实 job 生命周期管理租约;物理根去别名,长任务续租,后台完成或确认取消才释放;提交和执行共用同一互斥规则。限制未知写工具/工作根的行为应有明确策略,不能宣称已经实现所有真实写入口单写。
### Q11:新增事件不等于事务修好
[本次 provision 改动](<../sansheng/src/provision.js#L319>) 仅在补偿调用抛错时尝试写 config-rollback-failed;相同 Store 故障下该事件仍可能失败并被吞。第二轮已确认的三个核心反例仍保持同一代码:失败的当前角色未进入 applied、无 model 与 appliedModel 混用、失败请求无条件补偿撤销另一个成功请求。保留第二轮修复方案,不能把 Q11 标为已修。
证据限定:本轮源码与真实 runtime 契约重新核对;子审查尝试重跑旧内存脚本时被自动审批拒绝,明确未执行且未给具体原因,没有绕过重试。因此这些 Q11 旧反例是“旧动态证据+本轮代码未改”,不是本轮重新动态跑通。模型成功回执仍保留“正在运行的会话不受影响”,仍缺真实忙碌会话依据。
### Q12:原始 Hook 复现仍有两个可见问题
**位置**:[poller 切换清缓存](<../sansheng/client.js#L345>)、[useSanshengState](<../sansheng/client.js#L404>)、[一秒节流](<../sansheng/client.js#L427>)。
本轮执行真实 poller 与提取的原始 Hook,React 状态/订阅采用内存替身:
- A 已显示→A 同上下文通知发出一个悬挂请求→10ms 后主会话切 B。wake 因一秒节流直接丢弃,输出 `actualWorkspace=wb,shownProject=A,shownWorkspace=wa,requests=2`;没有发 B 请求。timer 在悬挂请求 finally 才重新安排,所以没有后续事件时旧 A 数据可持续保留。迟到错误的检查无法覆盖“请求根本未返回”。
- 正常发出 B 请求时 poller 发出 loading=true/data=null,但 Hook 在 setState 中硬编码 loading=false。输出 `workspaceId=B,loading=false,error=null,data=null`;RolesView 的条件将其当作未初始化,显示初始化入口。
**修复**:项目身份变化走即时失效通道,不受普通状态通知节流;普通节流必须补 trailing 调用。对旧请求支持取消/超时,不能依赖 finally 才能继续轮询。Hook 正确传递 loading,并在未知/加载阶段禁止初始化及旧项目操作。新增 Hook 级测试覆盖上述时间线,不能只测 poller 单次请求。
### Q13:UI 禁用已生效,但服务端仍能接受不可用模型
本轮使用真实 models/roster/updateProjectConfig,内存宿主的 missingKeys 明确返回 provider p 缺凭据。实际输出:`needsKey=true,result.ok=true,Store.models.lead=p/a,runtime.model=p/a`。未发真实模型请求。
[resolveModel](<../ds-bot/src/host/models.js#L161>) 仍只判断 ref 是否存在;[配置服务](<../sansheng/src/provision.js#L273>) 未补可用性校验。折叠配置表单的手写模型和 API/工具入口可绕过下拉禁用。保存端应重新读可信目录并拒绝已知 needsKey=true,同时区分目录不可用与有效模型;保留已做好的前端提示。
### UI/DSH 专项判断与交付要求
**UI01–UI03 全部维持上轮结论及 P1/P2 优先级。** 本轮 git diff 确认 DS-Bot 客户端未改;需要实现原生工作台共存模式,不是仅再加截图。新增 [v0.2.3 冒烟截图](<verification/evidence/host-v023.png>) 确实可见左树、底部输入框、右侧三卡和折叠 Bot 列表;它只证明该时刻浅色 1440×900 的静态布局,不能证明默认模式、重挂、切换、主题、设置和抽屉互斥没有冲突。本轮没有操作运行中的日常 GUI,也没有声称它已经损坏。
实施方的 [验收矩阵](<verification/02-test-matrix.md#L89>) 把 Q01/Q02/Q11/Q12/Q13 标为已修,需按以上证据改为部分修复;Q04 应继续写源码级、Q06 应限定为原脏读反例关闭,不泛化为完整事务安全。原 Q06 返回对象仍可别名到发布状态是内部封装局限;本轮未证明现有正常入口会利用这种引用修改审批,故不新增外部可利用漏洞结论。
优先顺序:**启动恢复保护(Q01/Q02)与原生 UI 共存(UI01–03)→实际写生命周期(Q08)→模型事务(Q11)→切换状态与模型可用性(Q12/Q13)**。继续执行第二轮 H01–H08 与首轮真实 E01–E04;不能用测试总数替代验收。先在隔离真实宿主验证,再由用户决定日常更新。
---
## 第二轮复审:7746edb / v0.2.2(历史记录)
**仍不通过正式验收。尤其不能据此版本宣称与现有 UI / DSH 无破坏性冲突。** 本轮按用户追加要求,重点检查原生聊天、项目树、右栏、设置入口、主题与会话模型的共存边界。下方“首轮历史报告”保留原始证据;其“123 项测试”“8 P1 / 4 P2”等是旧基线数据,不是本轮结果。
范围:`7c79de3 → 7746edb`,中间实施提交 `0d4372a`;12 个文件 +239/-27。最新版本为 `dsh-sansheng-sansheng@0.2.2`,配套 `ds-bot@0.3.2-sansheng.2`。本轮没有修改业务源码、安装包、profile 或日常会话,没有提交或推送,只更新这份审查文档。
### 当前判定与证据边界
- **旧 Q01–Q10:未关闭。** 相关治理、Store、成果、派发、记忆与租约代码在本轮差异中未改;Q09 所在路由只新增模型目录,未改 reconcile 路径。本轮没有把全部旧复现重新跑一次,沿用前轮证据并核对相关代码未变。
- **Q11、Q12:部分修复,均未关闭。** 新增测试覆盖了较简单的失败路径;真实模块或原始函数故障注入仍能复现遗漏路径。
- **新增 Q13(P2)、UI01(P1)、UI02(P2)、UI03(P2)。** 汇总为 16 个未关闭问题:9 P1 / 7 P2。UI 问题来自配套 DS-Bot 已有逻辑与三省六部补丁的组合,不表示全部由 v0.2.2 新增。
- **127/127 本地测试通过,0 失败**;三省六部客户端、provision、route 的语法检查均通过。真实模块复现使用内存宿主服务,UI 分支复现执行原始函数及最小服务替身,均不是浏览器 E2E。
- **日常安装与候选版本必须分开。** 只读检查发现 desktop 的包清单仍声明旧 `dsh-sansheng-liubu-mode`;其旧客户端 `mainTakeoverEnabled()` 仍直接返回 false。desktop 的顶层 `dsh-sansheng-sansheng` 目录不存在;`ds-bot` 目录为指向本仓库的链接。包清单、文件与链接不能证明运行实例已加载哪个模块;本轮没有已认证的实际页面操作通道,不能断言当前 7210 页面已发生以下视觉故障。
### UI01 · P1 · 保留项目树的补丁没有阻止 DS-Bot 全局界面接管
**位置**:[默认模式与界面分组](<../ds-bot/client.js#L23817>)、[默认 Bot 模式](<../ds-bot/client.js#L23884>)、[Shell 安装](<../ds-bot/client.js#L29733>)、[全局主题覆盖](<../ds-bot/client.js#L29060>)、[聊天控件替换](<../ds-bot/client.js#L29771>)、[启动导航](<../ds-bot/client.js#L29160>)。
**确定行为**:没有既存偏好时 `readMode()` 返回 bot;`groupsFor({mode:'bot',plain:true})` 仍返回 `{shell:true,conversation:false}`。三省六部 M-06 仅在角色页签已注册时跳过 TeamSidebar,但仍装载全部 Shell 样式、frame 监听、全局 `theme.overrideTokens('ds-bot', ...)`、品牌、设置触发器与设置 launcher 替换。普通会话虽然撤掉 conversation 层,shell 仍然保留。Bot 会话还会替换消息、header、composer,以及把原生 permission/plan/model 插槽替换为 Nothing;这是 DS-Bot 上游界面设计,但与本项目保留原生 UI 的要求冲突。
**另一个宿主影响**:默认 Bot 模式启动会 `ensureBotHome()`;roster 就绪、有 Main Bot、当前主会话不在 Bot/room 集合时,`homeToMainBot()` 会主动打开 Main Bot。条件成立时可能把用户从当前普通会话带走。本轮只核对代码条件,未操作日常页面。
**影响边界**:确认有跨组件主题/入口/导航修改机制,不能宣称只在右栏增加卡片;不等于已证明当前输入框移位、白屏、DSH 崩溃或会话数据丢失。M-02 保留原生设置、M-03 捕获重复注册异常值得保留,但不覆盖本问题。`freePriority` 会取比现有注册更低的数值,需结合实际宿主插槽优先级和已装 better-chat/better-sidebar 验证最终胜出者。
**最小修复**:建立明确的“原生工作台共存模式”,在该模式下保留 DS-Bot Host 能力,客户端仅贡献所需右栏/操作入口;不启用全局 shell/conversation 替换,不自动导航 Main Bot,不覆盖宿主主题与设置入口。不能只依赖用户恰好曾选择 Agent 模式,也不能只修左栏单个插槽。共存模式应通过稳定配置/服务声明,避免单次查询另一个插件页签推断模式。
**验收**:首次安装、已有 Bot 偏好、普通会话、三角色会话、禁用/重新启用、两种插件加载顺序,均保持原生主聊天与输入框;与当前 better-chat、better-sidebar、workspace-groups-remote 同时启用验证。未明确选择 Bot 全屏模式时不得改变主题、设置入口或当前会话。
### UI02 · P2 · 正常保留原生项目树被当作失败,反复重挂整个界面
**位置**:[M-06 跳过 TeamSidebar](<../ds-bot/client.js#L29744>)、[verifySidebar](<../ds-bot/client.js#L29877>)、[remount 的卸载范围](<../ds-bot/client.js#L23860>)。
**复现**:提供已声明的 `sidebar.workspaces` 插槽、不包含 TeamSidebar 的 entries、bot 模式,执行原始 verifySidebar 及排队定时器。结果:`remounts=3,warnings=3`。这恰是 M-06 成功保留原生树后的正常状态,却被当作 DS-Bot 侧栏丢失。每次 reconcile 又将尝试计数归零;不是无限紧循环,但会重复触发。
**影响**:`remount('shell')` 先撤掉 conversation,再撤掉 shell,之后重新安装;可能导致主题、菜单、输入组件反复卸载,焦点和局部输入状态丢失需在真实浏览器进一步确认。另一个加载顺序问题是 M-06 仅在安装时查看页签:若 DS-Bot 先挂载且 TeamSidebar 已存在,检查反而视为成功,后来的三省六部页签注册不会自动使它退出。
**修复**:检查预期界面模式;原生共存模式不应期待 TeamSidebar,也不应据此重挂整个 shell。订阅稳定的共存能力变化或在宿主配置阶段确定模式,支持正反加载顺序。验收时注入计数应稳定,不应出现三次“missing/remounting”警告。
### UI03 · P2 · DS-Bot 抽屉会主动折叠宿主右栏,与角色卡和其他右栏工具争用
**位置**:[右栏决策函数](<../ds-bot/client.js#L28444>)、[全局 one right panel 监听](<../ds-bot/client.js#L29605>)。
**复现与条件**:原始 `drawerOpened(true)` 返回 `collapse-column`;ui.details 从无到有且宿主右栏已打开时,订阅回调调用 `sidebar.toggleExpanded()`。该监听安装在 apply 的全局 effect 内,并非三省六部角色页签范围。宿主栏打开遇到“抽屉存在+会话切换窗口”时也选择折叠宿主栏。
**影响**:打开 Bot 详情等抽屉可以把三省角色卡、文件或终端所在的原生右栏关掉;存在导航互相争夺。是否涉及 better-sidebar 自定义布局,取决于其是否复用这些属性/服务,需要组合实测。
**修复与验收**:共存模式禁止 DS-Bot 全局控制宿主右栏展开状态;详情应交给宿主页签/受控面板呈现。连续切换 A/B 项目、角色卡、文件、终端和 Bot 详情时,只有用户请求的目标面板变化,不得因为后台状态事件折叠角色栏。
### Q11 复审 · P2 · 模型配置仍非完整可恢复事务
**已修部分**:先解析所有输入模型,避免后一个模型无效时先改前一个;新增对部分 runtime/Store 失败的补偿。
**仍存在四条确定反例**。本轮导入真实 [updateProjectConfig](<../sansheng/src/provision.js#L273>)、[roster.updateBot](<../ds-bot/src/host/roster.js#L429>) 和 [models.install](<../ds-bot/src/host/models.js#L250>),以内存服务注入故障,主审再次执行确认:
1. **当前失败角色漏补偿**:`applied.push` 在 updateBot 成功后;真实 updateBot 先改 model 并 save,再 applyModel。尚书 selectModel 抛错后,返回“已回滚”,但尚书 model 已是 `p/a`,appliedModel 和 Store 仍是 `p/old`。
2. **缺失模型的语义丢失**:旧 `model` 缺失、`appliedModel=p/old` 时,回滚会将 model 固定为 p/old;两者原先都缺失时,补偿 `{model:null}` 不恢复 Session 选择,Session/appliedModel 仍为 p/a,却返回“已回滚运行时模型”。
3. **失败请求撤销成功请求**:A 改 p/a 后在 Store 提交处暂停;B 改 p/b 并成功;A 提交失败并补偿。最终 Store=p/b,而 runtime 与 Session=p/old。Store 内部串行事务没有覆盖整个 runtime→Store→补偿流程。
4. **补偿失败不可持续追踪**:返回一次文本警告,未持久记录恢复待办及 before/desired/actual 差异;刷新后只剩过时 Store 值。
**DSH 影响**:真实 applyModel 会调用本人及群 Session 的 `sessionController.selectModel`,部分群会话失败只 warn。因此成功回执“正在运行的会话不受影响”缺乏证据。本轮没有真实忙碌会话测试,不据此断言会中断当前 turn。
**修复**:按项目串行化整个配置过程、锁后重读状态;与原生 DS-Bot 设置共存需 runtime 版本/CAS,补偿只能撤销本请求拥有的版本。保留字段是否存在、applied 状态及实际 Session 选择;覆盖当前失败调用的副作用,补偿后读取验证。恢复不完整时返回结构化 recoveryRequired,并记录可重新查询的差异;主 Store 故障时不能假定写回同一 Store 就可靠。补全 save/select/apply/kickoff 各失败点、并发、未固定模型和忙碌会话的回归。
### Q12 复审 · P2 · 修好了新项目请求失败,遗漏旧项目请求迟到失败
**位置**:[poller 成功/失败分支](<../sansheng/client.js#L349>)、[节流唤醒](<../sansheng/client.js#L419>)、[RolesView 使用传入 data/context](<../sansheng/client.js#L972>)。
**已修部分**:A 成功缓存后,B 的新请求失败,不再把 A 数据配上 B context。
**仍可复现**:A 成功→A 再次请求悬挂→实际主会话切到 B→尚未启动新 tick 时 A 请求失败。真实 poller 输出 `actualWorkspace=wb,emittedContext=wa,emittedProject=A`。catch 只核对请求序号和上次成功 signature,没有像成功分支一样重读当前 workspace;订阅 wake 的一秒节流使这个窗口不能被“切换一定刷新”排除。
**修复**:成功、失败、缓存复用、渲染和操作之前统一核对当前项目身份;切换立即失效旧上下文,丢弃迟到异常并安排新 tick。加载新项目期间清空或禁用旧项目的操作入口。测试应分别覆盖 A 的迟到成功/失败,以及 B 请求失败,不能只测后者。
### Q13 · P2 · 模型目录丢失 needsKey 信息,未配置凭据的模型被展示成可用选项
**位置**:[state 目录映射](<../sansheng/src/route.js#L115>)、[角色下拉](<../sansheng/client.js#L674>)、[真实目录 needsKey 契约](<../ds-bot/src/host/models.js#L100>)、[resolveModel](<../ds-bot/src/host/models.js#L161>)。
**复现**:给真实 /state handler 的 runtime catalog 返回 `{ref:'p/keyless',needsKey:true}`,响应 200 中模型仍在且 needsKey 字段消失。角色卡将其作为普通选项;真实 resolveModel 只要求模型 ref 存在,不能拦住这个选择。这里确认的是缺少可用性提示/检查,不是模型调用已经成功或失败。
**修复**:保留模型可用性元数据,对已知缺凭据的项明确标记并禁用,或进入宿主已有的配置入口;保存端独立复查可用性。不要通过新增表单索取密钥。新回归覆盖缺 key、目录不可用、失效授权、当前模型不在目录等情况。
### 其他共存检查(不混入已确认缺陷计数)
- 三省六部客户端使用独立右栏 tab 与带前缀的 CSS,没有发现它直接替换 app root 或主聊天;但 [ensureCss 的安装调用](<../sansheng/client.js#L1100>) 没有配套卸载清理,应补资源生命周期测试。不能因它本身相对克制就忽略 DS-Bot 的全局层。
- [DS-Bot bundle patch](<../ds-bot/cordis.patch.yml#L16>) 仍覆盖 web 配置为 searchProvider=auto/fetchProvider=http;文件自己说明 config 覆盖会替换整份 entry config。部署前必须比对用户原配置和最终合成值,避免覆盖现有搜索/抓取设置;是否已被更后面的 profile patch 覆盖,本轮未核验,不声称当前搜索已损坏。
- 原生设置页被禁用的上游补丁已移除,重复 settings.trigger 注册有 catch;未发现本轮新增明确的 DSH 启动崩溃证据。catch 不能代替插槽最终归属、禁用后清理和重新启用的验证。
- 没有证据证明删除用户文件、迁移或损坏全部 DSH 会话。已确认的是界面接管机制、错误补偿与治理漏洞,严重性不应夸大成已经发生数据丢失。
### 给实施 agent 的执行顺序与验收门槛
**先处理 UI01–UI03,建立真正的原生共存模式。** 目标固定为左侧原生项目树、中间原生聊天/输入框、右侧三角色卡与折叠 Bot 列表;禁止以换一套聊天皮肤来绕过冲突。模式同时约束 shell、conversation、主题、导航、右栏互斥、sidebar 自检,支持加载顺序变化。保留现有日常旧版“不接管主聊天”修复,不在日常 profile 直接试装候选。
**随后修 Q11/Q12/Q13,并完成首轮 WP-A–E。** Q01–Q10 的修复要求见历史报告;新模型功能不能替代核心治理修复。更新验收矩阵时分别标明真实 Host、真实模块+替身、纯函数、静态审查;不得将 127 测试通过写成真实 DSH E2E 全通过。
**新增宿主验收用例 H01–H08:**
| 编号 | 场景 | 必须满足 |
|---|---|---|
| H01 | 首次进入、刷新、已有 Bot 模式偏好 | 保持当前普通会话,不自动跳 Main Bot;原生主题和设置入口不变 |
| H02 | DS-Bot/三省六部正反加载顺序、禁用再启用 | 原生项目树始终存在;无错误重挂;监听和样式不重复/残留 |
| H03 | better-chat + better-sidebar + workspace-groups-remote 共存 | 主聊天、输入框、设置入口、项目树功能可用,插槽归属符合设计 |
| H04 | 角色栏/终端/文件/Bot 详情交叉打开 | 不被后台订阅擅自折叠;焦点、草稿、滚动不因 remount 丢失 |
| H05 | A/B 项目快速切换,旧成功/旧失败迟到,网络断开 | 不展示或操作旧项目;只保留同项目可信缓存 |
| H06 | 模型选择 apply/Store/补偿失败及并发 | Store/runtime/Session 一致或显式待恢复;成功修改不被旧请求撤销 |
| H07 | 正在生成的本人/群会话切换模型 | 依据实际宿主契约记录影响;不作未经实测的“运行不受影响”承诺 |
| H08 | 深浅色、窄屏、长工具流、原生权限/计划/模型入口 | 输入框保持底部、各控件可达、无主题串改与覆盖 |
应在独立测试 profile 与真实 DSH 实例完成 H01–H08,记录版本/配置差异、截图、日志和实际断言;之后再提日常安装审批。本轮未进行任何安装。另一个只读 Electron 源码定位子任务挂起,其取消请求被自动审批拒绝(仅返回 Auto review rejected,无具体原因);主会话无法查询其子任务 ID,因此未声称该诊断进程已结束。后续审查改用仓库源码,全部上述证据与该任务无关。
---
## 首轮历史报告:7c79de3(保留原证据,当前状态以上文为准)
审查日期:2026-11-14(Asia/Shanghai)
审查分支:`feat/dsbot`
固定提交:`7c79de30235094835c7430e8e124946bb3addbf5`
比较起点:`3f20f89`;50 个文件,新增 6587 行、删除 522 行。
范围:`sansheng@0.2.1` 与本地补丁 `ds-bot@0.3.2-sansheng.2`。本报告不是日常 desktop profile 的安装验收。
## 1. 结论与交付核对
**不通过正式验收;应继续保留候选版本定位。** 独立回归为 **123/123 通过、0 失败**,但新增边界复现发现 **8 项 P1、4 项 P2**。主要问题是治理故障放行、记忆访问检查不完整、审批可读到未提交状态、派发未可靠先记账,以及写租约没有约束真实执行。已有测试通过不足以证明这些边界成立。
实现方向值得保留:取消主聊天接管、保留原生项目树、右栏三角色与 Bot 切换、最新判决优先、服务端成果快照、提交代次、派发记录与恢复状态。这次不建议推倒重做 UI,而应先补服务端边界和执行事务,再完成真实验收。
已读取目标会话“三省六部工作台实施”(`session-6c11fb48-d90c-4c57-8848-bb21fef805ab`)两次完整交付文本:seq 2449 为 WP0–WP7 候选交付,seq 3049 为项目树/Bot 切换后续交付;seq 3052 为 turn completed。目标也已标记 complete。先前的压缩记录只解出首帧;本次逐帧解码确认了完整交付,不仅依赖标题或短摘要。定时检查已暂停,避免重复审查。
实施会话明确承认 E01–E04、深色/窄屏等未完成,这是正确的候选限制;不能据此推定功能失败。但是“WP2 写租约”“损坏状态拒绝”“记忆域覆盖”“R04 保存失败处理”等已宣称实现的能力,存在以下可复现缺陷。
## 2. 证据范围与验证方法
### 2.1 本次实际执行
```sh
node --test --test-isolation=none sansheng/test/*.test.js
# tests 123 / pass 123 / fail 0 / skipped 0
node --check sansheng/client.js
node --check sansheng/index.js
# 均退出 0
```
使用本机 bundled Node,测试约 2.8 秒。测试中的持久化写入使用临时目录;本次额外故障复现也只用独占 OS 临时目录及内存依赖,完成后清理。没有修改业务代码、日常 profile、安装目录、用户项目数据,没有提交、推送或升级。
主审负责 UI、路由、成果边界、整体整合;两名独立审查 agent 分别检查治理/审批与隔离/恢复。报告里的“真实模块复现”指加载仓库模块,在临时文件系统或 stub 宿主依赖下调用实际函数;不等于真实模型或真实宿主端到端执行。记忆模块两条最小复现提取执行了原始内部函数,并以源码调用链交叉核验,证据等级低于整模块集成。
本次还复核了实施方的[实际宿主截图](<verification/evidence/host-project-tree-bot-switch.png>):1440×900 浅色下原生输入框位于底部,左侧是工作区树,右侧有三角色与折叠 Bot 列表。截图只有一个工作区,不能证明多项目切换、右键菜单、深色或长工具流。当前没有已认证的浏览器控制通道,因此本次没有独立操作运行中的 GUI;未读取浏览器凭据,也未另起替代服务。
开始及完成代码审查时 HEAD 相同且工作树干净;本次唯一新增仓库文件为本报告。
### 2.2 严重性定义
- **P1**:会破坏核心治理、隔离或交付完整性;正式验收前必须修复。
- **P2**:导致状态误报、配置不一致或操作指向错误;应在对应功能放开前修复。
- “未验证”仅说明缺少证据,不单独当作代码缺陷。
## 3. 已确认问题与最小修复
### Q01 · P1 · 合法 JSON、错误 schema 被当成健康空状态,且覆盖隔离 registry
**位置**:[状态规范化与加载](<../sansheng/src/store.js#L50>)(50–67、137–168);[群门禁无项目时放行](<../sansheng/src/gates.js#L49>)(49–57)。
**触发与证据**:真实 Store 先保存项目并产生有效 registry,再将临时主状态内容写成 JSON `null` 后重新加载。结果为 `health=ok`、`registry.rooms={}`,同一受治理群的 `group_goal complete` guard 返回 ALLOW。这里只复现 guard 判定,没有执行真实原生 complete。
**原因/影响**:normalize 宽松回退成空数据;load 只把 JSON 解析异常当损坏,随后以空状态重建 registry。既丢失了治理身份,也把原本能用于故障拒绝的提示覆盖掉。已有 G07 只测非法 JSON,不能覆盖 schema 错误。
**修复**:解析后先校验顶层版本、必需集合及条目关键字段;只对明确支持的旧版本迁移。错误 schema、未知未来版本和部分非法结构应进入 broken,并保留最后已知 registry。缺失主状态但存在治理 registry 也必须保持不可写;不得把故障自动“修复”为新项目空状态。
**回归**:有效项目分别遇到 `null`、`[]`、错误版本、projects 类型错误、损坏条目、主状态缺失时,均不得覆盖既有 registry 或放行已知受治理动作;正常首次安装无文件与支持的 v2 迁移应仍可用。
### Q02 · P1 · 消息/记忆治理忽略 broken 状态,registry 存在仍放行
**位置**:[对外治理服务](<../sansheng/src/governance.js#L17>)(17–48)。
**触发与证据**:真实 Store 主状态写坏为非法 JSON,保留有效 registry;加载后 `health=broken`,`registryProjectForBot(AL)=A`。调用 `checkDelivery(AL→BL)` 及 `checkMemoryScope(AL, team)` 均返回 `allow:true`。
**原因/影响**:这两个入口只查当前空内存中的 projectByBot/projectByRoom,没有复用群门禁的 health+registry 降级判断。修复 Q01 也不会自动修复此处;Q01 是错误 schema 被当健康,Q02 是明确 broken 仍放行。
**修复**:形成唯一的项目归属/健康解析接口,返回 bound、unbound、unavailable 三态;known governed 主体在 unavailable 时拒绝投递及记忆读取/注入/写入。无法可靠判断治理范围时采用明确的降级策略,不能把 unknown 默认当非项目 Bot。
**回归**:broken/missing/schema 错误下分别覆盖发送方、接收方、群和记忆作用域;保留普通非治理 Bot 的预期行为。恢复有效状态后才恢复访问。
### Q03 · P1 · unknown 身份可调用仅限用户的绑定工具
**位置**:[绑定工具入口](<../sansheng/src/tools.js#L446>)(446–450)。
**触发与证据**:磁盘 DS-Bot 会话映射缺失/失效,但运行时 `isBotSession=true`,身份解析为 unknown。以此调用注册的 `sansheng_bind`,传入已有合法三角色群,真实绑定逻辑成功建立项目,`projectCount=1`。这和既有 unknown 门禁测试的身份故障前提一致;没有做真实宿主故障注入。
**原因/影响**:入口只拒绝 `actor.kind === 'bot'`,unknown 落入用户分支。绑定还可能携带 workDir 影响 Bot 目录,超出了该身份应具有的能力。
**修复**:用户专属操作使用 `actor.kind === 'user'` 正向允许列表;统一检查 provision、bind、配置、核实、控制等入口,不各自写宽松否定条件。这里无需取消用户本身的合法管理权限。
**回归**:user 成功、bot 拒绝、unknown 拒绝;unknown 不产生绑定、模型或工作目录副作用。
### Q04 · P1 · 记忆边界未覆盖群读取、自动注入及目标 Bot 写入
**位置**:[记忆写检查](<../ds-bot/src/host/memory.js#L415>)(415–425);[每步注入及自动召回](<../ds-bot/src/host/memory.js#L880>)(880–962);[读取作用域选择](<../ds-bot/src/host/memory.js#L1154>)(1154–1173)。
**触发条件必须区分**:
1. A 项目 Bot 同时是 B 项目群成员。治理服务对 group/B 明确拒绝,但原始 `readScopes('group', AL, roomB)` 仍返回 B 的 group scope。agent/pre-step 也仅以群 membership 决定 groupSnapshot、memoryUpdate、autoRecall 是否读群域。
2. A 的角色 Bot 本身还是已有 Main(绑定未排除此身份)。调用跨项目 Bot 记忆写检查时,没有向治理服务传 `targetBotId`,后续 Main 豁免放行。最小函数复现:`writeDenied({kind:'bot',botId:BL}, AL)` 返回 undefined,而完整参数的治理判断应为 false。
**影响**:不是“新建两个默认项目必然泄漏”,而是上述成员/身份组合可绕过项目边界;仅阻断 team 共享域不能满足项目隔离。
**修复**:统一 `authorizeMemoryScope(actor, scope, operation)`,每个候选 scope 在实际 load/write/注入之前检查,包含 roomId 和 targetBotId;显式 recall 与 groupSnapshot、autoRecall、memoryUpdate 使用同一过滤器。Main 权限不得覆盖项目归属拒绝。可考虑禁止项目角色兼任 Main,但不能以此代替群域读检查。
**回归**:双项目独特标记;跨项目群成员与项目 Main 两种配置;覆盖显式读取、默认读取、整 topic、系统提示、pre-step、增量更新、自动召回、写入。断言被拒数据从未读入/注入,不能只断言治理辅助函数返回 false。
### Q05 · P1 · 派发意图落盘失败后仍执行原生命令
**位置**:[派发观察器](<../sansheng/src/observe.js#L46>)(46–81)。
**触发与证据**:在真实 observer 中让 beginDispatch 抛出 `disk full`,native `next()` 仍调用一次并返回状态已改变。markDispatchInFlight 的保存失败走相同 catch。
**原因/影响**:除 payload-conflict 外,catch 清空 record 后继续执行,失去了“先持久化意图,再执行”的保障。重启可能完全没有该次动作的记录,无法可靠判断重试是否重复。
**修复**:识别出受治理项目后,prepared 和 in_flight 持久化失败必须终止原生执行并报告明确错误。结果保存失败发生在执行之后,应保留可恢复的 in_flight/unknown 事实,禁止宣称已可靠记账;不能把两种窗口都当无害观测失败吞掉。
**回归**:beginDispatch、markInFlight 分别失败时 `nativeCalls=0`;真实 native 已执行但 finish 失败时,重载可核实且不会自动重发。把这些断言加到 observer 层,而不仅测试 Store 回滚。
### Q06 · P1 · 审批事务落盘前已公开到内存,guard 可读到最后回滚的批准
**位置**:[Store 事务](<../sansheng/src/store.js#L192>)(192–225)。
**触发与证据**:真实临时 Store 中调用 addReview,制造原状态路径无法原子替换的写入失败。在写入 Promise 尚未结束的微任务窗口,peek 已有 review,真实安装的 gate 放行;写入最终 EPERM 后 review 被回滚,gate 又拒绝。
```text
pending-write: observed=true, reviewCount=1, guardResult=ALLOW
write-settled: ok=false, EPERM, reviewCount=0, guardResult=no-stage-review
```
**影响**:已证实门禁读取未提交审批,没有声称已让真实原生 pass 完成。最终失败时回滚内存,无法撤销其他调用在此前基于脏数据作出的决定。
**修复**:在独立 draft clone 上 mutate、裁剪与持久化;成功后一次发布到可读快照,失败从未公开 draft。对 registry 的持久化与发布也明确一致性策略。返回的可变引用不得让外部反向修改 committed state。
**回归**:延迟落盘期间所有读取看到旧提交;落盘失败始终没有批准;成功后才看到批准。同时完成 G06:原生目标最终变更点需比较审批序号、submissionSeq、目标对象摘要和必要的成果版本。**只修复此脏读并不能证明完整的 guard→异步执行 TOCTOU 已闭合。**
### Q07 · P1 · 不完整/缺失成果仍可作为有效验收依据
**位置**:[文件数量截断](<../sansheng/src/artifact.js#L326>)(326–358);[快照校验](<../sansheng/src/artifact.js#L676>)(676–703);[门禁成果检查](<../sansheng/src/gate.js#L144>)(144–160);[审查抓取成果](<../sansheng/src/tools.js#L161>)。
**触发与证据**:实际 capture/verify/gate 模块,非 Git 临时目录有 a.txt、z.txt;设置合法的 `project.delivery.maxFiles=1`,取得截断快照后修改 z.txt。输出为 `truncated=true, sameDigest=true, verification=true, gate=true`。默认上限为 5000,同类问题发生在超出默认上限时。另指定不存在目录,capture 得到 missing,verify 仍为 true。
**原因/影响**:快照只收集上限内文件;审批与门禁没有拒绝 truncated/missing。修改未收集的交付文件无法使旧批准失效。缺失目录分支只证明“仍然不存在”,不能证明已交付。
**修复**:pass/complete 必须要求完整且可读取的成果;truncated、missing、读取失败为不可验收。超限可缩小明确交付范围或使用流式完整摘要,不得默默接受前缀。无 workDir 的遗留兼容模式必须显式标识为无成果验证,不能宣称文件交付已验证。
**回归**:上限外修改/新增/删除、目录不存在、目录变文件、无权限、超大文件策略;同步和异步路径一致。拒绝提示应引导调整交付范围。排除目录仍按声明策略处理,不能误判成全部仓库文件都需要入摘要。
### Q08 · P1 · 写租约没有约束真实执行,提交快照后反而不释放
**位置**:[成果提交取租约](<../sansheng/src/tools.js#L270>)(270–296);[租约实现](<../sansheng/src/store.js#L502>)(502–523)。
**证据等级:源码调用链核查。** 实际 acquire 调用在成果提交和手动 lease 工具;执行派工、observer、ds-bot delivery/文件写入口没有对应强制检查。submit 获取租约后,成功、capture 异常、commit 异常均未自动释放。默认持有 30 分钟;相同 holder 不同 task 也不互斥。锁按 projectId 索引,两个不同项目指向同一实际根目录仍可分别获锁。
**影响**:不能据 Store 租约单测宣称 I07 已成立。工部实际执行不受锁约束;反而读成果的提交步骤可能挡住另一个角色随后提交,直到手动释放或过期。
**修复**:明确写任务执行生命周期和授权工作根;在实际执行前获取 `(规范化实际工作根, task/execution id)` 的独占权,执行结束/失败/取消可靠释放,运行期间续租。共享同根默认串行,或使用隔离 worktree。读快照不应遗留长写锁;需要短暂稳定视图时应在 finally 中释放。租约不能代替路径、符号链接和工具执行权限边界。
**回归**:同项目同 Bot 两任务、不同 Bot 两任务、不同项目同根、独立根并行;进程中断、取消、超时和重启;提交成功/失败均不泄漏锁。用真实写入口验证互斥,不能仅调用 acquireLease 证明。
### Q09 · P2 · 核实路由的 projectId 与 dispatch 所属项目脱节
**位置**:[核实 HTTP 路由](<../sansheng/src/route.js#L225>)(225–237);[按 ID 更新派发](<../sansheng/src/store.js#L451>)(451–461)。
**触发与证据**:真实 Store 创建 A/B,B 有 unknown 派发;实际 route handler 收到 `{projectId:'A', id:'B-dispatch', verdict:'done'}`。结果 `HTTP 200`,B 记录变 confirmed,审计事件 projectId 却是 A。
**影响**:错误页面上下文或调用参数可确认别的项目记录并写错审计归属。这是项目一致性缺陷;本复现没有证明未认证访问或跨用户权限提升。
**修复**:存储层原子执行 `resolveDispatch(projectId, dispatchId, expectedStatus, verdict, actor)`;项目不匹配则拒绝,不改变记录或写成功事件。事件归属从记录取值,并与状态更新处于同一事务。
**回归**:A+B-id 拒绝且两项目审计都不增加成功事件;A+A-id 通过;并发两次核实只有一个状态转换;记录不存在及已核实返回明确状态。
### Q10 · P2 · draft/start 的业务拒绝仍被记为 confirmed
**位置**:[业务结果分类](<../sansheng/src/records.js#L49>)(49–68)。
**触发与证据**:before/after id、revision、状态完全相同;active 状态重复 start,或 drafting 状态失败 draft,原生返回普通业务拒绝字符串。真实分类函数均返回 confirmed。
**原因/影响**:判 changed 时只要 after 已是目标状态便认为本次成功,没有比较状态是否发生迁移。R01 测试没有覆盖这两个特例。
**修复**:优先真实结构化回执;否则比较可证明的前后变化,明确“已经完成同一请求”的幂等回放与“本次调用被拒绝”。前后状态相同不能单凭状态名称断言成功。确保 before 是稳定快照。
**回归**:重复/被拒 draft、start 都为 rejected 或明确的既有请求重放;合法新建/启动为 confirmed;普通字符串错误和结构化错误一致,不触发额外后续动作。
### Q11 · P2 · 模型配置失败会留下部分实际修改
**位置**:[项目配置更新](<../sansheng/src/provision.js#L280>)(280–328)。
**触发与证据**:A 的 lead 使用有效新模型,shangshu 使用无效模型;真实 updateProjectConfig 配内存 runtime。返回 `ok:false`,但 AL 已变为新模型,Store 配置未变。最后 Store 保存失败也没有回滚此前 runtime 更新。
**原因/影响**:逐个 resolve 后立即更新;后续 resolve 报错和最终保存报错未进入已有补偿逻辑。页面显示失败,实际配置和展示配置不一致。
**修复**:先解析校验全部模型,再取 runtime 实际旧值并统一应用;任一更新或 Store 提交失败,执行补偿;补偿失败则记录明确的待修复状态并展示真实差异。不要用绑定配置 null 猜测 runtime 原值。
**回归**:第二/第三模型无效时零更新;中途 update 失败、最终保存失败、补偿失败;成功只影响 A,B 不变,返回值与实际状态一致。
### Q12 · P2 · 切到 B 后请求失败,右栏将 A 的数据配上 B 上下文
**位置**:[状态轮询错误路径](<../sansheng/client.js#L316>)(316–358);[角色页使用 current](<../sansheng/client.js#L916>)(916–958)。
**触发与证据**:执行实际导出的 poller:先在 workspace A 成功返回 current=A,再切换 B 并令请求失败。onChange 输出 `context='wb', displayedProject='A', error='network down'`。RolesView 优先使用 data.current,配置/角色按钮仍指向 A;只是显示一般断连提示。
**原因/影响**:lastData 没有绑定缓存上下文;success 路径有 signature 检查,catch 路径不完整。快速切换、失败或超时可显示错误项目的可操作内容。没有声称已在真实浏览器点击后改错项目。
**修复**:缓存同时保存 signature,只有同一项目断连才能展示上次状态;跨项目失败显示 B 的加载/错误状态,禁用依赖已解析项目的写动作。成功和失败回调都检查 requestId 与 context signature。无明确上下文时避免以第一个项目冒充当前项目。
**回归**:A 成功→B 失败、A 失败晚到→B 成功、A/B/A 快切、列表更新与重试;断言卡片、配置提交 projectId、角色跳转目标一致。同项目断连保留缓存继续可读。
## 4. 原 39 项验收重新判定
下表的“单测通过”只确认仓库已有用例通过,并不提升为真实宿主或完整场景验收。“部分”可能包括通过的子场景和新的反例。对照[原交接方案](<三省六部工作台-实施与验收交接方案.md#L299>)与[实施方矩阵](<verification/02-test-matrix.md>)。
| ID | 本次判定 | 依据及后续要求 |
|---|---|---|
| U01 | 部分 | 原生聊天不接管;已有浅色截图正常;长消息/工具流待实测 |
| U02 | 部分 | 有工作区树截图与菜单组件测试;缺双项目真实右键打开/初始化 |
| U03 | 单测通过,宿主待验 | 页签打开路径有测试;反复开关/聚焦实际页签待验 |
| U04 | 部分 | 无 Better Sidebar 回退有实施方冒烟;晚到/注册异常/卸载全路径待验 |
| U05 | 未完整验证 | 仅 1440×900 浅色;深色、窄屏、拖动待验 |
| U06 | 不通过完整边界 | Q12 跨项目失败缓存;成功旧响应的序号测试通过 |
| U07 | 单测通过 | 新 goalId 状态投影;真实目标切换待验 |
| U08 | 单测通过 | 最新审查投影;真实返工推进待验 |
| U09 | 部分 | 有错误提示,但 Q11 实际配置不一致、Q12 缓存跨项目 |
| I01 | 单测通过 | 默认 A/B 独立创建;真实双项目待 E03 |
| I02 | 单测通过 | Bot/群重复绑定拒绝;另补 Q03 unknown 管理边界 |
| I03 | 部分 | 工具显式项目冲突通过;Q09 HTTP 核实需补同等约束 |
| I04 | 部分 | 成功路径 B 不变;Q11 失败原子性不成立 |
| I05 | 不通过完整边界 | Q02、Q04 故障与群成员/Main 组合可绕过 |
| I06 | 不通过完整边界 | 健康治理辅助函数测试通过;Q02 broken 投递放行 |
| I07 | 不通过 | Q08 无执行层强制租约,工作根边界无实际验证 |
| G01 | 单测通过 | 无丞相记录拒绝;带引号群名完整原生路径需集成 |
| G02 | 单测通过 | Main 修改受治理目标拒绝;不代表管理工具/记忆均安全 |
| G03 | 单测通过 | 最新 reject 优先,不先筛 pass |
| G04 | 单测通过核心语义 | 最新判决、摘要、代次测试;完整 S1→S2→S1 原生链需补 |
| G05 | 单测通过 | 显式项目及证据身份过滤;补同名不同 ID 集成 |
| G06 | 不通过 | Q06 未提交审批可放行;最终原生提交点原子检查仍缺证据 |
| G07 | 不通过 | Q01 schema、Q02 broken 服务、Q03 unknown 绑定 |
| A01 | 部分 | 常规 Git 文件变化测试通过;Q07 不完整成果不得验收 |
| A02 | 部分 | 常规未跟踪文件变化测试通过;上限外变化漏检 |
| A03 | 单测通过 | 验收标准/任务范围摘要变化失效 |
| A04 | 不通过完整边界 | Q07 上限外改动不失效;尚无测试结果绑定最终成果的 E2E |
| A05 | 单测通过 | 仅原生账本 revision 变化不造成审批死锁 |
| R01 | 不通过完整边界 | Q10 draft/start 业务拒绝反例 |
| R02 | 单测通过 | 相同 requestId 幂等、冲突 payload 拒绝;真实投递重试待验 |
| R03 | 部分 | Store 重启转 unknown 通过;Q05 无意图窗口需补 |
| R04 | 不通过 | Q05 意图失败仍执行;Q06 回滚前暴露未提交状态 |
| R05 | 部分 | 自动返工去重单测通过;与原生 @ 同时到达需真实集成 |
| R06 | 部分 | 原生/本地预算最大值测试;历史裁剪再重启完整场景待补 |
| R07 | 部分 | 有 control 接口;执行中暂停/取消/刷新/恢复待 E2E |
| E01 | 未执行 | 原生正常派发→文件变更→测试→审批→完成 |
| E02 | 未执行 | 真实驳回→返工→新成果/审批→完成 |
| E03 | 未执行 | 双项目独特文件与记忆标记、相互不干扰 |
| E04 | 未执行 | 真实发送中断/重启/核实,无重复接受 |
实施方矩阵还需纠正:U02 一处写真实冒烟通过,但其正文仍说真实项目树右键未验证;第 7 节仍列旧版本及“真实截图缺失”,与现有截图和后续 v0.2.1 交付不一致。更新为精确的“哪个提交、哪种环境、哪种证据”,不要统一写通过,也不要反过来抹掉已有截图。
## 5. 可交给另一个 agent 的修复工作包
### WP-A:持久化与身份基础(先做)
范围:Q01、Q02、Q03、Q06。由一个负责人修改 Store、identity、治理入口,避免共享契约并行冲突。
产出:严格 schema 与迁移策略、只公开已提交状态、统一 health/归属三态、用户权限正向检查。先提交能重现失败的测试,再修复。完成标准:四项反例变为拒绝,原 123 项仍通过,普通非治理功能及正常迁移不回退。
### WP-B:实际记忆与写执行边界
依赖 WP-A 的统一治理接口。范围:Q04、Q08;主要修改 ds-bot 实际访问/执行层。
产出:作用域授权统一入口;所有读写、注入与召回调用它;实际写任务生命周期锁;规范化工作根和同根策略;任务级归属及释放/续约。UI 只展示锁状态,不承担授权。
完成标准:跨项目群成员、Main、坏状态均不能读入不允许的数据;真实第二写任务被拒绝或排队;所有完成/异常/取消路径不遗留锁。无法提供文件级隔离时,应明确禁用受影响的并行模式,不能仅降低文案承诺。
### WP-C:派发与审批提交闭环
依赖 WP-A;与 WP-B 协调执行 ID、锁和恢复记录。范围:Q05、Q06 剩余 G06 原子提交、Q07、Q09、Q10。
产出:意图失败不执行、结果失败可核实;可靠业务结果分类;项目内原子核实;完整可验收快照;在原生最终提交点比较预期目标/审批/成果版本。必要的 ds-bot 底座契约变更应写入补丁说明。
完成标准:磁盘失败、超时、并发改判、成果超限、错误项目核实、重复请求全部有执行次数/状态/审计断言;任何未知结果不自动重发。
### WP-D:配置与项目切换
可在 WP-A 契约明确后并行,范围 Q11、Q12。不得重新接管原生聊天或替换现有项目树。
产出:配置先校验后应用及补偿;按上下文隔离缓存;跨项目失败清理可操作旧视图;必要时无上下文显示明确选择状态。补当前上下文与按钮目标的行为测试。
完成标准:失败不留下未告知的部分模型修改;A/B 快切与失败重试时卡片、配置和会话目标同属一个项目;同项目离线缓存仍有清晰反馈。
### WP-E:真实验收与发布资料
依赖 A–D。使用单独已授权测试宿主;不修改日常 desktop profile。没有可用模型/浏览器通道就保持候选,不伪造 E2E。
按 E01→E02→E03→E04 执行,保存输入、goal/dispatch/review/submission 关联、文件差异、测试结果、取消/重启结果。随后补 U01–U06 真实页面路径:项目树右键、初始化、两项目切换、Better Sidebar 异常/缺失、深色/窄屏/拖栏、长工具流。
刷新[验证矩阵](<verification/02-test-matrix.md>)、[宿主冒烟记录](<verification/03-host-smoke.md>)、[发布说明](<verification/04-release.md>)、[交付记录](<verification/05-delivery-note.md>),让每项通过对应固定提交和证据。产物必须来自最终测试提交;本次未独立校验已发布 tarball 与 HEAD 的逐文件一致性,发布前应补这一项。
## 6. 合并、复核与发布门
推荐提交顺序:WP-A → WP-B/WP-D → WP-C → WP-E。WP-C 的纯分类/快照修复可提前独立实现,但最终提交点必须等共享契约稳定。Store 与工具注册由唯一负责人合并;其他 agent 提供需求或独立测试,避免同时格式化和覆盖共享文件。
正式验收至少要求:
1. Q01–Q08 全部关闭并附原失败/修复后通过证据;Q09–Q12 修复或明确禁用对应受影响功能。
2. 原 123 项回归保留通过,新增反例覆盖实际调用路径,不只测试辅助函数。
3. G06、I07、R04 不能以“前置 guard”“租约 API”“回滚函数存在”代替最终行为证明。
4. 39 项逐条填写证据,E01–E04 真正执行;真实 UI 路径与环境局限明确。
5. 最终提交、两包版本、发布产物一致;升级/回退保留数据,说明旧插件退出与新插件启用顺序。
本报告没有证明 P0 紧急事故,也没有证明已发生真实项目泄漏/误完成。上述 P1 是经模块复现或明确执行调用链证实的发布阻断问题;严重性按核心契约受损确定。
## 7. 可直接转发的执行提示
```text
请基于 docs/三省六部工作台-实施后审查与修复方案.md 修复当前候选版本。
审查基线为 feat/dsbot @ 7c79de30235094835c7430e8e124946bb3addbf5。
先确认当前 HEAD 和未提交改动;有后续变更时先核对问题是否已解决,不覆盖他人工作。
优先 WP-A(状态/schema/权限/只发布已提交状态),再按依赖实施 WP-B/C/D。
针对 Q01–Q12 先增加能复现问题的回归,再修实现;保留原 123 项回归。
重点:失败时停止受治理执行、所有实际记忆路径验权、真实任务写锁、
完整成果才能验收、原生最终提交点复核、项目核实事务一致、UI缓存按项目隔离。
不可把单元测试、静态截图或辅助函数判定当成完整 E2E。
完成后按原39项逐条更新证据;缺真实环境时保留候选状态。
本审查不授权安装/修改日常profile、迁移数据、推送或发布;按用户给你的实际授权处理。
交付:可审阅diff、失败→通过测试、准确版本、未验证项、升级/回退说明。
```