dsh-cohub 0.4.4 → 0.4.5

package/lib/index.js

@@ -54,6 +54,46 @@ co-planner - 只读。综合需求+信息+规范输出结构化任务分解方
 - 并行派发按下方「并行派发方式（原则 + 参数，禁止超预算大并行）」执行：优先并发：单条 assistant 消息里同时发出 N 个 delegate tool_use 块（N ≤ schedule.maxParallelBatch），由 agent loop 并发执行；单批规模受 \`schedule.maxParallelBatch\` 约束，禁止把可能超出墙钟预算的整批压进一次执行单元
 - delegate 按 cordis.patch.yml 的 skills 配置路由 provider/model 并 spawn 子代理；子代理不共享本会话，prompt 必须自包含（写全任务目标、相关文件路径、约束、期望输出格式；角色身份由 delegate 自动注入）
 
+### 批量委派方式（delegate_batch 工具）
+
+**用途**：一次工具调用内部并行派发多个子代理任务，避免 DSH agent loop 将多个 delegate 串行化。
+
+**何时使用**：
+- 需要同时派发 ≥2 个无依赖、不冲突的独立任务
+- 修改不同文件、探索不同目录、审查不同模块等互不干扰的场景
+- ⚠️ 同文件修改仍需串行，不能放入同一批 delegate_batch
+
+**参数**：
+- \`tasks\`：任务数组，每项包含：
+  - \`id\`（可选）：任务标识，用于结果映射；不提供时自动生成 task-0、task-1...
+  - \`skill\`（必填）：专职代理名，如 co-fixer、co-explorer、co-oracle
+  - \`prompt\`（必填）：具体任务描述（自包含，写全目标、文件路径、约束）
+
+**特性**：
+- 内部使用 Promise.allSettled() 并行启动所有子代理
+- 每个 task 有独立的 AbortController，超时时主动中止子代理
+- 每个 task 只尝试一次（不重试），通过墙钟预算超时兜底
+- 父级中止时全部子代理取消
+- 返回结构化结果：每个 task 的 status（completed/failed/error）、result、error
+
+**示例**：
+delegate_batch({
+  tasks: [
+    { id: "explore-auth", skill: "co-explorer", prompt: "搜索 src/auth/ 目录下所有认证相关文件" },
+    { id: "fix-login", skill: "co-fixer", prompt: "在 src/auth/login.ts 中修复类型错误" },
+    { id: "review-api", skill: "co-oracle", prompt: "审查 src/api/routes.ts 的安全问题" },
+  ]
+})
+
+**对比 delegate**：
+| 维度 | delegate | delegate_batch |
+|------|----------|----------------|
+| 每次调用 | 1 个任务 | N 个任务（N≥1） |
+| 并行方式 | 依赖 agent loop 并发多个 tool_use | 工具内部 Promise.allSettled |
+| 重试 | 支持（P1-2） | 不支持（每个 task 一次） |
+| 停滞检测 | 支持（N2） | 不支持 |
+| 适用场景 | 单任务、需要重试、需要停滞检测 | 批量并行独立任务 |
+
 ### 并行派发方式（原则 + 参数，禁止超预算大并行）
 - **并行原则（任何环境成立）**：无依赖且不冲突的任务并行；有依赖/同文件写冲突串行；并行度克制，收益递减收敛分批。
 - **批大小参数**：单批 ≤ \`schedule.maxParallelBatch\`（当前生效值见系统提示词注入的「调度参数」段；部署可调，本环境观测值 2-3）。
@@ -765,6 +805,17 @@ Orchestrator 会在 prompt 中明确指定：
 
 // src/council.ts
 import { defineTool } from "@deepseek-ai/dsh-tools";
+
+// src/text-utils.ts
+function contentText(output) {
+  if (!Array.isArray(output))
+    return "";
+  return output.filter((b) => !!b && typeof b === "object" && b.type === "text" && typeof b.text === "string").map((b) => b.text).join(`
+
+`);
+}
+
+// src/council.ts
 function shortModelLabel(model) {
   return model.split("/").pop() ?? model;
 }
@@ -821,13 +872,6 @@ ${r.result}`).join(`
   return parts.join(`
 `);
 }
-function contentText(output) {
-  if (!Array.isArray(output))
-    return "";
-  return output.filter((b) => !!b && typeof b === "object" && b.type === "text" && typeof b.text === "string").map((b) => b.text).join(`
-
-`);
-}
 function createCouncilTool(config, ctx) {
   return defineTool({
     name: "council_session",
@@ -1051,13 +1095,6 @@ function pickEnvContractText(args) {
   }
   return { text: DEFAULT_ENV_CONTRACT, source: "default" };
 }
-function contentText2(output) {
-  if (!Array.isArray(output))
-    return "";
-  return output.filter((b) => !!b && typeof b === "object" && b.type === "text" && typeof b.text === "string").map((b) => b.text).join(`
-
-`);
-}
 function normalizeErrorSignature(data) {
   if (!data || typeof data !== "object")
     return null;
@@ -1070,7 +1107,7 @@ function normalizeErrorSignature(data) {
     if (msg || code)
       return "err:" + (code ? code + " " : "") + msg.slice(0, 120);
   }
-  const text = contentText2(data?.message?.content).trim();
+  const text = contentText(data?.message?.content).trim();
   if (text)
     return "err:" + text.slice(0, 120);
   return data?.message?.isError === true ? "err:unknown" : null;
@@ -1187,7 +1224,7 @@ class EnvSignatureLearner {
           this.errorSigs.add(sig);
       }
     } else {
-      const text = contentText2(d?.message?.content);
+      const text = contentText(d?.message?.content);
       if (/await\s+import\s*\(/i.test(text))
         this.sawAwaitImportSuccess = true;
     }
@@ -1195,13 +1232,6 @@ class EnvSignatureLearner {
 }
 
 // src/delegate.ts
-function contentText3(output) {
-  if (!Array.isArray(output))
-    return "";
-  return output.filter((b) => !!b && typeof b === "object" && b.type === "text" && typeof b.text === "string").map((b) => b.text).join(`
-
-`);
-}
 function normalizeErrorSignature2(data) {
   if (!data || typeof data !== "object")
     return null;
@@ -1214,7 +1244,7 @@ function normalizeErrorSignature2(data) {
     if (msg || code)
       return "err:" + (code ? code + " " : "") + msg.slice(0, 120);
   }
-  const text = contentText3(data?.message?.content).trim();
+  const text = contentText(data?.message?.content).trim();
   if (text)
     return "err:" + text.slice(0, 120);
   return data?.message?.isError === true ? "err:unknown" : null;
@@ -1406,6 +1436,59 @@ class StallWatchdog {
     });
   }
 }
+function resolveSkillAndRoute(requestedSkill, getRoutes, ctx, logger) {
+  const skillName = requestedSkill || "co-fixer";
+  let skill = COHUB_SKILLS.find((s) => s.name === skillName);
+  if (!skill) {
+    (logger ?? ctx.logger)?.warn?.('delegate: unknown skill "' + skillName + '", falling back to co-fixer');
+    skill = COHUB_SKILLS.find((s) => s.name === "co-fixer");
+  } else if (!requestedSkill) {
+    (logger ?? ctx.logger)?.info?.("delegate: skill not specified, defaulting to co-fixer");
+  }
+  const route = (getRoutes() ?? []).find((s) => s.name === requestedSkill);
+  return { skill, route };
+}
+function buildAgentOptions(route, ctx) {
+  if (route?.provider) {
+    const available = new Set(ctx.llm.listProviders().map((p) => p.id));
+    if (available.has(route.provider)) {
+      return {
+        provider: route.provider,
+        ...route.model ? { model: route.model } : {},
+        ...route.maxTokens ? { maxTokens: route.maxTokens } : {}
+      };
+    }
+  }
+  return;
+}
+function resolveContractText(envContract, envSig, ctx) {
+  if (!envContract.enabled)
+    return { text: "", source: "disabled" };
+  const fp = envFingerprint();
+  const cached = envSig.use !== "off" ? readEnvSignatures(envSig.cachePath) : null;
+  const picked = pickEnvContractText({
+    manualText: envContract.text,
+    envSig,
+    cached,
+    fingerprint: fp
+  });
+  if (picked.source === "cache") {
+    ctx.logger?.info?.("[cohub envsig] 命中环境契约缓存（指纹一致 + TTL 内）");
+  }
+  const text = `
+
+--- ` + (picked.source === "cache" || picked.source === "manual-contract" ? "执行器环境契约（本环境已验证）" : "执行器环境契约（通用原则 + 探测式自适应）") + ` ---
+
+` + picked.text;
+  return { text, source: picked.source };
+}
+function buildDelegatePrompt(params) {
+  return (params.skill.brief || params.skill.content) + params.contractText + `
+
+--- 你的具体任务 ---
+
+` + params.userPrompt + (params.retryNote ?? "");
+}
 function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
   const envContract = {
     enabled: config.delegateEnvContract?.enabled ?? true,
@@ -1446,7 +1529,6 @@ function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
     parameters: {
       skill: {
         type: "string",
-        required: false,
         description: "专职代理技能名，如 co-fixer/co-explorer/co-oracle。缺省时默认 co-fixer"
       },
       prompt: {
@@ -1467,46 +1549,15 @@ function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
       const { retry, stall, schedule } = resolveRuntimeConfig();
       const RETRYABLE = new Set(retry.retryableReasons);
       ctx.logger?.info?.("[cohub schedule] 生效调度参数：batch=" + (schedule?.maxParallelBatch ?? 3) + " wallMs=" + (schedule?.wallClockBudgetMs ?? 600000) + " jobTracking=" + (schedule?.useJobTracking ?? "auto") + " adaptiveBatch=" + (schedule?.adaptiveBatch ?? "auto"));
-      const requestedSkill = args.skill || "co-fixer";
-      let skill = COHUB_SKILLS.find((s) => s.name === requestedSkill);
-      if (!skill) {
-        ctx.logger?.warn?.('delegate: unknown skill "' + requestedSkill + '", falling back to co-fixer');
-        skill = COHUB_SKILLS.find((s) => s.name === "co-fixer");
-      } else if (!args.skill) {
-        ctx.logger?.info?.("delegate: skill not specified, defaulting to co-fixer");
-      }
-      const route = (getRoutes() ?? []).find((s) => s.name === args.skill);
+      const { skill, route } = resolveSkillAndRoute(args.skill, getRoutes, ctx);
       const brief = skill.brief?.trim();
       if (!brief) {
         ctx.logger?.warn?.('delegate: skill "' + args.skill + '" 缺少 brief，回退完整 content');
       }
-      let agentOptions;
-      if (route?.provider) {
-        const available = new Set(ctx.llm.listProviders().map((p) => p.id));
-        if (available.has(route.provider)) {
-          agentOptions = {
-            provider: route.provider,
-            ...route.model ? { model: route.model } : {},
-            ...route.maxTokens ? { maxTokens: route.maxTokens } : {}
-          };
-        }
-      }
+      const agentOptions = buildAgentOptions(route, ctx);
+      const contractResult = resolveContractText({ enabled: envContract.enabled, text: envContract.text }, envSig, ctx);
+      const contractText = contractResult.text;
       const fp = envFingerprint();
-      const cached = envSig.use !== "off" ? readEnvSignatures(envSig.cachePath) : null;
-      const picked = pickEnvContractText({
-        manualText: envContract.text,
-        envSig,
-        cached,
-        fingerprint: fp
-      });
-      if (picked.source === "cache") {
-        ctx.logger?.info?.("[cohub envsig] 命中环境契约缓存（指纹一致 + TTL 内）");
-      }
-      const contractText = envContract.enabled ? `
-
---- ` + (picked.source === "cache" || picked.source === "manual-contract" ? "执行器环境契约（本环境已验证）" : "执行器环境契约（通用原则 + 探测式自适应）") + ` ---
-
-` + picked.text : "";
       let lastReason = "unknown";
       let lastPartial = "";
       let lastStall = null;
@@ -1516,11 +1567,12 @@ function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
         const retryNote = attempt > 0 ? `
 
 [重试 #` + attempt + "] 上一次执行中止，原因：" + lastReason + "；已完成部分：" + (lastPartial || "（无）") + stallNote + "。请从中断处继续，不要重复已完成步骤。" : "";
-        const promptText = (brief || skill.content) + contractText + `
-
---- 你的具体任务 ---
-
-` + args.prompt + retryNote;
+        const promptText = buildDelegatePrompt({
+          skill,
+          contractText,
+          userPrompt: args.prompt,
+          retryNote
+        });
         const ac = stall.enabled ? new AbortController : null;
         let onExecAbort = null;
         const forwardAbort = () => {
@@ -1613,9 +1665,9 @@ function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
           } catch {}
         }
         if (outcome?.stopReason === "completed")
-          return contentText3(outcome.output);
+          return contentText(outcome.output);
         lastReason = String(outcome?.stopReason ?? "unknown");
-        lastPartial = contentText3(outcome?.output ?? []).slice(0, 500);
+        lastPartial = contentText(outcome?.output ?? []).slice(0, 500);
         lastStall = stallInfo;
         if (stallInfo && !stall.recoverable)
           break;
@@ -1637,6 +1689,232 @@ function createDelegateTool(ctx, getRoutes, config = {}, getSettings) {
   });
 }
 
+// src/delegate_batch.ts
+import { defineTool as defineTool3 } from "@deepseek-ai/dsh-tools";
+var MAX_BATCH_SIZE = 20;
+function createDelegateBatchTool(ctx, getRoutes, config = {}, getSettings) {
+  const envContract = {
+    enabled: config.delegateEnvContract?.enabled ?? true,
+    text: config.delegateEnvContract?.text
+  };
+  const envSig = {
+    use: config.envSignatures?.use ?? "auto",
+    ttlMs: Math.max(0, config.envSignatures?.ttlMs ?? 604800000),
+    confirmCount: Math.max(1, Math.trunc(config.envSignatures?.confirmCount ?? 2)),
+    contract: config.envSignatures?.contract,
+    errorCategories: config.envSignatures?.errorCategories,
+    cachePath: config.envSignatures?.cachePath
+  };
+  function resolveRuntimeConfig() {
+    const settingsNow = getSettings ? getSettings() ?? {} : {};
+    const scheduleCfg = settingsNow.schedule ?? config.schedule;
+    return {
+      wallClockBudgetMs: Math.max(0, scheduleCfg?.wallClockBudgetMs ?? 600000)
+    };
+  }
+  return defineTool3({
+    name: "delegate_batch",
+    description: "批量并行委派：一次调用同时启动多个子代理任务，返回每个任务的结构化结果。适合并行派发多个无依赖的独立任务（如同时让多个 co-explorer 探索不同目录，或多个 co-fixer 修改不同文件）。每个 task 只尝试一次，不重试。上限 20 个任务。",
+    parameters: {
+      tasks: {
+        type: "array",
+        required: true,
+        description: "任务列表，每个任务包含 id（可选，用于结果映射）、skill（代理名）、prompt（具体任务描述）。上限 20 个。",
+        items: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            id: { type: "string", description: "可选任务标识，用于结果映射" },
+            skill: { type: "string", description: "必填，专职代理技能名，如 co-fixer / co-explorer / co-oracle" },
+            prompt: { type: "string", description: "必填，给该代理的具体任务描述" }
+          }
+        }
+      }
+    },
+    output: {
+      schema: { type: "string" },
+      render: (_args, value) => [{ type: "text", text: String(value) }]
+    },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      const parent = exec?.agent;
+      if (!parent)
+        throw new Error("delegate_batch requires a calling agent (exec.agent was undefined)");
+      const { wallClockBudgetMs } = resolveRuntimeConfig();
+      const tasks = args.tasks ?? [];
+      if (tasks.length === 0) {
+        return "delegate_batch: 无任务";
+      }
+      if (tasks.length > MAX_BATCH_SIZE) {
+        return `delegate_batch: 任务数 ${tasks.length} 超过上限 ${MAX_BATCH_SIZE}，请分批执行。`;
+      }
+      const contractText = envContract.enabled ? resolveContractText(envContract, envSig, ctx).text : "";
+      const starts = await Promise.allSettled(tasks.map(async (task, index) => {
+        const taskId = task.id ?? `task-${index}`;
+        const { skill, route } = resolveSkillAndRoute(task.skill, getRoutes, ctx, ctx.logger);
+        const promptText = buildDelegatePrompt({
+          skill,
+          contractText,
+          userPrompt: task.prompt
+        });
+        const agentOptions = buildAgentOptions(route, ctx);
+        const ac = new AbortController;
+        let onExecAbort = null;
+        if (exec.signal) {
+          if (exec.signal.aborted) {
+            ac.abort();
+          } else {
+            onExecAbort = () => {
+              if (!ac.signal.aborted)
+                ac.abort();
+            };
+            exec.signal.addEventListener("abort", onExecAbort, { once: true });
+          }
+        }
+        try {
+          const run = await ctx.subagents.start("spawn", {
+            label: `delegate_batch:${taskId}:${task.skill}`,
+            prompt: [{ type: "text", text: promptText }],
+            parent,
+            persona: "你是被委派的专职代理：严格遵循任务消息中的角色定义、关键约束、输出格式与工具指令，并完成末尾的具体任务。",
+            ...agentOptions ? { agentOptions } : {},
+            signal: ac.signal
+          });
+          return { taskId, task, run, ac, onExecAbort, startError: undefined };
+        } catch (startError) {
+          if (onExecAbort && exec.signal) {
+            try {
+              exec.signal.removeEventListener("abort", onExecAbort);
+            } catch {}
+          }
+          return { taskId, task, run: undefined, ac, onExecAbort: null, startError };
+        }
+      }));
+      const results = [];
+      const runs = [];
+      try {
+        for (const s of starts) {
+          if (s.status === "rejected") {
+            continue;
+          }
+          const val = s.value;
+          if (val.startError) {
+            results.push({
+              id: val.taskId,
+              skill: val.task.skill,
+              status: "error",
+              error: val.startError instanceof Error ? val.startError.message : String(val.startError)
+            });
+            continue;
+          }
+          const { run, taskId, task, ac, onExecAbort } = val;
+          runs.push({ run, taskId, task, ac, onExecAbort });
+          run.result.catch(() => {});
+        }
+        for (const { run, taskId, task, ac, onExecAbort } of runs) {
+          let outcome;
+          let timer = null;
+          try {
+            outcome = await Promise.race([
+              run.result,
+              new Promise((_, reject) => {
+                timer = setTimeout(() => {
+                  if (!ac.signal.aborted)
+                    ac.abort();
+                  reject(new Error(`超时：${wallClockBudgetMs}ms`));
+                }, wallClockBudgetMs);
+                if (exec.signal && !exec.signal.aborted) {
+                  exec.signal.addEventListener("abort", () => {
+                    if (timer)
+                      clearTimeout(timer);
+                  }, { once: true });
+                }
+              })
+            ]);
+            if (outcome?.stopReason === "completed") {
+              results.push({
+                id: taskId,
+                skill: task.skill,
+                status: "completed",
+                result: contentText(outcome.output)
+              });
+            } else {
+              results.push({
+                id: taskId,
+                skill: task.skill,
+                status: "failed",
+                error: `stopReason: ${outcome?.stopReason ?? "unknown"}`,
+                stopReason: outcome?.stopReason
+              });
+            }
+          } catch (e) {
+            results.push({
+              id: taskId,
+              skill: task.skill,
+              status: "error",
+              error: e instanceof Error ? e.message : String(e)
+            });
+          } finally {
+            if (timer)
+              clearTimeout(timer);
+          }
+        }
+      } finally {
+        for (const { run, ac, onExecAbort } of runs) {
+          if (onExecAbort && exec.signal) {
+            try {
+              exec.signal.removeEventListener("abort", onExecAbort);
+            } catch {}
+          }
+          if (!ac.signal.aborted)
+            ac.abort();
+          try {
+            run.dispose();
+          } catch {}
+        }
+      }
+      const completed = results.filter((r) => r.status === "completed");
+      const failed = results.filter((r) => r.status !== "completed");
+      let output = `--- delegate_batch 结果 ---
+`;
+      output += `总计: ${results.length} 个任务 | 完成: ${completed.length} | 失败: ${failed.length}
+
+`;
+      if (completed.length > 0) {
+        output += `## 已完成任务
+
+`;
+        for (const r of completed) {
+          output += `### ${r.id} (${r.skill})
+${r.result}
+
+`;
+        }
+      }
+      if (failed.length > 0) {
+        output += `## 失败/错误任务
+
+`;
+        for (const r of failed) {
+          output += `### ${r.id} (${r.skill})
+`;
+          output += `状态: ${r.status}
+`;
+          if (r.error)
+            output += `错误: ${r.error}
+`;
+          if (r.stopReason)
+            output += `stopReason: ${r.stopReason}
+`;
+          output += `
+`;
+        }
+      }
+      return output;
+    }
+  });
+}
+
 // src/index.ts
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 var Councillor = z.object({
@@ -1707,10 +1985,6 @@ var CohubSettingsSchema = z.object({
   schedule: ScheduleConfig,
   delegateRetry: DelegateRetry
 });
-function renderScheduleParams(schedule) {
-  const s = schedule ?? {};
-  return "调度参数（部署配置，非指令）：单批 ≤ " + (s.maxParallelBatch ?? 3) + "；墙钟预算 " + (s.wallClockBudgetMs ?? 600000) + " ms" + "；job 跟踪 " + (s.useJobTracking ?? "auto") + "；批间自适应 " + (s.adaptiveBatch ?? "auto");
-}
 var SHIPPED_PRESETS_DIR = fileURLToPath(new URL("../presets/", import.meta.url));
 function installAgentPresets(logger) {
   let entries;
@@ -1771,11 +2045,11 @@ function apply(ctx, config) {
     delegateRetry: config.delegateRetry,
     envSignatures: config.envSignatures
   }, () => currentSettings()));
-  ctx.effect(() => ctx.systemPrompt.section({
-    name: "cohub:schedule",
-    order: 96,
-    text: () => renderScheduleParams(currentSettings().schedule)
-  }), "cohub.scheduleSection()");
+  ctx.tools.register(createDelegateBatchTool(ctx, () => currentSkills(), {
+    delegateEnvContract: config.delegateEnvContract,
+    delegateRetry: config.delegateRetry,
+    envSignatures: config.envSignatures
+  }, () => currentSettings()));
   if ((config.councillors ?? []).length > 0) {
     if (!ctx.reflect?.get?.("subagents", false)) {
       throw new Error("cohub: council tool requires the subagents service (@deepseek-ai/dsh-subagent)");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cohub",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "DeepSeek Harness 版 CoHub：中文智能体编排——双 preset 模式（co-orchestrator 纯调度 + cohub-standard 标准）/ 12 技能（11 专职代理 + orchestrator）/ 多模型共识",
   "type": "module",
   "main": "lib/index.js",
@@ -36,7 +36,8 @@
     }
   },
   "scripts": {
-    "build": "bun run scripts/generate-skills.ts && bun build src/index.ts --outdir lib --target node --format esm --external @deepseek-ai/cordis --external @deepseek-ai/schemastery --external @deepseek-ai/dsh-tools --external @deepseek-ai/dsh-system-prompt --external @deepseek-ai/dsh-skill --external @deepseek-ai/dsh-home-paths --external @deepseek-ai/dsh-settings && bun run scripts/build-client.js",
+    "build": "bun run scripts/generate-skills.ts && bun run scripts/guard-schema.ts && bun build src/index.ts --outdir lib --target node --format esm --external @deepseek-ai/cordis --external @deepseek-ai/schemastery --external @deepseek-ai/dsh-tools --external @deepseek-ai/dsh-system-prompt --external @deepseek-ai/dsh-skill --external @deepseek-ai/dsh-home-paths --external @deepseek-ai/dsh-settings && bun run scripts/build-client.js",
+    "lint:schema": "bun run scripts/guard-schema.ts",
     "prepublishOnly": "npm run build",
     "build:client": "bun run scripts/build-client.js",
     "audit": "node scripts/audit-session.mjs"

package/presets/co-orchestrator/agent.cordis.yml

@@ -46,8 +46,13 @@
       name: '@deepseek-ai/dsh-tool-workflow'
 
 # ── 技能（co-* 技能目录由 dsh-cohub 全局注册，本 preset 只需加载工具） ──
+# 注意：catalogEnabled: false 关闭目录注入——Orchestrator 使用 delegate() 委派，
+# 从不通过 skill() 加载 co-* 技能，无需每步注入 14 个技能目录浪费 token。
+# skill() 工具本身仍然注册，子代理（通过 delegate spawn）可正常使用。
 - id: tool-skill
   name: '@deepseek-ai/dsh-tool-skill'
+  config:
+    catalogEnabled: false
 
 # ── 任务与后台任务面板 ──────────────────────────────────────────────────
 - id: tool-todo