dsh-workplan 2.3.9 → 3.0.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 +161 -0
- package/README.en.md +20 -18
- package/README.md +33 -19
- package/README.zh.md +15 -19
- package/client.js +88 -59
- package/docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md +19 -6
- package/docs/cc/ADV-TDS-TOE-DESIGN.md +3 -3
- package/docs/cc/AGD-OPS-SECURE-OPERATION.md +3 -7
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +22 -3
- package/docs/cc/SECURITY-TARGET.md +6 -6
- package/docs/collaboration.md +17 -16
- package/lib/approval-gate.js +144 -0
- package/lib/client.js +88 -59
- package/lib/comm-format.js +58 -6
- package/lib/criterion.js +210 -0
- package/lib/dept-journal.js +319 -0
- package/lib/host.js +333 -63
- package/lib/llm-rules.js +281 -24
- package/lib/plan.js +1468 -219
- package/lib/replan.js +50 -39
- package/lib/runtime.js +3474 -1088
- package/lib/three-phase.js +106 -20
- package/lib/understanding.js +18 -3
- package/lib/v3-contract.js +431 -0
- package/lib/watchdog.js +9 -1
- package/package.json +4 -3
- package/src/approval-gate.ts +168 -0
- package/src/client.ts +88 -59
- package/src/comm-format.ts +63 -5
- package/src/criterion.ts +261 -0
- package/src/dept-journal.ts +373 -0
- package/src/host.ts +341 -64
- package/src/llm-rules.ts +349 -27
- package/src/plan.ts +1464 -210
- package/src/replan.ts +48 -37
- package/src/runtime.ts +3028 -699
- package/src/three-phase.ts +147 -20
- package/src/understanding.ts +20 -3
- package/src/v3-contract.ts +470 -0
- package/src/watchdog.ts +13 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,164 @@
|
|
|
1
|
+
## 3.0.1 — 2026-11-16
|
|
2
|
+
|
|
3
|
+
### 激活热修:`dsh_workplan_hold` / `dsh_workplan_release` 缺 output 契约导致插件启用失败(宿主 register 硬校验)
|
|
4
|
+
|
|
5
|
+
> **事故**:v3.0.1 在 DSH Web GUI 启用失败,横幅报错 `TypeError: tool "dsh_workplan_hold" must declare output { schema, render, presentationMeta? }`(`file:///…/dsh-workplan/lib/host.js`)。宿主 `ToolsService.register()`(dsh-tools)强制每个工具声明 `output { schema, render, presentationMeta? }`;这两个 3.0.1 新增工具把 `render` 直接挂在工具根上、整体缺 `output` 包裹,注册即抛 TypeError,整个插件条目激活失败(web/headless 两 profile 经符号链接同源皆挂,错误横幅停在第一个失败工具上,release 同款隐患一并修复)。插件自身 1195 例全绿却过不了宿主注册——测试套件此前没有任何用例按宿主契约校验工具定义,此次一并补上永久防线。
|
|
6
|
+
|
|
7
|
+
**治本改动(`src/host.ts`)**:
|
|
8
|
+
|
|
9
|
+
- 两个工具补齐 `output { schema, render }`:schema 覆盖 runtime 全部返回形(hold:`ok/planId/alreadyHeld/hold/code/error`;release:`ok/gateReleased/planId/note/hold/dispatch/code/error`),与文件内其它 12 个工具同款写法对齐;render 按宿主契约接收 `(args, value)` 并返回 `ContentBlock[]`(此前实现返回裸字符串,不符合契约)。
|
|
10
|
+
- 顺带修正 release 的 render 判定顺序:「未能解除」以 `gateReleased !== true` 为准——原实现只看 `ok === false`,会把「闸门已解除但 deepThink 门禁拒派发」误报成未解除(该分支 `ok` 恰为 `false` 但闸门已松,与工具描述「闸门保持已解除」矛盾)。
|
|
11
|
+
|
|
12
|
+
**回归**:新增 `tests/tool-output-contract.test.ts` 3 例(①全部 14 个已注册工具逐字复刻宿主 register 判定 + schema 形状 + render 返回 ContentBlock[];②注册工具集与 `tests/fixtures/tool-surface.json` 清单逐字一致;③hold/release 门禁文案三分支语义)。另经宿主真实校验器(`@deepseek-ai/dsh-tools` 的 `assertSupportedJsonSchema` / `validateJsonSchemaValue`)对编译产物 `lib/host.js` 冒烟:14/14 通过。全量 **1206 例:pass 1205 / fail 0 / cancelled 0**。
|
|
13
|
+
|
|
14
|
+
**生效方式**:已 `npm run build` 并同步 `lib/`(web 与 headless 两 profile 经符号链接同源生效),**须用户手工重启 dsh** 后生效(禁止 Agent 自行重启)。
|
|
15
|
+
|
|
16
|
+
### 与 DSH 0.2.2-rc.3 内置 subagent 插件的冲突修复(全量审计后的 4 条真冲突,修 3 条 + 1 条文档声明)
|
|
17
|
+
|
|
18
|
+
> **审计结论**:工具名/配置键/事件无碰撞,4 条真冲突全部位于「插件 ↔ 内置 subagent 宿主 API/设置」边界。本条修复 3 条,第 4 条(双派发通道)以文档声明收口(内置工具无 per-agent 开关,preset toolFilter 改动面过大)。
|
|
19
|
+
|
|
20
|
+
**治本改动(`src/runtime.ts` + `package.json` + `README.md`)**:
|
|
21
|
+
|
|
22
|
+
- **[P0] `interruptByParent` 已在新版宿主移除 ⇒ phase-0 旧会话不再被中断(白跑烧 token、与 phase-1 重复工作)**。新增 `interruptChildContinuable()`(runtime.ts):优先新版 `subagents.interrupt(target, { kind:'ancestor', agent })`(authority 携带活体祖先 Agent,语义等价于旧 'continuable':中断当前回合、保留收件箱可接续);旧版宿主自动回退 `interruptByParent`。三处调用点(selfEffortTool 接续、delegateTool direct/review 登记)全部改走该 helper。旧测试夹具只 mock 旧 API ⇒ 回退路径保持可用,全部旧测试不回改。
|
|
23
|
+
- **[P1a] 设置页 `subagent.maxDepth`(默认 1)与三层体系(需 2)语义错位**。经核实宿主源码,两条深度通道互不相干:设置页滑块只约束内置 subagent/subagent_fork 工具(经 `resolveMaxDepth()`),插件派发只认 `spec.maxDepth`(manager.ts `resolveChildDepth`),滑块任何位置都不影响负责人→专家流程。新增 `detectDepthOverrideConflict()` + `notifyDepthOverrideConflict()`:三处派发点在检测到该设置 <2 时向计划会话发**一次性**说明(讲清两通道设计、无需操作、如何保持一致),不阻断派发。
|
|
24
|
+
- **[P1b] 宿主并发上限 `ACTIVATION_LIMIT_REACHED` 原样透出**。新增 `describeSubagentActivationError()`:识别该错误(code 或 message 双口径),翻译为可行动中文提示(稍后重试 / 「设置 → 子代理」调大 `maxActiveSubagents`);非该类错误原样返回不吞错。三处 `startActivation` 错误路径接入。
|
|
25
|
+
- **[P2] `package.json` 补 `engines.dsh: ">=0.2.2-rc.3"`**:此前完全无版本护栏,`interruptByParent` 漂移失效无人知晓;此后由宿主 plugin-compatibility 显式拦截过低版本。
|
|
26
|
+
- **[P2] README 新增「和 DSH 内置的子代理是什么关系」章节**:声明双派发通道事实(内置 subagent/subagent_fork 在插件子会话仍可见、绕过则不经任何闸门),并说明两个设置项对本插件的不同影响。
|
|
27
|
+
|
|
28
|
+
**回归**:新增 `tests/workplan-301-subagent-api-compat.test.ts`(8 个用例:新 API 优先/旧版回退/静默失败/异常吞掉、深度冲突一次性告警与各无冲突分支、并发上限翻译与非上限原样返回)。
|
|
29
|
+
|
|
30
|
+
## 3.0.0 — 2026-11-14
|
|
31
|
+
|
|
32
|
+
### 2026-11-15 本地机制修复补丁(认可闸门 + 死锁自愈;版本号维持 3.0.0,经用户确认后再定是否升版)
|
|
33
|
+
|
|
34
|
+
> **事故**:wp-e745a477 —— 用户任务原文写明「有疑问先问用户,经用户认可后再开始执行」,插件却在第一条用户消息上自动生成计划并因 `autoDispatch` 默认 true 立即派发;T1 子会话缺上下文升级待指示后子会话失联,`NO_CHILD` / `ESCALATION_OPEN` / dispatch 被待指示行挡住,三条出口全堵,整盘卡死只能人工取消。
|
|
35
|
+
|
|
36
|
+
**治本改动(`src/approval-gate.ts` + `src/runtime.ts` + `src/plan.ts` + `src/host.ts`)**:
|
|
37
|
+
|
|
38
|
+
1. **认可闸门(keyword 半,默认开)**:计划创建时检测任务锚点里的「先经用户认可/批准/确认再执行」门槛语(8 类正则),命中则计划照出、按住不派(`dispatchHold` 落档,durable 回放与重启重建均还原),直到用户明确认可、主 Agent 调用 `dsh_workplan_release`。`DSH_WORKPLAN_APPROVAL_GATE=0/false/off` 只关这一半。
|
|
39
|
+
2. **认可闸门(manual 半)**:新增 `dsh_workplan_hold` / `dsh_workplan_release` 工具,关键词未命中时主 Agent 可显式按住/解除;解除登记 `gateHistory` 留痕并走 dispatch 全部既有闸门。plan 模式下 release 同 dispatch 被 toolGuard 拒绝。
|
|
40
|
+
3. **派发/收尾联动**:闸门按住时 `dsh_workplan_dispatch` 拒 `DISPATCH_HELD`;回合收尾 steer 与 headless 硬失败对 held 计划豁免(不再催派发);未派发 held 计划不被下一条用户消息自动取消。
|
|
41
|
+
4. **死锁自愈**:`dsh_workplan_instruct` 遇到 `NO_CHILD` / `NOT_DIRECT_CHILD` 不再硬失败——把 escalated 行复位为 `pending`(合法迁移边)并登记 `reviveInstruction`(durable 透传 + 重建子会话时由 `buildChildPrompt` 注入提示词),下一次 dispatch 重建全新子会话并带上下达的决定。
|
|
42
|
+
5. **止血配置**:`cordis.patch.yml` 一度置 `autoDispatch:false`,全量回归通过后恢复 `config:{}`(默认自动派发 + 关键词闸门保护)。
|
|
43
|
+
|
|
44
|
+
**回归**:新增 `tests/approval-gate.test.ts` 19 例(门槛语 8 命中/3 不误伤/总开关/isDispatchHeld/revive 补丁与 applyStatus 集成/提示词注入/durable 透传);`tests/fixtures/tool-surface.json` 登记 2 个新工具;全量 **1195 例:pass 1194 / fail 0 / cancelled 0**(基线 1175 全绿)。`docs/cc/ADV-FSP`(工具 12→14)与 `AVA`(AS-14/15)同步。
|
|
45
|
+
|
|
46
|
+
**生效方式**:已 `npm run build` 并同步 `lib/`(web 与 headless 两 profile 经符号链接同源生效),**须用户手工重启 dsh** 后生效(禁止 Agent 自行重启)。
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
> **定版依据**:用户 2026-11-14 明确要求「优化全部完美完成后,此插件版本定为 3.0.0」,并裁决发布方式为**仅本地**(改版本号 + 构建 + 回归 + 变更说明,不对外发布、不打 tag)。本节下方「low 任务禁止第三层下派」一段原为 2.5.5 候选改动,经用户裁决**整体保留为 3.0.0 基线的一部分**,故并入本节,不再单独定版。
|
|
50
|
+
>
|
|
51
|
+
> **基线原则**:2.5.4 已有的全部强制机制(四角色两轮深度思考门禁、复杂任务 ≥8 人、下属开工预估上报、单任务 ≤10 分钟判据、F1–F9 沟通格式)**一条不减**,本节 13 条改动只做叠加。
|
|
52
|
+
|
|
53
|
+
### 十三条底层机制优化(用户 2026-11-14 原话逐条对应)
|
|
54
|
+
|
|
55
|
+
1. **会话内必须显示用户刚输入的任务内容**(原缺陷:等待分配期间切换会话再切回,看不到自己刚输入的任务)。根因(`reports/T4b-会话内容丢失根因报告-20261114.md`,3497 个会话 / 4034 轮对照):宿主在 pre-step 之前就认领用户消息,人类 `user/message` 只在首个 model step 内部落盘;插件却在 pre-step 里 `await runPlanner`,把这一步推迟到分钟级(含规划轮 p50=58.4s / p90=250s,不含规划轮 p50=0.04s),这段时间日志里没有可渲染的任务正文,屏幕上唯一副本是客户端回声,而客户端收到回执后无条件退休回声 → 切走再切回就空了。**治本**:pre-step 不再等待规划 —— 先同步放行本步并注入「正在分配、别自己动手」的说明,规划转后台(`src/runtime.ts` 的 `runPlanningInBackground`,同会话幂等、沿用本步 signal 的取消语义),计划一成即经唯一合规写入器 `appendUserMessage` 写入会话并照旧自动派发;首 step 秒级启动后宿主立即落盘人类消息。**加固**:`src/plan.ts` 的 `buildPlanMessage` 另把 `taskAnchor.text`(截断 4000)以「用户刚才输入的任务原文(只读锚点,与你最初的输入逐字一致):」逐字写进计划消息,任何回放都能读到原文。
|
|
56
|
+
|
|
57
|
+
2. **收到任务即输出固定文案**:`任务正在分配中,请稍等一下......`。由平台在规划预告之前写入会话(`src/runtime.ts` 的 `maybePlan`,`appendUserMessage(..., { deferUntilHead: true })`),常量定义在 `src/v3-contract.ts` 的 `STATUS_ASSIGNING_TEXT`(6 个半角点,逐字冻结)。
|
|
58
|
+
3. **派发给部门负责人的每个任务必须附质量要求**:新增 `qualityRequirements` 字段并设为**必填**(`src/host.ts` 的 schema、`src/llm-rules.ts` 的 `DelegationAssignment`),缺失即拒 `DELEGATE_QUALITY_REQUIREMENTS_MISSING`;负责人任务书用 `renderQualityRequirementsBlock` 逐条渲染并注明下达方。
|
|
59
|
+
4. **分配完成即输出固定文案**:`任务已经完成分配,正在执行中......`。由 `src/runtime.ts` 的 `dispatchPlan` 在 `record.phase='executing'` 之后写入(`STATUS_ASSIGNED_TEXT`)。两条文案各只发一次,重试/续跑不重复刷屏(提示词同步禁止子 Agent 自行复述这两句)。
|
|
60
|
+
5. **负责人派出的每个任务必须极简(1+1=2)**:新增硬门槛 `checkAtomicAssignment`(`src/v3-contract.ts`):单句、≤300 字符、≥8 字符、禁止并列多目标词(并且/同时/另外/还要/以及/分别/顺便)、禁止分号与多句,且必须带质量要求;不满足即拒 `DELEGATE_TASK_NOT_ATOMIC`,拒因附**可照做的拆小指令**(硬门槛,用户裁决 A)。
|
|
61
|
+
6. **派发给全球顶尖专家的任务必须交代成果要求与质量**:`src/llm-rules.ts` 的 `buildDelegateePrompt` 与 `buildPhaseZeroDelegateePrompt` 固定角色标签为「本部门相关领域全球顶尖专家」,插入质量要求块与专家汇报契约全文。
|
|
62
|
+
7. **专家成果必须极简、JSON 结构化汇报**:新增 F10 门禁与 `checkExpertReport` —— 字段仅 `keyResults` / `keyInfo` / `importantInfo` / `leadRequirements`,每条 ≤200 字符、每字段 ≤6 条,多余字段直接判不合规;重复内容用「完全相同 / 短条被长条包含(≥12 字符)/ bigram Dice ≥ 0.85 近义重复 / 去重键相同」四路拦截。
|
|
63
|
+
8. **负责人必须全面深入汇总本部门全部专家汇报**:F11 门禁用 `expectedExperts` 按名称核对 `sources` 是否覆盖全部专家,缺一即退回。
|
|
64
|
+
9. **取消部门组员角色**:`role` 枚举只剩 `['expert']`;历史 `member` 读取时归一为 `expert`(不报错、不迁移、不改历史日志);`ROLE_MIX_REQUIRED` 配比门禁删除,改为「至少 1 名专家」;client 文案、three-phase 提示词、journal 新写入全部去掉组员。
|
|
65
|
+
10. **负责人汇总报告必须精简、禁止累赘重复、JSON 结构化**:新增 F11 与 `checkDepartmentSummary` —— 字段仅 `keyResults` / `keyInfo` / `importantInfo` / `sources`,同一套四路去重规则;超长或重复一律退回。
|
|
66
|
+
11. **汇总报告完成后必须直接交给主 Agent**:`settleFromOutput` 把 `departmentSummary` 持久化到任务行,`emitSubtaskDoneNotice` 在完成通知里原样附「部门汇总报告(JSON,直接交给主 Agent):」+ 完整 JSON,不经二次概括、不裁剪。
|
|
67
|
+
12. **全部任务交回后由主 Agent 汇总最终成果**:`src/host.ts` 的 `PROMPT_SECTION` 新增 R12 硬规则(收齐全部部门汇总 JSON 后由主 Agent 统一深入汇总,不得把部门汇总直接当最终成果)。
|
|
68
|
+
13. **版本定为 3.0.0**:`package.json` / `package-lock.json` / `src/host.ts` meta / `tests/fixtures/tool-surface.json` / `README(.md/.en.md)` 安装示例全部同步 3.0.0。
|
|
69
|
+
|
|
70
|
+
### 兼容与回归
|
|
71
|
+
|
|
72
|
+
- **沟通格式规范升版**:`COMM_FORMAT_VERSION` 1 → 2,新增 F10/F11,**F1–F9 原文一字未改**;只有 `status==='done'` 且声明了层级(`tier:'expert'|'leader'`)时才追加对应条目,历史回放与旧日志零回归(有专门用例锁定)。
|
|
73
|
+
- **新增回归**:`tests/workplan-v3-contract.test.ts` 24 例(固定文案逐字、任务原文可见、质量要求归一与渲染、极简门槛各类拒绝、专家/部门 JSON 校验含 Dice 近义重复与去重键、F10/F11 层级接线、role=member 归一、版本 3.0.0)。
|
|
74
|
+
- **生效方式**:改的是 `src/`,运行中的进程不热加载 —— 已 `npm run build` 并同步 `lib/`,**须用户手工重启 dsh web** 后生效(禁止 Agent 自行重启)。
|
|
75
|
+
|
|
76
|
+
- **low 任务禁止第三层下派(用户裁决 D1–D6;计划 wp-43d5099c;实现规格 `reports/wp-T3-impl-spec-20261114.md`)**:
|
|
77
|
+
- **D1/D3 判定链(钳制前)**:low 判定=负责人自配 `consolidation.taskReasoningEffort`(钳制前原始声明,经 `taskReasoningEffortDeclared` 持久化记忆)→ 缺失时按任务行记录等级 `subtask.reasoningEffort` 兜底 → 两者皆缺=「未配置」**视同 low** 一并禁派。判定链与 `complexTask`(决定 ≥8 人闸与 6/12 人上限)**完全解耦**(`src/llm-rules.ts:348` `banDeclared = … ?? declaredEffort ?? input.taskRowEffort`)。
|
|
78
|
+
- **D2/D4 出口与拦截**:review 与 dispatch 共用唯一入口 `planDelegations`(`src/llm-rules.ts:352-360`),low(含视同 low)一律硬拒 `DELEGATE_LOW_TASK_FORBIDDEN`,拒因含「负责人亲自执行 + `action="direct"` 登记 + 40/40/20 字 + 无任何例外通道 + 历史派发不回溯」五要素;负责人改经新增动作 `dsh_workplan_delegate(action="direct")` 登记两轮深度思考产物后由平台以 low 档接续本人执行(`src/runtime.ts:8853`,schema `src/host.ts:862`)。direct 防旁路:复杂档/非法档 ⇒ `DELEGATE_DIRECT_EFFORT_INVALID`;携带分工表 ⇒ `DELEGATE_DIRECT_ASSIGNMENTS_FORBIDDEN`;缺/薄思考产物 ⇒ `THINK_MISSING`/`THINK_INCOMPLETE`(与主 Agent、叶子同一 40/40/20 判据);叶子调 direct ⇒ `NOT_LEADER_SESSION`/`NO_PLAN` 路由隔离。
|
|
79
|
+
- **D5 生效范围**:判据在「新下派请求时」计算,无迁移、无回溯、**不设独立配置开关**(由「无任何例外通道」推断,标注为推断项);回退=恢复旧版 lib + 用户手工重启。
|
|
80
|
+
- **D6 基线与路径**:基线 dsh-workplan@2.5.4,源码 `plugins/dsh-workplan`(符号链接至 web/headless 双 profile,改源码两端同时生效)。改动集中在 `src/llm-rules.ts`(新增闸+可选 `taskRowEffort` 参数+`taskReasoningEffortDeclared`)、`src/runtime.ts`(direct 分支、review/dispatch 传参、review 注入字段剥离、`gateAudit` 留痕、`SELF_EFFORT_MISSING` 文案指路 direct)、`src/plan.ts`(consolidation 消毒白名单+负责人任务书/接续提示文案)、`src/host.ts`(schema enum 与描述);`src/three-phase.ts` 零改动。
|
|
81
|
+
- **验证与证据**:专用回归 `tests/workplan-low-delegation-gate.test.ts` 30 例(A 判定链 / B 非法值与拒因顺序 / C 钳制记忆与防注入 / D direct 出口十项 / E 钳制前后 / F S4 非 low 零变化 / G 端到端),加受影响 4 文件共 **5 文件 72 例全绿**;全量回归 **1138 例 / 1137 通过 / 0 失败 / exit=0**(日志 `/tmp/full-final2.log`)。四态与非法值映射见 `/Users/open/Documents/Stocks/reports/T4-回归用例与执行结果_20261114.md`;对照 D1–D6/S1–S6 的逐条验收见 `/Users/open/Documents/Stocks/reports/T5-low禁派机制-对照原要求验收报告_20261114.md`;历史 81 条红灯整体修复与归因见 `/Users/open/Documents/Stocks/reports/本轮最终结果-81条回归清零-20261114.md`。
|
|
82
|
+
- **生效交接**:`node node_modules/typescript/bin/tsc -p tsconfig.json` 已构建并 `cp dist/*.js lib/`,`lib/` 已含改动;运行中进程不热加载,**须用户手工重启 dsh web** 后按 `/Users/open/Documents/Stocks/reports/T5-low禁派机制-对照原要求验收报告_20261114.md` §五命令复核(禁止 Agent 自行重启)。改动在工作树,未 commit/push/tag(发布归用户决定)。
|
|
83
|
+
- **已知问题(如实登记,未擅自处置)**:① 版本递增号待用户定版;② `delegateSelfEfforts`/`delegateDeepThinks` 的 `slice(0,6)` 与 `delegates`/`estimates` 的 `slice(0,12)` 上限不对称(第 7 名起台账截断,decision-record §5-2「O2」);③ `allowBanned` 豁免(专家预估上报必达主会话)与内部噪音禁止清单的规则冲突待用户裁决(F3)。
|
|
84
|
+
|
|
85
|
+
## 2.5.4 — 2026-11-12
|
|
86
|
+
|
|
87
|
+
- **机制缺陷治本(用户 2026-11-12 本会话实锤,③④⑥ 落地;②⑤ 经核实为有意安全契约,不 loosening)**:
|
|
88
|
+
- **③ 子会话迟到结算不得削弱主 Agent 人工改判**:主 Agent 已以 structured 证据裁决 done 后,子会话迟到结算携带更弱 verification/acceptance 时不再覆盖人工证据(plan.ts applyStatus 保留人工 structured 验收)。
|
|
89
|
+
- **④ 超时「待裁决」标记随 done 裁决清除**:行裁决 done 后 `pendingAdjudication=false`,界面/回放不再对已完成行显示「待裁决」(plan.ts applyStatus done 分支)。
|
|
90
|
+
- **⑥ 叶子中止/失败时父级完成口径显式**:父行 done 但含 failed/aborted 叶子时,摘要自动点名这些叶子并说明父级完成依据为其余证据+主 Agent 复核,非该叶子自报完成(plan.ts applyStatus),消除「叶子没做完却说全完成」的口径歧义。
|
|
91
|
+
- **②/⑤ 契约澄清(不改迁移表/覆盖守卫)**:reported→done/assigned 的拒绝与「只回一半/否定词反转不覆盖」是插件有意的防假完成契约(既有 204/Q6/U-16/T4 测试锁定)。本会话的误 blocked 实为子会话迟到结算写了非法 closure;remedy 走写入侧(结算不写非法 closure、人工补证带 A 编号),不 loosening 状态机与门禁。新增 tests/workplan-254-closure-gate.test.ts 7 例锁定 ③④⑥ + 契约原样 + 2.5.3 前置闸回归。
|
|
92
|
+
- **版本一致性**:package.json / package-lock(两处)/ host.ts meta / tool-surface fixture / README(.en) 安装命令 / 本 CHANGELOG 统一 2.5.4。
|
|
93
|
+
- **生效交接**:npm run build 已执行;运行中进程不热加载,须用户手工重启 dsh web 后复核。
|
|
94
|
+
- **T6 下属开工前预估时间上报硬门禁(用户 D9:「没有告知部门负责人预估时间,先拦截,再告知此人,你必须自己预估时间,汇报给对应负责人后,才可以重试或继续执行」;契约 _t6_estimate_20261112/00-contract-estimate-v1.md FROZEN)**:
|
|
95
|
+
- **self_effort 原子对新增必填 timeNotice**:`timeNotice={ declaredMinutes: 正整数分钟(Number.isInteger 且 1–10080), reason?: ≤300 字符 }`;校验顺序 reasoningEffort → complexityRationale → deepThink → timeNotice(最后校验),缺交硬拒 `ESTIMATE_MISSING`、形状非法硬拒 `ESTIMATE_INVALID`(error 均含 D9 原话+形状/非法原因),不登记、不接续 phase-1;成功返回附 `estimate:{declaredMinutes,reason?,delivery}`。
|
|
96
|
+
- **kind=estimate 送达负责人(复用 T5 通道,不新建队列)**:登记(persistSelf)之后、interrupt/接续之前经 `ctx.subagents.sendMessage` 投递【第三层开工预估】消息至部门行负责人会话(row.childId,缺失回退 leaderId);channelJournal kind 联合扩为 'escalation'|'instruction'|'estimate',from.member/to 归属留痕;两者皆缺或投递失败 ⇒ `ESTIMATE_DELIVERY_FAILED`(delivery:'failed' 落档、不接续,重试重新投递并覆盖;已 sent 幂等不重复投递);journal 写失败不掩盖投递结果(ok:true 附 journal:{ok:false,…})。
|
|
97
|
+
- **delegateEstimates 双通道持久化**:`delegates[].estimate` + 任务级 `delegateEstimates: Record<member,estimate>`(与 selfEffort/deepThink 同范式);applyStatus fail-closed 消毒(非法子对象丢弃、非法 map 抛 `INVALID_DELEGATE_ESTIMATES`)、尝试重置保留、durable 回放白名单一处不漏(buildUpdateMessage/reconstruct 消费端/persistSelf/modelStatusLines/derivePlanSnapshot);delegates 上限沿用 T8 同步值 slice(0,12),8 人预估全部存活。
|
|
98
|
+
- **重派未预估回 phase-0**:`leafPhaseZero = !priorSelf || !stashedThink || !stashedEstimate`——旧叶子已配档/已思考但未预估 ⇒ 回 phase-0 补交完整原子对;selfContinuation 文案附「预估已登记(含分钟数)」。
|
|
99
|
+
- **schema 与任务书同源**:host.ts delegate schema 新增 timeNotice 属性与 T6/D9 描述;llm-rules.ts phase-0 提交清单与叶子 brief 同步「整数分钟、未上报不接续」;plan.ts 负责人任务书补「下属预估即时送达并留痕(kind=estimate),未上报者被拦截开工」(时长求和归 T7,T6 只存不算;T7 读 delegateEstimates/journal estimate 求和)。
|
|
100
|
+
- **验证与生效交接(D8)**:测试与全量回归数字以负责人全量回归日志为准(reports/T6-lead-independent-verification-20261112.md);机制说明与冒烟步骤见 reports/T6-estimate-gate-mechanism-20261112.md。无需安装/升级插件包,集成构建由负责人执行;运行中进程不热加载,**须用户手工重启 dsh web** 后按冒烟步骤复核(派 1 名下级 → self_effort 缺 timeNotice 应被 ESTIMATE_MISSING 拦截 → 补交后负责人收到预估消息并接续执行)。
|
|
101
|
+
|
|
102
|
+
- **七条底层机制全面优化(用户 2026-11-12 七项要求 R1–R7;计划 wp-437e264b,T1–T11+T10R 全部 structured 验收通过;用户决策 D1–D10 见 reports/wp-user-decisions-20261112.md)**:
|
|
103
|
+
- **R1/T3 负责人分派前两轮深度梳理硬门禁**:部门负责人 review/dispatch 共用同一质量闸——problemAnalysis≥40字、approach≥40字、approachBasis≥20字(与主 Agent/叶子同源常量 three-phase.ts MIN_PLANNING_*),缺/薄产物硬拒 `DELEGATE_CONSOLIDATION_INCOMPLETE`(拒因点名实际字数与下限),合格才放行;每次拒绝/放行记入 gateAudit 台账(有界20条、durable 回放、status 可查)。标记 [2.5.4][T3R1]。证据 reports/T3-gate-audit-20261112.md。
|
|
104
|
+
- **R2/T4 复杂任务≥8人硬门禁**:`DELEGATE_HEADCOUNT_MIN`——声明档 medium/high/xhigh/max(`COMPLEX_DECLARED_EFFORTS`,钳制前判复杂、xhigh 不豁免)合计≥8人(`MIN_COMPLEX_DELEGATE_MEMBERS=8`)硬阻断,复杂上限放宽至12、非复杂保持6+静默截断;仍≥1 expert+≥1 member;持久化消毒上限同步 6→12(plan.ts `slice(0,12)`,门禁为唯一人数判据)。聚焦 tests/workplan-254-min-headcount.test.ts 11/11。证据 reports/T4-min-headcount-final-20261112.md。
|
|
105
|
+
- **R3/T5 负责人↔专家↔组员双向沟通通道**:叶子 dsh_workplan_escalate 经 delegate 登记反查部门行(不再 NO_PLAN 断链)、instruct 放权直系父会话(lineage 硬校验);新增 dept-journal.ts JSONL 留痕(坏行计 skipped);消息接口契约 v1 冻结(_t5_channel_20261112/00-contract-v1.md)。20 往返 40 投递 0 丢、故障注入 10/10 DELIVERY_FAILED 显式可重试、契约测试 17/17。证据 reports/T5-message-interface-v1-20261112.md。
|
|
106
|
+
- **R4/T6 下属开工前预估时间上报硬门禁**:见上条 T6(self_effort 原子对必填 timeNotice,ESTIMATE_MISSING/INVALID/DELIVERY_FAILED,D9 原话拦截)。
|
|
107
|
+
- **R5/T7 负责人任务时长=下属预估之和**:读时派生纯函数 `deriveLeaderEstimate`(plan.ts)挂三读面(serialisePlan→normaliseStatusEntry/modelStatusLines/delegate status),只计每成员最新 delivery='sent' 的 declaredMinutes 算术和、不含负责人自身耗时;客户端只渲染禁求和、无新增持久化(D3 口径)。tests/workplan-t7-duration-sum.test.ts 23 例。证据 reports/T7-final-acceptance-agent27.md。
|
|
108
|
+
- **R6/T9 负责人完美完成即时报主 Agent**:`emitSubtaskDoneNotice` 增强——验收结论 X/Y+D7 完美判据(structured+全 pass)+逐条验收+待主 Agent 执行事项(含 D8 手动重启建议);head→root completion 留痕;wait/async 均 notifyCompletion:true。证据 reports/T9-final-verification-20261112.md。
|
|
109
|
+
- **R7/T8 下属完美完成即时报负责人**:`emitDelegateDoneNotices`/`deliverDelegateDoneNotices`——done-only 过滤、sent 幂等、写时重读防竞态、DELIVERY_FAILED 显式+failed 留痕+下次结算兜底补发;两处结算接线。证据 reports/t8-full-suite-r3-20261112.log。
|
|
110
|
+
- **T11 两处运行态缺陷治本(T6/T7 实测暴露)**:①重启早期负责人会话不可见时 selfEffortTool 不再误报 `SELF_EFFORT_NOT_LEAF`——按 childId 懒加载回退扫 state.records(真非叶子仍拒绝);②deliverDelegateDoneNotices 及 extendMs/escalate/estimate 同路径 sendMessage 全部携带有效 signal(`new AbortController().signal`),消除 "Cannot read properties of undefined (reading 'throwIfAborted')",恢复要求7完成汇报真实投递(保留正常取消语义)。tests/workplan-t11-runtime-defects.test.ts 6 例。证据 reports/T11-acceptance-20261113.md。
|
|
111
|
+
- **T10R 最终回归验收**:7 条机制正反例锚定当前源码+全量绿;全量回归 **1035 pass / 0 fail / 0 cancelled / exit 0**(基线 983→1006→1029→1035)、tsc 零错误。证据 reports/T10R-final-acceptance-20261113.md、_t11_runtime_defects_20261113/full-test.log。
|
|
112
|
+
- **生效交接(D8)**:npm run build 已执行、lib 已含全部改动;运行中进程不热加载,**须用户手工重启 dsh web** 后按 T10R 报告冒烟步骤复核(禁止 Agent 自行重启)。改动在工作树,未 commit/push/tag(发布归用户决定)。
|
|
113
|
+
|
|
114
|
+
## 2.5.3 — 2026-11-12
|
|
115
|
+
|
|
116
|
+
- **重启后会话损坏治本(用户 2026-11-12 报告:Harness 重启后多会话报 SessionFormatError: system/message requires a protected first surface head)**:根因=规划期【规划预告】/【规划进行中】等通知经唯一写入器 appendUserMessage 以 user/message append 抢在宿主首条 system/message(protected head)之前落 surface;运行期不校验、重启冷读经 foldSurface 校验即整会话判损坏。修复=appendUserMessage 单点 protected-head 前置闸(头未就绪暂存、头就绪按序补发,plan.ts surfaceHeadExists/flushPreHeadNotices/preHeadNoticeQueue),零 schema 变更、不触碰 system/message。配套 scripts/repair-prehead-notices.mjs 对已损坏旧日志先备份 .bak-pre253、头前 workplan 通知改 log-only、离线复刻 foldSurface 校验通过才落盘;本会话已修复 4 份受损日志并留备份。回归=写入侧 deferral 用例(头前零泄漏/头后补发/首 surface=system/message)。
|
|
117
|
+
- **生效交接**:须用户手工重启 dsh web;活体会话日志静止后用修复脚本处理。
|
|
118
|
+
|
|
119
|
+
## 2.5.2 — 2026-11-11
|
|
120
|
+
|
|
121
|
+
- **「提交任务后长时间无反应」缺陷治本(用户 2026-11-12 硬要求:必须修复、禁止遗留;stall-fix 三条根因,均经本会话运行态实证)**:
|
|
122
|
+
- **R1 负责人 phase-1 重新 review 触发无条件中断(最致命)**:旧代码只要 review 登记了整体档就 `interruptByParent`,而中断后的接续逻辑只存在于 phase-0 结算分支——负责人已在 phase-1 执行时再次 review(哪怕等级不变)会被中断且无人接续,子会话 aborted、产物丢失、台账 blocked,用户看到长时间停滞。本会话两个计划的 T1 负责人均以此方式死亡(wp-e5ea8772 T1 在 revision7 review 后 15ms 即 aborted,运行态复现)。修复:中断前快照 `hadEffortOverride`(runtime.ts:7497),仅当 review 之前未登记整体档(真 phase-0→登记 转变)才中断(runtime.ts:7529);phase-1 重新 review 只更新梳理产物,绝不中断执行中回合。
|
|
123
|
+
- **R2 规划器默认取家族最高推理档 → 单次规划实测 12-13 分钟**:预告之后长时间只有心跳没有结果,用户体验即「死机」。修复:默认档改家族中等档(qwen⇒medium、非 qwen⇒high,runtime.ts:855),中等档不在合法集时回落最高档(家族白名单语义不变),`DSH_WORKPLAN_PLANNER_REASONING_EFFORT` 显式覆盖保留;规划是结构化分解(中等复杂度),中等档保证质量并显著缩短首屏等待。
|
|
124
|
+
- **R3 派发执行轮次期间零会话输出**:规划心跳只覆盖 runPlanner,执行轮次(可能十几分钟)期间无任何进度可见。修复:执行期进度心跳——createPlanningHeartbeat 工厂新增 buildMessage 注入,dispatchPlan 开始即 start(runtime.ts:3590)、finally 必 stop(runtime.ts:3863),默认 45s、`DSH_WORKPLAN_DISPATCH_HEARTBEAT_MS` 可调(≥5000ms),经唯一合规写入器发「已用时+完成进度+不是卡死」(buildDispatchHeartbeat,plan.ts:1797);不新增事件类型、maxNotices 保险丝、中止静默,与规划心跳同一收束纪律。
|
|
125
|
+
- **验证**:新增 tests/workplan-252-stall-fix.test.ts 7 例(R1 行为级中断计数:首次登记仍中断、已登记后同档/换档/不带档 re-review 零新增中断;R3 文案/假时钟周期/stop 收束/保险丝/中止静默/接线源码锚定;R2 源码锚定;四角色门禁冒烟不回归);既有 5 例规划器默认档断言按新契约适配(effort-rules A3c 改 env 显式 max 触发修正轨、planner-effort-clamp 两例、planner-salvage 两例,断言意图「不继承主 Agent/家族白名单/能力钳制」零删改)。根因与证据链:reports/stall-fix-root-cause.md。
|
|
126
|
+
- **生效交接(需主 Agent/用户执行)**:npm run build 已随全量回归完成;**运行中进程不热加载,须用户手工重启 dsh web**,重启后真实提交任务复现验证(提交即预告、规划提速、执行期心跳、re-review 不再中断);主会话工具面缺失 dsh_workplan_* 属宿主侧暴露问题(子会话可调用),重启后复核,不在本插件源码可修范围。未通过真实链路验证前不声称运行态缺陷已消除。
|
|
127
|
+
- **规划期间心跳治本(用户 2026-11-11 报告:本会话 turn 1 规划 12.5 分钟全程零会话输出,用户以为死机并手动中断,turn/end reason=interrupted)**:根因是 runPlanner 的失败重试回报器(createPlannerProgressReporter)只在「失败且会退避重试」时发通知;一次**持续流式输出但很慢**的尝试(推理 chunk 不断重置 idle 窗口,最长可达绝对上限 900s)既不失败也不触发 idle,于是【规划预告】之后整段静默,用户无法区分「正在生成」与「卡死」。本版新增与失败重试**正交**的规划心跳:只要 runPlanner 还在跑,就按固定间隔(默认 45s,DSH_WORKPLAN_PLANNING_HEARTBEAT_MS 可调,≥5000ms)经唯一合规写入器 appendUserMessage 在会话里发一条【规划进行中】通知——含已用时(分/秒)、当前尝试序号(第 N/M 次,>1 才显示)、并明确「正在等待模型返回,不是卡死;完成后立即显示【任务分解】;失败会自动重试并另行提示」。goal 触发的规划走同一 maybePlan 入口,同样受益。
|
|
128
|
+
- **实现与安全性**:文案纯函数 buildPlanningHeartbeat / 间隔归一 planningHeartbeatIntervalMs / 依赖注入工厂 createPlanningHeartbeat 落 plan.ts(可脱离宿主单元回归);runtime.ts maybePlan 在 runPlanner 之前 start、try/catch 外加 finally stop(成功/降级/中止都收束,绝不残留定时器,吸取 2.2.8/2.2.9 计时器教训);onProgress 包装顺带记录当前尝试序号供心跳显示。写入仍是 user/message(surfaceOp:'append'、形状校验),**不新增任何事件类型、不触碰 system/message**,故不会引入会话日志损坏;maxNotices 保险丝(默认 40)防失控,真正收束靠 finally。不改任何 schema、工具参数/输出、重试/超时语义,旧计划零迁移。
|
|
129
|
+
- **主 Agent 两轮深度思考协议硬门禁(用户 2026-11-11 补充要求:插件底层机制必须确保主 Agent 自己也做到)**:2.5.1 已覆盖部门负责人/全球顶尖专家/组员三层执行者;本版把同一协议强制到主 Agent——执行自己的任务必须先全面、全盘、深入梳理、研究、思考自己的任务(第一轮),再基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清自己的思路与具体一步步执行、完美完成任务的方法、流程和步骤(第二轮),最后才基于第二轮的方法、流程、步骤开始具体执行。机制落点:`dsh_workplan_dispatch` 首次派发必须随附 `deepThink{problemAnalysis, approach, approachBasis}`(three-phase.ts `validateMainDeepThink` 纯逻辑判据,与执行者层同一 40/40/20 字下限),未交硬拒 `MAIN_DEEP_THINK_MISSING`、不合格硬拒 `MAIN_DEEP_THINK_INCOMPLETE`,拒绝不启动任何子 Agent、不刷派发预告;合格后登记计划记录 + durable workplan-update(计划级 subtaskId=null)持久化,续跑/重试/join/重启回放读档放行(reconstruct 消费侧 `sanitizeMainDeepThink` 同口径消毒,G1 写入/消费双侧接线);按 planId 记账——重规划的新计划是新任务,必须重新两轮思考;NO_PLAN/PLAN_ID_MISMATCH/终态拒绝顺序不变。PROMPT_SECTION 主 Agent 硬规则与 dispatch 工具 schema/描述同源告知(提示词说服模型,代码守住边界)。新增 tests/workplan-251-main-deep-think.test.ts 13 例回归 + tests/helpers/main-deep-think.ts 共享夹具;既有 17 个测试文件 48 处 dispatch 调用统一以合格夹具过闸。旧计划回放零迁移(无新字段不报错;未登记产物时派发要求补交,属协议强制口径)。
|
|
130
|
+
- **叶子执行前两轮思考硬门禁 + 四角色少走弯路(用户 2026-11-12 要求:你/负责人/顶尖专家/组员执行自己的任务前都必须先两轮深度思考再执行,最高效率且全程少走弯路)**:2.5.1/2.5.2 已覆盖主 Agent(dispatch 门禁)与负责人(review 门禁),但专家/组员叶子只有任务书注入+结算时检查——思考产物在「执行后」才被迫补齐,不满足「先思考后执行」。本版把叶子 phase-0 提交升级为原子对:`self_effort` 必须同时携带合格 `deepThink{problemAnalysis, approach, approachBasis}`(与主 Agent 同一 `validateMainDeepThink` 判据、同一 40/40/20 字口径),缺交硬拒 `DEEP_THINK_MISSING`、不合格硬拒 `DEEP_THINK_INCOMPLETE`,不登记、不接续;两项齐全才登记并以自配档接续 phase-1——正式执行只能发生在两轮思考登记之后,接续任务书随附第二轮执行蓝图。持久化:`delegates[].deepThink` + `delegateDeepThinks` 台账经 applyStatus 消毒(非法/篡改丢弃,`INVALID_DELEGATE_DEEP_THINKS`)+ 尝试重置保留 + durable workplan-update 回放双侧接线(G1);重派读档直接 phase-1(提示词声明「自配档接续·两轮思考读档」+ 不要重复提交),只有自配档没有思考产物的旧叶子路由回 phase-0 补齐(先思考后执行不留旁路;旧计划回放零迁移)。四角色协议文案同源加入「以最高效率执行、确保完美完成」与「全程少走弯路:先查历史教训、先验证再动手、不重复试错」(threePhasePromptLines / PROMPT_SECTION / buildLlmRulesBrief 两 tier / phase-0 与 phase-1 任务书 / dispatch 与 delegate 工具 schema),历史教训自动注入(lessons)为少走弯路底层支撑。新增 tests/workplan-252-leaf-deep-think.test.ts 8 例回归 + helpers 预登记思考产物;既有 self-effort 用例按新契约适配(断言意图零删改)。T1 差距诊断落盘 reports/T1-four-role-gate-diagnosis.md(含四角色矩阵与 file:line 证据)。版本号沿用 2.5.2(用户尚未定版是否递增,不擅自改动)。
|
|
131
|
+
- **版本统一 2.5.2(用户定版)**:package.json / package-lock.json×2 / src/host.ts meta / tests/fixtures/tool-surface.json / README 三语徽章与安装行(README.zh 漏改在本轮补齐)/ 版本回归断言(workplan-250-head-delegation 要求5 断言随定版升级)。新增 tests/planning-heartbeat-2-5-2.test.ts 回归(文案/间隔/假时钟周期触发/stop 收束/中止静默/保险丝/源码锚定)。生效需 npm run build 后由用户手工重启 dsh web(宿主侧无热加载)。
|
|
132
|
+
|
|
133
|
+
- **重启后真实链路验证结论(2026-11-12,T6 补记;stall-fix 生效交接闭环)**:用户已手工重启 dsh web(11:29:53,pid 16910,build b5a6fc479711c210,加载 11:23:20 构建;三证:lsof/libproc 启动时间/插件自报一致 + 启动晚于构建 + realpath 链路同一,reports/t2-restart-state-check.md)。重启后本会话(wp-cb91f412)即真实提交任务链路,交接项逐条活证据(父会话日志 seq/时间,详见 reports/post-restart-verification-report.md §2):**提交即预告**✓(seq8 规划预告 @11:31:23,回合启动后 14 秒内;seq301 派发预告 @11:57:02);**规划提速(R2)**✓(状态行 default-medium,seq33;实测规划 305.6 秒(约 5 分钟)含第 2 次尝试,对比修复前 12–13 分钟);**规划期心跳**✓(seq9–14 共 6 条、间隔恰 45s);**执行期心跳(R3)**✓(57 条【派发执行中】、轮内 54 个间隔恰 45s,轮次间按 finally 收束停止属预期);**专家开工预估上报**✓(seq73/106/365–367/370);**主会话 dsh_workplan_* 工具面**✓(主会话直接调用 11 次,重启前缺失未复现)。**如实标注**:「re-review 不再中断(R1)」本会话无活体案例,由 workplan-252-stall-fix 7 例行为级测试覆盖、待重启后活体观察;叶子先思考后开工门禁的登记环节活证据成立,但接续环节在运行进程中被 D1 杀死(见下条),修复后由 D1-1/2/3 测试覆盖、活体复验待再次重启。**重启后新鲜全量复测(T5b,runner 实测口径)**:npm run verify **850 pass / 0 fail / 0 cancelled / exit 0**(含 D1/D2 新增 7 例;重启前 stall-fix 末轮基线 843/0/0)、tsc 零错误(CHECK_EXIT=0)、定向 5 文件 39/39(FOCUSED_EXIT=0)、全日志 not ok=0;证据 reports/T5b-verify-full.log / T5b-check.log / T5b-focused.log 与 reports/T5b-regression-acceptance.md。
|
|
134
|
+
- **D1 叶子接续死亡 + D2 陈旧结算备份误采纳(用户 2026-11-12 硬要求:查明并必须修复 T1/T2 四个叶子子任务自动停止;诊断 reports/D1-D2-root-cause-diagnosis.md,修复 T4b,独立验收 T5b)**:
|
|
135
|
+
- **D1 现象/根因**:四个第三层叶子在 self_effort 登记后 12–16ms 全部 aborted,接续会话从未创建、失败台账路径未执行。根因:selfEffortTool 用属性访问 `(ctx as any).agents?.get?.(leaderId)` 取负责人 agent,而 inject 清单(host.ts:82)不含 `agents`,Cordis 上下文代理对未注入服务的属性访问直接抛 `cannot get property "agents" without inject`(可选链挡不住代理 getter 抛错);异常发生在 interrupt 之后、startActivation 之前且无 try/catch → 叶子永久死亡(叶子 cffc015b seq18 抛错原文、11:38–11:46 无新会话目录、projcache `(self:` 零命中实证)。
|
|
136
|
+
- **D1 修复(T4b,最小治本)**:负责人 agent 解析移到 interrupt 之前,改宿主同款安全访问器 `ctx.get('agents')` + 整体 try/catch(旧夹具回退属性访问也在保护内);解析失败 ⇒ 不中断 phase-0、自配档与两轮思考产物登记保留、显式 `SELF_EFFORT_CONTINUATION_FAILED`(重派读档直连 phase-1 路径可用);接续 startActivation 的 signal 改独立 `new AbortController().signal`(平台驱动重激活不得被 phase-0 回合中断牵连)。落点 src/runtime.ts:7365-7382、7420;既有两次重试/失败台账/childId 更新/结算回调原样保留。
|
|
137
|
+
- **D2 现象/根因**:结果块缺失时的盘上备份恢复路径读固定文件名 `reports/wp-settlement-<subtaskId>.json` 且无归属/新鲜度校验,误采纳陈旧 wp-settlement-T1.json(截图任务)→ T1 假完成、wp-settlement-T2.json(基金任务)→ T2 误 blocked,T3/T4/T5 级联冻结;跨计划复用同名文件使陈旧副本必然存在。
|
|
138
|
+
- **D2 修复(T4b)**:采纳前双闸——新鲜度 `mtimeMs >= startedAt` + 归属(备份顶层 planId/subtaskId 必须与当前计划/子任务一致,裸 JSON 与证据标记块双入口);任一不满足 ⇒ 不采纳、record.errors 审计留痕(含文件 mtime 与 startedAt 的 ISO 值)、落回既有 EVIDENCE_MISSING 有界回喂(缺失永不计 done 的严格性不变);提示词同步要求备份本次执行新写覆盖旧文件、顶层必带 planId/subtaskId(childId 若已知也带)。落点 src/runtime.ts:2577-2640、src/plan.ts:5645。
|
|
139
|
+
- **验证(T5b 独立验收,全部 runner 实测)**:新增 tests/workplan-253-continuation-settlement.test.ts 7 例(D1-1/2/3 + D2-1/2/3/4,全量 ok646–652、定向 ok17–23);全量 850/850/0/0 exit 0、tsc 零错误、定向 39/39;14 个既有四角色门禁/stall-fix/结算套件逐一核验无回归;修复落点逐行读码核验全部命中;改动恰 5 个已跟踪文件(211+/24-)+1 新增测试,无夹带;测前=测后 HEAD/工作树/sha256 一致(证据绑定确切构建)。夹具契约适配披露:evidence-missing-retry A2 用例以 utimesSync 置未来 mtime 模拟「尝试内新写」,语义断言零改动(新契约直接要求,非放宽闸)。
|
|
140
|
+
- **生效交接(D1/D2,需用户执行)**:运行中宿主(pid 16910,11:29:53 启动)加载 11:23:20 构建、不热加载 lib/;盘上 lib/ 已含 D1/D2 修复(12:24:43 重建,哈希经 T5b 绑定),**须用户再次手工重启 dsh web 才在运行态生效**(规则 18,禁止自行重启)。**重启前过渡纪律**:第三层叶子派发在运行进程中仍会触发旧 D1 死亡——各部门负责人一律直接执行、禁止 delegate dispatch 叶子(review 分工表照常登记留痕但不下派);负责人自身 phase-0→phase-1 接续不受影响(已实证存活)。结算备份纪律(D2 教训):各子任务备份必须本次新写、顶层带 planId/subtaskId。重启后用 T2b 同款三证法复核加载新构建,并活体复验叶子接续与 re-review 不中断。版本号沿用 2.5.2(用户尚未定版是否递增,不擅自改动)。
|
|
141
|
+
|
|
142
|
+
## 2.5.1 — 2026-11-11
|
|
143
|
+
|
|
144
|
+
- **两轮深度思考协议(用户要求 1,底层机制升级)**:三阶段工作法的规划阶段升级为用户 2026-11-11 强制的「两轮深度思考」协议,部门负责人、部门里相关领域的全球顶尖专家、部门里组员三层执行者在执行自己的任务时同一口径:① 第一轮 · 任务深研——先全面、全盘、深入梳理、研究、思考自己的任务(→ phases.planning.problemAnalysis);② 第二轮 · 理清方法流程步骤——基于刚才第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清自己的思路,理清自己该具体如何一步步执行、达到最终完美完成自己任务的方法、流程和步骤(→ phases.planning.approach);③ 执行——最后,基于刚才第二轮理清楚的所有方法、流程、步骤,开始具体的执行工作。三步顺序与依赖不可颠倒:第二轮必须消费第一轮的全部结果,执行必须消费第二轮的方法、流程、步骤。
|
|
145
|
+
- **第二轮依据成为结构化必填证据(新增 approachBasis)**:「基于前一步完成好的所有结果」不再只是提示词——phases.planning.approachBasis(至少 1 条、合计 ≥20 字)要求逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤,两轮之间的依赖可审计;缺依据/依据太薄 ⇒ 规划阶段判未完成(PHASE_GATE 回喂待补项),不得记 done。THREE_PHASE_VERSION 1→2;problemAnalysis/approach 字段名保留、语义升级为两轮产物。在途旧结算证据缺 approachBasis 时按既有有界回喂通道要求补齐(强制口径,不是静默放行)。
|
|
146
|
+
- **负责人再分配硬门禁同口径**:planDelegations 在角色配比校验之后新增两轮产物闸——approach(第二轮方法、流程、步骤)与 approachBasis(第二轮依据)各至少 1 条,缺一拒绝 DELEGATE_CONSOLIDATION_INCOMPLETE、dispatch 不放行;缺 problemAnalysis/assignments/角色配比的旧拒因顺序不变。dsh_workplan_delegate 工具 consolidation schema 同步新增 approachBasis 并把 approach/approachBasis 列为必填;applyStatus 消毒与 durable workplan-update 回放写入/消费双侧接线(approachBasis 刷新/重启不丢)。旧计划状态回放不报错(新字段缺省为空);旧梳理产物缺第二轮依据时 dispatch 要求重新 review 补齐(协议强制口径)。
|
|
147
|
+
- **三层任务书注入单一事实源**:threePhasePromptLines 重写为两轮深度思考协议(第一轮/第二轮/执行依赖 + approachBasis 自检),二级任务书(buildChildPrompt)与三级任务书(buildDelegateePrompt)共享同一注入;buildLlmRulesBrief 负责人 tier 改写为「执行自己的任务先两轮深度思考,再执行与再分配」,专家/组员 tier 新增协议全文;两份任务书的执行要求各新增一条两轮深度思考强制行。dsh_workplan_verify 工具 planning schema 同步新增 approachBasis 必填。
|
|
148
|
+
- **版本统一 2.5.1(用户要求 3 定版)**:package.json / package-lock.json×2 / src/host.ts meta / tests/fixtures/tool-surface.json / README 三语徽章与安装行 / 版本回归断言(workplan-250-head-delegation 要求5 断言随定版升级)。新增 tests/workplan-251-deep-think.test.ts 回归;既有字段与校验原样保留。生效需 npm run build 后由用户手工重启 dsh web(宿主侧无热加载)。
|
|
149
|
+
|
|
150
|
+
## 2.5.0 — 2026-11-11
|
|
151
|
+
|
|
152
|
+
- **部门负责人再分配权限根因修复(用户要求 1)**:2.3.9 已交付 `dsh_workplan_delegate` 工具,但二级任务书 `buildChildPrompt` 的执行要求仍写着「不要派生新的 Agent」「你没有派发权限」——负责人同时收到「必须再分配」(llmRulesBrief)与「没有派发权限」(执行要求)两套矛盾指令,普遍不敢行使再分配。本版把禁令改写为精确边界:负责人**拥有本部门内再分配权限**(dsh_workplan_delegate,先 review 后 dispatch),禁令只针对主计划派发、重启/安装与第四层派生;并新增「本部门再分配权限与推理等级配置」授权段。规划器提示词同步改写(旧「子任务由子 Agent 独立执行:它们没有派发权限」→ 负责人牵头 + 部门内再分配权限)。
|
|
153
|
+
- **三层执行者推理等级自配置(用户要求 2,机制升级)**:由「负责人配置整体等级、下级未单独配档时继承」升级为**先配置后开工、各自自配全程自用、平台强制接续**。① 先配置后开工(平台强制):部门负责人与第三层专家/组员会话在未登记自配档时一律以 low 启动 phase-0——唯一职责是评估自身任务复杂度并提交自配;负责人经 `delegate(action="review")` 的 `consolidation.taskReasoningEffort` 提交(即负责人自配整体档),专家/组员经新增 `delegate(action="self_effort")` 提交(`reasoningEffort`+`complexityRationale` 必填:缺依据拒绝 `SELF_EFFORT_RATIONALE_MISSING`、非法档拒绝 `SELF_EFFORT_INVALID`、非第三层叶子拒绝 `SELF_EFFORT_NOT_LEAF`、已结算拒绝 `ALREADY_DONE`);phase-0 结束仍未登记自配 ⇒ 明确 `SELF_EFFORT_MISSING` 回喂(有界重试),禁止静默以 low 档继续正式任务。② 自配为权威:成员自配档为权威,分工表 per-member 档降为建议;下级不再继承负责人整体档,各层自配全程自用。③ 平台强制接续:宿主在子会话创建时解析推理等级、同会话换档不可行,故登记后平台立即 `interruptByParent(continuable)` 中断 phase-0 回合,新激活携带 phase-0 产物与完整任务书、以自配档接续同一任务进入 phase-1(继续勿重做;childId 台账同步更新,旧结算回调按旧 childId 自动失配);接续不是重试——不消耗 attempt 预算;接续失败重试 1 次仍败则明确报 `SELF_EFFORT_CONTINUATION_FAILED`,禁止静默降档;每次激活(首发/重试/续跑/中断后新激活)经 `resolveTaskEffort` 单一判据读档,自配档优先于规划器档位;尝试重置后 `delegateSelfEfforts` 保留,重派直接以已自配档接续 phase-1(不再 phase-0)。④ 持久化与回放:负责人自配写入状态行 `effortOverride`,成员自配写入 `delegates[].selfEffort`(越界钳制留痕 `selfEffortRequested`)与 `delegateSelfEfforts` 回落源,均经 applyStatus 五档白名单消毒(非法 `delegateSelfEfforts` 拒绝 `INVALID_DELEGATE_SELF_EFFORTS`)+ durable workplan-update 回放(写入与消费双侧接线,G1 教训),刷新/重启不丢;越界档按模型家族合法集合钳制并留痕,非法整体档仍拒绝 `DELEGATE_TASK_EFFORT_INVALID`。旧「下级未单独配档时继承整体等级、整体也未配置则回落 low」的继承回落口径废止;无新字段的旧计划回放零迁移。
|
|
154
|
+
- **分解更简单、多人承担(用户要求 3)**:规划器提示词新增硬规则——每个子任务单一目标、单一主产物、可独立验收,执行细节下沉到部门内分工;负责人任务书与 delegate 工具描述要求每位下级只承担一项简单工作,expert 与 member 各至少 1 名、最多 6 人共同承担。
|
|
155
|
+
- **版本统一 2.5.0(最终定版,含版本统一说明)**:原「2.5.1」仅为版本标签改动、无任何功能差异,按用户最终指令定版 2.5.0 并入本条目,不再单独设节。版本号逐处统一为 2.5.0:package.json / package-lock.json×2(顶层 version 与 packages[""].version)/ src/host.ts meta / lib/ 编译产物(lib/host.js 等,由 npm run build 再生)/ tests/fixtures/tool-surface.json / README 三语徽章与安装行(三语徽章此前滞留 2.3.9,一并修正)/ 版本回归断言(tests/version-sync.test.ts 一致性断言、tests/workplan-250-head-delegation.test.ts 要求5 版本断言)。本轮按用户要求全程禁用插件执行,重新启用需用户手工重启 dsh web。
|
|
156
|
+
- 新增 `tests/workplan-250-head-delegation.test.ts` 回归;要求2 自配置机制新增 `tests/workplan-250-self-effort.test.ts` 9 例回归;既有字段与校验原样,旧计划零迁移。生效需 `npm run build` 后由用户手工重启 dsh web(宿主侧无热加载)。
|
|
157
|
+
|
|
158
|
+
## 2.3.10 — 2026-11-11
|
|
159
|
+
|
|
160
|
+
- **分配前会话内耗时预告(用户要求1,T2 最小机制补丁)**:此前耗时预告只有专家开工后的 timeNotice 上报,规划前与派发前会话内零输出。本版在三个落点追加机制(均为追加式 notice/提示词,不改任何 schema 与工具参数/输出):P1 `runtime.ts maybePlan` 在 runPlanner 之前经唯一合规写入器 `appendUserMessage` 发【规划预告】——预估口径=单次规划窗口(normalisePlannerWindow 同源解析,含配置/环境变量覆盖)一半向上取整、至少 1 分钟,默认窗口 300s → 约 3 分钟,文案带窗口/重试口径与 O-5b「仅供参考,非承诺」标注;P2 `runtime.ts dispatchTool` 在通过全部拒绝闸门后、启动任何子 Agent 之前发【派发预告】——复用 `estimatePlanMinutes` 下界估算(estimateMinutes+并发度),按 planId 幂等守卫(重复派发/续跑/join 在途回合不刷屏,重规划新 planId 自然重新预告);P3 `host.ts PROMPT_SECTION` 追加主 Agent 硬规则「调用 dsh_workplan_dispatch 前必须先在会话中告知用户预估耗时(含数值与单位分钟、非承诺标注)」。文案纯函数 `planningEstimateMinutes` / `buildPlanningPreAnnouncement` / `buildDispatchPreAnnouncement` 落 `plan.ts`,新增 `tests/preannounce-2-3-10.test.ts` 6 例回归;`workplan-stuck-recovery` 的轮级结果消息计数按该用例本意排除新增预告通知。estimateMinutes / reasoningEffort 等既有字段与校验原样,旧计划零迁移。生效需 `npm run build` 后由用户手工重启 dsh web(宿主侧无热加载)。
|
|
161
|
+
|
|
1
162
|
## 2.3.9 — 2026-11-11
|
|
2
163
|
|
|
3
164
|
- **LLM 家族检测 + 推理等级事前约束(用户要求 1/2)**:新增单一事实源 `src/llm-rules.ts`——模型 ID 去空白转小写后以 `qwen` 前缀判定家族;qwen 系合法推理等级集合 `{low, medium, xhigh}`、非 qwen 系 `{low, high, max}`,并按任务复杂度映射(轻度=low;中等 qwen=medium/非qwen=high;非常复杂 qwen=xhigh/非qwen=max)。约束在**发送前**生效:规划器默认档取当前家族合法集最高档、派发侧子任务档位先按家族静态集收窄、再与宿主声明档位取交集钳制,两道闸各自 `console.warn` 留痕(model/family/requested/corrected/allowed/reason)。`plan.ts` 校验、`replan.ts` 入口、`client.ts` 渲染口径同源消费;五档仍为存储全集,旧计划/他模型计划回放零迁移。越界档不中断派发,按强度序自动降级并留痕(报错轨 `validateReasoningEffort` + 修正轨 `correctEffortForModel`)。
|
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
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.1)
|
|
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@
|
|
83
|
+
dsh plugin --profile web add dsh-workplan@3.0.1
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
Restart the DSH Web process (or reload the page) so the bundle is picked up.
|
|
@@ -102,7 +102,7 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
102
102
|
4. Open **Task progress** in the sidebar:
|
|
103
103
|
|
|
104
104
|
- five headline numbers: **tasks / work items / done / in progress / blocked**;
|
|
105
|
-
- plan cards grouped into **In progress**, **Ended** and **Completed**, each with a completion rate. **Ended** means the turn has stopped (nothing is running) while the plan is still unfinished; the card also says where it stopped (
|
|
105
|
+
- plan cards grouped into **In progress**, **Ended** and **Completed**, each with a completion rate. **Ended** means the turn has stopped (nothing is running) while the plan is still unfinished; the card also says where it stopped (paused / stuck / not started) and resuming is one sentence away;
|
|
106
106
|
- expand any plan to see per-stage progress and who owns each work item.
|
|
107
107
|
|
|
108
108
|
Every number is derived from the same task state — the panel can no longer claim "0 in progress" while the list below shows work running. That inconsistency is exactly what 1.4.3 fixed.
|
|
@@ -117,9 +117,9 @@ Every number is derived from the same task state — the panel can no longer cla
|
|
|
117
117
|
| `dsh_workplan_cancel` | Cancel a plan that has not been dispatched; never fabricates completion. |
|
|
118
118
|
| `dsh_workplan_replan` | Amend in place when the request changes: `cancel` / `replace` / `add`. Superseded rows are kept as history; the plan revision increases. Main agent only. |
|
|
119
119
|
| `dsh_workplan_escalate` | A child reports a blocker mid-run (question, options, recommendation) into the state machine and waits for direction, instead of only writing `BLOCKED` at the very end. |
|
|
120
|
-
| `dsh_workplan_instruct` | The main agent answers an escalation and issues direction; if delivery fails the instruction is queued for the next activation.
|
|
120
|
+
| `dsh_workplan_instruct` | The main agent answers an escalation and issues direction; if delivery fails the instruction is queued for the next activation. A 60-second acknowledgement reminder is advisory only and never blocks or aborts work. |
|
|
121
121
|
| `dsh_workplan_handoff` | Resolve cross-department needs: `list` / `assign` / `resolve` / `close`. Unresolved needs block delivery; when the asking row is waiting for direction, `resolve` delivers the answer straight into the child session. |
|
|
122
|
-
| `dsh_workplan_followup` | Send a closing note to a direct child that
|
|
122
|
+
| `dsh_workplan_followup` | Send a closing note to a stopped or paused direct child that already wrote its artifacts. |
|
|
123
123
|
| `dsh_workplan_verify` | Child agents submit their three-phase evidence for phase-3 (verification) checking; calls from phases 1–2 return `PHASE_GATE`. Passing verification is not completion — the completion gate re-checks the same evidence. |
|
|
124
124
|
| `dsh_workplan_lessons` | Read-only view of the permanent lesson memory: `list` / `search` / `stats`. Never changes plan state; used to audit what was remembered and which mistakes keep repeating. |
|
|
125
125
|
|
|
@@ -138,25 +138,27 @@ Phase 3 also requires a **retrospective** (`retrospective` inside `phases.verifi
|
|
|
138
138
|
|
|
139
139
|
A passing retrospective is appended to the **permanent lesson memory** at `~/.dsh/workplan/lessons.jsonl` (override with `DSH_WORKPLAN_LESSONS_FILE`). Before each dispatch, the most relevant lessons are ranked by department, project, keyword overlap, recurrence count and recency, then injected into the child prompt (max 8), labelled explicitly as historical data rather than new instructions. A repeated mistake increments `occurrences` and moves up the ranking instead of creating a duplicate — that is the self-iteration loop. A corrupt line is skipped instead of poisoning the whole file; the store keeps the most recent 500 records and writes atomically.
|
|
140
140
|
|
|
141
|
-
##
|
|
141
|
+
## Execution time, health checks, and resumes
|
|
142
142
|
|
|
143
|
-
|
|
143
|
+
**Department leads and domain experts have no whole-round, per-attempt, idle, or acknowledgement time limit.** Estimates are coordination information only: they never create deadlines or decide `done`. The legacy 10-minute completion criterion is disabled and cannot be re-enabled through environment variables. `extendMs` remains a compatibility input but returns `TIME_LIMITS_DISABLED` without changing a timer.
|
|
144
|
+
|
|
145
|
+
| Setting | Current behavior | Configuration |
|
|
144
146
|
|---|---|---|
|
|
145
|
-
|
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
| Planner no-progress ceiling | 5 min
|
|
149
|
-
| Planner stall window | 90 s
|
|
150
|
-
| Planner absolute ceiling | 15 min
|
|
151
|
-
| Automatic resumes |
|
|
147
|
+
| Lead/expert round and attempt execution | **Unlimited**: ends on a real result, a real error, evidence/quality gates, or explicit user cancellation | Legacy `DSH_WORKPLAN_TOTAL_TIMEOUT_MS`, `DSH_WORKPLAN_CHILD_TIMEOUT_MS`, `totalTimeoutMs`, `childTimeoutMs`, and subtask `timeoutMs` never create a deadline |
|
|
148
|
+
| Idle and acknowledgement monitoring | Observation and reminders only; no time-only `blocked` status or abort | Legacy `DSH_WORKPLAN_IDLE_TIMEOUT_MS` does not limit execution |
|
|
149
|
+
| Dispatch tool | No `timeoutMs`; `async` returns immediately, while `wait` waits for actual settlement | Prefer `async` for long work, with `status` and explicit `cancel` |
|
|
150
|
+
| Planner no-progress ceiling | 5 min from the last output chunk; planning only, not lead/expert execution | `DSH_WORKPLAN_PLANNER_TIMEOUT_MS` |
|
|
151
|
+
| Planner stall window | 90 s of missing output after streaming starts; transport health only | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
|
|
152
|
+
| Planner absolute ceiling | 15 min; planning only | Scales with `…_PLANNER_TIMEOUT_MS` |
|
|
153
|
+
| Automatic resumes | 2; non-time pause recovery, not an execution clock | `DSH_WORKPLAN_MAX_RESUMES` |
|
|
152
154
|
| Subagent concurrency | 5 (fixed) | — |
|
|
153
155
|
|
|
154
|
-
|
|
156
|
+
Individual model connections, Bash commands, and disposal waits retain their local health checks; they are not department task deadlines. Without automatic time-based termination, genuinely stuck work can keep consuming concurrency and spend, so use the dashboard/`status` and explicitly cancel or redirect it. Legacy deadlines, extension journals, timeout counts, and criterion fields remain readable history but never arm new timers.
|
|
155
157
|
|
|
156
|
-
|
|
158
|
+
Non-time settings can still be placed in the plugin config:
|
|
157
159
|
|
|
158
160
|
```jsonc
|
|
159
|
-
{ "
|
|
161
|
+
{ "maxResumes": 2 }
|
|
160
162
|
```
|
|
161
163
|
|
|
162
164
|
## Security and privacy
|
|
@@ -219,7 +221,7 @@ The fix removes the cached snapshot: every number is derived at serialisation ti
|
|
|
219
221
|
|
|
220
222
|
**Numbers are lower than before.** That is the fix: 1.4.3 derives them from real state, and the old numbers were frequently inflated.
|
|
221
223
|
|
|
222
|
-
**A subagent stopped moving.** Five minutes without
|
|
224
|
+
**A subagent stopped moving.** Five minutes without events no longer blocks or aborts it. Inspect the dashboard/`status`, then explicitly cancel the plan/subtask or send an `instruct` update. This preserves human control without killing long reasoning or large tasks.
|
|
223
225
|
|
|
224
226
|
## Uninstall
|
|
225
227
|
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
|
|
4
4
|
|
|
5
5
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.1)
|
|
7
7
|
|
|
8
8
|
给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
|
|
9
9
|
|
|
@@ -62,14 +62,14 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
|
|
|
62
62
|
|
|
63
63
|
| 要求 | 说明 |
|
|
64
64
|
|---|---|
|
|
65
|
-
| DeepSeek Harness |
|
|
65
|
+
| DeepSeek Harness | **≥ 0.2.2-rc.3**(官方 Web 版,`dsh web` / `--profile web` 跑的这套;`engines.dsh` 会拦截过低版本) |
|
|
66
66
|
| Node.js | **22 或更高**(`node -v` 自查) |
|
|
67
67
|
| 网络 | 安装时需要能访问 npm registry |
|
|
68
68
|
|
|
69
69
|
## 一键安装
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
dsh plugin --profile web add dsh-workplan@
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@3.0.1
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -93,7 +93,7 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
93
93
|
4. 点左侧栏的**「任务进度」**,就能看到:
|
|
94
94
|
|
|
95
95
|
- 顶部五个数字:**几个任务 / 分配了多少件工作 / 做好了 / 正在做 / 卡住了**;
|
|
96
|
-
- 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」=
|
|
96
|
+
- 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」= 这一轮已经停了(没有东西在跑)但计划还没做完,卡片会写清停在哪儿(已暂停 / 卡住了 / 还没开始),说一句「继续」即可接着推进;
|
|
97
97
|
- 展开任意计划:每个阶段的进度、每件具体工作由哪个部门负责、当前状态。
|
|
98
98
|
|
|
99
99
|
5. 进度数字背后的每一行,都来自同一份任务状态——**不会再出现「显示 0 个正在做、但下面明明写着正在做」这种自相矛盾**(1.4.3 专门修的就是这个,见下文)。
|
|
@@ -110,9 +110,9 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
110
110
|
| `dsh_workplan_cancel` | 取消还没派发的计划,不会伪造任何「已完成」。 |
|
|
111
111
|
| `dsh_workplan_replan` | 需求变更时就地修订:`cancel` / `replace` / `add`,旧行标为「已取代」保留可追溯,计划版本号递增。主 Agent 专用。 |
|
|
112
112
|
| `dsh_workplan_escalate` | 子 Agent 执行中遇阻上报:问题、选项、建议进状态机,等主 Agent 指示;不再是「只能憋到结尾写 BLOCKED」。 |
|
|
113
|
-
| `dsh_workplan_instruct` | 主 Agent
|
|
113
|
+
| `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。60 秒无回执只提示,不按时间判失败或中止。 |
|
|
114
114
|
| `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
|
|
115
|
-
| `dsh_workplan_followup` |
|
|
115
|
+
| `dsh_workplan_followup` | 给已中止或暂停、但产物已落盘的直接子会话补一条收尾说明。 |
|
|
116
116
|
| `dsh_workplan_verify` | 子 Agent 在**阶段三(验证阶段)**提交三阶段证据做核验;阶段一、二调用会返回 `PHASE_GATE`。核验通过≠完成,最终仍由完成判定复核。 |
|
|
117
117
|
| `dsh_workplan_lessons` | 只读查看**永久教训记忆**:`list` / `search` / `stats`。它只读文件,不改计划状态;用来核对「到底记住了什么、哪些错误在重复发生」。 |
|
|
118
118
|
|
|
@@ -165,26 +165,30 @@ DSH_WORKPLAN_LESSONS_FILE=/path/x.jsonl # 需要时用环境变量覆盖
|
|
|
165
165
|
|
|
166
166
|
完整的角色、数据契约、状态机、失败恢复与「改代码时必须同步的三处」,见 **[协作契约](https://github.com/abbaababa/dsh-workplan/blob/main/docs/collaboration.md)**;12 个部门的职责与交接清单见 **[部门职责与交接约定](https://github.com/abbaababa/dsh-workplan/blob/main/docs/departments.md)**。
|
|
167
167
|
|
|
168
|
-
##
|
|
168
|
+
## 执行时限、健康保护与续跑
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
**部门负责人和部门相关领域全球顶尖专家没有任务总时限、单次执行时限、无进展终止时限或回执终止时限。** 事前预估仅用于协调和向用户说明,不会派生截止时间,也不会影响 `done` 验收;`extendMs` 只保留旧调用兼容并返回 `TIME_LIMITS_DISABLED`,不会真的延期。历史上的 10 分钟完成判据已停用,环境变量不能重新开启。
|
|
171
|
+
|
|
172
|
+
| 项 | 当前行为 | 配置说明 |
|
|
171
173
|
|---|---|---|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
| 规划器无进展上限 | 5
|
|
176
|
-
| 规划器静默判定 | 90
|
|
177
|
-
| 规划器绝对上限 | 15
|
|
178
|
-
| 自动续跑次数 |
|
|
174
|
+
| 负责人/专家整轮与单次执行 | **无时限**,直到自然完成、真实错误、证据/质量门禁或用户显式取消 | 旧 `DSH_WORKPLAN_TOTAL_TIMEOUT_MS`、`DSH_WORKPLAN_CHILD_TIMEOUT_MS`、`totalTimeoutMs`、`childTimeoutMs`、子任务 `timeoutMs` 均不再形成截止 |
|
|
175
|
+
| 无进展与回执 | 保留观测和提醒,不因静默或回执超期自动 `blocked` / 中止 | 旧 `DSH_WORKPLAN_IDLE_TIMEOUT_MS` 不形成执行限制 |
|
|
176
|
+
| `dispatch` 工具 | 不声明工具执行期限;`async` 立即返回,`wait` 会一直等到本轮实际收束 | 长任务建议使用 `async`,配合 `status` 查询和显式 `cancel` |
|
|
177
|
+
| 规划器无进展上限 | 5 分钟(自上一个输出块起算;仅约束生成计划,不约束负责人/专家执行) | `DSH_WORKPLAN_PLANNER_TIMEOUT_MS` |
|
|
178
|
+
| 规划器静默判定 | 90 秒(仅规划输出传输健康保护) | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
|
|
179
|
+
| 规划器绝对上限 | 15 分钟(仅规划器) | 随 `…_PLANNER_TIMEOUT_MS` 等比变化 |
|
|
180
|
+
| 自动续跑次数 | 2 次(处理可续跑的非时间暂停,不是执行时钟) | `DSH_WORKPLAN_MAX_RESUMES` |
|
|
179
181
|
| 并发子 Agent | 5 个(固定) | — |
|
|
180
182
|
|
|
181
|
-
|
|
183
|
+
单次模型网络请求、单条 Bash 命令和清理等待仍有各自的局部健康保护;它们不是部门任务的总时限,不能用一条慢命令的传输超时替代整个任务 deadline。后台任务也不能绕过用户显式取消。
|
|
184
|
+
|
|
185
|
+
没有自动时间终结后,真正卡住的执行可能持续占用并发和费用:请看板提示与 `status`,由用户明确取消或指示处理。旧记录中的 `deadlineAt`、延期日志、超时计数和判据字段只用于历史回放,不会重新武装计时器。
|
|
182
186
|
|
|
183
|
-
|
|
187
|
+
非时间的资源与续跑配置仍可写在启动 DSH 的 shell 或插件配置中,例如:
|
|
184
188
|
|
|
185
189
|
```jsonc
|
|
186
190
|
// cordis.patch.yml 里的 config 字段
|
|
187
|
-
{ "
|
|
191
|
+
{ "maxResumes": 2 }
|
|
188
192
|
```
|
|
189
193
|
|
|
190
194
|
## 安全与隐私(可以自己复核)
|
|
@@ -239,6 +243,16 @@ npm audit --omit=dev
|
|
|
239
243
|
|
|
240
244
|
</details>
|
|
241
245
|
|
|
246
|
+
## 和 DSH 内置的子代理是什么关系(重要)
|
|
247
|
+
|
|
248
|
+
DSH 本身自带「子智能体」能力(内置 subagent 工具)。本插件**不替换、也不关闭**它,两者同时存在,请知道这三件事:
|
|
249
|
+
|
|
250
|
+
1. **插件的部门负责人/专家**由插件统一派发和管理,走 `dsh_workplan_delegate` 等 11 个工具的全部闸门(事前预估、分工表、两轮深度思考、结算核验、汇报核验)。
|
|
251
|
+
2. **内置 subagent 工具在这些子会话里仍然可见**。如果模型绕过插件、直接调用内置 `subagent` / `subagent_fork`,那个人会话**不经过插件的任何闸门**(无台账、无核验、无执行管理),产物也不会自动进计划看板。发现看板外多出来路不明的子会话时,对它说「以后派活一律走 dsh_workplan」即可。
|
|
252
|
+
3. **设置页两个子代理选项对本插件的影响不同**(已核实宿主源码,两条通道互不相干):
|
|
253
|
+
- 「子代理最大深度」(`subagent.maxDepth`)**只管内置 subagent/subagent_fork 工具**——本插件的三层体系(你 → 部门负责人 → 专家)按派发契约固定申请第 2 层深度,宿主对插件契约单独放行,**该滑块在任何位置都不会影响、也不会拦阻**负责人派发给专家。首次检测到该设置 <2 时插件会一次性说明这一点(无需任何操作;想完全一致可把滑块调到 2,重启后恢复默认);
|
|
254
|
+
- 「子代理最大并发」(`maxActiveSubagents`)**对本插件生效**——超上限时插件会明确提示「稍后重试或调大该设置」。
|
|
255
|
+
|
|
242
256
|
## 常见问题
|
|
243
257
|
|
|
244
258
|
**装完没反应?**
|
|
@@ -251,7 +265,7 @@ npm audit --omit=dev
|
|
|
251
265
|
1.4.3 之后数字来自真实状态而不是缓存,所以会比旧版本「更小、但更准」(旧版本的完成率经常虚高)。
|
|
252
266
|
|
|
253
267
|
**子 Agent 卡住不动?**
|
|
254
|
-
5
|
|
268
|
+
插件不会再仅因 5 分钟没有新事件就自动判失败或中止。请查看「任务进度」和 `status`;确认需要停止时明确说「取消这个计划/子任务」,需要调整时用 `instruct` 下达指示。这样保留人工控制,也避免长时间深思或大型任务被误杀。
|
|
255
269
|
|
|
256
270
|
## 卸载
|
|
257
271
|
|
package/README.zh.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
|
|
4
4
|
|
|
5
5
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.1)
|
|
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@
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@3.0.1
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
|
@@ -93,7 +93,7 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
93
93
|
4. 点左侧栏的**「任务进度」**,就能看到:
|
|
94
94
|
|
|
95
95
|
- 顶部五个数字:**几个任务 / 分配了多少件工作 / 做好了 / 正在做 / 卡住了**;
|
|
96
|
-
- 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」=
|
|
96
|
+
- 计划卡:分「进行中」「已结束」「已完成」三组,右上角是完成率。「已结束」= 这一轮已经停了(没有东西在跑)但计划还没做完,卡片会写清停在哪儿(旧版预算/超时历史、真实异常 / 还没开始),说一句「继续」即可接着推进;
|
|
97
97
|
- 展开任意计划:每个阶段的进度、每件具体工作由哪个部门负责、当前状态。
|
|
98
98
|
|
|
99
99
|
5. 进度数字背后的每一行,都来自同一份任务状态——**不会再出现「显示 0 个正在做、但下面明明写着正在做」这种自相矛盾**(1.4.3 专门修的就是这个,见下文)。
|
|
@@ -112,7 +112,7 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
112
112
|
| `dsh_workplan_escalate` | 子 Agent 执行中遇阻上报:问题、选项、建议进状态机,等主 Agent 指示;不再是「只能憋到结尾写 BLOCKED」。 |
|
|
113
113
|
| `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。带 60s/180s 回执检查。 |
|
|
114
114
|
| `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
|
|
115
|
-
| `dsh_workplan_followup` |
|
|
115
|
+
| `dsh_workplan_followup` | 给因真实异常或用户取消而中断、但产物已落盘的直接子会话补一条收尾说明。 |
|
|
116
116
|
|
|
117
117
|
在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
|
|
118
118
|
|
|
@@ -127,27 +127,23 @@ dsh plugin --profile web add "$(pwd)"
|
|
|
127
127
|
|
|
128
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
129
|
|
|
130
|
-
##
|
|
130
|
+
## 执行时限、健康保护与续跑(知道这些就不会误以为卡死)
|
|
131
131
|
|
|
132
|
-
|
|
132
|
+
**部门负责人和部门相关领域全球顶尖专家执行任务没有时限**:没有总时长、单次时长、空闲无进展、未回执或 10 分钟验收门槛。平台不会仅因执行较久、暂时没有新事件或未立即回执而中止、判 blocked、换人接手或拒绝 done。旧版 `totalTimeoutMs`、`childTimeoutMs`、`idleTimeoutMs`、`extendMs`、`timeoutMs` 及由此写入的旧 `deadlineAt` 都不会再生成计时器,只作为历史信息展示;派发工具也不再声明任何 `timeoutMs`。
|
|
133
|
+
|
|
134
|
+
| 项 | 当前行为 | 怎么改 |
|
|
133
135
|
|---|---|---|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
| 子 Agent 无进展判定 | 5 分钟 | `DSH_WORKPLAN_IDLE_TIMEOUT_MS` |
|
|
136
|
+
| 负责人/专家执行时限 | **无**(预估和时间告知仅作协调信息,不影响验收) | 无需配置 |
|
|
137
|
+
| 用户显式取消/真实错误 | 仍立即收束并保留盘上产物 | 用户直接取消任务 |
|
|
137
138
|
| 规划器无进展上限 | 5 分钟(**自上一个输出块起算**,一直在输出就一直顺延) | `DSH_WORKPLAN_PLANNER_TIMEOUT_MS` |
|
|
138
139
|
| 规划器静默判定 | 90 秒(输出开始后连一个字都不再来才算卡死) | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
|
|
139
140
|
| 规划器绝对上限 | 15 分钟(= 无进展上限 × 3,有无产出都到此为止) | 随 `…_PLANNER_TIMEOUT_MS` 等比变化 |
|
|
140
|
-
| 自动续跑次数 |
|
|
141
|
+
| 自动续跑次数 | 2 次 | `DSH_WORKPLAN_MAX_RESUMES` |
|
|
141
142
|
| 并发子 Agent | 5 个(固定) | — |
|
|
142
143
|
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
环境变量写在启动 DSH 的那个 shell 里,或者写进插件配置:
|
|
144
|
+
这些规划器时限只保护“生成计划”这一步,不会作用到负责人或专家执行。执行阶段只由真实完成、真实错误、证据/质量门禁或用户取消改变;重试可由真实失败触发,不会因计时器到点触发。
|
|
146
145
|
|
|
147
|
-
|
|
148
|
-
// cordis.patch.yml 里的 config 字段
|
|
149
|
-
{ "totalTimeoutMs": 1800000 } // 30 分钟
|
|
150
|
-
```
|
|
146
|
+
旧版本写进 shell 或 `cordis.patch.yml` 的 `{ "totalTimeoutMs": 1800000 }` 可以继续被读取用于历史回放,但**不会生效**;不需要为了“无限执行”把它改成 0 或填极大值。
|
|
151
147
|
|
|
152
148
|
## 安全与隐私(可以自己复核)
|
|
153
149
|
|
|
@@ -212,8 +208,8 @@ npm audit --omit=dev
|
|
|
212
208
|
**数字和以前不一样了?**
|
|
213
209
|
1.4.3 之后数字来自真实状态而不是缓存,所以会比旧版本「更小、但更准」(旧版本的完成率经常虚高)。
|
|
214
210
|
|
|
215
|
-
**子 Agent
|
|
216
|
-
5
|
|
211
|
+
**子 Agent 很久没有新消息,是卡住了吗?**
|
|
212
|
+
不会因为 5 分钟没有新事件就自动判卡住、blocked 或换人。负责人和专家可以持续执行;你可以随时询问进度,或明确取消任务。只有真实完成、真实错误、证据/质量门禁不通过或你显式取消才会改变状态。若之前因旧版本自动中断,对主 Agent 说「续跑这个计划」即可从受阻处继续,已完成的产物不会重做。
|
|
217
213
|
|
|
218
214
|
## 卸载
|
|
219
215
|
|