dsh-workplan 3.0.0 → 3.0.2

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
@@ -94,7 +94,7 @@ const PROMPT_SECTION = [
94
94
  '3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
95
95
  '3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
96
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.0。涉及版本号的对外表述一律写 3.0.0。',
97
+ '3.0.2 版本(用户要求 13):本插件当前版本为 3.0.2。涉及版本号的对外表述一律写 3.0.2。',
98
98
  /*
99
99
  * [2.5.1] 主 Agent 两轮深度思考协议(用户 2026-11-11 补充要求):部门三层
100
100
  * 执行者已有结算/再分配双门禁,主 Agent 自己也必须做到同一协议——提示词
@@ -134,24 +134,22 @@ const PROMPT_SECTION = [
134
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 续跑剩余项。',
135
135
  '6. 如果续跑被拒绝、受阻项无法恢复、证据补不齐、计划已取消但未完成,或用户要求先看中间结果:答复开头必须写「未完成:剩余 N 项(列出 ID)与原因」,正文只能按中间结果表述,不得包装成成品。取消不会给你交付许可。',
136
136
  /*
137
- * [2.2.0][T5/O-5a] E1:超时是安全兜底(防止任务无限运行),不是交付期限。
138
- * 旧句把「每步 15 分钟」的规模参考写成硬性上限,等于对外承诺固定完成时间;
139
- * 改为「协商上限+安全兜底」,并给出 extendMs 协商入口。安全概念与事故溯源
140
- * (上方 1.8.7/1.8.13 注释)全部保留,不删。
137
+ * [3.0.1] 部门负责人与全球顶尖专家的正式执行已彻底取消时间上限。
141
138
  *
142
- * [2.6.0][Q7-B] 边界澄清:本条禁止的是把规模参考写成运行层硬上限、对外承诺
143
- * 固定完成时间;用户 2026-11-13 裁决后的判据层完成目标 ≤10 分钟不属于此列
144
- * (判据层与运行层分层并存,见第 7 条)。
139
+ * 历史版本曾同时使用单次超时、空闲超时、回执超时、整轮预算和十分钟判据;
140
+ * 这些机制会在长任务尚未完成时中止、判 blocked、换人接手或拒绝 done。
141
+ * 现在只保留用户显式取消、真实执行错误、证据与质量门禁。预估和开工上报
142
+ * 仍用于协调,但不得派生任何截止、延期、接手或完成门槛。
145
143
  */
146
- '7. 子任务的时间分两层(用户 2026-11-13 裁决,组合 B/B/B/B/A/A/B):判据层=完成目标 ≤10 分钟(默认必须达成;确需超出,唯一合法例外=用户明确批准并留痕:任务 ID、批准原文/来源、批准时间、放宽后分钟数、适用范围;无留痕=未批准,不得以 done 收尾);运行层安全兜底=协商上限 clamp(estimateMinutes×2.0, 1 秒, 120 分钟)+到点 L4 安全兜底结算+120 分钟绝对上限,它不是固定交付期限、不构成对外承诺,更不构成「允许慢」的许可。计量口径=单次尝试墙钟(每次尝试独立计,续跑/重试不累加);主计划行达标须同时满足「事前叶子预估之和 ≤10 分钟」与「事后该行单次尝试墙钟 ≤10 分钟」。生效时点:自补丁部署+用户重启+复核通过后新创建的计划起适用;此前已验收为 done 的历史任务与在途计划一律不回溯、不改判。整轮预算(默认 20 分钟)同样只是运行层安全兜底,不是交付期限。子 Agent 接近上限时应先把已完成内容落盘并在结论里列出路径。任何「达到协商上限」「本轮预算用尽」都不等于「什么都没做」:状态里的 error 会列出「声明产物已在盘上」,必须先用文件核对;若产物已覆盖验收标准,用 dsh_workplan_update 复核改判,只补缺失部分再续跑,禁止无视盘上产物把整步重跑。确认需要更多时间时,须先向用户申请例外并留痕(任务 ID、批准原文/来源、批准时间、放宽后分钟数、适用范围;无留痕=未批准),批准后才可用 dsh_workplan_update 的 extendMs 协商放宽(放宽永远有界:累计超过初始协商上限的一倍即拒绝,转新轮续跑或转 escalate 请主 Agent/用户裁决)。',
144
+ '7. 执行时间规则:部门负责人和部门相关领域全球顶尖专家执行任务不设总时长、单次时长、空闲无进展或回执硬截止;平台不得仅因执行较久、暂时无新事件或未立即回执而中止、判 blocked、换人接手或拒绝 done。estimateMinutes、timeNotice、timeSpentMinutes 只用于协调与告知,仅供参考、非承诺,不参与完成验收。extendMs 已停用(TIME_LIMITS_DISABLED),无需申请延期。用户显式取消、真实执行错误、证据/质量门禁仍然有效;长时间任务应及时落盘并报告进度,完成与否只由真实结果和验收证据决定。',
147
145
  /*
148
146
  * [2.3.0][T1] 专家执行时间机制三条款(用户 2026-11-10 要求 1/2 的主 Agent 侧义务):
149
147
  * 预估上报后必须转告用户;第 1 次超时必须放宽并告知专家(插件自动投递最新时限
150
148
  * 与质量效率要求);第 2 次超时由主 Agent 接手,已完成部分只读保护、禁止丢弃。
151
149
  */
152
- '7a. [2.3.0→2.6.0] 专家时间机制(按用户 2026-11-13 裁决 Q1-B:第一次超时不再自动放宽,改为用户批准后才放宽):专家开工预告(timeNotice/【专家预估上报】通知)到达后,必须把该预估执行时间告知用户;专家第一次超时(【执行中断】通知与状态行 timeoutCount=1)时,先向用户申请例外并留痕(任务 ID、批准原文/来源、批准时间、放宽后分钟数、适用范围;无留痕=未批准),用户批准后才可用 extendMs 放宽——延期成功后插件自动把最新执行时限与「必须在保证工作质量的前提下高效率执行」告知专家,回执 childNotified=false 时用 dsh_workplan_followup 补发;同一子任务第二次超时(timeoutCount≥2,takeoverRequired=true)后不再重派专家,由主 Agent 直接接手:只继续 takeoverBrief.remainingOutputs 与未满足的验收,专家已完成产物已登记为只读保护(landedRefs 并入 artifacts,只增不减),禁止丢弃、禁止删除或覆盖、禁止整步重跑。未获批准不得放宽,按判据层未达标处理(不 done、生成接替子任务只补缺口);接手仅发生在已批准延期的场景。生效开关(D-1 三重门运行态落点):判据 v2 仅对「DSH_WORKPLAN_CRITERION_V2=1 且 DSH_WORKPLAN_CRITERION_V2_SINCE(epoch 毫秒/ISO)起点之后新创建」的计划生效,由主 Agent 在部署+用户重启+复核通过后设置;未生效的在途/历史计划按 2.3.0 旧机制,不回溯、不改判。',
150
+ '7a. 专家预估沟通:timeNotice/【专家预估上报】到达后仍须把预估告知用户;预估变化可再次上报,但它只是协调信息,不会触发延期、超时计数、主 Agent 接手或时长判据。不得要求专家为超过任意分钟数申请批准,也不得因实际耗时高于预估否定其已完成且证据合格的工作。',
153
151
  '8. 出现「待指示」项(closure=escalated,左侧栏显示「待指示」并附问题摘录)时,必须在当轮处理:用 dsh_workplan_instruct 下发决定(投递到子会话并把该行恢复为执行中),或确认放弃后用 dsh_workplan_update 置 blocked。不要沉默略过,也不要把待指示当成普通失败——它是一条还没被回答的请示,会一直占着交付门禁。',
154
- '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 或中止执行。',
155
153
  /*
156
154
  * [1.11.0] T7:需求变更的重规划不能只靠模型自觉。
157
155
  *
@@ -211,6 +209,10 @@ export type WorkplanConfig = {
211
209
  plannerTimeoutMs?: number
212
210
  /** [2.1.6] 输出开始后的完全静默窗口(毫秒),亦可用 DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS。 */
213
211
  plannerIdleTimeoutMs?: number
212
+ /**
213
+ * 历史兼容字段。为免旧配置报错仍接受数值,但执行层不会据此创建任何
214
+ * 截止、空闲监控、整轮计时器或自动中止;新配置不应再使用。
215
+ */
214
216
  childTimeoutMs?: number
215
217
  idleTimeoutMs?: number
216
218
  totalTimeoutMs?: number
@@ -264,10 +266,8 @@ function createUpdateTool(runtime: any) {
264
266
  + '当主 Agent 核对子任务结果、发现完成不实或需要修正时使用。'
265
267
  + '把子任务标成 done 时,必须同时给出真实的 verification 与 acceptance(每项 result="pass"),'
266
268
  + '否则计划不会变成可交付状态(deliveryReady=false,present 会被拒绝)。'
267
- + '运行中的子任务需要更多时间时,传 extendMs(毫秒)即可协商放宽,不需要 force;放宽永远有界(累计 ≤ 初始协商上限 × 1),超出转新轮续跑或转 escalate 请主 Agent 裁决。'
268
- + '[SCv2-T4][Q1-B] 判据 v2 生效的计划:第一次超时不再自动放宽,须先向用户申请例外批准,批准后随 extendMs 携带 criterionApproval 留痕方可放宽;未批准不得放宽,按未完成转接替子任务。'
269
- + '[2.3.0] 延期成功后插件自动向执行中的专家投递最新执行时限与「保证质量、高效率执行」要求(回执 childNotified);'
270
- + '同一子任务第二次超时自动置 takeoverRequired,由主 Agent 接手未完成部分,已完成产物只读保护、禁止丢弃。'
269
+ + '部门负责人和全球顶尖专家执行没有时限,extendMs 已停用并返回 TIME_LIMITS_DISABLED;不要申请延期。'
270
+ + 'timeNotice 仅记录预估(仅供参考、非承诺),可用于告知预估变化,不影响执行或验收。'
271
271
  + '这些字段会写入会话日志,刷新/重启后仍然生效。',
272
272
  parameters: {
273
273
  type: 'object',
@@ -283,7 +283,7 @@ function createUpdateTool(runtime: any) {
283
283
  status: {
284
284
  type: 'string',
285
285
  enum: ['pending', 'in_progress', 'done', 'blocked'],
286
- description: '新的状态(普通改判必填;仅协商时限时可省略,改传 extendMs / timeNotice)。',
286
+ description: '新的状态(普通改判必填;仅记录开工预估时可省略并改传 timeNotice)。extendMs 仅为旧调用兼容,会返回 TIME_LIMITS_DISABLED。',
287
287
  },
288
288
  progress: {
289
289
  type: 'integer',
@@ -366,11 +366,7 @@ function createUpdateTool(runtime: any) {
366
366
  */
367
367
  extendMs: {
368
368
  type: 'integer',
369
- description: '延期毫秒数(正整数,仅主 Agent 可用):只推移本子任务的协商截止并重置计时,'
370
- + '不改状态判定;运行中可用,不需要 force。除非另传 status,否则可省略 status。'
371
- + '放宽永远有界:累计延期 ≤ 初始协商上限的一倍,超出会被拒绝并提示转新轮续跑或转 escalate 请主 Agent 裁决。'
372
- + '[2.3.0] 延期成功后插件自动告知专家最新执行时限(含保证质量、高效率执行要求);每次超时计一行内 timeoutCount,第二次触发 takeoverRequired(主 Agent 接手,已完成部分只读保护)。'
373
- + '[SCv2-T4][Q1-B] 判据 v2 生效的计划(部署+用户重启+复核通过后新创建):extendMs 必须同时携带 criterionApproval 用户批准留痕,否则拒绝(EXTEND_NEEDS_USER_APPROVAL);未生效的在途/历史计划按 2.3.0 旧机制,不需要批准。',
369
+ description: '旧版延期字段,仅为兼容保留。部门负责人和全球顶尖专家已无执行截止,传入正整数只返回 TIME_LIMITS_DISABLED,不改状态、不重设任何计时器,也不需要用户批准。请改用 timeNotice 更新纯信息预估。',
374
370
  },
375
371
  /*
376
372
  * [SCv2-T4][Q1-B/C06/C08] 用户例外批准留痕(criterionApproval → 行上
@@ -381,8 +377,7 @@ function createUpdateTool(runtime: any) {
381
377
  */
382
378
  criterionApproval: {
383
379
  type: 'object',
384
- description: '用户例外批准留痕(Q1-B 唯一例外通道):判据 v2 生效的计划上,extendMs 放宽或超判据改判 done 必须先取得用户明确批准并随调用携带本字段;无留痕=未批准。'
385
- + '批准必须在本次尝试结算前取得(事后追认无效)。留痕 5 项:任务 ID、批准原文/来源、批准时间(Asia/Shanghai 展示)、放宽后分钟数、适用范围。',
380
+ description: '旧版时间判据批准字段,仅为兼容历史调用与记录保留;当前没有时间判据、延期或超时例外审批,此字段不影响 done。完成仍必须通过真实证据、产物与质量验收。',
386
381
  properties: {
387
382
  approvedBy: { type: 'string', enum: ['user'], description: '批准主体:必须是 user(用户明确批准);主 Agent 自行批准无效。' },
388
383
  at: { type: 'number', description: '用户实际批准的时间(epoch 毫秒;展示按 Asia/Shanghai)。不得晚于当前时刻。' },
@@ -399,8 +394,7 @@ function createUpdateTool(runtime: any) {
399
394
  */
400
395
  timeNotice: {
401
396
  type: 'object',
402
- description: '专家开工预告(O-2a):{ declaredMinutes, reason },只记入协商流水,不改状态与判定。'
403
- + '[2.3.0] 落档后插件立即向主会话推送【专家预估上报】通知,提醒主 Agent 把该预期执行时间告知用户。',
397
+ description: '专家开工预估:{ declaredMinutes, reason },只记入信息流水并通知主 Agent 转告用户,仅供参考、非承诺;不生成截止、不触发延期或接管,也不改状态与完成判定。',
404
398
  properties: {
405
399
  declaredMinutes: { type: 'number', description: '预计完成本子任务的分钟数(仅供参考、非承诺)。' },
406
400
  reason: { type: 'string', description: '预告理由(可选)。' },
@@ -1285,6 +1279,153 @@ function createInstructTool(runtime: any) {
1285
1279
  }
1286
1280
  }
1287
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
+
1288
1429
  /**
1289
1430
  * [1.11.0] 跨部门需求的处置入口(用户 m00687)。
1290
1431
  *
@@ -1573,14 +1714,7 @@ function createDispatchTool(runtime: any) {
1573
1714
  )
1574
1715
  },
1575
1716
  },
1576
- /*
1577
- * The host tool timeout must outlive the plan budget, otherwise the model
1578
- * call is killed while the dispatcher is still legitimately working and the
1579
- * plan looks stuck. Derive it from the resolved limits.
1580
- */
1581
- timeoutMs: Number(runtime?.limits?.totalTimeoutMs ?? 0) > 0
1582
- ? Number(runtime.limits.totalTimeoutMs) + 20000
1583
- : 24 * 60 * 60 * 1000,
1717
+ // 不声明 timeoutMs:部门与专家执行没有工具层 24 小时或预算派生截止。
1584
1718
  async execute(args: any, exec: any) {
1585
1719
  const parsed = asObject(args) ?? {}
1586
1720
  return runtime.dispatchTool(exec.agent, parsed, exec.signal)
@@ -1589,11 +1723,12 @@ function createDispatchTool(runtime: any) {
1589
1723
  }
1590
1724
 
1591
1725
  /*
1592
- * Read the limits from the environment when the config does not set them.
1726
+ * [3.0.1] Legacy limit readers.
1593
1727
  *
1594
- * The plugin used to hard-code a 300 s child ceiling with no way to raise it
1595
- * short of editing the source, so any machine with slower subagents hit the
1596
- * 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.
1597
1732
  */
1598
1733
  /**
1599
1734
  * [1.10.4] 布尔开关:配置项优先,其次环境变量。
@@ -1672,10 +1807,12 @@ export function toolGuardReason(
1672
1807
  exec: any,
1673
1808
  runtime: { planModeActive(session: any): boolean; presentDenialReason(agent: any): string | undefined },
1674
1809
  ) {
1675
- if (exec?.name === 'dsh_workplan_dispatch') {
1810
+ if (exec?.name === 'dsh_workplan_dispatch' || exec?.name === 'dsh_workplan_release') {
1676
1811
  const session = exec?.agent?.session
1677
1812
  if (session && runtime.planModeActive(session)) {
1678
- 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。'
1679
1816
  }
1680
1817
  return undefined
1681
1818
  }
@@ -1774,6 +1911,9 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1774
1911
  */
1775
1912
  ctx.effect(() => ctx.tools.register(createHandoffTool(runtime)))
1776
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)))
1777
1917
 
1778
1918
  /*
1779
1919
  * Plan mode produces a plan for review, not department execution. Denying
@@ -1787,6 +1927,11 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1787
1927
  ctx.effect(() => ctx.tools.guard((exec: any) => toolGuardReason(exec, runtime)))
1788
1928
 
1789
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))
1790
1935
  /*
1791
1936
  * [1.8.7] 回合收尾前的闸门。官方 `agent/turn-stopping` 是 serial 事件、
1792
1937
  * 在边界提交前被 await;监听器 `agent.steer()` 后机器会重读 inbox,于是
@@ -1853,7 +1998,7 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
1853
1998
 
1854
1999
  export const meta = {
1855
2000
  name,
1856
- version: '3.0.0',
2001
+ version: '3.0.2',
1857
2002
  promptOrder: PROMPT_ORDER,
1858
2003
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
1859
2004
  }
package/src/llm-rules.ts CHANGED
@@ -195,7 +195,7 @@ export function buildLlmRulesBrief(info: LlmRulesBriefInfo = {}): string {
195
195
  lines.push('- 质量要求硬门槛(用户要求 6):每一条分派都必须带 qualityRequirements(至少 1 条、每条 ≤400 字符、最多 8 条),写清「成果必须达到什么要求、什么算合格、怎么算不合格」;缺它平台拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING)。任务书会把这块原文交给专家。')
196
196
  lines.push('- 专家汇报必须精简且是 JSON(用户要求 7):专家完成后在证据块里给出 report(keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组,每数组 ≤6 条、每条 ≤200 字符,禁止重复);你收到后逐条核对,缺项或重复会被格式门禁退回(F10)。')
197
197
  lines.push('- 你的汇总必须精简且是 JSON(用户要求 8/10/11):汇总本部门全部专家汇报后,在证据块里给出 departmentSummary(keyResults/keyInfo/importantInfo/sources 四个字符串数组,sources 必须覆盖全部已派发专家,禁止累赘重复);不合格会被退回(F11)。汇总完成后直接交回主 Agent,不需要另建文件。')
198
- lines.push('- 判据层与运行层(用户 2026-11-13 裁决):本行完成目标 ≤10 分钟,默认必须达成;再分配时须把本行全部叶子的开工预估之和控制在 ≤10 分钟,预估未报齐只显示部分和、不得视为达标;无下级直做时按该行单次尝试墙钟判定,不得自动豁免。确需超出 10 分钟,唯一合法例外=先向用户申请例外并留痕(无留痕=未批准),未获批准不得用 extendMs 放宽,应按未完成转接替子任务只补缺口。')
198
+ lines.push('- 执行时间与验收:你和每位全球顶尖专家均没有总时长、单次时长、空闲或回执硬截止。开工预估及其汇总只用于协调与告知,未报齐时如实显示部分和,但不构成分钟判据;不得以耗时、预估超额或未经时间批准为由拒绝 done,extendMs 已停用。完成只由真实结果、产物、结构化证据和质量验收决定;用户显式取消与真实错误仍然有效。')
199
199
  }
200
200
  return lines.join('\n')
201
201
  }
@@ -634,7 +634,7 @@ export function buildDelegateePrompt(input: {
634
634
  '执行要求(用户强制要求 5 原文口径):',
635
635
  '- 执行自己的任务必须先完成下方「三阶段工作法」的两轮深度思考(2.5.1 强制;2.5.2 执行前硬门禁):第一轮全面、全盘、深入梳理、研究、思考自己的任务;第二轮基于第一轮完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,理清具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(含依据 approachBasis);两轮产物经 phase-0 的 self_effort 一并提交 deepThink,未登记合格产物平台不会接续你进入正式执行;执行必须严格基于第二轮的方法、流程、步骤,全程少走弯路(先查历史教训、先验证再动手、不重复试错)。',
636
636
  '- 你的推理等级以自配为权威(分工表档仅建议):phase-0(low 档启动)唯一职责是经 dsh_workplan_delegate(action="self_effort") 提交自配档;phase-1 以登记生效的自配档全程应用(规划、执行、验证、复盘全生命周期),不得自行换档。',
637
- '- 开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice={ declaredMinutes: 正整数分钟, reason? } 上报部门负责人,未上报不接续(T6/D9 硬门禁:ESTIMATE_MISSING/ESTIMATE_INVALID);你必须自己预估时间,汇报给对应负责人后,才可以重试或继续执行。你的预估会累加到部门行的 ≤10 分钟判据目标:单项预估要真实,不要为凑数压低,也不要无理由放大;部门行达标须同时满足事前预估之和 ≤10 分钟与事后单次尝试墙钟 ≤10 分钟。',
637
+ '- 开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice={ declaredMinutes: 正整数分钟, reason? } 上报部门负责人,未上报不接续(T6/D9 硬门禁:ESTIMATE_MISSING/ESTIMATE_INVALID);该上报只是协调信息,必须如实预估。你和部门负责人执行任务均没有总时长、单次时长、空闲或回执硬截止;预估或实际耗时不会触发延期、超时接手,也不影响 done 验收。',
638
638
  '- 必须在确保自身任务完成品质非常高的前提下,完美、超高效率地执行;严禁低效执行与浪费 token。',
639
639
  '- 你是第三层叶子执行者:不得派生任何第四层 Agent/子会话;无法完成时在结论首行写 BLOCKED: 原因 并说明缺什么,不要空转。',
640
640
  '- 遇阻上报通道:遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/需要负责人决定方向)时,第一动作是调用 dsh_workplan_escalate({ "question": "需要负责人回答的单个问题", "options": ["可选方向"], "needs": ["需要谁提供什么"] })——请示会经 delegate 登记落到你所属部门行的第三层台账(待指示),由部门负责人用 dsh_workplan_instruct 答复你;调用成功后停止推进、只做只读核对,不要自行选定一个选项继续。',