dsh-workplan 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/CHANGELOG.md +68 -0
  2. package/README.en.md +41 -2
  3. package/README.md +40 -2
  4. package/SECURITY.md +109 -0
  5. package/docs/SBOM.md +113 -0
  6. package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +97 -0
  7. package/docs/cc/CC-2026-ASSESSMENT.md +254 -0
  8. package/docs/cc/SECURITY-TARGET.md +239 -0
  9. package/docs/collaboration.md +440 -0
  10. package/docs/collapse-interaction-spec.md +272 -0
  11. package/docs/defect-report-count-inconsistency.md +370 -0
  12. package/docs/departments.md +194 -0
  13. package/docs/design-proposals/state-machine.reference.ts +836 -0
  14. package/docs/design-proposals/state-machine.test.reference.ts +655 -0
  15. package/docs/fix-report-derived-counts-1.4.3.md +199 -0
  16. package/docs/fix-report-phase-percent-1.5.2.md +284 -0
  17. package/docs/preview/progress-visual-1.5.0.html +683 -0
  18. package/docs/progress-visualization-clarify-20261028.md +211 -0
  19. package/docs/progress-visualization-design-20261028.md +607 -0
  20. package/docs/progress-visualization-locate-20261028.md +159 -0
  21. package/docs/progress-visualization-report-1.5.0.md +140 -0
  22. package/docs/release-notes-1.7.0.md +46 -0
  23. package/docs/release-notes-1.7.1.md +36 -0
  24. package/docs/release-record-1.5.1-20261028.md +258 -0
  25. package/docs/release-record-1.5.2-20261029.md +101 -0
  26. package/docs/release-record-1.7.0-20261030.md +58 -0
  27. package/docs/release-record-1.7.1-20261030.md +56 -0
  28. package/docs/repro-count-inconsistency.md +310 -0
  29. package/docs/review-collaboration-20261030.md +246 -0
  30. package/docs/root-cause-phase-percent.md +866 -0
  31. package/docs/state-progress-matrix.md +517 -0
  32. package/docs/status-grouping-ia.md +789 -0
  33. package/docs/stuck-review-1.3.0.md +646 -0
  34. package/docs/t4-contrast-measurement.json +496 -0
  35. package/docs/t4-contrast-measurement.md +177 -0
  36. package/docs/t8-fix-prioritization.md +105 -0
  37. package/docs/version-upgrade-rollback-1.5.0-20261028.md +654 -0
  38. package/docs/visual-refinement-spec.md +164 -0
  39. package/lib/host.js +5 -16
  40. package/lib/runtime.js +37 -1
  41. package/package.json +4 -2
  42. package/src/host.ts +6 -15
  43. package/src/runtime.ts +39 -1
@@ -0,0 +1,310 @@
1
+ # 最小复现:聚合计数与实时状态不一致(T2)
2
+
3
+ - 适用版本:`dsh-workplan@1.4.2`(缺陷构建)
4
+ - 复现脚本:[`scripts/repro-inconsistent-counts.ts`](../scripts/repro-inconsistent-counts.ts)
5
+ - 缺陷清单:[`docs/defect-report-count-inconsistency.md`](defect-report-count-inconsistency.md)
6
+ - 记录时间:2026-10-28
7
+ - 结论:**可稳定复现**。脚本以当前 `lib/runtime.js`、`lib/plan.js`、`client.js` 为唯一被测对象,不 mock 被测逻辑;同一份下发的 JSON 里,`stats` 与 `statuses`/`departments` 可以同时给出互相矛盾的事实,且这些事实会同时渲染到同一个页面。
8
+
9
+ ---
10
+
11
+ ## 1. 复现前提
12
+
13
+ | 项目 | 实测值 |
14
+ | --- | --- |
15
+ | 操作系统 | macOS(Darwin),本轮实测机型 `<your-mac-hostname>` |
16
+ | Node | `v26.9.0`(`/opt/homebrew/Cellar/node/26.9.0/bin/node`) |
17
+ | 插件根目录 | `<repo>` |
18
+ | 被测构建 | `lib/runtime.js`、`lib/plan.js`、`client.js`(均未改动,见第 8 节哈希) |
19
+ | 服务状态 | 宿主已运行 `dsh --profile web --host 127.0.0.1 --port 3080`(PID 2511),**本复现不依赖它,也不重启它** |
20
+
21
+ **为什么不用真实 HTTP 接口**:实测 `GET http://127.0.0.1:3080/dsh-workplan/plans` 返回 `HTTP/1.1 401 Unauthorized` 与 `{"ok":false,"error":"未授权的请求"}`。该路由要求浏览器同源会话凭证,命令行无法提供。因此脚本直接调用 `runtime.plansPayload(sessionId)`——它与该路由使用的是**同一个序列化函数**,输出就是 UI 轮询拿到的 JSON 结构。UI 证据则用 `client.js` 的真实工厂函数在 React 桩上渲染成 HTML 字符串,读取的是与浏览器相同的组件代码。
22
+
23
+ 这不是“模拟 bug”,而是绕开鉴权,调用产生该 JSON 的真实函数。
24
+
25
+ ---
26
+
27
+ ## 2. 一键复现(照做即可)
28
+
29
+ ### 2.1 带注释版
30
+
31
+ ```bash
32
+ # 1) 进入唯一的插件权威目录(改其他目录不会生效)
33
+ cd <repo>
34
+
35
+ # 2) 用当前构建跑复现:预期 exit 0(exit 0 = 四类缺陷全部被复现)
36
+ node scripts/repro-inconsistent-counts.ts
37
+
38
+ # 3) 可选:确认同一脚本在修复后能作为验收探针
39
+ # 当前缺陷构建下预期 exit 1;9 条不变量断言中 8 条 [FAIL](departments 一致这条本就 PASS)
40
+ node scripts/repro-inconsistent-counts.ts --expect-fixed
41
+
42
+ # 4) 可选:单独做严格类型检查(脚本不在任何 tsconfig 的 include 内)
43
+ npx tsc --noEmit --strict --target ES2022 --module NodeNext \
44
+ --moduleResolution NodeNext --types node --skipLibCheck \
45
+ --allowJs --checkJs false scripts/repro-inconsistent-counts.ts
46
+ ```
47
+
48
+ ### 2.2 无注释、可直接复制版
49
+
50
+ ```bash
51
+ cd <repo>
52
+ node scripts/repro-inconsistent-counts.ts
53
+ node scripts/repro-inconsistent-counts.ts --expect-fixed
54
+ npx tsc --noEmit --strict --target ES2022 --module NodeNext --moduleResolution NodeNext --types node --skipLibCheck --allowJs --checkJs false scripts/repro-inconsistent-counts.ts
55
+ ```
56
+
57
+ 预期耗时约 3–6 秒(场景 B 的预算暂停需要等计时器触发)。
58
+
59
+ ---
60
+
61
+ ## 3. 预期输出(当前缺陷构建,实测原文节选)
62
+
63
+ ```text
64
+ === Observed payloads ===
65
+ A stats : {"total":3,"done":1,"blocked":0,"inProgress":0,"pending":2,"progress":33}
66
+ A actual : {"done":2,"blocked":0,"inProgress":1,"pending":0} progress 70
67
+ A statuses : T1:done:100, T2:done:100, T3:in_progress:10
68
+ A departments: [{"id":"engineering","total":1,"done":1,"blocked":0,"inProgress":0},{"id":"qa","total":1,"done":1,"blocked":0,"inProgress":0},{"id":"design","total":1,"done":0,"blocked":0,"inProgress":1}]
69
+
70
+ === Observed UI (top bar / card / stage / pills) ===
71
+ A top done/doing: 1 / 0
72
+ A card meta : {"progress":33,"inProgress":0,"pending":2}
73
+ A donut : 33
74
+ B top done/doing: 0 / 0
75
+ B card meta : {"progress":100,"inProgress":0,"pending":1}
76
+ B donut : 0
77
+ C top blocked : 2 doing 0
78
+ C card meta : {"progress":0,"inProgress":0,"pending":0}
79
+
80
+ === Reproduction assertions (buggy build) ===
81
+ [PASS] A: frozen stats say 0 doing / 2 pending — {...}
82
+ [PASS] A: actual state is 1 doing / 0 pending, one more done — {...}
83
+ [PASS] A: same payload contradicts itself (stats.done=1, qa.done=1) — [...]
84
+ [PASS] A: same payload contradicts itself (stats.inProgress=0, design.inProgress=1) — [...]
85
+ [PASS] A: UI top bar shows 1 done / 0 doing — 1/0
86
+ [PASS] A: UI card says 0 正在做 · 2 还没开始 — {...}
87
+ [PASS] A: UI renders a done T2 and an in-progress T3 — stage/subtask pills read statuses
88
+ [PASS] A: UI donut shows the frozen 33% — 33
89
+ [PASS] B: pending keeps progress=100 — {...}
90
+ [PASS] B: pause payload says 100% with 0 done — {...}
91
+ [PASS] B: UI says 总体进度 100% while the donut says 0% / 0 done — ...
92
+ [PASS] C: resume keeps stale blocked=2 while none is blocked — 2/0
93
+ [PASS] C: UI shows 2 卡住了 while T1 is 正在做 — blocked=2
94
+ [PASS] C: UI card says 0 正在做 · 0 还没开始 while T1 runs and T2 is pending — {...}
95
+
96
+ All four defects reproduced (stats freeze, payload split-brain, budget invariant breach, stale resume counts).
97
+ ```
98
+
99
+ > 注:上面 `{...}` 只是本文档为控制篇幅做的省略;脚本运行时打印完整 JSON。以实际输出为准。
100
+
101
+ 判定标准:
102
+
103
+ - 进程 exit code 为 `0`;
104
+ - 14 条断言全部为 `[PASS]`;
105
+ - 末行为 `All four defects reproduced (...)`。
106
+
107
+ ---
108
+
109
+ ## 4. 场景 A:第二并发波内 `stats` 冻结(P0,主诉)
110
+
111
+ ### 4.1 构造步骤(脚本 `scenarioFrozenDuringSecondWave()`)
112
+
113
+ 1. 建一个含 3 个子任务、2 个阶段的计划:
114
+ - S1:`T1`(engineering,快任务);
115
+ - S2:`T2`(qa,依赖 T1,快任务)、`T3`(design,依赖 T1,挂起任务)。
116
+ 2. 按 `createPlan` 的真实内存形状创建记录(`src/runtime.ts:1619-1628`,**初始没有 `stats` 字段**)。
117
+ 3. 调用真实 `dispatchPlan`:
118
+ - 第一波:T1 完成;波末 `src/runtime.ts:760` 写入 `record.stats`;
119
+ - 第二波:T2 完成,T3 进入 `in_progress` 并挂起。
120
+ 4. 在 T2 已 done、T3 仍 `in_progress` 时,读取 `runtime.plansPayload(session.id).sessions[0]`。
121
+ 5. 把同一份 payload 交给真实 `client.js` 渲染 Dashboard,读取统计条、卡片、阶段徽标、子任务胶囊、Donut。
122
+
123
+ ### 4.2 观察到的错误值 vs 期望值
124
+
125
+ | 观测面 | 观察到的错误值 | 期望值(由同一份 `statuses` 派生) |
126
+ | --- | --- | --- |
127
+ | `stats.done` | `1` | `2` |
128
+ | `stats.inProgress` | `0` | `1` |
129
+ | `stats.pending` | `2` | `0` |
130
+ | `stats.progress` | `33` | `70`(`(100+100+10)/3` 四舍五入) |
131
+ | 同一 payload 的 `departments` | `qa.done=1`、`design.inProgress=1` | 与 `stats.done=1`、`stats.inProgress=0` 不可能同时成立 |
132
+ | UI 顶部统计条 | `1 做好了 / 0 正在做` | `2 做好了 / 1 正在做` |
133
+ | UI 卡片进度行 | `总体进度 33%` + `0 正在做 · 2 还没开始` | `总体进度 70%` + `1 正在做 · 0 还没开始` |
134
+ | UI 阶段徽标 | `第 2 步:第二波 ... 正在做` | 同为「正在做」(与统计条矛盾) |
135
+ | UI 子任务胶囊 | T2「做好了」、T3「正在做」 | 同左(与统计条矛盾) |
136
+ | UI Donut | `33%` | `70%` 或按完成件数 `67%`,但**不应与卡片 33% 并存** |
137
+
138
+ ### 4.3 复现概率与可见时长
139
+
140
+ - **确定性 100%**:只要计划存在“第一波结束之后仍有状态变化”,`stats` 就必然停留在第一波波末快照;这不是竞态偶发。
141
+ - **可见时长**:从第一波波末到整个 `dispatchPlan` 结束(含所有后续波、子 Agent 运行、预算等待),最长可达分钟级;UI 每 4000ms 轮询一次,因此不是一闪而过的渲染抖动,而是稳定可见的错误画面。
142
+ - 原始会话的旁证:`session-91ec3273…` 的计划分 6 个阶段、12 个子任务,分 6 轮预算续跑(见第 7 节),天然具备多波结构。
143
+
144
+ ---
145
+
146
+ ## 5. 场景 B:预算暂停产生 `pending + progress=100`(P1)
147
+
148
+ ### 5.1 构造步骤(脚本 `scenarioBudgetPause()`)
149
+
150
+ 1. 建一个 1 个子任务的计划,子 Agent 挂起不返回。
151
+ 2. 调用 `dispatchPlan` 时传 `totalTimeoutMs: 350`。`dispatchPlan` 内部会把计时器下限抬到约 1000ms(`Math.max(1000, deadline - now)`),因此实际约 1 秒后触发“本轮预算用尽”。
152
+ 3. 读取 `record.phase`、payload 的 `statuses`、`stats`,再渲染 UI。
153
+
154
+ ### 5.2 观察到的错误值 vs 期望值
155
+
156
+ | 观测面 | 观察到的错误值 | 期望值 |
157
+ | --- | --- | --- |
158
+ | `statuses[0].status` | `pending` | `pending`(暂停后回到未开始,本身合理) |
159
+ | `statuses[0].progress` | `100` | `0`(`applyStatus` 对 pending 的归一化值) |
160
+ | `statuses[0].childId` | `child-hang`(残留) | `null` |
161
+ | `statuses[0].startedAt` | 非空(残留) | `null` |
162
+ | `statuses[0].finishedAt` | `null` | `null` |
163
+ | `statuses[0].error` | `本轮预算用尽,等待续跑` | 同左(保留原因合理) |
164
+ | `stats` | `{"total":1,"done":0,"blocked":0,"inProgress":0,"pending":1,"progress":100}` | `progress: 0` |
165
+ | UI 卡片 | `总体进度 100%` + `0 正在做 · 1 还没开始` | `总体进度 0%` |
166
+ | UI Donut | `0%`(按 done/total) | `0%`;但**不应与卡片的 100% 同屏并存** |
167
+
168
+ ### 5.3 原始会话中的真实证据(非构造)
169
+
170
+ 原始会话 `session-91ec3273-3277-49ff-87b3-7ce4722f29e0` 的解压后 JSONL 第 327 行(事件 `seq=325`,时间 `2026-10-27 21:20:36 CST`)是一条 `workplan-result`,其原文头部为:
171
+
172
+ ```text
173
+ 【部门执行结果】完成 11/12,受阻 0,请主 Agent 核对并整合
174
+ ...
175
+ 4. 本轮执行预算用尽,剩余 1 项未完成(不是失败、未计入续跑额度):再次调用 dsh_workplan_dispatch 即可从剩下的步骤继续,已完成的不重跑。
176
+ ```
177
+
178
+ 同一消息内嵌的 payload 实测为:
179
+
180
+ ```json
181
+ "stats": {"total":12,"done":11,"blocked":0,"inProgress":0,"pending":1,"progress":100}
182
+ ```
183
+
184
+ 其中未完成的 T12 条目:
185
+
186
+ ```json
187
+ {
188
+ "subtaskId": "T12",
189
+ "status": "pending",
190
+ "progress": 100,
191
+ "childId": "41bcef5d-39b2-4726-9ba1-f67ac4908de1",
192
+ "startedAt": 1793106957096,
193
+ "finishedAt": null,
194
+ "summary": "",
195
+ "error": "本轮预算用尽,等待续跑"
196
+ }
197
+ ```
198
+
199
+ 这条证据直接证明:**原始会话里确实出现过“12 项只完成 11 项、但总体进度 100%、最后一项 pending 且 progress=100”的画面**。不是本报告构造出来的假想。
200
+
201
+ ### 5.4 复现概率
202
+
203
+ - 只要本轮预算在任一子任务执行中耗尽,**确定性 100%**;
204
+ - 默认单轮预算为 60000ms(`createWorkplanRuntime` 下限),长任务/多子任务批次很容易触发;原始会话连续 6 轮都在预算边界暂停,说明这是常规路径,不是极端异常。
205
+
206
+ ---
207
+
208
+ ## 6. 场景 C:resume 后 `stats.blocked` 残留(P1)
209
+
210
+ ### 6.1 构造步骤(脚本 `scenarioResumeBlocked()`)
211
+
212
+ 1. 建一个 2 个子任务的计划,初始 `statuses` 都是 `blocked`,`record.stats.blocked = 2`,`phase = 'blocked'`,`resumeCount = 0`。
213
+ 2. 调用 `plansPayload` 取得暂停画面(此时 stats 与 statuses 一致,均为 2 blocked)。
214
+ 3. 调用 `resumePlan` 恢复;T1 变为 `in_progress` 并挂起,T2 被重置为 `pending`。
215
+ 4. 在 T1 仍 `in_progress` 时读取 payload 并渲染 UI。
216
+
217
+ ### 6.2 观察到的错误值 vs 期望值
218
+
219
+ | 观测面 | 观察到的错误值 | 期望值 |
220
+ | --- | --- | --- |
221
+ | `stats.blocked` | `2` | `0` |
222
+ | `stats.inProgress` | `0` | `1` |
223
+ | `stats.pending` | `0` | `1` |
224
+ | `stats.done` | `0` | `0` |
225
+ | 实际状态计数 | `{done:0, blocked:0, inProgress:1, pending:1}` | 同左 |
226
+ | UI 顶部 | `2 卡住了 / 0 正在做` | `0 卡住了 / 1 正在做` |
227
+ | UI 卡片 | `0 正在做 · 0 还没开始` | `1 正在做 · 1 还没开始` |
228
+ | UI 子任务胶囊 | T1「正在做」 | 同左(与顶部矛盾) |
229
+
230
+ ### 6.3 复现概率
231
+
232
+ - 只要计划曾进入 `blocked` 且被 resume,并在“第一波结束前”读取,**确定性 100%**;
233
+ - 可见窗口从 resume 写入 `statuses` 起,到该波结束(`src/runtime.ts:760`)或 `finally`(`:825`)重算 `stats` 为止;若第一个子任务运行较久,窗口同样可达分钟级。
234
+
235
+ ---
236
+
237
+ ## 7. 原始会话与截图的对应关系(证据边界)
238
+
239
+ 原始会话的解压命令(只读,不修改任何东西):
240
+
241
+ ```bash
242
+ zstd -dc "~/.dsh/sessions/--Users-open-Documents-Stocks--/session-91ec3273-3277-49ff-87b3-7ce4722f29e0/session.v4.jsonl.zstd" > /tmp/session-91ec.jsonl
243
+ ```
244
+
245
+ 该会话共 634 行事件,其中 7 条 `workplan-result`(解压后 JSONL 第 197、249、265、294、310、327、394 行)。前 6 条 `phase` 均为 `paused`,最后一条为 `integrating`。逐条实测统计:
246
+
247
+ | JSONL 行 | 时间(CST) | 完成/总数 | stats.progress | phase |
248
+ | --- | --- | --- | --- | --- |
249
+ | 197 | 2026-10-27 18:45:27 | 5/14 | 43 | paused |
250
+ | 249 | 2026-10-27 19:59:41 | 6/12 | 58 | paused |
251
+ | 265 | 2026-10-27 20:20:12 | 7/12 | 67 | paused |
252
+ | 294 | 2026-10-27 20:40:16 | 8/12 | 75 | paused |
253
+ | 310 | 2026-10-27 21:00:27 | 9/12 | 83 | paused |
254
+ | 327 | 2026-10-27 21:20:36 | 11/12 | **100** | paused |
255
+ | 394 | 2026-10-27 21:31:58 | 12/12 | 100 | integrating |
256
+
257
+ 说明:
258
+
259
+ - 原始会话的 `workplan-result` 只在批次暂停/结束时生成,此时 `finally` 刚重算过 `stats`,所以这些快照大多是自洽的;**不能用它们反证运行中 UI 是自洽的**。
260
+ - 但第 327 行恰好同时暴露了 D3:`done=11/12`、`pending=1`、`stats.progress=100`、pending 项 `progress=100`。这是原始会话内的真实数据,不是构造。
261
+ - 用户截图显示的是运行中的 UI,与场景 A 的冻结窗口同源;但本轮没有拿到截图原文件,因此不能断言截图时刻一定处于 A,也不把“截图里的具体数字”当作已验证事实。场景 A 的结论由真实 `plansPayload` + 真实 `client.js` 渲染共同证明,可脱离截图独立成立。
262
+
263
+ ---
264
+
265
+ ## 8. 被测构建指纹(保证“跑的就是缺陷版本”)
266
+
267
+ ```text
268
+ version 1.4.2
269
+ src/runtime.ts f4dc6fd33b3e511ff0bfbc5886a1d1ef2404d17f495c142e93e5174cd385b367
270
+ src/plan.ts c3cfd5e760604c8cde3a2b9c57bc55b01b4755837257d09396d05bd269dd506e
271
+ lib/runtime.js 5f93ea0fa49b0cdc04819642d8626704b5918c8768e2982ebfa0603b355f9790
272
+ lib/plan.js 24455faea8791ba8e0ccec26c8d84cc98415ae0e6da881e9f60f5573b9418503
273
+ client.js 0c3ffd342a66da3a436633ba73b9d5b514200e9d91db3203f0a97bf7d5acd15d
274
+ package.json b542c81034a24eb31cea016a93ef2716fc850787994cf8dd93c9e42ce8f05fad
275
+ ```
276
+
277
+ 复核命令:
278
+
279
+ ```bash
280
+ cd <repo>
281
+ shasum -a 256 src/runtime.ts src/plan.ts lib/runtime.js lib/plan.js client.js package.json
282
+ ```
283
+
284
+ 若哈希与上表不同,说明被测代码已变化,本报告的数值需要重新跑一遍才能引用。
285
+
286
+ ---
287
+
288
+ ## 9. 第三人复核清单
289
+
290
+ 照做后逐项打勾,任何一项不符都说明环境或代码版本不同,请先停下核对第 8 节哈希:
291
+
292
+ - [ ] 命令从 `<repo>` 执行;
293
+ - [ ] `node scripts/repro-inconsistent-counts.ts` 退出码为 `0`;
294
+ - [ ] 输出包含 14 条 `[PASS]`,且没有 `[FAIL]`;
295
+ - [ ] 场景 A 的 `stats` 为 `done=1, inProgress=0, pending=2, progress=33`,而 `actual` 为 `done=2, inProgress=1, pending=0`;
296
+ - [ ] 场景 A 的 UI 卡片为 `0 正在做 · 2 还没开始`,同时存在 `步骤 T3 ... 正在做` 的胶囊;
297
+ - [ ] 场景 B 的 pending 项为 `progress=100`、`childId=child-hang`、`startedAt` 非空,`stats.progress=100` 且 `done=0`;
298
+ - [ ] 场景 B 的 UI 卡片为 `总体进度 100%`,Donut 为 `0%`;
299
+ - [ ] 场景 C 的 `stats.blocked=2`,而实际 blocked 为 `0`、inProgress 为 `1`;
300
+ - [ ] `--expect-fixed` 在当前构建退出码为 `1`,且 9 条不变量断言中有 8 条 `[FAIL]`(`departments` 一致这条本就 `[PASS]`;修复后应全部 `[PASS]`、退出码 `0`)。
301
+
302
+ ---
303
+
304
+ ## 10. 本复现的边界
305
+
306
+ 1. **没有重启、没有构建、没有改源码**:脚本只调用已存在的 `lib/*.js` 与 `client.js`;运行前后这些文件的哈希不变。
307
+ 2. **HTTP 路由未被直接调用**:401 是宿主的鉴权设计,不是插件缺陷;用同一序列化函数取证不降低结论强度,但本报告不声称“亲眼看到浏览器网络面板里的 401 之后数据”。
308
+ 3. **UI 是服务端渲染字符串,不是真实浏览器 DOM**:React 桩按 `client.js` 的真实组件树输出 HTML,足以证明“同一屏出现互相矛盾的文案”;但不覆盖 CSS 布局、字体、遮挡、浏览器扩展等纯展示因素。原始截图的具体像素不在本轮取证范围内。
309
+ 4. **时间窗口依赖真实子 Agent 的挂起行为**:脚本用 `hangingChild` 精确控制窗口;真实环境的窗口长度取决于子 Agent 运行时长,但“窗口存在”这一点与子 Agent 快慢无关。
310
+ 5. **本轮只诊断,不修复**:源码、`lib/`、`client.js`、版本号均未改动;修复与回归测试属于后续任务。
@@ -0,0 +1,246 @@
1
+ # dsh-workplan 协作机制审查(T2)
2
+
3
+ - 审查对象:`plugins/dsh-workplan` @ 1.6.0(工作区含未提交改动,见 T1 盘点)
4
+ - 审查范围:任务分解 → 派发 → 部门子 Agent 执行 → 结果回传 → 主 Agent 整合 的全链路
5
+ - 审查方法:静态阅读源码(`src/host.ts` / `src/runtime.ts` / `src/plan.ts`)+ 文档比对 + 测试覆盖检查
6
+ - 证据等级:**【代码】**= 直接读到的实现;**【文档】**= 文档/注释中的承诺;**【推断】**= 由代码结构推出的风险,未运行验证
7
+ - 结论口径:本报告只描述“当前实现是什么、在哪里断”,不评价产品价值;未运行的行为一律标注“未验证”
8
+
9
+ ---
10
+
11
+ ## 一、协作机制现状说明(数据流)
12
+
13
+ ### 1.1 全链路(含代码落点)
14
+
15
+ ```
16
+ 用户消息
17
+ │ agent/pre-step(step===1,仅 root session)
18
+ ▼
19
+ [L0 触发过滤] runtime.ts:1736 maybePlan
20
+ │ isSocialMessage / isVagueContinuation / isStatusQuestion 直接放行不建计划(plan.ts:182/228/274)
21
+ │ existing.dispatchPromise || phase==='executing' → 不重复规划
22
+ ▼
23
+ [L1 规划] runtime.ts:205 runPlanner → ctx.llm.stream(PLANNER_TIMEOUT_MS=120s)
24
+ │ plan.ts:675 buildPlannerPrompt(12 个部门、≤6 阶段、≤15 子任务)
25
+ │ plan.ts:649 extractJson → plan.ts:607 validatePlan → plan.ts:523 checkPlanGraph
26
+ ▼
27
+ [L2 计划落地] plan.ts:804 buildPlanMessage → runtime.ts:1863 enterDecision
28
+ │ 以 user/message(kind=workplan)注入,用户与主 Agent 同时可见
29
+ │ plan 模式:额外注入 notice,禁止派发(host.ts:273-283 tools.guard)
30
+ ▼
31
+ [L3 派发入口] host.ts:189 dsh_workplan_dispatch → runtime.ts:1453 dispatchTool
32
+ │ 守卫:root session、planId 匹配、plan 模式拒绝、dispatchPromise 去重、canResumePlan
33
+ │ 重建:内存无记录时 runtime.ts:1030 reconstructFromSession 从会话日志回放
34
+ ▼
35
+ [L4 调度] runtime.ts:672 dispatchPlan
36
+ │ readySubtasks(plan, statuses)(plan.ts:1503,只看 dependsOn 是否 done)
37
+ │ runWithConcurrency(ready, MAX_CONCURRENT=5)(runtime.ts:739;plan.ts:15)
38
+ │ 失败级联 markDependentsBlocked(plan.ts:1514)
39
+ ▼
40
+ [L5 子任务执行] runtime.ts:573 runSubtask → runtime.ts:375 executeSubtask
41
+ │ ctx.subagents.startActivation({ provider:'spawn', parent:主 Agent, maxDepth:1, delivery:'caller' })
42
+ │ buildChildPrompt(plan.ts:1638):全局任务/交付物/主要矛盾/阶段/子任务/依赖结果/执行约束
43
+ │ 看门狗:idle 300s / hard 900s(runtime.ts:65-67);stalled 重试 1 次
44
+ ▼
45
+ [L6 依赖回传] 只回传 dependsOn 的 {id,title,status,summary}(runtime.ts:404-415),summary ≤3000 字
46
+ ▼
47
+ [L7 落状态] writeSubtaskStatus → record.statuses(runtime.ts:363)
48
+ │ 子 Agent 输出首行 `BLOCKED:` → blocked(runtime.ts:485);否则一律 done
49
+ ▼
50
+ [L8 汇总回传] runtime.ts:655 buildRoundResult → plan.ts:863 buildResultMessage
51
+ │ append user/message(kind=workplan-result)+ dispatch 工具返回值(含 statuses/stats)
52
+ ▼
53
+ [L9 主 Agent 整合] host.ts:38-47 系统提示:核对事实/证据/验收,不合格用 dsh_workplan_update 改判
54
+ │ runtime.ts:1323 updateStatus(可被主 Agent 用于补完或降级)
55
+ ▼
56
+ [L10 外部可见] GET /dsh-workplan/plans(runtime.ts:1625 route)
57
+ client.ts:1344 fetch + client.ts:1376 setInterval 4000ms 轮询
58
+ ```
59
+
60
+ ### 1.2 设计意图(从代码与提示可确认的部分)
61
+
62
+ | 意图 | 实现位置 | 是否真正生效 |
63
+ |---|---|---|
64
+ | 主 Agent 只做“核对与整合”,具体工作下放部门 | host.ts:38-47 | 生效(软约束,靠提示) |
65
+ | 子 Agent 不得派发/取消/改计划 | runtime.ts:1326/1456/1376 的 `isRootSession` 检查 | 生效(硬约束) |
66
+ | 子 Agent 不得重启服务/装依赖/派生 Agent | plan.ts:1685 仅写进 prompt | **仅口头约束** |
67
+ | 依赖驱动、可并行 | plan.ts:1503 readySubtasks+runtime.ts:739 并发 5 | 生效 |
68
+ | 阶段门槛与检查点 | plan.ts:689-690、746 只进提示与 UI(client.ts:1456) | **不生效**(调度器无视阶段边界,plan.ts:1499-1501 注释自认“stage is only a grouping label”) |
69
+ | 受阻可续跑、已完成不重跑 | plan.ts:1589 canResumePlan、1560 resetBlockedStatuses | 生效(额度 4 次,可配置 0-5) |
70
+ | 刷新后状态不翻转 | runtime.ts:911 serialisePlan + 1030 reconstructFromSession | 大部分生效,C10 例外 |
71
+ | 部门是“组织单元” | plan.ts:28-43 DEPARTMENTS(12 个) | **只是文案标签**:不参与调度、无负责人、无部门内队列 |
72
+
73
+ ### 1.3 协作链路的真实形态
74
+
75
+ - **星型而非网状**:主 Agent 是唯一中枢;部门子 Agent 之间没有任何直接通道(无消息、无共享黑板、无互相提问)。
76
+ - **单向传递**:上游 → 下游只传 `status + summary` 文本;下游无法向上游追问,也无法告知“你的产物缺了什么”。
77
+ - **同步阻塞**:一次 `dsh_workplan_dispatch` 覆盖整轮执行,主 Agent 在返回前看不到任何中间结果(只有面板能看到心跳)。
78
+ - **回放即事实**:结果消息是唯一持久事实源(plan.ts:993 applyResultStatuses),内存 `state.records` 只是缓存(runtime.ts:1263,每会话单槽位)。
79
+
80
+ ---
81
+
82
+ ## 二、协作断点与风险点清单
83
+
84
+ > 编号 C1–C17。每条给出:现象 / 代码或文档出处 / 影响 / 复核方法。
85
+ > “复核方法”均为只读命令,任何人可在 `plugins/dsh-workplan` 下执行。
86
+
87
+ ### C1 派发期间主 Agent 是黑箱等待【代码】
88
+
89
+ - 现象:`dispatchTool` 同步 `await record.dispatchPromise`,直到全部子任务结束或总预算(默认 20 分钟)耗尽才返回;子任务进展只写 `record.heartbeatAt`(runtime.ts:455),不产生任何中间对话消息。工具超时被设为“总预算 + 20s”(host.ts:225),即宿主也允许它阻塞 20 分钟。
90
+ - 出处:runtime.ts:672-800(while 循环)、1566-1617(await + append);host.ts:225。
91
+ - 影响:用户中途问“在做什么”,主 Agent 没有任何可回答的上下文;一次慢子任务会让整轮“静默”十几分钟,与“各部门紧密联系”的诉求直接冲突。
92
+ - 复核:`grep -n "await record.dispatchPromise\|timeoutMs:" src/runtime.ts src/host.ts`
93
+
94
+ ### C2 部门之间没有横向通信【代码】
95
+
96
+ - 现象:`buildChildPrompt` 的依赖段只注入 `dependsOn` 的 `{id,title,status,summary}`,且 summary 在写入时已 `truncate(output, 3000)`;并行兄弟任务的存在、目标、产物完全不可见。
97
+ - 出处:runtime.ts:404-415;plan.ts:1638-1693;runtime.ts:490-500。
98
+ - 影响:跨部门产物格式对不上时,只能等下游失败再由主 Agent 兜底;没有“结对/会签/互评”的承载。
99
+ - 复核:`grep -n "dependencyResults" src/runtime.ts src/plan.ts`
100
+
101
+ ### C3 对话背景在计划时刻冻结,且被双重截断【代码】
102
+
103
+ - 现象:`conversationContext` 在 step 1 由 `recentConversation(session, 7000)` 计算并存入 record(runtime.ts:1568 使用),子 Agent prompt 内再 `truncate(…, 5000)`(plan.ts:1654)。之后用户补充的任何信息都不会进入已建计划的子任务;`reconstructFromSession` 不返回该字段(runtime.ts:1030-1200),重启/续跑后的子 Agent 背景为空。
104
+ - 出处:runtime.ts:124-146、1568;plan.ts:1654;runtime.ts:1030。
105
+ - 影响:部门拿到的是“旧意图”,越到后期越容易做偏;续跑场景下偏差最大。
106
+ - 复核:`grep -n "conversationContext" src/runtime.ts src/plan.ts`
107
+
108
+ ### C4 回传无结构,完成判定过宽(假完成风险)【代码+推断】
109
+
110
+ - 现象:唯一机器可读失败信号是子 Agent 输出首行匹配 `/^\s*BLOCKED\s*[::]/i`(runtime.ts:485);其余任何非空文本一律记 `done`。summary 只保留 3000 字自由文本,没有“证据/命令输出/文件路径/验收逐条打勾”的结构化字段。`acceptance` 数组没有被逐条核对,复核完全依赖主 Agent 自觉(host.ts:43-46 是软提示)。
111
+ - 出处:runtime.ts:485-520;plan.ts:1638-1693(执行要求段);plan.ts:416-448(acceptance 仅校验非空)。
112
+ - 影响:写明“受阻:…”而非 `BLOCKED:` 会被记成完成;子 Agent 声称完成但无证据时,主 Agent 缺少可机读的核对抓手。
113
+ - 复核:`grep -n "BLOCKED" src/runtime.ts src/plan.ts`;`grep -rn "acceptance" src/runtime.ts`
114
+
115
+ ### C5 依赖只看“状态=done”,不看“产物可用”【代码】
116
+
117
+ - 现象:`readySubtasks` 仅判断 `dependsOn.every(status==='done')`;不检查 outputs 是否真的存在。`markDependentsBlocked` 只写一句“上游子任务受阻:T1、T2”,不携带缺失产物/失败原因。
118
+ - 出处:plan.ts:1503-1512、1514-1540。
119
+ - 影响:上游“做完了但没交出可用物”时下游照常开跑,错误被推迟到更贵的环节;下游无法针对性补救。
120
+ - 复核:`sed -n '1503,1540p' src/plan.ts`
121
+
122
+ ### C6 阶段检查点只是展示,调度器无视阶段边界【代码+文档】
123
+
124
+ - 现象:planner 被要求为每阶段写 `checkpoint`、设置阶段门槛(plan.ts:689-690、746),但 `readySubtasks` 对 flatten 后的整图取就绪,跨阶段可直接并行;checkpoint 只在 UI 渲染(client.ts:1456)。
125
+ - 出处:plan.ts:1499-1501(注释:“A stage is only a grouping label”)、1503;client.ts:1456。
126
+ - 影响:“阶段验收后进入下一阶段”的协作承诺不成立;后期阶段可能在上游检查点未过时就开工。
127
+ - 复核:`grep -n "checkpoint" src/*.ts`
128
+
129
+ ### C7 主 Agent 与调度器双写同一状态表(无锁)【代码】
130
+
131
+ - 现象:`dsh_workplan_update` 直接改 `record.statuses`(runtime.ts:1323-1370),**不检查** `record.dispatchPromise`;而 `dispatchTool` 对重复派发有 `alreadyRunning` 保护。两边都没有版本号或“该子任务正在执行”的保护,后写者覆盖先写者。
132
+ - 出处:runtime.ts:1323-1370(updateStatus)对比 runtime.ts:1500-1520(dispatch 锁)。
133
+ - 影响:主 Agent 在派发中改判 → 子任务结束时被覆盖;或子任务完成结果覆盖主 Agent 的人工修正。职责边界在代码层不存在。
134
+ - 复核:`sed -n '1323,1345p' src/runtime.ts`;`grep -rn "update.*dispatch\|同时" tests/*.ts`(无此覆盖)
135
+
136
+ ### C8 工具描述承诺“重复调用幂等”,实现不一致【代码】
137
+
138
+ - 现象:host.ts:189-195 描述“重复调用是幂等的”;但并发重复调用走 alreadyRunning 分支,返回 `{ok:true, alreadyRunning:true, phase, startedAt}`,**不含 statuses/stats**(runtime.ts:1520)。
139
+ - 出处:host.ts:195;runtime.ts:1500-1520。
140
+ - 影响:模型第二次调用拿不到任何结果明细,可能误判“已成功但没结果”,进而重复回答或重复派发。
141
+ - 复核:`sed -n '1493,1520p' src/runtime.ts`
142
+
143
+ ### C9 续跑额度文案用常量,运行时可配置 → 数字会错【代码】
144
+
145
+ - 现象:`buildResultMessage` 用 `MAX_PLAN_RESUMES = 4` 计算“剩余额度”(plan.ts:900-901、1548),运行时却用 `limits.maxResumes`(0–5,runtime.ts:1268-1280、1543)。配置 `maxResumes≠4` 时,回给主 Agent 的额度数字与真实可用额度不符。
146
+ - 出处:plan.ts:900-901、1548;runtime.ts:1268-1280、1543。
147
+ - 影响:直接决定“受阻后该重试还是直接接手”的判断,属于协作决策信息错误。
148
+ - 复核:`grep -n "MAX_PLAN_RESUMES" src/plan.ts src/runtime.ts`
149
+
150
+ ### C10 未派发计划被内存标记取消,但不落盘 → 实时/回放不一致【代码】
151
+
152
+ - 现象:新一轮 step 1 时若上一计划从未派发,`maybePlan` 直接把内存 `phase='cancelled'` 并只写 `record.errors`(runtime.ts:1758-1765),**不 append 取消消息**;随后新计划覆盖单槽位 record。回放只认 `workplan-cancel` 标记消息(plan.ts:975-992),因此旧计划在刷新后回到 pending/stale。
153
+ - 出处:runtime.ts:1749-1765;plan.ts:950-992;runtime.ts:1030-1200。
154
+ - 影响:刷新前后结论不同,违反插件自身在 1.6.0 声明的“实时与回放同源”不变量(runtime.ts:957 注释)。
155
+ - 复核:`sed -n '1749,1770p' src/runtime.ts`;`grep -n "parseCancelMessage" src/runtime.ts`
156
+
157
+ ### C11 跨计划、跨会话没有协作载体【代码】
158
+
159
+ - 现象:`state.records` 每会话只有一个记录(runtime.ts:1263);面板只列 root session 且最多 20 条(MAX_LIVE_SESSIONS,runtime.ts:83、1218-1240)。一个复杂任务被拆成多轮计划后,计划之间没有依赖、引用或汇总视图;`finished[]` 快照只在同会话内、且需显式 planId 才能取回。
160
+ - 出处:runtime.ts:1030-1200(finished 快照)、1218-1240、1262。
161
+ - 影响:用户要求的“持之以恒、紧密联系”在“多计划/多轮次”尺度上没有实现载体;重启后旧计划只能靠 planId 逐个唤醒。
162
+ - 复核:`grep -n "MAX_LIVE_SESSIONS\|state.records" src/runtime.ts`
163
+
164
+ ### C12 子 Agent 能力边界一半靠 prompt,一半靠代码【代码】
165
+
166
+ - 现象:硬约束只有三处 `isRootSession` 拒绝(update/cancel/dispatch,runtime.ts:1326、1376、1456);“不能重启服务、不能安装/升级、不要派生 Agent”只写在 prompt(plan.ts:1685),`maxDepth:1` 只限制派生深度(runtime.ts:421)。文件写入与命令执行没有部门级护栏;`tools.guard` 只拦 plan 模式下的 dispatch(host.ts:273-283)。
167
+ - 出处:plan.ts:1685;runtime.ts:421;host.ts:273-283。
168
+ - 影响:越权动作可执行且不会被调度器发现;出事后只能靠事后读 summary。
169
+ - 复核:`grep -n "maxDepth\|tools.guard" src/runtime.ts src/host.ts`
170
+
171
+ ### C13 规划超限即降级,没有“再分解”兜底【代码】
172
+
173
+ - 现象:`MAX_STAGES=6`、`MAX_SUBTASKS=15`、`MAX_PLAN_JSON_CHARS=60000`(plan.ts:13-16);校验失败或 LLM 超时/输出非 JSON 时进 degraded(plan.ts:819-853;runtime.ts:1290-1330),只注入“请向用户说明并询问是否重试”,不自动缩小范围或分阶段重规划。
174
+ - 出处:plan.ts:13-16、523-605、607-628、819-853;runtime.ts:1290-1330。
175
+ - 影响:任务越复杂越容易撞上限,偏偏此时全线停摆、必须人工重试。
176
+ - 复核:`sed -n '11,16p' src/plan.ts`;`sed -n '819,853p' src/plan.ts`
177
+
178
+ ### C14 失败重试只覆盖“停滞”一种,且没有失败经验回灌【代码】
179
+
180
+ - 现象:`executeSubtask` 最多 2 次尝试,仅 `CHILD_STALLED` 触发重试(runtime.ts:516-523);超时、非 completed、空输出直接 blocked。再次 resume 用**完全相同**的 prompt 重跑(buildChildPrompt 不读取上次 error),续跑上限 4 次。
181
+ - 出处:runtime.ts:390-535、573-620;plan.ts:1589-1630。
182
+ - 影响:同一个坑可能重复踩满 4 次预算;失败原因没有反馈给下一次尝试。
183
+ - 复核:`grep -n "CHILD_STALLED\|attempt < 2" src/runtime.ts`
184
+
185
+ ### C15 计划规模与时间预算之间没有校验【代码+文档】
186
+
187
+ - 现象:planner 被要求“单个子任务 10 分钟内完成”(plan.ts:704),运行时默认子任务上限 15 分钟、总预算 20 分钟、并发 5(runtime.ts:65-79;plan.ts:15)。planner 不知道预算,也不校验“15 个子任务 × 10 分钟”在 20 分钟内是否可能完成。
188
+ - 出处:plan.ts:704、15;runtime.ts:65-79。
189
+ - 影响:合法但过大的计划必然撞总预算 → paused → 需要多轮续跑,用户观感是“怎么老做不完”。
190
+ - 复核:`grep -n "TOTAL_TIMEOUT_MS\|CHILD_TIMEOUT_MS" src/runtime.ts`
191
+
192
+ ### C16 文档层:无协作机制设计文档,行号引用已漂移【文档】
193
+
194
+ - 现象:`docs/` 下 20 份 Markdown 文档全部围绕可视化/计数/阶段语义,**没有一份描述“任务→部门→子任务→回传”的协作设计**。且行号引用已过期:`docs/status-grouping-ia.md:61` 用 `src/runtime.ts:884` 指 departments,实际 884 行是 `sessionTurnState`,departments 聚合在 1007 行。这 20 份文档中共 265 处 `src/*.ts:NNN` 形式引用,未逐一校验。
195
+ - 出处:docs/status-grouping-ia.md:61;src/runtime.ts:884、1023。
196
+ - 影响:后续 Agent/维护者按文档定位会读错代码,正是本次任务“代码可读性差导致误判”的风险来源。
197
+ - 复核:`sed -n '61p' docs/status-grouping-ia.md`;`sed -n '884p;1007p' src/runtime.ts`;`grep -rho "src/[a-z]*\.ts:[0-9]\+" docs/*.md | wc -l`
198
+
199
+ ### C17 人-机-部门三方只靠 4 秒轮询同步【代码】
200
+
201
+ - 现象:面板每 4s `fetch /dsh-workplan/plans`(client.ts:1344、1376),无推送;该面板是用户观察部门进展的唯一实时界面,而主 Agent 连这个界面都不读(dispatch 期间不返回)。
202
+ - 出处:client.ts:1344、1376;runtime.ts:1625 route。
203
+ - 影响:用户看到进度、主 Agent 看不到;主 Agent 的整合结论与用户此刻看到的画面可能不同步。
204
+ - 复核:`grep -n "setInterval\|/dsh-workplan/plans" src/client.ts`
205
+
206
+ ---
207
+
208
+ ## 三、风险分级(按“是否直接破坏协作闭环”排序)
209
+
210
+ | 级别 | 断点 | 理由 |
211
+ |---|---|---|
212
+ | 高 | C1、C4、C5、C7 | 直接造成“主 Agent 失联 / 假完成 / 下游空跑 / 双写覆盖”,协作闭环会断 |
213
+ | 高 | C9、C8 | 回给主 Agent 的决策信息错误,会引发错误动作(误判额度、误判幂等) |
214
+ | 中 | C2、C3、C6、C12、C14 | 削弱协作质量,但不一定立刻表现为失败 |
215
+ | 中 | C10、C11、C13、C15 | 状态一致性与复杂任务承载能力问题 |
216
+ | 低 | C16、C17 | 可维护性/体验问题,不改变执行结果 |
217
+
218
+ ---
219
+
220
+ ## 四、现有机制中已被验证有效的护栏(避免优化时误删)
221
+
222
+ 1. 子 Agent 无法 update/cancel/dispatch(`isRootSession`,runtime.ts:1326 / 1376 / 1456)——硬约束,代码层成立;但 `grep -rn "NOT_ROOT" tests/` 无命中,即**没有测试覆盖**这三条拒绝路径。
223
+ 2. 每个子任务独立 deadline,且超时**必定结算**(`Promise.race`,runtime.ts:573-629),一个慢子任务不会拖死整条 DAG。
224
+ 3. 预算耗尽记 `paused` 而非 `blocked`,未完成项保留 `pending` 以便续跑(runtime.ts:790-850),有回归测试(`tests/workplan-budget-pause.test.ts`)。
225
+ 4. 结果消息是持久事实源,刷新后由 `applyResultStatuses` 回放(plan.ts:993-1015),有测试(`tests/runtime-replay.test.ts`)。
226
+ 5. plan 模式只拦 dispatch、不冻结其他工具(host.ts:273-283),不会死锁。
227
+ 6. `stale pending` 不再被静默改判 cancelled(runtime.ts:1180)。
228
+
229
+ ---
230
+
231
+ ## 五、给后续优化(T3 及之后)的事实约束
232
+
233
+ 1. 任何“跨部门直接通信”的新机制都必须解决 C1 的**同步阻塞**前提,否则只是把等待搬到另一处。
234
+ 2. 任何“主 Agent 中途介入/改判”的设计必须同时解决 C7 的**双写竞争**(需要锁或版本号),否则会制造新的状态翻转。
235
+ 3. 任何“阶段门槛”设计必须改 `readySubtasks`(plan.ts:1503),因为当前调度器根本不读 stage。
236
+ 4. 修改回传字段时必须同步改三处:`writeSubtaskStatus`(runtime.ts:363)、`buildResultMessage`(plan.ts:863)、`applyResultStatuses`(plan.ts:993),否则实时/回放再次分叉。
237
+ 5. 额度、超时这类“可配置值”只能在 `limits`(runtime.ts:1268-1280)取一次,禁止在 `plan.ts` 里再写常量(C9 即反例)。
238
+
239
+ ---
240
+
241
+ ## 六、本报告的局限
242
+
243
+ - 未运行插件、未执行真实派发;所有“影响”均为静态推断,标注【推断】处未验证。
244
+ - 未覆盖 `src/client.ts` 的交互细节(T2 只关心协作与状态链路),客户端只核对了轮询与部门渲染点。
245
+ - 未评估 1.6.0 之后那批未提交改动对协作链路的影响(T1 已记录工作区不干净);若该批改动触及 `runtime.ts`/`plan.ts`,本报告行号需重新核对。
246
+ - 测试覆盖只做了“有无”判断,未评估断言强度。