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,646 @@
1
+ # dsh-workplan 卡住问题复盘、诊断与 1.3.4 修复
2
+
3
+ > 复盘对象:`<repo>`(1.2.1 及更早版本的运行记录)
4
+ > 修复版本:**1.3.0 → 1.3.1 → 1.3.2 → 1.3.3 → 1.3.4**
5
+ > 复盘时间:2026-10-26
6
+ > 证据性质:本文件所有数字均来自本机可读的会话存档或可重跑测试;标注「未验证」的条目没有证据支撑。
7
+
8
+ ---
9
+
10
+ ## 1. 结论摘要
11
+
12
+ 「卡住」不是一种故障,而是**一条失效链**:
13
+
14
+ 1. 单个子 Agent 停住 → 被**固定 300 秒墙钟**判死(`CHILD_TIMEOUT_MS = 300000`,不看是否还在产出);
15
+ 2. 它的下游全部被标成「上游子任务受阻」→ 整份计划进入 `blocked`;
16
+ 3. 再次调用 `dsh_workplan_dispatch` 时,所有子任务都是 `blocked`,可调度集合为空 → 派发器**一个子 Agent 都没跑就返回 `ok: true`**;
17
+ 4. 模型看到 `ok: true` 以为已恢复,于是永远等下去;用户看到的则是「完成 0/N」。
18
+
19
+ 历史证据里,**76% 的受阻子任务是一次失败引发的级联**(112/148)。所以真正的放大器不是 300 秒本身,而是第 3 步的「假成功」——它把一次可恢复的失败变成了死局。
20
+
21
+ 1.3.0 的修复分三层:**判定更准**(无进展才算卡住)、**恢复可达**(受阻可续跑、额度用尽时明确交还主 Agent)、**不可能静默卡死**(取消一定能生效、陈旧派发会超时返回、错误永远可读)。
22
+
23
+ ---
24
+
25
+ ## 2. 数据源与「卡住」判定口径
26
+
27
+ ### 2.1 数据源
28
+
29
+ | 数据源 | 路径 | 覆盖 | 可读性 |
30
+ | --- | --- | --- | --- |
31
+ | 会话存档 | `~/.dsh/sessions/**/session.v4.jsonl.zstd` | 336 个会话文件(`find … -name session.v4.jsonl.zstd | wc -l` = 336) | 可直接 `zstd -dc` 解压 |
32
+ | 含插件记录的会话 | 同上 | 10 个会话目录;解析出 26 条结果载荷,其中 3 条是 fork 会话复制的同一份(同 `planId`+`dispatchedAt`)→ **去重后 23 次派发** | 可读 |
33
+ | 插件源码 | `plugins/dsh-workplan/src` | 1.2.1 全量 | 可读 |
34
+ | 构建产物 | `plugins/dsh-workplan/lib` | 1.2.1 全量 | 可读 |
35
+ | 本次会话复现 | 本会话派发记录 | 1 次(11 子任务) | 可读 |
36
+
37
+ 时间覆盖:2026-10-25 14:52 → 2026-10-26 18:03(`dispatchedAt` 最早/最晚)。
38
+
39
+ **缺口(不推断为「不存在」)**:336 个会话文件中只有 10 个目录含 `DSH-WORKPLAN-RESULT` 载荷。其余会话没有插件结果记录,无法判断是「没用到插件」「计划未派发」还是「记录被裁剪」,一律列为**待确认**。
40
+
41
+ ### 2.2 判定口径
42
+
43
+ 满足任一条件即记为「卡住事件」:
44
+
45
+ - 派发返回 `ok: true` 但 `stats.done == 0` 且 `stats.blocked > 0`(假成功);
46
+ - 出现 `子任务 T? 超时(300000ms)` 错误串;
47
+ - 计划长期停在 `blocked` 且无后续派发;
48
+ - 用户侧想停止却收到 `计划正在执行,不能取消`;
49
+ - 错误串不可读(`[object Object]`)导致无法定位。
50
+
51
+ ---
52
+
53
+ ## 3. 历史证据
54
+
55
+ ### 3.1 派发结果分布(去重后 23 次派发)
56
+
57
+ | 结果 | 次数 | 说明 |
58
+ | --- | --- | --- |
59
+ | 全部完成 | 6 | 同一版本、同一环境下可以跑完,**说明不是全局性环境故障** |
60
+ | 完成 0 个且至少 1 个受阻 | **11** | 高危:表面 `ok: true`,实际零产出 |
61
+ | 至少 1 个受阻(含上项) | 17 | 74% |
62
+ | 计划最大子任务数 | 13 | 超过 5 并发,会排队 |
63
+
64
+ ### 3.2 148 条受阻子任务的直接原因
65
+
66
+ | 原因 | 条数 | 占比 |
67
+ | --- | --- | --- |
68
+ | 级联:`上游子任务受阻:T?` | **113** | **76%** |
69
+ | 超时(其中 5 条明写 `300000ms`,17 条为旧版无毫秒文案) | 22 | 15% |
70
+ | `调度次数异常`(派发循环保护触发) | 12 | 8% |
71
+ | `[object Object]`(错误不可读) | 1 | <1% |
72
+
73
+ 另有 1 条 `执行已取消` 记录、1 条用户在计划执行中尝试取消被拒的痕迹。
74
+
75
+ 补充说明(避免把已修的问题再算一次):那 12 条 `调度次数异常` 出现在 2026-10-25 的旧计划里,对应缺陷是调度器把 `readySubtasks()` 返回对象的 `id` 当成了 `subtaskId`,导致每个可调度项都被跳过、循环空转到保护上限。当前源码已修复(`src/runtime.ts` 派发循环内有注释说明),并有回归测试 `dispatch runs real DAG subtasks and does not hit the loop guard`。这些历史记录的具体插件版本号**未验证**。
76
+
77
+ **读法**:把 113 条级联剥掉,真正独立的失败证据只有 22 条超时 + 12 条循环 + 1 条不可读错误。也就是说,**一次失败平均拖垮约 5 个子任务**——这正是「卡住」在用户视角里的样子。
78
+
79
+ ### 3.3 本会话内的复现(1.2.1,可逐字段核对)
80
+
81
+ | 字段 | 值 |
82
+ | --- | --- |
83
+ | 计划 | `wp-286d6087-2f60-44c3-9632-02b93d1514da`,11 个子任务 |
84
+ | 唯一失败子任务 | T1,`childId 01d0a03c-0602-4913-9251-5e636c449b41` |
85
+ | `startedAt` → `finishedAt` | `1793009032411` → `1793009332411` |
86
+ | 差值 | **恰好 300000 ms** |
87
+ | 失败时状态 | `progress: 100`、`status: blocked`(进度与状态自相矛盾) |
88
+ | 其余 10 个子任务 | 全部 `上游子任务受阻:…`,无一执行 |
89
+ | 派发返回值 | `ok: true`,完成 0/11 |
90
+
91
+ 「恰好 300000 ms」排除了网络抖动、模型波动等解释:是代码里的常数,不是外部环境。
92
+
93
+ ---
94
+
95
+ ## 4. 根因
96
+
97
+ | 编号 | 根因 | 代码位置(1.2.1) | 为什么会导致「卡住」 |
98
+ | --- | --- | --- | --- |
99
+ | R1 | 固定的墙钟上限,且不区分「还在产出」和「已经停住」 | `CHILD_TIMEOUT_MS = 300000` | 慢但健康的子 Agent 被一律杀头;用户无法配置 |
100
+ | R2 | 一个子任务受阻 → 所有下游标为受阻 | 派发器依赖判定 | 放大 5 倍(112/148),且不可逆 |
101
+ | R3 | **受阻计划重新派发时「假成功」** | `readySubtasks()` 对全 `blocked` 返回空 → `ok: true` | 模型以为已恢复,永远等待;无任何提示说明「什么都没跑」 |
102
+ | R4 | 运行中的计划拒绝取消 | `cancelPlan` 抛 `PLAN_RUNNING` | 想停也停不下来;唯一出路是杀进程 |
103
+ | R5 | `dispatchPromise` 永挂 → 永远回答 `already running` | `dispatchTool` 只 `await` 不设上限 | 一次僵死会污染后续所有调用的入口 |
104
+ | R6 | 错误用 `String(error)` 渲染 | `pushRecordError` / 子任务 error | 落盘成 `[object Object]`,事后无法诊断 |
105
+ | R7 | 子 Agent 提示词直接解引用 `taskUnderstanding` / `contradictions` | `buildChildPrompt` | 重建或旧版计划缺字段时,每个子 Agent 瞬间失败 → 整份计划受阻(1.3.0 开发期由测试实际触发) |
106
+ | R8 | 续跑后不重写结果消息;构建脚本漏拷新模块 | `record.resultWritten`、`package.json` build | 刷新页面看到旧的受阻快照;新模块会让插件加载失败(1.3.0 引入时必须同步修) |
107
+ | R9 | 工具超时硬编码 `1220000`,与计划预算不联动 | `host.ts` dispatch 工具 `timeoutMs` | 提高了计划预算后,工具仍会在中途被杀 |
108
+
109
+ 环境因素(网络、模型)**不能**解释证据:同一时间段有 6 次全部完成的派发;失败时长精确等于常数。
110
+
111
+ ---
112
+
113
+ ## 5. 修复映射(1.3.0)
114
+
115
+ | 根因 | 修复 | 位置 |
116
+ | --- | --- | --- |
117
+ | R1 | 拆成「无进展窗口(默认 300s)」+「绝对上限(默认 900s)」;只有会话日志停止增长才判 `stalled`,触到上限判 `exhausted`;`stalled` 自动换新子 Agent 重试一次,`exhausted` 不重试 | `src/watchdog.ts:37`(`pickTimeoutReason`)、`src/watchdog.ts:121`(`createProgressWatchdog`)、`src/runtime.ts:341`/`:351`(`normaliseChildTimeout`/`normaliseIdleTimeout`) |
118
+ | R2 | 受阻只影响自身,恢复由续跑承担:`resetBlockedStatuses` 只重置 `blocked`/`in_progress`,`done` 永不重跑 | `src/plan.ts:1158` |
119
+ | R3 | `canResumePlan` 判定:仅 `blocked` 可续跑,`cancelled` 永不自动续跑,额度默认 2(0–5 可配);额度耗尽返回 `ok: false` + `hint` 要求主 Agent 直接接手 | `src/plan.ts:1187`、`src/runtime.ts:652` 起 |
120
+ | R4 | 取消会中止在途派发,返回 `abortedRunning: true`,计划进入 `cancelled`,在途结果仍写 durable 消息 | `src/runtime.ts:1116`、`src/runtime.ts:1218` |
121
+ | R5 | 超过「计划预算 + 120s」仍未返回 → `ok: false`、`stale: true`、`hint` 提示直接接手 | `src/runtime.ts:1165` |
122
+ | R6 | `describeError()` 统一渲染 Error / 字符串 / 嵌套对象 / Envelope 文本;错误列表与子任务 error 全部走它 | `src/watchdog.ts:64` |
123
+ | R7 | 提示词对 `taskUnderstanding`、`contradictions`、`method`、`inputs`、`outputs`、`acceptance` 全部做防御性读取 | `src/plan.ts:1222` |
124
+ | R8 | 续跑清除 `resultWritten`(`src/runtime.ts:659`);build 脚本补 `dist/watchdog.js` | `src/runtime.ts`、`package.json` |
125
+ | R9 | 工具超时 = `limits.totalTimeoutMs + 20000`;四项阈值可用配置键或环境变量覆盖 | `src/host.ts:213`、`src/host.ts:228` |
126
+
127
+ ### 5.1 新增可配置项
128
+
129
+ | 配置键 | 环境变量 | 默认 | 范围 |
130
+ | --- | --- | --- | --- |
131
+ | `childTimeoutMs` | `DSH_WORKPLAN_CHILD_TIMEOUT_MS` | 900000 | 1000–1800000 |
132
+ | `idleTimeoutMs` | `DSH_WORKPLAN_IDLE_TIMEOUT_MS` | 300000 | 1000–900000 |
133
+ | `totalTimeoutMs` | `DSH_WORKPLAN_TOTAL_TIMEOUT_MS` | 1200000 | ≥ 60000 |
134
+ | `maxResumes` | `DSH_WORKPLAN_MAX_RESUMES` | 2 | 0–5 |
135
+
136
+ ### 5.2 不变量(修复后必须始终成立)
137
+
138
+ 1. 子 Agent 只要还在写会话日志,就不会因为「慢」被杀死。
139
+ 2. `blocked` 计划再次派发时,要么真的跑起来,要么 `ok: false` 并给出原因——不存在「`ok: true` 但零产出」。
140
+ 3. 任何派发都有终点:完成、受阻、取消、或超时返回,四者之一。
141
+ 4. 错误文本永远可读,不含 `[object Object]`。
142
+ 5. 取消命令在任何阶段都生效。
143
+
144
+ ---
145
+
146
+ ## 6. 验证
147
+
148
+ ### 6.1 自动化测试
149
+
150
+ `npm test`(build → 测试编译 → node --test):**51 通过 / 0 失败 / 2718ms**。
151
+
152
+ 新增 `tests/workplan-stuck-recovery.test.ts`(11 个用例)逐条对应根因:
153
+
154
+ | 用例 | 覆盖根因 |
155
+ | --- | --- |
156
+ | `canResumePlan allows a blocked plan…` | R3(拒绝 cancelled、额度耗尽) |
157
+ | `resetBlockedStatuses keeps done work…` | R2 |
158
+ | `result message tells the model how to recover…` | R3 可观测性 |
159
+ | `pickTimeoutReason distinguishes idle stall from hard ceiling` | R1 |
160
+ | `watchdog fires when the child log stops growing…` | R1(冻结日志判 stalled;持续增长不误杀) |
161
+ | `timeouts are clamped…` | R1(坏配置不能禁用/放大超时) |
162
+ | `describeError never renders an object as [object Object]` | R6 |
163
+ | `a stalled child blocks only itself, then a re-dispatch resumes` | R1+R2+R3+R8 端到端:停滞→重试→受阻→续跑→完成,`resumeCount=1`,两条 durable 结果 |
164
+ | `re-dispatching a blocked plan with no resume budget left…` | R3(额度耗尽不消耗预算) |
165
+ | `cancel stops a running dispatch instead of being refused` | R4 |
166
+ | `a dispatch promise that never settles…` | R5 |
167
+
168
+ 这些用例在 1.2.1 上会失败,在 1.3.0 上通过——即「回归可复现」。
169
+
170
+ ### 6.2 加载冒烟
171
+
172
+ 在隔离的假 `ctx` 中 `import('./lib/host.js')` 并 `apply`:
173
+
174
+ - 导出齐全:`apply, meta, name, inject, PROMPT_ORDER, PROMPT_SECTION, createUpdateTool, createDispatchTool, createCancelTool, plannerOutputSchema`
175
+ - 三个工具注册成功:`dsh_workplan_update`、`dsh_workplan_cancel`、`dsh_workplan_dispatch`
176
+ - 派发工具超时按预算推导为 `1220000`(= 1200000 + 20000)
177
+
178
+ ### 6.3 未验证项
179
+
180
+ - **未在真实大计划上端到端跑 1.3.0**:当前运行的 DSH 进程(PID 765,端口 3080)在启动时已加载 1.2.1,host 代码不支持热更新;本会话里的每次 `dsh_workplan_dispatch` 仍是旧实现。需要重启后复测(见 §8)。
181
+ - 只复盘到含插件记录的 8 个会话;其余 328 个会话是否用过插件**无法判定**。
182
+ - 900s 绝对上限下的长时间子 Agent 行为只在假子 Agent 上验证过(1s 缩放),未在真实模型上跑满 900s。
183
+
184
+ ---
185
+
186
+ ## 7. 残余风险
187
+
188
+ | 风险 | 影响 | 缓解 |
189
+ | --- | --- | --- |
190
+ | 子 Agent「缓慢但持续产出」会耗尽 900s 上限 | 该子任务受阻,下游受阻 | 上限可配;续跑保留已完成部分;`hint` 要求主 Agent 接手 |
191
+ | 续跑额度默认 2 次仍可能不够 | 第三次起必须人工接手 | 可用 `DSH_WORKPLAN_MAX_RESUMES` 调至 5;结果消息明确说明 |
192
+ | 计划重建依赖 durable 消息 | 消息被裁剪则续跑信息丢失 | 消息与计划同源落盘,不依赖内存态 |
193
+ | 未接入集中监控 | 只能靠下次复盘扫描 | 建议按 §8.3 定期扫描 `子任务 … 超时`、`readySubtasks 为空`、`[object Object]` |
194
+
195
+ ---
196
+
197
+ ## 8. 升级、验证与回滚
198
+
199
+ ### 8.1 版本
200
+
201
+ `1.2.1 → 1.3.0`(minor:行为变化 + 新配置项,无破坏性 API 改动;工具参数未变)。
202
+
203
+ 变更文件:`src/watchdog.ts`(新增)、`src/plan.ts`、`src/runtime.ts`、`src/host.ts`、`tests/workplan-stuck-recovery.test.ts`(新增)、`package.json`、`package-lock.json`、`CHANGELOG.md`、`docs/stuck-review-1.3.0.md`。
204
+
205
+ ### 8.2 生效方式(需要重启)
206
+
207
+ 插件通过符号链接 `~/.dsh/profiles/web/node_modules/dsh-workplan → plugins/dsh-workplan` 加载,`npm run build` 后 `lib/` 已是 1.3.0,但**已启动的进程仍在跑 1.2.1**。重启步骤(带注释版):
208
+
209
+ ```bash
210
+ # 1) 进入 DSH 所在的 tmux 会话(当前 GUI 就跑在这个会话里)
211
+ tmux attach -t dsh
212
+ # 2) 按 Ctrl-C 结束旧的 dsh 进程
213
+ # 3) 用与原来完全相同的参数重启
214
+ npx @deepseek-ai/dsh@next --profile web --host 127.0.0.1 --port 3080 \
215
+ --trusted-host <your-tailnet-host> --no-open
216
+ ```
217
+
218
+ 可直接复制版:
219
+
220
+ ```bash
221
+ tmux attach -t dsh
222
+ npx @deepseek-ai/dsh@next --profile web --host 127.0.0.1 --port 3080 --trusted-host <your-tailnet-host> --no-open
223
+ ```
224
+
225
+ 重启后验证(带注释版):
226
+
227
+ ```bash
228
+ # 查看插件版本是否已是 1.3.0
229
+ grep '"version"' <repo>/package.json
230
+ # 重新跑全量测试,确认产物与测试一致
231
+ cd <repo> && npm test
232
+ ```
233
+
234
+ 可直接复制版:
235
+
236
+ ```bash
237
+ grep '"version"' <repo>/package.json
238
+ cd <repo> && npm test
239
+ ```
240
+
241
+ 重启后第一件事:在 GUI 里重新派发一个真实任务,确认受阻项可以被续跑而不是「完成 0/N 且 ok: true」。
242
+
243
+ ### 8.3 每次复盘的重扫命令(防止复发看不见)
244
+
245
+ ```bash
246
+ # 统计含插件记录的会话:去重后的派发数、假成功(ok 但零完成)数
247
+ python3 - <<'SCAN'
248
+ import json,os,re,subprocess
249
+ ROOT=os.path.expanduser('~/.dsh/sessions'); rows=[]
250
+ for dp,_,fns in os.walk(ROOT):
251
+ for fn in fns:
252
+ if fn!='session.v4.jsonl.zstd': continue
253
+ p=os.path.join(dp,fn)
254
+ txt=subprocess.run(['zstd','-dc',p],capture_output=True).stdout.decode('utf-8','replace')
255
+ if 'DSH-WORKPLAN-RESULT:BEGIN' not in txt: continue
256
+ for line in txt.splitlines():
257
+ try: e=json.loads(line)
258
+ except: continue
259
+ d=e.get('data') or {}; m=d.get('message') or d
260
+ t=''.join(c.get('text','') for c in (m.get('content') or []) if isinstance(c,dict))
261
+ mm=re.search(r'RESULT:BEGIN -->\s*(.*?)\s*<!-- DSH-WORKPLAN-RESULT:END', t, re.S)
262
+ if not mm: continue
263
+ try: pay=json.loads(mm.group(1))
264
+ except: continue
265
+ rows.append(pay)
266
+ uniq={(r.get('planId'),r.get('dispatchedAt')):r for r in rows}
267
+ u=list(uniq.values())
268
+ fake=[r for r in u if (r.get('stats') or {}).get('done')==0 and (r.get('stats') or {}).get('blocked',0)>0]
269
+ print('原始载荷',len(rows),'去重派发',len(u),'假成功(零完成)',len(fake))
270
+ for r in fake: print(' ',r.get('dispatchedAt'),r.get('planId'),r.get('stats'))
271
+ SCAN
272
+ ```
273
+
274
+ ### 8.4 回滚
275
+
276
+ **如实说明**:本次修改前未对 1.2.1 源码做时间戳快照(过程缺口)。因此:
277
+
278
+ - 回滚到 1.2.1 需要按 §8.1 的变更文件清单,反向撤销对应改动(续跑/看门狗/取消/超时推导),或使用你机器上已存在的 Time Machine / 编辑器本地历史备份(未验证其可用性)。
279
+ - 1.3.0 自身已快照:`<repo-parent>/.backups/dsh-workplan-1.3.0-20261026-182341.tar.gz`(不含 `node_modules`、`dist`、`dist-tests`,可 `npm run build` 重建)。
280
+ - 建议下一步:`cd plugins/dsh-workplan && git init && git add -A && git commit -m "dsh-workplan 1.3.0: fix stuck plans"`,此后任何改动都有可回滚历史。
281
+
282
+ 回滚操作(带注释版):
283
+
284
+ ```bash
285
+ # 停掉 DSH(同 §8.2 的 Ctrl-C),然后用备份覆盖源码
286
+ cd <repo-parent>
287
+ tar -xzf .backups/dsh-workplan-1.3.0-20261026-182341.tar.gz
288
+ cd dsh-workplan && npm run build
289
+ ```
290
+
291
+ 可直接复制版:
292
+
293
+ ```bash
294
+ cd <repo-parent> && tar -xzf .backups/dsh-workplan-1.3.0-20261026-182341.tar.gz && cd dsh-workplan && npm run build
295
+ ```
296
+
297
+ ---
298
+
299
+ ## 9. 证据追溯表
300
+
301
+ | 结论 | 证据 |
302
+ | --- | --- |
303
+ | 300 秒墙钟是常数而非环境 | 本会话 T1 `finishedAt - startedAt = 300000` 整;5 条历史错误串含 `(300000ms)` |
304
+ | 假成功广泛存在 | 11/23 次派发「零完成且至少 1 个受阻」 |
305
+ | 级联是主要放大器 | 148 条受阻中 113 条为 `上游子任务受阻` |
306
+ | 非全局环境故障 | 同期 6 次派发全部完成 |
307
+ | 修复有效 | 51/51 测试通过;11 个新用例在 1.2.1 上必失败 |
308
+ | 1.3.0 可加载 | 隔离 `ctx` 冒烟:3 个工具注册成功,超时 1220000 |
309
+ | 尚未在运行进程生效 | PID 765 启动于修改前;host 代码无热更新 |
310
+
311
+ ---
312
+
313
+ # 附录 A:1.3.1 真实进程端到端实证(2026-10-26)
314
+
315
+ PID 765(1.2.1)重启后为 PID 24118(启动 18:46:29,加载 1.3.1 构建字节)。18:52:48 自动生成 4 阶段 9 子任务计划 `wp-72bb11e3`,18:53:18 派发,19:13:18 返回 `完成 2/9,受阻 7`。
316
+
317
+ ## A.1 已被证明修好的部分
318
+
319
+ | 证据 | 说明 |
320
+ | --- | --- |
321
+ | T1 `startedAt 1793011998610 → finishedAt 1793012839013`,差值 **840403 ms(14 分 0 秒)** | 同一子任务在 1.2.1 下会在 300000 ms 被杀并级联;1.3.1 下它完整跑完并 `done` |
322
+ | T2 137629 ms 完成,未误杀 | 硬上限 900 s 未误伤 |
323
+ | 结果载荷含 `resumeAvailable:true`、`resumeCount:0` | 续跑字段在真实进程中生效 |
324
+ | 客户端 `client.js` 由进程直接提供,含「还可续跑」等 1.3.1 文案 | 面板侧修复已随进程生效 |
325
+
326
+ ## A.2 本轮暴露的新缺陷:计划总预算把正常慢计划判成失败
327
+
328
+ - 时间线:18:53:18 派发 → T1 用掉 840 s、T2 用掉 137 s → 19:13:18 到达 `TOTAL_TIMEOUT_MS = 1200000`(20 分钟)→ 正在跑的 T3 被中止并记为「总执行超时」→ T4–T9 以「上游子任务受阻:T3」级联受阻。
329
+ - 为什么是缺陷(而不是配置问题):
330
+ 1. 预算到点与子任务失败共用同一套「受阻」语义,面板再次显示「0~2/N 做好了、N 卡住了」,正是用户反复投诉的症状;
331
+ 2. 计划里有 5 个能独立并行的子任务从未被启动,却被记为失败;
332
+ 3. 20 分钟固定值与本计划实际需要(T1 一项就 14 分钟)严重不匹配。
333
+ - 另外:本轮自动生成的计划把「执行真实派发」「重启服务」写成子任务,而子 Agent 没有派发权限、不能重启服务,这类子任务从设计上不可完成(T3 即使给足时间也过不了)。
334
+
335
+ ## A.3 1.3.2 的修复
336
+
337
+ | 缺陷 | 修复 | 证据 |
338
+ | --- | --- | --- |
339
+ | 预算到点 = 失败 | 预算到点改为 `paused`:未完成子任务保持 `pending`,清掉中止尝试写入的「未完成:总执行超时」,错误文案写明「本轮执行预算(N 分钟)已到:已完成 X/Y,其余 Z 项保留为未完成,再次派发即可续跑」 | `tests/workplan-budget-pause.test.ts` 用例 1 |
340
+ | 刷新后状态回退 | `reconstructFromSession` 记住结果消息里的 `phase: paused`,刷新不会退回「正在做」 | 用例 3 |
341
+ | 续跑额度太小 | `MAX_PLAN_RESUMES` 2 → 4(多轮续跑,每轮 20 分钟) | 既有用例改为按常量断言 |
342
+ | 子 Agent 被派不可能任务 | 规划器提示词新增:禁止把「调用 dsh_workplan_dispatch / 重启 dsh web / 安装升级插件」写进子任务;单个子任务应 ≤10 分钟 | 用例 4 |
343
+ | 子 Agent 空等 | 子 Agent 提示词新增:没有派发权限、不能重启服务,遇到这类步骤直接说明需要主 Agent 执行 | 用例 5 |
344
+ | 面板文案 | 新增阶段标签「预算用完,可续跑」(warn 色,不显示为「卡住了」) | `src/client.ts` |
345
+
346
+ 测试:`node --test dist-tests/tests/*.test.js` → **59/59 通过**(1.3.1 为 54/54)。
347
+
348
+ ## A.4 尚未完成的验证(必须如实保留)
349
+
350
+ - 1.3.2 仍在磁盘与 `lib/`,**PID 24118 内存里是 1.3.1**,`paused` 语义只能在重启后的真实进程里验证。
351
+ - 验证方法:重启 `dsh web` → 派发一份含长任务的新计划 → 预算到点时卡片应显示「预算用完,可续跑」、`受阻 0`、未完成项为「还没开始」,再派发一次能接着跑完。
352
+ - 回滚:`tar -xzf .backups/dsh-workplan-1.3.1-20261026-184413.tar.gz && npm run build`。
353
+
354
+ ---
355
+
356
+ ## 附录 B:1.3.2 真实进程端到端实证(2026-10-26 19:39–19:59)
357
+
358
+ **环境**:`dsh web` PID 29790,启动 19:31:02;插件目录 `plugins/dsh-workplan`(symlink 到 `~/.dsh/profiles/web/node_modules/`),`lib/host.js` 构建于 19:20:08,早于进程启动 → 运行版本 1.3.2。
359
+
360
+ **派发**:计划 `wp-21b92c99-1405-41d1-b215-0518e9ecf8d0`(4 阶段 8 子任务),`dispatchedAt 1793014750686`,19:59 返回。
361
+
362
+ | 子任务 | 结果 | 用时 | 说明 |
363
+ |---|---|---|---|
364
+ | T1 进程/版本核查 | done | 96.4s | 独立确认 29790 加载 1.3.2,且唯一副本、无残留旧进程 |
365
+ | T2 产物三处改动核对 | done | 357.1s | 3/3 命中;并指出 paused 回放存在缺口(见 G1) |
366
+ | T3 设计验证计划 | done | 715.4s | 给出 3 任务串联的计时方案与预期矩阵 |
367
+ | T7 复跑测试 | done | 107.1s | 59/59 通过,两轮一致,产物与源码逐字节一致 |
368
+ | T4/T5/T6/T8 | pending | — | `本轮预算用尽,等待续跑` |
369
+
370
+ **统计**:`{total:8, done:4, blocked:0, pending:4, progress:63}`,阶段 `paused`,工具输出「本轮预算用尽,可续跑」。
371
+
372
+ **结论**:1.2.1 下必然出现的「0/N 做好了 · N 卡住了」级联受阻(22 次实测、11 次零完成)在本轮**没有复现**——20 分钟预算到点时,正在跑的子任务与下游全部保持 pending,受阻数 0。**核心缺陷(固定 300 秒判死 + 预算到点级联受阻)已在真实进程得到修复证据。**
373
+
374
+ **本轮暴露的收尾缺陷(1.3.3 修复)**:
375
+ - G1 暂停计划被判定为不可续跑:`resumeAvailable: false`,卡片提示「续跑额度已用尽」,与“再派发即继续”的事实相反(`canResumePlan` 只认 `blocked`)。
376
+ - G2 结果载荷缺 `phase`:刷新后暂停被回放成 `executing`(T2 独立指出)。
377
+ - G3 `errors` 仍残留 `"T4: 总执行超时"` 等行,模型会误读为失败。
378
+
379
+ **尚未验证**:1.3.3 的上述三处在真实进程中的表现(需重启加载后复跑);`resumeAvailable` 修正后的面板文案与刷新回放; 多轮续跑直至完成的端到端链路。
380
+
381
+ ## 附录 C:1.3.3 真实进程实证与 1.3.4 修复(2026-10-26 20:29)
382
+
383
+ **环境**:PID 96748 启动 20:05:37,`lib/host.js` 构建 20:01:51、`version: '1.3.3'`,端口 3080 独占;DSH 0.2.1-rc.3。
384
+
385
+ **派发**:计划 `wp-1fdf7130`(11 子任务),20:09:23 派发,20:29 返回。
386
+
387
+ | 指标 | 1.3.1(9 子任务) | 1.3.2(8 子任务) | 1.3.3(11 子任务) |
388
+ |---|---|---|---|
389
+ | 完成 | 2 | 4 | **9** |
390
+ | 受阻 | 7 | 0 | **0** |
391
+ | 待续 | 0 | 4 | 2 |
392
+ | 级联「上游受阻」 | 6 | 0 | **0** |
393
+ | 载荷 phase | 缺失 | 缺失 | `"paused"` |
394
+ | resumeAvailable | false | false | **true** |
395
+ | errors 残留超时行 | 有 | 有 | **无** |
396
+
397
+ 工具输出:「本轮预算用尽,可续跑(完成 9/11,受阻 0)」,结果消息第 4 行为「本轮执行预算用尽,剩余 2 项未完成(不是失败、未计入续跑额度):再次调用 dsh_workplan_dispatch 即可从剩下的步骤继续,已完成的不重跑。」
398
+
399
+ **同轮子任务查出的新缺陷(1.3.4 已修,见 CHANGELOG)**:
400
+ - 重启后 `dispatchTool` 无内存记录直接 `NO_PLAN`,计划永久不可续跑(T6 提出,已用源码复核确认:`runtime.ts:1225` 当时直接抛错)。
401
+ - 新计划继承上一份计划的 `paused` 回放(T8 的 F 行,已用单测复现并修复)。
402
+ - 调用点无测试覆盖(T5 的 B2 变异存活;已抽 `buildRoundResult` 并补用例,变异现被杀)。
403
+
404
+ **尚未验证**:1.3.4 在真实进程中的表现(需再次重启);暂停后**跨进程**续跑(重建记录 → 继续剩余 2 项)的端到端链路;多轮续跑直至全部完成。
405
+
406
+ ## 附录 D:1.3.4 真实进程核验与证据分级(2026-10-26 21:14)
407
+
408
+ **环境**:PID 7752 启动 20:48:23;`lib/*.js`、`client.js`、`dist/*` 均构建于 20:32:07(早于启动 16 分 16 秒);四处版本串 1.3.4;profile 软链只指向本仓库这一份。
409
+
410
+ **本轮派发**:计划 `wp-8bc5c900`(11 子任务),20:54:18 派发,21:14:18 返回 → `phase: "paused"`、`done 9 / blocked 0 / pending 2`、`resumeAvailable: true`、`errors` 仅一条预算说明。**1.3.3/1.3.4 的暂停语义与载荷字段在 1.3.4 真实进程再次成立。**
411
+
412
+ ### 证据分级(本轮全部断言)
413
+
414
+ | 断言 | 等级 | 证据 |
415
+ |---|---|---|
416
+ | 进程 7752 加载 1.3.4 | 真实进程(强间接) | 构建 20:32:07 早于启动 20:48:23;端口 3080 唯一监听者 7752;唯一插件副本;`meta.version=1.3.4`。**未取得进程自报版本**(HTTP API 返回 unauthorized) |
417
+ | 预算到点 = 暂停而非失败 | 真实进程 | 本轮载荷 `phase=paused`、`blocked=0`、`errors` 无 `/总执行超时/` |
418
+ | `resumeAvailable` 对暂停为 true | 真实进程 | 本轮载荷 `resumeAvailable: true`、`resumeCount: 0` |
419
+ | 修复点 2:新计划不继承暂停 | 真实事件流重放(运行时) | 重放 20:54:18 边界 → `pending`;删掉重置三行的对照产物 → 退回 `paused`(对照组复现旧症状) |
420
+ | 修复点 1:重启后重建计划 | **仅代码 + 单测(真实进程未触发)** | 本轮计划建于重启之后(20:54:05 > 进程 20:48:23),内存本就热,重建分支未进入 |
421
+ | 结果消息经调用点携带 `phase` | 单测(本轮补强) | 新增端到端断言后,调用点变异实测 64 pass / 1 fail;变异前该变异 65/65 存活 |
422
+
423
+ ### 本轮新增的两处事实性问题(不修功能,只记录)
424
+
425
+ 1. 快照文件名 `…-2042.tar.gz` 与文件系统时间 20:32:15 不一致(内容与磁盘树逐字节相同)。
426
+ 2. `stats.progress` 是各子任务 `progress` 的均值,不是完成率:本轮 `done 9/11` 而 `progress 91`(因 T7 已 pending 但 progress=100)。验收断言不得用 `done/total` 对照 `progress`。
427
+
428
+ **下一步(单一动作)**:重启一次 → 对暂停中的 `wp-8bc5c900` 发起派发。这一次的派发对象在重启前就已存在,重建分支必然进入:既能验证修复点 1,又能跑完 T10/T11 收尾。
429
+
430
+ ## 附录 E:1.3.6——重启后旧计划不可达(2026-10-26 21:30)
431
+
432
+ **触发路径**:计划 A 暂停 → 重启 dsh web → 下一回合自动生成计划 B → 派发 A。
433
+
434
+ | 环节 | 1.3.5 及以前 | 1.3.6 |
435
+ |---|---|---|
436
+ | `reconstructFromSession` 回放范围 | 只有最新计划 B | 每条计划一份快照,可按 `planId` 选 |
437
+ | 派发 A 的结果 | 重建得到 B → `PLAN_ID_MISMATCH` | 重建得到 A → 只跑 A 的待续项 |
438
+ | 未完成工作的可达性 | 磁盘上有、入口没有 | 可派发、可续跑 |
439
+
440
+ **证据等级**:代码 + 单测(66/66,含新增用例);真实进程验证待下一次重启后派发旧计划时取得。
441
+
442
+ ## 附录 F:1.3.7——重启后「内存里已有别的计划」这一半(2026-10-26 21:30)
443
+
444
+ 真机按附录 E 的方案执行,直接得到失败载荷:
445
+
446
+ ```
447
+ Error: planId 与当前计划不匹配
448
+ ```
449
+
450
+ 此时进程 PID 25247(启动 21:22:38)加载的是 1.3.6(构建 21:21:01)。
451
+
452
+ | 事件 | seq/时间 | 事实 |
453
+ |---|---|---|
454
+ | 旧计划暂停 | 20:29:26(wp-1fdf…)/ 21:14:18(wp-8bc5c900) | 9 完成 / 2 未完成 |
455
+ | 重启 | 21:22:38 | 新 PID 25247 |
456
+ | 本回合新计划 | 21:24:15(wp-0fd49b2d) | 规划器自动生成,`pending` |
457
+ | 派发旧计划 | 21:24:2x | `planId 与当前计划不匹配` |
458
+
459
+ **根因**:1.3.6 的重建条件是「内存里没有记录」。但规划器在重启后的第一个回合就写入了新计划,内存空窗只存在于「启动后、首次规划前」这几十秒,用户实际请求永远落在这个窗口之外。因此 1.3.6 的修复在真实路径上等于没生效——这一条只能靠真机撞出来,单测构造不出「内存里是另一份计划」的时序。
460
+
461
+ **修复**:重建条件改为「无记录」或「点名了另一份计划」,且该计划有派发在跑时不重建。真实存档重放(2677 条事件)结果:最新计划 `wp-0fd49b2d` / `pending`;点名 `wp-8bc5c900` → `paused`、9 完成、未完成 `T10,T11`;点名不存在的 planId → `null`。
462
+
463
+ **证据等级**:真实进程(失败载荷)+ 真实存档重放 + 单测 67/67。成功派发的真实载荷仍待下一次重启。
464
+
465
+ ---
466
+
467
+ ## 附录 G:1.3.4 版本记录与证据一致性校对(T10,2026-10-26 21:38)
468
+
469
+ > **只追加、不改写**:本节不改动正文与附录 A–F 的任何历史结论,只做三件事:① 指出「表述强于证据」的位置并给出建议措辞;② 把本轮新取得的 1.3.4 真实载荷补入并标注等级;③ 记录剩余风险与下一步。所有「建议改写」都是**若发布勘误时可采用的说法**,不是对历史文本的修改。
470
+
471
+ ### G.0 校对范围、对照物与证据等级
472
+
473
+ **被校对文本**
474
+
475
+ - `plugins/dsh-workplan/CHANGELOG.md:29-37`(1.3.4 段;与 1.3.4 快照内原文逐字相同,未被追溯改写)
476
+ - 本文件附录 C(`:381-404`)与附录 D(`:406-428`);E(`:430-440`)、F(`:442-463`)作旁证
477
+
478
+ **对照物(均可复查)**
479
+
480
+ - 插件快照:`plugins/.backups/dsh-workplan-1.3.3-20261026-200155.tar.gz`、`…-1.3.4-20261026-2042.tar.gz`、`…-1.3.5-20261026-211526.tar.gz`
481
+ - 1.3.4 快照逐文件 diff:`src/runtime.ts` 三处、`src/host.ts` 与 `package*.json` 仅版本号、`tests/workplan-budget-pause.test.ts` +3 例、`lib/*.js` 为编译产物、`CHANGELOG.md` +1 段;`client.js` 无改动
482
+ - 1.3.4/1.3.5 快照重编译与变异实验(本轮实测,线上树未改动)
483
+ - 真实会话存档:`~/.dsh/sessions/--Users-open-Documents-Stocks--/session-5838a977-…/session.v4.jsonl.zstd`(本轮解压副本 2724 行;关键事件 seq 2229 / 2459 / 2460 / 2654 / 2721)
484
+
485
+ **证据等级(本文统一口径,取代 D 表中混用的等级名)**
486
+
487
+ | 等级 | 含义 |
488
+ |---|---|
489
+ | **E1 真实进程真实载荷** | 被测进程在真实运行中写下、可按 seq 复查的落盘载荷 |
490
+ | **E2 真实进程加载推断** | 由构建时间、启动时间、加载路径、版本串推断;未取得进程自报版本 |
491
+ | **E3 真实存档重放** | 用真实事件流喂给真实或对照产物得到的运行时结果 |
492
+ | **E4 仅单测/快照复跑** | 单元测试、快照重编译、变异实验;不触及真实进程 |
493
+ | **E5 未验证** | 只有代码或推断,没有运行时证据 |
494
+
495
+ ### G.1 总判定:改动清单一致,「验证程度」不一致
496
+
497
+ 1. **「改了什么」完全一致(E4)**:三条 bullet 与实际 diff 一一对应——① 抽出 `buildRoundResult(record, sessionId, limits)`(1.3.4 `src/runtime.ts:653-666`,调用点 `:1364`,删除原内联构造);② 新计划分支重置三行(`:946-948`:`resultPhase = ''` / `resultSeen = false` / `resumeCount = 0`);③ 派发前重建(`:1266-1269`,`:1273` 才抛 `NO_PLAN`)。无虚构改动,也无漏记改动。
498
+ 2. **数字一致(E4)**:1.3.4 快照重编译后 `node --test dist-tests/tests/*.test.js` → **tests 65 / pass 65 / fail 0**,与「新增 3 例(62+3)、全量 65/65」一致。
499
+ 3. **「验证到什么程度」不一致**:bullet 3 的「接线」缺口在 1.3.4 并未关闭(调用点变异 65/65 存活,E4);bullet 1 的修复在 1.3.4 真实进程从未触发(E5);1.3.6 的真机载荷(seq 2654,E1)进一步证明「只重建最新计划」不足。附录 D 的「下一步」预测因此只对了一半。
500
+
501
+ ### G.2 「表述强于证据」清单(G-1…G-11)
502
+
503
+ **G-1|`CHANGELOG.md:35`(1.3.4 bullet 3)— 接线缺口被写成已关闭**
504
+
505
+ - 原文:「结果写入处的接线没有测试……现在结果消息构造抽成导出的 `buildRoundResult(record, sessionId, limits)`,并新增用例;同一变异现在会让测试变红(已实测)。」
506
+ - 差距:抽取后**函数本体**变异确实被杀(1.3.4 快照:64 pass / 1 fail,E4);但把**调用点**改成 `buildRoundResult({ ...record, phase: undefined }, …)` 仍 **65/65 全绿**(E4)。「没有任何用例覆盖调用点」这一前提在 1.3.4 依旧成立;1.3.5(`CHANGELOG.md:18-24`)才补上从 session 取 `workplan-result` 的端到端断言。
507
+ - 建议改写:「1.3.4 把结果构造抽成可测函数,函数本体变异可被杀;**调用点接线仍无覆盖**;1.3.5 补端到端断言后,调用点变异才变红(64/1)。」
508
+
509
+ **G-2|`CHANGELOG.md:33`(1.3.4 bullet 1)—「重启后可派发」的边界未标注**
510
+
511
+ - 原文:「暂停后重启 `dsh web`,计划再也派发不了……现在派发前会 `reconstructFromSession` 从会话存档重建记录并登记回内存。」
512
+ - 差距:代码属实(E4)。但 ① 1.3.4 真实进程从未进入该分支(T7:计划创建 20:54:05 晚于进程启动 20:48:23,内存热;E5);② 1.3.6 真机在「重启后已生成新计划」时派发旧计划,返回 `Error: planId 与当前计划不匹配`(seq 2654,E1)——重建只取最新计划,旧计划仍不可达。该修复只覆盖「重启后、首次规划前」的几十秒空窗。
513
+ - 建议改写:「现在派发前会在**内存无记录**时从存档重建最新计划并登记回内存;修复只覆盖重启后的空窗——重启后已生成新计划时,旧计划仍不可派发(1.3.6/1.3.7 继续修,真实失败载荷 seq 2654)。」
514
+
515
+ **G-3|附录 C:402 — 与 G-1 同一处过强表述**
516
+
517
+ - 原文:「调用点无测试覆盖(T5 的 B2 变异存活;已抽 `buildRoundResult` 并补用例,变异现被杀)。」
518
+ - 差距:函数本体可杀,调用点变异 65/65 存活(E4)。
519
+ - 建议改写:「……已抽 `buildRoundResult` 并补用例,函数本体变异可杀;**调用点接线仍无覆盖**,1.3.5 补端到端断言。」
520
+
521
+ **G-4|附录 C:400 — 行号错 10 行**
522
+
523
+ - 原文:「已用源码复核确认:`runtime.ts:1225` 当时直接抛错」。
524
+ - 差距:1.3.3 快照中 `NO_PLAN` 抛错在 `src/runtime.ts:1215`(`:1225` 是注释行);1.3.4 对应 `:1273`。
525
+ - 建议改写:「`runtime.ts:1215`(1.3.3 快照;1.3.4 为 `:1273`)」。
526
+
527
+ **G-5|附录 D:410 与 F:454 — 返回时刻与预算起算点**
528
+
529
+ - 原文:「20:54:18 派发,21:14:18 返回」;F 中「21:14:18(wp-8bc5c900)」。
530
+ - 差距:工具调用 seq 2448 在 20:54:18.693;但 `record.dispatchedAt = 1793019260523`(**20:54:20.5**),20 分钟预算到 21:14:20.5;载荷实际落盘 **21:14:20**(seq 2459,tool/result seq 2460 同刻)。「21:14:18」是工具调用时刻 + 20 分钟,不是落盘时刻。
531
+ - 建议改写:「20:54:18 发起派发(预算自 20:54:20 起算),21:14:20 结果落盘(seq 2459/2460)」。
532
+
533
+ **G-6|附录 D:416 — 等级名不统一**
534
+
535
+ - 原文:进程 7752 加载 1.3.4 =「真实进程(强间接)」。
536
+ - 差距:与同表「真实进程」并列却不加区分;当日未取得进程自报版本(HTTP 401)。
537
+ - 建议改写:「E2 加载推断(构建 20:32:07 < 启动 20:48:23;端口与插件副本唯一;未取得自报版本)」。
538
+
539
+ **G-7|附录 D:428 — 预测未标注执行结果**
540
+
541
+ - 原文:「重启一次 → 对暂停中的 `wp-8bc5c900` 发起派发……重建分支必然进入:既能验证修复点 1,又能跑完 T10/T11 收尾。」
542
+ - 差距:动作已执行。1.3.6(PID 25247,21:22:38 启动)于 21:24:23 派发旧计划,21:24:26 返回 `Error: planId 与当前计划不匹配`(seq 2654,E1),T10/T11 未跑。1.3.7(PID 25685,21:27:31 启动)于 21:29:12 再次派发(seq 2721),截至本节写作未落盘(E5)。「必然进入」对,「必然成功」错。
543
+ - 建议改写:在该段末尾补「执行结果:1.3.6 进入重建但取回新计划 → `PLAN_ID_MISMATCH`(seq 2654);1.3.7 按 `planId` 重建后 21:29:12 再派发,结果待落盘」。
544
+
545
+ **G-8|附录 D:421 — 版本归属提前**
546
+
547
+ - 原文(表格行「结果消息经调用点携带 `phase`」):「单测(本轮补强)」+「新增端到端断言后,调用点变异实测 64 pass / 1 fail;变异前该变异 65/65 存活」。
548
+ - 差距:该端到端断言属于 **1.3.5**(`CHANGELOG.md:18-27`,21:15:26 备份发布),晚于 D 标题的 21:14,也晚于 1.3.4 轮次。写「本轮补强」会让人以为 1.3.4 已覆盖调用点。
549
+ - 建议改写:「1.3.5 补强(E4):调用点变异 64/1;1.3.4 同变异 65/65 存活」。
550
+
551
+ **G-9|附录 E:430-440 — 时间标注与「待验证」**
552
+
553
+ - 原文:标题「2026-10-26 21:30」;末尾「真实进程验证待下一次重启后派发旧计划时取得」。
554
+ - 差距:文件落盘 mtime 21:25:25,E 内引用的最晚事件是 21:24:26;「待下一次」已被同轮附录 F 的真实失败载荷(seq 2654)回答。
555
+ - 建议改写:时间按事件时间(21:22–21:24)标注;E 末尾改为「已在 F 记录(真实失败载荷 seq 2654)」。
556
+
557
+ **G-10|本文件 :1 与 :4 — 版本沿革停在 1.3.4**
558
+
559
+ - 原文:标题「……与 1.3.4 修复」;「修复版本:1.3.0 → 1.3.1 → 1.3.2 → 1.3.3 → 1.3.4」。
560
+ - 差距:1.3.5(21:15:26)/ 1.3.6(21:21:01 构建)/ 1.3.7(21:25:31 构建)已发布;正文 §1–§8 仍是 1.3.0 期记录(§6.1 的 51/51 属 1.3.0)。历史记录不改写,但读者会误以为全文在讲 1.3.4。
561
+ - 建议改写(仅加一行):「沿革续:1.3.5 → 1.3.6 → 1.3.7(`CHANGELOG.md:1-27`;附录 E/F/G);正文 §1–§8 为 1.3.0 期记录。」
562
+
563
+ **G-11|跨报告(不在本文件)— T6 的「1.3.4 载荷为零」已失效**
564
+
565
+ - 原文(T6 汇报,写于 21:07–21:12):「本轮 1.3.4 的载荷……现在还不存在」「载荷证据为零」。
566
+ - 差距:21:14:20,seq 2459 已落盘(E1,见 G.3)。该结论只在写作时刻成立。
567
+ - 建议:最终汇总引用为「截至 21:12 未落盘;21:14:20 落盘后已取得(附录 G.3)」。
568
+
569
+ ### G.3 1.3.4 真实载荷逐字段核对(seq 2459,E1)
570
+
571
+ 事件:`user/message`,`source.kind = workplan-result`,落盘 21:14:20;载荷 JSON 位于 `<!-- DSH-WORKPLAN-RESULT:BEGIN -->` 与 `END` 之间;同一 `planId` 的 durable 结果消息计数 = **1**。
572
+
573
+ | 字段 | 原文值 | 核对 | 说明 |
574
+ |---|---|---|---|
575
+ | `planId` | `wp-8bc5c900-8b3d-40c6-8121-4903e6f644fe` | ✅ 与 seq 2448 派发参数逐字相同 | — |
576
+ | `statuses` | 11 项;T1–T9 `done/100`,T10 `pending/100`,T11 `pending/0` | ✅ | T10 于 21:13:05 启动后被预算切断;T11 从未开始 |
577
+ | `stats` | `total 11 / done 9 / blocked 0 / inProgress 0 / pending 2 / progress 91` | ✅ | 91 是 progress 均值(90.91 四舍五入),不是完成率 81.8% |
578
+ | `phase` | `"paused"` | ✅ | 与「预算到点=暂停」一致 |
579
+ | `resumeCount` | `0` | ✅ | 本轮未消耗续跑额度 |
580
+ | `resumeAvailable` | `true` | ✅ | 暂停态可续跑 |
581
+ | `errors` | 1 条,无 `/总执行超时/` | ✅ | 原文:「本轮执行预算(20 分钟)已到:已完成 9/11,其余 2 项保留为未完成,再次派发本计划即可续跑(已完成的不重跑)」 |
582
+ | 结果消息条数 | 该 `planId` 恰好 1 条 | ✅ | 无重复写入 |
583
+
584
+ **边界(重要)**:这些字段在 1.3.3 的 seq 2229 上同样成立。因此 seq 2459 只能证明「**1.3.4 运行期的暂停语义与载荷字段成立**」(E1),**不能**单独证明 1.3.4 的三处新修复——修复点 1 本轮未触发(E5)、修复点 2 靠重放(E3)、修复点 3 靠单测(E4)。
585
+
586
+ ### G.4 三处修复的证据等级(1.3.4)
587
+
588
+ | 修复点 | 代码位置(1.3.4) | 现有证据 | 等级 | 缺口 |
589
+ |---|---|---|---|---|
590
+ | 1 重启后重建 | `src/runtime.ts:1266-1269`(抛错 `:1273`) | 单测「重启后派发自动重建」+ 65/65(E4);真实进程未进入(E5) | **E4;真实进程 E5** | 需「先建计划 → 重启 → 派发旧计划」的真实成功载荷;1.3.6 已证明只重建最新计划不够(seq 2654,E1) |
591
+ | 2 新计划不继承暂停 | `:946-948` | T8:真实事件流 + 1.3.4 实际产物重放 → `pending`;删除三行的对照产物 → `paused`(E3);单测(E4) | **E3** | 在线进程内存状态未观测(API 401);但对照组精确复现旧症状,归因充分 |
592
+ | 3 结果构造可测 | `:653-666`,调用点 `:1364` | 函数本体变异被杀(64/1);调用点变异存活(65/65);1.3.5 补断言后调用点变异被杀(64/1)——均 E4 | **函数 E4;接线(1.3.4)E5** | 1.3.4 的「接线」问题未关闭,1.3.5 关闭 |
593
+
594
+ **本轮变异实验原始结果(E4,全部在 /tmp 快照内执行)**
595
+
596
+ | 实验 | 对象 | 结果 |
597
+ |---|---|---|
598
+ | 基线 | 1.3.4 未改动 | tests 65 / pass 65 / fail 0 |
599
+ | 变异 A(函数本体 `phase: record.phase` → `undefined`) | 1.3.4 | 64 pass / 1 fail(被杀) |
600
+ | 变异 B(调用点传 `{ ...record, phase: undefined }`) | 1.3.4 | **65/65 全绿(存活)** |
601
+ | 变异 B(同一调用点) | 1.3.5 | 64 pass / 1 fail(被杀) |
602
+ | 变异 B2(1.3.3 载荷构造 `phase` → `undefined`) | 1.3.3 | **62/62 全绿(复现 CHANGELOG 前提)** |
603
+
604
+ ### G.5 版本沿革补记(不修改标题)
605
+
606
+ - 2026-10-26:1.3.3(备份 20:01:55)→ 1.3.4(构建 20:32:07;PID 7752 于 20:48:23 启动,约 21:22 被替换)→ 1.3.5(备份 21:15:26)→ 1.3.6(构建 21:21:01;PID 25247 于 21:22:38 启动)→ 1.3.7(构建 21:25:31;PID 25685 于 21:27:31 启动,端口 3080)。
607
+ - CHANGELOG 自述测试数:1.3.4 65/65、1.3.5 65/65、1.3.6 66/66、1.3.7 67/67。本轮只复跑了 1.3.3(62)、1.3.4(65)、1.3.5(65);**66/67 未复跑(E5)**。
608
+ - 1.3.4 真实进程已退出,任何 1.3.4 在线复测都不可能再进行;1.3.4 的结论只能建立在存档与快照上。
609
+
610
+ ### G.6 剩余风险与下一步(给主 Agent)
611
+
612
+ 1. **1.3.7 的真实派发(seq 2721,21:29:12)结果未落盘**:若成功,它将是第一份「重启后点名旧计划并成功续跑」的 E1 载荷;请在结果落盘后补记 seq、`phase`、`done/pending`、`errors`,并核对 T10/T11 是否收尾。
613
+ 2. **1.3.4 从未在真实进程验证「暂停 → 重启 → 续跑」**:文档与最终答复不得写「1.3.4 已端到端验证」;其修复点 1 的等级是 E5。
614
+ 3. **不要沿用 T6 的「1.3.4 载荷为零」**:21:14:20 的 seq 2459 已推翻(G-11)。
615
+ 4. **不要追溯改写 CHANGELOG 1.3.4 与附录 D**:历史记录保留;如需对外,按 G.2 的措辞在下一版说明或勘误中引用。
616
+ 5. **记录卫生**:附录 E/F 标注的 21:30 与文件落盘 21:25:25 不符;后续附录建议一律引用事件 seq 与事件时间,而不是写作时刻。
617
+
618
+ ### G.7 复跑方法(任何人可重做上述 E4)
619
+
620
+ ```bash
621
+ # 1) 解出 1.3.4 快照并链接依赖(只读复用线上 node_modules)
622
+ mkdir -p /tmp/g134 && tar xzf plugins/.backups/dsh-workplan-1.3.4-20261026-2042.tar.gz -C /tmp/g134
623
+ cd /tmp/g134/dsh-workplan && ln -s <repo>/node_modules node_modules
624
+ # 2) 构建并跑全量测试(期望 tests 65 / pass 65 / fail 0)
625
+ ./node_modules/.bin/tsc -p tsconfig.test.json && node --test dist-tests/tests/*.test.js
626
+ # 3) 变异 A:src/runtime.ts:663 的 `phase: record.phase` 改为 `phase: undefined` → 期望 64/1
627
+ # 4) 变异 B:src/runtime.ts:1364 改为 buildRoundResult({ ...record, phase: undefined }, …)
628
+ # 1.3.4 期望 65/65(存活);1.3.5 快照期望 64/1(该版本已补端到端断言)
629
+ ```
630
+
631
+ (附录 G 由 T10 子任务写入;写入前备份:`plugins/.backups/stuck-review-1.3.0-pre-T10-20261026-213702.md`。本节数字均来自本条列出的快照、存档 seq 与复跑命令。)
632
+
633
+ ## 附录 H:1.3.7 真机收口——重启后按名字续跑旧计划(2026-10-26 21:44)
634
+
635
+ | 时间 | 事件 | 证据 |
636
+ |---|---|---|
637
+ | 21:25:31 | 1.3.7 构建落盘 | `lib/host.js:272` `version: '1.3.7'`,`lib/runtime.js` 含 `needsRebuild` |
638
+ | 21:27:31 | 宿主重启,PID **25685** | 构建早于启动 2 分钟;3080 仅 25685 |
639
+ | 21:29:05 | 本回合规划器新建计划 `wp-468ffb03`,写入内存 | 内存里此刻是**另一份**计划 |
640
+ | 21:29:12 | 派发旧计划 `wp-8bc5c900`(重启前暂停的那份) | `needsRebuild` 命中:内存有记录但 planId 不同 → 按 planId 从会话存档重建 |
641
+ | 21:29:16 | T10 启动;21:39:24 T11 启动 | 只跑未完成的两项,已完成的 9 项未重跑 |
642
+ | 21:43:52 | 结果落盘 seq **2724**:`done 11 / blocked 0 / pending 0 / phase integrating` | 与 seq 2459(21:14:20,9/11 paused)对照,同一条计划 |
643
+
644
+ **这是「重启后旧计划是否可续跑」第一次取得真实进程的完整闭环证据**:进程加载 1.3.7 → 内存里已有另一份新计划 → 点名旧计划 → 按 planId 重建 → 只补跑缺的两项 → 11/11 完成。1.3.6 在同一条路径上返回过 `Error: planId 与当前计划不匹配`(seq 2654,21:24:26),两版对照即为承重性证据。
645
+
646
+ **证据等级**:E1(真实进程真实载荷)。至此「重启后继续未完成计划」不再有待验证项。