dsh-agent-toolkit 0.1.0 → 0.2.2

package/lib/index.d.ts

@@ -47,6 +47,21 @@ interface BotsModuleConfig {
   errorDetailMaxChars: number;
 }
 //#endregion
+//#region src/agents/team-preset.d.ts
+/** 本功能的可调配置（Config schema 在 ../index.ts）。 */
+interface AgentTeamPresetConfig {
+  /** 总开关：false 时启动不生成/刷新 preset。 */
+  enabled: boolean;
+  /** 生成的 preset id（即目录名）。 */
+  id: string;
+  /** 源 preset id，读其 composition 做派生。 */
+  source: string;
+  /** preset.yml 的显示名。 */
+  name: string;
+  /** preset.yml 的描述。 */
+  description: string;
+}
+//#endregion
 //#region src/index.d.ts
 declare const name = "dsh-agent-toolkit";
 declare const inject: string[];
@@ -62,6 +77,7 @@ interface Config {
   provider: string;
   toolName: string;
   feishu: BotsModuleConfig;
+  agentTeamPreset: AgentTeamPresetConfig;
 }
 /** layers/rules 的 schemastery schema 照归档 prompt-stack/src/index.ts:21-41 逐字段平移（含 overrides transform hack）。 */
 declare const Config: z<unknown, Config>;

package/lib/index.js

@@ -1,16 +1,16 @@
 import z from "@deepseek-ai/schemastery";
 import { z as z$1 } from "zod";
 import { defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
-import { readFile, readdir } from "node:fs/promises";
-import { join } from "node:path";
+import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
 import yaml from "js-yaml";
-import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
+import { expandHomePath, resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { defineTool } from "@deepseek-ai/dsh-tools";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { existsSync } from "node:fs";
 import { SessionId } from "@deepseek-ai/dsh-session";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import * as lark from "@larksuiteoapi/node-sdk";
-import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { randomBytes, randomUUID } from "node:crypto";
 import { setupUsage } from "@dsh-agent-toolkit/token-usage";
 //#region src/agents/store.ts
@@ -60,7 +60,42 @@ function migrateAgentRecord(record) {
 	} : rest;
 }
 //#endregion
+//#region src/channels/basic-tools.ts
+const BASIC_TOOLS = [
+	{
+		id: "@deepseek-ai/dsh-persona",
+		config: { text: "You are a coding agent powered by the {{model}} model. Your working directory is {{cwd}}." }
+	},
+	{
+		id: "@deepseek-ai/dsh-agent-instructions",
+		config: { maxBytes: 65536 }
+	},
+	...process.platform === "win32" ? [{ id: "@deepseek-ai/dsh-tool-pwsh" }] : [{ id: "@deepseek-ai/dsh-tool-bash" }],
+	{ id: "@deepseek-ai/dsh-tool-fs" },
+	{
+		id: "@deepseek-ai/dsh-tool-fs-search",
+		config: { sampleOverCapGlobResults: false }
+	}
+];
+/** 原生工具名（白名单 UI 与存量迁移用）：与 BASIC_TOOLS 挂载插件注册的工具名一一对应。
+*  名字来源（摘自 deepseek-harness 源码）：dsh-tool-pwsh/dsh-tool-bash → 'pwsh'/'bash'（平台互斥）；
+*  dsh-tool-fs → 'read'/'write'/'edit'/'read_image'；dsh-tool-fs-search → 'glob'/'grep'。
+*  这些工具 scoped 挂载在 agentCtx，不出现在顶层 ctx.tools.schemas()，故需显式常量。 */
+const NATIVE_TOOL_NAMES = [
+	process.platform === "win32" ? "pwsh" : "bash",
+	"read",
+	"write",
+	"edit",
+	"read_image",
+	"glob",
+	"grep"
+];
+//#endregion
 //#region src/agents/builtin.ts
+/** 内置保底 Agent 记录：main + explorer（只读白名单）/ general（不限制）。 */
+/** explorer 默认白名单：原生工具去掉写类（write/edit）。shell 名平台互斥（win32=pwsh、其余=bash），
+*  必须从 NATIVE_TOOL_NAMES 派生不可写死——宿主 tools.restrict 对未知名响亮失败。 */
+const EXPLORER_READONLY_ALLOW = NATIVE_TOOL_NAMES.filter((n) => n !== "write" && n !== "edit");
 const BUILTIN_AGENTS = [
 	{
 		id: "main",
@@ -74,7 +109,8 @@ const BUILTIN_AGENTS = [
 		persona: `你是代码库探索员。快速定位与任务相关的文件与符号，回答关于代码结构、
 调用关系、实现位置的问题。你只读不写：不修改任何文件、不运行有副作用的命令。
 输出结论清单，每条附文件路径与行号；信息不足时说明缺口，不要猜测。`,
-		builtin: true
+		builtin: true,
+		tools: { allow: [...EXPLORER_READONLY_ALLOW] }
 	},
 	{
 		id: "general",
@@ -97,20 +133,16 @@ const RoleYamlSchema = z$1.object({
 	persona: z$1.string().min(1),
 	provider: z$1.string().optional(),
 	model: z$1.string().optional(),
-	tools: z$1.object({
-		allow: z$1.array(z$1.string()).optional(),
-		deny: z$1.array(z$1.string()).optional()
-	}).optional()
+	tools: z$1.object({ allow: z$1.array(z$1.string()).optional() }).optional()
 });
 /**
 * 解析校验单个角色 YAML 文件并转成 AgentRecord。
 * @param text - 文件内容。
 * @param source - 用于错误信息的来源名（通常是文件路径）。
 * @param fileName - 文件名（去 .yml），name 省略时的取值；显式 name 须与它一致。
-* @param warn - 非致命丢弃（如 tools.deny）的通知通道。
 * @throws YAML 语法错误、结构非法、name 与文件名不一致、id 非法、tools 空。
 */
-function parseRoleYaml(text, source, fileName, warn) {
+function parseRoleYaml(text, source, fileName) {
 	let parsed;
 	try {
 		parsed = yaml.load(text);
@@ -127,8 +159,7 @@ function parseRoleYaml(text, source, fileName, warn) {
 	const id = raw.name ?? fileName;
 	if (raw.name !== void 0 && raw.name !== fileName) throw new Error(`dsh-agent-toolkit: 角色文件 ${source} 的 name "${raw.name}" 与文件名 "${fileName}" 不一致（省略 name 即取文件名）`);
 	if (!AGENT_ID_RE.test(id)) throw new Error(`dsh-agent-toolkit: 角色 id "${id}" 非法（${source}）：只允许小写字母、数字、-，且以小写字母开头`);
-	if (hasTools && raw.tools !== void 0 && (raw.tools.allow?.length ?? 0) === 0 && (raw.tools.deny?.length ?? 0) === 0) throw new Error(`dsh-agent-toolkit: 角色文件 ${source} 的 tools 为空：allow/deny 至少配一个`);
-	if (raw.tools?.deny !== void 0 && raw.tools.deny.length > 0) warn?.(`dsh-agent-toolkit: 角色文件 ${source} 的 tools.deny 已忽略（注册表仅支持 allow 白名单）`);
+	if (hasTools && raw.tools !== void 0 && (raw.tools.allow?.length ?? 0) === 0) throw new Error(`dsh-agent-toolkit: 角色文件 ${source} 的 tools 为空：allow 至少配一个（不需要限制请整段省略 tools）`);
 	const model = raw.provider !== void 0 && raw.model !== void 0 ? {
 		provider: raw.provider,
 		model: raw.model
@@ -186,7 +217,7 @@ async function importRolesYaml(ctx, rolesDir) {
 		return result;
 	}
 	for (const ref of refs) try {
-		const record = parseRoleYaml(await readFile(ref.path, "utf8"), ref.path, ref.fileName, ctx.warn);
+		const record = parseRoleYaml(await readFile(ref.path, "utf8"), ref.path, ref.fileName);
 		await ctx.agents.put(record.id, record);
 		result.imported++;
 	} catch (error) {
@@ -200,47 +231,17 @@ async function markImported(ctx) {
 	await ctx.meta.put(ROLES_YAML_IMPORTED_KEY, { value: "1" });
 }
 //#endregion
-//#region src/channels/basic-tools.ts
-const BASIC_TOOLS = [
-	{
-		id: "@deepseek-ai/dsh-persona",
-		config: { text: "You are a coding agent powered by the {{model}} model. Your working directory is {{cwd}}." }
-	},
-	{
-		id: "@deepseek-ai/dsh-agent-instructions",
-		config: { maxBytes: 65536 }
-	},
-	...process.platform === "win32" ? [{ id: "@deepseek-ai/dsh-tool-pwsh" }] : [{ id: "@deepseek-ai/dsh-tool-bash" }],
-	{ id: "@deepseek-ai/dsh-tool-fs" },
-	{
-		id: "@deepseek-ai/dsh-tool-fs-search",
-		config: { sampleOverCapGlobResults: false }
-	}
-];
-/** 原生工具名（白名单 UI 与存量迁移用）：与 BASIC_TOOLS 挂载插件注册的工具名一一对应。
-*  名字来源（摘自 deepseek-harness 源码）：dsh-tool-pwsh/dsh-tool-bash → 'pwsh'/'bash'（平台互斥）；
-*  dsh-tool-fs → 'read'/'write'/'edit'/'read_image'；dsh-tool-fs-search → 'glob'/'grep'。
-*  这些工具 scoped 挂载在 agentCtx，不出现在顶层 ctx.tools.schemas()，故需显式常量。 */
-const NATIVE_TOOL_NAMES = [
-	process.platform === "win32" ? "pwsh" : "bash",
-	"read",
-	"write",
-	"edit",
-	"read_image",
-	"glob",
-	"grep"
-];
-//#endregion
 //#region src/agents/registry.ts
 /** tools.allow 一次性并入原生工具名的 meta 表标记键。 */
 const TOOLS_NATIVE_MIGRATED_KEY = "tools_native_migrated";
+/** explorer 只读白名单一次性并入的 meta 表标记键。 */
+const EXPLORER_READONLY_MIGRATED_KEY = "explorer_readonly_migrated";
 /**
-* 打开 dsh_agent_toolkit 域 → 缺 main/explorer/general 时种入内置 → 首启 YAML 导入 →
-* 构建内存缓存。域由 apply 统一 open（storage-domain 同名单开），此处只消费表句柄。
+* 打开 dsh_agent_toolkit 域 → 首启 YAML 导入 → 旧记录迁移（promptLayers/原生并入/explorer 只读）→
+* 缺 main/explorer/general 时种入内置 → 构建内存缓存。域由 apply 统一 open（storage-domain 同名单开），此处只消费表句柄。
 */
 async function createRegistry(warn, tables) {
 	const { agents, meta } = tables;
-	await seedBuiltins(agents);
 	await importRolesYaml({
 		agents,
 		meta,
@@ -260,6 +261,15 @@ async function createRegistry(warn, tables) {
 		if (next !== record) await agents.put(id, next);
 	}
 	if (!nativeMigrated) await meta.put(TOOLS_NATIVE_MIGRATED_KEY, { value: "1" });
+	if (!(meta.get("explorer_readonly_migrated") !== void 0)) {
+		const explorer = agents.get("explorer");
+		if (explorer !== void 0 && explorer.tools === void 0) await agents.put("explorer", {
+			...explorer,
+			tools: { allow: [...EXPLORER_READONLY_ALLOW] }
+		});
+		await meta.put(EXPLORER_READONLY_MIGRATED_KEY, { value: "1" });
+	}
+	await seedBuiltins(agents);
 	const cache = /* @__PURE__ */ new Map();
 	for (const [id, record] of agents.entries()) cache.set(id, record);
 	const listeners = /* @__PURE__ */ new Set();
@@ -1192,7 +1202,7 @@ function withPartialText(error, output) {
 	return text.length === 0 ? error : `${error}\n成员中断前的部分产出：\n${text}`;
 }
 /** 收集并释放一次前台运行；dispose 失败不掩盖独立的结果失败。 */
-async function settleForegroundRun(run, roleId) {
+async function settleForegroundRun(run, roleId, route) {
 	const childSessionId = String(run.id);
 	const [execution] = await Promise.allSettled([run.result.then((result) => {
 		const error = stopReasonError(result);
@@ -1202,7 +1212,11 @@ async function settleForegroundRun(run, roleId) {
 			role: roleId,
 			runId: String(run.id),
 			childSessionId,
-			output: result.output
+			output: result.output,
+			...route !== void 0 ? {
+				provider: route.provider,
+				model: route.model
+			} : {}
 		};
 	})]);
 	const [disposal] = await Promise.allSettled([Promise.resolve().then(() => run.dispose())]);
@@ -1269,7 +1283,9 @@ function createDelegateTool(toolName, deps) {
 						type: "array",
 						required: true,
 						items: { type: "json" }
-					}
+					},
+					provider: { type: "string" },
+					model: { type: "string" }
 				}
 			},
 			render: (_args, value) => [{
@@ -1279,7 +1295,11 @@ function createDelegateTool(toolName, deps) {
 			presentationMeta: (_args, value) => ({
 				role: value.role,
 				runId: value.runId,
-				childSessionId: value.childSessionId
+				childSessionId: value.childSessionId,
+				...typeof value.provider === "string" && typeof value.model === "string" ? {
+					provider: value.provider,
+					model: value.model
+				} : {}
 			})
 		},
 		isConcurrencySafe: () => true,
@@ -1312,7 +1332,19 @@ function createDelegateTool(toolName, deps) {
 				} } : {},
 				...role.tools !== void 0 ? { toolFilter: { allow: [...role.tools.allow] } } : {}
 			};
-			return settleForegroundRun(await deps.startRun(deps.provider, request), role.id);
+			const route = (role.model !== void 0 && role.model.provider !== "" && role.model.model !== "" ? role.model : void 0) ?? (typeof parent.options.provider === "string" && parent.options.provider !== "" && typeof parent.options.model === "string" && parent.options.model !== "" ? {
+				provider: parent.options.provider,
+				model: parent.options.model
+			} : void 0);
+			const parentSessionId = String(parent.session.id);
+			if (route !== void 0) deps.active.set(parentSessionId, role.id, route);
+			try {
+				const run = await deps.startRun(deps.provider, request);
+				if (route !== void 0) await deps.recordRoute(String(run.id), route).catch(() => void 0);
+				return await settleForegroundRun(run, role.id, route);
+			} finally {
+				if (route !== void 0) deps.active.delete(parentSessionId, role.id);
+			}
 		}
 	});
 }
@@ -1326,7 +1358,7 @@ const TEAM_SECTION_ORDER = 116.6;
 * 工具随 provider 在场与否挂载/摘除。名册来自注册表（main 排除），工具与提示段都经
 * 闭包读取 registry，UI 改角色后新会话即生效。
 */
-function setupDelegate(ctx, config, registry) {
+function setupDelegate(ctx, config, registry, channels) {
 	const { provider, toolName } = config;
 	let disposeTool;
 	let providerFailed = false;
@@ -1339,7 +1371,9 @@ function setupDelegate(ctx, config, registry) {
 			roster: () => registry.list(),
 			provider,
 			buildPersona: (role) => buildAgentPersona({ rules: config.rules }, role, role.model),
-			startRun: (pr, request) => ctx.subagents.start(pr, request)
+			startRun: (pr, request) => ctx.subagents.start(pr, request),
+			active: channels.active,
+			recordRoute: channels.recordRoute
 		}));
 	};
 	ctx.on("subagent/provider-added", (p) => {
@@ -1372,6 +1406,86 @@ function setupDelegate(ctx, config, registry) {
 	});
 }
 //#endregion
+//#region src/delegate/active.ts
+function createActiveRoutes() {
+	const map = /* @__PURE__ */ new Map();
+	const key = (sessionId, roleId) => `${sessionId}:${roleId}`;
+	return {
+		set: (sessionId, roleId, route) => {
+			map.set(key(sessionId, roleId), route);
+		},
+		get: (sessionId, roleId) => map.get(key(sessionId, roleId)),
+		delete: (sessionId, roleId) => {
+			map.delete(key(sessionId, roleId));
+		}
+	};
+}
+//#endregion
+//#region src/delegate/routes.ts
+/** 委派路由持久存储域：子会话头部 chip 的数据源（schema 与 domain 布局的单一来源在本文件）。 */
+const DelegationRouteRecordSchema = z$1.object({
+	provider: z$1.string(),
+	model: z$1.string(),
+	at: z$1.number()
+});
+const delegationRoutesDomain = defineDomain({
+	name: "dsh_agent_toolkit_routes",
+	version: 1,
+	tables: { routes: domainTable(DelegationRouteRecordSchema) }
+});
+//#endregion
+//#region src/delegate/api.ts
+function createDelegateApiHandler(deps) {
+	return async (req, res) => {
+		const url = new URL(req.url ?? "/", "http://127.0.0.1");
+		const sub = url.pathname.replace(/^\/dsh-agent-toolkit\/api/, "") || "/";
+		if (req.method !== "GET") {
+			json$1(res, 405, { error: "method not allowed" });
+			return;
+		}
+		if (sub === "/delegate/active") {
+			const route = deps.active.get(url.searchParams.get("session") ?? "", url.searchParams.get("role") ?? "");
+			if (route === void 0) {
+				json$1(res, 404, { error: "not found" });
+				return;
+			}
+			json$1(res, 200, {
+				provider: route.provider,
+				model: route.model
+			});
+			return;
+		}
+		if (sub === "/delegate/route") {
+			const record = deps.routes.get(url.searchParams.get("session") ?? "");
+			if (record === void 0) {
+				json$1(res, 404, { error: "not found" });
+				return;
+			}
+			json$1(res, 200, {
+				provider: record.provider,
+				model: record.model
+			});
+			return;
+		}
+		json$1(res, 404, { error: "not found" });
+	};
+}
+/**
+* 注册 delegate 路由（恒启用，与 agents 同策略）。webServer 为可选服务：
+* 缺席时经 registerOptionalRoutes 惰性不注册。prefix 先于 /api 兜底前缀命中。
+*/
+function setupDelegateApi(ctx, deps) {
+	const handler = createDelegateApiHandler(deps);
+	registerOptionalRoutes(ctx, (webCtx) => {
+		const unregister = webCtx.webServer.register({
+			kind: "prefix",
+			path: "/dsh-agent-toolkit/api/delegate",
+			handler
+		});
+		return () => unregister();
+	});
+}
+//#endregion
 //#region src/agents/api.ts
 function createAgentsApiHandler(deps) {
 	return async (req, res) => {
@@ -1498,6 +1612,59 @@ function setupAgentsApi(ctx, deps) {
 	});
 }
 //#endregion
+//#region src/agents/create-command.ts
+/** 拼装 /create-agent 的引导文本（模型面契约，文案为规格锁定内容）。 */
+function buildCreateAgentGuidance(input) {
+	const lines = [
+		"# 交互式创建 Agent 团队成员",
+		"",
+		"## 工作流（三步）",
+		"1. 澄清需求：需求不明确时用 ask_user_question 向用户提问，整个流程提问总次数不超过 5 次，不重复问已确认的信息；",
+		"2. 生成推荐并请用户确认：推荐 id / name / description / persona / tools 五个字段（id 是团队内唯一标识，name 是显示名，description 是职责一句话描述，persona 是系统提示词个性段，tools 是工具白名单）；",
+		"3. 迭代：用户有修改意见时按意见修订名称、描述、个性和工具后再次确认，直到用户明确确认。"
+	];
+	if (input.requirement !== "") lines.push("", "## 用户初始需求", `用户已在命令中提供初始需求：「${input.requirement}」。请据此减少提问轮次，仅就不明确的点提问。`);
+	lines.push("", "## 现有 Agent id（不可复用）", input.agentIds.join(", "), "id 规则：小写字母开头，仅含小写字母/数字/连字符（[a-z0-9-]），最长 32 字符。", "", "## 可用工具清单", `原生工具：${NATIVE_TOOL_NAMES.join(", ")}`, `全局工具：${input.globalTools.join(", ")}`, "省略 tools 字段表示不限制（Agent 可使用全部工具）。一旦给出白名单，该 Agent 只有列出的工具可用：通常应保留原生工具，否则失去读文件/搜索/执行命令等基本能力（最终取舍按需求判断，如只读角色可去掉 write/edit）。");
+	if (input.origin === void 0) lines.push("", "## 落库", "当前宿主无 web 服务，无法自动落库。用户确认推荐后，请把最终配置完整输出给用户，并提示其打开 Agents 面板按推荐内容手动创建。");
+	else lines.push("", "## 落库（用户明确确认后执行）", "用你的 shell 工具调用 Agents 面板同一 HTTP 端点完成创建：", `1. 先 GET ${input.origin}/dsh-agent-toolkit/api/agents 复核所选 id 仍未被占用；`, `2. 再 PUT ${input.origin}/dsh-agent-toolkit/api/agents/<id>，请求体为 JSON（不要在 body 中携带 id 或 builtin 字段）：`, "   {\"name\":\"...\",\"description\":\"...\",\"persona\":\"...\",\"tools\":{\"allow\":[\"...\"]}}", "   （description/persona/tools 均可省略；省略 tools 表示不限制）", "3. curl 示例（Windows 的 pwsh 里用 curl.exe）：", `   curl.exe -s -X PUT "${input.origin}/dsh-agent-toolkit/api/agents/<id>" -H "Content-Type: application/json" -d "{\\"name\\":\\"...\\"}"`, `4. 返回 200 后必须再 GET ${input.origin}/dsh-agent-toolkit/api/agents，在返回列表中找到该 id 的记录，把它的 name/description/persona/tools 关键字段展示给用户，作为落库证据；`, "5. 落库成功后告知用户可在 Agents 面板查看、并可被 team_delegate 委派；任一步返回 4xx 则把错误信息展示给用户，修正后重试。");
+	return lines.join("\n");
+}
+/**
+* 注册 /create-agent。webServer 为可选服务按仓库规则经 ctx.get 读取（不进 inject），
+* 缺席（headless/CLI）时 origin 为 undefined，引导文本落库节降级为手动创建指引。
+*
+* 命令结果（command/done）是 log-only、不进模型：引导文本必须经 agent.followup
+* 投递为 user 消息驱动主 Agent（与 channels/inbound.ts 同一机制），命令卡只回执短文案。
+*/
+function setupCreateAgentCommand(ctx, deps) {
+	ctx.commands.register({
+		name: "create-agent",
+		description: "交互式创建 Agent 团队成员：访谈澄清需求 → 推荐配置 → 确认后经面板 API 落库",
+		input: { hint: "初始需求描述，可空" },
+		handler: ({ rawInput, agent }) => {
+			const webServer = ctx.get("webServer");
+			const origin = webServer === void 0 ? void 0 : `http://127.0.0.1:${webServer.port}`;
+			const text = buildCreateAgentGuidance({
+				requirement: rawInput.trim(),
+				agentIds: deps.registry.list().map((agent) => agent.id),
+				globalTools: deps.listTools(),
+				origin
+			});
+			agent.followup(createUserMessage({
+				content: [{
+					type: "text",
+					text
+				}],
+				source: { kind: "user" }
+			}));
+			return {
+				kind: "success",
+				text: "已向主 Agent 发出创建 Agent 引导，请继续对话完成访谈与确认。"
+			};
+		}
+	});
+}
+//#endregion
 //#region src/channels/agent-setup.ts
 /** bot 会话角色 persona 的 scoped 段名：与全局 persona 层同名，scoped 注册即 shadow 覆盖主 Agent persona。 */
 const TOOLKIT_PERSONA_SECTION = "prompt-stack:persona";
@@ -3027,6 +3194,125 @@ function setupBots(ctx, config, deps) {
 	});
 }
 //#endregion
+//#region src/agents/team-preset.ts
+/**
+* Agent 团队 preset 自动生成：派生宿主当前 shipped standard composition，
+* 文本级禁用 subagent 工具族 4 个行，写入首个 trust=user 的 preset root。
+* 设计：docs/superpowers/specs/2026-09-02-agent-team-preset-design.md
+*/
+/** 禁用目标行：覆盖与 team_delegate 竞争/配套的 5 个模型可见工具所属的 4 个行。 */
+const TEAM_PRESET_DISABLED_ROWS = [
+	"tool-subagent",
+	"tool-subagent-fork",
+	"tool-subagent-control",
+	"tool-subagent-list-agents"
+];
+/**
+* 文本级锚点改写：对 4 个目标行各插入一行 `disabled: true`（缩进 = 锚点缩进 + 2 空格）。
+* 锚点是整行精确匹配 `- id: <行id>`（忽略首尾空白），防 tool-subagent 误中
+* tool-subagent-fork / tool-subagent-control 前缀；锚点所属块内（锚点行之后、
+* 首个缩进 <= 锚点缩进的非空行之前）已有 `disabled:` 键则跳过——既幂等，也避免
+* 与宿主已有的 `disabled: !!js ...` 撞出 YAML 重复键。锚点缺失 warn 并跳过该锚点，
+* 其余照常。除插入行外文本逐字节不变。
+*/
+function disableSubagentRows(source, warn) {
+	const lines = source.split("\n");
+	for (const row of TEAM_PRESET_DISABLED_ROWS) {
+		const anchor = `- id: ${row}`;
+		const index = lines.findIndex((line) => line.trim() === anchor);
+		if (index === -1) {
+			warn(`dsh-agent-toolkit: agent-team preset 锚点行 "${anchor}" 在源 composition 中缺失，已跳过`);
+			continue;
+		}
+		const indent = lines[index].length - lines[index].trimStart().length;
+		let hasDisabled = false;
+		for (let i = index + 1; i < lines.length; i += 1) {
+			const line = lines[i];
+			if (line.trim() === "") continue;
+			if (line.length - line.trimStart().length <= indent) break;
+			if (/^\s*disabled\s*:/.test(line)) {
+				hasDisabled = true;
+				break;
+			}
+		}
+		if (hasDisabled) continue;
+		lines.splice(index + 1, 0, `${" ".repeat(indent + 2)}disabled: true`);
+	}
+	return lines.join("\n");
+}
+const COMPOSITION_FILE = "agent.cordis.yml";
+const METADATA_FILE = "preset.yml";
+/**
+* 生成目录的归属标记：无此标记的同名目录视为用户手工 preset，不覆盖。
+* 标记必须在 mkdir 后最先写入（marker-first）：这样写 composition/metadata 失败留下的是
+* 带标记的半成品目录，下次启动会被正常重写自愈；若最后才写标记，则半成品目录无标记、
+* 会被误判为用户手工 preset 而永久卡死不覆盖。
+*/
+const MARKER_FILE = ".generated-by";
+const MARKER_CONTENT = "dsh-agent-toolkit";
+/** 镜像宿主 PRESET_ID：preset id 即目录名，正则白名单是路径逃逸的 containment 边界。 */
+const PRESET_ID = /^[a-z0-9][a-z0-9-]*$/;
+const GENERATED_HEADER = "# 本文件由 dsh-agent-toolkit 自动生成，勿手改（每次启动重写）。\n";
+/**
+* 启动时生成/刷新 agent-team preset。所有失败路径 warn 降级，不影响插件其余功能。
+* 不设为默认 preset、卸载不删目录（可能有会话在用；composition 不引用 toolkit 行，
+* 残留 preset 自身仍可用）。每次启动重写：standing mount 按文件代际，重写只影响新会话。
+*/
+async function setupAgentTeamPreset(ctx, config) {
+	if (!config.enabled) return;
+	const warn = (msg) => {
+		ctx.logger.warn(msg);
+	};
+	const agentPresets = ctx.get("agentPresets", false);
+	if (agentPresets === void 0) return;
+	if (!PRESET_ID.test(config.id)) {
+		warn(`dsh-agent-toolkit: agentTeamPreset.id "${config.id}" 不是合法 preset id，跳过 agent-team 生成`);
+		return;
+	}
+	let source;
+	try {
+		source = await agentPresets.read(config.source);
+	} catch (error) {
+		warn(`dsh-agent-toolkit: 读取源 preset "${config.source}" 失败，跳过 agent-team 生成：${error instanceof Error ? error.message : String(error)}`);
+		return;
+	}
+	const root = agentPresets.roots.find((r) => r.trust === "user");
+	if (root === void 0) {
+		warn("dsh-agent-toolkit: preset roots 中无 trust=user 的目录，跳过 agent-team 生成");
+		return;
+	}
+	const composition = GENERATED_HEADER + disableSubagentRows(source, warn);
+	const dir = join(resolve(expandHomePath(root.path)), config.id);
+	try {
+		const markerPath = join(dir, MARKER_FILE);
+		let dirExists = true;
+		try {
+			await access(dir);
+		} catch {
+			dirExists = false;
+		}
+		if (dirExists) {
+			let marked = false;
+			try {
+				marked = (await readFile(markerPath, "utf8")).trim() === MARKER_CONTENT;
+			} catch {}
+			if (!marked) {
+				warn(`dsh-agent-toolkit: ${dir} 已存在且非本插件生成，不覆盖，跳过 agent-team 生成`);
+				return;
+			}
+		}
+		await mkdir(dir, { recursive: true });
+		await writeFile(markerPath, `${MARKER_CONTENT}\n`, "utf8");
+		await writeFile(join(dir, COMPOSITION_FILE), composition, "utf8");
+		await writeFile(join(dir, METADATA_FILE), yaml.dump({
+			name: config.name,
+			description: config.description
+		}, { lineWidth: -1 }), "utf8");
+	} catch (error) {
+		warn(`dsh-agent-toolkit: 写入 agent-team preset 失败（${dir}）：${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+//#endregion
 //#region src/index.ts
 const name = "dsh-agent-toolkit";
 const inject = [
@@ -3081,6 +3367,19 @@ const Config = z.object({
 		registerAppTimeoutMs: 6e5,
 		processingReactionEmoji: "OneSecond",
 		errorDetailMaxChars: 500
+	}),
+	agentTeamPreset: z.object({
+		enabled: z.boolean().default(true),
+		id: z.string().default("agent-team"),
+		source: z.string().default("standard"),
+		name: z.string().default("Agent 团队"),
+		description: z.string().default("Agent 团队模式：禁用原生 subagent 工具族，委派统一走 team_delegate 团队角色")
+	}).default({
+		enabled: true,
+		id: "agent-team",
+		source: "standard",
+		name: "Agent 团队",
+		description: "Agent 团队模式：禁用原生 subagent 工具族，委派统一走 team_delegate 团队角色"
 	})
 });
 async function apply(ctx, config) {
@@ -3107,14 +3406,30 @@ async function apply(ctx, config) {
 		source: layerSource,
 		rules: config.rules
 	});
+	const routesTable = (await openDomainSafely(ctx, delegationRoutesDomain, warn)).table("routes");
+	const activeRoutes = createActiveRoutes();
 	setupDelegate(ctx, {
 		provider: config.provider,
 		toolName: config.toolName,
 		rules: config.rules
-	}, registry);
+	}, registry, {
+		active: activeRoutes,
+		recordRoute: async (childSessionId, route) => {
+			await routesTable.put(childSessionId, {
+				provider: route.provider,
+				model: route.model,
+				at: Date.now()
+			});
+		}
+	});
+	setupDelegateApi(ctx, {
+		active: activeRoutes,
+		routes: routesTable
+	});
+	const listTools = () => ctx.tools.schemas().map((s) => s.name);
 	setupAgentsApi(ctx, {
 		registry,
-		listTools: () => ctx.tools.schemas().map((s) => s.name),
+		listTools,
 		listProviders: () => ctx.llm.listProviders().map(({ id, name }) => ({
 			id,
 			name
@@ -3124,6 +3439,10 @@ async function apply(ctx, config) {
 			name
 		})))
 	});
+	setupCreateAgentCommand(ctx, {
+		registry,
+		listTools
+	});
 	setupPromptLayersApi(ctx, {
 		source: layerSource,
 		rules: config.rules,
@@ -3142,6 +3461,7 @@ async function apply(ctx, config) {
 			};
 		}
 	});
+	await setupAgentTeamPreset(ctx, config.agentTeamPreset);
 	if (config.modules.feishu) setupBots(ctx, config.feishu, { registry });
 	if (config.modules.usage) setupUsage(ctx, { timezone: config.timezone }, name);
 }