dsh-workplan 3.0.9 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/runtime.js CHANGED
@@ -52,6 +52,10 @@ import { phaseGateFromErrors, phaseSummaryLine, sanitizeStartPhaseEvidence, STAR
52
52
  import { lessonStats, rankLessons, readLessons, recordLesson, renderLessonsBrief, resolveLessonsFile, } from './lessons.js';
53
53
  import { computeMappingDigest, verifyMappingDigest } from './supersede-digest.js';
54
54
  import { supersedePlanRecord } from './supersede.js';
55
+ // [3.1.0] 人数上限单一真源(caps.ts):报错文案与门禁同源。
56
+ import { MAX_COMPLEX_DELEGATE_MEMBERS } from './caps.js';
57
+ // [3.1.0] 排队等待上限环境变量化(默认 10 分钟不变)+规划器并发预算环境变量化。
58
+ import { envPositiveInt } from './caps.js';
55
59
  import { createProgressWatchdog, describeError } from './watchdog.js';
56
60
  import { AUTO_RESUME_DEFAULTS, autoResumeAttemptCap, decideAutoResume, liveResumeCounts } from './auto-resume.js';
57
61
  /*
@@ -248,8 +252,12 @@ export function describeSubagentActivationError(error, context) {
248
252
  * 多个等待者共享一个模块级冷却时间,避免同一毫秒一起撞门(惊群)。
249
253
  * 这不是“精确信号量”(宿主没有暴露当前活跃数),而是“有界排队退避”:
250
254
  * 空位一出现,等待者按退避节奏自然补位。
255
+ *
256
+ * [3.1.0] 等待上限可用 DSH_WORKPLAN_ACTIVATION_QUEUE_MAX_WAIT_MS 覆盖
257
+ * (默认 10 分钟不变);新增 onWait 回调:每次退避决策后通知调用方,
258
+ * 供派发循环向用户暴露「排队中」状态(排队可见化)。
251
259
  */
252
- export const ACTIVATION_QUEUE_MAX_WAIT_MS = 10 * 60 * 1000;
260
+ export const ACTIVATION_QUEUE_MAX_WAIT_MS = envPositiveInt('DSH_WORKPLAN_ACTIVATION_QUEUE_MAX_WAIT_MS', 10 * 60 * 1000);
253
261
  const ACTIVATION_QUEUE_BASE_DELAY_MS = 1000;
254
262
  const ACTIVATION_QUEUE_MAX_DELAY_MS = 15000;
255
263
  let activationQueueCooldownUntil = 0;
@@ -258,7 +266,7 @@ export function isActivationLimitError(error) {
258
266
  return true;
259
267
  return /limit reached/i.test(String(error?.message ?? error ?? ''));
260
268
  }
261
- export async function startActivationQueued(start, signal, context) {
269
+ export async function startActivationQueued(start, signal, context, onWait) {
262
270
  const beganAt = Date.now();
263
271
  let waits = 0;
264
272
  for (;;) {
@@ -280,6 +288,13 @@ export async function startActivationQueued(start, signal, context) {
280
288
  // 全局冷却只增不减:所有等待者共用同一个“下一次可以再试”的时刻。
281
289
  activationQueueCooldownUntil = Math.max(activationQueueCooldownUntil, now + backoff);
282
290
  const delay = Math.max(250, activationQueueCooldownUntil - now);
291
+ // [3.1.0] 排队可见化:退避决策通知调用方(派发循环据此发用户可见通知)。
292
+ if (onWait) {
293
+ try {
294
+ onWait({ waits, elapsedMs: Date.now() - beganAt });
295
+ }
296
+ catch { /* 通知回调失败不影响排队 */ }
297
+ }
283
298
  await sleepAbortable(signal, delay + Math.floor(Math.random() * 250));
284
299
  if (signal?.aborted)
285
300
  throw new PlanError('排队等待子代理空位时被取消', 'ABORTED');
@@ -9023,7 +9038,7 @@ export function createWorkplanRuntime(ctx, options = {}) {
9023
9038
  ok: false,
9024
9039
  code: 'MISSING_CONSOLIDATION',
9025
9040
  subtaskId,
9026
- error: 'review 必须携带 consolidation 分工表:{ assignments[{member, role:"expert", task, qualityRequirements[], reasoningEffort}] },并随附 startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }——五步第 1/2/3 步开工证据(第一步任务梳理;第二步基于第一步全部结果研究资源、工具与具体实施方案;第三步把资源与工具真正备齐并给出就绪证据)+ 分工表(至少 1 名、最多 12 名本部门全球顶尖专家;组员角色已取消;每项任务必须极简并附质量要求)。',
9041
+ error: `review 必须携带 consolidation 分工表:{ assignments[{member, role:"expert", task, qualityRequirements[], reasoningEffort}] },并随附 startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }——五步第 1/2/3 步开工证据(第一步任务梳理;第二步基于第一步全部结果研究资源、工具与具体实施方案;第三步把资源与工具真正备齐并给出就绪证据)+ 分工表(至少 1 名、最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 名本部门全球顶尖专家;组员角色已取消;每项任务必须极简并附质量要求)。`,
9027
9042
  };
9028
9043
  }
9029
9044
  // [3.0.8] 负责人 review 开工闸:与 direct/dispatch/self_effort 同一
@@ -9139,6 +9154,10 @@ export function createWorkplanRuntime(ctx, options = {}) {
9139
9154
  ? parentSession.header.cwd
9140
9155
  : undefined);
9141
9156
  const delegates = [];
9157
+ // [3.1.0] 排队可见化:派发期间每次「首次退避」记一条用户可见通知,循环结束
9158
+ // 后统一投递(不在工具执行中途重入会话事件流);每成员至多一条,防刷屏。
9159
+ const queueNotices = [];
9160
+ let skippedDone = 0;
9142
9161
  /*
9143
9162
  * [2.5.0][R4] 重试/续跑不丢已完成部分(第三层落点):重派时 row.delegates
9144
9163
  * 仍是上一次尝试的台账——为每位下级附上次状态/失败原因/已回报结论与已核实
@@ -9150,6 +9169,17 @@ export function createWorkplanRuntime(ctx, options = {}) {
9150
9169
  // 读取(consolidation 不再携带两轮思考产物)。
9151
9170
  const consolidationApproach = Array.isArray(row?.startPhases?.planning?.approach) ? row.startPhases.planning.approach : [];
9152
9171
  for (const assignment of delegationPlan.members) {
9172
+ const prior = priorDelegates.find((item) => item?.member === assignment.member) ?? null;
9173
+ /*
9174
+ * [3.1.0] 重派跳过已完成成员:done 结论已经过 F10 汇报核验,是已交付的
9175
+ * 有效成果;旧实现对分工表成员无条件重新拉起,已完成专家被重复派活
9176
+ * (浪费 token,还可能覆盖已验收产物)。跳过激活、原样保留台账条目。
9177
+ */
9178
+ if (prior?.status === 'done') {
9179
+ delegates.push(prior);
9180
+ skippedDone += 1;
9181
+ continue;
9182
+ }
9153
9183
  const rulesBrief = buildLlmRulesBrief({
9154
9184
  model,
9155
9185
  effort: assignment.effort,
@@ -9159,7 +9189,6 @@ export function createWorkplanRuntime(ctx, options = {}) {
9159
9189
  memberName: assignment.member,
9160
9190
  memberRole: assignment.role,
9161
9191
  });
9162
- const prior = priorDelegates.find((item) => item?.member === assignment.member) ?? null;
9163
9192
  const retryBrief = prior
9164
9193
  ? buildDelegateRetryBrief(prior, probeDelegateLandedArtifacts(cwd, assignment.member), consolidationApproach)
9165
9194
  : '';
@@ -9210,6 +9239,10 @@ export function createWorkplanRuntime(ctx, options = {}) {
9210
9239
  let childId = null;
9211
9240
  let memberStatus = 'running';
9212
9241
  let memberError = null;
9242
+ // [3.1.0] 排队计量:只有真的发生退避等待才记录 queuedMs(不把正常激活
9243
+ // 延迟误标成排队)。
9244
+ let memberQueued = false;
9245
+ const activationBeganAt = Date.now();
9213
9246
  try {
9214
9247
  // [3.0.1][P1a] 宿主 subagent.maxDepth < 2 时一次性告警(scope=计划根会话)。
9215
9248
  notifyDepthOverrideConflict(ctx, typeof parentSession?.header?.parentSession === 'string' ? parentSession.header.parentSession : (typeof parentId === 'string' ? parentId : null));
@@ -9231,7 +9264,14 @@ export function createWorkplanRuntime(ctx, options = {}) {
9231
9264
  maxDepth: 2,
9232
9265
  signal,
9233
9266
  delivery: 'caller',
9234
- }), signal, `派发成员 ${assignment.member}(${subtaskId})`);
9267
+ }), signal, `派发成员 ${assignment.member}(${subtaskId})`, (info) => {
9268
+ // [3.1.0] 排队可见化:首次退避时记录一条用户可见通知(循环结束后
9269
+ // 统一投递,不在工具执行中途重入会话事件流);按成员去重,防刷屏。
9270
+ memberQueued = true;
9271
+ if (queueNotices.some((line) => line.includes(`成员 ${assignment.member}(`)))
9272
+ return;
9273
+ queueNotices.push(`【排队中】成员 ${assignment.member}(${subtaskId}):子代理并发空位已满,已等待约 ${Math.round(info.elapsedMs / 1000)} 秒。这不是失败——空位一出现就会自动开始;长时间无进展可在「设置 → 子代理」调大 subagent.maxActiveSubagents,或设 DSH_WORKPLAN_ACTIVATION_QUEUE_MAX_WAIT_MS 调大排队等待上限。`);
9274
+ });
9235
9275
  childId = typeof activation?.childId === 'string' ? activation.childId : null;
9236
9276
  if (activation && typeof activation.result?.then === 'function') {
9237
9277
  const settledChildId = childId;
@@ -9301,8 +9341,18 @@ export function createWorkplanRuntime(ctx, options = {}) {
9301
9341
  error: memberError,
9302
9342
  startedAt: Date.now(),
9303
9343
  finishedAt: null,
9344
+ // [3.1.0] 排队留痕:status=queued 期间实际等待毫秒数,供看板/复盘展示。
9345
+ ...(memberQueued ? { queuedMs: Date.now() - activationBeganAt } : {}),
9304
9346
  });
9305
9347
  }
9348
+ // [3.1.0] 排队可见化:派发期间发生过的排队等待,统一向根会话投递用户可见
9349
+ // 通知(每成员一条);投递失败不影响派发结果。
9350
+ for (const line of queueNotices) {
9351
+ try {
9352
+ appendUserMessage(parentSession, makeUserMessage(line, { kind: 'workplan', form: 'notice', summary: line.slice(0, 80) }));
9353
+ }
9354
+ catch { /* 通知投递失败不影响派发结果 */ }
9355
+ }
9306
9356
  // [2.5.4][T3R1] 分派门禁放行留痕(A3):并入台账 persist,同一动作不二次
9307
9357
  // persist(避免 revision 竞争);gateAudit 经 applyStatus 消毒 + durable 回放。
9308
9358
  const written = persist({
@@ -9320,7 +9370,8 @@ export function createWorkplanRuntime(ctx, options = {}) {
9320
9370
  taskEffort: delegationPlan.taskEffort,
9321
9371
  effortOverride: written?.effortOverride ?? row.effortOverride ?? null,
9322
9372
  ...(rejected.length ? { rejected: rejected.map((item) => ({ member: item.member, error: item.error })) } : {}),
9323
- hint: '第三层已派发(一层下级、叶子层,第四层会被硬拒)。每位全球顶尖专家的完成结论会送回本会话(delivery=caller);收齐后由你汇总核验,再写最终结果块。用 action="status" 查看进度。成员遇阻会经 dsh_workplan_escalate 在你这里落「待指示」(delegates[].closure=escalated):必须当轮用 dsh_workplan_instruct(subtaskId=本部门行 ID,多个成员同时请示时加 member)答复,投递成功后该成员恢复执行。3.0.5 硬规则:任何成员待指示期间,review/dispatch/direct 一律拒绝改派,必须由原成员继续执行。',
9373
+ ...(skippedDone ? { skippedDone } : {}),
9374
+ hint: '第三层已派发(一层下级、叶子层,第四层会被硬拒)。每位全球顶尖专家的完成结论会送回本会话(delivery=caller);收齐后由你汇总核验,再写最终结果块。用 action="status" 查看进度。成员遇阻会经 dsh_workplan_escalate 在你这里落「待指示」(delegates[].closure=escalated):必须当轮用 dsh_workplan_instruct(subtaskId=本部门行 ID,多个成员同时请示时加 member)答复,投递成功后该成员恢复执行。3.0.5 硬规则:任何成员待指示期间,review/dispatch/direct 一律拒绝改派,必须由原成员继续执行。' + (skippedDone ? ` 本次重派跳过 ${skippedDone} 名已完成成员(成果已保留,未重复拉起)。` : ''),
9324
9375
  };
9325
9376
  }
9326
9377
  async function dispatchTool(agent, args, signal) {
@@ -11540,7 +11591,10 @@ async function maybePlan(ctx, state, payload, downstream, options) {
11540
11591
  budget: {
11541
11592
  totalMinutes: 0,
11542
11593
  childMinutes: 0,
11543
- concurrency: MAX_CONCURRENT,
11594
+ // [3.1.0] 规划器并发预算环境变量化:宿主不向插件暴露 maxActiveSubagents,
11595
+ // 故以 DSH_WORKPLAN_PLANNER_CONCURRENCY 显式可配(默认不变 = MAX_CONCURRENT)。
11596
+ // 调大宿主 subagent.maxActiveSubagents 后,同步调大此值让规划器按真实并行度排预算。
11597
+ concurrency: envPositiveInt('DSH_WORKPLAN_PLANNER_CONCURRENCY', MAX_CONCURRENT),
11544
11598
  maxResumes: Number(options?.limits?.maxResumes ?? MAX_PLAN_RESUMES),
11545
11599
  },
11546
11600
  });
@@ -227,13 +227,16 @@ export function checkAtomicAssignment(task, qualityRequirements) {
227
227
  /** 单个汇报数组的条数上限:精简的量化口径。 */
228
228
  export const MAX_REPORT_ITEMS = 6;
229
229
  /**
230
- * [3.0.6][第 3 批③] sources(部门汇总「覆盖的专家汇报」)专用上限。
231
- * 死锁修复:复杂任务按用户裁决 D1/D2 强制 ≥8 名专家(上限 12),而 sources
230
+ * [3.0.6][第 3 批③][3.1.0 改数] sources(部门汇总「覆盖的专家汇报」)专用上限。
231
+ * 死锁修复史:复杂任务按用户裁决 D1/D2 强制 ≥8 名专家(上限原 12),而 sources
232
232
  * 必须覆盖全部已派发专家——若与其他数组共用 6 条上限,7–12 人的部门永远
233
233
  * 交不出合法汇总(覆盖诚实要求 vs 精简上限互相矛盾)。覆盖是硬要求,
234
- * 故 sources 单独放宽到 16(≥ 复杂任务 12 人上限 + 余量),其余数组仍 6 条。
234
+ * 故 sources 单独放宽;3.1.0 专家上限 12→25,本条数同步 16→30(25 + 余量 5)。
235
+ * 单一真源在 caps.ts(可用 DSH_WORKPLAN_MAX_SOURCES_ITEMS 覆盖),此处 re-export
236
+ * 保持既有 import 路径不变。
235
237
  */
236
- export const MAX_SOURCES_ITEMS = 16;
238
+ import { MAX_SOURCES_ITEMS } from './caps.js';
239
+ export { MAX_SOURCES_ITEMS };
237
240
  /** 单条汇报文本的字符上限。 */
238
241
  export const MAX_REPORT_ITEM_CHARS = 200;
239
242
  /** 专家汇报的四个必填字段(与用户要求 7 的四个方向一一对应)。 */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-workplan",
3
- "version": "3.0.9",
3
+ "version": "3.1.0",
4
4
  "description": "Automatic task decomposition, real department subagents, and a responsive workplan dashboard for DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/src/caps.ts ADDED
@@ -0,0 +1,49 @@
1
+ /**
2
+ * [3.1.0] 数量上限的单一真源( caps = capability caps )。
3
+ *
4
+ * 为什么要有这个模块:
5
+ * - 复杂任务分工表人数上限(12 → 25,用户裁决 2026-11-19)与部门汇总 sources
6
+ * 上限(16 → 30)此前分散硬编码在 llm-rules / v3-contract / plan.ts 的存档
7
+ * 消毒里,历史上发生过「改一处漏一处」:3.0.6 的部门汇总死锁(人数 12 但
8
+ * sources 卡 6)、以及「写 25 读 12」的存读不对称。收口到本模块后,
9
+ * 所有消费方 import 同一常量,物理上不可能再分叉。
10
+ * - llm-rules.ts 依赖 plan.ts(历史既有),plan.ts 不能反向 import llm-rules,
11
+ * 因此把上限放在这个零依赖叶子模块里,两边都能安全引用,无循环风险。
12
+ *
13
+ * 环境变量(全部可选,默认即用户裁决值,不设则行为与 3.1.0 默认完全一致):
14
+ * - DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS:复杂任务专家人数上限,默认 25
15
+ * (仍强制 ≥ MIN_COMPLEX_DELEGATE_MEMBERS=8,防止把上限配得比下限低)。
16
+ * - DSH_WORKPLAN_MAX_SOURCES_ITEMS:部门汇总 sources 条数上限,默认 30
17
+ * (必须 ≥ 专家人数上限,否则「逐人覆盖」硬要求与条数上限互相矛盾——
18
+ * 3.0.6 死锁的复发条件,故默认值取 25+余量)。
19
+ */
20
+
21
+ /** 读取正整数环境变量;缺失/非正整数/NaN 一律回落默认值(fail-closed 到裁决值)。 */
22
+ export function envPositiveInt(name: string, fallback: number): number {
23
+ const raw = process.env[name]
24
+ if (typeof raw !== 'string' || raw.trim() === '') return fallback
25
+ const n = Number(raw.trim())
26
+ return Number.isInteger(n) && n > 0 ? n : fallback
27
+ }
28
+
29
+ /**
30
+ * 复杂任务(声明档 medium/high/xhigh/max)分工表人数下限:用户裁决 D1/D2,
31
+ * 固定 8,不开放环境变量(裁决明示「少于 8 人硬性阻断」)。
32
+ */
33
+ export const MIN_COMPLEX_DELEGATE_MEMBERS = 8
34
+
35
+ /**
36
+ * 复杂任务分工表人数上限:用户裁决 D2 原为 12,2026-11-19 用户裁决扩大到 25
37
+ * (部门负责人数量不动;只放宽部门内全球顶尖专家)。仍强制 ≥ 下限 8。
38
+ */
39
+ export const MAX_COMPLEX_DELEGATE_MEMBERS = Math.max(
40
+ MIN_COMPLEX_DELEGATE_MEMBERS,
41
+ envPositiveInt('DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS', 25),
42
+ )
43
+
44
+ /**
45
+ * 部门汇总 sources(「覆盖的专家汇报」)条数上限:3.0.6 为修复 12 人死锁放宽到
46
+ * 16;3.1.0 随专家上限 25 同步放宽到 30(25 + 非专家来源余量 5)。覆盖是诚实
47
+ * 硬要求——本条数必须 ≥ 专家人数上限,否则部门永远交不出合法汇总(死锁)。
48
+ */
49
+ export const MAX_SOURCES_ITEMS = envPositiveInt('DSH_WORKPLAN_MAX_SOURCES_ITEMS', 30)
@@ -21,6 +21,7 @@
21
21
  import {
22
22
  checkDepartmentSummary,
23
23
  checkExpertReport,
24
+ MAX_SOURCES_ITEMS,
24
25
  renderDepartmentSummarySpec,
25
26
  renderExpertReportSpec,
26
27
  } from './v3-contract.js'
@@ -98,7 +99,7 @@ export const COMM_FORMAT_SPEC = Object.freeze({
98
99
  description: '专家(第三层执行者)结果必须包含 report 对象,只允许 keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组字段:keyResults / leadRequirements 各至少 1 条非空内容,keyInfo / importantInfo 可为空数组但字段必须存在,每数组最多 6 条、每条最多 200 字符,内部与跨字段不得出现重复表述',
99
100
  rationale: '用户要求 7:专家成果必须非常精简地汇报给部门负责人,只要关键信息、关键成果、重要信息和负责人要求的东西,并以 JSON mode 结构化输出' }),
100
101
  Object.freeze({ id: 'F11', category: 'report',
101
- description: '部门负责人结果必须包含 departmentSummary 对象,只允许 keyResults/keyInfo/importantInfo/sources 四个字符串数组字段,keyResults 至少 1 条非空,keyResults/keyInfo/importantInfo 每项最多 6 条、每条最多 200 字符;sources 最多 16 条且必须逐人覆盖本部门全部已派发专家,内部与跨字段不得出现重复表述',
102
+ description: `部门负责人结果必须包含 departmentSummary 对象,只允许 keyResults/keyInfo/importantInfo/sources 四个字符串数组字段,keyResults 至少 1 条非空,keyResults/keyInfo/importantInfo 每项最多 6 条、每条最多 200 字符;sources 最多 ${MAX_SOURCES_ITEMS} 条且必须逐人覆盖本部门全部已派发专家,内部与跨字段不得出现重复表述`,
102
103
  rationale: '用户要求 8/10/11:部门负责人必须全面汇总全部专家汇报,汇总报告必须精简、禁止累赘重复,并以 JSON mode 结构化直接交回主 Agent' }),
103
104
  ]),
104
105
  /*
package/src/host.ts CHANGED
@@ -23,6 +23,8 @@ import {
23
23
  updateToolOutputSchema,
24
24
  } from './runtime.js'
25
25
  import { DEPARTMENT_IDS, isRecord, START_EVIDENCE_MIN_CHARS_BRIEF } from './plan.js'
26
+ // [3.1.0] 人数上限单一真源(caps.ts):工具说明书与门禁/消毒/提示词同源。
27
+ import { MAX_COMPLEX_DELEGATE_MEMBERS, MIN_COMPLEX_DELEGATE_MEMBERS } from './caps.js'
26
28
  import { autoResumeEnabledFrom } from './auto-resume.js'
27
29
  import { pruneJournal } from './dept-journal.js'
28
30
 
@@ -103,7 +105,7 @@ const PROMPT_SECTION = [
103
105
  '3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
104
106
  '3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
105
107
  '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)。',
106
- '3.0.9 版本(用户要求 13):本插件当前版本为 3.0.9。涉及版本号的对外表述一律写 3.0.9。',
108
+ '3.1.0 版本(用户要求 13):本插件当前版本为 3.1.0。涉及版本号的对外表述一律写 3.1.0。',
107
109
  /*
108
110
  * [3.0.8] 主 Agent 五步开工证据协议(取代 2.5.1 两轮深度思考,用户已批准):
109
111
  * 部门三层执行者已有开工/结算双门禁,主 Agent 自己也必须做到同一协议——
@@ -871,8 +873,8 @@ function createDelegateTool(runtime: any) {
871
873
  + '第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);'
872
874
  + '第三步把资源与工具真正备齐并给出就绪证据。'
873
875
  + '先 action="review" 提交第 1/2/3 步开工证据(startPhases)'
874
- // [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts 负责人任务书同源逐字一致)
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 人硬性阻断;'
876
+ // [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts 负责人任务书同源逐字一致;3.1.0 上限 25)
877
+ + `(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)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断;`
876
878
  + '并可用 consolidation.taskReasoningEffort 为整个任务配置整体推理等级,配置后本任务重试/续跑全程沿用;下级档位以成员 self_effort 自配为权威(分工表档仅建议)),'
877
879
  + '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家(部门组员角色已取消,只保留 expert;固定一层下级、叶子层,第四层一律被拒)。'
878
880
  + '分配必须更简单:每位专家只承担一个动作、一个主产物、一项可独立验收的工作(简单到像 1+1=2:单句、≤300 字符、不含并列词,且每条必须带至少 1 条 qualityRequirements 质量要求;不满足即拒绝派发)。'
@@ -950,8 +952,8 @@ function createDelegateTool(runtime: any) {
950
952
  },
951
953
  assignments: {
952
954
  type: 'array',
953
- // [3.0.0] 用户 2026-11-14 第 5/6/9 条:组员角色取消、任务极简、质量要求必填。
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 条可检查的质量要求);不满足即拒绝派发。',
955
+ // [3.0.0] 用户 2026-11-14 第 5/6/9 条:组员角色取消、任务极简、质量要求必填;3.1.0 上限随 caps.ts。
956
+ description: `分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(${START_EVIDENCE_MIN_CHARS_BRIEF};可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断,超过上限平台拒收(可精简名单或拆两轮派发,绝不静默丢人无痕)。每一条任务必须简单到像 1+1=2:一个动作、一个主产物、一项可独立验收(≤300 字符、单句、不含并列词),且必须带 qualityRequirements(至少 1 条可检查的质量要求);不满足即拒绝派发。`,
955
957
  items: {
956
958
  type: 'object',
957
959
  properties: {
@@ -2126,7 +2128,7 @@ export function apply(ctx: any, config: WorkplanConfig = {}) {
2126
2128
 
2127
2129
  export const meta = {
2128
2130
  name,
2129
- version: '3.0.9',
2131
+ version: '3.1.0',
2130
2132
  promptOrder: PROMPT_ORDER,
2131
2133
  routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
2132
2134
  }
package/src/llm-rules.ts CHANGED
@@ -43,6 +43,9 @@ import {
43
43
  renderExpertReportSpec,
44
44
  renderQualityRequirementsBlock,
45
45
  } from './v3-contract.js'
46
+ // [3.1.0] 数量上限单一真源(复杂任务专家人数 12→25):与 v3-contract 的 sources
47
+ // 上限、plan.ts 的存档消毒同一常量,杜绝「改一处漏一处」的写读不对称。
48
+ import { MAX_COMPLEX_DELEGATE_MEMBERS, MIN_COMPLEX_DELEGATE_MEMBERS } from './caps.js'
46
49
 
47
50
  export {
48
51
  allowedEffortsForModel,
@@ -178,8 +181,9 @@ export function buildLlmRulesBrief(info: LlmRulesBriefInfo = {}): string {
178
181
  if (info.tier === 'delegate') {
179
182
  lines.push(`- 你是部门第三层执行者(本部门相关领域全球顶尖专家${info.memberName ? `:${info.memberName}` : ''})。执行自己的任务必须遵守五步工作法的前三步(3.0.8 单一框架):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果,研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);第三步把资源与工具真正备齐并给出就绪证据;然后进入第四步具体执行,全程少走弯路(先查历史教训、先验证再动手、不重复试错)。前三步证据经 phase-0(low 档启动)由 dsh_workplan_delegate(action="self_effort") 一并提交 startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } },未登记合格证据平台不会接续你进入正式执行。分工表给你的档位仅为建议:你必须在 phase-0 经 self_effort 按自己任务复杂度提交自配档(reasoningEffort+complexityRationale),平台登记后立即以自配档接续你执行正式任务;越界档会被钳制并留痕。开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice 上报部门负责人,未上报不接续(T6/D9 硬门禁)。必须确保自身任务完成品质非常高的前提下,完美、超高效率地执行。`)
180
183
  } else {
181
- // [2.5.4][T4] 人数口径同步(D1/D2):非复杂≤6;复杂(medium/high/xhigh/max)≥8 且 ≤12,少于 8 硬性阻断。
182
- lines.push('- 部门负责人(本任务书的直接接收者)强制流程(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内的再分配权限——执行自己的任务必须先完成五步前三步(第一步任务梳理;第二步基于第一步全部结果研究资源、工具与具体实施方案;第三步把资源与工具真正备齐并给出就绪证据),正式执行与再分配全程少走弯路(先查历史教训、先验证再动手、不重复试错),经 dsh_workplan_delegate(action="review") 一并提交分工表(assignments + taskReasoningEffort)与第 1/2/3 步证据(startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }),并在 consolidation.taskReasoningEffort 里按你接到任务的复杂度配置你自己的整体推理等级(先配置后开工:phase-0 以 low 启动,登记后平台立即以自配档接续本会话进入 phase-1,重试/续跑全程生效);第 1/2/3 步证据与分工表未提交前,dsh_workplan_delegate(action="dispatch") 会被平台拒绝(硬门禁)。梳理完成后必须把任务拆得更简单——每位下级只承担单一目标、单一主产物、可独立验收的一项工作——再合理分配给本部门多名相关领域全球顶尖专家(部门组员角色已按用户要求 9 取消,分工表只允许 role="expert",至少 1 名;low/未配置任务禁止下派——负责人亲自执行,第 1/2/3 步证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断);每位下级必须在 phase-0 经 dsh_workplan_delegate(action="self_effort") 按自己分到的单项任务复杂度自配推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),专家自配为权威(分工表 per-expert 档仅建议),平台登记后以自配档接续下级会话,全程应用;平台会按上述等级集合自动钳制越界档并留痕,等级在其任务全生命周期生效且不可被覆盖。第三层为叶子层:任何第四层派发一律被拒绝。')
184
+ // [2.5.4][T4][3.1.0] 人数口径同步(D1/D2):low/未配置禁派;复杂(medium/high/xhigh/max)
185
+ // ≥8 且 ≤25(上限随 caps.ts,环境变量可覆盖,提示词与门禁同源不漂移)。
186
+ lines.push(`- 部门负责人(本任务书的直接接收者)强制流程(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内的再分配权限——执行自己的任务必须先完成五步前三步(第一步任务梳理;第二步基于第一步全部结果研究资源、工具与具体实施方案;第三步把资源与工具真正备齐并给出就绪证据),正式执行与再分配全程少走弯路(先查历史教训、先验证再动手、不重复试错),经 dsh_workplan_delegate(action="review") 一并提交分工表(assignments + taskReasoningEffort)与第 1/2/3 步证据(startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } }),并在 consolidation.taskReasoningEffort 里按你接到任务的复杂度配置你自己的整体推理等级(先配置后开工:phase-0 以 low 启动,登记后平台立即以自配档接续本会话进入 phase-1,重试/续跑全程生效);第 1/2/3 步证据与分工表未提交前,dsh_workplan_delegate(action="dispatch") 会被平台拒绝(硬门禁)。梳理完成后必须把任务拆得更简单——每位下级只承担单一目标、单一主产物、可独立验收的一项工作——再合理分配给本部门多名相关领域全球顶尖专家(部门组员角色已按用户要求 9 取消,分工表只允许 role="expert",至少 1 名;low/未配置任务禁止下派——负责人亲自执行,第 1/2/3 步证据经 dsh_workplan_delegate(action="direct") 登记(${START_EVIDENCE_MIN_CHARS_BRIEF};可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断,超过上限平台拒收(可精简名单或拆两轮派发,绝不静默丢人无痕));每位下级必须在 phase-0 经 dsh_workplan_delegate(action="self_effort") 按自己分到的单项任务复杂度自配推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),专家自配为权威(分工表 per-expert 档仅建议),平台登记后以自配档接续下级会话,全程应用;平台会按上述等级集合自动钳制越界档并留痕,等级在其任务全生命周期生效且不可被覆盖。第三层为叶子层:任何第四层派发一律被拒绝。`)
183
187
  /*
184
188
  * [3.0.0] 用户 2026-11-14 第 3、5、6、7、8、10、11 条要求:负责人侧四条硬规则。
185
189
  * 与代码门禁同源(planDelegations 的 checkAtomicAssignment、comm-format 的
@@ -221,10 +225,13 @@ export interface ConsolidationInput {
221
225
  */
222
226
  taskReasoningEffort?: unknown
223
227
  /**
224
- * [2.5.5][T3] 平台写入的钳制前声明记忆(review 时的原始声明,由 runtime
225
- * 持久化、dispatch 读回),仅供 low 禁派闸消费,防非 qwen 系 medium 声明
226
- * 被钳制后 low 误杀;review 新输入不得携带(runtime 调用点剥离+host
227
- * schema additionalProperties:false 拒绝)。
228
+ * [2.5.5][T3][3.1.0 扩展] 平台写入的钳制前声明记忆(review 时的原始声明,由
229
+ * runtime 持久化、dispatch 读回)。消费方有两处且同源:low 禁派闸(防非 qwen
230
+ * 系 medium 被钳制后 low 误杀)与 complexTask 复杂判定([3.1.0] 治本:dispatch
231
+ * 复读若只看钳制后 taskReasoningEffort,已放行的 8–25 人名单会被回落成 cap=6
232
+ * 静默截断——旧实现注释自称「强制语义不破」,实际截断发生在分工表复读,矛盾)。
233
+ * review 新输入不得携带(runtime 调用点剥离+host schema additionalProperties:false
234
+ * 拒绝),否则 {taskReasoningEffort:'low', taskReasoningEffortDeclared:'max'} 可绕过禁派闸。
228
235
  */
229
236
  taskReasoningEffortDeclared?: unknown
230
237
  }
@@ -266,14 +273,13 @@ export interface DelegationPlan {
266
273
  }
267
274
 
268
275
  const MAX_DELEGATE_MEMBERS = 6
269
- /**
270
- * [2.5.4][T4] 用户决策 D1/D2:复杂任务(声明档 medium/high/xhigh/max)分派
271
- * 人数下限 8(expert+member 合计,少于 8 硬性阻断);上限放宽到 12
272
- * (12 为实现取值,D2 授权提高上限)。非复杂(low/未配置)保持 6 人上限
273
- * 与原有静默截断,旧行为零变化。
276
+ /*
277
+ * [3.1.0] 复杂人数下限 8 / 上限 25(原 12)已收口到 caps.ts(单一真源,含环境
278
+ * 变量覆盖 DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS)。D1/D2 语义不变:复杂任务
279
+ * (声明档 medium/high/xhigh/max)少于 8 人硬性阻断;low/未配置保持禁派
280
+ * (MAX_DELEGATE_MEMBERS=6 仅保留给历史/非法档路径,正常低档位在禁派闸已被拦)。
274
281
  */
275
- const MIN_COMPLEX_DELEGATE_MEMBERS = 8
276
- const MAX_COMPLEX_DELEGATE_MEMBERS = 12
282
+ // const MIN_COMPLEX_DELEGATE_MEMBERS / MAX_COMPLEX_DELEGATE_MEMBERS → ./caps.ts
277
283
  /** [2.5.4][T4] D1:除 low 外全部算复杂——medium/high/xhigh/max 均触发 ≥8 人门禁,xhigh 不豁免。 */
278
284
  const COMPLEX_DECLARED_EFFORTS: readonly string[] = Object.freeze(['medium', 'high', 'xhigh', 'max'])
279
285
 
@@ -318,20 +324,21 @@ export function planDelegations(input: {
318
324
  * 分工表与整体等级,拒因顺序不变。
319
325
  */
320
326
  /*
321
- * [2.5.4][T4] 复杂判定必须用「声明档」(钳制前):
322
- * declared = consolidation.taskReasoningEffort ?? input.taskEffortFallback。
323
- * 原因(D1):correctEffortForModel 在非 qwen 系会把 medium 钳到 low,
324
- * 若按钳制后档位判复杂会静默豁免 medium,违反「medium/high/xhigh/max 均触发」。
325
- * 这里只提前「原始声明档读取 + 复杂判定 + 上限选择」这一纯读取逻辑,
327
+ * [2.5.4][T4][3.1.0 治本] 复杂判定必须用「声明档」(钳制前),且优先消费平台
328
+ * 持久化的钳制前声明记忆 taskReasoningEffortDeclared:
329
+ * declared = taskReasoningEffortDeclared ?? taskReasoningEffort ?? taskEffortFallback。
330
+ *
331
+ * 原因(D1 + 3.1.0 实测缺陷):correctEffortForModel 在非 qwen 系会把 medium
332
+ * 钳到 low;review 通过后宿主把钳制后值写回 consolidation.taskReasoningEffort,
333
+ * dispatch 读回时若只看该字段,complexTask 会被误判成 false → memberCap 从
334
+ * 25 回落成 6 → review 放行的 8–25 人名单被静默截断(tests C1 用例实测复现:
335
+ * 8 人名单派发只剩 6 人)。旧注释自称「分工表已是 review 放行的 ≥8 人名单,
336
+ * 强制语义不破」——但截断恰恰发生在 dispatch 复读分工表时,注释与行为矛盾,
337
+ * 3.1.0 起按声明记忆判定,两入口完全一致。
338
+ *
326
339
  * TASK_EFFORT_INVALID 校验与其余各闸位置一律不动,既有拒因顺序完全保持。
327
- * 持久化边界(负责人补充说明 2):review 通过后宿主把钳制后值写回
328
- * row.consolidation.taskReasoningEffort 与 effortOverride,dispatch 读回的是
329
- * 钳制后声明——因此强制点在 review 入口(dispatch 必须先有合格 review,每个
330
- * 复杂声明都必然在 review 处按原始声明被 ≥8 校验);dispatch 复读为纵深复核,
331
- * 非 qwen+medium 的极端组合复读时虽看到钳制后的 low,但分工表已是 review 放行
332
- * 的 ≥8 人名单,强制语义不破。qwen 系钳制不改变复杂性分类,两入口完全一致。
333
340
  */
334
- const declaredEffort = consolidation.taskReasoningEffort ?? input.taskEffortFallback
341
+ const declaredEffort = consolidation.taskReasoningEffortDeclared ?? consolidation.taskReasoningEffort ?? input.taskEffortFallback
335
342
  const complexTask = typeof declaredEffort === 'string' && COMPLEX_DECLARED_EFFORTS.includes(declaredEffort)
336
343
  /*
337
344
  * [2.5.5][T3] 用户裁决 D1/D2/D3:low(含未配置视同 low)任务禁止第三层下派。
@@ -353,7 +360,12 @@ export function planDelegations(input: {
353
360
  }
354
361
  }
355
362
  const memberCap = complexTask ? MAX_COMPLEX_DELEGATE_MEMBERS : MAX_DELEGATE_MEMBERS
356
- const assignments = (Array.isArray(consolidation.assignments) ? consolidation.assignments : []).slice(0, memberCap)
363
+ /*
364
+ * [3.1.0] 不再静默截断:完整分工表进入校验链,超上限由下方 DELEGATE_HEADCOUNT_MAX
365
+ * 闸明确拒收(可照做的精简/拆两轮指引)。旧实现在这里 slice(0, memberCap),
366
+ * 交 26 人只派前 25 人、丢 1 人无痕——用户裁决废止该行为。
367
+ */
368
+ const assignments = Array.isArray(consolidation.assignments) ? consolidation.assignments : []
357
369
  if (assignments.length === 0) {
358
370
  return { ...empty, code: 'DELEGATE_CONSOLIDATION_INCOMPLETE', error: '梳理产物不完整:分工表 assignments 至少 1 条(member/role/task/reasoningEffort 四项齐全)。' }
359
371
  }
@@ -459,13 +471,29 @@ export function planDelegations(input: {
459
471
  * 分工表闸重复。下方直接是复杂任务人数下限闸,拒因顺序不变。
460
472
  */
461
473
  /*
462
- * [2.5.4][T4] 用户决策 D1/D2 人数下限硬门禁(新增的最后一道闸):
474
+ * [3.1.0] 分工表人数上限硬门禁(用户裁决:超限拒收,不留「丢人无痕」):
475
+ * 完整名单(经上方逐条校验合法后)超过本任务上限即整单拒绝,并给出两条
476
+ * 可照做的出路(精简 / 拆两轮)。位置在 MIN 闸之前:26 人先收到「超上限」
477
+ * 而非「少于 8 人」这类误导性拒因;7 人则自然落到下方 MIN 闸。
478
+ */
479
+ if (members.length > memberCap) {
480
+ return {
481
+ ok: false,
482
+ code: 'DELEGATE_HEADCOUNT_MAX',
483
+ members: [],
484
+ clamped: [],
485
+ taskEffort: null,
486
+ taskEffortClamped: null,
487
+ error: `分工表当前 ${members.length} 人,超过${complexTask ? '复杂任务' : '本任务'}上限 ${memberCap} 人(平台 3.1.0 起不再静默截断,不留「丢人无痕」)。两条可照做的出路:1) 精简名单——把可合并/最弱的几项砍掉或合并成一项,重新 review;2) 拆成两轮——第一轮先派最关键的 ≤${memberCap} 人,收齐后用 dsh_workplan_delegate(action="review"/"dispatch") 补派剩余部分。`,
488
+ }
489
+ }
490
+ /*
491
+ * [2.5.4][T4] 用户决策 D1/D2 人数下限硬门禁:
463
492
  * 复杂任务(声明档 medium/high/xhigh/max)expert+member 合计必须 ≥8 人,
464
- * 不足直接阻断分派。人数按截断后实际分派数计(复杂上限 12≥8,截断前后
465
- * 判定等价);角色配比校验(ROLE_MIX_REQUIRED)在本闸之前,保持不变。
466
- * 放在拒因链最后:既有 8 道拒因顺序完全不变。
493
+ * 不足直接阻断分派。人数按完整分工表计(3.1.0 起无截断,上限闸已在上方)。
494
+ * 放在拒因链最后:既有拒因顺序完全不变。
467
495
  */
468
- if (complexTask && assignments.length < MIN_COMPLEX_DELEGATE_MEMBERS) {
496
+ if (complexTask && members.length < MIN_COMPLEX_DELEGATE_MEMBERS) {
469
497
  return {
470
498
  ok: false,
471
499
  code: 'DELEGATE_HEADCOUNT_MIN',
@@ -473,7 +501,7 @@ export function planDelegations(input: {
473
501
  clamped: [],
474
502
  taskEffort: null,
475
503
  taskEffortClamped: null,
476
- error: `复杂任务(声明档 ${String(declaredEffort)})按用户决策 D1/D2 须合计 ≥8 人(组员角色已取消,8 人全部为专家),当前 ${assignments.length} 人;请把任务拆得更简单(单一目标/单一主产物/可独立验收,简单到 1+1=2)并扩充分工表后重新 review/dispatch。`,
504
+ error: `复杂任务(声明档 ${String(declaredEffort)})按用户决策 D1/D2 须合计 ≥${MIN_COMPLEX_DELEGATE_MEMBERS} 人(组员角色已取消,全部为专家),当前 ${members.length} 人;请把任务拆得更简单(单一目标/单一主产物/可独立验收,简单到 1+1=2)并扩充分工表后重新 review/dispatch。`,
477
505
  }
478
506
  }
479
507
  /*
package/src/plan.ts CHANGED
@@ -18,6 +18,9 @@ import {
18
18
  sanitizeCriterionException,
19
19
  } from './criterion.js'
20
20
  import { MAX_TASK_ANCHOR_CHARS } from './understanding.js'
21
+ // [3.1.0] 复杂任务专家人数上限单一真源(caps.ts):存档消毒、门禁、提示词同源,
22
+ // 杜绝「写 25 读 12」的存读不对称(3.0.6 死锁同类事故的预防)。
23
+ import { MAX_COMPLEX_DELEGATE_MEMBERS, MIN_COMPLEX_DELEGATE_MEMBERS } from './caps.js'
21
24
  import { isMappingDigest, verifyMappingDigest } from './supersede-digest.js'
22
25
  import { checkStartEvidenceCarryover, fiveStepPromptLines, MAX_PHASE_ITEM_CHARS, MAX_PHASE_LIST_ITEMS, MAX_PHASE_TOTAL_CHARS, phaseSummaryLine, sanitizeStartPhaseEvidence, START_EVIDENCE_MIN_CHARS_BRIEF, validateFiveStepEvidence, validateStartPhaseEvidence } from './five-step.js'
23
26
  // [修复] 七项字数下限简报(five-step.ts 单一事实源)转发给 host.ts 等消费方。
@@ -2792,6 +2795,12 @@ export function buildDegradedMessage(options: any) {
2792
2795
  '自动任务分解失败,部门 Agent 未启动。',
2793
2796
  '请先向用户说明失败原因,并询问是否重试;在用户确认前不要开始执行任务。',
2794
2797
  '',
2798
+ '可行动方向(按可能性排序,供你向用户解释并征求选择):',
2799
+ `1) 任务太大:拆成两轮——第一轮先交付核心成果,第二轮再做扩展与打磨。每轮子任务更少、规划更稳(当前规划上限:${MAX_STAGES} 个阶段、${MAX_SUBTASKS} 个子任务)。`,
2800
+ `2) 部门分工人数超限:复杂任务专家上限 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人(可用环境变量 DSH_WORKPLAN_MAX_COMPLEX_DELEGATE_MEMBERS 调整,默认 25);超限会被拒收并提示精简名单或拆两轮派发,不会静默丢人无痕。`,
2801
+ '3) 子代理并发排队超时:在「设置 → 子代理」调大 subagent.maxActiveSubagents,或设 DSH_WORKPLAN_ACTIVATION_QUEUE_MAX_WAIT_MS 调大排队等待上限(默认 10 分钟)。',
2802
+ '4) 规划超时或被限流:直接说「重试」即可重新分解(每次规划最多 3 次尝试)。',
2803
+ '',
2795
2804
  PLAN_MARKER_BEGIN,
2796
2805
  JSON.stringify(payload),
2797
2806
  PLAN_MARKER_END,
@@ -3250,8 +3259,15 @@ export function buildCancelMessage(planId: any, reason: any = '用户取消', te
3250
3259
  * [T7] 可见文本收敛+信封迁移(选项 A):取消是计划级终态事件(C1b),
3251
3260
  * 保留一行关键进度与「取消≠完成」输出契约;全量信封随 source.durable
3252
3261
  * 落盘,parseCancelMessage 先读元数据回退旧文本标记(旧消息零迁移)。
3262
+ *
3263
+ * [3.1.0] 双写回归修复(W5 探针断言 6 实测红灯):T7 把信封迁出可见文本后,
3264
+ * 1.8.19 等旧版读端只剩文本标记通道(source.durable 是 2.2.x 才有的形态),
3265
+ * 旧回放读不到取消/取代 → 安全降级契约破坏(v3.0.0–v3.0.9 回归)。恢复
3266
+ * 标记块双写:新读端仍优先 source.durable(可见文本零变化),旧读端按
3267
+ * cancelled 安全降级。w5-cross-version-check 六断言全 PASS 为准入。
3253
3268
  */
3254
3269
  const keyText = capKeyProgressText(`${summary}|取消≠完成:未完成项不得交付、不得声称完成;不要调用 present;答复开头须写「未完成:剩余 N 项(列出 ID)与原因」(按需:dsh_workplan_status)`)
3270
+ + `\n\n${CANCEL_MARKER_BEGIN}\n${JSON.stringify(payload)}\n${CANCEL_MARKER_END}`
3255
3271
  return makeUserMessage(keyText, {
3256
3272
  kind: 'workplan-cancel',
3257
3273
  form: 'notice',
@@ -3296,8 +3312,11 @@ function buildSupersededMessage(planId: any, reason: any, terminal: any) {
3296
3312
  supersededAt,
3297
3313
  supersededBy: by,
3298
3314
  }
3299
- /* [T7] 可见文本收敛+信封迁移(选项 A):取代是计划级终态事件(C1b)。 */
3315
+ /* [T7] 可见文本收敛+信封迁移(选项 A):取代是计划级终态事件(C1b)。
3316
+ * [3.1.0] 同上恢复标记块双写:旧版读端(1.8.19)只认文本标记,缺它会
3317
+ * 把 superseded 安全降级退化成「读不到终态」——W5 探针断言 6 钉住。 */
3300
3318
  const keyText = capKeyProgressText(`${summary}|被取代≠完成:原计划记录原样保留,未完成项不会因转移变成完成;交付只用承接计划通过就绪检查的产物(按需:dsh_workplan_status)`)
3319
+ + `\n\n${CANCEL_MARKER_BEGIN}\n${JSON.stringify(payload)}\n${CANCEL_MARKER_END}`
3301
3320
  return makeUserMessage(keyText, {
3302
3321
  kind: 'workplan-cancel',
3303
3322
  form: 'notice',
@@ -5014,11 +5033,9 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5014
5033
  * 经开工闸 validateStartPhaseEvidence 判据。consolidation 只留分工表与等级配置。
5015
5034
  */
5016
5035
  assignments: (Array.isArray(patch.consolidation.assignments) ? patch.consolidation.assignments : [])
5017
- // [2.5.4][T4] D1/D2 配套:消毒上限须 ≥ 合法分工表最大人数(复杂 12,与 llm-rules.ts
5018
- // MAX_COMPLEX_DELEGATE_MEMBERS 同值——因 llm-rules 依赖 plan 会循环引用,此处不 import,
5019
- // 改一处须同步另一处);人数判据唯一权威仍是 planDelegations 门禁:非复杂在
5020
- // review/dispatch 照旧截 6,持久化放宽不绕任何闸。
5021
- .slice(0, 12)
5036
+ // [3.1.0] 消毒上限随 caps.ts(复杂 12→25,单一真源;历史注释「改一处须
5037
+ // 同步另一处」的耦合自此解除);人数判据唯一权威仍是 planDelegations 门禁。
5038
+ .slice(0, MAX_COMPLEX_DELEGATE_MEMBERS)
5022
5039
  .map((item: any) => ({
5023
5040
  member: truncate(String(item?.member ?? ''), 80),
5024
5041
  role: normalizeDeptRole(item?.role),
@@ -5094,8 +5111,8 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5094
5111
  }
5095
5112
  }
5096
5113
  next.delegates = (Array.isArray(patch.delegates) ? patch.delegates : [])
5097
- // [T8][D2 同步] 与 MAX_COMPLEX_DELEGATE_MEMBERS=12 对齐,人数权威仍是 planDelegations 门禁
5098
- .slice(0, 12)
5114
+ // [T8][D2 同步][3.1.0] 与 caps.ts MAX_COMPLEX_DELEGATE_MEMBERS 同源(不再手写 12)
5115
+ .slice(0, MAX_COMPLEX_DELEGATE_MEMBERS)
5099
5116
  .map((item: any) => ({
5100
5117
  member: truncate(String(item?.member ?? ''), 80),
5101
5118
  role: normalizeDeptRole(item?.role),
@@ -5165,7 +5182,7 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5165
5182
  else if (isRecord(patch.delegateSelfEfforts)) {
5166
5183
  const entries = Object.entries(patch.delegateSelfEfforts)
5167
5184
  .filter(([, value]) => typeof value === 'string' && REASONING_EFFORTS.includes(value))
5168
- .slice(0, 12)
5185
+ .slice(0, MAX_COMPLEX_DELEGATE_MEMBERS)
5169
5186
  next.delegateSelfEfforts = Object.fromEntries(entries.map(([key, value]) => [truncate(String(key), 80), value]))
5170
5187
  } else {
5171
5188
  throw new PlanError('delegateSelfEfforts 必须是 member→档位 对象或 null', 'INVALID_DELEGATE_SELF_EFFORTS')
@@ -5183,7 +5200,7 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5183
5200
  const entries = Object.entries(patch.delegateStartPhases)
5184
5201
  .map(([key, value]) => [truncate(String(key), 80), sanitizeStartPhaseEvidence(value)] as const)
5185
5202
  .filter(([, value]) => value !== null)
5186
- .slice(0, 12)
5203
+ .slice(0, MAX_COMPLEX_DELEGATE_MEMBERS)
5187
5204
  next.delegateStartPhases = Object.fromEntries(entries)
5188
5205
  } else {
5189
5206
  throw new PlanError('delegateStartPhases 必须是 member→开工证据 对象或 null', 'INVALID_DELEGATE_START_PHASES')
@@ -5194,8 +5211,7 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5194
5211
  * 重置保留(与 delegateSelfEfforts/delegateStartPhases 同语义);重派读档据此
5195
5212
  * 判定「预估已登记」。逐成员经 sanitizeDelegateEstimate 消毒(非法丢弃),
5196
5213
  * 非法形状抛 INVALID_DELEGATE_ESTIMATES(与 delegateSelfEfforts 同错误码口径)。
5197
- * 上限 12 与 delegates slice(0,12)/MAX_COMPLEX_DELEGATE_MEMBERS 对齐:契约 A2
5198
- * 要求 8 人预估全部存活,不得沿用旧台账的 6 人截断。
5214
+ * [3.1.0] 上限随 caps.ts(不再手写 12):契约 A2 要求全部预估存活。
5199
5215
  */
5200
5216
  if (patch.delegateEstimates !== undefined) {
5201
5217
  if (patch.delegateEstimates === null) next.delegateEstimates = null
@@ -5203,7 +5219,7 @@ export function applyStatus(statuses: any, subtaskId: any, patch: any) {
5203
5219
  const entries = Object.entries(patch.delegateEstimates)
5204
5220
  .map(([key, value]) => [truncate(String(key), 80), sanitizeDelegateEstimate(value)] as const)
5205
5221
  .filter(([, value]) => value !== null)
5206
- .slice(0, 12)
5222
+ .slice(0, MAX_COMPLEX_DELEGATE_MEMBERS)
5207
5223
  next.delegateEstimates = Object.fromEntries(entries)
5208
5224
  } else {
5209
5225
  throw new PlanError('delegateEstimates 必须是 member→预估对象 或 null', 'INVALID_DELEGATE_ESTIMATES')
@@ -6859,7 +6875,7 @@ export function buildChildPrompt({
6859
6875
  // + 更简单的多人分工。与 llm-rules.ts buildLlmRulesBrief 同一口径。
6860
6876
  '本部门再分配权限与推理等级配置(用户强制要求,平台机制保障):',
6861
6877
  // [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts buildLlmRulesBrief 同源逐字一致)
6862
- '- 你是本子任务的部门负责人,拥有再分配权限:先用 dsh_workplan_delegate(action="review") 提交第 1/2/3 步开工证据(startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } })与分工表,再用 action="dispatch" 把任务分配给本部门多名相关领域全球顶尖专家(角色只保留 expert,部门组员已按用户要求 9 取消,至少 1 名;low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断);未提交开工证据与分工表前 dispatch 会被平台硬门禁拒绝。',
6878
+ `- 你是本子任务的部门负责人,拥有再分配权限:先用 dsh_workplan_delegate(action="review") 提交第 1/2/3 步开工证据(startPhases={ planning{ problemAnalysis[], approach[], approachBasis[], resources[], tools[] }, preparation{ prepared[], evidence[] } })与分工表,再用 action="dispatch" 把任务分配给本部门多名相关领域全球顶尖专家(角色只保留 expert,部门组员已按用户要求 9 取消,至少 1 名;low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(${START_EVIDENCE_MIN_CHARS_BRIEF};可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人且最多 ${MAX_COMPLEX_DELEGATE_MEMBERS} 人,少于 ${MIN_COMPLEX_DELEGATE_MEMBERS} 人硬性阻断,超过上限平台拒收);未提交开工证据与分工表前 dispatch 会被平台硬门禁拒绝。`,
6863
6879
  '- 分配必须更简单:每位下级只承担单一目标、单一主产物、可独立验收的一项工作;任务描述完整自包含,让下级拿到就能做,不要把多个交付物压给同一个人。',
6864
6880
  '- 先配置后开工(平台硬规则):你以 phase-0(low 档)启动,唯一职责是评估你接到任务的复杂度,并在 consolidation.taskReasoningEffort 里配置你自己的整体推理等级(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max);登记后平台立即以你的自配档接续本会话进入 phase-1(派活/协调/验收/重试决策整个分配过程全程用自配档,重试/续跑不丢)。分工表 per-expert 档仅为建议:每位专家必须在 phase-0 经 self_effort 按自己分到的单项任务复杂度自配自己的等级,专家自配为权威,越界档由平台按当前模型家族合法集合自动钳制并留痕。low(轻度)/未配置任务禁止下派:负责人亲自执行,开工证据经 action="direct" 登记;复杂任务才走 review+dispatch。',
6865
6881
  '- 第三层专家是叶子层:他们不得再派生第四层;下级结论会送回本会话,收齐后由你汇总核验(必须覆盖全部已派发专家,不得只汇总一部分),再写最终结果块。用 action="status" 随时查看梳理登记与下级进度。',