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/src/host.ts CHANGED
@@ -85,6 +85,28 @@ export const PROMPT_ORDER = 40
85
85
 
86
86
  const PROMPT_SECTION = [
87
87
  '本会话已启用自动任务分解。系统会在每个新用户任务的第一个模型步骤前生成计划,并先把计划显示在对话里;收到【任务分解】后,必须先调用 dsh_workplan_dispatch(默认 wait 等结果;预计较久时用 mode:"async" 先开跑),再做任何其他工具调用或回答。',
88
+ /*
89
+ * [3.0.0] 用户 2026-11-14 十三条要求的提示词侧双保险(代码侧同源门禁见
90
+ * v3-contract / comm-format / llm-rules / runtime)。文案不做发挥,只写
91
+ * 机制的实际行为,避免提示词与门禁分叉。
92
+ */
93
+ '3.0.0 会话可见性与状态提示(插件自动执行,你不得省略或改动):接单时插件会自动在会话内输出「任务正在分配中,请稍等一下......」;分配完成(派发成功)后自动输出「任务已经完成分配,正在执行中......」。这两条是逐字冻结的固定文案,由平台发送,你不需要也不得重复发送;若你发现其中一条没有出现在会话里,说明插件未走通对应环节,应先报告而不是假装已发送。计划消息会把你刚才输入的任务原文逐字带在会话里(切换会话再切回也仍可见),这是用户要求 1 的保证,不要删除或改写。',
94
+ '3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
95
+ '3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
96
+ '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.0 版本(用户要求 13):本插件当前版本为 3.0.1。涉及版本号的对外表述一律写 3.0.1。',
98
+ /*
99
+ * [2.5.1] 主 Agent 两轮深度思考协议(用户 2026-11-11 补充要求):部门三层
100
+ * 执行者已有结算/再分配双门禁,主 Agent 自己也必须做到同一协议——提示词
101
+ * 告知 + dispatch 硬门禁(validateMainDeepThink)双保险,与部门层同一哲学。
102
+ */
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),未登记合格两轮思考产物一律不进入正式执行。',
104
+ /*
105
+ * [2.3.10][T2] 用户要求1(P3)提示词双保险:插件已在规划前/派发前自动发送
106
+ * 【规划预告】/【派发预告】(runtime.ts maybePlan / dispatchTool);这里把
107
+ * 「分配前必须先告知用户预估耗时」写成主 Agent 硬规则,防止模型省略或吞掉。
108
+ */
109
+ '分配任务前必须先告知预估耗时:调用 dsh_workplan_dispatch 前,必须先在会话中告知用户本次分配的预估耗时(含明确数值与单位分钟,标注「仅供参考,非承诺」)。插件在规划前与派发前自动发送的【规划预告】/【派发预告】即该告知的组成部分,不得省略、不得吞掉;主 Agent 自己的答复也应向用户转述预估时间。',
88
110
  '如果当前是 plan 模式:不要调用 dsh_workplan_dispatch;先把计划展示给用户,等待用户审阅并退出 plan 模式后,再调用 dsh_workplan_dispatch 执行。',
89
111
  '纯问候、寒暄、致谢、告别、简单确认(如「你好」「谢谢」「好的」「再见」)不生成计划,也不启动子 Agent;直接自然、简短地回答。只有包含实际目标、问题或交付物的消息才进行分解。',
90
112
  '单独的「继续」「接着」「然后呢」「下一步」等没有新增任务内容的追问,不生成计划;由主 Agent 结合会话上下文继续,或先询问用户要延续哪件事。',
@@ -112,20 +134,22 @@ const PROMPT_SECTION = [
112
134
  '5. 「完成」只有一个判据:计划里全部子任务都是 done,**且** deliveryReady=true(每个 done 项 verification="structured"、acceptance 非空且逐项 result="pass"、无缺失产物)。用户取消 ≠ 完成:取消只停止执行,未完成项仍然是未完成。`dsh_workplan_dispatch` 返回 ok:true / complete:true 只表示调用成功或状态全 done,必须再看 deliveryReady 与 完成 X/Y;只要 deliveryReady=false 或还有 pending/blocked,就禁止 present 交付物、禁止写“已完成/最终版/已交付”、禁止给收尾性最终答复,必须先再次调用 dsh_workplan_dispatch 续跑剩余项。',
113
135
  '6. 如果续跑被拒绝、受阻项无法恢复、证据补不齐、计划已取消但未完成,或用户要求先看中间结果:答复开头必须写「未完成:剩余 N 项(列出 ID)与原因」,正文只能按中间结果表述,不得包装成成品。取消不会给你交付许可。',
114
136
  /*
115
- * [2.2.0][T5/O-5a] E1:超时是安全兜底(防止任务无限运行),不是交付期限。
116
- * 旧句把「每步 15 分钟」的规模参考写成硬性上限,等于对外承诺固定完成时间;
117
- * 改为「协商上限+安全兜底」,并给出 extendMs 协商入口。安全概念与事故溯源
118
- * (上方 1.8.7/1.8.13 注释)全部保留,不删。
137
+ * [3.0.1] 部门负责人与全球顶尖专家的正式执行已彻底取消时间上限。
138
+ *
139
+ * 历史版本曾同时使用单次超时、空闲超时、回执超时、整轮预算和十分钟判据;
140
+ * 这些机制会在长任务尚未完成时中止、判 blocked、换人接手或拒绝 done。
141
+ * 现在只保留用户显式取消、真实执行错误、证据与质量门禁。预估和开工上报
142
+ * 仍用于协调,但不得派生任何截止、延期、接手或完成门槛。
119
143
  */
120
- '7. 子任务的时间是「协商上限」+「安全兜底」,不是固定交付期限:规模参考 15 分钟量级(仅供参考、非承诺,实际时长由执行专家开工预告协商决定),整轮预算(默认 20 分钟)同样只是安全兜底,不是交付期限。子 Agent 接近上限时应先把已完成内容落盘并在结论里列出路径。任何「达到协商上限」「本轮预算用尽」都不等于「什么都没做」:状态里的 error 会列出「声明产物已在盘上」,必须先用文件核对;若产物已覆盖验收标准,用 dsh_workplan_update 复核改判,只补缺失部分再续跑,禁止无视盘上产物把整步重跑。确认需要更多时间时,主 Agent 可用 dsh_workplan_update 的 extendMs 协商放宽(放宽永远有界:累计超过初始协商上限的一倍即拒绝,转新轮续跑或转 escalate 请主 Agent/用户裁决)。',
144
+ '7. 执行时间规则:部门负责人和部门相关领域全球顶尖专家执行任务不设总时长、单次时长、空闲无进展或回执硬截止;平台不得仅因执行较久、暂时无新事件或未立即回执而中止、判 blocked、换人接手或拒绝 done。estimateMinutes、timeNotice、timeSpentMinutes 只用于协调与告知,仅供参考、非承诺,不参与完成验收。extendMs 已停用(TIME_LIMITS_DISABLED),无需申请延期。用户显式取消、真实执行错误、证据/质量门禁仍然有效;长时间任务应及时落盘并报告进度,完成与否只由真实结果和验收证据决定。',
121
145
  /*
122
146
  * [2.3.0][T1] 专家执行时间机制三条款(用户 2026-11-10 要求 1/2 的主 Agent 侧义务):
123
147
  * 预估上报后必须转告用户;第 1 次超时必须放宽并告知专家(插件自动投递最新时限
124
148
  * 与质量效率要求);第 2 次超时由主 Agent 接手,已完成部分只读保护、禁止丢弃。
125
149
  */
126
- '7a. [2.3.0] 专家时间机制:专家开工预告(timeNotice/【专家预估上报】通知)到达后,必须把该预估执行时间告知用户;专家第一次超时(【执行中断】通知与状态行 timeoutCount=1)时,必须用 extendMs 放宽——延期成功后插件自动把最新执行时限与「必须在保证工作质量的前提下高效率执行」告知专家,回执 childNotified=false 时用 dsh_workplan_followup 补发;同一子任务第二次超时(timeoutCount≥2,takeoverRequired=true)后不再重派专家,由主 Agent 直接接手:只继续 takeoverBrief.remainingOutputs 与未满足的验收,专家已完成产物已登记为只读保护(landedRefs 并入 artifacts,只增不减),禁止丢弃、禁止删除或覆盖、禁止整步重跑。',
150
+ '7a. 专家预估沟通:timeNotice/【专家预估上报】到达后仍须把预估告知用户;预估变化可再次上报,但它只是协调信息,不会触发延期、超时计数、主 Agent 接手或时长判据。不得要求专家为超过任意分钟数申请批准,也不得因实际耗时高于预估否定其已完成且证据合格的工作。',
127
151
  '8. 出现「待指示」项(closure=escalated,左侧栏显示「待指示」并附问题摘录)时,必须在当轮处理:用 dsh_workplan_instruct 下发决定(投递到子会话并把该行恢复为执行中),或确认放弃后用 dsh_workplan_update 置 blocked。不要沉默略过,也不要把待指示当成普通失败——它是一条还没被回答的请示,会一直占着交付门禁。',
128
- '9. 出现「已下发未响应」(ackOverdue)时,不要重复派发:先用 dsh_workplan_status 看该行 childId 与已等待时长,必要时用 dsh_workplan_followup 投递一次说明;超过硬超时仍未响应会记为 blocked(blockedKind=no-ack),可以再下发指示复活。',
152
+ '9. 出现「已下发未响应」(ackOverdue)时,不要重复派发:先用 dsh_workplan_status 看该行 childId 与已等待时长,必要时用 dsh_workplan_followup 投递一次说明。ackOverdue 仅是提示,不存在无回执硬超时;平台不会仅因此把任务记为 blocked 或中止执行。',
129
153
  /*
130
154
  * [1.11.0] T7:需求变更的重规划不能只靠模型自觉。
131
155
  *
@@ -185,6 +209,10 @@ export type WorkplanConfig = {
185
209
  plannerTimeoutMs?: number
186
210
  /** [2.1.6] 输出开始后的完全静默窗口(毫秒),亦可用 DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS。 */
187
211
  plannerIdleTimeoutMs?: number
212
+ /**
213
+ * 历史兼容字段。为免旧配置报错仍接受数值,但执行层不会据此创建任何
214
+ * 截止、空闲监控、整轮计时器或自动中止;新配置不应再使用。
215
+ */
188
216
  childTimeoutMs?: number
189
217
  idleTimeoutMs?: number
190
218
  totalTimeoutMs?: number
@@ -227,7 +255,7 @@ export type WorkplanConfig = {
227
255
  *
228
256
  * 环境变量:`DSH_WORKPLAN_FAIL_CLOSED_ON_INCOMPLETE=1|0`。
229
257
  */
230
- failClosedOnIncomplete?: boolean
258
+ failClosedOnIncomplete?: boolean | 'auto'
231
259
  }
232
260
 
233
261
  function createUpdateTool(runtime: any) {
@@ -238,9 +266,8 @@ function createUpdateTool(runtime: any) {
238
266
  + '当主 Agent 核对子任务结果、发现完成不实或需要修正时使用。'
239
267
  + '把子任务标成 done 时,必须同时给出真实的 verification 与 acceptance(每项 result="pass"),'
240
268
  + '否则计划不会变成可交付状态(deliveryReady=false,present 会被拒绝)。'
241
- + '运行中的子任务需要更多时间时,传 extendMs(毫秒)即可协商放宽,不需要 force;放宽永远有界(累计 ≤ 初始协商上限 × 1),超出转新轮续跑或转 escalate 请主 Agent 裁决。'
242
- + '[2.3.0] 延期成功后插件自动向执行中的专家投递最新执行时限与「保证质量、高效率执行」要求(回执 childNotified);'
243
- + '同一子任务第二次超时自动置 takeoverRequired,由主 Agent 接手未完成部分,已完成产物只读保护、禁止丢弃。'
269
+ + '部门负责人和全球顶尖专家执行没有时限,extendMs 已停用并返回 TIME_LIMITS_DISABLED;不要申请延期。'
270
+ + 'timeNotice 仅记录预估(仅供参考、非承诺),可用于告知预估变化,不影响执行或验收。'
244
271
  + '这些字段会写入会话日志,刷新/重启后仍然生效。',
245
272
  parameters: {
246
273
  type: 'object',
@@ -256,7 +283,7 @@ function createUpdateTool(runtime: any) {
256
283
  status: {
257
284
  type: 'string',
258
285
  enum: ['pending', 'in_progress', 'done', 'blocked'],
259
- description: '新的状态(普通改判必填;仅协商时限时可省略,改传 extendMs / timeNotice)。',
286
+ description: '新的状态(普通改判必填;仅记录开工预估时可省略并改传 timeNotice)。extendMs 仅为旧调用兼容,会返回 TIME_LIMITS_DISABLED。',
260
287
  },
261
288
  progress: {
262
289
  type: 'integer',
@@ -339,10 +366,27 @@ function createUpdateTool(runtime: any) {
339
366
  */
340
367
  extendMs: {
341
368
  type: 'integer',
342
- description: '延期毫秒数(正整数,仅主 Agent 可用):只推移本子任务的协商截止并重置计时,'
343
- + '不改状态判定;运行中可用,不需要 force。除非另传 status,否则可省略 status。'
344
- + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。'
345
- + '[2.3.0] 延期成功后插件自动告知专家最新执行时限(含保证质量、高效率执行要求);每次超时计一行内 timeoutCount,第二次触发 takeoverRequired(主 Agent 接手,已完成部分只读保护)。',
369
+ description: '旧版延期字段,仅为兼容保留。部门负责人和全球顶尖专家已无执行截止,传入正整数只返回 TIME_LIMITS_DISABLED,不改状态、不重设任何计时器,也不需要用户批准。请改用 timeNotice 更新纯信息预估。',
370
+ },
371
+ /*
372
+ * [SCv2-T4][Q1-B/C06/C08] 用户例外批准留痕(criterionApproval → 行上
373
+ * criterionException)。D-28 教训同源:runtime 会读取的字段必须在这里
374
+ * 显式声明(additionalProperties:false)。5 项口径:任务 ID(subtaskId)、
375
+ * 批准原文/来源(reason/source)、批准时间(at)、放宽后分钟数(由
376
+ * extendMs 自动回填 extendedMinutes)、适用范围(scope)。
377
+ */
378
+ criterionApproval: {
379
+ type: 'object',
380
+ description: '旧版时间判据批准字段,仅为兼容历史调用与记录保留;当前没有时间判据、延期或超时例外审批,此字段不影响 done。完成仍必须通过真实证据、产物与质量验收。',
381
+ properties: {
382
+ approvedBy: { type: 'string', enum: ['user'], description: '批准主体:必须是 user(用户明确批准);主 Agent 自行批准无效。' },
383
+ at: { type: 'number', description: '用户实际批准的时间(epoch 毫秒;展示按 Asia/Shanghai)。不得晚于当前时刻。' },
384
+ reason: { type: 'string', description: '用户批准原文/来源(逐字摘录,必填;「全部按推荐」不构成对个别超时的批准)。' },
385
+ source: { type: 'string', description: '批准来源(可选:用户消息引用/会话 ID 等)。' },
386
+ scope: { type: 'string', enum: ['task', 'plan'], description: '适用范围:task=仅本任务;plan=本计划。' },
387
+ },
388
+ required: ['approvedBy', 'at', 'reason', 'scope'],
389
+ additionalProperties: false,
346
390
  },
347
391
  /*
348
392
  * [2.2.0][T5/O-4c] O-2a 专家开工预告:{declaredMinutes, reason}。与 extendMs
@@ -350,8 +394,7 @@ function createUpdateTool(runtime: any) {
350
394
  */
351
395
  timeNotice: {
352
396
  type: 'object',
353
- description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。'
354
- + '[2.3.0] 落档后插件立即向主会话推送【专家预估上报】通知,提醒主 Agent 把该预期执行时间告知用户。',
397
+ description: '专家开工预估:{ declaredMinutes, reason },只记入信息流水并通知主 Agent 转告用户,仅供参考、非承诺;不生成截止、不触发延期或接管,也不改状态与完成判定。',
355
398
  properties: {
356
399
  declaredMinutes: { type: 'number', description: '预计完成本子任务的分钟数(仅供参考、非承诺)。' },
357
400
  reason: { type: 'string', description: '预告理由(可选)。' },
@@ -704,6 +747,7 @@ function createEscalateTool(runtime: any) {
704
747
  name: 'dsh_workplan_escalate',
705
748
  description:
706
749
  '子 Agent 遇阻时向父会话上报请示,并把该子任务置为「待指示」。'
750
+ + '第三层专家(叶子)同样可用:请示会经 delegate 登记落到所属部门行的第三层台账,由部门负责人用 dsh_workplan_instruct 答复。'
707
751
  + '遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/同一命令连续两次失败/需要主 Agent 决定方向)时,'
708
752
  + '第一动作是调用本工具,然后停止推进、只做只读核对,等待主 Agent 指示。'
709
753
  + '不需要外部决定时不要调用;调用后不要自行选定一个选项继续。',
@@ -777,16 +821,20 @@ function createEscalateTool(runtime: any) {
777
821
  *
778
822
  * 用户要求 4 原文:「分到相关任务的相关部门的负责人,必须再将你分配的任务,
779
823
  * 通过自己全面、全盘、深入开展梳理、研究、思考后,再合理分配相关任务给本部门
780
- * 相关领域全球顶尖专家、本部门的几个组员。」
824
+ * 相关领域全球顶尖专家(部门组员角色已取消)。」
781
825
  *
782
826
  * 落地为两步硬流程(服务端校验,提示词绕不过):
783
827
  * - `review`:提交「全面梳理产物 + 分工表」(问题梳理/约束/未知/思路 +
784
828
  * 每位下级的 member/role/task/reasoningEffort);分工表必须同时含
785
- * ≥1 名 expert(顶尖专家)与 ≥1 名 member(组员)。
829
+ * ≥1 名 expert(顶尖专家);部门组员角色已取消(3.0.0)。
786
830
  * - `dispatch`:未登记 review 产物 ⇒ 硬门禁拒绝;登记后为每位下级派生
787
831
  * 第三层子会话(叶子层,第四层被宿主绝对深度上限硬拒),推理等级按
788
832
  * 当前模型家族合法集合(qwen→low/medium/xhigh;非qwen→low/high/max)
789
833
  * 钳制并留痕,随 agentOptions 全程生效(要求 5)。
834
+ * - `direct`:[2.5.5][T3] low(含未配置视同 low)任务负责人亲自执行登记:
835
+ * 仅收 deepThink 两轮产物(40/40/20 字判据)+可选 reasoningEffort='low',
836
+ * 拒 consolidation/分工表与复杂档;登记后平台以 low 档接续本会话亲自执行
837
+ * (文档同步,门禁在 runtime/llm-rules)。
790
838
  *
791
839
  * 权限模型与 escalate 同款:注册在插件根、对所有会话可见,`execute` 内部由
792
840
  * runtime.delegateTool 按「调用者必须是计划内某行的部门负责人子会话」硬校验。
@@ -795,54 +843,104 @@ function createDelegateTool(runtime: any) {
795
843
  return {
796
844
  name: 'dsh_workplan_delegate',
797
845
  description:
798
- '部门负责人专用的第三层派发(用户要求 4/5):先 action="review" 提交全面梳理产物'
799
- + '(问题梳理 + 分工表:每位下级的 member/role/task/reasoningEffort,至少 1 名 expert 顶尖专家 + 1 名 member 组员),'
800
- + '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家与本部门组员(固定一层下级、叶子层,第四层一律被拒)。'
846
+ '部门负责人专用的第三层派发(用户要求 1/2/3):你拥有本部门内再分配权限。执行自己的任务必须先走两轮深度思考:'
847
+ + '先全面、全盘、深入梳理、研究、思考自己的任务,再基于前一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,'
848
+ + '理清思路与具体一步步执行、完美完成任务的方法、流程和步骤,最后才基于这些方法、流程、步骤执行与再分配。'
849
+ + '先 action="review" 提交两轮深度思考产物'
850
+ // [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 人硬性阻断;'
852
+ + '并可用 consolidation.taskReasoningEffort 为整个任务配置整体推理等级,配置后本任务重试/续跑全程沿用;下级档位以成员 self_effort 自配为权威(分工表档仅建议)),'
853
+ + '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家(部门组员角色已取消,只保留 expert;固定一层下级、叶子层,第四层一律被拒)。'
854
+ + '分配必须更简单:每位专家只承担一个动作、一个主产物、一项可独立验收的工作(简单到像 1+1=2:单句、≤300 字符、不含并列词,且每条必须带至少 1 条 qualityRequirements 质量要求;不满足即拒绝派发)。'
801
855
  + 'review 未提交前 dispatch 被硬门禁拒绝。每位下级的推理等级必须按其任务复杂度配置'
802
856
  + '(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),'
803
857
  + '平台按当前模型家族合法集合自动钳制越界档并留痕,等级在其任务全生命周期生效。'
804
- + 'action="status" 查看梳理登记与下级进度。',
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,正式执行必须按第二轮方法流程步骤进行、全程少走弯路;成员自配为权威、分工表档仅建议)。',
805
861
  parameters: {
806
862
  type: 'object',
807
863
  properties: {
808
864
  action: {
809
865
  type: 'string',
810
- enum: ['review', 'dispatch', 'status'],
811
- description: 'review=提交全面梳理产物与分工表;dispatch=正式派发给专家/组员;status=查看登记与进度。',
866
+ 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(先配置+先思考后开工,缺一硬拒不接续)。',
868
+ },
869
+ reasoningEffort: {
870
+ type: 'string',
871
+ enum: ['low', 'medium', 'high', 'xhigh', 'max'],
872
+ description: 'action="self_effort" 必带(schema 层不强制,缺交将被运行时拒绝 SELF_EFFORT_MISSING):叶子按自己分到的单项任务复杂度自配的推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max)。成员自配为权威,越界档被平台钳制并留痕;登记后平台立即以自配档接续 phase-1。action="direct" 可选:仅接受 \'low\'(缺失默认 low);复杂档请走 review。',
873
+ },
874
+ complexityRationale: {
875
+ type: 'string',
876
+ description: 'action="self_effort" 必带(schema 层不强制,缺交将被运行时拒绝 SELF_EFFORT_RATIONALE_MISSING):复杂度依据(为什么你的单项任务是该档:事实/依赖/验证难度)。',
877
+ },
878
+ deepThink: {
879
+ type: 'object',
880
+ description: 'action="self_effort" 必填(2.5.2 执行前硬门禁):专家执行自己任务前的两轮深度思考产物。第一轮全面、全盘、深入梳理、研究、思考自己分到的任务;第二轮基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清具体如何一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。缺交/不合格硬拒(DEEP_THINK_MISSING / DEEP_THINK_INCOMPLETE),不登记、不接续正式执行;登记后持久化,重派读档放行。action="direct" 必填(负责人 low 直执登记,同一 40/40/20 判据)。',
881
+ 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 字。' },
885
+ },
886
+ required: ['problemAnalysis', 'approach', 'approachBasis'],
887
+ additionalProperties: false,
888
+ },
889
+ timeNotice: {
890
+ type: 'object',
891
+ description: 'action="self_effort" 必填(T6/D9 开工前预估硬门禁):本人任务预估执行时间,整数分钟;未提交/不合格硬拒(ESTIMATE_MISSING/ESTIMATE_INVALID),预估经通道送达部门负责人后才接续执行。',
892
+ properties: {
893
+ declaredMinutes: { type: 'integer', minimum: 1, maximum: 10080, description: '本人任务预估执行时间,正整数分钟(Number.isInteger 且 ≥1、≤10080);单位=分钟。' },
894
+ reason: { type: 'string', description: '可选:预估理由(≤300 字符,trim 后落档)。' },
895
+ },
896
+ required: ['declaredMinutes'],
897
+ additionalProperties: false,
812
898
  },
813
899
  consolidation: {
814
900
  type: 'object',
815
- description: 'action="review" 必填:负责人「全面、全盘、深入梳理」的产物 + 第三层分工表。',
901
+ description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE):负责人执行自己任务时「两轮深度思考」的产物 + 第三层分工表。第一轮:全面、全盘、深入梳理、研究、思考自己的任务(problemAnalysis);第二轮:基于第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步执行、完美完成任务的方法、流程和步骤(approach),并写清第二轮基于第一轮全部结果的依据对应(approachBasis)。两轮产物未齐前 dispatch 被硬门禁拒绝。action="direct" 禁止携带(direct 不接受分工表)。',
816
902
  properties: {
817
903
  problemAnalysis: {
818
904
  type: 'array',
819
905
  items: { type: 'string' },
820
- description: '问题梳理(现状/事实/约束/未知/主要矛盾逐条写清),至少 1 条。',
906
+ description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条。',
821
907
  },
822
908
  constraints: { type: 'array', items: { type: 'string' }, description: '约束条件。' },
823
909
  unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项。' },
824
- approach: { 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
+ taskReasoningEffort: {
913
+ type: 'string',
914
+ enum: ['low', 'medium', 'high', 'xhigh', 'max'],
915
+ description: '可选:负责人为整个任务配置的整体推理等级(按本任务复杂度:轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max)。负责人自配整体档:配置后本任务每次派发/重试/续跑全程沿用;下级以 self_effort 自配为权威;越界档被平台钳制并留痕。',
916
+ },
825
917
  assignments: {
826
918
  type: 'array',
827
- description: '分工表:至少 1 名 expert(全球顶尖专家)+ 1 名 member(部门组员),最多 6 人。',
919
+ // [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 条可检查的质量要求);不满足即拒绝派发。',
828
921
  items: {
829
922
  type: 'object',
830
923
  properties: {
831
- member: { type: 'string', description: '专家/组员的姓名或代号。' },
832
- role: { type: 'string', enum: ['expert', 'member'], description: 'expert=本部门相关领域全球顶尖专家;member=本部门组员。' },
833
- task: { type: 'string', description: '分配给该下级的任务(完整、自包含)。' },
924
+ member: { type: 'string', description: '专家的姓名或代号。' },
925
+ role: { type: 'string', enum: ['expert'], description: '只能是 expert=本部门相关领域全球顶尖专家(部门组员角色已取消;历史数据里的 member 读取时归一为 expert)。' },
926
+ task: { type: 'string', description: '分配给该专家的任务:一个动作、一个主产物,完整自包含,单句且 ≤300 字符;出现并列词或分句会被拒绝(DELEGATE_TASK_NOT_ATOMIC)。' },
927
+ qualityRequirements: {
928
+ type: 'array',
929
+ items: { type: 'string' },
930
+ description: '必填(用户要求 6):这条任务成果必须达到的要求和质量,至少 1 条、最多 8 条、每条 ≤400 字符,写清什么算合格、什么算不合格;缺失即拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING)。',
931
+ },
834
932
  reasoningEffort: {
835
933
  type: 'string',
836
934
  enum: ['low', 'medium', 'high', 'xhigh', 'max'],
837
- description: '按该任务复杂度配置:轻度=low;比较复杂的任务 qwen 系=medium、非 qwen 系=high;非常复杂的任务 qwen 系=xhigh、非 qwen 系=max。越界档会被平台钳制并留痕。',
935
+ description: '按该任务复杂度配置:轻度=low;比较复杂的任务 qwen 系=medium、非 qwen 系=high;非常复杂的任务 qwen 系=xhigh、非 qwen 系=max。建议档(成员自配为权威):叶子 phase-0 一律 low 启动并经 self_effort 自配;越界档会被平台钳制并留痕。',
838
936
  },
839
937
  },
840
- required: ['member', 'role', 'task'],
938
+ required: ['member', 'role', 'task', 'qualityRequirements'],
841
939
  additionalProperties: false,
842
940
  },
843
941
  },
844
942
  },
845
- required: ['problemAnalysis', 'assignments'],
943
+ required: ['problemAnalysis', 'approach', 'approachBasis', 'assignments'],
846
944
  additionalProperties: false,
847
945
  },
848
946
  },
@@ -877,8 +975,8 @@ function createDelegateTool(runtime: any) {
877
975
  const members = Array.isArray(result.members) ? result.members : []
878
976
  const clamped = Array.isArray(result.clamped) ? result.clamped : []
879
977
  return textContent(
880
- `梳理产物已登记(${String(result.subtaskId ?? '')}):分工 ${members.length} 人`
881
- + `(expert ${members.filter((m: any) => m?.role === 'expert').length} / member ${members.filter((m: any) => m?.role === 'member').length})`
978
+ `梳理产物已登记(${String(result.subtaskId ?? '')}):分工 ${members.length} 名专家`
979
+ + `(全部为 expert;部门组员角色已取消)`
882
980
  + (clamped.length ? `;越界等级已钳制 ${clamped.length} 条(${clamped.map((c: any) => `${c.member}:${c.requested}→${c.corrected}`).join('、')})` : '')
883
981
  + '|下一步:action="dispatch" 正式派发。',
884
982
  )
@@ -887,7 +985,7 @@ function createDelegateTool(runtime: any) {
887
985
  const delegates = Array.isArray(result.delegates) ? result.delegates : []
888
986
  return textContent(
889
987
  `第三层已派发 ${delegates.length} 人:`
890
- + delegates.map((d: any) => `${d?.member ?? '?'}(${d?.role === 'expert' ? '专家' : '组员'}/${d?.effort ?? '?'}/${d?.status ?? '?'})`).join('、')
988
+ + delegates.map((d: any) => `${d?.member ?? '?'}(专家/${d?.effort ?? '?'}/${d?.status ?? '?'})`).join('、')
891
989
  + '|下级结论会送回本会话;收齐汇总核验后再写最终结果块。action="status" 可查看进度。',
892
990
  )
893
991
  }
@@ -923,7 +1021,7 @@ export function createVerifyTool(runtime: any) {
923
1021
  description:
924
1022
  '部门子 Agent 在第三阶段(验证阶段)使用的插件核验:提交 planning / execution / verification 三阶段证据,'
925
1023
  + '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
926
- + '只有「问题梳理 + 可执行思路 + 实际执行步骤」齐全后,才会进入阶段三核验。'
1024
+ + '只有「两轮深度思考产物(第一轮任务深研 problemAnalysis + 第二轮方法流程步骤 approach + 第二轮依据 approachBasis)+ 实际执行步骤」齐全后,才会进入阶段三核验。'
927
1025
  + '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按三阶段契约判定。',
928
1026
  parameters: {
929
1027
  type: 'object',
@@ -938,13 +1036,15 @@ export function createVerifyTool(runtime: any) {
938
1036
  properties: {
939
1037
  planning: {
940
1038
  type: 'object',
1039
+ description: '阶段一 · 两轮深度思考:第一轮全面、全盘、深入梳理、研究、思考自己的任务;第二轮基于第一轮完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。',
941
1040
  properties: {
942
- problemAnalysis: { type: 'array', items: { type: 'string' }, description: '要解决的问题逐条梳理(现状/事实/约束/未知/主要矛盾/边界)' },
1041
+ problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界)' },
943
1042
  constraints: { type: 'array', items: { type: 'string' }, description: '约束条件' },
944
1043
  unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项' },
945
- approach: { type: 'array', items: { type: 'string' }, description: '完整可执行的思路:每一步做什么、产出什么、如何证明' },
1044
+ approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(每一步做什么、产出什么、如何证明)' },
1045
+ approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填):第二轮如何基于第一轮完成好的所有结果——第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤' },
946
1046
  },
947
- required: ['problemAnalysis', 'approach'],
1047
+ required: ['problemAnalysis', 'approach', 'approachBasis'],
948
1048
  },
949
1049
  execution: {
950
1050
  type: 'object',
@@ -1097,16 +1197,19 @@ function createLessonsTool(runtime: any) {
1097
1197
  /**
1098
1198
  * [1.11.0] 主 → 子的指示通道(T4 C-10 / T6 M6)。
1099
1199
  *
1100
- * 服务端硬校验:根会话、该行 `closure:'escalated'`、`childId` 是本会话直接
1101
- * 子会话、instruction 非空且 ≤4000 字符。投递失败时不改状态 —— 「我发了」
1102
- * 与「它收到了」必须是两件事,否则界面会显示一个没人执行的指示。
1200
+ * 服务端硬校验:调用者是目标子会话的直接父会话(根会话答复第一层部门行,
1201
+ * 部门负责人答复自己派出的第三层叶子;严格 lineage,非直系一律拒绝)、
1202
+ * 目标 `closure:'escalated'`、`childId` 是调用者直接子会话、instruction
1203
+ * 非空且 ≤4000 字符。投递失败时不改状态 —— 「我发了」与「它收到了」必须
1204
+ * 是两件事,否则界面会显示一个没人执行的指示。
1103
1205
  */
1104
1206
  function createInstructTool(runtime: any) {
1105
1207
  return {
1106
1208
  name: 'dsh_workplan_instruct',
1107
1209
  description:
1108
- '向一条「待指示」子任务下发主 Agent 的决定:投递给对应子会话,并把该行恢复为执行中(closure=instructed)。'
1109
- + '只有根会话可调用;只接受 closure=escalated 的行。'
1210
+ '向一条「待指示」子任务下发决定:投递给对应子会话,并把该行恢复为执行中(closure=instructed)。'
1211
+ + '根会话可答复第一层部门行;部门负责人可答复自己派出的第三层专家(subtaskId 填自己的部门行 ID 或省略,用 member 或 sessionId 指定目标,二者至少其一)。'
1212
+ + '只有目标子会话的直接父会话可调用,非直系一律拒绝;根路径只接受 closure=escalated 的行。'
1110
1213
  + '投递失败时状态不变(仍是待指示),按返回的 hint 重试或改用 dsh_workplan_update 明确放弃。',
1111
1214
  parameters: {
1112
1215
  type: 'object',
@@ -1117,7 +1220,15 @@ function createInstructTool(runtime: any) {
1117
1220
  },
1118
1221
  subtaskId: {
1119
1222
  type: 'string',
1120
- description: '待指示的子任务 ID,例如 T3。',
1223
+ description: '待指示的子任务 ID,例如 T3。部门负责人答复第三层叶子时填自己的部门行 ID。',
1224
+ },
1225
+ member: {
1226
+ type: 'string',
1227
+ description: '可选:第三层成员名(delegates[].member)。仅部门负责人答复叶子时使用;与 sessionId 至少其一。',
1228
+ },
1229
+ sessionId: {
1230
+ type: 'string',
1231
+ description: '可选:目标叶子的子会话 ID(delegates[].childId)。仅部门负责人答复叶子时使用;与 member 至少其一;必须是调用者的直接子会话。',
1121
1232
  },
1122
1233
  instruction: {
1123
1234
  type: 'string',
@@ -1168,6 +1279,153 @@ function createInstructTool(runtime: any) {
1168
1279
  }
1169
1280
  }
1170
1281
 
1282
+ /**
1283
+ * [3.0.1] 认可闸门·显式按住(双保险中不依赖关键词识别的那一半)。
1284
+ * 与 dispatch 同款权限模型:注册在插件根,execute 内部 isRootSession 硬校验。
1285
+ */
1286
+ function createHoldTool(runtime: any) {
1287
+ return {
1288
+ name: 'dsh_workplan_hold',
1289
+ description:
1290
+ '把当前会话尚未派发的计划设为「认可闸门」按住状态:在用户明确认可前,自动与手动派发都会被拒绝'
1291
+ + '(dsh_workplan_dispatch 返回 DISPATCH_HELD)。用于任务要求先经用户认可再执行、'
1292
+ + '而任务锚点又未被关键词识别命中的场景。只能设在尚未派发的计划上;已开跑的计划不设闸门。'
1293
+ + '解除唯一出口:用户明确认可后调用 dsh_workplan_release(登记留痕并开跑)。',
1294
+ parameters: {
1295
+ type: 'object',
1296
+ properties: {
1297
+ planId: {
1298
+ type: 'string',
1299
+ description: '计划 ID;省略时使用当前会话最新计划。',
1300
+ },
1301
+ reason: {
1302
+ type: 'string',
1303
+ description: '按住原因(会写入闸门记录与 durable 留档)。',
1304
+ },
1305
+ },
1306
+ },
1307
+ /*
1308
+ * [3.0.1-激活热修] DSH tools.register() 的强制契约:每个工具必须声明
1309
+ * output { schema, render, presentationMeta? }(dsh-tools/src/index.ts
1310
+ * register() 校验,缺 output 或 render 非函数即抛 TypeError)。此前本工具
1311
+ * 把 render 直接挂在工具根上、整体缺 output 包裹,宿主注册即抛
1312
+ * 「tool "dsh_workplan_hold" must declare output { schema, render, presentationMeta? }」,
1313
+ * 整个插件条目启用失败(web/headless 两 profile 经符号链接同源皆挂)。
1314
+ * 此处与文件内其它 12 个工具同款写法对齐:schema 覆盖 runtime.holdTool 的
1315
+ * 全部返回形(ok/planId/alreadyHeld/hold/code/error),render 按宿主契约
1316
+ * 接收 (args, value) 并返回 ContentBlock[](textContent)。
1317
+ */
1318
+ output: {
1319
+ schema: {
1320
+ type: 'object',
1321
+ properties: {
1322
+ ok: { type: 'boolean' },
1323
+ planId: { type: 'string' },
1324
+ alreadyHeld: { type: 'boolean' },
1325
+ hold: { type: 'object', additionalProperties: true },
1326
+ code: { type: 'string' },
1327
+ error: { type: 'string' },
1328
+ },
1329
+ required: ['ok'],
1330
+ additionalProperties: true,
1331
+ },
1332
+ render(_args: any, value: any) {
1333
+ const result = isRecord(value) ? value : {}
1334
+ if (!result.ok) {
1335
+ return textContent(`未能按住计划:${String(result.error ?? '未知错误')}(${String(result.code ?? '')})`)
1336
+ }
1337
+ if (result.alreadyHeld) return textContent('计划已在认可闸门之下,无需重复按住。')
1338
+ return textContent(`计划 ${String(result.planId ?? '')} 已设为认可闸门按住:用户明确认可前不得派发。`)
1339
+ },
1340
+ },
1341
+ async execute(args: any, exec: any) {
1342
+ const parsed = asObject(args) ?? {}
1343
+ return runtime.holdTool(exec.agent, parsed)
1344
+ },
1345
+ }
1346
+ }
1347
+
1348
+ /**
1349
+ * [3.0.1] 认可闸门·解除并开跑:「用户已明确认可」的唯一合法出口。
1350
+ */
1351
+ function createReleaseTool(runtime: any) {
1352
+ return {
1353
+ name: 'dsh_workplan_release',
1354
+ description:
1355
+ '解除当前会话计划的「认可闸门」并立即派发:先登记用户认可的留痕(gateHistory,durable 回放不丢),'
1356
+ + '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/deepThink 等照常生效)。'
1357
+ + '仅当计划处于认可闸门之下时可用;若派发因 deepThink 等门禁被拒,闸门保持已解除,'
1358
+ + '补齐后直接重发 dispatch 即可,认可事实无需重来。仅根会话可用。',
1359
+ parameters: {
1360
+ type: 'object',
1361
+ properties: {
1362
+ planId: {
1363
+ type: 'string',
1364
+ description: '计划 ID;省略时使用当前会话最新计划。',
1365
+ },
1366
+ note: {
1367
+ type: 'string',
1368
+ description: '用户认可的留痕备注(例如认可的原文摘要),写入 gateHistory。',
1369
+ },
1370
+ deepThink: {
1371
+ type: 'object',
1372
+ description: '可选:随解除一并提交的主 Agent 两轮深度思考产物;提供则解除后立即开跑,缺省则派发按 deepThink 门禁返回补交指引。',
1373
+ properties: {
1374
+ problemAnalysis: { type: 'string' },
1375
+ approach: { type: 'string' },
1376
+ approachBasis: { type: 'string' },
1377
+ },
1378
+ required: ['problemAnalysis', 'approach', 'approachBasis'],
1379
+ },
1380
+ mode: {
1381
+ type: 'string',
1382
+ enum: ['sync', 'async'],
1383
+ description: '可选:解除后的派发模式,语义与 dsh_workplan_dispatch.mode 相同。',
1384
+ },
1385
+ },
1386
+ },
1387
+ /*
1388
+ * [3.0.1-激活热修] 与 dsh_workplan_hold 同款契约修复:output { schema, render }
1389
+ * 为 tools.register() 强制项。schema 覆盖 runtime.releaseTool 的全部返回形
1390
+ * (ok/gateReleased/planId/note/hold/dispatch/code/error;dispatch 为 dispatchTool
1391
+ * 的完整结果对象,保持开放对象不裁剪)。render 语义修正:判定「未能解除」
1392
+ * 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但 deepThink
1393
+ * 门禁拒派发」误报成未解除(该分支 ok 恰为 false 但闸门已松)。
1394
+ */
1395
+ output: {
1396
+ schema: {
1397
+ type: 'object',
1398
+ properties: {
1399
+ ok: { type: 'boolean' },
1400
+ gateReleased: { type: 'boolean' },
1401
+ planId: { type: 'string' },
1402
+ note: { type: 'string' },
1403
+ hold: { type: 'object', additionalProperties: true },
1404
+ dispatch: { type: 'object', additionalProperties: true },
1405
+ code: { type: 'string' },
1406
+ error: { type: 'string' },
1407
+ },
1408
+ required: ['ok'],
1409
+ additionalProperties: true,
1410
+ },
1411
+ render(_args: any, value: any) {
1412
+ const result = isRecord(value) ? value : {}
1413
+ if (result.gateReleased !== true) {
1414
+ return textContent(`未能解除闸门:${String(result.error ?? '未知错误')}(${String(result.code ?? '')})`)
1415
+ }
1416
+ if (result.dispatch && result.dispatch.ok === false) {
1417
+ return textContent(`认可闸门已解除,但派发未通过:${String(result.dispatch.error ?? '')}(${String(result.dispatch.code ?? '')})`)
1418
+ }
1419
+ return textContent(`认可闸门已解除(${String(result.hold?.reason ?? '')}),计划已开始执行。`)
1420
+ },
1421
+ },
1422
+ async execute(args: any, exec: any) {
1423
+ const parsed = asObject(args) ?? {}
1424
+ return runtime.releaseTool(exec.agent, parsed, exec.signal)
1425
+ },
1426
+ }
1427
+ }
1428
+
1171
1429
  /**
1172
1430
  * [1.11.0] 跨部门需求的处置入口(用户 m00687)。
1173
1431
  *
@@ -1363,6 +1621,10 @@ function createDispatchTool(runtime: any) {
1363
1621
  description:
1364
1622
  '派发当前会话尚未执行的任务分解计划。计划显示后必须先调用本工具;wait 会等到本轮结束,'
1365
1623
  + '把 durable 结果写入会话并返回每个子任务的状态/摘要。'
1624
+ + '【2.5.1 主 Agent 两轮深度思考协议】执行自己的任务必须先全面、全盘、深入梳理、研究、思考自己的任务(第一轮),'
1625
+ + '再基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清思路与具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(第二轮),'
1626
+ + '最后才基于第二轮的方法、流程、步骤开始执行:首次派发必须随附 deepThink 产物,未提交或不合格被硬门禁拒绝'
1627
+ + '(MAIN_DEEP_THINK_MISSING / MAIN_DEEP_THINK_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划的新计划须重新提交。'
1366
1628
  + '返回值里的 complete=false 表示计划还没做完(可能只是本轮预算用尽),此时必须再次派发续跑,'
1367
1629
  + '不得把当前产物当作最终结果。重复调用是幂等的。',
1368
1630
  parameters: {
@@ -1378,6 +1640,17 @@ function createDispatchTool(runtime: any) {
1378
1640
  description: '默认 wait:等本轮结束后返回完整结果。async:立即返回 running,'
1379
1641
  + '本轮结束时自动写入结果消息;期间用 dsh_workplan_status 查看进度。',
1380
1642
  },
1643
+ deepThink: {
1644
+ type: 'object',
1645
+ description: '主 Agent 两轮深度思考产物(本计划首次派发必填;已登记后续跑/重启自动读档):第一轮全面、全盘、深入梳理、研究、思考自己的任务;第二轮基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二轮基于第一轮全部结果的依据。派发顺序、督战、验收与交付必须按第二轮的方法、流程、步骤执行。',
1646
+ properties: {
1647
+ problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条、合计 ≥40 字。' },
1648
+ approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(派发顺序/督战/验收/交付如何做、如何证明),至少 1 条、合计 ≥40 字。' },
1649
+ approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填):第二轮如何基于第一轮完成好的所有结果——第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤,至少 1 条、合计 ≥20 字。' },
1650
+ },
1651
+ required: ['problemAnalysis', 'approach', 'approachBasis'],
1652
+ additionalProperties: false,
1653
+ },
1381
1654
  },
1382
1655
  additionalProperties: false,
1383
1656
  },
@@ -1441,14 +1714,7 @@ function createDispatchTool(runtime: any) {
1441
1714
  )
1442
1715
  },
1443
1716
  },
1444
- /*
1445
- * The host tool timeout must outlive the plan budget, otherwise the model
1446
- * call is killed while the dispatcher is still legitimately working and the
1447
- * plan looks stuck. Derive it from the resolved limits.
1448
- */
1449
- timeoutMs: Number(runtime?.limits?.totalTimeoutMs ?? 0) > 0
1450
- ? Number(runtime.limits.totalTimeoutMs) + 20000
1451
- : 24 * 60 * 60 * 1000,
1717
+ // 不声明 timeoutMs:部门与专家执行没有工具层 24 小时或预算派生截止。
1452
1718
  async execute(args: any, exec: any) {
1453
1719
  const parsed = asObject(args) ?? {}
1454
1720
  return runtime.dispatchTool(exec.agent, parsed, exec.signal)
@@ -1457,11 +1723,12 @@ function createDispatchTool(runtime: any) {
1457
1723
  }
1458
1724
 
1459
1725
  /*
1460
- * Read the limits from the environment when the config does not set them.
1726
+ * [3.0.1] Legacy limit readers.
1461
1727
  *
1462
- * The plugin used to hard-code a 300 s child ceiling with no way to raise it
1463
- * short of editing the source, so any machine with slower subagents hit the
1464
- * wall on every plan. These knobs let operations tune it without a rebuild.
1728
+ * childTimeoutMs / idleTimeoutMs / totalTimeoutMs and their environment
1729
+ * variables are still accepted so old profile configs do not fail validation,
1730
+ * but the runtime no longer arms any deadline from them. They must not be
1731
+ * documented or used as a way to limit department-lead or expert execution.
1465
1732
  */
1466
1733
  /**
1467
1734
  * [1.10.4] 布尔开关:配置项优先,其次环境变量。
@@ -1540,10 +1807,12 @@ export function toolGuardReason(
1540
1807
  exec: any,
1541
1808
  runtime: { planModeActive(session: any): boolean; presentDenialReason(agent: any): string | undefined },
1542
1809
  ) {
1543
- if (exec?.name === 'dsh_workplan_dispatch') {
1810
+ if (exec?.name === 'dsh_workplan_dispatch' || exec?.name === 'dsh_workplan_release') {
1544
1811
  const session = exec?.agent?.session
1545
1812
  if (session && runtime.planModeActive(session)) {
1546
- return '当前是 plan 模式:计划已生成,请先让用户审阅/退出 plan 模式,再调用 dsh_workplan_dispatch。'
1813
+ return exec?.name === 'dsh_workplan_release'
1814
+ ? '当前是 plan 模式:计划尚待用户审阅,不能用 dsh_workplan_release 绕过审阅直接开跑;请用户退出 plan 模式后再解除闸门/派发。'
1815
+ : '当前是 plan 模式:计划已生成,请先让用户审阅/退出 plan 模式,再调用 dsh_workplan_dispatch。'
1547
1816
  }
1548
1817
  return undefined
1549
1818
  }
@@ -1642,6 +1911,9 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1642
1911
  */
1643
1912
  ctx.effect(() => ctx.tools.register(createHandoffTool(runtime)))
1644
1913
  ctx.effect(() => ctx.tools.register(createDispatchTool(runtime)))
1914
+ /* [3.0.1] 认可闸门:显式按住 / 解除并开跑,与 dispatch 同款根会话硬校验。 */
1915
+ ctx.effect(() => ctx.tools.register(createHoldTool(runtime)))
1916
+ ctx.effect(() => ctx.tools.register(createReleaseTool(runtime)))
1645
1917
 
1646
1918
  /*
1647
1919
  * Plan mode produces a plan for review, not department execution. Denying
@@ -1655,6 +1927,11 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1655
1927
  ctx.effect(() => ctx.tools.guard((exec: any) => toolGuardReason(exec, runtime)))
1656
1928
 
1657
1929
  ctx.effect(() => ctx.on('agent/pre-step', runtime.onPreStep))
1930
+ /*
1931
+ * [3.0.1] 后台规划等待期间,followup/queue 可能还没进入下一次 pre-step。
1932
+ * 在官方 inbox 插入事件处立即取代旧规划,避免旧结果迟到覆盖新任务。
1933
+ */
1934
+ ctx.effect(() => ctx.on('agent/inbox/inserted', runtime.onInboxInserted))
1658
1935
  /*
1659
1936
  * [1.8.7] 回合收尾前的闸门。官方 `agent/turn-stopping` 是 serial 事件、
1660
1937
  * 在边界提交前被 await;监听器 `agent.steer()` 后机器会重读 inbox,于是
@@ -1721,7 +1998,7 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1721
1998
 
1722
1999
  export const meta = {
1723
2000
  name,
1724
- version: '2.3.9',
2001
+ version: '3.0.1',
1725
2002
  promptOrder: PROMPT_ORDER,
1726
2003
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1727
2004
  }