dsh-workplan 1.8.4 → 1.9.1
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.
- package/CHANGELOG.md +686 -0
- package/README.en.md +1 -1
- package/README.md +1 -1
- package/client.js +18 -2
- package/docs/postmortem-1.8.4-20261030.md +51 -0
- package/docs/postmortem-1.8.7-20261031.md +498 -0
- package/docs/release-notes-1.9.1.md +67 -0
- package/docs/release-record-1.8.4-20261030.md +70 -0
- package/lib/host.js +345 -31
- package/lib/plan.js +494 -17
- package/lib/runtime.js +1819 -124
- package/lib/supersede-digest.js +115 -0
- package/lib/supersede.js +378 -0
- package/package.json +2 -2
- package/src/client.ts +19 -2
- package/src/host.ts +370 -33
- package/src/plan.ts +537 -17
- package/src/runtime.ts +1813 -114
- package/src/supersede-digest.ts +116 -0
- package/src/supersede.ts +429 -0
package/README.en.md
CHANGED
|
@@ -77,7 +77,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
|
|
|
77
77
|
## Install
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
dsh plugin --profile web add dsh-workplan@1.
|
|
80
|
+
dsh plugin --profile web add dsh-workplan@1.9.1
|
|
81
81
|
```
|
|
82
82
|
|
|
83
83
|
Restart the DSH Web process (or reload the page) so the bundle is picked up.
|
package/README.md
CHANGED
package/client.js
CHANGED
|
@@ -44,6 +44,8 @@ window.__ModuleLoader__.load({
|
|
|
44
44
|
"helpTitle": "先看这三句",
|
|
45
45
|
"helpWhat": "这件事",
|
|
46
46
|
"helpWho": "现在谁在做",
|
|
47
|
+
/* [1.8.5] 「已结束」的计划下面不许再写「现在谁在做」。 */
|
|
48
|
+
"helpWhere": "停在哪一步",
|
|
47
49
|
"helpNext": "接下来做什么",
|
|
48
50
|
"helpNobody": "还没开始",
|
|
49
51
|
"helpDone": "都做完了",
|
|
@@ -73,6 +75,7 @@ window.__ModuleLoader__.load({
|
|
|
73
75
|
"paused": "预算用完,可续跑",
|
|
74
76
|
"degraded": "安排失败",
|
|
75
77
|
"cancelled": "已取消",
|
|
78
|
+
"superseded": "已由他计划承接",
|
|
76
79
|
"ended": "已结束,可续跑"
|
|
77
80
|
},
|
|
78
81
|
"status": {
|
|
@@ -215,6 +218,7 @@ window.__ModuleLoader__.load({
|
|
|
215
218
|
"helpTitle": "Start with these three",
|
|
216
219
|
"helpWhat": "This task",
|
|
217
220
|
"helpWho": "Who is doing it now",
|
|
221
|
+
"helpWhere": "Where it stopped",
|
|
218
222
|
"helpNext": "What happens next",
|
|
219
223
|
"helpNobody": "Not started yet",
|
|
220
224
|
"helpDone": "Everything is done",
|
|
@@ -1122,6 +1126,18 @@ window.__ModuleLoader__.load({
|
|
|
1122
1126
|
return t('helpDone');
|
|
1123
1127
|
return t('helpNobody');
|
|
1124
1128
|
}
|
|
1129
|
+
/*
|
|
1130
|
+
* [1.8.5] 「谁在做」这三个字只能用在真的有东西在跑的时候。
|
|
1131
|
+
*
|
|
1132
|
+
* 事故(2026-10-30 21:38):计划已经「已结束,可续跑 · 卡住了」,卡片却仍写着
|
|
1133
|
+
* 「现在谁在做:研究分析 · 人性自私与利益博弈推演(卡住了)」,用户据此认为
|
|
1134
|
+
* 子智能体还在跑、报告和状态互相矛盾。同一句话在「没人跑」时应改口径为
|
|
1135
|
+
* 「停在哪一步」,把「现在进行时」换成「过去时」,不留误读空间。
|
|
1136
|
+
*/
|
|
1137
|
+
function workerLabel(session, t) {
|
|
1138
|
+
const active = findEntry(session, 'in_progress');
|
|
1139
|
+
return active ? t('helpWho') : t('helpWhere');
|
|
1140
|
+
}
|
|
1125
1141
|
/*
|
|
1126
1142
|
* A blocked card used to read "卡住了" and stop there: no hint that the plan
|
|
1127
1143
|
* is recoverable, so the only visible option was to restate the request and
|
|
@@ -1197,7 +1213,7 @@ window.__ModuleLoader__.load({
|
|
|
1197
1213
|
function Guide({ session, t }) {
|
|
1198
1214
|
const task = session.taskUnderstanding || {};
|
|
1199
1215
|
const what = task.deliverable || session.title || t('panel');
|
|
1200
|
-
return h('section', { className: 'dsh-wp-guide', 'aria-label': t('helpTitle') }, h('div', { className: 'dsh-wp-guide-title' }, t('helpTitle')), h('div', { className: 'dsh-wp-guide-body' }, h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpWhat')), h('div', { className: 'dsh-wp-guide-value' }, what)), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t
|
|
1216
|
+
return h('section', { className: 'dsh-wp-guide', 'aria-label': t('helpTitle') }, h('div', { className: 'dsh-wp-guide-title' }, t('helpTitle')), h('div', { className: 'dsh-wp-guide-body' }, h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpWhat')), h('div', { className: 'dsh-wp-guide-value' }, what)), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, workerLabel(session, t)), h('div', { className: 'dsh-wp-guide-value' }, workerText(session, t))), h('div', { className: 'dsh-wp-guide-row' }, h('div', { className: 'dsh-wp-guide-label' }, t('helpNext')), h('div', { className: 'dsh-wp-guide-value' }, nextText(session, t)))), h('div', { className: 'dsh-wp-guide-hint' }, t('helpHint')));
|
|
1201
1217
|
}
|
|
1202
1218
|
function Pill({ children, tone = 'idle' }) {
|
|
1203
1219
|
return h('span', { className: `dsh-wp-pill dsh-wp-tone-${tone}` }, h('span', { className: 'dsh-wp-dot' }), children);
|
|
@@ -2384,7 +2400,7 @@ window.__ModuleLoader__.load({
|
|
|
2384
2400
|
const stats = session.stats || {};
|
|
2385
2401
|
const phase = sessionPhaseOf(session);
|
|
2386
2402
|
const tone = phaseTone(phase);
|
|
2387
|
-
return h('div', { className: `dsh-wp-turn dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-turn-title' }, h('span', null, session.title || t('panel')), h(Pill, { tone }, phaseLabel(phase, session, t))), h('div', { className: 'dsh-wp-muted', style: { marginTop: '6px' } }, `${t
|
|
2403
|
+
return h('div', { className: `dsh-wp-turn dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-turn-title' }, h('span', null, session.title || t('panel')), h(Pill, { tone }, phaseLabel(phase, session, t))), h('div', { className: 'dsh-wp-muted', style: { marginTop: '6px' } }, `${workerLabel(session, t)}:${workerText(session, t)}`), h('div', { className: 'dsh-wp-muted', style: { marginTop: '2px' } }, `${t('helpNext')}:${nextText(session, t)}`), h('div', { className: 'dsh-wp-progress-meta' }, h('span', null, `${stats.done ?? 0}/${stats.total ?? 0} ${t('stats.done')} · ${stats.blocked ?? 0} ${t('stats.blocked')}`), h('span', { className: 'dsh-wp-muted' }, t('viewHint'))));
|
|
2388
2404
|
}
|
|
2389
2405
|
function contentText(block) {
|
|
2390
2406
|
if (!block || !Array.isArray(block.content))
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# 复盘:「已结束 ∧ 正在做」同屏(2026-10-30,dsh-workplan 1.8.4)
|
|
2
|
+
|
|
3
|
+
## 1. 时间线(全部来自原始事件日志,可复核)
|
|
4
|
+
|
|
5
|
+
| 时刻(本机 +08:00) | 事件 | 证据 |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| 19:52:50 | 事故会话第一个 `turn/start`(seq 5) | `session.v4.jsonl.zstd` |
|
|
8
|
+
| 19:58:39 | turn 1 `turn/end`(seq 254,`reason.kind=completed`) | 同上 |
|
|
9
|
+
| 20:06:33 | 用户截图:卡片已进「已结束」组,60%,第 4 步「正在做」 | 用户截图 |
|
|
10
|
+
| 20:16:37 | turn 2 `turn/start`(seq 261) | 日志 |
|
|
11
|
+
| 20:18:57 | turn 2 `turn/end`(seq 395) | 日志 |
|
|
12
|
+
| 20:22:50 | 计划结果写入(seq 396,`phase=blocked`,11/15,4 blocked) | 日志 |
|
|
13
|
+
|
|
14
|
+
关键事实:**20:06:33 处于两个回合之间,没有任何打开回合,但计划仍在推进**
|
|
15
|
+
(20:06:33 是 9/15、1 正在做;20:22:50 落成 11/15、4 卡住)。所以「已结束」不是文案错,
|
|
16
|
+
而是判定依据错。
|
|
17
|
+
|
|
18
|
+
## 2. 5-Why
|
|
19
|
+
|
|
20
|
+
1. 为什么同一张卡既说「已结束」又说「正在做」?——载荷同时携带 `phase='ended'` 与
|
|
21
|
+
`statuses` 里的 `in_progress`。
|
|
22
|
+
2. 为什么 `phase` 会是 `ended`?——`serialisePlan` 只看最后一个 `turn/start|turn/end`,
|
|
23
|
+
判定「本轮已结束」,就把未完成计划的阶段改写成 `ended`。
|
|
24
|
+
3. 为什么「回合结束」不等于「没东西在跑」?——1.7.0 引入 async 派发(`cb40b7a`),
|
|
25
|
+
派发在宿主回合结束后继续执行,结算可以晚数分钟。
|
|
26
|
+
4. 为什么插件没发现自己在跑?——存活信号 `record.dispatchPromise` 早就存在,且
|
|
27
|
+
`dispatchStatus` 已经用它算 `running`,但 `serialisePlan` 的 ended 改写块没读它,
|
|
28
|
+
载荷也不下发 `running`。**同一个进程里有两套「是否在跑」的判据,展示层拿到的是弱的那套。**
|
|
29
|
+
5. 为什么直到用户截图才发现?——没有任何断言检查「ended 载荷里不许有 in_progress」;
|
|
30
|
+
而 `tests/ended-group.test.ts:193` 反而把「卡住的计划结束后仍然报需处理」固化成期望行为。
|
|
31
|
+
|
|
32
|
+
系统层原因:状态事实有多个宣告者(宿主回合、派发结算、客户端计数派生),但**没有仲裁规则**
|
|
33
|
+
和**出口收敛**;一旦异步派发把两个宣告者的时间拉开,矛盾就必然出现。
|
|
34
|
+
|
|
35
|
+
## 3. 已落地的防复发措施
|
|
36
|
+
|
|
37
|
+
| 措施 | 落点 | 如何验证 |
|
|
38
|
+
|---|---|---|
|
|
39
|
+
| 存活事实优先:有活派发不得进 `ended`,`running` 随载荷下发 | `src/runtime.ts` `serialisePlan` | `tests/ended-live-dispatch.test.ts` 用例 1 |
|
|
40
|
+
| 出口收敛:ending 时残留 `in_progress` 改判 `blocked`(只改下发副本) | `settleStaleInflight` | 用例 3、4、5 |
|
|
41
|
+
| 新不变量 I11:`ended` 且 `inProgress>0` 判红 | `src/plan.ts` `aggregateInvariantViolations` | 用例 6 |
|
|
42
|
+
| 展示层自保:`running===true` 时不得渲染「已结束」 | `src/client.ts` `sessionPhaseOf` | `tests/client-resume-hint.test.ts` |
|
|
43
|
+
| 承诺与操作一致:徽标说「可续跑」,卡片必须给续跑方法 | `resumeHint` | 同上 |
|
|
44
|
+
| 单一百分比口径:分组/环/展开页取同一个计数 | `PlanOverview` | 事故日志离线渲染:只有「总体进度 73%」 |
|
|
45
|
+
|
|
46
|
+
## 4. 仍待观察(未验证,不当结论)
|
|
47
|
+
|
|
48
|
+
- 重启后 `GET /dsh-workplan/plans` 的实机载荷(本机该端点需进程内凭据,未取像素级证据)。
|
|
49
|
+
- `dsh-context` 的 Fleet「任务进度」是第二个同名表面,是否也读 `turn/end` 判存活未审查完。
|
|
50
|
+
- `billion-context` 改写会话消息是否可能丢弃 workplan 标记、`delivery-accepted.throughSeq`
|
|
51
|
+
停在某个序号之后的语义——均未证实。
|
|
@@ -0,0 +1,498 @@
|
|
|
1
|
+
# 复盘:计划没做完就把中间结果当成品交付(2026-10-31,dsh-workplan 1.8.7)
|
|
2
|
+
|
|
3
|
+
## 0. 结论先行
|
|
4
|
+
|
|
5
|
+
用户看到的现象是真的:会话
|
|
6
|
+
`session-99984ebd-7d13-47d5-87a0-e9ba7271b883` 在计划只完成 **10/13** 时
|
|
7
|
+
`present` 了报告并结束回合;第二个回合把进度改成 **11/13** 后再次结束,
|
|
8
|
+
T12、T13 从此再没执行。这不是用户误判,也不是「报告写得好不好」的问题,
|
|
9
|
+
而是**「完成」的判据分散在四处、且没有任何一处能在回合边界上强制生效**:
|
|
10
|
+
|
|
11
|
+
| 谁在宣告「完成」 | 当时的实际行为 | 缺陷 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| 结果消息(`buildResultMessage`) | 第 3 条命令「给出最终答复」,第 4 条又命令「再派发续跑」 | 两条命令互斥,模型照前者收尾 |
|
|
14
|
+
| 工具返回(dispatch render/schema) | `ok:true` +「已加入进行中的派发并等到结果」 | 没有 `complete` 字段,暂停读起来像成功 |
|
|
15
|
+
| 系统提示词(`PROMPT_SECTION`) | 只有「不要声称未经验证的完成」 | 没有「未完成禁止交付」的硬规则 |
|
|
16
|
+
| 回合边界(官方 `agent/turn-stopping`) | 插件**没有订阅**该事件 | 模型随时可以收尾,没有强制点 |
|
|
17
|
+
|
|
18
|
+
## 1. 时间线(全部来自原始事件日志,可复核)
|
|
19
|
+
|
|
20
|
+
证据文件:`~/.dsh/sessions/--Users-open-Documents-Stocks--/`
|
|
21
|
+
`session-99984ebd-7d13-47d5-87a0-e9ba7271b883/session.v4.jsonl.zstd`
|
|
22
|
+
(658,957 字节;解压后 598 个事件)。计划 ID:`wp-66f57fa3-fc71-4f8e-b8dd-b3e67c279467`。
|
|
23
|
+
|
|
24
|
+
| 时刻(本机 +08:00) | 事件 | 证据 |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| 11:41:34 | turn 1 `turn/start`(真实任务回合) | 会话日志 |
|
|
27
|
+
| 11:42:54 | 首个工具调用 `dsh_workplan_dispatch({"mode":"async"})`(seq 25) | 会话日志 |
|
|
28
|
+
| 11:46:44 | 主 Agent 先写出一版报告 `159667_2026年11月走势预判报告.md` | 会话日志 |
|
|
29
|
+
| 11:48:54 | 再调 `dsh_workplan_dispatch({"mode":"wait"})`,阻塞约 14 分钟 | 会话日志 |
|
|
30
|
+
| 11:49:19–12:00:12 | 后台依次创建 T8/T9/T10/T11 四个子 Agent;T11(排版设计)到预算点仍在跑 | `subagent/catalog` 事件 |
|
|
31
|
+
| 12:02:54 | 派发返回:**「本轮预算用尽,可续跑(完成 10/13,受阻 0)|已加入进行中的派发并等到结果」** | `tool/result` 原文 |
|
|
32
|
+
| 12:02:54 | 同一秒注入「【部门执行结果】完成 10/13,受阻 0,请主 Agent 核对并整合」,正文含「3. 给出最终答复」与「4. 再次调用 dsh_workplan_dispatch」 | `user/message`,`source.kind=workplan-result` |
|
|
33
|
+
| 12:03:08–12:03:54 | 模型修正报告日期/权重/表格,未再派发 | 会话日志 |
|
|
34
|
+
| 12:04:22 | `present` 报告(`deliverables/presented`) | 会话日志 |
|
|
35
|
+
| 12:04:25 | turn 1 `turn/end`,`reason.kind=completed`(计划 10/13) | 会话日志 |
|
|
36
|
+
| 12:12:34 | T11 完成通知(`subagent-settled`)触发 turn 2 `turn/start` | 会话日志 |
|
|
37
|
+
| 12:13:10 | 报告 E/G/I 行改为「11/13(T1–T11)」;T12/T13 未跑 | 会话日志 |
|
|
38
|
+
| 12:13:16 | turn 2 `turn/end`,`reason.kind=completed`(计划 11/13) | 会话日志 |
|
|
39
|
+
| 之后 | 没有第三个回合;计划永久停在 11/13 | 事件流结束 |
|
|
40
|
+
|
|
41
|
+
用户在 12:04 之后拿到的是「已 present 的报告 + 收尾性答复」;计划卡片同时显示
|
|
42
|
+
「已结束 · 本轮预算用尽,可续跑」。**聊天里的成品口径与卡片里的未完成口径不一致,
|
|
43
|
+
而用户读的是聊天。**
|
|
44
|
+
|
|
45
|
+
## 2. 5-Why
|
|
46
|
+
|
|
47
|
+
1. **为什么用户在没做完时看到了结果?**
|
|
48
|
+
因为 12:04:22 调用了 `present`、12:04:25 回合以 `completed` 关闭,而计划
|
|
49
|
+
`10/13`;12:13 的第二回合又以 `11/13` 关闭。
|
|
50
|
+
2. **为什么模型会认为可以收尾?**
|
|
51
|
+
模型收到的结果消息第 3 条就是「给出最终答复」;工具返回 `ok:true` 且写着
|
|
52
|
+
「已加入进行中的派发并等到结果」,没有任何字段说明「还剩 3 项」。
|
|
53
|
+
3. **为什么结果消息会自相矛盾?**
|
|
54
|
+
`buildResultMessage` 把「核对证据 / 处理受阻 / 给出最终答复」写死成职责清单,
|
|
55
|
+
未完成分支再追加第 4 条「再次派发」;`buildResultSummary` 也固定写
|
|
56
|
+
「请主 Agent 核对并整合」。**同一份控制消息里同时存在「收尾」和「续跑」两条命令。**
|
|
57
|
+
4. **为什么没有任何机制拦住收尾?**
|
|
58
|
+
插件只订阅 `agent/pre-step`,不订阅回合结束事件;官方提供的
|
|
59
|
+
`agent/turn-stopping`(serial、边界提交前 await、监听器可 `agent.steer()`
|
|
60
|
+
让机器重读 inbox)完全没有被使用。预算暂停只是文案上的「可续跑」。
|
|
61
|
+
5. **为什么没有回归测试发现?**
|
|
62
|
+
1.8.4 只修了「已结束 ∧ 正在做」(I11),`workplan-budget-pause.test.ts`
|
|
63
|
+
只断言暂停后的状态列表,从不断言「未完成时给模型的指令是什么」。
|
|
64
|
+
|
|
65
|
+
系统层原因:**「完成」有四个宣告者(模型叙述、工具返回、状态列表、回合边界),
|
|
66
|
+
但没有任何仲裁规则;唯一有强制力的边界事件没有被订阅。** 只要异步派发把
|
|
67
|
+
「预算到点」和「子任务结算」的时间拉开,这个缺口就必然被踩中。
|
|
68
|
+
|
|
69
|
+
## 3. 已落地的修复(1.8.7)
|
|
70
|
+
|
|
71
|
+
| 层 | 改动 | 落点 | 验证 |
|
|
72
|
+
|---|---|---|---|
|
|
73
|
+
| 结果消息 | 未完成时首句「未完成:完成 d/t,剩余 N 项」;职责第 3 条改为「【未完成,禁止交付】」,恢复动作固定为第 4 条;只有全 done 才出现「给出最终答复」 | `src/plan.ts` `buildResultSummary` / `buildResultMessage` | `tests/workplan-turn-stop-gate.test.ts` 用例 1、2 |
|
|
74
|
+
| 收尾指令 | 新增 `buildStopSteerText()`:说清剩余量/ID、禁止 present 与「已完成」措辞、给出唯一恢复动作 | `src/plan.ts` | 用例 3 |
|
|
75
|
+
| 工具返回 | render 分三态:「已开跑,尚未完成」/「未完成:完成 d/t,剩余 N 项」/「已完成」;schema 增加 `complete`、`remaining`;工具描述写明 `complete=false` 必须续跑 | `src/host.ts` `createDispatchTool`;`src/runtime.ts` `dispatchToolOutputSchema`、`completionFields` | `npm run check` + 用例 2 |
|
|
76
|
+
| 提示词 | 新增第 5、6 条:完成唯一判据是全部 done;`ok:true` 不等于完成;未完成禁止 `present`/「已完成」/收尾答复;确有阻碍时答复开头必须写「未完成:剩余 N 项与原因」 | `src/host.ts` `PROMPT_SECTION` | `tests/workplan-host.test.ts` |
|
|
77
|
+
| 回合边界 | 新增 `onTurnStopping` 并注册到官方 `agent/turn-stopping`:仍有未完成项时先等正在跑的派发,再 `agent.steer()` 注入「计划没做完,这个回合不关闭」;每回合最多 2 次;全 done/已取消/非任务回合直接放行 | `src/runtime.ts`、`src/host.ts` | 用例 4、5、6 |
|
|
78
|
+
|
|
79
|
+
## 4. 为什么这次能真正阻断
|
|
80
|
+
|
|
81
|
+
`agent/turn-stopping` 的语义(`@deepseek-ai/dsh-agent` 的
|
|
82
|
+
`lib/types/runtime-types.d.ts` 原文):
|
|
83
|
+
|
|
84
|
+
> Awaited before the boundary commits — a listener that objects steers
|
|
85
|
+
> (`agent.steer(...)`) and the machine re-reads its inbox: fresh steering runs
|
|
86
|
+
> another step, none closes the turn.
|
|
87
|
+
|
|
88
|
+
即:监听器在边界提交前被 await;只要 `steer` 注入新消息,机器会多跑一步而不关闭
|
|
89
|
+
回合。同仓的 `@deepseek-ai/dsh-workspace-changes` 就注册在插件根 `ctx` 上
|
|
90
|
+
(`lib/index.js:1067`),证明该 agent 作用域事件能到达根监听器。**提示词和文案
|
|
91
|
+
只能说服模型,这个事件能拦住收尾本身——两者叠加才是根治。**
|
|
92
|
+
|
|
93
|
+
## 5. 仍待验证 / 残余风险(不当结论)
|
|
94
|
+
|
|
95
|
+
- `agent/turn-stopping` 的实机行为尚未在本机重启后的 `dsh web` 上复现验证
|
|
96
|
+
(插件在 `dsh web` 启动时加载,**必须重启一次才生效**)。当前只有类型定义、
|
|
97
|
+
`dsh-agent-loop` 源码与同仓用例三处间接证据。
|
|
98
|
+
- `state.activeTurns` 只在「真实任务回合」置位;由用户一句「继续」触发的回合
|
|
99
|
+
不会置位(`isVagueContinuation` 提前返回)。1.8.8 已用
|
|
100
|
+
`turnCarriesPlanWork()` 补上「子 Agent 结算 / workplan 结果 / 续跑指令」
|
|
101
|
+
唤醒的回合,但纯人工「继续」回合仍不 steer;该回合的 `present` 仍会被工具级
|
|
102
|
+
闸门拒绝,纯文本收尾则只受提示词第 5、6 条约束。
|
|
103
|
+
- 每回合最多 2 次 steer:极端情况下第三轮仍可能带着未完成项收尾;此时界面与
|
|
104
|
+
文案会明确写「未完成」,但不会无限阻止模型结束回合。
|
|
105
|
+
- 事故会话本身仍停在 11/13;如需补齐 T12/T13,应对主 Agent 说「续跑这个计划」。
|
|
106
|
+
- 客户端卡片仍沿用「已结束 · 本轮预算用尽,可续跑」;本轮未改卡片措辞,只保证
|
|
107
|
+
聊天答复不再冒充成品。
|
|
108
|
+
|
|
109
|
+
## 6. 复现与验证命令
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
cd /Users/open/Documents/Stocks/plugins/dsh-workplan
|
|
113
|
+
npm run check # tsc --noEmit,期望无输出
|
|
114
|
+
npm test # 期望 220 tests / 220 pass / 0 fail
|
|
115
|
+
git log --oneline -3 # 期望看到本次 1.8.7 提交
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## 7. 1.8.8 补丁:补上审计发现的第二个绕过路径
|
|
119
|
+
|
|
120
|
+
1.8.7 上线后,审计计划 `wp-6753e19f` 的 T7 复核事故 turn 2 时发现:1.8.7 的闸门
|
|
121
|
+
只覆盖「有真实任务标记的回合」,而事故的第二个回合是被 T11 子 Agent 的结算通知
|
|
122
|
+
(`subagent-settled`)唤醒的——`humanMessages()` 只认人类 `user` 消息,`maybePlan`
|
|
123
|
+
在这类回合提前返回,`state.activeTurns` 没有置位,`onTurnStopping` 首行即放行。
|
|
124
|
+
同时 `present` 仍只有提示词约束,没有工具级拦截。两条合起来,正是事故里
|
|
125
|
+
「11/13 收尾 + 呈现半成品」的完整路径(H9、H10)。
|
|
126
|
+
|
|
127
|
+
1.8.8 的补法:
|
|
128
|
+
|
|
129
|
+
- **H9**:新增 `turnCarriesPlanWork(session, turn, record)`,从 `session.seq - 1`
|
|
130
|
+
回扫本回合事件,识别 `subagent-settled` / `workplan-result` /
|
|
131
|
+
`workplan-continue` 三类来源;`subagent-settled` 还要求
|
|
132
|
+
`source.senderSessionId` 属于本计划的子会话,无关子 Agent 的结算不会误激活。
|
|
133
|
+
`onTurnStopping` 改为「不在本回合任务标记里 **且** 本回合不携带计划工作」才放行。
|
|
134
|
+
- **H10**:新增 `presentDenialReason(agent)`,在 `src/host.ts` 的
|
|
135
|
+
`ctx.tools.guard` 中对 `present` 执行前拦截;根会话计划未完成即拒绝,文案列出
|
|
136
|
+
剩余项,并给出「先续跑 / 确实无法继续先 `dsh_workplan_cancel`」两条出路。
|
|
137
|
+
- **附带**:全部剩余项都 blocked 时不再空转 steer(没有可运行子任务,steer 只会
|
|
138
|
+
消耗回合),但 `present` 仍被拒绝。
|
|
139
|
+
|
|
140
|
+
验证:`npm run check` 无诊断;`npm test` 220/220;`npm run build` 五个产物
|
|
141
|
+
sha256 前后一致。运行中的 `dsh web` 仍需重启后生效。
|
|
142
|
+
|
|
143
|
+
## 8. 1.8.9 补丁:重启后的进度回退与剩余两条绕过路径
|
|
144
|
+
|
|
145
|
+
1.8.8 上线、用户重启 Web 服务后,`wp-6753e19f` 从 13/14 退回 5/14。根因不在
|
|
146
|
+
写入而在回放:`reconstructFromSession` 只有一组 `plan/statuses`,会话里出现
|
|
147
|
+
第二个计划(「继续」被误判生成的 `wp-dd26f206`,seq 1223)时,前一个计划被
|
|
148
|
+
压进冻结快照并停止接收后续事件。`wp-6753e19f` 迟到的 7/14 结果(seq 1337)
|
|
149
|
+
与六条 T9–T14 的 `done` 改判(seq 1517–1532)因 `planId` 不匹配被丢弃,
|
|
150
|
+
重启后永远回到冻结时的 5/14。
|
|
151
|
+
|
|
152
|
+
1.8.9 的补法:
|
|
153
|
+
|
|
154
|
+
- **回放按 planId 分账**:`ReplaySnapshot` 以 `plan.planId` 为键;`plan` /
|
|
155
|
+
`result` / `update` / `cancel` 与 `dsh_workplan_update` 的工具调用都按载荷
|
|
156
|
+
里的 `planId` 路由,`targetPlanId` 显式指定时优先返回该计划。用 1657 事件的
|
|
157
|
+
真实日志重放,`wp-6753e19f` 恢复为 13/14(仅 T5 blocked)。
|
|
158
|
+
- **结算回合按会话谱系认亲**:预算暂停把未完成项重置为 `pending`,而
|
|
159
|
+
`normaliseStatusEntry` 对 `pending` 强制清空 `childId`(不变量 I6 也不允许
|
|
160
|
+
`pending` 携带 `childId`)。事故里的 T11 因此从 `planChildIds` 消失。新增
|
|
161
|
+
`isChildSessionOf()`,用 `header.parentSession` 判定谱系,不再依赖易失字段。
|
|
162
|
+
- **`present` 的证据硬缺口**:全部 `done` 但存在 `verification === 'failed'`、
|
|
163
|
+
`acceptance[].result === 'fail'` 或非空 `missingArtifacts` 时,`present` 在
|
|
164
|
+
执行前被拒绝,并提示先 `dsh_workplan_update` 补证或改回 `blocked`。
|
|
165
|
+
`legacy`/无结构化证据属于软缺口,仍由提示词与结果消息约束;拦死它们会让
|
|
166
|
+
旧计划永久不可交付,只剩 `cancel` 一条路,是新的死锁。
|
|
167
|
+
|
|
168
|
+
验证:`npm run check` 无诊断;`npm test` 223/223;新增三条回归用例
|
|
169
|
+
(回放分账、`childId` 清空后的结算拦截、`present` 证据缺口)。
|
|
170
|
+
|
|
171
|
+
残余:取消计划后 `planIncomplete` 为 `false`,`present` 会放行(当前语义是
|
|
172
|
+
「取消即只交付中间结果,正文须写明未完成」);`status === 'done'` 但
|
|
173
|
+
`acceptance` 为空时仍按结构化证据接收,只能靠自检失败拦住明确错误的证据。
|
|
174
|
+
|
|
175
|
+
## 9. 1.8.10 补丁:回放窗口越过 plan 消息
|
|
176
|
+
|
|
177
|
+
1.8.9 的按 planId 分账在短日志上验证通过,但重启后对 `wp-6753e19f` 仍然
|
|
178
|
+
返回最新计划。原因是回放窗口固定为最近 `MAX_HISTORY_EVENTS`(2000)个事件,
|
|
179
|
+
而本会话已增长到 2256 个事件,`wp-6753e19f` 的 plan 消息在 seq 22,早已在
|
|
180
|
+
窗口之外:`ensure()` 从未执行,快照不存在,`reconstructFromSession` 返回
|
|
181
|
+
`null`,`status` 与 `dispatch` 一起退回内存里的新计划。
|
|
182
|
+
|
|
183
|
+
1.8.10 在显式传入 `targetPlanId` 且窗口内找不到该计划时,从窗口起点向前
|
|
184
|
+
扫描 plan 消息,把回放起点前移;默认回放不变。同一份 2256 事件日志重放
|
|
185
|
+
`wp-6753e19f` 得到 13/14(仅 T5 blocked)。`npm run check` 无诊断;
|
|
186
|
+
`npm test` 224/224。
|
|
187
|
+
|
|
188
|
+
残余:默认回放仍只保证最新计划,多计划并存的会话里续跑旧计划必须显式传
|
|
189
|
+
`planId`。
|
|
190
|
+
|
|
191
|
+
## 10. 1.8.11 补丁:真实生命周期下的谱系与重复回放
|
|
192
|
+
|
|
193
|
+
1.8.9 的谱系判定与 1.7.0 的改判回放各有一个只有在真实生命周期里才暴露的
|
|
194
|
+
缺陷,由 1.8.10 的重启后核验(wp-91b6a96b 的 T3、T7)定位:
|
|
195
|
+
|
|
196
|
+
- **谱系判定在结算消息到达时必然失效。** `dsh-subagent` 的
|
|
197
|
+
`finishDisposal` 先 `await activation.handle.dispose()`(`lib/index.js:2026`),
|
|
198
|
+
之后才 `notifySettlement`(`:2040`)。父会话收到 `subagent-settled` 时,
|
|
199
|
+
子会话已从 live 存储移除,`ctx.sessions.get(senderId)` 恒为 `undefined`。
|
|
200
|
+
1.8.9 的 `isChildSessionOf()` 因此从未在真实生命周期里成立,事故 turn 2
|
|
201
|
+
的路径仍可绕过闸门;T7 探针 A1a(真实 dispose 顺序)测得 steered:0。
|
|
202
|
+
- **人工改判被回放两次。** 一次 `dsh_workplan_update` 同时留下 durable
|
|
203
|
+
`workplan-update` 消息与配对的 `tool/result`。回放先按消息应用
|
|
204
|
+
(revision 4、`updatedBy: agent`),再按工具结果应用一次
|
|
205
|
+
(revision 5、`updatedBy: system`、summary 被覆盖),T3 在六个 `done`
|
|
206
|
+
改判上复现。
|
|
207
|
+
|
|
208
|
+
1.8.11 的补法:
|
|
209
|
+
|
|
210
|
+
- 认亲增加第三来源:父会话自己的 `subagent/catalog` 事件(spawn 时追加,
|
|
211
|
+
重启、回放、预算重置都不改写)。顺序为 childId → live 谱系 → spawn 记录;
|
|
212
|
+
三处都不命中才放行。扫描按 `session.seq` 缓存,避免每回合 O(n) 重扫。
|
|
213
|
+
- 回放记录每条 durable 改判的 seq 与状态;配对 `tool/result` 在其后且状态
|
|
214
|
+
相同时跳过第二次 `applyStatus`。durable 消息缺席时仍由 `tool/result`
|
|
215
|
+
独立生效,保持 1.6.0 的容错语义。
|
|
216
|
+
|
|
217
|
+
验证:`npm run check` 无诊断;`npm test` 228/228(新增 3 条:dispose 后按
|
|
218
|
+
spawn 记录认亲、三处都无记录不激活、人工改判只写一次)。
|
|
219
|
+
|
|
220
|
+
残余:`subagent/catalog` 只能证明「本会话 spawn 过它」,不能证明「它属于
|
|
221
|
+
该计划」;同一会话里两个未完成计划并存时,任一子 Agent 结算都可能让闸门
|
|
222
|
+
为当前记录 steer。这个偏差不会放行未完成交付,只会多要求一次续跑。要彻底
|
|
223
|
+
消除,需要把 childId→planId 的归属在 spawn 时持久化(1.8.12 候选)。
|
|
224
|
+
|
|
225
|
+
## 11. 1.8.15:取消终态、长会话回放与 present 的计划选择
|
|
226
|
+
|
|
227
|
+
1.8.14 发布后,三份独立复核(T4e 取消语义、T5c 运行态身份、T3 边界地毯)
|
|
228
|
+
在 1.8.13 / 1.8.14 字节上又测到四类缺陷:
|
|
229
|
+
|
|
230
|
+
- **取消后 dispatch 仍会启动部门 Agent。** `dispatchTool` 只检查内存里的
|
|
231
|
+
`record.phase`,取消只把计划标成 cancelled,并没有把派发入口关死;
|
|
232
|
+
`activationCalled: true`、`ok: true`,2/2 全 done 的 cancelled 计划还会被
|
|
233
|
+
静默改写成 `phase: 'done'`。
|
|
234
|
+
- **派发途中第二次取消再写一条取消消息。** 幂等守卫要求
|
|
235
|
+
`!record.dispatchPromise`,而取消正发生在派发进行中,守卫被绕过。
|
|
236
|
+
- **已取消回合的结果消息仍教「继续派发」。** 摘要与第 3/4 条职责不带取消
|
|
237
|
+
分支,与 stop-steer 的「不要 dispatch」自相矛盾(T4e F3、T3 C14/C15)。
|
|
238
|
+
- **长会话默认回放返回 null。** `MAX_HISTORY_EVENTS = 2000` 的窗口起点可能
|
|
239
|
+
落在计划消息之后,`reconstructFromSession` 返回 null,`present` 看不到计划
|
|
240
|
+
而静默放行(T3 B4)。另外 `buildHash` 未覆盖 `lib/watchdog.js`,
|
|
241
|
+
`/dsh-workplan/plans` 载荷没有版本身份(T5c)。
|
|
242
|
+
|
|
243
|
+
1.8.15 的补法:
|
|
244
|
+
|
|
245
|
+
- `dispatch` 对 `cancelled` 计划返回 `ok: false / code: 'PLAN_CANCELLED'`,
|
|
246
|
+
在启动任何子 Agent 之前返回。
|
|
247
|
+
- `cancelPlan` 在派发途中记录 `abortRequested`;第二次取消返回
|
|
248
|
+
`alreadyCancelled: true`,不再追加 durable 消息。
|
|
249
|
+
- `buildResultSummary` / `buildResultMessage` 增加取消分支:只完成 X/Y 时
|
|
250
|
+
明确「已取消,不得交付」,并禁止再次派发。
|
|
251
|
+
- 默认回放窗口向前回扫到最后定义的计划消息;**默认契约仍是「最后定义」**,
|
|
252
|
+
因为同一个默认答案也喂给 `dispatch`,改成「最后活动」会让旧计划截获新任务
|
|
253
|
+
的派发目标。`present` 改为优先按本回合消息点名的 `planId` 重建
|
|
254
|
+
(`currentTurnOf` + 已有的 `planIdFromTurn`),从而在 A 定义、B 后定义、
|
|
255
|
+
A 的结果最后到达时判 A 而不是 B。
|
|
256
|
+
- `buildHash` 纳入 `watchdog.js`;`plansPayload` 返回 `version` 与 `runtime`。
|
|
257
|
+
|
|
258
|
+
验证:`npm run check` 无诊断;`npm test` 252/252(新增
|
|
259
|
+
`tests/workplan-1815-guards.test.ts` 6 条,覆盖上述四类缺陷与身份字段)。
|
|
260
|
+
|
|
261
|
+
残余:P3 cancelled 后 present 的拒绝由 `deliveryReadiness` 统一承担,测试
|
|
262
|
+
钉住的是「拒绝 + 文案」;没有活体会话内的端到端 present 证据。默认回放与
|
|
263
|
+
`present` 的「本回合计划」判定依赖会话日志里的 `turn/start` 与结算消息,
|
|
264
|
+
日志被归档/截断的会话只能退回默认回放。
|
|
265
|
+
|
|
266
|
+
## 12. 1.8.16:present 必须检查整个会话的计划
|
|
267
|
+
|
|
268
|
+
1.8.15 交付后,本会话做了一次活体 E2E:直接调用 `present` 交付根因报告。
|
|
269
|
+
当时 `wp-6753e19f` 仍是 13/14(T5 blocked),但 `present` **成功返回**。
|
|
270
|
+
原因不是闸门没写,而是它只判「本回合消息点名的计划 / 最后定义的计划」——
|
|
271
|
+
而本会话最后定义的计划 wp-4038784e 已经 7/7 就绪,于是闸门看了一个已完成
|
|
272
|
+
的计划,放过了另一个未完成的计划。
|
|
273
|
+
|
|
274
|
+
这与事故现场是同一类错误:交付动作与「真正未完成的那份工作」之间没有绑定。
|
|
275
|
+
1.8.16 的补法:
|
|
276
|
+
|
|
277
|
+
- `sessionPlanRecords(session)` 扫描整份会话日志,收集所有出现过的
|
|
278
|
+
`planId`,逐个用显式 planId 重建(`reconstructFromSession(session, id)`
|
|
279
|
+
自带窗口回扫),得到每个计划的当前状态。
|
|
280
|
+
- 闸门对所有**非取消且未就绪**的计划求并集:只要还有一个,就拒绝
|
|
281
|
+
`present`,并在文案里逐条列出计划、完成数、剩余子任务与证据缺口。
|
|
282
|
+
- 已取消的计划不参与「阻塞其他计划」的并集——事故会话里会累积永远不再
|
|
283
|
+
推进的取消计划,若让它们永久阻塞,交付将死锁。但若取消的计划正是本回合
|
|
284
|
+
或当前记录所指的那一个,仍按「已取消 ≠ 可交付」拒绝(T5-C 语义不变)。
|
|
285
|
+
|
|
286
|
+
验证:`npm run check` 无诊断;`npm test` 253/253(新增一条多计划用例);
|
|
287
|
+
构建产物 sha256 前后一致。
|
|
288
|
+
|
|
289
|
+
残余:`present` 没有参数声明「本次交付属于哪个计划」,所以只能按会话级
|
|
290
|
+
保守规则判断。若未来引入多计划并行交付,需要在 `present` 载荷里显式携带
|
|
291
|
+
planId,或把产物与计划建立持久关联。
|
|
292
|
+
|
|
293
|
+
## 13. 1.8.17:回放记录缺 `errors` 字段导致整轮假受阻
|
|
294
|
+
|
|
295
|
+
17:51:37,`wp-40ce5eee` 的派发在 20 分钟预算边界中止,结果消息把 T5–T10
|
|
296
|
+
六项全部标成
|
|
297
|
+
|
|
298
|
+
```
|
|
299
|
+
error: record.errors is not iterable
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
其中 T5、T6、T7 已经启动了真实的子 Agent,T8–T10 还没轮到——它们不是失败,
|
|
303
|
+
是被一个 `TypeError` 连坐。
|
|
304
|
+
|
|
305
|
+
直接原因:
|
|
306
|
+
|
|
307
|
+
1. 宿主在 17:30:21 重启,内存里没有 `wp-40ce5eee` 的记录;
|
|
308
|
+
2. `dispatchTool` 走 `needsRebuild`,用 `reconstructFromSession` 从会话日志
|
|
309
|
+
重建记录;
|
|
310
|
+
3. 重建返回的对象有 `plan/statuses/phase/createdAt/…`,没有 `errors`;
|
|
311
|
+
4. 预算到点,`disposeActivation` 在清理子任务时写
|
|
312
|
+
`record.errors = [...record.errors, `${subtaskId} dispose: …`]`;
|
|
313
|
+
5. 展开 `undefined` 抛出 `TypeError: record.errors is not iterable`,冒到本轮
|
|
314
|
+
调度器的 catch,把剩余子任务统一记为 blocked。
|
|
315
|
+
|
|
316
|
+
这条链与事故现场的同类之处:**两条数据源(实时缓存 / 日志回放)形状不一致,
|
|
317
|
+
失败在边界上被放大成「其余全部失败」**。回放是为了让重启后的计划还能继续,
|
|
318
|
+
但它返回的记录比内存记录少一个字段,于是本该继续的那一轮被自己拦死。
|
|
319
|
+
|
|
320
|
+
修复(1.8.17):
|
|
321
|
+
|
|
322
|
+
- `ReplaySnapshot` 增加 `errors: string[]`;回放结果消息时并入
|
|
323
|
+
`result.errors`(最近 20 条);返回的记录始终带 `errors` 数组。
|
|
324
|
+
- 所有 `[...record.errors, …]` 展开点补 `?? []`,覆盖 dispose 失败、重试说明、
|
|
325
|
+
剩余预算不足、子任务超时、超时写状态失败、预算收尾、错误记录七处。
|
|
326
|
+
- `tests/workplan-replay-errors.test.ts` 两条:回放记录始终有 `errors` 数组并
|
|
327
|
+
保留 durable 失败行;回放记录再派发时子任务失败只记错、不炸整轮。
|
|
328
|
+
|
|
329
|
+
验证:`npm run check` 无诊断;`npm test` 255/255;构建前后 5 个产物 sha256
|
|
330
|
+
一致。
|
|
331
|
+
|
|
332
|
+
残余:这次崩溃发生在「预算中止 + dispose 失败」的组合路径上;如果未来新增
|
|
333
|
+
记录字段,仍可能出现「实时缓存有、回放没有」的同类漂移。更彻底的补法是让
|
|
334
|
+
两条路径共用同一个 record 工厂,或在回放结束时跑一次形状校验(schema
|
|
335
|
+
assertion)。这一条尚未实施。
|
|
336
|
+
|
|
337
|
+
## 14. 1.8.18:空计划、取消后重启与已交付文件的写保护
|
|
338
|
+
|
|
339
|
+
1.8.16 的全计划 `present` 闸门解决的是「看哪一个计划」,1.8.18 解决的是
|
|
340
|
+
「计划本身还算不算交付对象」以及「交付之后文件还能不能被改」。
|
|
341
|
+
|
|
342
|
+
### 14.1 空计划(U6)
|
|
343
|
+
|
|
344
|
+
`deliveryReadiness` 的 `ready = total > 0 && …` 意味着 `stages: []` 的计划
|
|
345
|
+
永远到不了 ready;而 `present` 的候选集只看「是否 done/是否 ready」,于是
|
|
346
|
+
空计划会以「0 个子任务虽都已 done」的错文案被永久拒绝。空计划不是正常
|
|
347
|
+
规划能产出的(`validatePlan` 会拒),只可能来自畸形历史消息;把它当交付对象
|
|
348
|
+
判定没有意义。修复:`definedSubtaskCount(plan)` 决定候选是否参与闸门,空计划
|
|
349
|
+
放行;畸形到无法计算定义的,按「不可判断」继续 fail-closed。
|
|
350
|
+
|
|
351
|
+
### 14.2 取消后重启(T5 E1/E6)
|
|
352
|
+
|
|
353
|
+
取消工具自己的契约写着「取消后如仍有未完成项或证据缺口,present 仍会被拒绝」。
|
|
354
|
+
但在「取消未完成计划 → 重启宿主 → present」这条序列上,回放时 live record 与
|
|
355
|
+
本回合计划都不存在,候选集为空,闸门直接放行。修复:`lastGateablePlanRecord()`
|
|
356
|
+
回退到最近一个定义了工作的计划,被取消但未完成的计划因此仍拒绝;同时保留
|
|
357
|
+
两条不变量——较新的已就绪计划不被历史取消项阻塞,空计划不能当挡箭牌。
|
|
358
|
+
|
|
359
|
+
### 14.3 已交付文件的写保护(T7-N2)
|
|
360
|
+
|
|
361
|
+
`present` 不复制内容(工具描述原文:the user opens the current files),
|
|
362
|
+
`write`/`edit` 也不校验路径是否已交付。事故的迟到回合在 12:04 出卡后,于
|
|
363
|
+
12:13 两次原地改写同一份报告,用户点开的卡片背后内容已经变了。修复:
|
|
364
|
+
`present` 时把「当时已定义的计划 id + 路径」记进快照;新增
|
|
365
|
+
`fileWriteGuardReason`,在根会话对同一路径的 `write`/`edit`/
|
|
366
|
+
`str_replace_editor` 检查这些计划是否仍未就绪,未就绪则拒绝并给出续跑 /
|
|
367
|
+
取消 / 重新 present 的出口。present 之后新建的计划不在快照里,避免把正常
|
|
368
|
+
改版卡死。
|
|
369
|
+
|
|
370
|
+
### 14.4 验证
|
|
371
|
+
|
|
372
|
+
- `tests/present-gate-evidence.test.ts` 8 条:A1/A2 回归事故形状,A3 空计划,
|
|
373
|
+
A4 plan 模式防死锁,A5 按定义过滤,A6 取消后重启仍拒,A7 历史取消不阻塞,
|
|
374
|
+
A8 空计划挡箭牌无效。
|
|
375
|
+
- `tests/workplan-presented-write-guard.test.ts` 7 条:拒绝与出口、路径归一、
|
|
376
|
+
新计划放行、就绪放行、取消放行、非根会话/plan 模式放行、只接管三个写工具。
|
|
377
|
+
- `npm run check` 无诊断;`npm test` 270/270;两次构建 5 个产物 sha256 一致。
|
|
378
|
+
|
|
379
|
+
### 14.5 残余
|
|
380
|
+
|
|
381
|
+
- 写保护只覆盖根会话的直接写工具调用;shell 重定向、符号链接、子会话写入
|
|
382
|
+
不在覆盖内(已在 T7 §9.7 列明)。
|
|
383
|
+
- 落码后尚未在运行实例验证:补丁未提交前进程仍加载 1.8.17,活体写拒绝与
|
|
384
|
+
`present` 行为要等重启后按 T7-N3 清单跑。
|
|
385
|
+
- 1.8.18 与并行工程的改动共用工作树,提交时整体评审,不单独 cherry-pick。
|
|
386
|
+
|
|
387
|
+
## 15. 1.8.19:超时与预算中止不得抹掉已落盘的产物
|
|
388
|
+
|
|
389
|
+
### 15.1 事故(2026-10-31 23:07–23:23)
|
|
390
|
+
|
|
391
|
+
- T10(子会话 `a0d5b134…`)22:58:20 启动,23:07:25 收到
|
|
392
|
+
`turn/end {"kind":"aborted","reason":{"kind":"parent"}}`——这是 20 分钟整轮
|
|
393
|
+
预算(`TOTAL_TIMEOUT_MS = 1200000`)的父级中止,不是模型自己停、不是完成、
|
|
394
|
+
也不是工具报错。它的覆盖率产物 23:06:26 已经落盘;预算分支把状态重置为
|
|
395
|
+
`pending` 时按 `applyStatus` 语义清空 `childId/startedAt`,卡片于是显示
|
|
396
|
+
「从未开始」。
|
|
397
|
+
- T11(`031225ef…`)与 T12(`7934905a…`)23:08:38 启动,23:23:38 收到
|
|
398
|
+
`turn/end` 的父级中止——恰好是 900 秒硬上限(`CHILD_TIMEOUT_MS = 900000`)。
|
|
399
|
+
T11 的 `T11_索引登记与扫描复核_20261031.md`(32,996 B)与 T12 的
|
|
400
|
+
`T12_缺口补齐报告_20261031.md`(51,547 B)分别在 23:22–23:23 落盘,比被杀
|
|
401
|
+
早 4–60 秒;父会话只看到 `blocked / 达到执行上限`,没有任何产物线索。
|
|
402
|
+
- 判定:三条子任务的 deliverable 都已完整落盘,主 Agent 复核后改判
|
|
403
|
+
T11/T12/T13 done(wp-79fb0f9e 13/13);但「超时=什么都没做」的记账必须修。
|
|
404
|
+
|
|
405
|
+
### 15.2 修复
|
|
406
|
+
|
|
407
|
+
- `timeoutBlockedPatch`:硬超时先把子任务声明的 `outputs` 对照磁盘,命中的
|
|
408
|
+
文件写进 `error` 与 `artifacts`,未命中的进 `missingArtifacts`;判定不变。
|
|
409
|
+
- `budgetResetError`:预算重置的 error 保留上一轮 `childId`(前 8 位)、运行
|
|
410
|
+
秒数与已落盘产物,重置后仍是 `pending`(可续跑)。
|
|
411
|
+
- `buildChildPrompt` 的 `resumeHint`:下一次尝试先列出上一轮已落盘产物,要求
|
|
412
|
+
核对后只补缺失,不整步重写。
|
|
413
|
+
- `PROMPT_SECTION` 第 7 条:把「超时 ≠ 什么都没做」写成主 Agent 的硬规则。
|
|
414
|
+
|
|
415
|
+
### 15.3 验证
|
|
416
|
+
|
|
417
|
+
- `tests/timeout-artifact-evidence.test.ts` 4 条:超时产物入 error/artifacts、
|
|
418
|
+
无产物不编造、预算重置保留子会话与时长、提示词续跑段。
|
|
419
|
+
- `npm run check` 无诊断;`npm test` 274/274;两次构建 5 产物 sha256 一致。
|
|
420
|
+
|
|
421
|
+
### 15.4 残余
|
|
422
|
+
|
|
423
|
+
- 900 秒上限与 20 分钟预算是策略值,未改默认;超时仍不自动重试,只保证
|
|
424
|
+
「证据不丢、重试有据、提示词不重写」。
|
|
425
|
+
- 运行进程仍加载 1.8.18;1.8.19 的活体验证需重启后补。
|
|
426
|
+
|
|
427
|
+
## 16. 1.9.0:终态解耦,取消/被取代不再无限挡门(2026-11-01)
|
|
428
|
+
|
|
429
|
+
### 16.1 现象与机制
|
|
430
|
+
|
|
431
|
+
- `wp-bea31753` 被取消(0/8)后,`present` 仍把它选为「最后可判定计划」并硬拦
|
|
432
|
+
(`runtime.ts:3253-3261` 写回 live → `3267-3286` 拒绝);同一计划 `dispatch`
|
|
433
|
+
返回 `PLAN_CANCELLED`(`2620-2635`),收尾 steer 又说两件都不能做 → 双向死锁。
|
|
434
|
+
日志实例:seq 7167 cancel → 7174 present → 7175 `isError`。
|
|
435
|
+
- 根因是两套判断互相矛盾:1.8.13 起「已取消」仍算不可交付,1.8.16 又把取消计划
|
|
436
|
+
排除出全会话未完成并集;回退分支单独把终态计划捞回来,于是取消既不能解除
|
|
437
|
+
挡门、也不能派发。
|
|
438
|
+
|
|
439
|
+
### 16.2 修复
|
|
440
|
+
|
|
441
|
+
- `TERMINAL_PHASES` / `isTerminalPhase`:`cancelled`、`superseded` 统一为终态,
|
|
442
|
+
`reconcilePhase` 不再把终态改回 active。
|
|
443
|
+
- 终态解耦(D1):终态计划不进入 present 的全局未完成集合、不自动写回 live、
|
|
444
|
+
不自动触发收尾 steer;只有本回合结构化点名时才判定(D2,`cancelled` 文案
|
|
445
|
+
逐字保留)。
|
|
446
|
+
- `superseded` 只做读取/判定/拒绝:`supersededBy.successorPlanId` 缺失、承接
|
|
447
|
+
计划终止或未就绪 ⇒ `SUPERSEDED_STALE`;承接计划就绪才放行。写入路径不在本版。
|
|
448
|
+
- `dispatch` 对 `superseded` 返回 `PLAN_SUPERSEDED`;`cancelled` 返回体不变。
|
|
449
|
+
|
|
450
|
+
### 16.3 语义变更(必须披露)
|
|
451
|
+
|
|
452
|
+
- 旧行为:取消一个未完成计划后,即使非本回合点名,present 也拒绝(T5-C)。
|
|
453
|
+
- 新行为:非本回合点名的终态计划不再阻塞交付;**取消仍然不是完成**——
|
|
454
|
+
记录仍是 cancelled 0/N,本回合点名它时仍按「已取消 + 不得调用 present」硬拦。
|
|
455
|
+
- 理由:取消是用户叫停;让一个被叫停的计划永久堵死整个会话的交付,代价高于
|
|
456
|
+
「取消后再交付」。需要「取消后仍禁止交付」的会话,应保留计划为 active 并
|
|
457
|
+
用 update 补证据,而不是取消。
|
|
458
|
+
|
|
459
|
+
### 16.4 验证与残余
|
|
460
|
+
|
|
461
|
+
- `npm run check` 无诊断;`npm test` 274/274;两次构建 5 产物 sha256 一致。
|
|
462
|
+
- 更新 A6/A8、delivery-gate 与 turn-stop-gate 中「取消一律拒绝」的旧断言为
|
|
463
|
+
「非点名放行 / 点名硬拦」。
|
|
464
|
+
- 残余:`superseded` 写入路径、P1 `EVIDENCE_GAP` 拒绝码统一、W1 digest 规范化、
|
|
465
|
+
W5 与真实取消信封 replay 联测、活体重启验证。
|
|
466
|
+
|
|
467
|
+
## 17. 1.9.1:为「被中止但产物已交付」的子会话补发 follow-up(2026-11-01)
|
|
468
|
+
|
|
469
|
+
### 17.1 事实
|
|
470
|
+
|
|
471
|
+
- 事故夜三条子会话 `a0d5b134`(qa:T10)、`031225ef`(engineering:T11)、
|
|
472
|
+
`7934905a`(writing:T12)分别在 23:07:25 / 23:23:38 被整轮预算与 900s
|
|
473
|
+
子任务上限中止;三条末轮都是 `turn/end = aborted/parent`。
|
|
474
|
+
- 台账侧三条早已 `done + verification=structured + acceptance 全 pass`
|
|
475
|
+
(durable seq 6197 / 6464 / 6471),父会话重启只回放台账
|
|
476
|
+
(`runtime.ts:1541`),不会改写子会话的 `turn/end`。
|
|
477
|
+
- DSH Web 子智能体列表只读 `subagentTiming.lastTurnCompleted`
|
|
478
|
+
(`dsh-client-ui-subagent/lib/client.js:203-204` 文案、`:272` 状态点),
|
|
479
|
+
该字段由子会话末轮 `turn/end` 推出 ⇒ 两条数据源 3/3 冲突,界面永远灰点。
|
|
480
|
+
|
|
481
|
+
### 17.2 处置
|
|
482
|
+
|
|
483
|
+
- 用户 2026-11-01 明确同意「补发 follow-up,让圈注三行真正变绿」(路径 A)。
|
|
484
|
+
- 新增 `dsh_workplan_followup`:调用官方
|
|
485
|
+
`subagents.sendMessage(sender, targetId, content, {signal})`。service 的语义
|
|
486
|
+
是「向发送者的直接父/直接 continuable 子投递;running 目标在下一步收,
|
|
487
|
+
idle 目标开新一轮,缺席的直接子会话冷恢复」——正是路径 A 需要的真实
|
|
488
|
+
follow-up,而不是伪造记录。
|
|
489
|
+
- 守卫:根会话、catalog 直接子会话、message 非空且 ≤4000 字符、服务缺失/
|
|
490
|
+
投递异常均显式失败;工具不写计划状态、不触发 present、不改
|
|
491
|
+
`lastTurnCompleted`。
|
|
492
|
+
- 新增 `tests/workplan-followup-tool.test.ts` 3 条;全量 277/277。
|
|
493
|
+
|
|
494
|
+
### 17.3 边界与残余
|
|
495
|
+
|
|
496
|
+
- 补发成功 ≠ 界面变绿:必须等子会话自己跑完并 `turn/end = completed`。
|
|
497
|
+
- 若子会话再次被预算/上限中止,灰点保留;不得改投影缓存或手写 turn/end。
|
|
498
|
+
- 本版不自动补发:必须用户明确授权后由主 Agent 调用工具。
|