dsh-workplan 3.0.3 → 3.0.9

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/src/host.ts CHANGED
@@ -22,8 +22,9 @@ import {
22
22
  statusToolOutputSchema,
23
23
  updateToolOutputSchema,
24
24
  } from './runtime.js'
25
- import { DEPARTMENT_IDS, isRecord } from './plan.js'
25
+ import { DEPARTMENT_IDS, isRecord, START_EVIDENCE_MIN_CHARS_BRIEF } from './plan.js'
26
26
  import { autoResumeEnabledFrom } from './auto-resume.js'
27
+ import { pruneJournal } from './dept-journal.js'
27
28
 
28
29
  /*
29
30
  * [1.8.14] Identity of the modules this process actually loaded (N1).
@@ -66,6 +67,14 @@ const LOADED_BUILD = (() => {
66
67
  */
67
68
  const PROCESS_STARTED_AT = Date.now() - Math.round(process.uptime() * 1000)
68
69
 
70
+ /*
71
+ * [3.0.6][第 2 批] 静态图表资产只读一次。
72
+ * 旧实现每次请求都 readFileSync 210KB(看板每次加载都拉一次),在请求路径上
73
+ * 做磁盘 I/O 没有必要:vendor 文件随插件发布、运行期不会变。缓存 Buffer 后
74
+ * 后续请求直接复用;读取失败不缓存,下次仍会重试。
75
+ */
76
+ let chartVendorBytes: Buffer | null = null
77
+
69
78
  function phaseLabel(phase: any) {
70
79
  if (phase === 'paused') return '本轮预算用尽,可续跑'
71
80
  if (phase === 'blocked') return '卡住了'
@@ -94,13 +103,13 @@ const PROMPT_SECTION = [
94
103
  '3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
95
104
  '3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
96
105
  '3.0.0 角色与汇报(用户要求 7/8/9/10/11/12):部门组员角色已取消,只保留部门负责人与全球顶尖专家(role 只允许 expert);专家完成后必须以 JSON 汇报(证据块里的 report:keyResults/keyInfo/importantInfo/leadRequirements,精简、禁止重复,F10);部门负责人必须全面汇总本部门全部专家汇报后,以 JSON 交回主 Agent(departmentSummary:keyResults/keyInfo/importantInfo/sources,精简、禁止累赘重复,F11);等所有部门的汇总都交回后,由你再全面、深入整理汇总成最终成果交付给用户(用户要求 12)。',
97
- '3.0.3 版本(用户要求 13):本插件当前版本为 3.0.3。涉及版本号的对外表述一律写 3.0.3。',
106
+ '3.0.9 版本(用户要求 13):本插件当前版本为 3.0.9。涉及版本号的对外表述一律写 3.0.9。',
98
107
  /*
99
- * [2.5.1] 主 Agent 两轮深度思考协议(用户 2026-11-11 补充要求):部门三层
100
- * 执行者已有结算/再分配双门禁,主 Agent 自己也必须做到同一协议——提示词
101
- * 告知 + dispatch 硬门禁(validateMainDeepThink)双保险,与部门层同一哲学。
108
+ * [3.0.8] 主 Agent 五步开工证据协议(取代 2.5.1 两轮深度思考,用户已批准):
109
+ * 部门三层执行者已有开工/结算双门禁,主 Agent 自己也必须做到同一协议——
110
+ * 提示词告知 + dispatch 硬门禁(validateStartPhaseEvidence)双保险,与部门层同一哲学。
102
111
  */
103
- '主 Agent 两轮深度思考协议(2.5.1 强制,与部门负责人/顶尖专家同一口径;2.5.2 补齐叶子执行前硬门禁并强制少走弯路):你执行自己的任务时,必须先全面、全盘、深入梳理、研究、思考自己的任务(第一轮:目标与验收、现状与事实、约束、未知、主要矛盾、边界);接着基于刚才第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清自己的思路,理清自己该具体如何一步步以最高效率执行、确保完美完成自己任务的方法、流程和步骤(第二轮,含全程如何少走弯路:先查历史教训、先验证再动手、不重复试错);最后基于刚才第二轮理清楚的所有方法、流程、步骤,开始具体的执行工作。首次调用 dsh_workplan_dispatch 必须随附 deepThink={ problemAnalysis(第一轮任务深研), approach(第二轮方法流程步骤), approachBasis(第二轮基于第一轮全部结果的依据对应) },未提交或不合格会被平台硬门禁拒绝(MAIN_DEEP_THINK_MISSING / MAIN_DEEP_THINK_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划产生的新计划是新任务,必须重新两轮思考并提交。派发顺序、督战、验收与交付必须严格按第二轮理清的方法、流程、步骤执行,不得静默改道。四角色执行前门禁现已全覆盖:主 Agent 经 dispatch 门禁、负责人经 delegate review 门禁、专家经 phase-0 self_effort+deepThink 门禁(DEEP_THINK_MISSING / DEEP_THINK_INCOMPLETE),未登记合格两轮思考产物一律不进入正式执行。',
112
+ '主 Agent 五步开工证据协议(3.0.8 强制,与部门负责人/顶尖专家同一口径):你执行自己的任务时,必须完成五步工作法的前三步——第一步全面、全盘、深入梳理、研究、思考自己的任务(目标与验收、现状与事实、约束、未知、主要矛盾、边界);第二步基于刚才第一步完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率执行、确保完美完成自己任务的方法、流程和步骤(含全程如何少走弯路:先查历史教训、先验证再动手、不重复试错),并写清依据;第三步把资源与工具真正备齐并给出就绪证据。首次调用 dsh_workplan_dispatch 必须随附 startPhases={ planning{ problemAnalysis(第一步任务梳理), resources(第二步资源研究), tools(第二步工具研究), approach(第二步方法流程步骤), approachBasis(第二步基于第一步全部结果的依据对应) }, preparation{ prepared(第三步已备清单), evidence(第三步就绪证据) } },未提交或不合格会被平台硬门禁拒绝(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划产生的新计划是新任务,必须重新完成前三步并提交。派发顺序、督战、验收与交付必须严格按第二步理清的方法、流程、步骤执行,不得静默改道。四角色执行前门禁现已全覆盖:主 Agent 经 dispatch 门禁、负责人经 delegate review 门禁、专家经 phase-0 self_effort+startPhases 门禁(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),未登记合格开工证据一律不进入正式执行。',
104
113
  /*
105
114
  * [2.3.10][T2] 用户要求1(P3)提示词双保险:插件已在规划前/派发前自动发送
106
115
  * 【规划预告】/【派发预告】(runtime.ts maybePlan / dispatchTool);这里把
@@ -165,10 +174,10 @@ const PROMPT_SECTION = [
165
174
  /*
166
175
  * [2.0.0] 自我学习与自我迭代(用户 2026-11-05 强制要求)。
167
176
  *
168
- * 部门 Agent 在阶段三必须复盘并落盘为永久记忆;这条提示词让主 Agent 知道
177
+ * 部门 Agent 在第五步收尾必须复盘并落盘为永久记忆;这条提示词让主 Agent 知道
169
178
  * 记忆存在、存在哪里、怎么复核,而不是把「会学习」当成不可见的口号。
170
179
  */
171
- '每个部门完成工作后,必须在阶段三提交复盘(问题 / 弯路 / 解决 / 防再犯规则),插件会自动把它写入永久教训记忆文件(默认 ~/.dsh/workplan/lessons.jsonl,可用 DSH_WORKPLAN_LESSONS_FILE 覆盖);下次派发同类子任务时,相关历史教训会自动出现在子 Agent 提示词里。',
180
+ '每个部门完成工作后,必须在第五步收尾提交复盘(问题 / 弯路 / 解决 / 防再犯规则),插件会自动把它写入永久教训记忆文件(默认 ~/.dsh/workplan/lessons.jsonl,可用 DSH_WORKPLAN_LESSONS_FILE 覆盖);下次派发同类子任务时,相关历史教训会自动出现在子 Agent 提示词里。',
172
181
  '需要复核「到底记住了什么、哪些错误在重复发生」时,调用 `dsh_workplan_lessons`(action: list / search / stats)。它是只读工具;记忆里反复出现的教训(occurrences ≥ 2)必须在下一次计划里变成明确约束,不能让同类错误第三次发生。',
173
182
  ].join('\n')
174
183
 
@@ -256,6 +265,19 @@ export type WorkplanConfig = {
256
265
  * 环境变量:`DSH_WORKPLAN_FAIL_CLOSED_ON_INCOMPLETE=1|0`。
257
266
  */
258
267
  failClosedOnIncomplete?: boolean | 'auto'
268
+ /**
269
+ * [3.0.6][第 3 批①] `agent/turn-stopping` 等待在途规划/派发的上限(毫秒)。
270
+ * 默认 60 分钟;0 = 无限等待(旧行为)。只约束收尾等待,不构成执行时限。
271
+ */
272
+ turnStoppingMaxWaitMs?: number
273
+ /**
274
+ * [3.0.6][第 2 批] 留痕保留天数。**0(默认)= 永久保留,不自动删除**。
275
+ *
276
+ * 审计证据默认不该被清理;只有部署方明确配置正数(或环境变量
277
+ * `DSH_WORKPLAN_JOURNAL_RETENTION_DAYS`)时,才会在启动时和之后每 24 小时
278
+ * 删除超过该天数未更新的 `<planId>.jsonl`(单次最多 200 个最旧文件)。
279
+ */
280
+ journalRetentionDays?: number
259
281
  }
260
282
 
261
283
  function createUpdateTool(runtime: any) {
@@ -748,8 +770,9 @@ function createEscalateTool(runtime: any) {
748
770
  description:
749
771
  '子 Agent 遇阻时向父会话上报请示,并把该子任务置为「待指示」。'
750
772
  + '第三层专家(叶子)同样可用:请示会经 delegate 登记落到所属部门行的第三层台账,由部门负责人用 dsh_workplan_instruct 答复。'
773
+ + '3.0.5 硬规则:第三层专家上报后,部门负责人禁止另派给其他专家,必须梳理该问题与本部门全部任务执行状态、研究方案后,用 dsh_workplan_instruct 答复原专家,原专家继续执行。'
751
774
  + '遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/同一命令连续两次失败/需要主 Agent 决定方向)时,'
752
- + '第一动作是调用本工具,然后停止推进、只做只读核对,等待主 Agent 指示。'
775
+ + '第一动作是调用本工具,然后停止推进、只做只读核对,等待主 Agent/负责人指示。'
753
776
  + '不需要外部决定时不要调用;调用后不要自行选定一个选项继续。',
754
777
  parameters: {
755
778
  type: 'object',
@@ -805,7 +828,7 @@ function createEscalateTool(runtime: any) {
805
828
  `${String(result.subtaskId ?? '')} 已登记为「待指示」`
806
829
  + (result.alreadyEscalated ? '(此前已登记,未重复提交)' : '')
807
830
  + `:${String(result.question ?? '')}`
808
- + '|现在停止推进,只做只读核对;等待主 Agent 指示后再继续。',
831
+ + '|现在停止推进,只做只读核对;等待主 Agent/部门负责人指示后再继续。第三层请示在答复前禁止改派给其他专家。',
809
832
  )
810
833
  },
811
834
  },
@@ -824,7 +847,7 @@ function createEscalateTool(runtime: any) {
824
847
  * 相关领域全球顶尖专家(部门组员角色已取消)。」
825
848
  *
826
849
  * 落地为两步硬流程(服务端校验,提示词绕不过):
827
- * - `review`:提交「全面梳理产物 + 分工表」(问题梳理/约束/未知/思路 +
850
+ * - `review`:提交「开工证据 + 分工表」(startPhases 五步第 1/2/3 步 +
828
851
  * 每位下级的 member/role/task/reasoningEffort);分工表必须同时含
829
852
  * ≥1 名 expert(顶尖专家);部门组员角色已取消(3.0.0)。
830
853
  * - `dispatch`:未登记 review 产物 ⇒ 硬门禁拒绝;登记后为每位下级派生
@@ -832,7 +855,8 @@ function createEscalateTool(runtime: any) {
832
855
  * 当前模型家族合法集合(qwen→low/medium/xhigh;非qwen→low/high/max)
833
856
  * 钳制并留痕,随 agentOptions 全程生效(要求 5)。
834
857
  * - `direct`:[2.5.5][T3] low(含未配置视同 low)任务负责人亲自执行登记:
835
- * 仅收 deepThink 两轮产物(40/40/20 字判据)+可选 reasoningEffort='low',
858
+ * 仅收 startPhases 开工证据(problemAnalysis/approach ≥40 字、approachBasis/
859
+ * resources/prepared/evidence ≥20 字、tools ≥10)+可选 reasoningEffort='low',
836
860
  * 拒 consolidation/分工表与复杂档;登记后平台以 low 档接续本会话亲自执行
837
861
  * (文档同步,门禁在 runtime/llm-rules)。
838
862
  *
@@ -843,28 +867,29 @@ function createDelegateTool(runtime: any) {
843
867
  return {
844
868
  name: 'dsh_workplan_delegate',
845
869
  description:
846
- '部门负责人专用的第三层派发(用户要求 1/2/3):你拥有本部门内再分配权限。执行自己的任务必须先走两轮深度思考:'
847
- + '先全面、全盘、深入梳理、研究、思考自己的任务,再基于前一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,'
848
- + '理清思路与具体一步步执行、完美完成任务的方法、流程和步骤,最后才基于这些方法、流程、步骤执行与再分配。'
849
- + '先 action="review" 提交两轮深度思考产物'
870
+ '部门负责人专用的第三层派发(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内再分配权限。执行自己的任务必须先完成五步前三步:'
871
+ + '第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);'
872
+ + '第三步把资源与工具真正备齐并给出就绪证据。'
873
+ + '先 action="review" 提交第 1/2/3 步开工证据(startPhases)'
850
874
  // [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts 负责人任务书同源逐字一致)
851
- + '(problemAnalysis=第一轮任务深研 + approach=第二轮方法流程步骤 + approachBasis=第二轮基于第一轮全部结果的依据 + 分工表:每位下级的 member/role/task/reasoningEffort,至少 1 名 expert 顶尖专家(部门组员角色已按用户要求 9 取消);low/未配置任务禁止下派——负责人亲自执行,两轮思考产物经 dsh_workplan_delegate(action="direct") 登记(40/40/20 字判据,可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断;'
875
+ + '(planning{ problemAnalysis, resources, tools, approach, approachBasis } + preparation{ prepared, evidence },开工证据字数下限:' + START_EVIDENCE_MIN_CHARS_BRIEF + ' + 分工表:每位下级的 member/role/task/reasoningEffort,至少 1 名 expert 顶尖专家(部门组员角色已按用户要求 9 取消);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断;'
852
876
  + '并可用 consolidation.taskReasoningEffort 为整个任务配置整体推理等级,配置后本任务重试/续跑全程沿用;下级档位以成员 self_effort 自配为权威(分工表档仅建议)),'
853
877
  + '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家(部门组员角色已取消,只保留 expert;固定一层下级、叶子层,第四层一律被拒)。'
854
878
  + '分配必须更简单:每位专家只承担一个动作、一个主产物、一项可独立验收的工作(简单到像 1+1=2:单句、≤300 字符、不含并列词,且每条必须带至少 1 条 qualityRequirements 质量要求;不满足即拒绝派发)。'
855
879
  + 'review 未提交前 dispatch 被硬门禁拒绝。每位下级的推理等级必须按其任务复杂度配置'
856
880
  + '(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),'
857
881
  + '平台按当前模型家族合法集合自动钳制越界档并留痕,等级在其任务全生命周期生效。'
858
- + 'action="status" 查看梳理登记与下级进度。第三层专家叶子用 action="self_effort" 自配推理等级并提交执行前两轮深度思考产物'
859
- + '(先配置+先思考后开工:phase-0 以 low 启动,唯一职责=评估自身任务复杂度并提交 reasoningEffort+complexityRationale+deepThink{problemAnalysis,approach,approachBasis}+开工前预估 timeNotice{declaredMinutes:正整数分钟,reason?};'
860
- + '缺交/不合格 deepThink 硬拒 DEEP_THINK_MISSING/DEEP_THINK_INCOMPLETE、不接续;两项齐全登记后平台立即以自配档接续同一任务进入 phase-1,正式执行必须按第二轮方法流程步骤进行、全程少走弯路;成员自配为权威、分工表档仅建议)。',
882
+ + 'action="status" 查看登记与下级进度。第三层专家叶子用 action="self_effort" 自配推理等级并提交五步第 1/2/3 步开工证据'
883
+ + '(先配置+先研究准备后开工:phase-0 以 low 启动,唯一职责=评估自身任务复杂度并提交 reasoningEffort+complexityRationale+startPhases{planning,preparation}+开工前预估 timeNotice{declaredMinutes:正整数分钟,reason?};'
884
+ + '缺交/不合格开工证据硬拒 START_EVIDENCE_MISSING/START_EVIDENCE_INCOMPLETE、不接续;齐全登记后平台立即以自配档接续同一任务进入 phase-1,正式执行必须按第二步方法流程步骤进行、全程少走弯路;成员自配为权威、分工表档仅建议)。'
885
+ + '3.0.5 硬规则:任一第三层成员处于待指示(escalated)时,review/dispatch/direct 一律拒绝改派、重派或降级;负责人必须梳理该成员问题与本部门全部任务状态,研究方案后用 dsh_workplan_instruct 答复原成员,原成员继续执行。',
861
886
  parameters: {
862
887
  type: 'object',
863
888
  properties: {
864
889
  action: {
865
890
  type: 'string',
866
891
  enum: ['review', 'dispatch', 'direct', 'status', 'self_effort'],
867
- description: 'review=提交两轮深度思考产物与分工表(负责人);dispatch=正式派发给专家(负责人);direct=low 任务负责人亲自执行登记(仅收 deepThink 两轮产物 40/40/20+可选 reasoningEffort=\'low\';拒 consolidation/分工表与复杂档,防旁路);status=查看登记与进度;self_effort=第三层专家叶子自配推理等级+提交执行前两轮深度思考产物 deepThink+开工前预估 timeNotice(先配置+先思考后开工,缺一硬拒不接续)。',
892
+ description: 'review=提交开工证据与分工表(负责人):startPhases 五步第 1/2/3 步证据 + 每位下级的 member/role/task/reasoningEffort;dispatch=正式派发给专家(负责人);direct=low 任务负责人亲自执行登记(仅收 startPhases 开工证据,' + START_EVIDENCE_MIN_CHARS_BRIEF + '+可选 reasoningEffort=\'low\';拒 consolidation/分工表与复杂档,防旁路);status=查看登记与进度;self_effort=第三层专家叶子自配推理等级+提交开工证据 startPhases+开工前预估 timeNotice(先配置+先研究准备后开工,缺一硬拒不接续)。',
868
893
  },
869
894
  reasoningEffort: {
870
895
  type: 'string',
@@ -875,15 +900,33 @@ function createDelegateTool(runtime: any) {
875
900
  type: 'string',
876
901
  description: 'action="self_effort" 必带(schema 层不强制,缺交将被运行时拒绝 SELF_EFFORT_RATIONALE_MISSING):复杂度依据(为什么你的单项任务是该档:事实/依赖/验证难度)。',
877
902
  },
878
- deepThink: {
903
+ startPhases: {
879
904
  type: 'object',
880
- description: 'action="self_effort" 必填(2.5.2 执行前硬门禁):专家执行自己任务前的两轮深度思考产物。第一轮全面、全盘、深入梳理、研究、思考自己分到的任务;第二轮基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清具体如何一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。缺交/不合格硬拒(DEEP_THINK_MISSING / DEEP_THINK_INCOMPLETE),不登记、不接续正式执行;登记后持久化,重派读档放行。action="direct" 必填(负责人 low 直执登记,同一 40/40/20 判据)。',
905
+ description: 'action="self_effort" / "review" / "direct" 必填(3.0.8 开工证据硬门禁):五步工作法前三步证据——第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);第三步把资源与工具真正备齐并给出就绪证据。缺交/不合格硬拒(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),不登记、不接续正式执行;登记后持久化,重派/续跑读档放行。',
881
906
  properties: {
882
- problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一轮 · 任务深研(目标与验收/现状/事实/约束/未知/主要矛盾/边界),至少 1 条、合计 ≥40 字。' },
883
- approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤(含如何最高效率、少走弯路:先查历史教训、先验证再动手、不重复试错),至少 1 条、合计 ≥40 字。' },
884
- approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据:第二轮如何基于第一轮完成好的所有结果(逐条对应),至少 1 条、合计 ≥20 字。' },
907
+ planning: {
908
+ type: 'object',
909
+ properties: {
910
+ problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界),至少 1 条、合计 ≥40 字。' },
911
+ resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
912
+ tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
913
+ approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清如何一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤,至少 1 条、合计 ≥40 字。' },
914
+ approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据:如何基于第一步完成好的所有结果(逐条对应),至少 1 条、合计 ≥20 字。' },
915
+ },
916
+ required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
917
+ additionalProperties: false,
918
+ },
919
+ preparation: {
920
+ type: 'object',
921
+ properties: {
922
+ prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
923
+ evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
924
+ },
925
+ required: ['prepared', 'evidence'],
926
+ additionalProperties: false,
927
+ },
885
928
  },
886
- required: ['problemAnalysis', 'approach', 'approachBasis'],
929
+ required: ['planning', 'preparation'],
887
930
  additionalProperties: false,
888
931
  },
889
932
  timeNotice: {
@@ -898,17 +941,8 @@ function createDelegateTool(runtime: any) {
898
941
  },
899
942
  consolidation: {
900
943
  type: 'object',
901
- description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE):负责人执行自己任务时「两轮深度思考」的产物 + 第三层分工表。第一轮:全面、全盘、深入梳理、研究、思考自己的任务(problemAnalysis);第二轮:基于第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步执行、完美完成任务的方法、流程和步骤(approach),并写清第二轮基于第一轮全部结果的依据对应(approachBasis)。两轮产物未齐前 dispatch 被硬门禁拒绝。action="direct" 禁止携带(direct 不接受分工表)。',
944
+ description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE):第三层分工表(3.0.8 起不再内嵌开工证据——开工证据一律经 startPhases 提交登记)。负责人自己的第 1/2/3 步开工证据未登记前 dispatch 被硬门禁拒绝。action="direct" 禁止携带(direct 不接受分工表)。',
902
945
  properties: {
903
- problemAnalysis: {
904
- type: 'array',
905
- items: { type: 'string' },
906
- description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条。',
907
- },
908
- constraints: { type: 'array', items: { type: 'string' }, description: '约束条件。' },
909
- unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项。' },
910
- approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果,再全面、全盘、深入梳理、研究、思考后理清的具体一步步执行、完美完成任务的方法、流程和步骤(每步做什么、产出什么、如何证明),至少 1 条。' },
911
- approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填,至少 1 条):第二轮如何基于第一轮完成好的所有结果——逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤。' },
912
946
  taskReasoningEffort: {
913
947
  type: 'string',
914
948
  enum: ['low', 'medium', 'high', 'xhigh', 'max'],
@@ -917,7 +951,7 @@ function createDelegateTool(runtime: any) {
917
951
  assignments: {
918
952
  type: 'array',
919
953
  // [3.0.0] 用户 2026-11-14 第 5/6/9 条:组员角色取消、任务极简、质量要求必填。
920
- description: '分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low/未配置任务禁止下派——负责人亲自执行,两轮思考产物经 dsh_workplan_delegate(action="direct") 登记(40/40/20 字判据,可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断。每一条任务必须简单到像 1+1=2:一个动作、一个主产物、一项可独立验收(≤300 字符、单句、不含并列词),且必须带 qualityRequirements(至少 1 条可检查的质量要求);不满足即拒绝派发。',
954
+ description: '分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断。每一条任务必须简单到像 1+1=2:一个动作、一个主产物、一项可独立验收(≤300 字符、单句、不含并列词),且必须带 qualityRequirements(至少 1 条可检查的质量要求);不满足即拒绝派发。',
921
955
  items: {
922
956
  type: 'object',
923
957
  properties: {
@@ -940,7 +974,7 @@ function createDelegateTool(runtime: any) {
940
974
  },
941
975
  },
942
976
  },
943
- required: ['problemAnalysis', 'approach', 'approachBasis', 'assignments'],
977
+ required: ['assignments'],
944
978
  additionalProperties: false,
945
979
  },
946
980
  },
@@ -1005,12 +1039,13 @@ function createDelegateTool(runtime: any) {
1005
1039
  }
1006
1040
 
1007
1041
  /**
1008
- * [1.13.0] 阶段三(验证阶段)的插件核验工具(用户 2026-11-05)。
1042
+ * [1.13.0→3.0.8] 第四步(验证阶段)的插件核验工具(用户 2026-11-05;五步口径)。
1009
1043
  *
1010
- * 三阶段工作法要求部门 Agent 先梳理问题、再形成可执行思路、最后执行与验证。
1011
- * 这个工具只做一件事:接收三阶段证据并给出核验结论。缺少 planning/execution
1012
- * 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,避免
1013
- * 跳过前两阶段直接宣称验证通过。
1044
+ * 五步工作法要求部门 Agent 先梳理问题(第一步)、再研究资源/工具/方案(第二步)、
1045
+ * 再备齐就绪(第三步)、执行并逐项验证(第四步)、最后收尾与复盘(第五步)。
1046
+ * 这个工具只做一件事:接收五步证据并给出核验结论。缺少 planning/preparation
1047
+ * /execution 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,
1048
+ * 避免跳过前三步直接宣称验证通过。
1014
1049
  *
1015
1050
  * 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用 dsh-workplan 插件」是
1016
1051
  * 该次优化会话的过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
@@ -1019,10 +1054,10 @@ export function createVerifyTool(runtime: any) {
1019
1054
  return {
1020
1055
  name: 'dsh_workplan_verify',
1021
1056
  description:
1022
- '部门子 Agent 在第三阶段(验证阶段)使用的插件核验:提交 planning / execution / verification 三阶段证据,'
1023
- + '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
1024
- + '只有「两轮深度思考产物(第一轮任务深研 problemAnalysis + 第二轮方法流程步骤 approach + 第二轮依据 approachBasis)+ 实际执行步骤」齐全后,才会进入阶段三核验。'
1025
- + '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按三阶段契约判定。',
1057
+ '部门子 Agent 在第四步(验证阶段)使用的插件核验:提交 planning / preparation / execution / verification 五步证据,'
1058
+ + '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / preparation / execution 证据时返回 PHASE_GATE 与待补项;'
1059
+ + '只有「前三步开工证据(第一步任务梳理 + 第二步资源/工具/方案研究 + 第三步准备就绪)+ 实际执行步骤」齐全后,才会进入第四步核验。'
1060
+ + '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按五步契约判定。',
1026
1061
  parameters: {
1027
1062
  type: 'object',
1028
1063
  properties: {
@@ -1036,12 +1071,12 @@ export function createVerifyTool(runtime: any) {
1036
1071
  properties: {
1037
1072
  planning: {
1038
1073
  type: 'object',
1039
- description: '阶段一 · 两轮深度思考:第一轮全面、全盘、深入梳理、研究、思考自己的任务;第二轮基于第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。',
1074
+ description: '第一步 + 第二步:全面、全盘、深入梳理、研究、思考自己的任务(问题梳理),再基于第一步全部结果研究资源、工具与实施方案(方法、流程、步骤,含依据)。',
1040
1075
  properties: {
1041
- problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界)' },
1076
+ problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界)' },
1042
1077
  constraints: { type: 'array', items: { type: 'string' }, description: '约束条件' },
1043
1078
  unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项' },
1044
- approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(每一步做什么、产出什么、如何证明)' },
1079
+ approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:基于第一步全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(每一步做什么、产出什么、如何证明)' },
1045
1080
  approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步的资源、工具、方案如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤' },
1046
1081
  resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:完成本任务需要哪些资源(数据/文件/权限/人/知识/时间),逐项写清用途与获取方式' },
1047
1082
  tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么、为什么选它' },
@@ -1084,7 +1119,7 @@ export function createVerifyTool(runtime: any) {
1084
1119
  requirementCheck: { type: 'string', description: '逐条核对用户原要求的结果' },
1085
1120
  retrospective: {
1086
1121
  type: 'object',
1087
- description: '阶段三收尾的自我学习复盘:本次遇到的问题、走过的弯路、如何解决、以后如何预防再犯',
1122
+ description: '第四步收尾的自我学习复盘:本次遇到的问题、走过的弯路、如何解决、以后如何预防再犯',
1088
1123
  properties: {
1089
1124
  problems: { type: 'array', items: { type: 'string' }, description: '本次全过程遇到的问题(现象 + 根因),至少 1 条' },
1090
1125
  detours: { type: 'array', items: { type: 'string' }, description: '走过的弯路/返工/无效尝试;确实没有就写空数组' },
@@ -1132,7 +1167,7 @@ export function createVerifyTool(runtime: any) {
1132
1167
  )
1133
1168
  }
1134
1169
  return textContent(
1135
- `${String(result.subtaskId ?? '')} 阶段三核验通过:${String(result.summary ?? '')}`
1170
+ `${String(result.subtaskId ?? '')} 第四步核验通过:${String(result.summary ?? '')}`
1136
1171
  + '|把同一份 phases 写进结果块后提交。',
1137
1172
  )
1138
1173
  },
@@ -1147,7 +1182,7 @@ export function createVerifyTool(runtime: any) {
1147
1182
  /**
1148
1183
  * [2.0.0] 永久教训记忆的只读入口(用户 2026-11-05 自我学习要求)。
1149
1184
  *
1150
- * 不提供写动作:记忆只能由「阶段三复盘通过 → 完成判定」这条链写入,
1185
+ * 不提供写动作:记忆只能由「第四步复盘通过 → 完成判定」这条链写入,
1151
1186
  * 防止主 Agent 事后手写一条“教训”绕过真实复盘证据。
1152
1187
  */
1153
1188
  function createLessonsTool(runtime: any) {
@@ -1156,7 +1191,7 @@ function createLessonsTool(runtime: any) {
1156
1191
  description:
1157
1192
  '查看 dsh-workplan 的永久教训记忆(部门完成工作后自动落盘的复盘):'
1158
1193
  + 'action=list 按部门取最相关教训,action=search 按关键词检索,action=stats 看总数/重复数与文件位置。'
1159
- + '只读,不修改计划状态;阶段三验证时用它核对记住了什么、哪些同类错误在重复出现。',
1194
+ + '只读,不修改计划状态;第四步验证时用它核对记住了什么、哪些同类错误在重复出现。',
1160
1195
  parameters: {
1161
1196
  type: 'object',
1162
1197
  properties: {
@@ -1220,6 +1255,7 @@ function createInstructTool(runtime: any) {
1220
1255
  description:
1221
1256
  '向一条「待指示」子任务下发决定:投递给对应子会话,并把该行恢复为执行中(closure=instructed)。'
1222
1257
  + '根会话可答复第一层部门行;部门负责人可答复自己派出的第三层专家(subtaskId 填自己的部门行 ID 或省略,用 member 或 sessionId 指定目标,二者至少其一)。'
1258
+ + '3.0.5 硬规则:第三层只能答复已经提交请示的原专家,投递成功后必须原专家继续执行;待指示期间负责人不得 review/dispatch/direct 改派。'
1223
1259
  + '只有目标子会话的直接父会话可调用,非直系一律拒绝;根路径只接受 closure=escalated 的行。'
1224
1260
  + '投递失败时状态不变(仍是待指示),按返回的 hint 重试或改用 dsh_workplan_update 明确放弃。',
1225
1261
  parameters: {
@@ -1364,8 +1400,8 @@ function createReleaseTool(runtime: any) {
1364
1400
  name: 'dsh_workplan_release',
1365
1401
  description:
1366
1402
  '解除当前会话计划的「认可闸门」并立即派发:先登记用户认可的留痕(gateHistory,durable 回放不丢),'
1367
- + '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/deepThink 等照常生效)。'
1368
- + '仅当计划处于认可闸门之下时可用;若派发因 deepThink 等门禁被拒,闸门保持已解除,'
1403
+ + '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/startPhases 等照常生效)。'
1404
+ + '仅当计划处于认可闸门之下时可用;若派发因 startPhases 等门禁被拒,闸门保持已解除,'
1369
1405
  + '补齐后直接重发 dispatch 即可,认可事实无需重来。仅根会话可用。',
1370
1406
  parameters: {
1371
1407
  type: 'object',
@@ -1378,15 +1414,31 @@ function createReleaseTool(runtime: any) {
1378
1414
  type: 'string',
1379
1415
  description: '用户认可的留痕备注(例如认可的原文摘要),写入 gateHistory。',
1380
1416
  },
1381
- deepThink: {
1417
+ startPhases: {
1382
1418
  type: 'object',
1383
- description: '可选:随解除一并提交的主 Agent 两轮深度思考产物;提供则解除后立即开跑,缺省则派发按 deepThink 门禁返回补交指引。',
1419
+ description: '可选:随解除一并提交的主 Agent 五步第 1/2/3 步开工证据(与 dsh_workplan_dispatch.startPhases 同形状);提供则解除后立即开跑,缺省则派发按 START_EVIDENCE_MISSING 门禁返回补交指引。',
1384
1420
  properties: {
1385
- problemAnalysis: { type: 'string' },
1386
- approach: { type: 'string' },
1387
- approachBasis: { type: 'string' },
1421
+ planning: {
1422
+ type: 'object',
1423
+ properties: {
1424
+ problemAnalysis: { type: 'array', items: { type: 'string' } },
1425
+ resources: { type: 'array', items: { type: 'string' } },
1426
+ tools: { type: 'array', items: { type: 'string' } },
1427
+ approach: { type: 'array', items: { type: 'string' } },
1428
+ approachBasis: { type: 'array', items: { type: 'string' } },
1429
+ },
1430
+ required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
1431
+ },
1432
+ preparation: {
1433
+ type: 'object',
1434
+ properties: {
1435
+ prepared: { type: 'array', items: { type: 'string' } },
1436
+ evidence: { type: 'array', items: { type: 'string' } },
1437
+ },
1438
+ required: ['prepared', 'evidence'],
1439
+ },
1388
1440
  },
1389
- required: ['problemAnalysis', 'approach', 'approachBasis'],
1441
+ required: ['planning', 'preparation'],
1390
1442
  },
1391
1443
  mode: {
1392
1444
  type: 'string',
@@ -1400,7 +1452,7 @@ function createReleaseTool(runtime: any) {
1400
1452
  * 为 tools.register() 强制项。schema 覆盖 runtime.releaseTool 的全部返回形
1401
1453
  * (ok/gateReleased/planId/note/hold/dispatch/code/error;dispatch 为 dispatchTool
1402
1454
  * 的完整结果对象,保持开放对象不裁剪)。render 语义修正:判定「未能解除」
1403
- * 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但 deepThink
1455
+ * 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但 startPhases
1404
1456
  * 门禁拒派发」误报成未解除(该分支 ok 恰为 false 但闸门已松)。
1405
1457
  */
1406
1458
  output: {
@@ -1632,10 +1684,10 @@ function createDispatchTool(runtime: any) {
1632
1684
  description:
1633
1685
  '派发当前会话尚未执行的任务分解计划。计划显示后必须先调用本工具;wait 会等到本轮结束,'
1634
1686
  + '把 durable 结果写入会话并返回每个子任务的状态/摘要。'
1635
- + '【2.5.1 主 Agent 两轮深度思考协议】执行自己的任务必须先全面、全盘、深入梳理、研究、思考自己的任务(第一轮),'
1636
- + '再基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(第二轮),'
1637
- + '最后才基于第二轮的方法、流程、步骤开始执行:首次派发必须随附 deepThink 产物,未提交或不合格被硬门禁拒绝'
1638
- + '(MAIN_DEEP_THINK_MISSING / MAIN_DEEP_THINK_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划的新计划须重新提交。'
1687
+ + '【3.0.8 主 Agent 五步开工证据协议】执行自己的任务必须先完成前三步:全面、全盘、深入梳理、研究、思考自己的任务(第一步任务梳理),'
1688
+ + '基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(第二步资源/工具/方案研究,含依据),'
1689
+ + '再把资源与工具真正备齐并给出就绪证据(第三步准备就绪);最后才基于第二步的方法、流程、步骤开始执行:首次派发必须随附 startPhases 开工证据,未提交或不合格被硬门禁拒绝'
1690
+ + '(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划的新计划须重新提交。'
1639
1691
  + '返回值里的 complete=false 表示计划还没做完(可能只是本轮预算用尽),此时必须再次派发续跑,'
1640
1692
  + '不得把当前产物当作最终结果。重复调用是幂等的。',
1641
1693
  parameters: {
@@ -1651,15 +1703,33 @@ function createDispatchTool(runtime: any) {
1651
1703
  description: '默认 wait:等本轮结束后返回完整结果。async:立即返回 running,'
1652
1704
  + '本轮结束时自动写入结果消息;期间用 dsh_workplan_status 查看进度。',
1653
1705
  },
1654
- deepThink: {
1706
+ startPhases: {
1655
1707
  type: 'object',
1656
- description: '主 Agent 两轮深度思考产物(本计划首次派发必填;已登记后续跑/重启自动读档):第一轮全面、全盘、深入梳理、研究、思考自己的任务;第二轮基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。派发顺序、督战、验收与交付必须按第二轮的方法、流程、步骤执行。',
1708
+ description: '主 Agent 五步第 1/2/3 步开工证据(本计划首次派发必填;已登记后续跑/重启自动读档):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二步基于第一步全部结果的依据;第三步把资源与工具真正备齐并给出就绪证据。派发顺序、督战、验收与交付必须按第二步理清的方法、流程、步骤执行。',
1657
1709
  properties: {
1658
- problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条、合计 ≥40 字。' },
1659
- approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(派发顺序/督战/验收/交付如何做、如何证明),至少 1 条、合计 ≥40 字。' },
1660
- approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填):第二轮如何基于第一轮完成好的所有结果——第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤,至少 1 条、合计 ≥20 字。' },
1710
+ planning: {
1711
+ type: 'object',
1712
+ properties: {
1713
+ problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条、合计 ≥40 字。' },
1714
+ resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
1715
+ tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
1716
+ approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清的具体一步步执行、完美完成任务的方法、流程和步骤(派发顺序/督战/验收/交付如何做、如何证明),至少 1 条、合计 ≥40 字。' },
1717
+ approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤,至少 1 条、合计 ≥20 字。' },
1718
+ },
1719
+ required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
1720
+ additionalProperties: false,
1721
+ },
1722
+ preparation: {
1723
+ type: 'object',
1724
+ properties: {
1725
+ prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
1726
+ evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
1727
+ },
1728
+ required: ['prepared', 'evidence'],
1729
+ additionalProperties: false,
1730
+ },
1661
1731
  },
1662
- required: ['problemAnalysis', 'approach', 'approachBasis'],
1732
+ required: ['planning', 'preparation'],
1663
1733
  additionalProperties: false,
1664
1734
  },
1665
1735
  },
@@ -1875,8 +1945,45 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1875
1945
  config.failClosedOnIncomplete,
1876
1946
  settingEnv('DSH_WORKPLAN_FAIL_CLOSED_ON_INCOMPLETE'),
1877
1947
  ),
1948
+ turnStoppingMaxWaitMs: numericSetting(config.turnStoppingMaxWaitMs, 'DSH_WORKPLAN_TURN_STOPPING_MAX_WAIT_MS', true),
1878
1949
  })
1879
1950
 
1951
+ /*
1952
+ * [3.0.6][第 2 批] 可选留痕清理:默认关闭(0 = 永久保留证据)。
1953
+ * 只有显式配置正数时才启用;启动先跑一次,之后每 24 小时一次。
1954
+ */
1955
+ const journalRetentionDays = (() => {
1956
+ const configured = numericSetting(config.journalRetentionDays, 'DSH_WORKPLAN_JOURNAL_RETENTION_DAYS', true)
1957
+ return configured !== undefined && configured > 0 ? Math.min(configured, 3650) : 0
1958
+ })()
1959
+ if (journalRetentionDays > 0) {
1960
+ const prune = () => {
1961
+ const result = pruneJournal({ retentionDays: journalRetentionDays, excludePlanIds: activePlanIdSet(runtime) })
1962
+ if (!result.ok) ctx.logger?.warn?.(`[dsh-workplan] journal 清理失败:${result.error}`)
1963
+ // 删除失败逐条 warn(ok 仍为 true,errors[] 是弱错误通道,不得静默)。
1964
+ if (Array.isArray(result.errors) && result.errors.length > 0) {
1965
+ for (const line of result.errors) console.warn(`[dsh-workplan] journal 清理异常:${String(line)}`)
1966
+ }
1967
+ return result
1968
+ }
1969
+ ctx.effect(() => {
1970
+ /*
1971
+ * [复审修复] 首次清理从激活同步路径挪到 10s 后:激活是同步路径,不能
1972
+ * 当场扫盘(readdir/stat 大目录会拖住插件注册)。卸载时清除——
1973
+ * journalRetentionTimer 同款的 ctx.effect 清理模式。
1974
+ */
1975
+ const firstPruneTimer = setTimeout(prune, 10_000)
1976
+ if (typeof firstPruneTimer?.unref === 'function') firstPruneTimer.unref()
1977
+ return () => clearTimeout(firstPruneTimer)
1978
+ })
1979
+ ctx.effect(() => {
1980
+ // 卫生类:不触发只少一次清理,不得拖住正在关闭的宿主。
1981
+ const journalRetentionTimer = setInterval(prune, 24 * 60 * 60 * 1000)
1982
+ if (typeof journalRetentionTimer?.unref === 'function') journalRetentionTimer.unref()
1983
+ return () => clearInterval(journalRetentionTimer)
1984
+ })
1985
+ }
1986
+
1880
1987
  ctx.effect(() =>
1881
1988
  ctx.systemPrompt.section({
1882
1989
  name: 'dsh-workplan',
@@ -1904,9 +2011,9 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1904
2011
  * 计划内某行的部门负责人子会话」硬校验;根会话与第三层叶子会话都会被拒。
1905
2012
  */
1906
2013
  ctx.effect(() => ctx.tools.register(createDelegateTool(runtime)))
1907
- /* [1.13.0] 阶段三核验:子会话唯一可用的插件工作能力,阶段一/二会被 PHASE_GATE 拒绝。 */
2014
+ /* [1.13.0→3.0.8] 第四步核验:子会话唯一可用的插件工作能力,前三步会被 PHASE_GATE 拒绝。 */
1908
2015
  ctx.effect(() => ctx.tools.register(createVerifyTool(runtime)))
1909
- /* [2.0.0] 永久教训记忆的只读复核入口(阶段三验证用)。 */
2016
+ /* [2.0.0] 永久教训记忆的只读复核入口(第四步验证用)。 */
1910
2017
  ctx.effect(() => ctx.tools.register(createLessonsTool(runtime)))
1911
2018
  ctx.effect(() => ctx.tools.register(createInstructTool(runtime)))
1912
2019
  /*
@@ -1989,7 +2096,10 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1989
2096
  return
1990
2097
  }
1991
2098
  try {
1992
- const body = readFileSync(new URL('../vendor/chart.umd.js', import.meta.url))
2099
+ if (!chartVendorBytes) {
2100
+ chartVendorBytes = readFileSync(new URL('../vendor/chart.umd.js', import.meta.url))
2101
+ }
2102
+ const body = chartVendorBytes
1993
2103
  res.statusCode = 200
1994
2104
  res.setHeader('content-type', 'text/javascript; charset=utf-8')
1995
2105
  res.setHeader('cache-control', 'public, max-age=3600')
@@ -2005,11 +2115,18 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
2005
2115
  })
2006
2116
 
2007
2117
  ctx.effect(() => () => runtime.dispose())
2118
+
2119
+ /*
2120
+ * [3.0.6][复审修复] 把 runtime 句柄交还给调用方:宿主契约不消费本返回值
2121
+ * (清理一律经上方 effect),测试与宿主编排需要观察 state.records /
2122
+ * 替换 startAutoDispatch 时可直接拿到同一实例,不必从工具闭包里挖。
2123
+ */
2124
+ return runtime
2008
2125
  }
2009
2126
 
2010
2127
  export const meta = {
2011
2128
  name,
2012
- version: '3.0.3',
2129
+ version: '3.0.9',
2013
2130
  promptOrder: PROMPT_ORDER,
2014
2131
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
2015
2132
  }
@@ -2030,7 +2147,14 @@ export function fileWriteGuardReason(
2030
2147
  writeTargets(agent: any, args: any): string[]
2031
2148
  },
2032
2149
  ) {
2033
- if (!isWriteShapedCall(exec)) return undefined
2150
+ /*
2151
+ * [复审修复] bash 写保护绕过:shell 类工具的 command 字符串(重定向/heredoc/
2152
+ * tee/sed -i/cp/mv)此前因参数形状不认(无 file_path/path)而整类绕过闸门。
2153
+ * 先解析出 shell 写目标(非 shell 调用为 null),形状闸门与 shell 闸门至少
2154
+ * 命中其一才继续。
2155
+ */
2156
+ const shellTargets = shellWriteTargets(exec)
2157
+ if (!isWriteShapedCall(exec) && shellTargets === null) return undefined
2034
2158
  // The three historical write tools pass their arguments through untouched, so
2035
2159
  // their behaviour stays exactly as before (argument-shape matching is only an
2036
2160
  // EXTENSION: a tool that used to be denied is still denied the same way).
@@ -2043,9 +2167,47 @@ export function fileWriteGuardReason(
2043
2167
  const extra = runtime.presentedWriteDenialReason(exec?.agent, { file_path: target })
2044
2168
  if (typeof extra === 'string') return extra
2045
2169
  }
2170
+ /*
2171
+ * [复审修复] shell 写目标:与上面同一判定出口——只拦「写入已交付文件」,
2172
+ * 纯读命令(cat/grep/less 该路径)解析不出写目标,天然放行。
2173
+ * 启发式局限(保守模式):只认 > / >> 重定向、tee、sed -i、mv/cp/install/dd
2174
+ * 的目标;命令拼接变量(cmd=path; $cmd)、eval、find -delete 等动态写法
2175
+ * 不在解析范围内——见 shellWriteTargets 注释。
2176
+ */
2177
+ if (shellTargets) {
2178
+ for (const target of shellTargets) {
2179
+ const extra = runtime.presentedWriteDenialReason(exec?.agent, { file_path: target })
2180
+ if (typeof extra === 'string') return extra
2181
+ }
2182
+ }
2046
2183
  return undefined
2047
2184
  }
2048
2185
 
2186
+ /*
2187
+ * [复审修复] 活跃 planId 集合:pruneJournal 只看 mtime,「活跃但安静」的计划
2188
+ * (久无新留痕、mtime 变旧)会被误删;把当前活跃 planId 传给 excludePlanIds
2189
+ * 即可保住。planning 在途时尚未铸出 planId(planId 在规划完成后才生成,占位
2190
+ * 记录 planId=null),因此 runtime.state.records 就是全部活跃 planId 的事实源。
2191
+ * 导出以便直接单测;读取失败返回空集——宁可少排除,也不让清理路径抛错。
2192
+ */
2193
+ export function activePlanIdSet(runtime: any): ReadonlySet<string> {
2194
+ const ids = new Set<string>()
2195
+ try {
2196
+ const records = runtime?.state?.records
2197
+ if (records instanceof Map) {
2198
+ for (const record of records.values()) {
2199
+ const direct = typeof record?.planId === 'string' ? record.planId.trim() : ''
2200
+ const nested = typeof record?.plan?.planId === 'string' ? record.plan.planId.trim() : ''
2201
+ const id = direct !== '' ? direct : (nested !== '' ? nested : null)
2202
+ if (id) ids.add(id)
2203
+ }
2204
+ }
2205
+ } catch {
2206
+ // 同上:名单读取失败不阻断清理。
2207
+ }
2208
+ return ids
2209
+ }
2210
+
2049
2211
  /**
2050
2212
  * [1.12.2] G2: recognise write calls by their argument shape, not by a tool-name
2051
2213
  * allow-list. The 1.8.18 version named write/edit/str_replace_editor only, so a
@@ -2072,3 +2234,78 @@ function isWriteShapedCall(exec: any) {
2072
2234
  // Every other write form names a single target: file_path or path.
2073
2235
  return typeof args.file_path === 'string' || typeof args.path === 'string'
2074
2236
  }
2237
+
2238
+ /*
2239
+ * [复审修复] shell 类工具的识别:exec.name 为 bash/shell/exec,或以它们为
2240
+ * 前缀且前缀后是 [-_] 分隔符或结尾(bash_exec、shell-tool 等宿主工具名变体)。
2241
+ * 要求分隔符是为了避免 'executor' 这类普通名字被误判进 shell 闸门。
2242
+ */
2243
+ function isShellLikeToolName(name: any): boolean {
2244
+ if (typeof name !== 'string' || name === '') return false
2245
+ if (name === 'bash' || name === 'shell' || name === 'exec') return true
2246
+ return /^(?:bash|shell|exec)(?:[-_]|$)/.test(name)
2247
+ }
2248
+
2249
+ /*
2250
+ * [复审修复] 从 shell 调用的 command 字符串解析「写目标路径」。
2251
+ *
2252
+ * 返回 null = 这不是 shell 类调用(或没有 command 参数),调用方据此跳过
2253
+ * shell 闸门;返回数组则可能为空(shell 调用但不含写形态,如纯读的
2254
+ * cat/grep/less)——空数组同样放行。多提取无害:每个候选最终仍走
2255
+ * presentedWriteDenialReason 的「已交付且计划未就绪」判定,普通路径直接
2256
+ * 放行;要防的是漏提取,所以解析宁可宽进。
2257
+ *
2258
+ * 保守模式只认这些强写信号:
2259
+ * - `>` / `>>` 重定向(含 heredoc:`cat <<EOF > path` 的重定向部分);
2260
+ * - `tee [-a] files...`(tee 是纯写管道,必须整组检查);
2261
+ * - `sed -i[.bak] ... files`(段内 -i 之后的全部非选项 token);
2262
+ * - `mv/cp/install 源... 目标`(只取最后一个非选项 token——源是读,只有
2263
+ * 目标是写,全取会把「复制自受保护文件」误拦成写);
2264
+ * - `dd of=path`。
2265
+ *
2266
+ * 启发式局限(有意保守,备查):
2267
+ * - 变量间接(cmd="> $f"; eval、sh -c 嵌套命令)不做展开;
2268
+ * - find -delete、perl -i、crontab 等少见写法不覆盖;
2269
+ * - 引号内带空格的路径按空白截断,不做完整 shell 词法分析;
2270
+ * - 超长命令只解析前 20k 字符。
2271
+ */
2272
+ const SHELL_COMMAND_PARSE_LIMIT = 20_000
2273
+ function shellWriteTargets(exec: any): string[] | null {
2274
+ if (!isShellLikeToolName(exec?.name)) return null
2275
+ const command = exec?.arguments?.command
2276
+ if (typeof command !== 'string' || command.trim() === '') return null
2277
+ const text = command.length > SHELL_COMMAND_PARSE_LIMIT ? command.slice(0, SHELL_COMMAND_PARSE_LIMIT) : command
2278
+ const targets = new Set<string>()
2279
+ const stripQuotes = (token: string) => token.replace(/^['"]+|['"]+$/g, '')
2280
+ const isOption = (token: string) => token === '-' || token.startsWith('-') || token === '--'
2281
+ const add = (token: string | undefined) => {
2282
+ const cleaned = stripQuotes(String(token ?? '')).trim()
2283
+ if (cleaned !== '') targets.add(cleaned)
2284
+ }
2285
+ // > / >> 重定向(兼容 fd 前缀 2>file、1> file;&> 合并重定向跳过——歧义大)。
2286
+ for (const match of text.matchAll(/(?<![&\d])\d*>>?\s*([^\s;|&<>]+)/g)) add(match[1])
2287
+ // 按命令段分隔:; | &&。单 &(2>&1 的合并目标)不拆,避免把 fd 描述切碎。
2288
+ for (const segment of text.split(/&&|[;|]/)) {
2289
+ const trimmed = segment.trim()
2290
+ if (trimmed === '') continue
2291
+ // tee [-a] files...:tee 之后到段尾的全部 token 都是写目标。
2292
+ const tee = /(?:^|\s)tee(?:\s+-[a-zA-Z]+)*\s+(\S(?:[\s\S]*?))?$/.exec(trimmed)
2293
+ if (tee && /\btee\b/.test(trimmed)) {
2294
+ for (const token of (tee[1] ?? '').split(/\s+/)) if (!isOption(token)) add(token)
2295
+ }
2296
+ // sed -i[.bak] ...:段内含 sed 且带 -i 选项时,取其后的全部非选项 token。
2297
+ const sed = /(?:^|\s)sed(?:\s+-[a-zA-Z]+)*\s+(-i\S*)(?:\s+([\s\S]*))?$/.exec(trimmed)
2298
+ if (sed) {
2299
+ for (const token of (sed[2] ?? '').split(/\s+/)) if (!isOption(token)) add(token)
2300
+ }
2301
+ // mv/cp/install 源... 目标:只取最后一个非选项 token(目标是写、源是读)。
2302
+ const mover = /(?:^|\s)(?:mv|cp|install)(?:\s+-[a-zA-Z]+)*\s+([\s\S]+)$/.exec(trimmed)
2303
+ if (mover) {
2304
+ const tokens = (mover[1] ?? '').split(/\s+/).filter((token) => !isOption(token))
2305
+ add(tokens[tokens.length - 1])
2306
+ }
2307
+ // dd of=path(of= 后到空白为止)。
2308
+ for (const match of trimmed.matchAll(/(?:^|\s)of=([^\s;|&]+)/g)) add(match[1])
2309
+ }
2310
+ return [...targets]
2311
+ }