dsh-workplan 2.3.9 → 3.0.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 +115 -0
- package/README.en.md +2 -2
- package/README.md +2 -2
- package/README.zh.md +2 -2
- package/client.js +68 -8
- package/docs/cc/ADV-FSP-FUNCTIONAL-SPEC.md +3 -3
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +3 -3
- package/lib/client.js +68 -8
- package/lib/comm-format.js +58 -6
- package/lib/criterion.js +215 -0
- package/lib/dept-journal.js +319 -0
- package/lib/host.js +167 -35
- package/lib/llm-rules.js +281 -24
- package/lib/plan.js +1415 -168
- package/lib/replan.js +50 -39
- package/lib/runtime.js +3098 -639
- package/lib/three-phase.js +106 -20
- package/lib/understanding.js +18 -3
- package/lib/v3-contract.js +431 -0
- package/lib/watchdog.js +6 -1
- package/package.json +2 -2
- package/src/client.ts +68 -8
- package/src/comm-format.ts +63 -5
- package/src/criterion.ts +262 -0
- package/src/dept-journal.ts +373 -0
- package/src/host.ts +168 -36
- package/src/llm-rules.ts +349 -27
- package/src/plan.ts +1416 -161
- package/src/replan.ts +48 -37
- package/src/runtime.ts +2518 -139
- package/src/three-phase.ts +147 -20
- package/src/understanding.ts +20 -3
- package/src/v3-contract.ts +470 -0
- package/src/watchdog.ts +6 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,118 @@
|
|
|
1
|
+
## 3.0.0 — 2026-11-14
|
|
2
|
+
|
|
3
|
+
> **定版依据**:用户 2026-11-14 明确要求「优化全部完美完成后,此插件版本定为 3.0.0」,并裁决发布方式为**仅本地**(改版本号 + 构建 + 回归 + 变更说明,不对外发布、不打 tag)。本节下方「low 任务禁止第三层下派」一段原为 2.5.5 候选改动,经用户裁决**整体保留为 3.0.0 基线的一部分**,故并入本节,不再单独定版。
|
|
4
|
+
>
|
|
5
|
+
> **基线原则**:2.5.4 已有的全部强制机制(四角色两轮深度思考门禁、复杂任务 ≥8 人、下属开工预估上报、单任务 ≤10 分钟判据、F1–F9 沟通格式)**一条不减**,本节 13 条改动只做叠加。
|
|
6
|
+
|
|
7
|
+
### 十三条底层机制优化(用户 2026-11-14 原话逐条对应)
|
|
8
|
+
|
|
9
|
+
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)以「用户刚才输入的任务原文(只读锚点,与你最初的输入逐字一致):」逐字写进计划消息,任何回放都能读到原文。
|
|
10
|
+
|
|
11
|
+
2. **收到任务即输出固定文案**:`任务正在分配中,请稍等一下......`。由平台在规划预告之前写入会话(`src/runtime.ts` 的 `maybePlan`,`appendUserMessage(..., { deferUntilHead: true })`),常量定义在 `src/v3-contract.ts` 的 `STATUS_ASSIGNING_TEXT`(6 个半角点,逐字冻结)。
|
|
12
|
+
3. **派发给部门负责人的每个任务必须附质量要求**:新增 `qualityRequirements` 字段并设为**必填**(`src/host.ts` 的 schema、`src/llm-rules.ts` 的 `DelegationAssignment`),缺失即拒 `DELEGATE_QUALITY_REQUIREMENTS_MISSING`;负责人任务书用 `renderQualityRequirementsBlock` 逐条渲染并注明下达方。
|
|
13
|
+
4. **分配完成即输出固定文案**:`任务已经完成分配,正在执行中......`。由 `src/runtime.ts` 的 `dispatchPlan` 在 `record.phase='executing'` 之后写入(`STATUS_ASSIGNED_TEXT`)。两条文案各只发一次,重试/续跑不重复刷屏(提示词同步禁止子 Agent 自行复述这两句)。
|
|
14
|
+
5. **负责人派出的每个任务必须极简(1+1=2)**:新增硬门槛 `checkAtomicAssignment`(`src/v3-contract.ts`):单句、≤300 字符、≥8 字符、禁止并列多目标词(并且/同时/另外/还要/以及/分别/顺便)、禁止分号与多句,且必须带质量要求;不满足即拒 `DELEGATE_TASK_NOT_ATOMIC`,拒因附**可照做的拆小指令**(硬门槛,用户裁决 A)。
|
|
15
|
+
6. **派发给全球顶尖专家的任务必须交代成果要求与质量**:`src/llm-rules.ts` 的 `buildDelegateePrompt` 与 `buildPhaseZeroDelegateePrompt` 固定角色标签为「本部门相关领域全球顶尖专家」,插入质量要求块与专家汇报契约全文。
|
|
16
|
+
7. **专家成果必须极简、JSON 结构化汇报**:新增 F10 门禁与 `checkExpertReport` —— 字段仅 `keyResults` / `keyInfo` / `importantInfo` / `leadRequirements`,每条 ≤200 字符、每字段 ≤6 条,多余字段直接判不合规;重复内容用「完全相同 / 短条被长条包含(≥12 字符)/ bigram Dice ≥ 0.85 近义重复 / 去重键相同」四路拦截。
|
|
17
|
+
8. **负责人必须全面深入汇总本部门全部专家汇报**:F11 门禁用 `expectedExperts` 按名称核对 `sources` 是否覆盖全部专家,缺一即退回。
|
|
18
|
+
9. **取消部门组员角色**:`role` 枚举只剩 `['expert']`;历史 `member` 读取时归一为 `expert`(不报错、不迁移、不改历史日志);`ROLE_MIX_REQUIRED` 配比门禁删除,改为「至少 1 名专家」;client 文案、three-phase 提示词、journal 新写入全部去掉组员。
|
|
19
|
+
10. **负责人汇总报告必须精简、禁止累赘重复、JSON 结构化**:新增 F11 与 `checkDepartmentSummary` —— 字段仅 `keyResults` / `keyInfo` / `importantInfo` / `sources`,同一套四路去重规则;超长或重复一律退回。
|
|
20
|
+
11. **汇总报告完成后必须直接交给主 Agent**:`settleFromOutput` 把 `departmentSummary` 持久化到任务行,`emitSubtaskDoneNotice` 在完成通知里原样附「部门汇总报告(JSON,直接交给主 Agent):」+ 完整 JSON,不经二次概括、不裁剪。
|
|
21
|
+
12. **全部任务交回后由主 Agent 汇总最终成果**:`src/host.ts` 的 `PROMPT_SECTION` 新增 R12 硬规则(收齐全部部门汇总 JSON 后由主 Agent 统一深入汇总,不得把部门汇总直接当最终成果)。
|
|
22
|
+
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。
|
|
23
|
+
|
|
24
|
+
### 兼容与回归
|
|
25
|
+
|
|
26
|
+
- **沟通格式规范升版**:`COMM_FORMAT_VERSION` 1 → 2,新增 F10/F11,**F1–F9 原文一字未改**;只有 `status==='done'` 且声明了层级(`tier:'expert'|'leader'`)时才追加对应条目,历史回放与旧日志零回归(有专门用例锁定)。
|
|
27
|
+
- **新增回归**:`tests/workplan-v3-contract.test.ts` 24 例(固定文案逐字、任务原文可见、质量要求归一与渲染、极简门槛各类拒绝、专家/部门 JSON 校验含 Dice 近义重复与去重键、F10/F11 层级接线、role=member 归一、版本 3.0.0)。
|
|
28
|
+
- **生效方式**:改的是 `src/`,运行中的进程不热加载 —— 已 `npm run build` 并同步 `lib/`,**须用户手工重启 dsh web** 后生效(禁止 Agent 自行重启)。
|
|
29
|
+
|
|
30
|
+
- **low 任务禁止第三层下派(用户裁决 D1–D6;计划 wp-43d5099c;实现规格 `reports/wp-T3-impl-spec-20261114.md`)**:
|
|
31
|
+
- **D1/D3 判定链(钳制前)**:low 判定=负责人自配 `consolidation.taskReasoningEffort`(钳制前原始声明,经 `taskReasoningEffortDeclared` 持久化记忆)→ 缺失时按任务行记录等级 `subtask.reasoningEffort` 兜底 → 两者皆缺=「未配置」**视同 low** 一并禁派。判定链与 `complexTask`(决定 ≥8 人闸与 6/12 人上限)**完全解耦**(`src/llm-rules.ts:348` `banDeclared = … ?? declaredEffort ?? input.taskRowEffort`)。
|
|
32
|
+
- **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` 路由隔离。
|
|
33
|
+
- **D5 生效范围**:判据在「新下派请求时」计算,无迁移、无回溯、**不设独立配置开关**(由「无任何例外通道」推断,标注为推断项);回退=恢复旧版 lib + 用户手工重启。
|
|
34
|
+
- **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` 零改动。
|
|
35
|
+
- **验证与证据**:专用回归 `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`。
|
|
36
|
+
- **生效交接**:`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(发布归用户决定)。
|
|
37
|
+
- **已知问题(如实登记,未擅自处置)**:① 版本递增号待用户定版;② `delegateSelfEfforts`/`delegateDeepThinks` 的 `slice(0,6)` 与 `delegates`/`estimates` 的 `slice(0,12)` 上限不对称(第 7 名起台账截断,decision-record §5-2「O2」);③ `allowBanned` 豁免(专家预估上报必达主会话)与内部噪音禁止清单的规则冲突待用户裁决(F3)。
|
|
38
|
+
|
|
39
|
+
## 2.5.4 — 2026-11-12
|
|
40
|
+
|
|
41
|
+
- **机制缺陷治本(用户 2026-11-12 本会话实锤,③④⑥ 落地;②⑤ 经核实为有意安全契约,不 loosening)**:
|
|
42
|
+
- **③ 子会话迟到结算不得削弱主 Agent 人工改判**:主 Agent 已以 structured 证据裁决 done 后,子会话迟到结算携带更弱 verification/acceptance 时不再覆盖人工证据(plan.ts applyStatus 保留人工 structured 验收)。
|
|
43
|
+
- **④ 超时「待裁决」标记随 done 裁决清除**:行裁决 done 后 `pendingAdjudication=false`,界面/回放不再对已完成行显示「待裁决」(plan.ts applyStatus done 分支)。
|
|
44
|
+
- **⑥ 叶子中止/失败时父级完成口径显式**:父行 done 但含 failed/aborted 叶子时,摘要自动点名这些叶子并说明父级完成依据为其余证据+主 Agent 复核,非该叶子自报完成(plan.ts applyStatus),消除「叶子没做完却说全完成」的口径歧义。
|
|
45
|
+
- **②/⑤ 契约澄清(不改迁移表/覆盖守卫)**: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 前置闸回归。
|
|
46
|
+
- **版本一致性**:package.json / package-lock(两处)/ host.ts meta / tool-surface fixture / README(.en) 安装命令 / 本 CHANGELOG 统一 2.5.4。
|
|
47
|
+
- **生效交接**:npm run build 已执行;运行中进程不热加载,须用户手工重启 dsh web 后复核。
|
|
48
|
+
- **T6 下属开工前预估时间上报硬门禁(用户 D9:「没有告知部门负责人预估时间,先拦截,再告知此人,你必须自己预估时间,汇报给对应负责人后,才可以重试或继续执行」;契约 _t6_estimate_20261112/00-contract-estimate-v1.md FROZEN)**:
|
|
49
|
+
- **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}`。
|
|
50
|
+
- **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,…})。
|
|
51
|
+
- **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 人预估全部存活。
|
|
52
|
+
- **重派未预估回 phase-0**:`leafPhaseZero = !priorSelf || !stashedThink || !stashedEstimate`——旧叶子已配档/已思考但未预估 ⇒ 回 phase-0 补交完整原子对;selfContinuation 文案附「预估已登记(含分钟数)」。
|
|
53
|
+
- **schema 与任务书同源**:host.ts delegate schema 新增 timeNotice 属性与 T6/D9 描述;llm-rules.ts phase-0 提交清单与叶子 brief 同步「整数分钟、未上报不接续」;plan.ts 负责人任务书补「下属预估即时送达并留痕(kind=estimate),未上报者被拦截开工」(时长求和归 T7,T6 只存不算;T7 读 delegateEstimates/journal estimate 求和)。
|
|
54
|
+
- **验证与生效交接(D8)**:测试与全量回归数字以负责人全量回归日志为准(reports/T6-lead-independent-verification-20261112.md);机制说明与冒烟步骤见 reports/T6-estimate-gate-mechanism-20261112.md。无需安装/升级插件包,集成构建由负责人执行;运行中进程不热加载,**须用户手工重启 dsh web** 后按冒烟步骤复核(派 1 名下级 → self_effort 缺 timeNotice 应被 ESTIMATE_MISSING 拦截 → 补交后负责人收到预估消息并接续执行)。
|
|
55
|
+
|
|
56
|
+
- **七条底层机制全面优化(用户 2026-11-12 七项要求 R1–R7;计划 wp-437e264b,T1–T11+T10R 全部 structured 验收通过;用户决策 D1–D10 见 reports/wp-user-decisions-20261112.md)**:
|
|
57
|
+
- **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。
|
|
58
|
+
- **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。
|
|
59
|
+
- **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。
|
|
60
|
+
- **R4/T6 下属开工前预估时间上报硬门禁**:见上条 T6(self_effort 原子对必填 timeNotice,ESTIMATE_MISSING/INVALID/DELIVERY_FAILED,D9 原话拦截)。
|
|
61
|
+
- **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。
|
|
62
|
+
- **R6/T9 负责人完美完成即时报主 Agent**:`emitSubtaskDoneNotice` 增强——验收结论 X/Y+D7 完美判据(structured+全 pass)+逐条验收+待主 Agent 执行事项(含 D8 手动重启建议);head→root completion 留痕;wait/async 均 notifyCompletion:true。证据 reports/T9-final-verification-20261112.md。
|
|
63
|
+
- **R7/T8 下属完美完成即时报负责人**:`emitDelegateDoneNotices`/`deliverDelegateDoneNotices`——done-only 过滤、sent 幂等、写时重读防竞态、DELIVERY_FAILED 显式+failed 留痕+下次结算兜底补发;两处结算接线。证据 reports/t8-full-suite-r3-20261112.log。
|
|
64
|
+
- **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。
|
|
65
|
+
- **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。
|
|
66
|
+
- **生效交接(D8)**:npm run build 已执行、lib 已含全部改动;运行中进程不热加载,**须用户手工重启 dsh web** 后按 T10R 报告冒烟步骤复核(禁止 Agent 自行重启)。改动在工作树,未 commit/push/tag(发布归用户决定)。
|
|
67
|
+
|
|
68
|
+
## 2.5.3 — 2026-11-12
|
|
69
|
+
|
|
70
|
+
- **重启后会话损坏治本(用户 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)。
|
|
71
|
+
- **生效交接**:须用户手工重启 dsh web;活体会话日志静止后用修复脚本处理。
|
|
72
|
+
|
|
73
|
+
## 2.5.2 — 2026-11-11
|
|
74
|
+
|
|
75
|
+
- **「提交任务后长时间无反应」缺陷治本(用户 2026-11-12 硬要求:必须修复、禁止遗留;stall-fix 三条根因,均经本会话运行态实证)**:
|
|
76
|
+
- **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 只更新梳理产物,绝不中断执行中回合。
|
|
77
|
+
- **R2 规划器默认取家族最高推理档 → 单次规划实测 12-13 分钟**:预告之后长时间只有心跳没有结果,用户体验即「死机」。修复:默认档改家族中等档(qwen⇒medium、非 qwen⇒high,runtime.ts:855),中等档不在合法集时回落最高档(家族白名单语义不变),`DSH_WORKPLAN_PLANNER_REASONING_EFFORT` 显式覆盖保留;规划是结构化分解(中等复杂度),中等档保证质量并显著缩短首屏等待。
|
|
78
|
+
- **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 保险丝、中止静默,与规划心跳同一收束纪律。
|
|
79
|
+
- **验证**:新增 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。
|
|
80
|
+
- **生效交接(需主 Agent/用户执行)**:npm run build 已随全量回归完成;**运行中进程不热加载,须用户手工重启 dsh web**,重启后真实提交任务复现验证(提交即预告、规划提速、执行期心跳、re-review 不再中断);主会话工具面缺失 dsh_workplan_* 属宿主侧暴露问题(子会话可调用),重启后复核,不在本插件源码可修范围。未通过真实链路验证前不声称运行态缺陷已消除。
|
|
81
|
+
- **规划期间心跳治本(用户 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 入口,同样受益。
|
|
82
|
+
- **实现与安全性**:文案纯函数 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、工具参数/输出、重试/超时语义,旧计划零迁移。
|
|
83
|
+
- **主 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 调用统一以合格夹具过闸。旧计划回放零迁移(无新字段不报错;未登记产物时派发要求补交,属协议强制口径)。
|
|
84
|
+
- **叶子执行前两轮思考硬门禁 + 四角色少走弯路(用户 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(用户尚未定版是否递增,不擅自改动)。
|
|
85
|
+
- **版本统一 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(宿主侧无热加载)。
|
|
86
|
+
|
|
87
|
+
- **重启后真实链路验证结论(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。
|
|
88
|
+
- **D1 叶子接续死亡 + D2 陈旧结算备份误采纳(用户 2026-11-12 硬要求:查明并必须修复 T1/T2 四个叶子子任务自动停止;诊断 reports/D1-D2-root-cause-diagnosis.md,修复 T4b,独立验收 T5b)**:
|
|
89
|
+
- **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:` 零命中实证)。
|
|
90
|
+
- **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 更新/结算回调原样保留。
|
|
91
|
+
- **D2 现象/根因**:结果块缺失时的盘上备份恢复路径读固定文件名 `reports/wp-settlement-<subtaskId>.json` 且无归属/新鲜度校验,误采纳陈旧 wp-settlement-T1.json(截图任务)→ T1 假完成、wp-settlement-T2.json(基金任务)→ T2 误 blocked,T3/T4/T5 级联冻结;跨计划复用同名文件使陈旧副本必然存在。
|
|
92
|
+
- **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。
|
|
93
|
+
- **验证(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 模拟「尝试内新写」,语义断言零改动(新契约直接要求,非放宽闸)。
|
|
94
|
+
- **生效交接(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(用户尚未定版是否递增,不擅自改动)。
|
|
95
|
+
|
|
96
|
+
## 2.5.1 — 2026-11-11
|
|
97
|
+
|
|
98
|
+
- **两轮深度思考协议(用户要求 1,底层机制升级)**:三阶段工作法的规划阶段升级为用户 2026-11-11 强制的「两轮深度思考」协议,部门负责人、部门里相关领域的全球顶尖专家、部门里组员三层执行者在执行自己的任务时同一口径:① 第一轮 · 任务深研——先全面、全盘、深入梳理、研究、思考自己的任务(→ phases.planning.problemAnalysis);② 第二轮 · 理清方法流程步骤——基于刚才第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清自己的思路,理清自己该具体如何一步步执行、达到最终完美完成自己任务的方法、流程和步骤(→ phases.planning.approach);③ 执行——最后,基于刚才第二轮理清楚的所有方法、流程、步骤,开始具体的执行工作。三步顺序与依赖不可颠倒:第二轮必须消费第一轮的全部结果,执行必须消费第二轮的方法、流程、步骤。
|
|
99
|
+
- **第二轮依据成为结构化必填证据(新增 approachBasis)**:「基于前一步完成好的所有结果」不再只是提示词——phases.planning.approachBasis(至少 1 条、合计 ≥20 字)要求逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤,两轮之间的依赖可审计;缺依据/依据太薄 ⇒ 规划阶段判未完成(PHASE_GATE 回喂待补项),不得记 done。THREE_PHASE_VERSION 1→2;problemAnalysis/approach 字段名保留、语义升级为两轮产物。在途旧结算证据缺 approachBasis 时按既有有界回喂通道要求补齐(强制口径,不是静默放行)。
|
|
100
|
+
- **负责人再分配硬门禁同口径**: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 补齐(协议强制口径)。
|
|
101
|
+
- **三层任务书注入单一事实源**:threePhasePromptLines 重写为两轮深度思考协议(第一轮/第二轮/执行依赖 + approachBasis 自检),二级任务书(buildChildPrompt)与三级任务书(buildDelegateePrompt)共享同一注入;buildLlmRulesBrief 负责人 tier 改写为「执行自己的任务先两轮深度思考,再执行与再分配」,专家/组员 tier 新增协议全文;两份任务书的执行要求各新增一条两轮深度思考强制行。dsh_workplan_verify 工具 planning schema 同步新增 approachBasis 必填。
|
|
102
|
+
- **版本统一 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(宿主侧无热加载)。
|
|
103
|
+
|
|
104
|
+
## 2.5.0 — 2026-11-11
|
|
105
|
+
|
|
106
|
+
- **部门负责人再分配权限根因修复(用户要求 1)**:2.3.9 已交付 `dsh_workplan_delegate` 工具,但二级任务书 `buildChildPrompt` 的执行要求仍写着「不要派生新的 Agent」「你没有派发权限」——负责人同时收到「必须再分配」(llmRulesBrief)与「没有派发权限」(执行要求)两套矛盾指令,普遍不敢行使再分配。本版把禁令改写为精确边界:负责人**拥有本部门内再分配权限**(dsh_workplan_delegate,先 review 后 dispatch),禁令只针对主计划派发、重启/安装与第四层派生;并新增「本部门再分配权限与推理等级配置」授权段。规划器提示词同步改写(旧「子任务由子 Agent 独立执行:它们没有派发权限」→ 负责人牵头 + 部门内再分配权限)。
|
|
107
|
+
- **三层执行者推理等级自配置(用户要求 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」的继承回落口径废止;无新字段的旧计划回放零迁移。
|
|
108
|
+
- **分解更简单、多人承担(用户要求 3)**:规划器提示词新增硬规则——每个子任务单一目标、单一主产物、可独立验收,执行细节下沉到部门内分工;负责人任务书与 delegate 工具描述要求每位下级只承担一项简单工作,expert 与 member 各至少 1 名、最多 6 人共同承担。
|
|
109
|
+
- **版本统一 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。
|
|
110
|
+
- 新增 `tests/workplan-250-head-delegation.test.ts` 回归;要求2 自配置机制新增 `tests/workplan-250-self-effort.test.ts` 9 例回归;既有字段与校验原样,旧计划零迁移。生效需 `npm run build` 后由用户手工重启 dsh web(宿主侧无热加载)。
|
|
111
|
+
|
|
112
|
+
## 2.3.10 — 2026-11-11
|
|
113
|
+
|
|
114
|
+
- **分配前会话内耗时预告(用户要求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(宿主侧无热加载)。
|
|
115
|
+
|
|
1
116
|
## 2.3.9 — 2026-11-11
|
|
2
117
|
|
|
3
118
|
- **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/v2.5.2)
|
|
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.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
|
[](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
|
|
6
|
-
[](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.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@
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@3.0.0
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
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/v2.5.2)
|
|
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.
|
|
72
|
+
dsh plugin --profile web add dsh-workplan@2.5.2
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
|
package/client.js
CHANGED
|
@@ -23,7 +23,6 @@ window.__ModuleLoader__.load({
|
|
|
23
23
|
"groupEnded": "已结束",
|
|
24
24
|
"groupLiveHint": "还没结束,正在或即将推进",
|
|
25
25
|
"groupDoneHint": "已全部完成并收尾",
|
|
26
|
-
"groupEndedHint": "这一轮已经停了,没有东西在跑;说「续跑」可继续推进",
|
|
27
26
|
"groupCollapse": "收起",
|
|
28
27
|
"groupExpand": "展开",
|
|
29
28
|
"groupNeeds": "需处理",
|
|
@@ -93,15 +92,16 @@ window.__ModuleLoader__.load({
|
|
|
93
92
|
"closed": "无需动作"
|
|
94
93
|
},
|
|
95
94
|
"handoffs": "跨部门需求",
|
|
96
|
-
"delegates": "
|
|
95
|
+
"delegates": "第三层(全球顶尖专家)",
|
|
97
96
|
"delegateExpert": "专家",
|
|
98
|
-
"delegateMember": "
|
|
97
|
+
"delegateMember": "专家",
|
|
99
98
|
"delegateStatus": {
|
|
100
99
|
"running": "执行中",
|
|
101
100
|
"done": "已完成",
|
|
102
101
|
"failed": "失败",
|
|
103
102
|
"timeout": "超时",
|
|
104
|
-
"rejected": "派发被拒"
|
|
103
|
+
"rejected": "派发被拒",
|
|
104
|
+
"blocked": "受阻"
|
|
105
105
|
},
|
|
106
106
|
"dept": {
|
|
107
107
|
"engineering": "工程研发",
|
|
@@ -245,6 +245,11 @@ window.__ModuleLoader__.load({
|
|
|
245
245
|
"noticeChannelAwaiting": "等待观测",
|
|
246
246
|
"noticeChannelNotObserved": "未观测到送达",
|
|
247
247
|
"reason": "原因",
|
|
248
|
+
"leaderEstimateFull": "负责人任务时长=全部下属开工预估之和:{minutes} 分钟({reported}/{expected} 已上报)|判据层完成目标 ≤10 分钟:达标须同时满足事前预估之和与事后单次尝试墙钟均 ≤10 分钟",
|
|
249
|
+
"leaderEstimatePartial": "下属开工预估部分和:{minutes} 分钟({reported}/{expected} 已上报{gaps})|预估未报齐只显示部分和,不得视为「简单判据达标」(判据层完成目标 ≤10 分钟)",
|
|
250
|
+
"leaderEstimateOver": "⚠ 超简单判据:事前预估 {minutes} 分钟 > 10 分钟完成目标——请事前拆分,或经用户明确批准并留痕(无留痕=未批准,不得视为达标)",
|
|
251
|
+
"leaderEstimateMissing": ",缺:{names}",
|
|
252
|
+
"leaderEstimateFailed": ",报送失败:{names}",
|
|
248
253
|
},
|
|
249
254
|
"en": {
|
|
250
255
|
"groupLive": "In progress",
|
|
@@ -305,6 +310,7 @@ window.__ModuleLoader__.load({
|
|
|
305
310
|
"paused": "Paused (budget spent)",
|
|
306
311
|
"degraded": "Planning failed",
|
|
307
312
|
"cancelled": "Cancelled",
|
|
313
|
+
"superseded": "Taken over by another plan",
|
|
308
314
|
"ended": "Ended (resumable)"
|
|
309
315
|
},
|
|
310
316
|
"status": {
|
|
@@ -328,7 +334,8 @@ window.__ModuleLoader__.load({
|
|
|
328
334
|
"done": "done",
|
|
329
335
|
"failed": "failed",
|
|
330
336
|
"timeout": "timeout",
|
|
331
|
-
"rejected": "rejected"
|
|
337
|
+
"rejected": "rejected",
|
|
338
|
+
"blocked": "blocked"
|
|
332
339
|
},
|
|
333
340
|
"dept": {
|
|
334
341
|
"engineering": "Engineering",
|
|
@@ -472,6 +479,11 @@ window.__ModuleLoader__.load({
|
|
|
472
479
|
"noticeChannelAwaiting": "Awaiting observation",
|
|
473
480
|
"noticeChannelNotObserved": "Delivery not observed",
|
|
474
481
|
"reason": "reason",
|
|
482
|
+
"leaderEstimateFull": "Leader task duration = sum of all delegate start estimates: {minutes} min ({reported}/{expected} reported) | Criterion layer: completion target <= 10 min, met only when both the ex-ante estimate sum and the ex-post single-attempt wall clock are <= 10 min",
|
|
483
|
+
"leaderEstimatePartial": "Partial sum of delegate start estimates: {minutes} min ({reported}/{expected} reported{gaps}) | Estimates incomplete: partial sum only, never a met criterion (completion target <= 10 min)",
|
|
484
|
+
"leaderEstimateOver": "OVER criterion: ex-ante estimate {minutes} min > 10 min completion target - split the work or obtain explicit user approval with an audit trail (no trail = not approved, never a met criterion)",
|
|
485
|
+
"leaderEstimateMissing": ", missing: {names}",
|
|
486
|
+
"leaderEstimateFailed": ", delivery failed: {names}",
|
|
475
487
|
}
|
|
476
488
|
};
|
|
477
489
|
function flattenLocale(source, prefix = '', out = {}) {
|
|
@@ -1567,7 +1579,9 @@ window.__ModuleLoader__.load({
|
|
|
1567
1579
|
* - 计划定义:estimateMinutes(预估)、timeoutMs(协商上限)、reasoningEffort(推理等级);
|
|
1568
1580
|
* - 状态行:startedAt/deadlineAt(协商截止)、timeJournal(延期/预告历史)、
|
|
1569
1581
|
* timeNotice(开工预告)、timeWarning(到点预警)、noticeChannel(子→主通道是否送达)、
|
|
1570
|
-
* pendingAdjudication
|
|
1582
|
+
* pendingAdjudication(到点后的待裁决标记);
|
|
1583
|
+
* [T7] leaderEstimate(负责人时长聚合,服务端读时派生:全员 sent 表述完整等式,
|
|
1584
|
+
* 否则部分和+缺口名单;null/缺失整块不渲染,客户端严禁求和)。
|
|
1571
1585
|
*
|
|
1572
1586
|
* 客户端不推导状态机、不补造字段:任何字段缺失就少显示一行;全部缺失整块不渲染,
|
|
1573
1587
|
* 绝不出现 undefined / [object Object]。
|
|
@@ -1596,7 +1610,20 @@ window.__ModuleLoader__.load({
|
|
|
1596
1610
|
const warning = item?.timeWarning && typeof item.timeWarning === 'object' ? item.timeWarning : null;
|
|
1597
1611
|
const channel = item?.noticeChannel && typeof item.noticeChannel === 'object' ? item.noticeChannel : null;
|
|
1598
1612
|
const pending = item?.pendingAdjudication === true;
|
|
1599
|
-
|
|
1613
|
+
/*
|
|
1614
|
+
* [T7][J2/J6] 负责人任务时长聚合:只渲染服务端下发的 leaderEstimate
|
|
1615
|
+
* (plan.ts deriveLeaderEstimate 读时派生,经 serialisePlan→derivePlanSnapshot
|
|
1616
|
+
* 同源下发)。客户端严禁求和、不推导状态机:reported===expected 仅作
|
|
1617
|
+
* 措辞选择(J1:全员 sent 才表述完整等式)。totalMinutes=0 合法(F3
|
|
1618
|
+
* 部分和 0),故用 ≥0 守卫而非 positiveNumber;字段缺失/null(J8 空
|
|
1619
|
+
* roster/replanned 旧行/越界 fail-closed)⇒ 不渲染本块。
|
|
1620
|
+
*/
|
|
1621
|
+
const leaderEstimate = item?.leaderEstimate && typeof item.leaderEstimate === 'object' ? item.leaderEstimate : null;
|
|
1622
|
+
const leaderExpected = leaderEstimate && Number.isInteger(leaderEstimate.expected) && leaderEstimate.expected > 0 ? leaderEstimate.expected : null;
|
|
1623
|
+
const leaderReported = leaderEstimate && Number.isInteger(leaderEstimate.reported) && leaderEstimate.reported >= 0 ? leaderEstimate.reported : null;
|
|
1624
|
+
const leaderMinutes = leaderEstimate && Number.isFinite(Number(leaderEstimate.totalMinutes)) && Number(leaderEstimate.totalMinutes) >= 0 ? Number(leaderEstimate.totalMinutes) : null;
|
|
1625
|
+
const leaderShown = leaderEstimate !== null && leaderExpected !== null && leaderReported !== null && leaderMinutes !== null;
|
|
1626
|
+
if (!estimate && !ceiling && !deadlineAt && !notice && !warning && !channel && !pending && extensions.length === 0 && !leaderShown) {
|
|
1600
1627
|
return null;
|
|
1601
1628
|
}
|
|
1602
1629
|
const remainingMs = deadlineAt ? Math.max(0, deadlineAt - Date.now()) : null;
|
|
@@ -1640,6 +1667,29 @@ window.__ModuleLoader__.load({
|
|
|
1640
1667
|
}
|
|
1641
1668
|
if (pending)
|
|
1642
1669
|
notes.push(`${t('pendingAdjudication')}:${t('pendingAdjudicationHint')}`);
|
|
1670
|
+
/*
|
|
1671
|
+
* [T7][J1 方案 A] 全员 sent(reported===expected)才表述完整等式
|
|
1672
|
+
* 「负责人任务时长=全部下属开工预估之和」;否则必须按「部分和(X/Y)」
|
|
1673
|
+
* 标注并如实列出缺口名单。名单 join 只是展示拼接,不是求和;数值全部
|
|
1674
|
+
* 来自服务端下发的 leaderEstimate,客户端不做任何算术。
|
|
1675
|
+
*/
|
|
1676
|
+
if (leaderShown) {
|
|
1677
|
+
const missingNames = Array.isArray(leaderEstimate.missing) ? leaderEstimate.missing.filter((name) => typeof name === 'string' && name !== '') : [];
|
|
1678
|
+
const failedNames = Array.isArray(leaderEstimate.failed) ? leaderEstimate.failed.filter((name) => typeof name === 'string' && name !== '') : [];
|
|
1679
|
+
const gaps = (missingNames.length > 0 ? fill(t('leaderEstimateMissing'), { names: missingNames.join('、') }) : '')
|
|
1680
|
+
+ (failedNames.length > 0 ? fill(t('leaderEstimateFailed'), { names: failedNames.join('、') }) : '');
|
|
1681
|
+
notes.push(leaderReported === leaderExpected
|
|
1682
|
+
? fill(t('leaderEstimateFull'), { minutes: leaderMinutes, reported: leaderReported, expected: leaderExpected })
|
|
1683
|
+
: fill(t('leaderEstimatePartial'), { minutes: leaderMinutes, reported: leaderReported, expected: leaderExpected, gaps }));
|
|
1684
|
+
/*
|
|
1685
|
+
* [SCv2-T4][Q4-B/C21] 超判据告警:只读服务端下发的布尔
|
|
1686
|
+
* leaderEstimateOverCriterion(normaliseStatusEntry 派生),客户端
|
|
1687
|
+
* 严禁自行算术(client.ts 既定约定)。部分和 >10 同样告警(AC-Q4-2)。
|
|
1688
|
+
*/
|
|
1689
|
+
if (item?.leaderEstimateOverCriterion === true) {
|
|
1690
|
+
notes.push(fill(t('leaderEstimateOver'), { minutes: leaderMinutes }));
|
|
1691
|
+
}
|
|
1692
|
+
}
|
|
1643
1693
|
return h('div', { className: 'dsh-wp-time' }, h('div', { className: 'dsh-wp-time-title' }, t('timeNegotiation')), facts.length > 0
|
|
1644
1694
|
? h('div', { className: 'dsh-wp-time-row' }, facts.map((fact, factIndex) => h('span', { key: String(factIndex) }, fact)))
|
|
1645
1695
|
: null, notes.map((note, noteIndex) => h('p', { key: String(noteIndex), className: 'dsh-wp-time-note' }, note)));
|
|
@@ -1721,7 +1771,7 @@ window.__ModuleLoader__.load({
|
|
|
1721
1771
|
: null,
|
|
1722
1772
|
/*
|
|
1723
1773
|
* [2.3.9][T4b] 第三层派发看板(用户要求 4/5):部门负责人分配给
|
|
1724
|
-
*
|
|
1774
|
+
* 全球顶尖专家的每位下级、其推理等级(含越界钳制留痕)与实时状态
|
|
1725
1775
|
* 必须对用户与主 Agent 可见,否则「第三层派给了谁、跑没跑完」只存在
|
|
1726
1776
|
* 负责人子会话里。数据源 = 状态行 delegates(applyStatus 消毒 +
|
|
1727
1777
|
* durable workplan-update 回放,刷新/重启不丢),客户端不推导状态。
|
|
@@ -1731,7 +1781,17 @@ window.__ModuleLoader__.load({
|
|
|
1731
1781
|
+ `(${member?.role === 'expert' ? t('delegateExpert') : t('delegateMember')})`
|
|
1732
1782
|
+ `|${t('reasoningEffort')}:${String(member?.effort ?? '?')}`
|
|
1733
1783
|
+ (member?.requested && member.requested !== member.effort ? `(越界钳制自 ${String(member.requested)})` : '')
|
|
1784
|
+
+ (member?.selfEffort ? `|自配档 ${String(member.selfEffort)}${member?.selfEffortRequested && member.selfEffortRequested !== member.selfEffort ? `(钳制自 ${String(member.selfEffortRequested)})` : ''}` : '|自配档 待自配')
|
|
1734
1785
|
+ `|${t(`delegateStatus.${String(member?.status ?? 'running')}`)}`
|
|
1786
|
+
/*
|
|
1787
|
+
* [2.5.6] 第三层闭环可见性:叶子的「待指示/已给指示/已回应」
|
|
1788
|
+
* 与第一层同一套 closure 文案(服务端下发,客户端不推导),
|
|
1789
|
+
* 请示问题随待指示标记一并展示,负责人/用户一眼看到谁在等谁。
|
|
1790
|
+
*/
|
|
1791
|
+
+ (member?.escalation ? `|${t('closureEscalated')}${member.escalation.question ? `:${String(member.escalation.question)}` : ''}` : '')
|
|
1792
|
+
+ (member?.lastInstruction ? `|${t('closureInstructed')}` : '')
|
|
1793
|
+
+ (member?.closure === 'acknowledged' ? `|${t('closureAcknowledged')}` : '')
|
|
1794
|
+
+ (member?.instructionOverdue ? `|${t('closureNoAck')}` : '')
|
|
1735
1795
|
+ (member?.summary ? `:${String(member.summary)}` : '')))))
|
|
1736
1796
|
: null, status !== 'blocked' && item?.summary ? h('p', { className: 'dsh-wp-muted' }, `${t('summary')}:${plainError(item.summary)}`) : null,
|
|
1737
1797
|
/*
|
|
@@ -17,7 +17,7 @@ TOE 对外暴露 **2 类接口**:9 个 Agent 工具(宿主注入给模型调
|
|
|
17
17
|
|
|
18
18
|
| # | 工具 | 调用者 | 用途(一句话) | 关键参数 | 失败/拒绝行为 |
|
|
19
19
|
|---|---|---|---|---|---|
|
|
20
|
-
| 1 | `dsh_workplan_dispatch` | 主 Agent |
|
|
20
|
+
| 1 | `dsh_workplan_dispatch` | 主 Agent | 派发计划执行(2.5.2 起首次派发强制主 Agent 两轮深度思考协议) | `planId?`, `mode: wait/async`, `deepThink{problemAnalysis, approach, approachBasis}`(首次派发必填) | 无计划/重复派发幂等返回;首次派发未交/不合格两轮思考产物硬拒 `MAIN_DEEP_THINK_MISSING` / `MAIN_DEEP_THINK_INCOMPLETE`(不启动子 Agent),登记后 durable 持久化、续跑/重启回放读档放行,重规划新计划须重新提交;`complete:false` 表示未完成,必须续跑 |
|
|
21
21
|
| 2 | `dsh_workplan_status` | 主 Agent(只读) | 查看各子任务实时状态 | `planId?` | 只读,无副作用 |
|
|
22
22
|
| 3 | `dsh_workplan_update` | 主 Agent | 回写子任务状态/证据/验收 | `subtaskId`, `status`, `verification`, `acceptance[]` | done 需 structured+pass,否则 `deliveryReady=false`;执行中改判需 `force` |
|
|
23
23
|
| 4 | `dsh_workplan_replan` | 主 Agent | 需求变更时重规划 | `reason`, `changes[]` | 执行中调用返回 `REPLAN_PLAN_RUNNING`,变更不丢 |
|
|
@@ -26,9 +26,9 @@ TOE 对外暴露 **2 类接口**:9 个 Agent 工具(宿主注入给模型调
|
|
|
26
26
|
| 7 | `dsh_workplan_instruct` | 主 Agent | 向「待指示」子任务下发决定 | `subtaskId`, `instruction` | 仅接受 `closure=escalated` 的行 |
|
|
27
27
|
| 8 | `dsh_workplan_escalate` | 子 Agent | 子任务遇阻上报请示 | `question`, `options?`, `needs?` | 调用后子任务置「待指示」 |
|
|
28
28
|
| 9 | `dsh_workplan_handoff` | 主 Agent(仅根会话) | 处置跨部门需求 | `action: list/assign/resolve/close` | 非根会话拒绝 |
|
|
29
|
-
| 10 | `dsh_workplan_verify` | 子 Agent(阶段三) |
|
|
29
|
+
| 10 | `dsh_workplan_verify` | 子 Agent(阶段三) | 核验三阶段证据与验收覆盖(planning 为两轮深度思考产物,approachBasis 必填,2.5.1) | `phases`(planning/execution/verification) | 阶段一/二返回 `PHASE_GATE`;证据缺口返回 `VERIFICATION_INCOMPLETE`;核验通过不等于完成 |
|
|
30
30
|
| 11 | `dsh_workplan_lessons` | 根会话 / 子 Agent(只读) | 查看永久教训记忆(`list` / `search` / `stats`) | `action`、`department`、`query`、`limit` | 只读,不写计划状态、不提供写入动作;记忆只能由阶段三复盘通过后的完成判定写入 |
|
|
31
|
-
| 12 | `dsh_workplan_delegate` | 部门负责人子 Agent(2.3.9
|
|
31
|
+
| 12 | `dsh_workplan_delegate` | 部门负责人子 Agent(2.3.9;2.5.0 强化) | 第三层派发:先提交「两轮深度思考」产物(第一轮全面、全盘、深入梳理研究思考自己的任务,第二轮基于其全部结果理清方法、流程、步骤),再把任务拆成更简单的单项工作分给本部门多名顶尖专家与组员 | `action: review/dispatch/status/self_effort`、`consolidation{problemAnalysis, approach, approachBasis, assignments[], taskReasoningEffort?}`、self_effort 携带 `reasoningEffort+complexityRationale+deepThink{problemAnalysis, approach, approachBasis}`(2.5.2 叶子执行前硬门禁) | 非部门负责人子会话(根会话 / 第三层叶子)拒绝;`review` 未登记时 `dispatch` 返回 `DELEGATE_CONSOLIDATION_MISSING`;两轮产物缺 approach/approachBasis 返回 `DELEGATE_CONSOLIDATION_INCOMPLETE`(2.5.1);分工表缺 expert 或 member 返回 `DELEGATE_ROLE_MIX_REQUIRED`;越界推理等级按模型家族集合钳制并留痕;`taskReasoningEffort` 非法返回 `DELEGATE_TASK_EFFORT_INVALID`,合法则钳制后写入状态行 `effortOverride`(五档白名单消毒 + durable 回放 + 尝试重置不清除),派发链每次激活经 `resolveTaskEffort` 优先读它,下级档位以成员 self_effort 自配为权威(分工表档仅建议;继承仅旧计划回放兼容);下级子会话 `maxDepth:2`,第四层由宿主深度上限硬拒 |
|
|
32
32
|
|
|
33
33
|
### 1.2 HTTP 路由(1 个)/ HTTP route
|
|
34
34
|
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
|---|---|---|---|
|
|
26
26
|
| AS-1 | `GET/HEAD /dsh-workplan/plans` | 请求头、查询串(未使用)、方法 | 越权读取计划内容 |
|
|
27
27
|
| AS-2 | `GET/HEAD /dsh-workplan/vendor/chart.umd.js` | 同 AS-1 | 路径穿越读任意文件(理论) |
|
|
28
|
-
| AS-3 | `dsh_workplan_dispatch` |
|
|
28
|
+
| AS-3 | `dsh_workplan_dispatch` | 模型生成的参数(含 `deepThink` 两轮思考产物,2.5.2) | 未经确认的派发、重复派发;主 Agent 跳过两轮深度思考直接派发。缓解:首次派发必须随附 deepThink{problemAnalysis, approach, approachBasis},validateMainDeepThink 硬校验(40/40/20 字下限),未交/不合格硬拒 MAIN_DEEP_THINK_MISSING / MAIN_DEEP_THINK_INCOMPLETE,拒绝不启动子 Agent;登记后 durable workplan-update 持久化 + reconstruct 消毒回放,按 planId 记账(重规划须重新思考);tests/workplan-251-main-deep-think.test.ts 覆盖 |
|
|
29
29
|
| AS-4 | `dsh_workplan_update` | `subtaskId`、`status`、`expectedRevision` | 并发覆盖、伪造完成 |
|
|
30
30
|
| AS-5 | `dsh_workplan_cancel` | `planId` | 取消他人计划 |
|
|
31
31
|
| AS-6 | `dsh_workplan_status` | `planId` | 只读,风险最低 |
|
|
@@ -118,7 +118,7 @@ npm run verify
|
|
|
118
118
|
|
|
119
119
|
| # | 新增入口 | 输入可控点 | 潜在滥用 | 对策(实测) |
|
|
120
120
|
|---|---|---|---|---|
|
|
121
|
-
| AS-11 | `dsh_workplan_verify` | `phases`(嵌套对象,受字段长度/条数/总长上限)、`acceptance` | 子 Agent 伪造「全部通过」的验证证据骗过核验;把核验通过当成完成许可;阶段一/二提前调用规避门禁 | 核验只做结构与验收覆盖检查,**不是完成判定**;完成仍由 `adjudicateResult` 对同一份证据再判;只交 planning/execution 时返回 `PHASE_GATE
|
|
121
|
+
| AS-11 | `dsh_workplan_verify` | `phases`(嵌套对象,受字段长度/条数/总长上限)、`acceptance` | 子 Agent 伪造「全部通过」的验证证据骗过核验;把核验通过当成完成许可;阶段一/二提前调用规避门禁 | 核验只做结构与验收覆盖检查,**不是完成判定**;完成仍由 `adjudicateResult` 对同一份证据再判;只交 planning/execution 时返回 `PHASE_GATE`;planning 缺第二轮依据 approachBasis 同样 `PHASE_GATE`(2.5.1);`MAX_PHASE_*` 限制输入规模;`tests/three-phase.test.ts` 覆盖 |
|
|
122
122
|
| AS-12 | `dsh_workplan_lessons` | `action`(枚举)、`department`、`query`(≤ 原文长度)、`limit`(1–50) | 读取教训记忆探测其他项目的内部信息;用被污染的教训做提示词注入;把只读工具当成写入通道 | 只读、无写入动作;注入前清除不可见字符与会话引用并在提示词中声明为历史数据;返回条数受 `limit` 限制;`tests/self-learning.test.ts` 覆盖 |
|
|
123
123
|
|
|
124
124
|
## 10. v2.3.9 攻击面增量(模型家族推理等级约束与第三层派发)
|
|
@@ -127,6 +127,6 @@ npm run verify
|
|
|
127
127
|
|
|
128
128
|
| # | 新增入口 | 输入可控点 | 潜在滥用 | 对策(实测) |
|
|
129
129
|
|---|---|---|---|---|
|
|
130
|
-
| AS-13 | `dsh_workplan_delegate` | `action`(枚举)、`consolidation`(嵌套对象:problemAnalysis/constraints/unknowns/approach/assignments[]
|
|
130
|
+
| AS-13 | `dsh_workplan_delegate` | `action`(枚举)、`consolidation`(嵌套对象:problemAnalysis/constraints/unknowns/approach/approachBasis/assignments[]/taskReasoningEffort?,受条数与字段长度上限) | 负责人跳过「全面梳理」直接派发;把任务推给下级后自己空转收尾;派生无限层级(第四层、第五层)绕开主计划验收;给下级配置越界推理等级;经 `taskReasoningEffort`/`effortOverride` 注入非法档位;非负责人会话(根会话/第三层叶子)冒用该工具 | 服务端按 `childId` 反查计划行,只有计划内部门负责人子会话可用(根会话 `NOT_LEADER_SESSION`、叶子层 `NO_PLAN`/`NO_SUBTASK`);`dispatch` 前必须已登记 `review` 梳理产物(`DELEGATE_CONSOLIDATION_MISSING`),两轮深度思考产物缺 approach/approachBasis 拒绝(`DELEGATE_CONSOLIDATION_INCOMPLETE`,2.5.1),且分工表必须同时含 expert 与 member(`DELEGATE_ROLE_MIX_REQUIRED`);下级 spawn 传 `maxDepth:2`,第四层由宿主 `resolveChildDepth` 抛 `SubagentDepthError` 硬拒;等级经 `planDelegations` 按模型家族集合钳制并写 `requested`/`effort` 留痕,`taskReasoningEffort` 非法拒绝(`DELEGATE_TASK_EFFORT_INVALID`)、越界钳制留痕;`effortOverride` 经 `applyStatus` 五档白名单消毒(非法抛 `INVALID_EFFORT_OVERRIDE`)+ durable `workplan-update` 回放,派发链经 `resolveTaskEffort` 单一判据读档;叶子经 `self_effort` 自配+提交执行前两轮思考产物 deepThink(五档白名单 `SELF_EFFORT_INVALID`、必填依据 `SELF_EFFORT_RATIONALE_MISSING`、缺思考产物 `DEEP_THINK_MISSING`/不合格 `DEEP_THINK_INCOMPLETE` 硬拒不接续(2.5.2)、家族钳制留痕、`delegates[].deepThink`/`delegateDeepThinks` 消毒+重置保留+durable 回放、`delegates[].selfEffort`/`delegateSelfEfforts` 消毒+durable 回放+重置保留,接续失败重试 1 次仍败显式 `SELF_EFFORT_CONTINUATION_FAILED` 禁止静默降档,非叶子调用 `SELF_EFFORT_NOT_LEAF`);台账走 `applyStatus` 消毒 + durable 回放,刷新后门禁不失效;`tests/delegate-tool.test.ts` 与 `tests/workplan-250-head-delegation.test.ts` 覆盖 |
|
|
131
131
|
|
|
132
132
|
等级约束侧(无新工具,但是新的强制点):`src/llm-rules.ts` 是要求 1/2 的唯一事实源,`plan.ts` 校验、`replan.ts` 入口、`runtime.ts` 派发与规划器四处消费同一份集合,越界档不静默通过——按强度序钳制并 `console.warn` 留痕(含 model/family/requested/corrected/allowed/reason)。本节不改 §1 方法与「未做」声明:仍未做渗透测试、模糊测试与形式化分析;AVA_VAN.2+ 需外部实验室,为固有残留、如实披露。
|