dsh-plugin-prompt-tool 0.6.2 → 0.7.1

package/lib/index.mjs

@@ -1,9 +1,8 @@
-import { C as userPresetsDir, D as DEFAULT_SKILLS_DIR, E as DEFAULT_RESIDENT_AGENTS_PATH, O as LEGACY_CONTAINER_DIR, S as savePresetParams, T as DEFAULT_PRESET_DIR, _ as readPluginState, a as asString, b as resolvePresetDir, c as duplicateUserPreset, d as listPresets, f as loadPresetContent, g as parseImportedPresetId, h as packageEngineDir, i as applyModuleConfigs, k as LEGACY_USER_PRESETS_DIR, l as ensurePresetSeed, m as openPresetLocation, n as mergePromptConfigs, o as assertCompositionArray, p as loadPresetSpec, r as renderPromptConfigYaml, s as cloneBuiltinPreset, t as loadPromptConfigFiles, u as listBuiltinTemplates, v as removeUserPreset, w as writePluginState, x as resolvePresetParams, y as renderComposition } from "./prompt-configs-BgFw_bFf.mjs";
-import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { A as DEFAULT_SKILLS_DIR, C as resolvePresetParams, D as writePluginState, E as withPresetDoc, M as LEGACY_USER_PRESETS_DIR, O as DEFAULT_PRESET_DIR, S as resolvePresetDir, T as userPresetsDir, _ as packageEngineDir, a as applyModuleConfigs, b as removeUserPreset, c as buildModuleConfigsFromParams, d as ensurePresetSeed, f as listBuiltinTemplates, g as openPresetLocation, h as loadPresetSpec, i as MODEL_SEGMENT_MAP, j as LEGACY_CONTAINER_DIR, k as DEFAULT_RESIDENT_AGENTS_PATH, l as cloneBuiltinPreset, m as loadPresetContent, n as mergePromptConfigs, o as asString, p as listPresets, r as renderPromptConfigYaml, s as assertCompositionArray, t as loadPromptConfigFiles, u as duplicateUserPreset, v as parseImportedPresetId, w as savePresetParams, x as renderComposition, y as readPluginState } from "./prompt-configs-BnQKRHVb.mjs";
 import { appendFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
-import { parse, parseDocument, stringify } from "yaml";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
+import { parse, parseDocument, stringify } from "yaml";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomBytes } from "node:crypto";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -551,23 +550,20 @@ function installSubagentModelRoute(ctx, isEnabled, provider, model) {
 	});
 }
 //#endregion
-//#region src/shared/param-keys.ts
+//#region src/shared/engine-params.ts
 /**
-* 引擎行为参数键（按预设存储：激活预设 preset.yml 的 params + promptConfigs）。
-* 不进 Config schema、不进 settings namespace——每预设一份，随预设走（官方范式：
-* Config = 部署轴，引擎行为在预设文件）。
-*
-* 这些键在 UI 有专门编辑入口（模型设置 / 工具与深度 / 开关），writePreset 把
-* 预设级 params 合并进每条 promptConfig 的 params 时排除——「params（高级参数
-* JSON）」框只保留内容变量与配置自身策略参数，避免 UI 已管理的参数冗余回写。
-* 放 shared：host（write-preset）与 config/settings-bridge 共用，单一来源。
+* 引擎行为参数键唯一权威（数组字面量 = 运行时事实）。
+* 与 EngineParams 接口双向相等断言：新增参数必须同时改接口与列表，漏改任一侧
+* typecheck 失败（防历史事故：PARAM_KEYS 漏 25 键混入 variables.yml 污染注入）。
 */
-const PARAM_KEYS = /* @__PURE__ */ new Set([
+const ENGINE_PARAM_KEYS = [
 	"firstTurnAnchor",
 	"firstTurnText",
 	"firstTurnCustom",
 	"guideText",
 	"guideCustom",
+	"guideEnabled",
+	"injectPrompt",
 	"modelProvider",
 	"modelName",
 	"subagentModelProvider",
@@ -578,7 +574,6 @@ const PARAM_KEYS = /* @__PURE__ */ new Set([
 	"subagentReasoningEffort",
 	"subagentTemperature",
 	"subagentMaxTokens",
-	"subagentPersona",
 	"toolFilterAllow",
 	"toolFilterDeny",
 	"maxDepth",
@@ -586,13 +581,147 @@ const PARAM_KEYS = /* @__PURE__ */ new Set([
 	"firstTurnWord",
 	"bootstrapMaxTokens",
 	"usePtcMode",
+	"promoteGate",
+	"promoteAfterFirstResponse",
+	"maxPromoteSteps",
+	"bootstrapTools",
+	"compactionTools",
+	"personaSectionsOnly",
+	"workspaceLine",
+	"phase1FirstCallInstruction",
+	"messageSources",
+	"deferredSources",
+	"deferredGraceSteps",
+	"instructionHint",
+	"stages",
+	"stagePreUnlock",
+	"stageAdvanceTool",
+	"stageAdvanceDescription",
+	"stageSectionTemplate",
+	"toolFilterSubagents",
+	"strReplaceEditorMaxOutputChars",
+	"anchorTurn",
+	"anchorTurnText",
+	"deliberationGate",
+	"deliberationMinChars",
+	"deliberationMaxGatesPerTurn",
+	"cotDrip",
+	"cotDripEvery",
+	"cotDripMaxPerTurn"
+];
+/** writePreset.runtimeOf 实际透传键（与 PresetWriterParams 双向相等断言，防 Pick 漏键）。 */
+const WRITER_PARAM_KEYS = [
+	"firstTurnAnchor",
+	"firstTurnText",
+	"firstTurnCustom",
+	"guideText",
+	"guideCustom",
+	"guideEnabled",
 	"injectPrompt",
+	"modelProvider",
+	"modelName",
+	"subagentModelProvider",
+	"subagentModelName",
+	"modelReasoningEffort",
+	"modelTemperature",
+	"modelMaxTokens",
+	"subagentReasoningEffort",
+	"subagentTemperature",
+	"subagentMaxTokens",
+	"toolFilterAllow",
+	"toolFilterDeny",
+	"maxDepth",
+	"allowKinds",
+	"firstTurnWord",
+	"bootstrapMaxTokens",
+	"usePtcMode",
+	"anchorTurn",
+	"anchorTurnText",
+	"deliberationGate",
+	"deliberationMinChars",
+	"deliberationMaxGatesPerTurn",
+	"cotDrip",
+	"cotDripEvery",
+	"cotDripMaxPerTurn"
+];
+const NUMERIC_PARAM_RULES = {
+	modelTemperature: validateTemperature,
+	subagentTemperature: validateTemperature,
+	modelMaxTokens: validateMaxTokens,
+	subagentMaxTokens: validateMaxTokens
+};
+function validateTemperature(value) {
+	return Number.isFinite(value) ? void 0 : "必须是有限数字";
+}
+function validateMaxTokens(value) {
+	return Number.isSafeInteger(value) && value > 0 ? void 0 : "必须是正整数";
+}
+/**
+* 校验参数键值（键集合合法性由调用方白名单先行校验）。返回逐字段错误；空数组 = 通过。
+* 类型收窄：只接受 number（preset.yml 手写数字）与 string（UI 字符串标量）；
+* '' 是合法删键值，其余空白串/非数字串/越界值在保存层响亮失败。
+*/
+function validateEngineParamValues(overrides) {
+	const errors = [];
+	for (const [key, value] of Object.entries(overrides)) {
+		const rule = NUMERIC_PARAM_RULES[key];
+		if (rule === void 0) continue;
+		if (value === void 0 || value === null || value === "") continue;
+		if (typeof value !== "number" && typeof value !== "string") {
+			errors.push({
+				key,
+				message: `${key}: 必须是数字或数字字符串（留空 = 不设置）`
+			});
+			continue;
+		}
+		const text = typeof value === "string" ? value.trim() : String(value);
+		if (text.length === 0) {
+			errors.push({
+				key,
+				message: `${key}: 必须是数字（留空 = 不设置）`
+			});
+			continue;
+		}
+		const numeric = Number(text);
+		const reason = Number.isNaN(numeric) ? "必须是数字" : rule(numeric);
+		if (reason !== void 0) errors.push({
+			key,
+			message: `${key}: ${reason}（留空 = 不设置）`
+		});
+	}
+	return errors;
+}
+//#endregion
+//#region src/shared/param-keys.ts
+/**
+* 引擎行为参数键（按预设存储：激活预设 preset.yml 的 params + promptConfigs）。
+* 不进 Config schema、不进 settings namespace——每预设一份，随预设走（官方范式：
+* Config = 部署轴，引擎行为在预设文件）。
+*
+* 派生自 ENGINE_PARAM_KEYS（唯一权威）+ 少量附加键：
+*  - 锚定/引导内容键：writePreset 映射进 near-anchor/router-guide 的 promptConfig
+*    params（策略消费），须排除出 variables.yml（避免同一键双落盘为模板变量）；
+*  - promptConfigs：settings 提示词配置数组键。
+* 注意：variables.yml 的占位键（spec.variables 空值登记，供世界书条目 {{key}} 动态
+* 引用）走另一套通道，不属于 PARAM_KEYS——两套体系不互串。
+* 放 shared：host（write-preset）与 config/settings-bridge 共用，单一来源。
+*/
+const EXTRA_PARAM_KEYS = [
+	"buildPattern",
+	"complexPattern",
+	"firstTurnBuild",
+	"firstTurnInspect",
+	"firstTurnDeep",
+	"guideComplexPattern",
+	"guideWeak",
+	"guideDeep",
 	"promptConfigs"
-]);
+];
+const PARAM_KEYS = /* @__PURE__ */ new Set([...ENGINE_PARAM_KEYS, ...EXTRA_PARAM_KEYS]);
 //#endregion
 //#region src/config.ts
 /** 插件配置、settings 数据模型与默认常量（settings 接口层）。 */
-const NS = settingsNamespace("prompt-tool");
+const NS = "prompt-tool";
 const Config = z.object({
 	injectAgentsPrompt: z.boolean().default(false),
 	writeAgents: z.boolean().default(true),
@@ -730,6 +859,20 @@ function loadPromptTemplates() {
 		};
 	});
 }
+/** 工具模板库扫描（templates/tools/*.yml；损坏 fail loud——包内模板属于发布 bug）。 */
+function loadToolTemplates() {
+	const dir = fileURLToPath(new URL("../templates/tools", import.meta.url));
+	return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isFile() && /\.ya?ml$/i.test(entry.name)).sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {
+		const content = readFileSync(join(dir, entry.name), "utf8");
+		const parsed = parse(content, { logLevel: "silent" });
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed) || typeof parsed.id !== "string" || parsed.id.length === 0 || typeof parsed.name !== "string" || parsed.execute === null || typeof parsed.execute !== "object") throw new Error(`tool template ${entry.name} must contain id/name/execute`);
+		return {
+			file: entry.name,
+			content,
+			spec: parsed
+		};
+	});
+}
 //#endregion
 //#region src/runtime/skill-fix.ts
 /**
@@ -850,6 +993,73 @@ function fixSkillEntry(skillsDir, folder) {
 	};
 }
 //#endregion
+//#region src/host/worldbook.ts
+/** 世界书条目 CRUD 服务：promptConfigs world-book 策略配置的增删改查。
+*  与角色卡导入（characters.applyCharacterToPreset）共用同一存储（preset.yml
+*  promptConfigs），模型工具（world_book_*）与未来 bridge 端点同源，
+*  不各自实现 parseDocument 往返。 */
+/**
+* 世界书条目结构工厂（能力归一）。
+* strategy/layer/position 固定值与 params 键集单一权威——ST 导入（sillytavern.ts）
+* 与模型工具（world_book_upsert）共用，不再各自手写条目结构。
+*/
+function buildWorldBookEntry(input) {
+	return {
+		...input.id !== void 0 ? { id: input.id } : {},
+		name: input.name,
+		strategy: "world-book",
+		order: typeof input.order === "number" ? input.order : 100,
+		text: input.text,
+		layer: "pre-step",
+		position: "before-all",
+		...input.enabled !== void 0 ? { enabled: input.enabled } : {},
+		params: {
+			constant: input.constant,
+			...input.keys !== void 0 && input.keys.length > 0 ? { keys: input.keys } : {},
+			...input.secondaryKeys !== void 0 && input.secondaryKeys.length > 0 ? { secondaryKeys: input.secondaryKeys } : {},
+			...input.caseSensitive === true ? { caseSensitive: true } : {},
+			...input.wholeWords === true ? { wholeWords: true } : {},
+			...typeof input.selectiveLogic === "number" ? { selectiveLogic: input.selectiveLogic } : {}
+		}
+	};
+}
+const isWorldBook = (config) => config !== null && typeof config === "object" && !Array.isArray(config) && config.strategy === "world-book";
+/** 当前预设全部世界书条目（保持文件顺序）。 */
+function listWorldBookEntries(presetDir) {
+	const spec = loadPresetSpec(presetDir);
+	return Array.isArray(spec.promptConfigs) ? spec.promptConfigs.filter(isWorldBook) : [];
+}
+/** 新增或更新一条世界书条目（按 id 定位；不存在则追加）。返回写入后条目总数。 */
+function upsertWorldBookEntry(presetDir, entry) {
+	if (entry === null || typeof entry !== "object" || typeof entry.id !== "string" || entry.id.length === 0) throw new TypeError("世界书条目必须含非空字符串 id");
+	let count = 0;
+	withPresetDoc(presetDir, (doc) => {
+		const current = doc.toJS();
+		const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
+		const existing = configs.findIndex((config) => String(config.id ?? "") === entry.id);
+		if (existing >= 0) configs[existing] = entry;
+		else configs.push(entry);
+		doc.setIn(["promptConfigs"], configs);
+		count = configs.filter(isWorldBook).length;
+	});
+	return count;
+}
+/** 删除一条世界书条目；不存在抛错。返回删除后条目总数。 */
+function deleteWorldBookEntry(presetDir, id) {
+	let count = 0;
+	let removed = false;
+	withPresetDoc(presetDir, (doc) => {
+		const current = doc.toJS();
+		const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
+		const kept = configs.filter((config) => !(isWorldBook(config) && String(config.id ?? "") === id));
+		removed = kept.length !== configs.length;
+		doc.setIn(["promptConfigs"], kept);
+		count = kept.filter(isWorldBook).length;
+	});
+	if (!removed) throw new Error(`世界书条目 ${id} 不存在`);
+	return count;
+}
+//#endregion
 //#region src/host/sillytavern.ts
 /**
 * SillyTavern 预设 → 本项目单文件预设转换引擎（纯函数，无文件 IO）。
@@ -1016,25 +1226,20 @@ function convertStToPreset(card, baseName) {
 			const secondaryKeys = Array.isArray(rawSecondary) ? rawSecondary.map(String).filter((key) => key.trim().length > 0) : [];
 			const constant = entry.constant === true || entry.add_always === true;
 			const enabled = entry.disable !== void 0 ? entry.disable !== true : entry.enabled !== false;
-			configs.push({
+			const stOrder = typeof entry.insertion_order === "number" ? entry.insertion_order : typeof entry.order === "number" ? entry.order : 100;
+			configs.push(buildWorldBookEntry({
 				id: `lore-${String(entry.id ?? entry.uid ?? index)}`,
 				name: comment,
 				enabled,
-				strategy: "world-book",
-				order: typeof entry.insertion_order === "number" ? entry.insertion_order : typeof entry.order === "number" ? entry.order : 100,
+				order: -stOrder,
 				text: content,
-				layer: "pre-step",
-				position: "before-all",
-				params: {
-					constant,
-					...keys.length > 0 ? { keys } : {},
-					...secondaryKeys.length > 0 ? { secondaryKeys } : {},
-					...(entry.case_sensitive ?? entry.caseSensitive) === true ? { caseSensitive: true } : {},
-					...(entry.match_whole_words ?? entry.matchWholeWords) === true ? { wholeWords: true } : {},
-					...(entry.use_regex ?? entry.useRegex) === true ? { useRegex: true } : {},
-					...typeof entry.selectiveLogic === "number" ? { selectiveLogic: entry.selectiveLogic } : typeof entry.selective_logic === "number" ? { selectiveLogic: entry.selective_logic } : {}
-				}
-			});
+				constant,
+				keys: keys.length > 0 ? keys : void 0,
+				secondaryKeys: secondaryKeys.length > 0 ? secondaryKeys : void 0,
+				...(entry.case_sensitive ?? entry.caseSensitive) === true ? { caseSensitive: true } : {},
+				...(entry.match_whole_words ?? entry.matchWholeWords) === true ? { wholeWords: true } : {},
+				...typeof entry.selectiveLogic === "number" ? { selectiveLogic: entry.selectiveLogic } : typeof entry.selective_logic === "number" ? { selectiveLogic: entry.selective_logic } : {}
+			}));
 		}
 	}
 	const firstMes = clean(bodyText("first_mes"));
@@ -1188,6 +1393,70 @@ function sortConfigs(configs) {
 		return (Number(a.order) || 0) - (Number(b.order) || 0);
 	});
 }
+/** 角色卡记忆条目字段（不含 id；id 由调用方加 chara-<卡>- 前缀）。 */
+function buildCharacterMemoryEntry(spec, memory) {
+	if (memory.trim().length === 0) return void 0;
+	return buildWorldBookEntry({
+		name: "角色记忆",
+		enabled: true,
+		order: 3e3,
+		text: `【${spec.name} 的关系记忆】\n${memory}`,
+		constant: true
+	});
+}
+/** 角色卡记忆变更后同步已导入预设的 chara-<id>-memory 注入条目
+*  （world_book note 写入卡记忆后调用；未导入当前预设的卡返回 synced=false）。 */
+function syncImportedCharacterMemory(presetRoot, templateName, cardId) {
+	if (!validCardId(cardId)) return {
+		ok: false,
+		message: `非法角色卡 id：${cardId}`
+	};
+	const spec = loadConverted(cardDir(presetRoot, cardId));
+	if (spec === void 0) return {
+		ok: false,
+		message: `角色卡 ${cardId} 不存在或参数损坏`
+	};
+	const memory = readCharacterMemory(presetRoot, cardId);
+	const memoryId = `chara-${cardId}-memory`;
+	let synced = false;
+	try {
+		withPresetDoc(join(presetRoot, templateName), (doc) => {
+			const current = doc.toJS();
+			if (!(Array.isArray(current.meta?.importedCharacters) ? current.meta.importedCharacters.map(String) : []).includes(cardId)) return;
+			const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
+			const entry = buildCharacterMemoryEntry(spec, memory);
+			const at = configs.findIndex((config) => config !== null && typeof config === "object" && String(config.id ?? "") === memoryId);
+			if (entry === void 0) {
+				if (at >= 0) {
+					configs.splice(at, 1);
+					synced = true;
+				}
+			} else if (at >= 0) {
+				configs[at] = {
+					...entry,
+					id: memoryId
+				};
+				synced = true;
+			} else {
+				configs.push({
+					...entry,
+					id: memoryId
+				});
+				synced = true;
+			}
+			if (synced) doc.setIn(["promptConfigs"], sortConfigs(configs));
+		});
+		return {
+			ok: true,
+			synced
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			message: `同步失败：${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+}
 /** 角色卡库根：预设根下的点前缀目录（官方 roster 扫描跳过，与 .engine 同机制）。 */
 function charactersDir(presetRoot) {
 	return join(presetRoot, ".characters");
@@ -1205,6 +1474,19 @@ function loadConverted(dir) {
 		return;
 	}
 }
+/** 追加角色卡本地记忆（.characters/<id>/memory.md，跟随角色卡跨预设）。 */
+function appendCharacterMemory(presetRoot, cardId, note) {
+	appendMemoryFile(join(cardDir(presetRoot, cardId), "memory.md"), note, "# 角色记忆");
+}
+/** 追加记忆文件（时间戳列表格式；header 标注文件类型）。世界书工具与角色卡共用。 */
+function appendMemoryFile(file, note, header = "# 本地记忆") {
+	const content = note.trim();
+	if (content.length === 0) return;
+	mkdirSync(dirname(file), { recursive: true });
+	const line = `\n- [${(/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ")}] ${content}\n`;
+	if (existsSync(file)) appendFileSync(file, line, "utf8");
+	else writeFileSync(file, `${header}\n${line}`, "utf8");
+}
 /** 读角色卡本地记忆文本（无记忆返回空串）。 */
 function readCharacterMemory(presetRoot, cardId) {
 	try {
@@ -1303,13 +1585,6 @@ function deleteCharacterCard(presetRoot, id) {
 		};
 	}
 }
-function withPresetDoc(presetRoot, templateName, mutate) {
-	const file = join(presetRoot, templateName, "preset.yml");
-	if (!existsSync(file)) throw new Error(`当前预设 ${templateName} 无 preset.yml`);
-	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
-	mutate(doc);
-	writeFileSync(file, doc.toString(), "utf8");
-}
 /** 角色卡参数导入当前预设：promptConfigs 合并（chara-<id>- 前缀防冲突）、
 *  params 合并（角色卡覆盖同键）、meta.importedCharacters 记录来源。 */
 function applyCharacterToPreset(presetRoot, templateName, cardId) {
@@ -1323,9 +1598,31 @@ function applyCharacterToPreset(presetRoot, templateName, cardId) {
 		message: `角色卡 ${cardId} 不存在或参数损坏`
 	};
 	const prefix = `chara-${cardId}-`;
+	const hasSystemSections = (spec.promptConfigs ?? []).some((config) => config !== null && typeof config === "object" && !Array.isArray(config) && config.layer === "system-section");
+	let personaOpened = false;
 	try {
-		withPresetDoc(presetRoot, templateName, (doc) => {
+		withPresetDoc(join(presetRoot, templateName), (doc) => {
 			const current = doc.toJS();
+			if (hasSystemSections) {
+				const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
+				const personaIdx = configs.findIndex((config) => {
+					if (config === null || typeof config !== "object" || Array.isArray(config)) return false;
+					const entry = config;
+					const params = entry.params;
+					return entry.id === "persona-main" || params?.sectionName === "deployment:persona";
+				});
+				if (personaIdx >= 0) {
+					if ((configs[personaIdx]?.params)?.complete === true) {
+						doc.setIn([
+							"promptConfigs",
+							personaIdx,
+							"params",
+							"complete"
+						], false);
+						personaOpened = true;
+					}
+				}
+			}
 			const existing = Array.isArray(current.promptConfigs) ? current.promptConfigs.filter((config) => {
 				return config !== null && typeof config === "object" && !String(config.id ?? "").startsWith(prefix);
 			}) : [];
@@ -1341,31 +1638,36 @@ function applyCharacterToPreset(presetRoot, templateName, cardId) {
 			for (const [key, value] of Object.entries(spec.params ?? {})) doc.setIn(["params", key], value);
 			const memory = readCharacterMemory(presetRoot, cardId);
 			const memoryId = `${prefix}memory`;
-			if (memory.length > 0) {
-				const memoryEntry = {
-					id: memoryId,
-					name: "角色记忆",
-					strategy: "world-book",
-					layer: "pre-step",
-					position: "before-all",
-					enabled: true,
-					order: 1e3,
-					text: `【${spec.name} 的关系记忆】\n${memory}`,
-					params: { constant: true }
-				};
-				doc.setIn(["promptConfigs"], sortConfigs([
-					...existing,
-					...added,
-					memoryEntry
-				]));
-			} else doc.setIn(["promptConfigs"], sortConfigs([...existing, ...added]));
+			const memoryEntry = buildCharacterMemoryEntry(spec, memory);
+			const merged = sortConfigs([
+				...existing,
+				...added,
+				...memoryEntry !== void 0 ? [{
+					...memoryEntry,
+					id: memoryId
+				}] : []
+			]);
+			if (hasSystemSections) {
+				const persona = merged.find((config) => {
+					if (config === null || typeof config !== "object" || Array.isArray(config)) return false;
+					const entry = config;
+					const params = entry.params;
+					return entry.id === "persona-main" || params?.sectionName === "deployment:persona";
+				});
+				if ((persona?.params)?.complete === true && persona !== void 0) {
+					persona.params.complete = false;
+					personaOpened = true;
+				}
+			}
+			doc.setIn(["promptConfigs"], merged);
 			const list = Array.isArray(current.meta?.importedCharacters) ? current.meta.importedCharacters : [];
 			if (!list.map(String).includes(cardId)) list.push(cardId);
 			doc.setIn(["meta", "importedCharacters"], list);
 		});
 		return {
 			ok: true,
-			count: (spec.promptConfigs ?? []).length
+			count: (spec.promptConfigs ?? []).length,
+			...personaOpened ? { personaOpened: true } : {}
 		};
 	} catch (error) {
 		return {
@@ -1385,7 +1687,7 @@ function removeCharacterFromPreset(presetRoot, templateName, cardId) {
 	const prefix = `chara-${cardId}-`;
 	try {
 		let removed = 0;
-		withPresetDoc(presetRoot, templateName, (doc) => {
+		withPresetDoc(join(presetRoot, templateName), (doc) => {
 			const current = doc.toJS();
 			const kept = (Array.isArray(current.promptConfigs) ? current.promptConfigs : []).filter((config) => {
 				const isCard = config !== null && typeof config === "object" && String(config.id ?? "").startsWith(prefix);
@@ -1412,14 +1714,15 @@ function removeCharacterFromPreset(presetRoot, templateName, cardId) {
 //#region src/shared/bridge-contract.ts
 /**
 * settings bridge 跨端契约（host 注册 / client 消费的唯一来源）。
-* 铁律：11 端点载荷统一成功 `{ ok: true, value }`、失败 `{ ok: false, code?, message? }`；
+* 铁律：25 端点载荷统一成功 `{ ok: true, value }`、失败 `{ ok: false, code?, message? }`；
 * 端点附加字段只能以 value 旁的可选扩展字段出现（describe）。
 * 改路径或载荷形状必须同步更新 test/shared/bridge-contract.test.mjs。
 */
 const SETTINGS_BRIDGE_PREFIX = "/api/prompt-tool/settings";
-/** 22 个桥端点路径（相对前缀）。新增端点必须同时登记到契约测试。 */
+/** 桥端点路径（相对前缀）。新增端点必须同时登记到契约测试。 */
 const BRIDGE_ENDPOINTS = {
 	meta: "/meta",
+	bootstrap: "/bootstrap",
 	describe: "/describe",
 	models: "/models",
 	mutate: "/mutate",
@@ -1431,6 +1734,7 @@ const BRIDGE_ENDPOINTS = {
 	importPreset: "/import-preset",
 	paramOverrides: "/param-overrides",
 	presetVariables: "/preset-variables",
+	customTools: "/custom-tools",
 	importPresetPackage: "/import-preset-package",
 	exportPreset: "/export-preset",
 	presetDelete: "/preset-delete",
@@ -1523,7 +1827,8 @@ function restorePresetImport(targetDir, backupDir) {
 	} catch {}
 }
 /** 自建 loopback settings bridge：替代 registerConfigurableProviders，避免模型设置区出现插件条目。 */
-function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngineStrategyDir, ensureRegistered, afterSkillFix, getPresetConfigsDir, afterPresetImport, afterOverridesChange, afterPresetPackageImport) {
+function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngineStrategyDir, afterSkillFix, getPresetConfigsDir, afterPresetImport, afterOverridesChange, afterPresetPackageImport) {
+	let invalidateCachedDescriptor = () => {};
 	ctx.inject(["settings", "webServer"], (sctx) => {
 		sctx.effect(() => {
 			let cachedDescriptor;
@@ -1540,6 +1845,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			const invalidateDescriptor = () => {
 				cachedDescriptor = void 0;
 			};
+			invalidateCachedDescriptor = invalidateDescriptor;
 			const guard = (req, res) => {
 				if (!isLoopbackRequest(req)) {
 					writeBridgeJson(res, 403, {
@@ -1559,19 +1865,149 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}
 				return true;
 			};
+			/** 引擎能力矩阵（meta 端点与 /bootstrap 共用）：动态 import 引擎 schema。 */
+			const loadEngineMeta = async () => {
+				const { getEngineMeta } = await import(new URL("../engine/schema.mjs", import.meta.url).href);
+				const meta = getEngineMeta();
+				meta.presets = listPresets();
+				meta.builtinTemplates = listBuiltinTemplates();
+				return meta;
+			};
+			/** describe 运行时事实（describe 端点与 /bootstrap 共用）：检测状态、技能快照、
+			*  宿主默认模型、模型目录缓存、激活预设参数。不触网（模型目录只读 10min 缓存）。 */
+			const collectDescribeExtras = () => {
+				const detection = getModelsState();
+				const skillsState = getSkillsState();
+				let hostDefaultModel;
+				try {
+					const selection = sctx.settings.get("agent-default-model");
+					if (selection !== null && typeof selection === "object") {
+						const record = selection;
+						hostDefaultModel = {
+							...typeof record.provider === "string" && record.provider.length > 0 ? { provider: record.provider } : {},
+							...typeof record.model === "string" && record.model.length > 0 ? { model: record.model } : {},
+							...typeof record.reasoningEffort === "string" && record.reasoningEffort.length > 0 ? { reasoningEffort: record.reasoningEffort } : {}
+						};
+						if (Object.keys(hostDefaultModel).length === 0) hostDefaultModel = void 0;
+					}
+				} catch {}
+				const modelCatalog = peekModelCatalog();
+				let presetParams = {};
+				let templatePreStepCount = 0;
+				try {
+					const activeDir = getPresetConfigsDir?.() ?? "";
+					const templateName = activeDir.length > 0 ? basename(activeDir) : "anchored";
+					const spec = loadPresetSpec(activeDir.length > 0 ? activeDir : resolvePresetDir(templateName));
+					presetParams = resolvePresetParams(spec, {});
+					if (Array.isArray(spec.promptConfigs)) presetParams.promptConfigs = spec.promptConfigs;
+					templatePreStepCount = (spec.promptConfigs ?? []).filter((config) => {
+						const layer = config.layer;
+						return layer === void 0 || layer === "pre-step";
+					}).length;
+				} catch {
+					templatePreStepCount = 0;
+				}
+				return {
+					presetParams,
+					hostDefaultModel,
+					templatePreStepCount,
+					modelsAvailable: detection.available,
+					providers: detection.providers,
+					modelCatalog,
+					modelsError: detection.error,
+					activeSkillsDirs: skillsState.activeSkillsDirs,
+					skillsDirExists: Object.fromEntries(skillsState.activeSkillsDirs.map((dir) => [dir, existsSync(dir)])),
+					skillCatalog: skillsState.skillCatalog
+				};
+			};
+			/** 激活预设的引擎参数子集（/param-overrides 读取；preset.yml 按 mtime 缓存）。 */
+			const readParamOverrides = (dir) => {
+				try {
+					const spec = loadPresetSpec(dir);
+					const params = {};
+					for (const key of PARAM_KEYS) {
+						if (key === "promptConfigs") continue;
+						if (spec.params !== null && typeof spec.params === "object" && key in spec.params) params[key] = spec.params[key];
+					}
+					return params;
+				} catch {
+					return {};
+				}
+			};
+			/** 预设级模板变量（/preset-variables 读取）。 */
+			const readPresetVariables = (dir) => {
+				try {
+					const spec = loadPresetSpec(dir);
+					const variables = {};
+					for (const [key, value] of Object.entries(spec.params ?? {})) if (!PARAM_KEYS.has(key) && typeof value === "string") variables[key] = value;
+					for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string") variables[key] = value;
+					return {
+						variables,
+						enabled: spec.variablesEnabled !== false
+					};
+				} catch {
+					return {
+						variables: {},
+						enabled: true
+					};
+				}
+			};
+			/** 生成目录实际生效配置（/prompt-configs 读取）。 */
+			const readPromptConfigs = (dir) => {
+				try {
+					return dir.length > 0 ? loadPromptConfigFiles(join(dir, "prompt-configs")) : [];
+				} catch {
+					return [];
+				}
+			};
 			const disposers = [
+				sctx.webServer.register({
+					kind: "exact",
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.bootstrap,
+					handler: async (req, res) => {
+						if (!guard(req, res)) return;
+						const descriptor = findDescriptor();
+						if (descriptor === void 0) {
+							writeBridgeJson(res, 404, {
+								ok: false,
+								code: "settings-not-exposed",
+								message: "prompt-tool settings namespace is not registered"
+							});
+							return;
+						}
+						try {
+							const meta = await loadEngineMeta();
+							const dir = getPresetConfigsDir?.() ?? "";
+							const extras = collectDescribeExtras();
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: descriptor,
+								meta: { meta },
+								overrides: { overrides: dir.length > 0 ? readParamOverrides(dir) : {} },
+								variables: dir.length > 0 ? readPresetVariables(dir) : {
+									variables: {},
+									enabled: true
+								},
+								promptConfigs: { promptConfigs: readPromptConfigs(dir) },
+								...extras
+							});
+						} catch (error) {
+							writeBridgeJson(res, 500, {
+								ok: false,
+								code: "bootstrap-failed",
+								message: error instanceof Error ? error.message : String(error)
+							});
+						}
+					}
+				}),
 				sctx.webServer.register({
 					kind: "exact",
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.meta,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const { getEngineMeta } = await import(new URL("../engine/schema.mjs", import.meta.url).href);
-						const meta = getEngineMeta();
-						meta.presets = listPresets();
-						meta.builtinTemplates = listBuiltinTemplates();
 						writeBridgeJson(res, 200, {
 							ok: true,
-							value: { meta }
+							value: { meta: await loadEngineMeta() }
 						});
 					}
 				}),
@@ -1580,7 +2016,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.describe,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const descriptor = findDescriptor();
 						if (descriptor === void 0) {
 							writeBridgeJson(res, 404, {
@@ -1590,50 +2025,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						const detection = getModelsState();
-						const skillsState = getSkillsState();
-						let hostDefaultModel;
-						try {
-							const selection = sctx.settings.get(settingsNamespace("agent-default-model"));
-							if (selection !== null && typeof selection === "object") {
-								const record = selection;
-								hostDefaultModel = {
-									...typeof record.provider === "string" && record.provider.length > 0 ? { provider: record.provider } : {},
-									...typeof record.model === "string" && record.model.length > 0 ? { model: record.model } : {},
-									...typeof record.reasoningEffort === "string" && record.reasoningEffort.length > 0 ? { reasoningEffort: record.reasoningEffort } : {}
-								};
-								if (Object.keys(hostDefaultModel).length === 0) hostDefaultModel = void 0;
-							}
-						} catch {}
-						const modelCatalog = peekModelCatalog();
-						let presetParams = {};
-						let templatePreStepCount = 0;
-						try {
-							const settingsValue = descriptor.value !== null && typeof descriptor.value === "object" ? descriptor.value : {};
-							const templateName = typeof settingsValue.presetTemplate === "string" && settingsValue.presetTemplate.length > 0 ? settingsValue.presetTemplate : "anchored";
-							const spec = loadPresetSpec(resolvePresetDir(templateName));
-							presetParams = resolvePresetParams(spec, {});
-							if (Array.isArray(spec.promptConfigs)) presetParams.promptConfigs = spec.promptConfigs;
-							templatePreStepCount = (spec.promptConfigs ?? []).filter((config) => {
-								const layer = config.layer;
-								return layer === void 0 || layer === "pre-step";
-							}).length;
-						} catch {
-							templatePreStepCount = 0;
-						}
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: descriptor,
-							presetParams,
-							hostDefaultModel,
-							templatePreStepCount,
-							modelsAvailable: detection.available,
-							providers: detection.providers,
-							modelCatalog,
-							modelsError: detection.error,
-							activeSkillsDirs: skillsState.activeSkillsDirs,
-							skillsDirExists: Object.fromEntries(skillsState.activeSkillsDirs.map((dir) => [dir, existsSync(dir)])),
-							skillCatalog: skillsState.skillCatalog
+							...collectDescribeExtras()
 						});
 					}
 				}),
@@ -1642,7 +2037,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.models,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { modelCatalog: await listAdvertisedModels(sctx) }
@@ -1654,7 +2048,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.mutate,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						if (body === null || body === void 0 || typeof body !== "object") {
 							writeBridgeJson(res, 400, {
@@ -1716,7 +2109,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.configsValidate,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const { body } = await readBridgeBody(req);
+						const { body, tooLarge } = await readBridgeBody(req, PRESET_PACKAGE_MAX_BYTES);
+						if (tooLarge) {
+							writeBridgeJson(res, 413, {
+								ok: false,
+								code: "configs-too-large",
+								message: `配置载荷超过 ${Math.round(PRESET_PACKAGE_MAX_BYTES / 1024 / 1024)}MB 上限`
+							});
+							return;
+						}
 						if (body === null || body === void 0 || typeof body !== "object") {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -1736,7 +2137,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.skillFix,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						if (body === null || body === void 0 || typeof body !== "object") {
 							writeBridgeJson(res, 400, {
@@ -1815,7 +2215,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						try {
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: { templates: loadPromptTemplates() }
+								value: {
+									templates: loadPromptTemplates(),
+									toolTemplates: loadToolTemplates()
+								}
 							});
 						} catch (error) {
 							writeBridgeJson(res, 500, {
@@ -1831,18 +2234,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.promptConfigs,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						try {
-							const dir = join(getPresetConfigsDir?.() ?? "", "prompt-configs");
-							writeBridgeJson(res, 200, {
-								ok: true,
-								value: { promptConfigs: dir.length > 0 ? loadPromptConfigFiles(dir) : [] }
-							});
-						} catch {
-							writeBridgeJson(res, 200, {
-								ok: true,
-								value: { promptConfigs: [] }
-							});
-						}
+						const dir = getPresetConfigsDir?.() ?? "";
+						writeBridgeJson(res, 200, {
+							ok: true,
+							value: { promptConfigs: readPromptConfigs(dir) }
+						});
 					}
 				}),
 				sctx.webServer.register({
@@ -1871,7 +2267,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.importPreset,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const { body } = await readBridgeBody(req);
+						const { body, tooLarge } = await readBridgeBody(req, PRESET_PACKAGE_MAX_BYTES);
+						if (tooLarge) {
+							writeBridgeJson(res, 413, {
+								ok: false,
+								code: "preset-import-too-large",
+								message: `内容资产超过 ${Math.round(PRESET_PACKAGE_MAX_BYTES / 1024 / 1024)}MB 上限`
+							});
+							return;
+						}
 						if (body === null || body === void 0 || typeof body !== "object") {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -1881,8 +2285,27 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							return;
 						}
 						const record = body;
-						const scope = record.scope === "agents" ? "agents" : "preset";
-						const content = typeof record.content === "string" ? record.content : "";
+						const contents = [];
+						if (Array.isArray(record.contents)) for (const entry of record.contents) {
+							if (entry === null || typeof entry !== "object") continue;
+							const item = entry;
+							contents.push({
+								scope: item.scope === "agents" ? "agents" : "preset",
+								content: typeof item.content === "string" ? item.content : ""
+							});
+						}
+						else contents.push({
+							scope: record.scope === "agents" ? "agents" : "preset",
+							content: typeof record.content === "string" ? record.content : ""
+						});
+						if (contents.length === 0) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "settings-rejected",
+								message: "unreadable JSON body"
+							});
+							return;
+						}
 						const dir = getPresetConfigsDir?.() ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
@@ -1894,11 +2317,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						try {
 							mkdirSync(dir, { recursive: true });
-							writeFileSync(join(dir, scope === "preset" ? "preset.md" : "agents.md"), content, "utf8");
-							afterPresetImport?.(scope);
+							for (const entry of contents) writeFileSync(join(dir, entry.scope === "preset" ? "preset.md" : "agents.md"), entry.content, "utf8");
+							afterPresetImport?.(contents.map((entry) => entry.scope));
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: { scope }
+								value: { scopes: contents.map((entry) => entry.scope) }
 							});
 						} catch (error) {
 							writeBridgeJson(res, 500, {
@@ -1925,31 +2348,47 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						const presetRoot = dirname(dir);
 						const templateName = basename(dir);
-						const { body } = await readBridgeBody(req);
+						const { body, tooLarge } = await readBridgeBody(req, PRESET_PACKAGE_MAX_BYTES);
+						if (tooLarge) {
+							writeBridgeJson(res, 413, {
+								ok: false,
+								code: "overrides-too-large",
+								message: `参数载荷超过 ${Math.round(PRESET_PACKAGE_MAX_BYTES / 1024 / 1024)}MB 上限`
+							});
+							return;
+						}
 						const record = body ?? {};
 						if (record.overrides === void 0 && record.promptConfigs === void 0) {
-							try {
-								const spec = loadPresetSpec(dir);
-								const params = {};
-								for (const key of PARAM_KEYS) {
-									if (key === "promptConfigs") continue;
-									if (spec.params !== null && typeof spec.params === "object" && key in spec.params) params[key] = spec.params[key];
-								}
-								writeBridgeJson(res, 200, {
-									ok: true,
-									value: { overrides: params }
-								});
-							} catch {
-								writeBridgeJson(res, 200, {
-									ok: true,
-									value: { overrides: {} }
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: { overrides: readParamOverrides(dir) }
+							});
+							return;
+						}
+						const rawOverrides = record.overrides !== null && typeof record.overrides === "object" && !Array.isArray(record.overrides) ? record.overrides : void 0;
+						if (rawOverrides !== void 0) {
+							const unknownKeys = Object.keys(rawOverrides).filter((key) => key === "promptConfigs" || !PARAM_KEYS.has(key));
+							if (unknownKeys.length > 0) {
+								writeBridgeJson(res, 400, {
+									ok: false,
+									code: "overrides-unknown-key",
+									message: `未知引擎参数键：${unknownKeys.join(", ")}`
 								});
+								return;
 							}
+						}
+						const valueErrors = rawOverrides !== void 0 ? validateEngineParamValues(rawOverrides) : [];
+						if (valueErrors.length > 0) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "overrides-invalid-value",
+								message: valueErrors.map((item) => item.message).join("; ")
+							});
 							return;
 						}
 						try {
-							savePresetParams(presetRoot, templateName, record.overrides !== null && typeof record.overrides === "object" && !Array.isArray(record.overrides) ? record.overrides : void 0, Array.isArray(record.promptConfigs) ? record.promptConfigs : void 0);
-							afterOverridesChange?.();
+							savePresetParams(presetRoot, templateName, rawOverrides, Array.isArray(record.promptConfigs) ? record.promptConfigs : void 0);
+							if (record.rebuild !== false) afterOverridesChange?.();
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
@@ -1985,41 +2424,83 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const { body } = await readBridgeBody(req);
 						const record = body ?? {};
 						if (record.variables === void 0 && record.enabled === void 0) {
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: readPresetVariables(dir)
+							});
+							return;
+						}
+						try {
+							savePresetParams(presetRoot, templateName, void 0, void 0, record.variables !== null && typeof record.variables === "object" && !Array.isArray(record.variables) ? record.variables : void 0, typeof record.enabled === "boolean" ? record.enabled : void 0);
+							afterOverridesChange?.();
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: { variables: record.variables }
+							});
+						} catch (error) {
+							writeBridgeJson(res, 409, {
+								ok: false,
+								code: "preset-variables-rejected",
+								message: `模板变量保存失败：${error instanceof Error ? error.message : String(error)}`
+							});
+						}
+					}
+				}),
+				sctx.webServer.register({
+					kind: "exact",
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.customTools,
+					handler: async (req, res) => {
+						if (!guard(req, res)) return;
+						const dir = getPresetConfigsDir?.() ?? "";
+						if (dir.length === 0) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "preset-dir-unavailable",
+								message: "presetDir 未配置"
+							});
+							return;
+						}
+						const { body } = await readBridgeBody(req);
+						const record = body ?? {};
+						if (record.customTools === void 0) {
 							try {
 								const spec = loadPresetSpec(dir);
-								const variables = {};
-								for (const [key, value] of Object.entries(spec.params ?? {})) if (!PARAM_KEYS.has(key) && typeof value === "string") variables[key] = value;
-								for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string") variables[key] = value;
 								writeBridgeJson(res, 200, {
 									ok: true,
-									value: {
-										variables,
-										enabled: spec.variablesEnabled !== false
-									}
+									value: { customTools: Array.isArray(spec.customTools) ? spec.customTools : [] }
 								});
 							} catch {
 								writeBridgeJson(res, 200, {
 									ok: true,
-									value: {
-										variables: {},
-										enabled: true
-									}
+									value: { customTools: [] }
 								});
 							}
 							return;
 						}
 						try {
-							savePresetParams(presetRoot, templateName, void 0, void 0, record.variables !== null && typeof record.variables === "object" && !Array.isArray(record.variables) ? record.variables : void 0, typeof record.enabled === "boolean" ? record.enabled : void 0);
+							const customTools = record.customTools;
+							if (!Array.isArray(customTools)) {
+								writeBridgeJson(res, 400, {
+									ok: false,
+									code: "custom-tools-invalid",
+									message: "customTools 必须是数组"
+								});
+								return;
+							}
+							withPresetDoc(dir, (doc) => {
+								if (customTools.length === 0) doc.deleteIn(["customTools"]);
+								else doc.setIn(["customTools"], customTools);
+							});
 							afterOverridesChange?.();
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: { variables: record.variables }
+								value: { customTools }
 							});
 						} catch (error) {
 							writeBridgeJson(res, 409, {
 								ok: false,
-								code: "preset-variables-rejected",
-								message: `模板变量保存失败：${error instanceof Error ? error.message : String(error)}`
+								code: "custom-tools-rejected",
+								message: `自定义工具保存失败：${error instanceof Error ? error.message : String(error)}`
 							});
 						}
 					}
@@ -2214,7 +2695,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetDelete,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						const record = body ?? {};
 						const id = typeof record.id === "string" ? record.id.trim() : "";
@@ -2259,7 +2739,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetClone,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						const record = body ?? {};
 						const id = typeof record.id === "string" ? record.id.trim() : "";
@@ -2291,7 +2770,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetDuplicate,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						const record = body ?? {};
 						const id = typeof record.id === "string" ? record.id.trim() : "";
@@ -2327,7 +2805,6 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetOpen,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						ensureRegistered(sctx);
 						const { body } = await readBridgeBody(req);
 						const record = body ?? {};
 						const id = typeof record.id === "string" ? record.id.trim() : "";
@@ -2583,6 +3060,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			};
 		}, "prompt-tool: settings bridge");
 	});
+	return { invalidateDescriptor: () => invalidateCachedDescriptor() };
 }
 //#endregion
 //#region src/runtime/character-tools.ts
@@ -2590,9 +3068,11 @@ const text$2 = (text) => [{
 	type: "text",
 	text
 }];
+/** 注册角色卡库模型工具；返回 disposer（预设切换重挂用）。enabled=false 返回空操作。 */
 function registerCharacterTools(ctx, host) {
-	ctx.inject(["tools"], (toolsCtx) => {
-		toolsCtx.tools.register(defineTool({
+	const fiber = ctx.inject(["tools"], (toolsCtx) => {
+		const disposers = [];
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_list",
 			description: "列出 SillyTavern 角色卡库：每张卡（id / 名称 / 描述 / 是否已导入当前预设）。导入角色卡、应用到当前预设或移除前先调用本工具获取 id。",
 			parameters: {},
@@ -2627,8 +3107,8 @@ function registerCharacterTools(ctx, host) {
 				render: (_args, value) => text$2(JSON.stringify(value.characters))
 			},
 			execute: async () => ({ characters: listCharacterCards(host.presetRoot(), host.templateName()) })
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_import",
 			description: "导入 SillyTavern 角色卡（chara_card_v2/v3 JSON）到角色卡库：接收角色卡 JSON 文本内容（可先读取文件）。PNG 角色卡请让用户从 UI 角色管理页导入。导入后需调用 character_apply 应用到当前预设。",
 			parameters: {
@@ -2671,8 +3151,8 @@ function registerCharacterTools(ctx, host) {
 					name: result.name
 				};
 			}
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_apply",
 			description: "把角色卡库中一张角色卡的参数（角色设定 / 系统提示 / 开场白 / 世界书 / 提示词库 / 采样参数）合并进当前激活预设（promptConfigs 带 chara-<id>- 前缀防冲突，params 合并，meta.importedCharacters 记录），并立即重建生成目录。重复应用幂等。",
 			parameters: { id: {
@@ -2706,8 +3186,8 @@ function registerCharacterTools(ctx, host) {
 					count: result.count
 				};
 			}
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_remove",
 			description: "从当前激活预设移除一张已导入角色卡的参数（删 chara-<id>- 前缀配置、该卡声明的 params 键、meta.importedCharacters 除名），并立即重建生成目录。角色卡库条目不受影响。",
 			parameters: { id: {
@@ -2741,8 +3221,8 @@ function registerCharacterTools(ctx, host) {
 					count: result.count
 				};
 			}
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_delete",
 			description: "从角色卡库删除一张角色卡（含其转换参数与头像）。已导入当前预设的参数不受影响（如需清理请先调用 character_remove）。",
 			parameters: { id: {
@@ -2766,8 +3246,14 @@ function registerCharacterTools(ctx, host) {
 				if (!result.ok) throw new Error(result.message);
 				return { id: args.id };
 			}
-		}));
+		})));
+		return () => {
+			for (const dispose of disposers) dispose();
+		};
 	});
+	return () => {
+		fiber.dispose();
+	};
 }
 //#endregion
 //#region src/runtime/world-book-tools.ts
@@ -2775,26 +3261,6 @@ const text$1 = (text) => [{
 	type: "text",
 	text
 }];
-function readConfigs(dir) {
-	const file = join(dir, "preset.yml");
-	const current = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" }).toJS();
-	return Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
-}
-function writeConfigs(dir, configs) {
-	const file = join(dir, "preset.yml");
-	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
-	doc.setIn(["promptConfigs"], configs);
-	writeFileSync(file, doc.toString(), "utf8");
-}
-/** 追加记忆文件（角色卡 memory.md 或预设 memory.md）。 */
-function appendMemory(file, note) {
-	const content = note.trim();
-	if (content.length === 0) return;
-	mkdirSync(join(file, ".."), { recursive: true });
-	const line = `\n- [${(/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ")}] ${content}\n`;
-	if (existsSync(file)) appendFileSync(file, line, "utf8");
-	else writeFileSync(file, `# 本地记忆\n${line}`, "utf8");
-}
 /** 从条目 id 解析来源角色卡（chara-<cardId>- 前缀，cardId 可含连字符：遍历库目录取最长匹配）。 */
 function sourceCardId(presetRoot, entryId) {
 	const root = join(presetRoot, ".characters");
@@ -2808,16 +3274,22 @@ function sourceCardId(presetRoot, entryId) {
 	} catch {}
 	return best;
 }
+/** 注册世界书条目级模型工具；返回 disposer（预设切换重挂用）。enabled=false 返回空操作。 */
 function registerWorldBookTools(ctx, host) {
-	ctx.inject(["tools"], (toolsCtx) => {
+	const fiber = ctx.inject(["tools"], (toolsCtx) => {
+		const disposers = [];
 		/** note 归属写入：角色卡条目 → 卡记忆；其他 → 预设记忆。 */
 		const writeNote = (entryId, note) => {
 			if (note === void 0 || note.trim().length === 0) return;
 			const cardId = entryId !== void 0 ? sourceCardId(host.presetRoot(), entryId) : void 0;
-			if (cardId !== void 0) appendMemory(join(host.presetRoot(), ".characters", cardId, "memory.md"), note);
-			else appendMemory(join(host.activeDir(), "memory.md"), note);
+			if (cardId !== void 0) {
+				appendMemoryFile(join(host.presetRoot(), ".characters", cardId, "memory.md"), note, "# 角色记忆");
+				try {
+					syncImportedCharacterMemory(host.presetRoot(), basename(host.activeDir()), cardId);
+				} catch {}
+			} else appendMemoryFile(join(host.activeDir(), "memory.md"), note, "# 本地记忆");
 		};
-		toolsCtx.tools.register(defineTool({
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_list",
 			description: "列出当前预设的世界书条目（world-book 策略配置：id / 名称 / 关键字 / 常驻 / 启用）。世界书 = 上下文条目：无 keys 的全局条目每次注入，有 keys 条目命中聊天内容才注入。增删改前先调用本工具获取 id。",
 			parameters: {},
@@ -2853,7 +3325,7 @@ function registerWorldBookTools(ctx, host) {
 				render: (_args, value) => text$1(JSON.stringify(value.entries))
 			},
 			execute: async () => {
-				return { entries: readConfigs(host.activeDir()).filter((config) => config.strategy === "world-book").map((config) => ({
+				return { entries: listWorldBookEntries(host.activeDir()).map((config) => ({
 					id: String(config.id ?? ""),
 					name: String(config.name ?? config.id ?? ""),
 					keys: Array.isArray(config.params && config.params.keys) ? config.params.keys : void 0,
@@ -2861,8 +3333,8 @@ function registerWorldBookTools(ctx, host) {
 					enabled: config.enabled !== false
 				})) };
 			}
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_upsert",
 			description: "新增或更新当前预设的一条世界书条目（world-book 策略配置）：按 id 更新（不存在则新增，id 自动生成 lore-<n>）。constant=true 常驻注入；否则命中 keys（或 secondaryKeys）任一关键字注入；无 keys 条目按全局每次注入。note 可选：写入来源角色卡的持久记忆（memory.md，条目 id 带 chara-<卡>- 前缀时）或预设记忆——持久记忆跨会话跟随角色卡（与 session_var 会话变量的临时状态不同，适合长期关系记录）。写盘后立即重建生成目录。",
 			parameters: {
@@ -2926,37 +3398,29 @@ function registerWorldBookTools(ctx, host) {
 			},
 			execute: async (args) => {
 				const dir = host.activeDir();
-				const configs = readConfigs(dir);
 				const targetId = args.id !== void 0 && args.id.length > 0 ? args.id : `lore-${Date.now().toString(36)}`;
-				const params = {
-					constant: args.constant === true,
-					...Array.isArray(args.keys) && args.keys.length > 0 ? { keys: args.keys } : {},
-					...Array.isArray(args.secondaryKeys) && args.secondaryKeys.length > 0 ? { secondaryKeys: args.secondaryKeys } : {}
-				};
-				const entry = {
-					id: targetId,
-					name: args.name,
-					strategy: "world-book",
-					order: typeof args.order === "number" ? args.order : 100,
-					text: args.content,
-					layer: "pre-step",
-					position: "before-all",
-					params
-				};
-				if (args.enabled === false) entry.enabled = false;
-				const existing = configs.findIndex((config) => String(config.id ?? "") === targetId);
-				if (existing >= 0) configs[existing] = entry;
-				else configs.push(entry);
-				writeConfigs(dir, configs);
+				const count = upsertWorldBookEntry(dir, {
+					...buildWorldBookEntry({
+						id: targetId,
+						name: args.name,
+						text: args.content,
+						order: typeof args.order === "number" ? args.order : void 0,
+						enabled: args.enabled === false ? false : void 0,
+						constant: args.constant === true,
+						keys: Array.isArray(args.keys) && args.keys.length > 0 ? args.keys : void 0,
+						secondaryKeys: Array.isArray(args.secondaryKeys) && args.secondaryKeys.length > 0 ? args.secondaryKeys : void 0
+					}),
+					id: targetId
+				});
 				writeNote(targetId, typeof args.note === "string" ? args.note : "");
 				host.rebuild();
 				return {
 					id: targetId,
-					count: configs.filter((config) => config.strategy === "world-book").length
+					count
 				};
 			}
-		}));
-		toolsCtx.tools.register(defineTool({
+		})));
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_delete",
 			description: "删除当前预设的一条世界书条目（world_book_list 获取 id）。note 可选：写入来源角色卡持久记忆（memory.md，跨会话跟随角色卡）或预设记忆。删除后立即重建生成目录。",
 			parameters: {
@@ -2988,20 +3452,22 @@ function registerWorldBookTools(ctx, host) {
 				render: (_args, value) => text$1(`世界书条目 ${value.id} 已删除（剩余 ${value.count} 条），生成目录已重建。`)
 			},
 			execute: async (args) => {
-				const dir = host.activeDir();
-				const configs = readConfigs(dir);
-				const kept = configs.filter((config) => !(config.strategy === "world-book" && String(config.id ?? "") === args.id));
-				if (kept.length === configs.length) throw new Error(`世界书条目 ${args.id} 不存在`);
-				writeConfigs(dir, kept);
+				const keptCount = deleteWorldBookEntry(host.activeDir(), args.id);
 				writeNote(args.id, typeof args.note === "string" ? args.note : "");
 				host.rebuild();
 				return {
 					id: args.id,
-					count: kept.filter((config) => config.strategy === "world-book").length
+					count: keptCount
 				};
 			}
-		}));
+		})));
+		return () => {
+			for (const dispose of disposers) dispose();
+		};
 	});
+	return () => {
+		fiber.dispose();
+	};
 }
 //#endregion
 //#region src/runtime/session-var-tools.ts
@@ -3009,9 +3475,11 @@ const text = (value) => [{
 	type: "text",
 	text: value
 }];
+/** 注册会话变量模型工具；返回 disposer（预设切换重挂用）。enabled=false 返回空操作。 */
 function registerSessionVarTools(ctx) {
-	ctx.inject(["tools"], (toolsCtx) => {
-		toolsCtx.tools.register(defineTool({
+	const fiber = ctx.inject(["tools"], (toolsCtx) => {
+		const disposers = [];
+		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "session_var",
 			description: "会话变量管理（SillyTavern setvar/getvar 语义）：list 查看当前会话全部变量、get 读取、set 设置、clear 清除。提示词/世界书文本中的 {{变量名}} 会在注入时替换为会话变量值（会话级覆盖预设默认值）；适合维护角色状态（如 {{心情}}、{{接受度}} 等）。注意：会话变量仅存于当前会话（结束即失）；跨会话长期记忆请用 world_book 工具的 note 参数写入角色卡记忆（持久，跟随角色卡）。",
 			parameters: {
@@ -3106,8 +3574,14 @@ function registerSessionVarTools(ctx) {
 					error: `未知 action: ${action}`
 				};
 			}
-		}));
+		})));
+		return () => {
+			for (const dispose of disposers) dispose();
+		};
 	});
+	return () => {
+		fiber.dispose();
+	};
 }
 //#endregion
 //#region src/runtime/tui.ts
@@ -3121,6 +3595,7 @@ const TUI_GLOBAL_SWITCHES = [
 const TUI_PARAM_SWITCHES = [
 	["injectPrompt", "锚定确认后注入 preset.md"],
 	["firstTurnAnchor", "追加任务引导"],
+	["guideEnabled", "每轮引导（独立开关；缺省跟随锚定）"],
 	["firstTurnCustom", "使用自定义引导（首句）"],
 	["guideCustom", "使用自定义引导（每轮）"],
 	["usePtcMode", "使用 PTC 模式"]
@@ -3291,18 +3766,56 @@ function parseTuiBoolean(token, current) {
 	if (token === "off") return false;
 	if (token === "toggle") return !current;
 }
+function asCommandAction(token) {
+	return token === "on" || token === "off" || token === "toggle" ? token : void 0;
+}
+/**
+* 解析可含空格的标识符与末尾动作。
+*
+* 斜杠命令没有 shell 引号语义，因此动作只认“最后一个独立 token”。config 的
+* 详情形态没有动作；只有去掉末尾动作后的候选 id 已存在时才把末尾 token 视为
+* 动作，避免把普通 id 误拆。
+*/
+function parseIdentifierAndAction(tokens, exists) {
+	if (tokens.length === 0) return { id: "" };
+	const last = tokens[tokens.length - 1];
+	const action = asCommandAction(last ?? "");
+	if (action !== void 0 && tokens.length >= 2) {
+		const id = tokens.slice(0, -1).join(" ");
+		if (exists(id)) return {
+			id,
+			action
+		};
+	}
+	return { id: tokens.join(" ") };
+}
 /** 通过 DSH 命令注册表暴露 /prompt-tool，Web 与 dsh-tui 都能执行。 */
 function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog, getPresetConfigsDir, savePresetParam) {
 	ctx.inject(["settings"], (sctx) => {
 		return sctx.commands.register({
 			name: "prompt-tool",
 			description: "提示词工具：查看或切换本插件开关",
-			input: { hint: "status | on/off/toggle <开关> | skill <目录名> on/off | config <id> [on/off/toggle]" },
+			input: { hint: "status | on/off/toggle <开关> | skill <目录名> on/off/toggle | config <id> [on/off/toggle]" },
 			handler: async (invocation) => {
 				const usage = () => ({
 					kind: "error",
-					text: "用法：/prompt-tool status\n      /prompt-tool on|off|toggle <writeAgents|writePreset|injectPrompt|injectAgentsPrompt|firstTurnAnchor|firstTurnCustom|guideCustom|usePtcMode>\n      /prompt-tool skill <技能目录名> on|off|toggle\n      /prompt-tool config <id>\n      /prompt-tool config <id> on|off|toggle\n      /prompt-tool bootstrapMaxTokens <正整数|0（关闭）>"
+					text: "用法：/prompt-tool status\n      /prompt-tool on|off|toggle <writeAgents|writePreset|injectPrompt|injectAgentsPrompt|firstTurnAnchor|firstTurnCustom|guideEnabled|guideCustom|usePtcMode>\n      /prompt-tool skill <技能目录名> on|off|toggle（目录名可含空格）\n      /prompt-tool config <id>（id 可含空格）\n      /prompt-tool config <id> on|off|toggle\n      /prompt-tool bootstrapMaxTokens <正整数|0（关闭）>"
 				});
+				const persistPresetParam = async (key, value) => {
+					if (savePresetParam === void 0) return {
+						kind: "error",
+						text: `无法保存 ${key}：预设参数保存回调不可用`
+					};
+					try {
+						await savePresetParam(key, value);
+						return;
+					} catch (error) {
+						return {
+							kind: "error",
+							text: `保存 ${key} 失败：${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				};
 				const tokens = invocation.rawInput.trim().split(/\s+/).filter((token) => token.length > 0);
 				const source = getSource();
 				const presetDir = getPresetConfigsDir?.();
@@ -3320,10 +3833,9 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 					};
 				}
 				if (tokens[0] === "skill") {
-					const folder = tokens[1];
-					if (folder === void 0) return usage();
-					const current = source.skillSwitches[folder] !== false;
-					const next = parseTuiBoolean(tokens[2], current);
+					const { id: folder, action } = parseIdentifierAndAction(tokens.slice(1), () => true);
+					if (folder.length === 0) return usage();
+					const next = parseTuiBoolean(action, source.skillSwitches[folder] !== false);
 					if (next === void 0) return usage();
 					await sctx.settings.mutate(ns, [{
 						op: "set",
@@ -3338,25 +3850,24 @@ ${renderTuiStatus(getSource(), readPresetParams(getPresetConfigsDir?.()), resolv
 					};
 				}
 				if (tokens[0] === "config") {
-					const id = tokens[1];
-					if (id === void 0) return usage();
+					const { id, action } = parseIdentifierAndAction(tokens.slice(1), (candidate) => promptConfigs.some((config) => config.id === candidate));
+					if (id.length === 0) return usage();
 					const current = promptConfigs.find((config) => config.id === id);
 					if (current === void 0) return {
 						kind: "error",
 						text: `未找到提示词配置 ${id}；用 /prompt-tool status 查看全部 id。`
 					};
-					const action = tokens[2];
 					if (action === void 0) return {
 						kind: "success",
 						text: renderConfigDetail(source, id, promptConfigs)
 					};
 					const next = parseTuiBoolean(action, current.enabled !== false);
 					if (next === void 0) return usage();
-					const nextConfigs = promptConfigs.map((config) => config.id === id ? {
+					const failure = await persistPresetParam("promptConfigs", promptConfigs.map((config) => config.id === id ? {
 						...config,
 						enabled: next
-					} : config);
-					savePresetParam?.("promptConfigs", nextConfigs);
+					} : config));
+					if (failure !== void 0) return failure;
 					return {
 						kind: "success",
 						text: `已把提示词配置 ${id} 设为 ${next ? "开" : "关"}
@@ -3371,7 +3882,8 @@ ${renderConfigDetail(getSource(), id, resolvePromptConfigs(getPresetConfigsDir?.
 						kind: "error",
 						text: "bootstrapMaxTokens 需要非负整数：0 关闭封顶，正整数设置首轮 maxTokens。"
 					};
-					savePresetParam?.("bootstrapMaxTokens", value);
+					const failure = await persistPresetParam("bootstrapMaxTokens", value);
+					if (failure !== void 0) return failure;
 					return {
 						kind: "success",
 						text: `已把 bootstrapMaxTokens 设为 ${value === 0 ? "关闭（不设封顶）" : String(value)}
@@ -3396,7 +3908,10 @@ ${renderTuiStatus(getSource(), readPresetParams(getPresetConfigsDir?.()), resolv
 					path: [key],
 					value: next
 				}]);
-				else savePresetParam?.(key, next);
+				else {
+					const failure = await persistPresetParam(key, next);
+					if (failure !== void 0) return failure;
+				}
 				return {
 					kind: "success",
 					text: `已把 ${key} 设为 ${next ? "开" : "关"}
@@ -3408,25 +3923,6 @@ ${renderTuiStatus(getSource(), readPresetParams(getPresetConfigsDir?.()), resolv
 	});
 }
 //#endregion
-//#region src/runtime/settings-registration.ts
-/**
-* 确保 `ns` 已注册：已注册（describe 命中）直接返回 true；未注册时补注册。
-* 官方 installSettingsSection 的 inject 回调只在 settings 服务首次可用时跑一次，
-* settings 服务实例被替换（provider fiber reload）后注册丢失且不自动重建；
-* 本函数由 Web bridge 每次请求前调用兜底。
-*/
-function ensureSettingsRegistered(sctx, ns, schema, hooks) {
-	if (sctx.settings.describe({ redactSecrets: true }).some((entry) => String(entry.ns) === String(ns))) return true;
-	try {
-		const scope = sctx.settings.register(ns, schema, { base: hooks.base() });
-		hooks.onRegistered(scope);
-		return true;
-	} catch (error) {
-		hooks.onError(error instanceof Error ? error.message : String(error));
-		return false;
-	}
-}
-//#endregion
 //#region src/runtime/agents-file.ts
 /** AGENTS.md 常驻规则的受管块读写（保留文件其余内容）。 */
 const RESIDENT_AGENTS_BEGIN = "# === prompt-tool managed block begin ===";
@@ -3547,8 +4043,9 @@ function runtimeOf(options, prompt) {
 		firstTurnText: typeof options.firstTurnText === "string" ? options.firstTurnText : "",
 		guideCustom: options.guideCustom === true,
 		guideText: typeof options.guideText === "string" ? options.guideText : "",
+		guideEnabled: typeof options.guideEnabled === "boolean" ? options.guideEnabled : void 0,
 		injectPrompt: options.injectPrompt !== false,
-		usePtcMode: options.usePtcMode !== false,
+		usePtcMode: typeof options.usePtcMode === "boolean" ? options.usePtcMode : void 0,
 		bootstrapMaxTokens: Number.isSafeInteger(options.bootstrapMaxTokens) ? options.bootstrapMaxTokens : 0,
 		modelProvider: typeof options.modelProvider === "string" && options.modelProvider.length > 0 ? options.modelProvider : "",
 		modelName: typeof options.modelName === "string" && options.modelName.length > 0 ? options.modelName : "",
@@ -3560,12 +4057,19 @@ function runtimeOf(options, prompt) {
 		subagentReasoningEffort: typeof options.subagentReasoningEffort === "string" && options.subagentReasoningEffort.length > 0 ? options.subagentReasoningEffort : void 0,
 		subagentTemperature: typeof options.subagentTemperature === "string" && options.subagentTemperature.length > 0 ? options.subagentTemperature : void 0,
 		subagentMaxTokens: typeof options.subagentMaxTokens === "string" && options.subagentMaxTokens.length > 0 ? options.subagentMaxTokens : void 0,
-		subagentPersona: typeof options.subagentPersona === "string" && options.subagentPersona.length > 0 ? options.subagentPersona : "",
 		toolFilterAllow: options.toolFilterAllow !== void 0 && (Array.isArray(options.toolFilterAllow) ? options.toolFilterAllow.length > 0 : String(options.toolFilterAllow).trim().length > 0) ? options.toolFilterAllow : void 0,
 		toolFilterDeny: options.toolFilterDeny !== void 0 && (Array.isArray(options.toolFilterDeny) ? options.toolFilterDeny.length > 0 : String(options.toolFilterDeny).trim().length > 0) ? options.toolFilterDeny : void 0,
 		maxDepth: options.maxDepth,
 		allowKinds: options.allowKinds,
-		firstTurnWord: typeof options.firstTurnWord === "string" && options.firstTurnWord.length > 0 ? options.firstTurnWord : void 0
+		firstTurnWord: typeof options.firstTurnWord === "string" && options.firstTurnWord.length > 0 ? options.firstTurnWord : void 0,
+		anchorTurn: typeof options.anchorTurn === "boolean" ? options.anchorTurn : void 0,
+		anchorTurnText: typeof options.anchorTurnText === "string" ? options.anchorTurnText : void 0,
+		deliberationGate: typeof options.deliberationGate === "boolean" ? options.deliberationGate : void 0,
+		deliberationMinChars: Number.isSafeInteger(options.deliberationMinChars) ? options.deliberationMinChars : void 0,
+		deliberationMaxGatesPerTurn: Number.isSafeInteger(options.deliberationMaxGatesPerTurn) ? options.deliberationMaxGatesPerTurn : void 0,
+		cotDrip: typeof options.cotDrip === "boolean" ? options.cotDrip : void 0,
+		cotDripEvery: Number.isSafeInteger(options.cotDripEvery) ? options.cotDripEvery : void 0,
+		cotDripMaxPerTurn: Number.isSafeInteger(options.cotDripMaxPerTurn) ? options.cotDripMaxPerTurn : void 0
 	};
 }
 /** 模型参数（思维程度/温度/输出上限）→ agent-request 提示词配置（官方 LlmCallConfig patch 浅合并）。
@@ -3609,6 +4113,8 @@ function writePreset(prompt, options) {
 	const presetDir = options.presetDir.trim().length > 0 ? options.presetDir : DEFAULT_PRESET_DIR;
 	const templateName = typeof options.presetTemplate === "string" && options.presetTemplate.trim().length > 0 ? options.presetTemplate.trim() : "anchored";
 	if (!/^[a-z0-9][a-z0-9-]*$/.test(templateName)) throw new Error(`invalid presetTemplate ${JSON.stringify(templateName)}: must match official agent-presets id /^[a-z0-9][a-z0-9-]*$/`);
+	const outputId = typeof options.outputId === "string" && options.outputId.trim().length > 0 ? options.outputId.trim() : templateName;
+	if (!/^[a-z0-9][a-z0-9-]*$/.test(outputId)) throw new Error(`invalid outputId ${JSON.stringify(outputId)}: must match official agent-presets id /^[a-z0-9][a-z0-9-]*$/`);
 	const templateDir = resolvePresetDir(templateName);
 	const spec = loadPresetSpec(templateDir);
 	const worldBook = spec.worldBook;
@@ -3638,8 +4144,7 @@ function writePreset(prompt, options) {
 					...keys.length > 0 ? { keys } : {},
 					...secondaryKeys.length > 0 ? { secondaryKeys } : {},
 					...entry.caseSensitive === true ? { caseSensitive: true } : {},
-					...entry.wholeWords === true ? { wholeWords: true } : {},
-					...entry.useRegex === true ? { useRegex: true } : {}
+					...entry.wholeWords === true ? { wholeWords: true } : {}
 				}
 			});
 		}
@@ -3655,27 +4160,37 @@ function writePreset(prompt, options) {
 	}
 	const runtime = runtimeOf(options, prompt);
 	const params = resolvePresetParams(spec, runtime);
-	const targetDir = join(presetDir, templateName);
+	const targetDir = join(presetDir, outputId);
 	mkdirSync(presetDir, { recursive: true });
-	const tmpDir = mkdtempSync(join(presetDir, `.${templateName}.tmp-`));
+	const tmpDir = mkdtempSync(join(presetDir, `.${outputId}.tmp-`));
 	const outDir = tmpDir;
 	try {
 		const overridesSrc = join(targetDir, "prompt-tool.overrides.yml");
 		if (existsSync(overridesSrc)) cpSync(overridesSrc, join(outDir, "prompt-tool.overrides.yml"), { force: true });
 		const composition = renderComposition(spec, runtime, templateDir);
 		assertCompositionArray(composition, spec);
-		const subComposition = composition.replaceAll("./engine/", "../.engine/").replaceAll("../prompt-configs", `../${templateName}/prompt-configs`);
+		const subComposition = composition.replaceAll("./engine/", "../.engine/").replaceAll("../prompt-configs", `../${outputId}/prompt-configs`);
 		writeFileSync(join(outDir, "agent.cordis.yml"), subComposition, "utf8");
+		const aliasSuffix = "（旧会话兼容）";
+		const aliasName = options.aliasOf === true ? typeof spec.name === "string" && spec.name.length > 0 ? spec.name : outputId : void 0;
+		const displayName = aliasName !== void 0 && !aliasName.endsWith(aliasSuffix) ? aliasName + aliasSuffix : aliasName;
 		const meta = spec.meta !== null && typeof spec.meta === "object" ? spec.meta : {};
-		const existingPresetYaml = existsSync(join(targetDir, "preset.yml")) ? readFileSync(join(targetDir, "preset.yml"), "utf8") : void 0;
+		const sourceYamlPath = options.aliasOf === true ? join(presetDir, templateName, "preset.yml") : join(targetDir, "preset.yml");
+		const existingPresetYaml = existsSync(sourceYamlPath) ? readFileSync(sourceYamlPath, "utf8") : void 0;
 		if (existingPresetYaml !== void 0 && existingPresetYaml.trim().length > 0) {
 			const doc = parseDocument(existingPresetYaml, { logLevel: "silent" });
 			doc.setIn(["order"], options.presetOrder);
-			if (typeof spec.name === "string" && spec.name.length > 0) doc.setIn(["name"], spec.name);
+			if (typeof spec.name === "string" && spec.name.length > 0) doc.setIn(["name"], displayName ?? spec.name);
+			if (options.aliasOf === true) doc.setIn(["id"], outputId);
 			if (typeof spec.description === "string" && spec.description.length > 0) doc.setIn(["description"], spec.description);
 			if (Object.keys(meta).length > 0) doc.setIn(["meta"], meta);
 			writeFileSync(join(outDir, "preset.yml"), doc.toString(), "utf8");
-		} else writeFileSync(join(outDir, "preset.yml"), stringify({
+		} else writeFileSync(join(outDir, "preset.yml"), stringify(displayName !== void 0 ? {
+			...meta,
+			id: outputId,
+			name: displayName,
+			order: options.presetOrder
+		} : {
 			...meta,
 			order: options.presetOrder
 		}) + "\n", "utf8");
@@ -3742,7 +4257,7 @@ function writePreset(prompt, options) {
 				next.params = {
 					...next.params,
 					useCustom: params.firstTurnCustom === true,
-					firstTurnText: asString(params.firstTurnText),
+					text: asString(params.firstTurnText),
 					buildPattern: asString(params.buildPattern),
 					complexPattern: asString(params.complexPattern),
 					firstTurnBuild: asString(params.firstTurnBuild),
@@ -3750,14 +4265,15 @@ function writePreset(prompt, options) {
 					firstTurnDeep: asString(params.firstTurnDeep)
 				};
 			} else if (next.id === "router-guide") {
-				next.enabled = params.firstTurnAnchor === true;
-				const useCustom = params.firstTurnAnchor === true && params.guideCustom === true;
+				const guideEnabled = params.guideEnabled === void 0 ? params.firstTurnAnchor === true : params.guideEnabled === true;
+				next.enabled = guideEnabled;
+				const useCustom = guideEnabled && params.guideCustom === true;
 				next.modelScope = useCustom ? "all" : "flash";
 				next.params = {
 					...next.params,
 					useCustom,
 					text: asString(params.guideText),
-					guideComplexPattern: asString(params.guideComplexPattern),
+					complexPattern: asString(params.complexPattern) || asString(params.guideComplexPattern),
 					guideWeak: asString(params.guideWeak),
 					guideDeep: asString(params.guideDeep)
 				};
@@ -3769,10 +4285,10 @@ function writePreset(prompt, options) {
 		const presetVariables = {};
 		for (const [key, value] of Object.entries(spec.params ?? {})) {
 			if (PARAM_KEYS.has(key)) continue;
-			const text = String(value);
-			if (text.length > 0) presetVariables[key] = text;
+			if (value === void 0 || value === null) continue;
+			presetVariables[key] = String(value);
 		}
-		for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string" && value.length > 0) presetVariables[key] = value;
+		for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string") presetVariables[key] = value;
 		const variablesEnabled = spec.variablesEnabled !== false;
 		const presetVariableKeys = new Set(Object.keys(presetVariables));
 		if (variablesEnabled && presetVariableKeys.size > 0) writeFileSync(join(promptConfigsDir, "variables.yml"), stringify(presetVariables), "utf8");
@@ -3781,15 +4297,30 @@ function writePreset(prompt, options) {
 				delete config.text;
 				config.texts = [];
 				config.enabled = params.injectPrompt !== false && prompt.trim().length > 0;
+				const explicitWord = asString(config.params?.firstTurnWord ?? params.firstTurnWord, "");
+				const signalWord = (text) => {
+					const sentence = /the exact sentence:\s*([A-Za-z]+)/i.exec(text);
+					if (sentence !== null && sentence[1] !== void 0) return sentence[1].toLowerCase();
+					const first = /^\P{L}*([\p{L}]+)/u.exec(text.trim());
+					return first !== null && first[1] !== void 0 ? first[1].toLowerCase() : void 0;
+				};
+				const derivedWords = [...new Set([
+					signalWord(asString(params.firstTurnText)),
+					signalWord(asString(params.firstTurnBuild)),
+					signalWord(asString(params.firstTurnInspect)),
+					signalWord(asString(params.firstTurnDeep))
+				].filter((word) => word !== void 0))];
+				const anchorWords = explicitWord.length > 0 ? [explicitWord] : derivedWords;
 				config.params = {
 					...config.params,
 					text: prompt,
-					firstTurnWord: asString(config.params?.firstTurnWord ?? params.firstTurnWord, "we")
+					firstTurnWord: explicitWord.length > 0 ? explicitWord : anchorWords[0] ?? "we",
+					anchorWords
 				};
 			}
 			if (config.fill === "instruction-hint") config.params = {
 				...config.params,
-				agentsInstructionPath: `../${templateName}/agents-instruction.md`,
+				agentsInstructionPath: `../${outputId}/agents-instruction.md`,
 				...options.injectAgentsPrompt === true ? { text: asString(options.agentsInstructionText) } : {}
 			};
 			if (!variablesEnabled && presetVariableKeys.size > 0) {
@@ -3803,6 +4334,18 @@ function writePreset(prompt, options) {
 			}
 			writeFileSync(join(promptConfigsDir, `${String(index * 10).padStart(2, "0")}-${config.id}.yml`), renderPromptConfigYaml(config), "utf8");
 		}
+		const customToolsDir = join(outDir, "custom-tools");
+		rmSync(customToolsDir, {
+			recursive: true,
+			force: true
+		});
+		mkdirSync(customToolsDir, { recursive: true });
+		const customTools = Array.isArray(spec.customTools) ? spec.customTools : [];
+		for (const [index, tool] of customTools.entries()) {
+			if (tool === null || typeof tool !== "object" || Array.isArray(tool) || typeof tool.id !== "string" || String(tool.id).length === 0) continue;
+			const toolId = String(tool.id);
+			writeFileSync(join(customToolsDir, `${String(index + 1).padStart(2, "0")}-${toolId}.yml`), stringify(tool, { lineWidth: 0 }), "utf8");
+		}
 		for (const legacy of spec.legacyCleanup ?? []) rmSync(join(outDir, legacy), { force: true });
 		const agentsInstructionPath = join(outDir, "agents-instruction.md");
 		if (typeof options.agentsInstructionText === "string" && options.agentsInstructionText.trim().length > 0) writeFileSync(agentsInstructionPath, options.agentsInstructionText, "utf8");
@@ -3855,9 +4398,10 @@ function writePreset(prompt, options) {
 function migrateLegacyLayout(presetRoot, legacyUserPresets) {
 	const legacyContainer = join(presetRoot, "prompt-tool");
 	const sharedEngine = join(presetRoot, ".engine");
+	const isLegacyContainer = existsSync(legacyContainer) && !existsSync(join(legacyContainer, "preset.yml"));
 	let migrated = false;
 	const legacyEngine = join(legacyContainer, "engine");
-	if (existsSync(legacyEngine) && !existsSync(sharedEngine)) try {
+	if (isLegacyContainer && existsSync(legacyEngine) && !existsSync(sharedEngine)) try {
 		mkdirSync(presetRoot, { recursive: true });
 		renameSync(legacyEngine, sharedEngine);
 		migrated = true;
@@ -3884,7 +4428,7 @@ function migrateLegacyLayout(presetRoot, legacyUserPresets) {
 		}
 	})();
 	const stamp = Date.now().toString(36);
-	if (existsSync(sharedEngine) && existsSync(legacyContainer)) try {
+	if (isLegacyContainer && existsSync(sharedEngine) && existsSync(legacyContainer)) try {
 		renameSync(legacyContainer, join(presetRoot, `prompt-tool.bak-${stamp}`));
 		migrated = true;
 	} catch {}
@@ -3900,6 +4444,43 @@ function normalizePresetRootDir(presetDir, presetRoot, legacyContainer) {
 	if (presetDir.endsWith("/prompt-tool") || presetDir.endsWith("\\prompt-tool")) return presetRoot;
 	return presetDir;
 }
+/**
+* 旧版参数覆盖文件（prompt-tool.overrides.yml）→ 激活预设 preset.yml 一次性退役迁移。
+* 旧写入路径（阶段 1）把引擎参数写进该文件；阶段 2 收敛为 savePresetParams 直接写
+* preset.yml 并删除覆盖文件。本函数仅处理存量升级场景：
+*   - 键白名单 = PARAM_KEYS（含 guideEnabled/injectPrompt/usePtcMode，补上旧手写列表
+*     缺失的 3 键；promptConfigs 不走覆盖文件，排除）；
+*   - 空值键按 savePresetParams 语义删除（回落模板/引擎默认）；
+*   - 成功 = preset.yml 已写入且覆盖文件已删（savePresetParams 删除）；失败（preset.yml
+*     缺失等）抛错且覆盖文件保留，调用方下次重建重试。
+* 返回 true = 已迁移（调用方需重读参数）；false = 无文件/解析失败/无有效键（文件已尽力清理）。
+*/
+function migrateParamOverridesFile(presetRoot, templateName) {
+	const file = join(presetRoot, templateName, "prompt-tool.overrides.yml");
+	let raw;
+	try {
+		raw = readFileSync(file, "utf8");
+	} catch {
+		return false;
+	}
+	if (raw.trim().length === 0) {
+		rmSync(file, { force: true });
+		return false;
+	}
+	let parsed;
+	try {
+		parsed = parse(raw, { logLevel: "silent" });
+	} catch {
+		return false;
+	}
+	const valid = Object.fromEntries(Object.entries(parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}).filter(([key]) => PARAM_KEYS.has(key) && key !== "promptConfigs"));
+	if (Object.keys(valid).length === 0) {
+		rmSync(file, { force: true });
+		return false;
+	}
+	savePresetParams(presetRoot, templateName, valid, void 0);
+	return true;
+}
 //#endregion
 //#region src/index.ts
 const name = "prompt-tool";
@@ -3930,6 +4511,7 @@ function warn(ctx, message) {
 	} catch {}
 }
 function apply(ctx, configIn) {
+	const hadLegacyContainer = existsSync(join(DEFAULT_PRESET_DIR, "prompt-tool")) && !existsSync(join(DEFAULT_PRESET_DIR, "prompt-tool", "preset.yml"));
 	let legacyMigrated = false;
 	try {
 		legacyMigrated = migrateLegacyLayout(DEFAULT_PRESET_DIR, LEGACY_USER_PRESETS_DIR);
@@ -3972,6 +4554,7 @@ function apply(ctx, configIn) {
 		runtime.firstTurnCustom = params.firstTurnCustom === true;
 		runtime.guideText = asString(params.guideText);
 		runtime.guideCustom = params.guideCustom === true;
+		runtime.guideEnabled = typeof params.guideEnabled === "boolean" ? params.guideEnabled : void 0;
 		runtime.modelProvider = asString(params.modelProvider);
 		runtime.modelName = asString(params.modelName);
 		runtime.subagentModelProvider = asString(params.subagentModelProvider);
@@ -3983,9 +4566,8 @@ function apply(ctx, configIn) {
 		runtime.subagentTemperature = asString(params.subagentTemperature);
 		runtime.subagentMaxTokens = asString(params.subagentMaxTokens);
 		runtime.bootstrapMaxTokens = Number.isSafeInteger(params.bootstrapMaxTokens) && params.bootstrapMaxTokens >= 0 ? params.bootstrapMaxTokens : 0;
-		runtime.usePtcMode = params.usePtcMode !== false;
+		runtime.usePtcMode = typeof params.usePtcMode === "boolean" ? params.usePtcMode : void 0;
 		runtime.injectPrompt = params.injectPrompt !== false;
-		runtime.subagentPersona = asString(params.subagentPersona) || void 0;
 		runtime.toolFilterAllow = params.toolFilterAllow;
 		runtime.toolFilterDeny = params.toolFilterDeny;
 		runtime.maxDepth = params.maxDepth;
@@ -3993,6 +4575,29 @@ function apply(ctx, configIn) {
 		runtime.firstTurnWord = asString(params.firstTurnWord) || void 0;
 		runtime.promptConfigs = Array.isArray(spec.promptConfigs) ? spec.promptConfigs : [];
 	};
+	let legacyAliasHandledThisRun = readPluginState().legacyAliasHandled === true;
+	const ensureLegacyAliasOnce = (presetPrompt, options) => {
+		if (legacyAliasHandledThisRun) return;
+		legacyAliasHandledThisRun = true;
+		const aliasFile = join(runtime.presetDir, "prompt-tool", "preset.yml");
+		try {
+			if (!existsSync(aliasFile) && hadLegacyContainer) {
+				writePreset(presetPrompt, {
+					...options,
+					outputId: "prompt-tool",
+					aliasOf: true
+				});
+				warn(ctx, "prompt-tool: 已创建一次性旧会话兼容快照 prompt-tool；日常切换不再重建");
+			}
+			writePluginState({
+				...readPluginState(),
+				legacyAliasHandled: true
+			});
+		} catch (error) {
+			legacyAliasHandledThisRun = false;
+			warn(ctx, `prompt-tool: 创建旧会话兼容快照失败（下次重建重试）：${error instanceof Error ? error.message : String(error)}`);
+		}
+	};
 	/** 重建生成目录（文本/组合/引擎/提示词配置）；writePreset 关闭时移除旧目录。 */
 	const rebuildPreset = () => {
 		reloadPresetParams();
@@ -4005,6 +4610,7 @@ function apply(ctx, configIn) {
 				firstTurnCustom: runtime.firstTurnCustom,
 				guideText: runtime.guideText,
 				guideCustom: runtime.guideCustom,
+				guideEnabled: runtime.guideEnabled,
 				injectPrompt: runtime.injectPrompt,
 				modelProvider: runtime.modelProvider,
 				modelName: runtime.modelName,
@@ -4016,7 +4622,6 @@ function apply(ctx, configIn) {
 				subagentReasoningEffort: runtime.subagentReasoningEffort,
 				subagentTemperature: runtime.subagentTemperature,
 				subagentMaxTokens: runtime.subagentMaxTokens,
-				subagentPersona: runtime.subagentPersona,
 				toolFilterAllow: runtime.toolFilterAllow,
 				toolFilterDeny: runtime.toolFilterDeny,
 				maxDepth: runtime.maxDepth,
@@ -4047,6 +4652,7 @@ function apply(ctx, configIn) {
 				}
 			}
 			writePreset(presetPrompt, options);
+			ensureLegacyAliasOnce(presetPrompt, options);
 		} else {
 			let cleaned = 0;
 			for (const preset of listPresets()) {
@@ -4054,6 +4660,7 @@ function apply(ctx, configIn) {
 				for (const name of [
 					"agent.cordis.yml",
 					"prompt-configs",
+					"custom-tools",
 					"preset.md",
 					"agents.md",
 					"agents-instruction.md",
@@ -4082,49 +4689,15 @@ function apply(ctx, configIn) {
 			return true;
 		}
 	};
-	/** 用户参数覆盖（生成目录 prompt-tool.overrides.yml；settings 不再承载参数）。 */
+	/** 旧版参数覆盖文件（prompt-tool.overrides.yml）一次性退役迁移：白名单
+	*  （PARAM_KEYS，含 guideEnabled/injectPrompt/usePtcMode）过滤后并入 preset.yml。
+	*  实现收敛到 migrateParamOverridesFile（migration.ts 单一权威）。 */
 	const applyParamOverrides = () => {
-		const raw = readGeneratedContent(activePresetDir(), "prompt-tool.overrides.yml");
-		if (raw.length === 0) return;
-		let overrides;
 		try {
-			const parsed = parse(raw, { logLevel: "silent" });
-			overrides = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+			if (migrateParamOverridesFile(runtime.presetDir, runtime.presetTemplate)) reloadPresetParams();
 		} catch {
-			return;
+			warn(ctx, "prompt-tool: prompt-tool.overrides.yml 迁移到 preset.yml 失败（下次重建重试）");
 		}
-		if (typeof overrides.firstTurnAnchor === "boolean") runtime.firstTurnAnchor = overrides.firstTurnAnchor;
-		if (typeof overrides.firstTurnCustom === "boolean") runtime.firstTurnCustom = overrides.firstTurnCustom;
-		if (typeof overrides.firstTurnText === "string") runtime.firstTurnText = overrides.firstTurnText;
-		if (typeof overrides.guideCustom === "boolean") runtime.guideCustom = overrides.guideCustom;
-		if (typeof overrides.guideText === "string") runtime.guideText = overrides.guideText;
-		if (typeof overrides.modelProvider === "string") runtime.modelProvider = overrides.modelProvider;
-		if (typeof overrides.modelName === "string") runtime.modelName = overrides.modelName;
-		if (typeof overrides.subagentModelProvider === "string") runtime.subagentModelProvider = overrides.subagentModelProvider;
-		if (typeof overrides.subagentModelName === "string") runtime.subagentModelName = overrides.subagentModelName;
-		if (typeof overrides.modelReasoningEffort === "string") runtime.modelReasoningEffort = overrides.modelReasoningEffort;
-		if (typeof overrides.modelTemperature === "string") runtime.modelTemperature = overrides.modelTemperature;
-		if (typeof overrides.modelMaxTokens === "string") runtime.modelMaxTokens = overrides.modelMaxTokens;
-		if (typeof overrides.subagentReasoningEffort === "string") runtime.subagentReasoningEffort = overrides.subagentReasoningEffort;
-		if (typeof overrides.subagentTemperature === "string") runtime.subagentTemperature = overrides.subagentTemperature;
-		if (typeof overrides.subagentMaxTokens === "string") runtime.subagentMaxTokens = overrides.subagentMaxTokens;
-		if (typeof overrides.subagentPersona === "string") runtime.subagentPersona = overrides.subagentPersona;
-		if (typeof overrides.firstTurnWord === "string") runtime.firstTurnWord = overrides.firstTurnWord;
-		if (typeof overrides.bootstrapMaxTokens === "number") runtime.bootstrapMaxTokens = overrides.bootstrapMaxTokens;
-		const listOf = (value) => {
-			if (typeof value === "string") return value;
-			if (Array.isArray(value)) return value.filter((item) => typeof item === "string");
-		};
-		const tfAllow = listOf(overrides.toolFilterAllow);
-		if (tfAllow !== void 0) runtime.toolFilterAllow = tfAllow;
-		const tfDeny = listOf(overrides.toolFilterDeny);
-		if (tfDeny !== void 0) runtime.toolFilterDeny = tfDeny;
-		const kinds = listOf(overrides.allowKinds);
-		if (kinds !== void 0 && (typeof kinds === "string" ? kinds.trim().length > 0 : kinds.length > 0)) runtime.allowKinds = kinds;
-		const depth = overrides.maxDepth;
-		if (depth === "provider-managed") runtime.maxDepth = "provider-managed";
-		else if (typeof depth === "number" && Number.isSafeInteger(depth) && depth >= 0) runtime.maxDepth = depth;
-		else if (typeof depth === "string" && depth.length > 0) runtime.maxDepth = depth;
 	};
 	const legacySkillsDir = typeof config.skillsDir === "string" && config.skillsDir.length > 0 && config.skillsDir !== DEFAULT_SKILLS_DIR ? config.skillsDir : "";
 	const userSkillsDirs = Array.isArray(config.skillsDirs) && config.skillsDirs.length > 0 ? config.skillsDirs.filter((dir) => typeof dir === "string" && dir.trim().length > 0) : legacySkillsDir.length > 0 ? [legacySkillsDir] : [];
@@ -4238,15 +4811,15 @@ function apply(ctx, configIn) {
 			}
 		};
 	});
-	registerSettingsBridge(ctx, NS, getModelsState, () => ({
+	const settingsBridge = registerSettingsBridge(ctx, NS, getModelsState, () => ({
 		activeSkillsDirs,
 		skillCatalog
-	}), () => "", (sctx) => ensureRegistered(sctx), () => {
+	}), () => "", () => {
 		skillCatalog = catalogOf(readAllSkillsChecked());
 		cachedSkills.invalidate();
 		invalidateSkills?.();
-	}, () => activePresetDir(), (scope) => {
-		if (scope === "preset") current = readGeneratedContent(activePresetDir(), "preset.md");
+	}, () => activePresetDir(), (scopes) => {
+		for (const scope of scopes) if (scope === "preset") current = readGeneratedContent(activePresetDir(), "preset.md");
 		else currentAgents = readGeneratedContent(activePresetDir(), "agents.md");
 		try {
 			rebuildPreset();
@@ -4283,6 +4856,7 @@ function apply(ctx, configIn) {
 		firstTurnCustom: initialParams.firstTurnCustom === true,
 		guideText: asString(initialParams.guideText),
 		guideCustom: initialParams.guideCustom === true,
+		guideEnabled: typeof initialParams.guideEnabled === "boolean" ? initialParams.guideEnabled : void 0,
 		injectPrompt: initialParams.injectPrompt !== false,
 		modelProvider: asString(initialParams.modelProvider),
 		modelName: asString(initialParams.modelName),
@@ -4295,8 +4869,7 @@ function apply(ctx, configIn) {
 		subagentTemperature: asString(initialParams.subagentTemperature),
 		subagentMaxTokens: asString(initialParams.subagentMaxTokens),
 		bootstrapMaxTokens: Number.isSafeInteger(initialParams.bootstrapMaxTokens) && initialParams.bootstrapMaxTokens >= 0 ? initialParams.bootstrapMaxTokens : 0,
-		usePtcMode: initialParams.usePtcMode !== false,
-		subagentPersona: asString(initialParams.subagentPersona) || void 0,
+		usePtcMode: typeof initialParams.usePtcMode === "boolean" ? initialParams.usePtcMode : void 0,
 		toolFilterAllow: initialParams.toolFilterAllow,
 		toolFilterDeny: initialParams.toolFilterDeny,
 		maxDepth: initialParams.maxDepth,
@@ -4309,9 +4882,21 @@ function apply(ctx, configIn) {
 		fallbackText: config.fallbackText,
 		promptConfigs: Array.isArray(initialSpec?.promptConfigs) ? initialSpec.promptConfigs : []
 	};
+	const agentPresetsNs = "agent-presets";
 	let hostSettingsService;
-	let lastSyncedHostDefault;
-	const syncHostDefault = (reason) => {
+	const readHostDefault = (value) => {
+		if (value === null || typeof value !== "object") return void 0;
+		const candidate = value.default;
+		return typeof candidate === "string" && candidate.length > 0 ? candidate : void 0;
+	};
+	const managedPresetExists = (id) => {
+		try {
+			return listPresets().some((preset) => preset.id === id);
+		} catch {
+			return false;
+		}
+	};
+	const syncHostDefault = (_reason) => {
 		const s = hostSettingsService;
 		if (s === void 0) return;
 		const template = runtime.presetTemplate;
@@ -4319,17 +4904,31 @@ function apply(ctx, configIn) {
 			warn(ctx, `prompt-tool: 预设 id ${JSON.stringify(template)} 不符合官方 agent-presets 命名（^[a-z0-9][a-z0-9-]*$），跳过宿主 default 同步；请将预设目录改名为合法 id`);
 			return;
 		}
-		if (reason === "switch" && lastSyncedHostDefault === template) return;
-		lastSyncedHostDefault = template;
-		try {
-			s.mutate(settingsNamespace("agent-presets"), [{
-				op: "set",
-				path: ["default"],
-				value: template
-			}]);
-		} catch (error) {
+		if (readHostDefault(s.get(agentPresetsNs)) === template) return;
+		s.mutate(agentPresetsNs, [{
+			op: "set",
+			path: ["default"],
+			value: template
+		}]).catch((error) => {
 			warn(ctx, `prompt-tool: 同步宿主 agent-presets default 失败：${error instanceof Error ? error.message : String(error)}`);
+		});
+	};
+	const syncTemplateFromHostDefault = (value) => {
+		const s = hostSettingsService;
+		if (s === void 0) return;
+		const template = readHostDefault(value ?? s.get(agentPresetsNs));
+		if (template === void 0 || template === runtime.presetTemplate) return;
+		if (!managedPresetExists(template)) {
+			warn(ctx, `prompt-tool: 官方 agent-presets default 已切换为 ${JSON.stringify(template)}，但该预设不在提示词工具管理目录中，跳过反向同步`);
+			return;
 		}
+		s.mutate(NS, [{
+			op: "set",
+			path: ["presetTemplate"],
+			value: template
+		}]).catch((error) => {
+			warn(ctx, `prompt-tool: 跟随官方 agent-presets default 失败：${error instanceof Error ? error.message : String(error)}`);
+		});
 	};
 	installSubagentModelRoute(ctx, () => runtime.subagentModelProvider.length > 0 && runtime.subagentModelName.length > 0, () => runtime.subagentModelProvider, () => runtime.subagentModelName);
 	const applyDefaultModel = installDefaultModelRoute(ctx, () => runtime.modelProvider.length > 0 && runtime.modelName.length > 0, () => runtime.modelProvider, () => runtime.modelName, () => runtime.modelReasoningEffort);
@@ -4352,14 +4951,10 @@ function apply(ctx, configIn) {
 		presetTemplate: runtime.presetTemplate
 	});
 	registerTuiCommand(ctx, NS, () => currentSource(), getModelsState, () => listAdvertisedModels(ctx), () => activePresetDir(), (key, value) => {
-		try {
-			if (key === "promptConfigs") savePresetParams(runtime.presetDir, runtime.presetTemplate, void 0, Array.isArray(value) ? value : void 0);
-			else savePresetParams(runtime.presetDir, runtime.presetTemplate, { [key]: value }, void 0);
-			reloadPresetParams();
-			rebuildPreset();
-		} catch (error) {
-			warn(ctx, `prompt-tool: TUI 参数保存失败：${error instanceof Error ? error.message : String(error)}`);
-		}
+		if (key === "promptConfigs") savePresetParams(runtime.presetDir, runtime.presetTemplate, void 0, Array.isArray(value) ? value : void 0);
+		else savePresetParams(runtime.presetDir, runtime.presetTemplate, { [key]: value }, void 0);
+		reloadPresetParams();
+		rebuildPreset();
 	});
 	/**
 	* 物化导入的预设：用其自身 preset.yml（spec 参数 + modules + promptConfigs）渲染
@@ -4381,7 +4976,6 @@ function apply(ctx, configIn) {
 			modelName: "",
 			subagentModelProvider: "",
 			subagentModelName: "",
-			subagentPersona: "",
 			injectAgentsPrompt: false,
 			bootstrapMaxTokens: 0,
 			usePtcMode: false,
@@ -4454,51 +5048,44 @@ function apply(ctx, configIn) {
 			if (!residentAgentsWritten) warn(ctx, `prompt-tool: failed to remove resident rules block from ${runtime.residentAgentsPath}`);
 		}
 		rebuildPreset();
-		if (presetTemplateChanged) syncHostDefault("switch");
-	};
-	registerCharacterTools(ctx, {
-		presetRoot: () => dirname(activePresetDir()),
-		templateName: () => basename(activePresetDir()),
-		rebuild: () => {
-			try {
-				rebuildPreset();
-			} catch (error) {
-				warn(ctx, `prompt-tool: character tool rebuild failed: ${String(error)}`);
-			}
+		if (presetTemplateChanged) {
+			syncHostDefault("switch");
+			applyBuiltinTools();
 		}
-	});
-	registerWorldBookTools(ctx, {
-		activeDir: () => activePresetDir(),
-		presetRoot: () => dirname(activePresetDir()),
-		rebuild: () => {
-			try {
-				rebuildPreset();
-			} catch (error) {
-				warn(ctx, `prompt-tool: world-book tool rebuild failed: ${String(error)}`);
+	};
+	let disposeBuiltinTools = [];
+	const applyBuiltinTools = () => {
+		for (const dispose of disposeBuiltinTools) dispose();
+		disposeBuiltinTools = [];
+		const push = (dispose) => {
+			if (typeof dispose === "function") disposeBuiltinTools.push(dispose);
+		};
+		push(registerCharacterTools(ctx, {
+			presetRoot: () => dirname(activePresetDir()),
+			templateName: () => basename(activePresetDir()),
+			rebuild: () => {
+				try {
+					rebuildPreset();
+				} catch (error) {
+					warn(ctx, `prompt-tool: character tool rebuild failed: ${String(error)}`);
+				}
 			}
-		}
-	});
-	registerSessionVarTools(ctx);
-	const settingsEntry = currentSource();
-	const ensureRegistered = (sctx) => ensureSettingsRegistered(sctx, NS, PromptSettingsSchema, {
-		base: () => settingsEntry,
-		onRegistered: (scope) => {
-			currentSource = () => scope.get();
-			scope.watch(() => {
+		}));
+		push(registerWorldBookTools(ctx, {
+			activeDir: () => activePresetDir(),
+			presetRoot: () => dirname(activePresetDir()),
+			rebuild: () => {
 				try {
-					applyState();
+					rebuildPreset();
 				} catch (error) {
-					warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`);
+					warn(ctx, `prompt-tool: world-book tool rebuild failed: ${String(error)}`);
 				}
-			});
-			try {
-				applyState();
-			} catch (error) {
-				warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`);
 			}
-		},
-		onError: (message) => warn(ctx, `prompt-tool: settings register failed: ${message}`)
-	});
+		}));
+		push(registerSessionVarTools(ctx));
+	};
+	applyBuiltinTools();
+	const settingsEntry = currentSource();
 	/** 阶段 2 迁移：旧全局 settings 引擎参数 → 激活预设 preset.yml（一次性，state.paramsMigrated 后跳过）。
 	*  兼容旧版预设根内 .pt-params-migrated 标记：存在即视为已迁移，并迁入状态文件后删除。 */
 	const migrateSettingsParamsToPreset = (sctx) => {
@@ -4560,20 +5147,32 @@ function apply(ctx, configIn) {
 			warn(ctx, `prompt-tool: settings 参数迁移失败（下次启动重试）：${error instanceof Error ? error.message : String(error)}`);
 		}
 	};
+	ctx.inject(["settings", "agentPresets"], () => {
+		syncTemplateFromHostDefault();
+	});
 	ctx.inject(["settings"], (sctx) => {
 		hostSettingsService = sctx.settings;
-		ensureRegistered(sctx);
-		if (legacyMigrated) syncHostDefault("migrate");
-		migrateSettingsParamsToPreset(sctx);
-		sctx.effect(() => () => {
-			currentSource = () => settingsEntry;
-			try {
-				applyState();
-			} catch (error) {
-				warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`);
+		sctx.effect(() => sctx.on("settings/updated", (ns, next) => {
+			if (String(ns) !== String(agentPresetsNs)) return;
+			syncTemplateFromHostDefault(next);
+		}), "prompt-tool: follow agent-presets default");
+		sctx.settings.installSection(ctx, NS, PromptSettingsSchema, settingsEntry, {
+			setSource: (current) => {
+				currentSource = current;
+			},
+			onChange: () => {
+				settingsBridge.invalidateDescriptor();
+				try {
+					applyState();
+				} catch (error) {
+					warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`);
+				}
 			}
 		});
+		if (legacyMigrated) syncHostDefault("migrate");
+		else syncTemplateFromHostDefault();
+		migrateSettingsParamsToPreset(sctx);
 	});
 }
 //#endregion
-export { BRIDGE_ENDPOINTS, Config, PARAM_KEYS, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, apply, applyModuleConfigs, cloneBuiltinPreset, createCachedSkillsReader, detectModels, ensurePresetSeed, ensureSettingsRegistered, ensureWebSurface, fixSkillEntry, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listPresets, listSkillFolders, loadPresetSpec, loadPromptTemplates, mergeSkillDirs, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, readPluginState, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeUserPreset, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, stPresetId, toKebabName, userPresetsDir, validSkills, validatePromptConfigs, writePluginState, writePreset };
+export { BRIDGE_ENDPOINTS, Config, ENGINE_PARAM_KEYS, MODEL_SEGMENT_MAP, PARAM_KEYS, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, WRITER_PARAM_KEYS, appendCharacterMemory, appendMemoryFile, apply, applyCharacterToPreset, applyModuleConfigs, buildModuleConfigsFromParams, buildWorldBookEntry, cloneBuiltinPreset, convertStToPreset, createCachedSkillsReader, deleteCharacterCard, deleteWorldBookEntry, detectModels, ensurePresetSeed, ensureWebSurface, fixSkillEntry, importCharacterCard, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listCharacterCards, listPresets, listSkillFolders, listWorldBookEntries, loadPresetSpec, loadPromptTemplates, loadToolTemplates, mergeSkillDirs, mergeStPresets, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, processStText, readCharacterMemory, readPluginState, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeCharacterFromPreset, removeUserPreset, renderComposition, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, stPresetId, syncImportedCharacterMemory, toKebabName, upsertWorldBookEntry, userPresetsDir, validSkills, validatePromptConfigs, writePluginState, writePreset };