dsh-workplan 2.2.9 → 2.3.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.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,11 @@
1
+ ## 2.3.0 — 2026-11-10
2
+
3
+ - 专家执行时间机制优化(用户 2026-11-10 要求,四点):
4
+ - **预估上报**:子任务派发后,专家向主 Agent 上报预估执行时长;主 Agent 把预估告知用户(预估仅供参考、非承诺,实际时长由协商决定)。
5
+ - **超时放宽并告知**:专家执行超过预估时间时,主 Agent 继续放宽时限,并把最新执行时间告知该专家,同时要求其在保证工作质量的前提下高效率执行,让专家有准备;放宽有界、可审计。
6
+ - **二次超时主 Agent 接手**:预估时间连续超时两次后,由主 Agent 接手该专家尚未完成的工作;禁止丢弃专家已完美完成的部分,必须以既有产物与证据为基础继续补齐。
7
+ - **版本与发布**:全部版本标识同步至 2.3.0(package.json / package-lock.json×2 / src/host.ts / lib/host.js / tool-surface fixture / README 三语安装行与徽章);本版本完成后自动发布到官方 GitHub 与索引源。
8
+
1
9
  ## 2.2.9 — 2026-11-10
2
10
 
3
11
  - 红字复发族治本(用户 2026-11-10 截图实证):收束类计时器去 unref 分类治理(存活恰 3 处卫生类白名单);结算结果块缺失与解析失败同闸有界回喂 + 盘上结算备份自动采纳(EVIDENCE_MISSING);防回归四件套(handle-policy 静态守卫、全局事件循环测试锚、run-tests cancelled===0 硬断言、CI node22+26 双矩阵)。
package/README.en.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > **Two selling points, one line: a full ISO/IEC 15408:2026 evidence pack you can verify with 5 commands, and a one-command install with zero runtime dependencies.**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-2.2.6-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.2.6)
6
+ [![version](https://img.shields.io/badge/version-2.3.0-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.3.0)
7
7
 
8
8
  Adds "plan first → dispatch real department subagents → watch progress in the sidebar" to **DeepSeek Harness (DSH)**. No app, no DSH source patch, no page replacement.
9
9
 
@@ -80,7 +80,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
80
80
  ## Install
81
81
 
82
82
  ```bash
83
- dsh plugin --profile web add dsh-workplan@2.2.9
83
+ dsh plugin --profile web add dsh-workplan@2.3.0
84
84
  ```
85
85
 
86
86
  Restart the DSH Web process (or reload the page) so the bundle is picked up.
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-2.2.6-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.2.6)
6
+ [![version](https://img.shields.io/badge/version-2.3.0-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.3.0)
7
7
 
8
8
  给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
9
9
 
@@ -69,7 +69,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
69
69
  ## 一键安装
70
70
 
71
71
  ```bash
72
- dsh plugin --profile web add dsh-workplan@2.2.9
72
+ dsh plugin --profile web add dsh-workplan@2.3.0
73
73
  ```
74
74
 
75
75
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
package/README.zh.md ADDED
@@ -0,0 +1,242 @@
1
+ # dsh-workplan
2
+
3
+ > **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
4
+
5
+ [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
+ [![version](https://img.shields.io/badge/version-2.3.0-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v2.3.0)
7
+
8
+ 给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
9
+
10
+ - 对话里先出【任务分解】:阶段、子任务、部门、验收标准,一样不缺
11
+ - 最多 5 个真实子 Agent 并行执行,结果写回会话
12
+ - 左侧栏「任务进度」:谁在做、做到哪、哪件卡住了
13
+
14
+ **English (US) — plain-language guide:** [README.en.md](README.en.md)
15
+
16
+ ---
17
+
18
+ ## 为什么敢拿 ISO/IEC 15408 当卖点,又不算吹牛
19
+
20
+ **CC(Common Criteria,ISO/IEC 15408)的规矩是三方分工:开发者交材料 → 独立实验室评测 → 国家机构发证。软件不能给自己发证。** 所以「本插件已通过 CC 认证」这句话,没有证书编号就是假的——这种话我们不说。
21
+
22
+ 我们做的是能自己做的那一半:**按 2026 版(不是 2022 版)标准的结构,把材料真做出来、公开出来,任何人都能自己核对。**
23
+
24
+ | 我们公开的 | 对应标准 | 在哪儿 |
25
+ |---|---|---|
26
+ | 保护什么、防谁、边界在哪 | 安全目标(ST) | [docs/cc/SECURITY-TARGET.md](docs/cc/SECURITY-TARGET.md) |
27
+ | 攻击面、7 条威胁、对策、残留风险 | 脆弱性评定(AVA) | [docs/cc/AVA-VULNERABILITY-ANALYSIS.md](docs/cc/AVA-VULNERABILITY-ANALYSIS.md) |
28
+ | 逐类对照 + EAL1 就绪度 + 还缺什么 | 自评估 | [docs/cc/CC-2026-ASSESSMENT.md](docs/cc/CC-2026-ASSESSMENT.md) |
29
+ | 第三方组件、许可证、哈希 | 生命周期(ALC) | [docs/SBOM.md](docs/SBOM.md) |
30
+ | 漏洞怎么报、多久回、部署怎么配 | 安全策略 | [SECURITY.md](SECURITY.md) |
31
+ | 470 项自动化测试(2026-11-03 独立复检实测 470/470 全绿),一条命令复跑 | 测试(ATE) | `npm run verify` |
32
+
33
+ 现状(2026-11-03 独立复检报告结论,33 条差距逐条复核):**26 条已关闭(通过);4 条经判定为「不适用或固有残留」且判定本身成立;1 条(发布包 sha256 数值)属发布期执行件,脚本已就绪、随发布公布**。无新发现的代码类缺口。**必须如实披露的固有残留**:`ATE_IND.1`(测试执行需认可实验室见证)与 `AVA_VAN.2+`(独立渗透评测)——按 CC 规则只能由认可实验室完成,本项目以「公开自评估」口径如实标注,任何宣传材料都不省略这条。
34
+
35
+ 版本口径(两个头都有官方来源佐证):证据包按 **ISO/IEC 15408:2026**(已列入 ISO 官方目录)的结构编写;现行国家认证体系(如德国 BSI)受理的版本仍为 **CC:2022**。所以我们说「**对齐 2026 结构、认证体系现行受理 CC:2022,公开全套自评证据 + 完整安装使用方法**」,不说「已通过 CC 认证」。
36
+
37
+ 自己验,3 行,复制即用:
38
+
39
+ ```bash
40
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
41
+ npm ci && npm run verify # 期望:tests 470 / pass 470 / fail 0
42
+ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中(预期)"
43
+ ```
44
+
45
+ > 一句话记住:**有证书是第三方给的,有证据是自己挣的。**
46
+ >
47
+ > **自我更正记录**:v1.8.1 公开更正了 v1.8.0 里三处「文档写得比代码多」的地方(图表路由其实不鉴权、自测并未覆盖鉴权与截断分支、EAL1 矩阵把一个自相矛盾的组件判成就绪),详情见 [CHANGELOG](CHANGELOG.md) 与 [自评估 §6.1](docs/cc/CC-2026-ASSESSMENT.md)。
48
+
49
+ ## 它到底做了什么(用大白话讲)
50
+
51
+ 平时你给 AI 一个复杂任务,它经常「一边想一边做」,做到一半你才发现方向不对。
52
+
53
+ 这个插件把节奏改成三拍:
54
+
55
+ 1. **先排计划**:你发出任务后、AI 真正动手前,它先写一份计划——分几个阶段、每个阶段几件具体工作、每件工作交给哪个部门、怎么做、什么算做完、可能卡在哪。
56
+ 2. **计划先给你看**:这份计划以「任务分解」的形式出现在对话里,包含每一步的依据与验收标准,而不是一句话糊过去。
57
+ 3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(最多 5 个同时跑),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
58
+
59
+ 计划不是装饰品:主 Agent 必须先派发、等到部门结果回来,才能继续往下答。
60
+
61
+ ## 装之前你需要什么
62
+
63
+ | 要求 | 说明 |
64
+ |---|---|
65
+ | DeepSeek Harness | 官方 Web 版(`dsh web` / `--profile web` 跑的这套) |
66
+ | Node.js | **22 或更高**(`node -v` 自查) |
67
+ | 网络 | 安装时需要能访问 npm registry |
68
+
69
+ ## 一键安装
70
+
71
+ ```bash
72
+ dsh plugin --profile web add dsh-workplan@2.3.0
73
+ ```
74
+
75
+ 装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
76
+
77
+ 没有 `dsh` 命令的话,先确认它在 PATH 里;用 `npx` 起的 DSH 可以直接用完整路径调用同一个 `dsh`。
78
+
79
+ ### 从源码安装(可选,想改代码时用)
80
+
81
+ ```bash
82
+ git clone https://github.com/abbaababa/dsh-workplan.git
83
+ cd dsh-workplan
84
+ npm ci && npm run build
85
+ dsh plugin --profile web add "$(pwd)"
86
+ ```
87
+
88
+ ## 装好以后怎么用(小白版)
89
+
90
+ 1. 打开 DSH Web,随便发一个**有实际目标**的任务,例如「帮我把这个目录的测试补到 80% 覆盖」。
91
+ 2. 等一两秒,对话里会出现一块【任务分解】:阶段、子任务、部门、验收标准齐全。
92
+ 3. 你只需要正常对话;主 Agent 会按规则派发计划,遇到要拍板的地方会问你。
93
+ 4. 点左侧栏的**「任务进度」**,就能看到:
94
+
95
+ - 顶部五个数字:**几个任务 / 分配了多少件工作 / 做好了 / 正在做 / 卡住了**;
96
+ - 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」= 这一轮已经停了(没有东西在跑)但计划还没做完,卡片会写清停在哪儿(预算用完 / 卡住了 / 还没开始),说一句「继续」即可接着推进;
97
+ - 展开任意计划:每个阶段的进度、每件具体工作由哪个部门负责、当前状态。
98
+
99
+ 5. 进度数字背后的每一行,都来自同一份任务状态——**不会再出现「显示 0 个正在做、但下面明明写着正在做」这种自相矛盾**(1.4.3 专门修的就是这个,见下文)。
100
+
101
+ 纯打招呼、道谢、问「做到哪了」不会触发拆解,不会平白多出一堆子 Agent。
102
+
103
+ ## 九个模型工具(你不用直接调用)
104
+
105
+ | 工具 | 作用 |
106
+ |---|---|
107
+ | `dsh_workplan_dispatch` | 派发当前计划,把结果写回会话。默认 `mode:"wait"` 等结束;`mode:"async"` 立刻返回、后台继续。重复调用是幂等的。 |
108
+ | `dsh_workplan_status` | 只读:问到哪了。重启或刷新后也能从会话记录重建。 |
109
+ | `dsh_workplan_update` | 主 Agent 核对结果、修正某个子任务状态与证据。带 `expectedRevision` 防覆盖,运行中默认拒绝(`force:true` 才覆盖)。子 Agent 不能调用。 |
110
+ | `dsh_workplan_cancel` | 取消还没派发的计划,不会伪造任何「已完成」。 |
111
+ | `dsh_workplan_replan` | 需求变更时就地修订:`cancel` / `replace` / `add`,旧行标为「已取代」保留可追溯,计划版本号递增。主 Agent 专用。 |
112
+ | `dsh_workplan_escalate` | 子 Agent 执行中遇阻上报:问题、选项、建议进状态机,等主 Agent 指示;不再是「只能憋到结尾写 BLOCKED」。 |
113
+ | `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。带 60s/180s 回执检查。 |
114
+ | `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
115
+ | `dsh_workplan_followup` | 给预算/超时中止、但产物已落盘的直接子会话补一条收尾说明。 |
116
+
117
+ 在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
118
+
119
+ ## 部门怎么协作(1.11.0 的真实能力)
120
+
121
+ 计划里的每件工作都带一个部门标签(工程研发、研究分析、设计、产品、数据、质量验证、安全、运维、文档写作、运营、法务合规、财务)。**标签决定提示词与统计口径,不是组织架构**:
122
+
123
+ - 部门之间**不能直接对话**(这是刻意的权限边界);跨部门信息由主 Agent 转达,或落到双方都能读的工作区文件。但每个子 Agent 的提示词里会带上**兄弟部门的只读一览**(谁、做什么、产出什么、已完成摘要),需要协作就写进 `needs`;每条 needs 会自动登记成带编号的跨部门需求(`open → routed → answered/closed`),结果消息与 `status` 都能看到,**未处置就拦住交付**。主 Agent 用 `dsh_workplan_handoff` 逐条处置;提出需求的行若正在等指示,`resolve` 会把答复直接投递给该子会话。
124
+ - 下游只看到 `dependsOn` 里上游的**摘要**与完整体检结果,看不到上游的完整对话。所以上游必须把「产物绝对路径 + 怎么验收」写进摘要;声明为 `file` 的产物会被逐个核实,**缺失就不给下游解锁**。
125
+ - 子 Agent 在输出末尾回传结构化证据块(`status` / `acceptance` / `artifacts` / `needs`)。**非空输出不再等于完成**:`partial`、任一条验收失败、坏块都判受阻,只有全 `pass` 才可直接采信,其余在结果消息里标「未验证」等主 Agent 核对。
126
+ - 阶段(stage)只是展示分组,**不是执行门槛**;真正决定先后的是 `dependsOn`。
127
+
128
+ 完整的角色、数据契约、状态机、失败恢复与「改代码时必须同步的三处」,见 **[协作契约](https://github.com/abbaababa/dsh-workplan/blob/main/docs/collaboration.md)**;12 个部门的职责与交接清单见 **[部门职责与交接约定](https://github.com/abbaababa/dsh-workplan/blob/main/docs/departments.md)**。
129
+
130
+ ## 预算、超时与续跑(知道这些就不会误以为卡死)
131
+
132
+ | 项 | 默认值 | 怎么改 |
133
+ |---|---|---|
134
+ | 单轮派发预算 | 20 分钟 | `DSH_WORKPLAN_TOTAL_TIMEOUT_MS` |
135
+ | 单个子 Agent 上限 | 15 分钟 | `DSH_WORKPLAN_CHILD_TIMEOUT_MS` |
136
+ | 子 Agent 无进展判定 | 5 分钟 | `DSH_WORKPLAN_IDLE_TIMEOUT_MS` |
137
+ | 规划器无进展上限 | 5 分钟(**自上一个输出块起算**,一直在输出就一直顺延) | `DSH_WORKPLAN_PLANNER_TIMEOUT_MS` |
138
+ | 规划器静默判定 | 90 秒(输出开始后连一个字都不再来才算卡死) | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
139
+ | 规划器绝对上限 | 15 分钟(= 无进展上限 × 3,有无产出都到此为止) | 随 `…_PLANNER_TIMEOUT_MS` 等比变化 |
140
+ | 自动续跑次数 | 4 次 | `DSH_WORKPLAN_MAX_RESUMES` |
141
+ | 并发子 Agent | 5 个(固定) | — |
142
+
143
+ 预算用尽不是失败:计划会变成「**本轮预算用尽,可续跑**」,已完成的不重跑,剩下的下次接着做。被判定卡住的子任务只卡它自己,不会拖垮整个计划;重试只会发生一次,第二次的提示词会带上一次的失败原因,不会原样重撞。
144
+
145
+ 环境变量写在启动 DSH 的那个 shell 里,或者写进插件配置:
146
+
147
+ ```jsonc
148
+ // cordis.patch.yml 里的 config 字段
149
+ { "totalTimeoutMs": 1800000 } // 30 分钟
150
+ ```
151
+
152
+ ## 安全与隐私(可以自己复核)
153
+
154
+ - **没有第三方运行时依赖**:`dependencies` 是空的;装出来的只有这个插件自己的 JS、配置、图标和说明。
155
+ - **不写你的磁盘**:源码里没有任何 `writeFileSync` / `appendFileSync` / `mkdirSync`(可 `grep` 验证);结果只写进 DSH 会话记录。
156
+ - **不向外发数据**:源码里没有 `child_process`、没有对外 `fetch`/`http.request`;唯一的一次 `fetch` 是浏览器端请求**同源**的 `/dsh-workplan/plans`。
157
+ - **面板数据要登录**:该路由走 DSH 自己的鉴权,未登录直接返回 401。
158
+ - **图表库是本地自带**:`vendor/chart.umd.js`(Chart.js 4.6.1,MIT)随包分发,不加载任何 CDN 脚本。
159
+
160
+ 自己复核:
161
+
162
+ ```bash
163
+ npm view dsh-workplan@latest dependencies # 应为空
164
+ grep -RInE "writeFileSync|child_process|eval\(" src # 应无命中
165
+ npm audit --omit=dev
166
+ ```
167
+
168
+ <details>
169
+ <summary><b>1.5.0 改了什么(进度一眼可见)</b>(点开看)</summary>
170
+
171
+ 1.5.0 只改展示层:把计划卡折叠态那行「本计划 0/8 做好了 + 一根 54×5px 的小条」换成图表组合。
172
+
173
+ | 位置 | 改前 | 改后 |
174
+ |---|---|---|
175
+ | 折叠中的计划卡 | 12px 灰字 + 迷你条 + 「0 卡住了」;百分比只在鼠标悬停的 `title` 里 | 44px 环形图 + 24px 百分比 + `本计划 X/Y 做好了` + 一行「现在在做什么」(卡住优先,带任务名)+ 8px 四段构成条 + 状态图例 + 阶段步进条 |
176
+ | 展开后的面板 | 一根计划级进度条 | 「分步进度」:每个阶段一行(名称、`完成/总数`、细条、状态),外加加权总体进度 |
177
+ | 0% 的计划 | 迷你条填充宽度为 0,轨道又与卡片底色用同一个 token,等于没有图 | 四层信号:加粗的环轨、24px「0%」、整条灰色的「还没开始」构成条、虚线阶段槽 + 当前阶段描边 |
178
+ | 0 个工作项的组头 | `未完成 0 / 已完成 0(完成率暂无数据)` | 整句删除,只留环上的 `—`;组内空态仍在(展开可见) |
179
+
180
+ 「卡住了」这类数字一个都没少,只是换了呈现:图例始终是 `做好了 / 正在做 / 卡住了 / 还没开始` 四项带数字。
181
+
182
+ **怎么看到效果**:插件的前端在 `client.js` 里,DSH Web 进程启动时加载它,所以先重启 DSH Web,再刷新 <http://127.0.0.1:3080>。不想改环境也能离线看对比:打开 [docs/preview/progress-visual-1.5.0.html](docs/preview/progress-visual-1.5.0.html)(`npm run preview` 可重新生成,它用同一份 CSS 渲染 1.4.3 与 1.5.0 的卡头)。
183
+
184
+ 没有新增依赖,`plan.ts` / `runtime.ts` 无改动;回滚方式见 [CHANGELOG.md](CHANGELOG.md)。
185
+
186
+ </details>
187
+
188
+ <details>
189
+ <summary><b>1.4.3 修了什么(为什么值得升级)</b>(点开看)</summary>
190
+
191
+ 1.4.3 是一次**计数一致性**修复:插件曾同时维护「实时任务状态」和「缓存的统计快照」两份真相,导致面板数字和实际状态对不上(截图里「0 个正在做」但下面有任务正在做,就是它)。
192
+
193
+ | 缺陷 | 表现 | 根因 |
194
+ |---|---|---|
195
+ | D1 | 面板数字长时间不更新 | 统计只在整批子 Agent 跑完后才重算,运行期间冻结 |
196
+ | D2 | 同一份数据里两个数字互相矛盾 | 计数来自缓存,部门聚合来自实时状态 |
197
+ | D3 | 「还没开始」的任务却显示 100%、带着上一次的执行者 | 预算重置绕过了状态机,旧字段没清 |
198
+ | D4 | 同一类失败,进度有时 100 有时 0 | 两处代码对「卡住」的进度语义不一致 |
199
+
200
+ 修法是**删掉缓存快照,只保留一份状态源**:所有数字在序列化时由同一函数现场派生,并配了 7 条不变量 + 变异测试防止回退。完整报告:[docs/fix-report-derived-counts-1.4.3.md](docs/fix-report-derived-counts-1.4.3.md)。
201
+
202
+ </details>
203
+
204
+ ## 常见问题
205
+
206
+ **装完没反应?**
207
+ 先重启 DSH Web;再确认 `~/.dsh/profiles/web/package.json` 的依赖里有 `dsh-workplan`。
208
+
209
+ **面板一直是空的?**
210
+ 面板只显示**当前会话**的计划。换一个会话、或这个会话还没产生计划时是空的,这是正常的。
211
+
212
+ **数字和以前不一样了?**
213
+ 1.4.3 之后数字来自真实状态而不是缓存,所以会比旧版本「更小、但更准」(旧版本的完成率经常虚高)。
214
+
215
+ **子 Agent 卡住不动?**
216
+ 5 分钟没有任何新事件会被判定卡住并单独标红;对主 Agent 说「续跑这个计划」即可从受阻处继续。
217
+
218
+ ## 卸载
219
+
220
+ ```bash
221
+ dsh plugin --profile web remove dsh-workplan
222
+ ```
223
+
224
+ ## 开发与验证
225
+
226
+ ```bash
227
+ npm ci
228
+ npm run check # tsc --noEmit
229
+ npm test # 全部测试(数量随版本变化,以命令输出与 CI 为准),含计数不变量与进度图表用例
230
+ npm run build # 编译 src/*.ts → lib/*.js、client.js
231
+ npm run preview # 重新生成 docs/preview 里的 1.4.3 / 1.5.0 卡头对比页
232
+ ```
233
+
234
+ `lib/` 与 `client.js` 是**提交进仓库的构建产物**,CI 会重建并校验二者无差异。
235
+
236
+ ## 许可证
237
+
238
+ MIT,见 [LICENSE](LICENSE)。Chart.js 亦为 MIT。
239
+
240
+ ---
241
+
242
+ **English (US) — plain-language guide:** [README.en.md](README.en.md)
@@ -0,0 +1,7 @@
1
+ # dsh-workplan v2.3.0
2
+
3
+ 专家执行时间机制优化:预估上报→告知用户;超时放宽→告知专家最新时限与「保证质量高效率执行」;二次超时主 Agent 接手,已完成产物只读保护禁止丢弃。
4
+
5
+ - tag: v2.3.0
6
+ - date: 2026-11-10
7
+ - npm: https://www.npmjs.com/package/dsh-workplan/v/2.3.0
@@ -0,0 +1,48 @@
1
+ # 发布记录 v2.2.9(2026-11-10)
2
+
3
+ 按 RELEASING.md §6 留档:所有证据可复跑。
4
+
5
+ ## 1. 版本与提交
6
+
7
+ | 项 | 值 |
8
+ |---|---|
9
+ | 版本 | 2.2.9(四处一致:package.json / package-lock×2 / src/host.ts / CHANGELOG 首段;version-sync 测试随全量绿) |
10
+ | 发布提交 | `b341db9`(main 已推送) |
11
+ | 标签 | `v2.2.9`(已推送) |
12
+ | 内容 | 红字复发族治本:收束类计时器分类去 unref(存活恰 3 处卫生类白名单)+ EVIDENCE_MISSING 有界回喂与盘上结算备份 + 防回归四件套(handle-policy 守卫/全局测试锚/run-tests cancelled===0 硬断言/CI node22+26 双矩阵) |
13
+
14
+ ## 2. 发布前检查(RELEASING §1)
15
+
16
+ - `npm run check` exit 0;`npm test` 全量 exit 0(失败面仅 version-sync 两处版本声明,同步后绿)。
17
+ - W5 跨版本 A/B 探针(打 tag 前):`RESULT: PASS`。
18
+ - 构建可复现:提交后 `npm run build && git diff --exit-code -- lib client.js` = **REPRO_CLEAN**。
19
+
20
+ ## 3. 渠道与制品
21
+
22
+ | 渠道 | 结果 | 证据(16:38 实测) |
23
+ |---|---|---|
24
+ | GitHub | `b341db9` + tag `v2.2.9` | CI verify(node 22+26 双矩阵)= **completed success**(双矩阵首次生产实证) |
25
+ | GitHub Release | https://github.com/abbaababa/dsh-workplan/releases/tag/v2.2.9 | 资产 `dsh-workplan-2.2.9.tgz`,sha256 `f46f6f5601ee889f5f53c5b248933443bc7bad3d12a1c54aefe6f86cb596840b`(本地打包即该值,打包源=干净克隆 v2.2.9) |
26
+ | npm | `+ dsh-workplan@2.2.9` | registry `dist-tags.latest = 2.2.9` 实测 |
27
+ | 索引源 | PR [awesome-dsh-plugin#13893](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/13893) OPEN,tarball 指 v2.2.9 | 前序 #13802 **已被上游合并**(mergedAt 2026-11-10T07:00:21Z,条目当时升至 v2.2.8);#13893 合并+上游 CI 发版后索引升至 2.2.9 |
28
+
29
+ ## 4. 运行态指纹(§6.1)
30
+
31
+ - 运行态实测(16:39,`dsh_workplan_status`):**v2.2.8|build 54a0e5295d0aa712|pid 822|启动 16:19:41**。
32
+ - 磁盘复刻(完整字节算法):`cat lib/host.js lib/runtime.js lib/plan.js lib/watchdog.js | shasum -a 256 | cut -c1-16` = **`88cae5ee10476b8b`**(v2.2.9 lib,16:38 实测)。
33
+ - 判定:**运行态≠磁盘属预期时序**——用户进程 16:19:41 启动,当时磁盘版本声明仍是 2.2.8(bump 发生在 16:3x),加载的就是当时的正确字节;2.2.9 lib 于其启动之后重建。不存在"重启未生效"故障。
34
+ - **待用户再手工重启一次后**,比对运行态 build=`88cae5ee10476b8b`、v=`2.2.9` 即判「2.2.9 已加载」;相同前不得宣称修复在运行态生效。
35
+
36
+ ## 5. 版本显示问答(用户 16:26 问题留档)
37
+
38
+ 「已重启但插件版本还是显示 2.2.8,正常吗?」——正常:①上一轮修复提交未 bump 版本(发版待用户决定),磁盘=2.2.8,重启后运行态=磁盘=2.2.8,三者一致说明加载链路健康;②本轮 2.2.9 发布后,需再次重启才见新版本(进程不会热载磁盘新字节)。
39
+
40
+ ## 6. 复验命令
41
+
42
+ ```bash
43
+ npm view dsh-workplan@latest version # = 2.2.9(已实测)
44
+ gh run list --repo abbaababa/dsh-workplan --commit b341db9 # completed success(双矩阵)
45
+ gh pr view 13893 --repo awesome-dsh-plugin/awesome-dsh-plugin --json state
46
+ curl -s https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json | grep -o '"id":"dsh-workplan"' # #13893 合并+上游发版后
47
+ cat lib/host.js lib/runtime.js lib/plan.js lib/watchdog.js | shasum -a 256 | cut -c1-16 # = 运行态回显即 2.2.9 已加载
48
+ ```
package/lib/host.js CHANGED
@@ -109,6 +109,12 @@ const PROMPT_SECTION = [
109
109
  * (上方 1.8.7/1.8.13 注释)全部保留,不删。
110
110
  */
111
111
  '7. 子任务的时间是「协商上限」+「安全兜底」,不是固定交付期限:规模参考 15 分钟量级(仅供参考、非承诺,实际时长由执行专家开工预告协商决定),整轮预算(默认 20 分钟)同样只是安全兜底,不是交付期限。子 Agent 接近上限时应先把已完成内容落盘并在结论里列出路径。任何「达到协商上限」「本轮预算用尽」都不等于「什么都没做」:状态里的 error 会列出「声明产物已在盘上」,必须先用文件核对;若产物已覆盖验收标准,用 dsh_workplan_update 复核改判,只补缺失部分再续跑,禁止无视盘上产物把整步重跑。确认需要更多时间时,主 Agent 可用 dsh_workplan_update 的 extendMs 协商放宽(放宽永远有界:累计超过初始协商上限的一倍即拒绝,转新轮续跑或转 escalate 请主 Agent/用户裁决)。',
112
+ /*
113
+ * [2.3.0][T1] 专家执行时间机制三条款(用户 2026-11-10 要求 1/2 的主 Agent 侧义务):
114
+ * 预估上报后必须转告用户;第 1 次超时必须放宽并告知专家(插件自动投递最新时限
115
+ * 与质量效率要求);第 2 次超时由主 Agent 接手,已完成部分只读保护、禁止丢弃。
116
+ */
117
+ '7a. [2.3.0] 专家时间机制:专家开工预告(timeNotice/【专家预估上报】通知)到达后,必须把该预估执行时间告知用户;专家第一次超时(【执行中断】通知与状态行 timeoutCount=1)时,必须用 extendMs 放宽——延期成功后插件自动把最新执行时限与「必须在保证工作质量的前提下高效率执行」告知专家,回执 childNotified=false 时用 dsh_workplan_followup 补发;同一子任务第二次超时(timeoutCount≥2,takeoverRequired=true)后不再重派专家,由主 Agent 直接接手:只继续 takeoverBrief.remainingOutputs 与未满足的验收,专家已完成产物已登记为只读保护(landedRefs 并入 artifacts,只增不减),禁止丢弃、禁止删除或覆盖、禁止整步重跑。',
112
118
  '8. 出现「待指示」项(closure=escalated,左侧栏显示「待指示」并附问题摘录)时,必须在当轮处理:用 dsh_workplan_instruct 下发决定(投递到子会话并把该行恢复为执行中),或确认放弃后用 dsh_workplan_update 置 blocked。不要沉默略过,也不要把待指示当成普通失败——它是一条还没被回答的请示,会一直占着交付门禁。',
113
119
  '9. 出现「已下发未响应」(ackOverdue)时,不要重复派发:先用 dsh_workplan_status 看该行 childId 与已等待时长,必要时用 dsh_workplan_followup 投递一次说明;超过硬超时仍未响应会记为 blocked(blockedKind=no-ack),可以再下发指示复活。',
114
120
  /*
@@ -171,6 +177,8 @@ function createUpdateTool(runtime) {
171
177
  + '把子任务标成 done 时,必须同时给出真实的 verification 与 acceptance(每项 result="pass"),'
172
178
  + '否则计划不会变成可交付状态(deliveryReady=false,present 会被拒绝)。'
173
179
  + '运行中的子任务需要更多时间时,传 extendMs(毫秒)即可协商放宽,不需要 force;放宽永远有界(累计 ≤ 初始协商上限 × 1),超出转新轮续跑或转 escalate 请主 Agent 裁决。'
180
+ + '[2.3.0] 延期成功后插件自动向执行中的专家投递最新执行时限与「保证质量、高效率执行」要求(回执 childNotified);'
181
+ + '同一子任务第二次超时自动置 takeoverRequired,由主 Agent 接手未完成部分,已完成产物只读保护、禁止丢弃。'
174
182
  + '这些字段会写入会话日志,刷新/重启后仍然生效。',
175
183
  parameters: {
176
184
  type: 'object',
@@ -271,7 +279,8 @@ function createUpdateTool(runtime) {
271
279
  type: 'integer',
272
280
  description: '延期毫秒数(正整数,仅主 Agent 可用):只推移本子任务的协商截止并重置计时,'
273
281
  + '不改状态判定;运行中可用,不需要 force。除非另传 status,否则可省略 status。'
274
- + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。',
282
+ + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。'
283
+ + '[2.3.0] 延期成功后插件自动告知专家最新执行时限(含保证质量、高效率执行要求);每次超时计一行内 timeoutCount,第二次触发 takeoverRequired(主 Agent 接手,已完成部分只读保护)。',
275
284
  },
276
285
  /*
277
286
  * [2.2.0][T5/O-4c] O-2a 专家开工预告:{declaredMinutes, reason}。与 extendMs
@@ -279,7 +288,8 @@ function createUpdateTool(runtime) {
279
288
  */
280
289
  timeNotice: {
281
290
  type: 'object',
282
- description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。',
291
+ description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。'
292
+ + '[2.3.0] 落档后插件立即向主会话推送【专家预估上报】通知,提醒主 Agent 把该预期执行时间告知用户。',
283
293
  properties: {
284
294
  declaredMinutes: { type: 'number', description: '预计完成本子任务的分钟数(仅供参考、非承诺)。' },
285
295
  reason: { type: 'string', description: '预告理由(可选)。' },
@@ -1442,7 +1452,7 @@ export function apply(ctx, config = {}) {
1442
1452
  }
1443
1453
  export const meta = {
1444
1454
  name,
1445
- version: '2.2.9',
1455
+ version: '2.3.0',
1446
1456
  promptOrder: PROMPT_ORDER,
1447
1457
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1448
1458
  };
package/lib/plan.js CHANGED
@@ -4566,6 +4566,17 @@ export function resetBlockedStatuses(statuses) {
4566
4566
  */
4567
4567
  if (item?.closure === 'escalated' || item?.closure === 'instructed')
4568
4568
  continue;
4569
+ /*
4570
+ * [2.3.0][T1] 二次超时 = 主 Agent 接手,不再把专家重派一遍。
4571
+ *
4572
+ * 用户要求 2:预估时间超时两次后由主 Agent 接手尚未完成的事,且禁止丢弃
4573
+ * 专家已完成部分。若续跑把这行重置为 pending 重派,等于让新专家从零重做、
4574
+ * 绕开 takeoverBrief 的只读保护——这里直接跳过:行保持 blocked,
4575
+ * takeoverRequired/takeoverBrief/artifacts 保护登记原样保留,由主 Agent
4576
+ * 用 dsh_workplan_update 复核改判(只补缺口)或人工裁决后离开该状态。
4577
+ */
4578
+ if (item?.takeoverRequired === true)
4579
+ continue;
4569
4580
  next = applyStatus(next, item.subtaskId, {
4570
4581
  status: 'pending',
4571
4582
  progress: 0,
@@ -4866,6 +4877,16 @@ leadAgentId = '', leadAgentIdSource = 'none', }) {
4866
4877
  : []),
4867
4878
  // [T3 扩展点·T6] 供 T6 在此行之后追加「完成即时通知」条款(O-1a 插件兜底通道语义);上方三条款为 O-1a①+O-2a+O-4a 合并协议段(矩阵 Z1),既有条款不得删改。
4868
4879
  // [2.2.0][T6/O-1a] 完成即时通知条款(插件兜底通道):完成即报是第一通道(见上方「完成即回报」);插件另设兜底——子任务结算成功后立即向主会话推送一条含子任务 ID、摘要、验收计数与用时的即时通知,不等待整轮结束。兜底不替代主动回报。
4880
+ /*
4881
+ * [2.3.0][T1] 超时放宽告知与二次超时接手条款(用户 2026-11-10 要求 1/2):
4882
+ * 预告会由插件自动转告主 Agent「请把预期时间告知用户」;超时后主 Agent
4883
+ * 放宽时插件会把最新执行时限推送给你;连续两次超时改由主 Agent 接手,
4884
+ * 因此专家任何时候都要把已完成内容及时落盘并在回报中列路径——已完成部分
4885
+ * 会被登记为只读保护,禁止被丢弃。以下既有条款零删改。
4886
+ */
4887
+ '- 预估上报会被插件即时转告主 Agent(含「请把此预期执行时间告知用户」提示),主 Agent 会把你报的预估时间告知用户,让双方都有准备。',
4888
+ '- 超时后主 Agent 放宽时,插件会向你的会话推送【延期告知】:内含最新执行时间与剩余余量,并要求你在保证工作质量的前提下高效率执行——收到通知继续当前工作,不要重新开始;已完成内容及时落盘。',
4889
+ '- 连续两次超时后本行转为「主 Agent 接手」(takeoverRequired):你已完成的产物会被登记为只读保护(禁止丢弃),主 Agent 只继续未完成部分;所以每个阶段都要及时落盘并在回报中列出已完成路径。',
4869
4890
  '',
4870
4891
  '遇阻上报(强制,先于继续动作):',
4871
4892
  '- 出现以下任一情况,第一动作是上报,不是猜测、绕过或静默继续:缺少权限/输入/依赖产物;需求自相矛盾;无法验证;同一命令连续两次失败;需要主 Agent 决定方向。',
package/lib/runtime.js CHANGED
@@ -2576,6 +2576,105 @@ export function extendDeadline(record, subtaskId, extendMs, meta = {}) {
2576
2576
  record.updatedAt = Date.now();
2577
2577
  return { ok: true, deadlineAt, timerRearmed: true, watchdogRearmed: Boolean(handle.watchdog) };
2578
2578
  }
2579
+ /*
2580
+ * [2.3.0][T1] 专家执行时间机制 v2.3.0(用户 2026-11-10 四项要求,全链路):
2581
+ * (a) 预估上报 → 告知用户:recordTimeNotice 落档后向主会话推送「请把预期用时
2582
+ * 转告用户」的即时通知;
2583
+ * (b) 超时 → 放宽 → 告知专家:延期事务成功后把最新执行时限推送给执行中的专家
2584
+ * 子会话,并附「必须在保证工作质量的前提下高效率执行」硬要求;
2585
+ * (c) 二次超时 → 主 Agent 接手:runSubtaskAttempt 的到点收束对每行计数
2586
+ * (timeoutCount),第二次超时置 takeoverRequired,并用 buildTakeoverBrief
2587
+ * 登记专家已完成产物、mergePreservedArtifacts 做「禁止丢弃已完成部分」的
2588
+ * 只读保护合并。
2589
+ * 向后兼容:全部走 StatusEntry 未知字段直写通道(与 deadlineAt/timeJournal
2590
+ * 同族),回放白名单同步透传;不改任何既有判定与既有字段语义。
2591
+ */
2592
+ export const TAKEOVER_AFTER_TIMEOUTS = 2;
2593
+ /**
2594
+ * [2.3.0][T1] 组装「主 Agent 接手包」:已完成部分(专家已落盘产物 + 已登记
2595
+ * artifacts)逐条快照,未完成部分按 outputs 反推。instruction 是硬约束文案:
2596
+ * 禁止丢弃已完成部分——接手只补缺口,不整步重跑、不删除或覆盖专家产物。
2597
+ */
2598
+ export function buildTakeoverBrief(subtask, row, landedRefs, timeoutCount) {
2599
+ const refs = (Array.isArray(landedRefs) ? landedRefs : [])
2600
+ .map((item) => String(item ?? ''))
2601
+ .filter(Boolean)
2602
+ .slice(0, 20);
2603
+ const completedArtifacts = (Array.isArray(row?.artifacts) ? row.artifacts : [])
2604
+ .filter((item) => item?.kind === 'file' && typeof item?.ref === 'string' && item.ref)
2605
+ .map((item) => ({ kind: 'file', ref: item.ref, exists: item.exists !== false }))
2606
+ .slice(0, 20);
2607
+ const outputs = (Array.isArray(subtask?.outputs) ? subtask.outputs : [])
2608
+ .map((item) => String(item ?? ''))
2609
+ .filter(Boolean);
2610
+ const remainingOutputs = outputs.filter((ref) => !refs.includes(ref));
2611
+ return {
2612
+ at: Date.now(),
2613
+ timeoutCount: Number(timeoutCount) || 0,
2614
+ landedRefs: refs,
2615
+ completedArtifacts,
2616
+ remainingOutputs,
2617
+ instruction: '主 Agent 只接手未完成部分:landedRefs/completedArtifacts 是专家已'
2618
+ + '完成并登记保护的产物,只读、禁止丢弃、禁止删除或覆盖、禁止整步重跑;'
2619
+ + '仅继续 remainingOutputs 与未满足的验收标准。',
2620
+ };
2621
+ }
2622
+ /**
2623
+ * [2.3.0][T1] 「禁止丢弃已完成部分」的只读保护合并(A4 硬编码点):
2624
+ * 接手登记的保护清单(takeoverBrief.landedRefs)与行上 artifacts 取并集,
2625
+ * 只增不减——任何后续对 artifacts 的写入都不可能丢掉已完成部分。
2626
+ * 纯函数,可脱离宿主回归。
2627
+ */
2628
+ export function mergePreservedArtifacts(artifacts, preservedRefs) {
2629
+ const list = (Array.isArray(artifacts) ? artifacts : [])
2630
+ .filter((item) => item && typeof item === 'object' && typeof item.ref === 'string')
2631
+ .map((item) => ({ ...item }));
2632
+ const seen = new Set(list.map((item) => String(item.ref)));
2633
+ for (const rawRef of Array.isArray(preservedRefs) ? preservedRefs : []) {
2634
+ const ref = String(rawRef ?? '');
2635
+ if (!ref || seen.has(ref))
2636
+ continue;
2637
+ // 保护条目固定 kind:'file'/exists:true:登记发生在产物确认在盘的时刻。
2638
+ list.push({ kind: 'file', ref, exists: true, preservedByTakeover: true });
2639
+ seen.add(ref);
2640
+ }
2641
+ return list.slice(-40);
2642
+ }
2643
+ /**
2644
+ * [2.3.0][T1] 放宽成功后告知执行中的专家最新时限(A2 的「告知」半边)。
2645
+ * 走 ctx.subagents.sendMessage 与 follow-up 同一投递通道:运行中的子会话在下一
2646
+ * 步收到。投递失败不阻断延期事务(时限已经推移),只留档 record.errors。
2647
+ */
2648
+ async function notifyExpertOfExtension(ctx, agent, record, subtaskId, deadlineAt) {
2649
+ const row = Array.isArray(record?.statuses)
2650
+ ? record.statuses.find((item) => item?.subtaskId === subtaskId)
2651
+ : null;
2652
+ const childId = String(row?.childId ?? '');
2653
+ const service = ctx?.subagents;
2654
+ if (!childId) {
2655
+ return { ok: false, error: '该行没有活跃子会话(childId 缺失),专家续跑时可从状态行 deadlineAt 读取最新时限' };
2656
+ }
2657
+ if (!service || typeof service.sendMessage !== 'function') {
2658
+ return { ok: false, error: '当前部署没有可用的 subagent 服务,无法投递延期告知' };
2659
+ }
2660
+ const remainingMin = Math.max(1, Math.ceil((Number(deadlineAt) - Date.now()) / 60000));
2661
+ const text = `【dsh-workplan·延期告知】子任务 ${subtaskId} 的执行时限已由主 Agent 放宽:`
2662
+ + `最新执行时间为 ${new Date(Number(deadlineAt)).toISOString()}(约剩 ${remainingMin} 分钟)。`
2663
+ + '你必须在保证工作质量的前提下高效率执行:优先推进高价值步骤,已完成内容及时落盘,'
2664
+ + '并在回报中明确区分「已完成 / 未完成」。收到本通知后请继续当前工作,不要重新开始。';
2665
+ try {
2666
+ await service.sendMessage(agent, childId, [{ type: 'text', text }], {});
2667
+ if (row) {
2668
+ const journal = Array.isArray(row.timeJournal) ? row.timeJournal : [];
2669
+ journal.push({ at: Date.now(), action: 'notify-expert', deadlineAt: Number(deadlineAt), by: 'system' });
2670
+ row.timeJournal = journal.slice(-20);
2671
+ }
2672
+ return { ok: true };
2673
+ }
2674
+ catch (error) {
2675
+ return { ok: false, error: truncate(error instanceof Error ? error.message : String(error), 300) };
2676
+ }
2677
+ }
2579
2678
  /*
2580
2679
  * One attempt under a deadline that belongs to that attempt alone.
2581
2680
  *
@@ -2647,7 +2746,15 @@ async function runSubtaskAttempt(ctx, record, stage, subtask, options, timeoutMs
2647
2746
  // 续跑、人工裁决)。Reached only when the child ignored both its idle window
2648
2747
  // and its abort signal; the message says so, otherwise the cause looks like
2649
2748
  // a plain "too slow" and the next investigation goes down the wrong path.
2650
- const message = `子任务 ${subtask.id} 达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:请主 Agent 决定延期 / 重试 / 接受,或转新轮续跑、人工裁决)`;
2749
+ // [2.3.0][T1] 计数在组装文案前预读:第 1 次超时的文案要求「必须放宽并
2750
+ // 告知专家」;第 2 次及以后的文案要求「主 Agent 接手、已完成部分只读
2751
+ // 保护、禁止丢弃」。错误文本是结果消息/看板/续跑判定的共同来源,所以
2752
+ // 接手语义必须在这里就落进 message,而不是只进即时通知。
2753
+ const preRow = record.statuses.find((item) => item?.subtaskId === subtask.id);
2754
+ const timeoutCountAtFire = Number(preRow?.timeoutCount ?? 0) + 1;
2755
+ const message = timeoutCountAtFire >= TAKEOVER_AFTER_TIMEOUTS
2756
+ ? `子任务 ${subtask.id} 第 ${timeoutCountAtFire} 次达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:takeoverRequired——预估时间已两次超时,请主 Agent 直接接手完成尚未完成的部分;专家已完成并落盘的部分已登记只读保护,禁止丢弃、禁止整步重跑)`
2757
+ : `子任务 ${subtask.id} 第 ${timeoutCountAtFire} 次达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:请主 Agent 立即放宽(extendMs,放宽后插件自动告知专家最新时限与保证质量高效率要求)/ 重试 / 接受,或转新轮续跑、人工裁决)`;
2651
2758
  try {
2652
2759
  // [1.8.19] Keep the evidence of what already landed on disk.
2653
2760
  const { patch, landed } = timeoutBlockedPatch(subtask, options.cwd, message, options.artifactExists);
@@ -2680,6 +2787,41 @@ async function runSubtaskAttempt(ctx, record, stage, subtask, options, timeoutMs
2680
2787
  const settleRow = record.statuses.find((item) => item?.subtaskId === subtask.id);
2681
2788
  if (settleRow)
2682
2789
  settleRow.pendingAdjudication = true;
2790
+ /*
2791
+ * [2.3.0][T1] 超时计数与二次超时接手(用户要求 1/2 的机读落点):
2792
+ * 每次到点收束给状态行 timeoutCount +1 并记入 timeJournal(action:'timeout')。
2793
+ * 第 1 次超时 → 即时通知主 Agent「必须放宽(extendMs)并告知专家最新时限」,
2794
+ * 告知专家由延期事务自动投递(notifyExpertOfExtension);
2795
+ * 第 2 次超时 → takeoverRequired=true + buildTakeoverBrief 登记已完成部分,
2796
+ * mergePreservedArtifacts 把已落盘产物并入行 artifacts(只读保护、只增不减),
2797
+ * 主 Agent 接手只继续 remainingOutputs 与未满足验收,禁止丢弃已完成部分。
2798
+ * 计数走 StatusEntry 未知字段直写通道,回放白名单同步透传。
2799
+ */
2800
+ if (settleRow) {
2801
+ const timeoutCount = timeoutCountAtFire;
2802
+ settleRow.timeoutCount = timeoutCount;
2803
+ const timeoutJournal = Array.isArray(settleRow.timeJournal) ? settleRow.timeJournal : [];
2804
+ timeoutJournal.push({ at: Date.now(), action: 'timeout', timeoutCount, by: 'system' });
2805
+ settleRow.timeJournal = timeoutJournal.slice(-20);
2806
+ if (timeoutCount >= TAKEOVER_AFTER_TIMEOUTS) {
2807
+ // 禁止丢弃已完成部分:接手包 + artifacts 只增不减的并集合并。
2808
+ settleRow.takeoverRequired = true;
2809
+ settleRow.takeoverBrief = buildTakeoverBrief(subtask, settleRow, ceilingLanded, timeoutCount);
2810
+ settleRow.artifacts = mergePreservedArtifacts(settleRow.artifacts, settleRow.takeoverBrief.landedRefs);
2811
+ }
2812
+ try {
2813
+ const takeoverText = timeoutCount >= TAKEOVER_AFTER_TIMEOUTS
2814
+ ? `子任务 ${subtask.id} 已第 ${timeoutCount} 次达到协商时限(二次超时):按 2.3.0 机制本行已置「主 Agent 接手」(takeoverRequired)。`
2815
+ + `专家已完成并登记保护的部分(只读、禁止丢弃):${ceilingLanded.slice(0, 8).join('、') || '(见 takeoverBrief)'};`
2816
+ + '请主 Agent 直接接手继续未完成部分,不要整步重跑、不要删除或覆盖已登记产物。'
2817
+ : `子任务 ${subtask.id} 第 1 次达到协商时限:按 2.3.0 机制请主 Agent 尽快用 dsh_workplan_update(extendMs) 放宽,`
2818
+ + '延期成功后插件会自动把最新时限与「保证质量、高效率执行」要求告知专家;如判断无需再放宽,请接手继续未完成部分(已完成产物将只读保护)。';
2819
+ announceSubtaskInterrupt(record, options.session ?? options.agent?.session, subtask.id, takeoverText);
2820
+ }
2821
+ catch {
2822
+ // 通知失败不影响结算(与预警同一纪律)。
2823
+ }
2824
+ }
2683
2825
  record.updatedAt = Date.now();
2684
2826
  }
2685
2827
  catch (error) {
@@ -2920,6 +3062,23 @@ export function modelStatusLines(statuses) {
2920
3062
  timeWarning: item.timeWarning ?? null,
2921
3063
  timeJournal: Array.isArray(item.timeJournal) ? item.timeJournal.slice(-10) : [],
2922
3064
  pendingAdjudication: item.pendingAdjudication === true,
3065
+ // [2.3.0][T1] 预估上报(A1)也要进模型可读面:主 Agent 告知用户前先读这里。
3066
+ timeNotice: item.timeNotice ?? null,
3067
+ /*
3068
+ * [2.3.0][T1] 超时计数 / 二次超时接手进入模型可读面:主 Agent 一眼能看出
3069
+ * 该行第几次超时、是否必须接手、接手包里哪些是只读保护的已完成产物。
3070
+ */
3071
+ timeoutCount: Number(item.timeoutCount ?? 0),
3072
+ takeoverRequired: item.takeoverRequired === true,
3073
+ takeoverBrief: item.takeoverBrief ?? null,
3074
+ /*
3075
+ * [2.3.0][T1] 已完成产物的只读保护登记必须进模型可读面:statusTool 的行
3076
+ * 来自本函数,此前不序列化 artifacts,导致 takeoverRequired 的「禁止丢弃
3077
+ * 已完成部分」清单对主 Agent 不可见。只透出对象形条目,照录不改写。
3078
+ */
3079
+ artifacts: (Array.isArray(item.artifacts) ? item.artifacts : [])
3080
+ .filter((entry) => entry && typeof entry === 'object' && typeof entry.ref === 'string')
3081
+ .map((entry) => ({ ...entry })),
2923
3082
  /*
2924
3083
  * [2.2.0][T3/O-2a] 子→主预告通道的结论必须进入模型可读面。
2925
3084
  *
@@ -3854,7 +4013,7 @@ export function reconstructFromSession(session, targetPlanId) {
3854
4013
  const rebuiltRow = snap.statuses.find((item) => item?.subtaskId === entry?.subtaskId);
3855
4014
  if (!rebuiltRow || !isRecord(entry))
3856
4015
  continue;
3857
- for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication']) {
4016
+ for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication', 'timeoutCount', 'takeoverRequired', 'takeoverBrief']) {
3858
4017
  if (entry[field] !== undefined)
3859
4018
  rebuiltRow[field] = entry[field];
3860
4019
  }
@@ -4024,7 +4183,7 @@ export function reconstructFromSession(session, targetPlanId) {
4024
4183
  */
4025
4184
  const replayRow = snap.statuses.find((item) => item?.subtaskId === update.subtaskId);
4026
4185
  if (replayRow) {
4027
- for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication']) {
4186
+ for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication', 'timeoutCount', 'takeoverRequired', 'takeoverBrief']) {
4028
4187
  if (update[field] !== undefined)
4029
4188
  replayRow[field] = update[field];
4030
4189
  }
@@ -4628,7 +4787,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
4628
4787
  * 路由分支,按 T4 直写通道写行(StatusEntry 保留未知字段;回放白名单已透传
4629
4788
  * timeNotice,刷新后不丢)。
4630
4789
  */
4631
- function recordTimeNotice(record, subtaskId, notice) {
4790
+ function recordTimeNotice(record, subtaskId, notice, session) {
4632
4791
  const row = Array.isArray(record?.statuses)
4633
4792
  ? record.statuses.find((item) => item?.subtaskId === subtaskId)
4634
4793
  : null;
@@ -4652,6 +4811,24 @@ export function createWorkplanRuntime(ctx, options = {}) {
4652
4811
  });
4653
4812
  row.timeJournal = journal.slice(-20);
4654
4813
  record.updatedAt = at;
4814
+ /*
4815
+ * [2.3.0][T1] 预估上报 → 告知用户(用户要求 1 的前半段闭环):专家的开工
4816
+ * 预告落档后,插件立即向主会话推送一条即时通知,明确「请把此预期执行
4817
+ * 时间告知用户」;新预告覆盖旧预告(每条新预告各通知一次,与「开工预告」
4818
+ * 协议一致)。通知是观测设施:写失败只留档 errors,绝不影响记录与执行。
4819
+ */
4820
+ if (session) {
4821
+ try {
4822
+ appendUserMessage(session, `【dsh-workplan·专家预估上报】子任务 ${subtaskId} 的执行专家`
4823
+ + `预估执行时间 ${Number(notice?.declaredMinutes)} 分钟`
4824
+ + (reason ? `(${reason})` : '')
4825
+ + `;请把此预期执行时间告知用户。若执行中超时,请主 Agent 放宽(extendMs)`
4826
+ + '并告知专家最新时限,连续两次超时则由主 Agent 接手未完成部分(已完成产物只读保护,禁止丢弃)。');
4827
+ }
4828
+ catch (error) {
4829
+ record.errors = [...(record.errors ?? []), `${subtaskId} 预估上报通知写入失败:${truncate(String(error?.message ?? error), 200)}`].slice(-20);
4830
+ }
4831
+ }
4655
4832
  }
4656
4833
  async function updateStatus(agent, args) {
4657
4834
  const session = agent?.session;
@@ -4829,7 +5006,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
4829
5006
  * 指示失败不该留下一笔「专家已预告」的记录。
4830
5007
  */
4831
5008
  if (hasTimeNotice && instructed?.ok !== false)
4832
- recordTimeNotice(record, subtaskId, timeNoticeArg);
5009
+ recordTimeNotice(record, subtaskId, timeNoticeArg, session);
4833
5010
  return instructed;
4834
5011
  }
4835
5012
  if (current?.closure === 'escalated') {
@@ -4896,10 +5073,18 @@ export function createWorkplanRuntime(ctx, options = {}) {
4896
5073
  };
4897
5074
  }
4898
5075
  extension = extended;
5076
+ /*
5077
+ * [2.3.0][T1] 用户要求 1 后半段:放宽成功后必须把「最新执行时间」告知
5078
+ * 专家,同时附「必须在保证工作质量的前提下高效率执行」硬要求,让专家
5079
+ * 有准备(收到通知继续当前工作,不重新开始)。投递失败不回滚延期——
5080
+ * 时限已经推移,只是告知通道未达:留档 errors,回执带 childNotified
5081
+ * 供主 Agent 决定是否用 dsh_workplan_followup 补发。
5082
+ */
5083
+ extension.childNotified = (await notifyExpertOfExtension(ctx, agent, record, subtaskId, extension.deadlineAt)).ok;
4899
5084
  }
4900
5085
  if (!statusRequested) {
4901
5086
  if (hasTimeNotice)
4902
- recordTimeNotice(record, subtaskId, timeNoticeArg);
5087
+ recordTimeNotice(record, subtaskId, timeNoticeArg, session);
4903
5088
  /*
4904
5089
  * 纯时限事务到此结束。方案 §2.2 效果 3:状态行 revision +1(延期/预告也是
4905
5090
  * 行变更,同样受 STALE_WRITE 乐观锁保护);状态与判定一个字段都不改。
@@ -4925,6 +5110,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
4925
5110
  deadlineAt: extension.deadlineAt,
4926
5111
  timerRearmed: extension.timerRearmed,
4927
5112
  watchdogRearmed: extension.watchdogRearmed,
5113
+ childNotified: extension.childNotified === true,
4928
5114
  }
4929
5115
  : {}),
4930
5116
  ...(hasTimeNotice ? { timeNotice: written?.timeNotice ?? null } : {}),
@@ -4972,12 +5158,25 @@ export function createWorkplanRuntime(ctx, options = {}) {
4972
5158
  revision,
4973
5159
  updatedBy: 'agent',
4974
5160
  });
5161
+ /*
5162
+ * [2.3.0][T1] 禁止丢弃已完成部分(A4 的第二个硬编码保护点):接手行
5163
+ * (takeoverRequired)后续任何一次 artifacts 写入,都把 takeoverBrief 登记
5164
+ * 的保护产物并集合并回来——只增不减,主 Agent 改判时不可能删掉专家已完成
5165
+ * 的产物清单,只能在其基础上补缺口。
5166
+ */
5167
+ if (args?.artifacts !== undefined) {
5168
+ const protectedRow = record.statuses.find((item) => item?.subtaskId === subtaskId);
5169
+ if (protectedRow?.takeoverRequired === true && Array.isArray(protectedRow?.takeoverBrief?.landedRefs)
5170
+ && protectedRow.takeoverBrief.landedRefs.length > 0) {
5171
+ protectedRow.artifacts = mergePreservedArtifacts(protectedRow.artifacts, protectedRow.takeoverBrief.landedRefs);
5172
+ }
5173
+ }
4975
5174
  /*
4976
5175
  * [2.2.0][T5/O-4c] 带 status 的调用同时带 timeNotice 时,预告记录在改判落行
4977
5176
  * 之后写入:applyStatus 抛错(如非法 verification)时不会留下半写的预告。
4978
5177
  */
4979
5178
  if (hasTimeNotice)
4980
- recordTimeNotice(record, subtaskId, timeNoticeArg);
5179
+ recordTimeNotice(record, subtaskId, timeNoticeArg, session);
4981
5180
  if (status === 'blocked') {
4982
5181
  record.statuses = markDependentsBlocked(record.plan, record.statuses, subtaskId, { reason: summary || '主 Agent 标记受阻' });
4983
5182
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-workplan",
3
- "version": "2.2.9",
3
+ "version": "2.3.0",
4
4
  "description": "Automatic task decomposition, real department subagents, and a responsive workplan dashboard for DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/src/host.ts CHANGED
@@ -118,6 +118,12 @@ const PROMPT_SECTION = [
118
118
  * (上方 1.8.7/1.8.13 注释)全部保留,不删。
119
119
  */
120
120
  '7. 子任务的时间是「协商上限」+「安全兜底」,不是固定交付期限:规模参考 15 分钟量级(仅供参考、非承诺,实际时长由执行专家开工预告协商决定),整轮预算(默认 20 分钟)同样只是安全兜底,不是交付期限。子 Agent 接近上限时应先把已完成内容落盘并在结论里列出路径。任何「达到协商上限」「本轮预算用尽」都不等于「什么都没做」:状态里的 error 会列出「声明产物已在盘上」,必须先用文件核对;若产物已覆盖验收标准,用 dsh_workplan_update 复核改判,只补缺失部分再续跑,禁止无视盘上产物把整步重跑。确认需要更多时间时,主 Agent 可用 dsh_workplan_update 的 extendMs 协商放宽(放宽永远有界:累计超过初始协商上限的一倍即拒绝,转新轮续跑或转 escalate 请主 Agent/用户裁决)。',
121
+ /*
122
+ * [2.3.0][T1] 专家执行时间机制三条款(用户 2026-11-10 要求 1/2 的主 Agent 侧义务):
123
+ * 预估上报后必须转告用户;第 1 次超时必须放宽并告知专家(插件自动投递最新时限
124
+ * 与质量效率要求);第 2 次超时由主 Agent 接手,已完成部分只读保护、禁止丢弃。
125
+ */
126
+ '7a. [2.3.0] 专家时间机制:专家开工预告(timeNotice/【专家预估上报】通知)到达后,必须把该预估执行时间告知用户;专家第一次超时(【执行中断】通知与状态行 timeoutCount=1)时,必须用 extendMs 放宽——延期成功后插件自动把最新执行时限与「必须在保证工作质量的前提下高效率执行」告知专家,回执 childNotified=false 时用 dsh_workplan_followup 补发;同一子任务第二次超时(timeoutCount≥2,takeoverRequired=true)后不再重派专家,由主 Agent 直接接手:只继续 takeoverBrief.remainingOutputs 与未满足的验收,专家已完成产物已登记为只读保护(landedRefs 并入 artifacts,只增不减),禁止丢弃、禁止删除或覆盖、禁止整步重跑。',
121
127
  '8. 出现「待指示」项(closure=escalated,左侧栏显示「待指示」并附问题摘录)时,必须在当轮处理:用 dsh_workplan_instruct 下发决定(投递到子会话并把该行恢复为执行中),或确认放弃后用 dsh_workplan_update 置 blocked。不要沉默略过,也不要把待指示当成普通失败——它是一条还没被回答的请示,会一直占着交付门禁。',
122
128
  '9. 出现「已下发未响应」(ackOverdue)时,不要重复派发:先用 dsh_workplan_status 看该行 childId 与已等待时长,必要时用 dsh_workplan_followup 投递一次说明;超过硬超时仍未响应会记为 blocked(blockedKind=no-ack),可以再下发指示复活。',
123
129
  /*
@@ -233,6 +239,8 @@ function createUpdateTool(runtime: any) {
233
239
  + '把子任务标成 done 时,必须同时给出真实的 verification 与 acceptance(每项 result="pass"),'
234
240
  + '否则计划不会变成可交付状态(deliveryReady=false,present 会被拒绝)。'
235
241
  + '运行中的子任务需要更多时间时,传 extendMs(毫秒)即可协商放宽,不需要 force;放宽永远有界(累计 ≤ 初始协商上限 × 1),超出转新轮续跑或转 escalate 请主 Agent 裁决。'
242
+ + '[2.3.0] 延期成功后插件自动向执行中的专家投递最新执行时限与「保证质量、高效率执行」要求(回执 childNotified);'
243
+ + '同一子任务第二次超时自动置 takeoverRequired,由主 Agent 接手未完成部分,已完成产物只读保护、禁止丢弃。'
236
244
  + '这些字段会写入会话日志,刷新/重启后仍然生效。',
237
245
  parameters: {
238
246
  type: 'object',
@@ -333,7 +341,8 @@ function createUpdateTool(runtime: any) {
333
341
  type: 'integer',
334
342
  description: '延期毫秒数(正整数,仅主 Agent 可用):只推移本子任务的协商截止并重置计时,'
335
343
  + '不改状态判定;运行中可用,不需要 force。除非另传 status,否则可省略 status。'
336
- + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。',
344
+ + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。'
345
+ + '[2.3.0] 延期成功后插件自动告知专家最新执行时限(含保证质量、高效率执行要求);每次超时计一行内 timeoutCount,第二次触发 takeoverRequired(主 Agent 接手,已完成部分只读保护)。',
337
346
  },
338
347
  /*
339
348
  * [2.2.0][T5/O-4c] O-2a 专家开工预告:{declaredMinutes, reason}。与 extendMs
@@ -341,7 +350,8 @@ function createUpdateTool(runtime: any) {
341
350
  */
342
351
  timeNotice: {
343
352
  type: 'object',
344
- description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。',
353
+ description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。'
354
+ + '[2.3.0] 落档后插件立即向主会话推送【专家预估上报】通知,提醒主 Agent 把该预期执行时间告知用户。',
345
355
  properties: {
346
356
  declaredMinutes: { type: 'number', description: '预计完成本子任务的分钟数(仅供参考、非承诺)。' },
347
357
  reason: { type: 'string', description: '预告理由(可选)。' },
@@ -1571,7 +1581,7 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1571
1581
 
1572
1582
  export const meta = {
1573
1583
  name,
1574
- version: '2.2.9',
1584
+ version: '2.3.0',
1575
1585
  promptOrder: PROMPT_ORDER,
1576
1586
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1577
1587
  }
package/src/plan.ts CHANGED
@@ -4678,6 +4678,16 @@ export function resetBlockedStatuses(statuses: any) {
4678
4678
  * (给出指示改判 instructed,或明确放弃改判 blocked)后才离开这个状态。
4679
4679
  */
4680
4680
  if (item?.closure === 'escalated' || item?.closure === 'instructed') continue
4681
+ /*
4682
+ * [2.3.0][T1] 二次超时 = 主 Agent 接手,不再把专家重派一遍。
4683
+ *
4684
+ * 用户要求 2:预估时间超时两次后由主 Agent 接手尚未完成的事,且禁止丢弃
4685
+ * 专家已完成部分。若续跑把这行重置为 pending 重派,等于让新专家从零重做、
4686
+ * 绕开 takeoverBrief 的只读保护——这里直接跳过:行保持 blocked,
4687
+ * takeoverRequired/takeoverBrief/artifacts 保护登记原样保留,由主 Agent
4688
+ * 用 dsh_workplan_update 复核改判(只补缺口)或人工裁决后离开该状态。
4689
+ */
4690
+ if (item?.takeoverRequired === true) continue
4681
4691
  next = applyStatus(next, item.subtaskId, {
4682
4692
  status: 'pending',
4683
4693
  progress: 0,
@@ -4991,6 +5001,16 @@ export function buildChildPrompt({
4991
5001
  : []),
4992
5002
  // [T3 扩展点·T6] 供 T6 在此行之后追加「完成即时通知」条款(O-1a 插件兜底通道语义);上方三条款为 O-1a①+O-2a+O-4a 合并协议段(矩阵 Z1),既有条款不得删改。
4993
5003
  // [2.2.0][T6/O-1a] 完成即时通知条款(插件兜底通道):完成即报是第一通道(见上方「完成即回报」);插件另设兜底——子任务结算成功后立即向主会话推送一条含子任务 ID、摘要、验收计数与用时的即时通知,不等待整轮结束。兜底不替代主动回报。
5004
+ /*
5005
+ * [2.3.0][T1] 超时放宽告知与二次超时接手条款(用户 2026-11-10 要求 1/2):
5006
+ * 预告会由插件自动转告主 Agent「请把预期时间告知用户」;超时后主 Agent
5007
+ * 放宽时插件会把最新执行时限推送给你;连续两次超时改由主 Agent 接手,
5008
+ * 因此专家任何时候都要把已完成内容及时落盘并在回报中列路径——已完成部分
5009
+ * 会被登记为只读保护,禁止被丢弃。以下既有条款零删改。
5010
+ */
5011
+ '- 预估上报会被插件即时转告主 Agent(含「请把此预期执行时间告知用户」提示),主 Agent 会把你报的预估时间告知用户,让双方都有准备。',
5012
+ '- 超时后主 Agent 放宽时,插件会向你的会话推送【延期告知】:内含最新执行时间与剩余余量,并要求你在保证工作质量的前提下高效率执行——收到通知继续当前工作,不要重新开始;已完成内容及时落盘。',
5013
+ '- 连续两次超时后本行转为「主 Agent 接手」(takeoverRequired):你已完成的产物会被登记为只读保护(禁止丢弃),主 Agent 只继续未完成部分;所以每个阶段都要及时落盘并在回报中列出已完成路径。',
4994
5014
  '',
4995
5015
  '遇阻上报(强制,先于继续动作):',
4996
5016
  '- 出现以下任一情况,第一动作是上报,不是猜测、绕过或静默继续:缺少权限/输入/依赖产物;需求自相矛盾;无法验证;同一命令连续两次失败;需要主 Agent 决定方向。',
package/src/runtime.ts CHANGED
@@ -2663,6 +2663,107 @@ export function extendDeadline(record: any, subtaskId: any, extendMs: any, meta:
2663
2663
  return { ok: true, deadlineAt, timerRearmed: true, watchdogRearmed: Boolean(handle.watchdog) }
2664
2664
  }
2665
2665
 
2666
+ /*
2667
+ * [2.3.0][T1] 专家执行时间机制 v2.3.0(用户 2026-11-10 四项要求,全链路):
2668
+ * (a) 预估上报 → 告知用户:recordTimeNotice 落档后向主会话推送「请把预期用时
2669
+ * 转告用户」的即时通知;
2670
+ * (b) 超时 → 放宽 → 告知专家:延期事务成功后把最新执行时限推送给执行中的专家
2671
+ * 子会话,并附「必须在保证工作质量的前提下高效率执行」硬要求;
2672
+ * (c) 二次超时 → 主 Agent 接手:runSubtaskAttempt 的到点收束对每行计数
2673
+ * (timeoutCount),第二次超时置 takeoverRequired,并用 buildTakeoverBrief
2674
+ * 登记专家已完成产物、mergePreservedArtifacts 做「禁止丢弃已完成部分」的
2675
+ * 只读保护合并。
2676
+ * 向后兼容:全部走 StatusEntry 未知字段直写通道(与 deadlineAt/timeJournal
2677
+ * 同族),回放白名单同步透传;不改任何既有判定与既有字段语义。
2678
+ */
2679
+ export const TAKEOVER_AFTER_TIMEOUTS = 2
2680
+
2681
+ /**
2682
+ * [2.3.0][T1] 组装「主 Agent 接手包」:已完成部分(专家已落盘产物 + 已登记
2683
+ * artifacts)逐条快照,未完成部分按 outputs 反推。instruction 是硬约束文案:
2684
+ * 禁止丢弃已完成部分——接手只补缺口,不整步重跑、不删除或覆盖专家产物。
2685
+ */
2686
+ export function buildTakeoverBrief(subtask: any, row: any, landedRefs: any, timeoutCount: any) {
2687
+ const refs = (Array.isArray(landedRefs) ? landedRefs : [])
2688
+ .map((item: any) => String(item ?? ''))
2689
+ .filter(Boolean)
2690
+ .slice(0, 20)
2691
+ const completedArtifacts = (Array.isArray(row?.artifacts) ? row.artifacts : [])
2692
+ .filter((item: any) => item?.kind === 'file' && typeof item?.ref === 'string' && item.ref)
2693
+ .map((item: any) => ({ kind: 'file', ref: item.ref, exists: item.exists !== false }))
2694
+ .slice(0, 20)
2695
+ const outputs = (Array.isArray(subtask?.outputs) ? subtask.outputs : [])
2696
+ .map((item: any) => String(item ?? ''))
2697
+ .filter(Boolean)
2698
+ const remainingOutputs = outputs.filter((ref: string) => !refs.includes(ref))
2699
+ return {
2700
+ at: Date.now(),
2701
+ timeoutCount: Number(timeoutCount) || 0,
2702
+ landedRefs: refs,
2703
+ completedArtifacts,
2704
+ remainingOutputs,
2705
+ instruction: '主 Agent 只接手未完成部分:landedRefs/completedArtifacts 是专家已'
2706
+ + '完成并登记保护的产物,只读、禁止丢弃、禁止删除或覆盖、禁止整步重跑;'
2707
+ + '仅继续 remainingOutputs 与未满足的验收标准。',
2708
+ }
2709
+ }
2710
+
2711
+ /**
2712
+ * [2.3.0][T1] 「禁止丢弃已完成部分」的只读保护合并(A4 硬编码点):
2713
+ * 接手登记的保护清单(takeoverBrief.landedRefs)与行上 artifacts 取并集,
2714
+ * 只增不减——任何后续对 artifacts 的写入都不可能丢掉已完成部分。
2715
+ * 纯函数,可脱离宿主回归。
2716
+ */
2717
+ export function mergePreservedArtifacts(artifacts: any, preservedRefs: any) {
2718
+ const list = (Array.isArray(artifacts) ? artifacts : [])
2719
+ .filter((item: any) => item && typeof item === 'object' && typeof item.ref === 'string')
2720
+ .map((item: any) => ({ ...item }))
2721
+ const seen = new Set(list.map((item: any) => String(item.ref)))
2722
+ for (const rawRef of Array.isArray(preservedRefs) ? preservedRefs : []) {
2723
+ const ref = String(rawRef ?? '')
2724
+ if (!ref || seen.has(ref)) continue
2725
+ // 保护条目固定 kind:'file'/exists:true:登记发生在产物确认在盘的时刻。
2726
+ list.push({ kind: 'file', ref, exists: true, preservedByTakeover: true })
2727
+ seen.add(ref)
2728
+ }
2729
+ return list.slice(-40)
2730
+ }
2731
+
2732
+ /**
2733
+ * [2.3.0][T1] 放宽成功后告知执行中的专家最新时限(A2 的「告知」半边)。
2734
+ * 走 ctx.subagents.sendMessage 与 follow-up 同一投递通道:运行中的子会话在下一
2735
+ * 步收到。投递失败不阻断延期事务(时限已经推移),只留档 record.errors。
2736
+ */
2737
+ async function notifyExpertOfExtension(ctx: any, agent: any, record: any, subtaskId: string, deadlineAt: number) {
2738
+ const row = Array.isArray(record?.statuses)
2739
+ ? record.statuses.find((item: any) => item?.subtaskId === subtaskId)
2740
+ : null
2741
+ const childId = String(row?.childId ?? '')
2742
+ const service: any = ctx?.subagents
2743
+ if (!childId) {
2744
+ return { ok: false, error: '该行没有活跃子会话(childId 缺失),专家续跑时可从状态行 deadlineAt 读取最新时限' }
2745
+ }
2746
+ if (!service || typeof service.sendMessage !== 'function') {
2747
+ return { ok: false, error: '当前部署没有可用的 subagent 服务,无法投递延期告知' }
2748
+ }
2749
+ const remainingMin = Math.max(1, Math.ceil((Number(deadlineAt) - Date.now()) / 60000))
2750
+ const text = `【dsh-workplan·延期告知】子任务 ${subtaskId} 的执行时限已由主 Agent 放宽:`
2751
+ + `最新执行时间为 ${new Date(Number(deadlineAt)).toISOString()}(约剩 ${remainingMin} 分钟)。`
2752
+ + '你必须在保证工作质量的前提下高效率执行:优先推进高价值步骤,已完成内容及时落盘,'
2753
+ + '并在回报中明确区分「已完成 / 未完成」。收到本通知后请继续当前工作,不要重新开始。'
2754
+ try {
2755
+ await service.sendMessage(agent, childId, [{ type: 'text', text }], {})
2756
+ if (row) {
2757
+ const journal = Array.isArray(row.timeJournal) ? row.timeJournal : []
2758
+ journal.push({ at: Date.now(), action: 'notify-expert', deadlineAt: Number(deadlineAt), by: 'system' })
2759
+ row.timeJournal = journal.slice(-20)
2760
+ }
2761
+ return { ok: true }
2762
+ } catch (error: any) {
2763
+ return { ok: false, error: truncate(error instanceof Error ? error.message : String(error), 300) }
2764
+ }
2765
+ }
2766
+
2666
2767
  /*
2667
2768
  * One attempt under a deadline that belongs to that attempt alone.
2668
2769
  *
@@ -2740,7 +2841,15 @@ async function runSubtaskAttempt(
2740
2841
  // 续跑、人工裁决)。Reached only when the child ignored both its idle window
2741
2842
  // and its abort signal; the message says so, otherwise the cause looks like
2742
2843
  // a plain "too slow" and the next investigation goes down the wrong path.
2743
- const message = `子任务 ${subtask.id} 达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:请主 Agent 决定延期 / 重试 / 接受,或转新轮续跑、人工裁决)`
2844
+ // [2.3.0][T1] 计数在组装文案前预读:第 1 次超时的文案要求「必须放宽并
2845
+ // 告知专家」;第 2 次及以后的文案要求「主 Agent 接手、已完成部分只读
2846
+ // 保护、禁止丢弃」。错误文本是结果消息/看板/续跑判定的共同来源,所以
2847
+ // 接手语义必须在这里就落进 message,而不是只进即时通知。
2848
+ const preRow = record.statuses.find((item: any) => item?.subtaskId === subtask.id)
2849
+ const timeoutCountAtFire = Number(preRow?.timeoutCount ?? 0) + 1
2850
+ const message = timeoutCountAtFire >= TAKEOVER_AFTER_TIMEOUTS
2851
+ ? `子任务 ${subtask.id} 第 ${timeoutCountAtFire} 次达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:takeoverRequired——预估时间已两次超时,请主 Agent 直接接手完成尚未完成的部分;专家已完成并落盘的部分已登记只读保护,禁止丢弃、禁止整步重跑)`
2852
+ : `子任务 ${subtask.id} 第 ${timeoutCountAtFire} 次达到协商执行上限(${timeoutMs}ms),已按安全兜底结算(待裁决:请主 Agent 立即放宽(extendMs,放宽后插件自动告知专家最新时限与保证质量高效率要求)/ 重试 / 接受,或转新轮续跑、人工裁决)`
2744
2853
  try {
2745
2854
  // [1.8.19] Keep the evidence of what already landed on disk.
2746
2855
  const { patch, landed } = timeoutBlockedPatch(subtask, options.cwd, message, options.artifactExists)
@@ -2771,6 +2880,40 @@ async function runSubtaskAttempt(
2771
2880
  */
2772
2881
  const settleRow = record.statuses.find((item: any) => item?.subtaskId === subtask.id)
2773
2882
  if (settleRow) settleRow.pendingAdjudication = true
2883
+ /*
2884
+ * [2.3.0][T1] 超时计数与二次超时接手(用户要求 1/2 的机读落点):
2885
+ * 每次到点收束给状态行 timeoutCount +1 并记入 timeJournal(action:'timeout')。
2886
+ * 第 1 次超时 → 即时通知主 Agent「必须放宽(extendMs)并告知专家最新时限」,
2887
+ * 告知专家由延期事务自动投递(notifyExpertOfExtension);
2888
+ * 第 2 次超时 → takeoverRequired=true + buildTakeoverBrief 登记已完成部分,
2889
+ * mergePreservedArtifacts 把已落盘产物并入行 artifacts(只读保护、只增不减),
2890
+ * 主 Agent 接手只继续 remainingOutputs 与未满足验收,禁止丢弃已完成部分。
2891
+ * 计数走 StatusEntry 未知字段直写通道,回放白名单同步透传。
2892
+ */
2893
+ if (settleRow) {
2894
+ const timeoutCount = timeoutCountAtFire
2895
+ settleRow.timeoutCount = timeoutCount
2896
+ const timeoutJournal = Array.isArray(settleRow.timeJournal) ? settleRow.timeJournal : []
2897
+ timeoutJournal.push({ at: Date.now(), action: 'timeout', timeoutCount, by: 'system' })
2898
+ settleRow.timeJournal = timeoutJournal.slice(-20)
2899
+ if (timeoutCount >= TAKEOVER_AFTER_TIMEOUTS) {
2900
+ // 禁止丢弃已完成部分:接手包 + artifacts 只增不减的并集合并。
2901
+ settleRow.takeoverRequired = true
2902
+ settleRow.takeoverBrief = buildTakeoverBrief(subtask, settleRow, ceilingLanded, timeoutCount)
2903
+ settleRow.artifacts = mergePreservedArtifacts(settleRow.artifacts, settleRow.takeoverBrief.landedRefs)
2904
+ }
2905
+ try {
2906
+ const takeoverText = timeoutCount >= TAKEOVER_AFTER_TIMEOUTS
2907
+ ? `子任务 ${subtask.id} 已第 ${timeoutCount} 次达到协商时限(二次超时):按 2.3.0 机制本行已置「主 Agent 接手」(takeoverRequired)。`
2908
+ + `专家已完成并登记保护的部分(只读、禁止丢弃):${(ceilingLanded as string[]).slice(0, 8).join('、') || '(见 takeoverBrief)'};`
2909
+ + '请主 Agent 直接接手继续未完成部分,不要整步重跑、不要删除或覆盖已登记产物。'
2910
+ : `子任务 ${subtask.id} 第 1 次达到协商时限:按 2.3.0 机制请主 Agent 尽快用 dsh_workplan_update(extendMs) 放宽,`
2911
+ + '延期成功后插件会自动把最新时限与「保证质量、高效率执行」要求告知专家;如判断无需再放宽,请接手继续未完成部分(已完成产物将只读保护)。'
2912
+ announceSubtaskInterrupt(record, options.session ?? options.agent?.session, subtask.id, takeoverText)
2913
+ } catch {
2914
+ // 通知失败不影响结算(与预警同一纪律)。
2915
+ }
2916
+ }
2774
2917
  record.updatedAt = Date.now()
2775
2918
  } catch (error: any) {
2776
2919
  record.errors = [
@@ -3007,6 +3150,23 @@ export function modelStatusLines(statuses: any) {
3007
3150
  timeWarning: item.timeWarning ?? null,
3008
3151
  timeJournal: Array.isArray(item.timeJournal) ? item.timeJournal.slice(-10) : [],
3009
3152
  pendingAdjudication: item.pendingAdjudication === true,
3153
+ // [2.3.0][T1] 预估上报(A1)也要进模型可读面:主 Agent 告知用户前先读这里。
3154
+ timeNotice: item.timeNotice ?? null,
3155
+ /*
3156
+ * [2.3.0][T1] 超时计数 / 二次超时接手进入模型可读面:主 Agent 一眼能看出
3157
+ * 该行第几次超时、是否必须接手、接手包里哪些是只读保护的已完成产物。
3158
+ */
3159
+ timeoutCount: Number(item.timeoutCount ?? 0),
3160
+ takeoverRequired: item.takeoverRequired === true,
3161
+ takeoverBrief: item.takeoverBrief ?? null,
3162
+ /*
3163
+ * [2.3.0][T1] 已完成产物的只读保护登记必须进模型可读面:statusTool 的行
3164
+ * 来自本函数,此前不序列化 artifacts,导致 takeoverRequired 的「禁止丢弃
3165
+ * 已完成部分」清单对主 Agent 不可见。只透出对象形条目,照录不改写。
3166
+ */
3167
+ artifacts: (Array.isArray(item.artifacts) ? item.artifacts : [])
3168
+ .filter((entry: any) => entry && typeof entry === 'object' && typeof entry.ref === 'string')
3169
+ .map((entry: any) => ({ ...entry })),
3010
3170
  /*
3011
3171
  * [2.2.0][T3/O-2a] 子→主预告通道的结论必须进入模型可读面。
3012
3172
  *
@@ -3939,7 +4099,7 @@ export function reconstructFromSession(session: any, targetPlanId?: string) {
3939
4099
  for (const entry of (Array.isArray(result.statuses) ? result.statuses : [])) {
3940
4100
  const rebuiltRow = snap.statuses.find((item: any) => item?.subtaskId === entry?.subtaskId)
3941
4101
  if (!rebuiltRow || !isRecord(entry)) continue
3942
- for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication']) {
4102
+ for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication', 'timeoutCount', 'takeoverRequired', 'takeoverBrief']) {
3943
4103
  if (entry[field] !== undefined) rebuiltRow[field] = entry[field]
3944
4104
  }
3945
4105
  /*
@@ -4106,7 +4266,7 @@ export function reconstructFromSession(session: any, targetPlanId?: string) {
4106
4266
  */
4107
4267
  const replayRow = snap.statuses.find((item: any) => item?.subtaskId === update.subtaskId)
4108
4268
  if (replayRow) {
4109
- for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication']) {
4269
+ for (const field of ['deadlineAt', 'timeNotice', 'timeWarning', 'timeJournal', 'pendingAdjudication', 'timeoutCount', 'takeoverRequired', 'takeoverBrief']) {
4110
4270
  if (update[field] !== undefined) replayRow[field] = update[field]
4111
4271
  }
4112
4272
  const replayExtend = Number(update.extendMs)
@@ -4806,7 +4966,7 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
4806
4966
  * 路由分支,按 T4 直写通道写行(StatusEntry 保留未知字段;回放白名单已透传
4807
4967
  * timeNotice,刷新后不丢)。
4808
4968
  */
4809
- function recordTimeNotice(record: any, subtaskId: string, notice: any) {
4969
+ function recordTimeNotice(record: any, subtaskId: string, notice: any, session?: any) {
4810
4970
  const row = Array.isArray(record?.statuses)
4811
4971
  ? record.statuses.find((item: any) => item?.subtaskId === subtaskId)
4812
4972
  : null
@@ -4829,6 +4989,23 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
4829
4989
  })
4830
4990
  row.timeJournal = journal.slice(-20)
4831
4991
  record.updatedAt = at
4992
+ /*
4993
+ * [2.3.0][T1] 预估上报 → 告知用户(用户要求 1 的前半段闭环):专家的开工
4994
+ * 预告落档后,插件立即向主会话推送一条即时通知,明确「请把此预期执行
4995
+ * 时间告知用户」;新预告覆盖旧预告(每条新预告各通知一次,与「开工预告」
4996
+ * 协议一致)。通知是观测设施:写失败只留档 errors,绝不影响记录与执行。
4997
+ */
4998
+ if (session) {
4999
+ try {
5000
+ appendUserMessage(session, `【dsh-workplan·专家预估上报】子任务 ${subtaskId} 的执行专家`
5001
+ + `预估执行时间 ${Number(notice?.declaredMinutes)} 分钟`
5002
+ + (reason ? `(${reason})` : '')
5003
+ + `;请把此预期执行时间告知用户。若执行中超时,请主 Agent 放宽(extendMs)`
5004
+ + '并告知专家最新时限,连续两次超时则由主 Agent 接手未完成部分(已完成产物只读保护,禁止丢弃)。')
5005
+ } catch (error: any) {
5006
+ record.errors = [...(record.errors ?? []), `${subtaskId} 预估上报通知写入失败:${truncate(String(error?.message ?? error), 200)}`].slice(-20)
5007
+ }
5008
+ }
4832
5009
  }
4833
5010
 
4834
5011
  async function updateStatus(agent: any, args: any): Promise<any> {
@@ -5003,7 +5180,7 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
5003
5180
  * [2.2.0][T5/O-4c] 预告与指示同一次到达时,指示成功落行后再记预告:
5004
5181
  * 指示失败不该留下一笔「专家已预告」的记录。
5005
5182
  */
5006
- if (hasTimeNotice && instructed?.ok !== false) recordTimeNotice(record, subtaskId, timeNoticeArg)
5183
+ if (hasTimeNotice && instructed?.ok !== false) recordTimeNotice(record, subtaskId, timeNoticeArg, session)
5007
5184
  return instructed
5008
5185
  }
5009
5186
  if (current?.closure === 'escalated') {
@@ -5070,9 +5247,17 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
5070
5247
  }
5071
5248
  }
5072
5249
  extension = extended
5250
+ /*
5251
+ * [2.3.0][T1] 用户要求 1 后半段:放宽成功后必须把「最新执行时间」告知
5252
+ * 专家,同时附「必须在保证工作质量的前提下高效率执行」硬要求,让专家
5253
+ * 有准备(收到通知继续当前工作,不重新开始)。投递失败不回滚延期——
5254
+ * 时限已经推移,只是告知通道未达:留档 errors,回执带 childNotified
5255
+ * 供主 Agent 决定是否用 dsh_workplan_followup 补发。
5256
+ */
5257
+ extension.childNotified = (await notifyExpertOfExtension(ctx, agent, record, subtaskId, extension.deadlineAt)).ok
5073
5258
  }
5074
5259
  if (!statusRequested) {
5075
- if (hasTimeNotice) recordTimeNotice(record, subtaskId, timeNoticeArg)
5260
+ if (hasTimeNotice) recordTimeNotice(record, subtaskId, timeNoticeArg, session)
5076
5261
  /*
5077
5262
  * 纯时限事务到此结束。方案 §2.2 效果 3:状态行 revision +1(延期/预告也是
5078
5263
  * 行变更,同样受 STALE_WRITE 乐观锁保护);状态与判定一个字段都不改。
@@ -5098,6 +5283,7 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
5098
5283
  deadlineAt: extension.deadlineAt,
5099
5284
  timerRearmed: extension.timerRearmed,
5100
5285
  watchdogRearmed: extension.watchdogRearmed,
5286
+ childNotified: extension.childNotified === true,
5101
5287
  }
5102
5288
  : {}),
5103
5289
  ...(hasTimeNotice ? { timeNotice: written?.timeNotice ?? null } : {}),
@@ -5141,11 +5327,24 @@ export function createWorkplanRuntime(ctx: any, options: WorkplanRuntimeOptions
5141
5327
  revision,
5142
5328
  updatedBy: 'agent',
5143
5329
  })
5330
+ /*
5331
+ * [2.3.0][T1] 禁止丢弃已完成部分(A4 的第二个硬编码保护点):接手行
5332
+ * (takeoverRequired)后续任何一次 artifacts 写入,都把 takeoverBrief 登记
5333
+ * 的保护产物并集合并回来——只增不减,主 Agent 改判时不可能删掉专家已完成
5334
+ * 的产物清单,只能在其基础上补缺口。
5335
+ */
5336
+ if (args?.artifacts !== undefined) {
5337
+ const protectedRow = record.statuses.find((item: any) => item?.subtaskId === subtaskId)
5338
+ if (protectedRow?.takeoverRequired === true && Array.isArray(protectedRow?.takeoverBrief?.landedRefs)
5339
+ && protectedRow.takeoverBrief.landedRefs.length > 0) {
5340
+ protectedRow.artifacts = mergePreservedArtifacts(protectedRow.artifacts, protectedRow.takeoverBrief.landedRefs)
5341
+ }
5342
+ }
5144
5343
  /*
5145
5344
  * [2.2.0][T5/O-4c] 带 status 的调用同时带 timeNotice 时,预告记录在改判落行
5146
5345
  * 之后写入:applyStatus 抛错(如非法 verification)时不会留下半写的预告。
5147
5346
  */
5148
- if (hasTimeNotice) recordTimeNotice(record, subtaskId, timeNoticeArg)
5347
+ if (hasTimeNotice) recordTimeNotice(record, subtaskId, timeNoticeArg, session)
5149
5348
  if (status === 'blocked') {
5150
5349
  record.statuses = markDependentsBlocked(record.plan, record.statuses, subtaskId, { reason: summary || '主 Agent 标记受阻' })
5151
5350
  }