dsh-plugin-prompt-tool 0.8.1 → 1.0.0

package/lib/{preset-package-BnJqrU4R.mjs → module-package-Cm3fHHlp.mjs}

@@ -1,8 +1,8 @@
-import { appendFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, posix, resolve, sep } from "node:path";
+import { appendFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { Pair, Scalar, YAMLMap, YAMLSeq, parse, parseDocument, stringify } from "yaml";
+import { Pair, Scalar, YAMLMap, YAMLSeq, isMap, parse, parseDocument, stringify } from "yaml";
 import { homedir } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "node:buffer";
@@ -29,177 +29,196 @@ const DSH_HOME = resolveDshHome();
 *  插件不再内置任何技能：包内没有 skills 目录，也不再有安装副本与内容账本。 */
 const USER_SKILLS_DIR = join(DSH_HOME, "skills");
 /**
-* 预设根：官方 USER_PRESET_DIR（DSH_HOME/.agent-presets）。
-* 每个预设一个官方预设目录（agent.cordis.yml 组合本体 + preset.yml 参数），
-* 宿主 agent-presets 直接可挂载；共享引擎自阶段 2 起由**插件包**提供（组合行写包名说明符），
-* 不再物化到预设根下。
+* 插件自有**存储根**（DSH_HOME/.prompt-tool）。
+*
+* 根下按物分目录：`modules/` 放模块定义与物化产物，`.characters/` 放角色卡库。
+* 与模块**同级的兄弟物**从模块路径上溯一级定位（`charactersDir(moduleRoot)` 就是这么做），
+* 不从这里读——模块级常量在 import 时按 `DSH_HOME` 冻结，测试内改环境变量对它无效。
+* 旧根 `.agent-presets/` 只读不删，本插件不再读写它。
+*/
+const STORAGE_ROOT = join(DSH_HOME, ".prompt-tool");
+/**
+* 存储根下的**模块根**：一个模块一个目录（`modules/<id>/`），定义与物化产物都在其内。
+*
+* 这是 `resolveModuleDir` / `assertModuleDirectory` / `listModules` 的扫描根，
+* 也是「本插件管理的模块」身份判定的基准。模块目录必须是它的**直接子目录**
+* （`assertModuleDirectory` 的一层深度契约由此成立）。
 */
-const DEFAULT_PRESET_DIR = join(DSH_HOME, ".agent-presets");
-join(DEFAULT_PRESET_DIR, ".engine");
+const MODULES_DIR = join(STORAGE_ROOT, "modules");
+/**
+* 模块定义文件名：`<模块根>/<id>/module.yml`。
+*
+* 与物化产物（`configs/`、`custom-tools/`、`triggers.yml`、`subagent-tools/`）同目录。
+* 旧形态的 `preset.yml` **不做兼容读取**：实测真实数据（beta 形态遗留）已经是本名，
+* 且仓库从 `02754cc` 起就没有 `preset.yml` 形态的用户数据；读到旧名目录时由
+* `listModules` 给出明确诊断，而不是静默跳过。
+*/
+const MODULE_DEFINITION_FILE = "module.yml";
+/** 模块物化目录名：提示词配置切片的落点（原 `prompt-configs/`）。 */
+const MODULE_CONFIGS_DIR = "configs";
 //#endregion
-//#region src/shared/engine-params.ts
-const FINITE_NUMBER = (value) => Number.isFinite(value) ? void 0 : "必须是有限数字";
-const POSITIVE_INTEGER = (value) => Number.isSafeInteger(value) && value > 0 ? void 0 : "必须是正整数";
-/** 类型、校验、卡片归属、草稿默认值和组合行映射的唯一运行时目录。 */
-const ENGINE_PARAM_DEFINITIONS = {
+//#region src/shared/legacy-prompt-params.ts
+/** 旧规则快捷参数只用于读取与旧 API 兼容；新编辑器直接保存规则实例。 */
+const LEGACY_PROMPT_PARAM_DEFINITIONS = {
 	firstTurnAnchor: {
 		kind: "boolean",
-		defaultValue: false,
-		card: "prompt-defaults"
+		targets: ["near-anchor"]
 	},
 	firstTurnText: {
 		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
+		targets: ["near-anchor", "prompt-injector"]
 	},
 	firstTurnCustom: {
 		kind: "boolean",
-		defaultValue: false,
-		card: "prompt-defaults"
+		targets: ["near-anchor"]
 	},
 	guideText: {
 		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
+		targets: ["router-guide"]
 	},
 	guideCustom: {
 		kind: "boolean",
-		defaultValue: false,
-		card: "prompt-defaults"
+		targets: ["router-guide"]
 	},
 	guideEnabled: {
 		kind: "boolean",
-		defaultValue: false,
-		card: "prompt-defaults"
+		targets: ["router-guide"]
 	},
 	injectPrompt: {
 		kind: "boolean",
-		defaultValue: true,
-		card: "prompt-defaults"
+		targets: ["prompt-injector"]
 	},
+	firstTurnWord: {
+		kind: "string",
+		targets: ["prompt-injector"]
+	},
+	buildPattern: {
+		kind: "pattern",
+		targets: ["near-anchor"]
+	},
+	complexPattern: {
+		kind: "pattern",
+		targets: ["near-anchor", "router-guide"]
+	},
+	firstTurnBuild: {
+		kind: "string",
+		targets: ["near-anchor", "prompt-injector"]
+	},
+	firstTurnInspect: {
+		kind: "string",
+		targets: ["near-anchor", "prompt-injector"]
+	},
+	firstTurnDeep: {
+		kind: "string",
+		targets: ["near-anchor", "prompt-injector"]
+	},
+	guideWeak: {
+		kind: "string",
+		targets: ["router-guide"]
+	},
+	guideDeep: {
+		kind: "string",
+		targets: ["router-guide"]
+	}
+};
+const LEGACY_PROMPT_PARAM_KEYS = Object.keys(LEGACY_PROMPT_PARAM_DEFINITIONS);
+const isLegacyPromptParam = (key) => Object.hasOwn(LEGACY_PROMPT_PARAM_DEFINITIONS, key);
+const legacyPromptParamPath = (key) => [
+	"layerSettings",
+	"pre-step",
+	key
+];
+//#endregion
+//#region src/shared/engine-params.ts
+const FINITE_NUMBER = (value) => Number.isFinite(value) ? void 0 : "必须是有限数字";
+const POSITIVE_INTEGER = (value) => Number.isSafeInteger(value) && value > 0 ? void 0 : "必须是正整数";
+/** 类型、校验、卡片归属、草稿默认值和组合行映射的唯一运行时目录。 */
+const ENGINE_PARAM_DEFINITIONS = {
 	modelProvider: {
 		kind: "string",
 		defaultValue: "",
-		card: "main-model"
+		card: "main-model",
+		storageLayer: "agent-request"
 	},
 	modelName: {
 		kind: "string",
 		defaultValue: "",
-		card: "main-model"
+		card: "main-model",
+		storageLayer: "agent-request"
 	},
 	subagentModelProvider: {
 		kind: "string",
 		defaultValue: "",
-		card: "subagent-model"
+		card: "subagent-model",
+		storageLayer: "subagent-start"
 	},
 	subagentModelName: {
 		kind: "string",
 		defaultValue: "",
-		card: "subagent-model"
+		card: "subagent-model",
+		storageLayer: "subagent-start"
 	},
 	modelReasoningEffort: {
 		kind: "string",
 		defaultValue: "",
-		card: "main-model"
+		card: "main-model",
+		storageLayer: "agent-request"
 	},
 	modelTemperature: {
 		kind: "number",
 		check: FINITE_NUMBER,
 		defaultValue: "",
-		card: "main-model"
+		card: "main-model",
+		storageLayer: "agent-request"
 	},
 	modelMaxTokens: {
 		kind: "number",
 		check: POSITIVE_INTEGER,
 		defaultValue: "",
-		card: "main-model"
+		card: "main-model",
+		storageLayer: "agent-request"
 	},
 	subagentReasoningEffort: {
 		kind: "string",
 		defaultValue: "",
-		card: "subagent-model"
+		card: "subagent-model",
+		storageLayer: "subagent-start"
 	},
 	subagentTemperature: {
 		kind: "number",
 		check: FINITE_NUMBER,
 		defaultValue: "",
-		card: "subagent-model"
+		card: "subagent-model",
+		storageLayer: "subagent-start"
 	},
 	subagentMaxTokens: {
 		kind: "number",
 		check: POSITIVE_INTEGER,
 		defaultValue: "",
-		card: "subagent-model"
+		card: "subagent-model",
+		storageLayer: "subagent-start"
 	},
 	maxDepth: {
 		kind: "max-depth",
 		defaultValue: "",
-		card: "subagent-tools"
-	},
-	firstTurnWord: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	buildPattern: {
-		kind: "pattern",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	complexPattern: {
-		kind: "pattern",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	firstTurnBuild: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	firstTurnInspect: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	firstTurnDeep: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	guideWeak: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
-	},
-	guideDeep: {
-		kind: "string",
-		defaultValue: "",
-		card: "prompt-defaults"
+		card: "subagent-tools",
+		storageLayer: "subagent-start"
 	},
 	instructionHint: {
 		kind: "boolean",
 		defaultValue: false,
 		card: "prompt-defaults",
+		storageLayer: "pre-step",
 		module: {
 			row: "instruction-hint",
 			key: "enabled"
 		}
 	},
-	strReplaceEditorMaxOutputChars: {
-		kind: "number",
-		check: POSITIVE_INTEGER,
-		defaultValue: 16e3,
-		card: "str-replace-editor",
-		module: {
-			row: "str-replace-editor",
-			key: "maxOutputChars",
-			mode: "editor-default"
-		}
-	},
 	toolGitBashEnabled: {
 		kind: "boolean",
 		defaultValue: true,
 		card: "tool-git-bash",
+		storageLayer: "tool-pipeline",
 		module: {
 			row: "tool-git-bash",
 			key: "enabled"
@@ -216,6 +235,7 @@ const ENGINE_PARAM_DEFINITIONS = {
 		],
 		defaultValue: "",
 		card: "tool-config-engine",
+		storageLayer: "tool-pipeline",
 		module: {
 			row: "tool-config-engine",
 			key: "requireApproval"
@@ -224,7 +244,7 @@ const ENGINE_PARAM_DEFINITIONS = {
 };
 const ENGINE_PARAM_KEYS = Object.keys(ENGINE_PARAM_DEFINITIONS);
 /** writePreset.runtimeOf 实际透传键：全部引擎参数可直接进入 writer。 */
-const WRITER_PARAM_KEYS = ENGINE_PARAM_KEYS;
+const WRITER_PARAM_KEYS = [...ENGINE_PARAM_KEYS, ...LEGACY_PROMPT_PARAM_KEYS];
 /** 已有逗号分隔/flow-array 语义，client 与生成器共享。 */
 function engineParamList(value) {
 	if (Array.isArray(value)) return value.map(String).filter((item) => item.length > 0);
@@ -240,10 +260,6 @@ function buildEngineModuleParams(params) {
 		const binding = definition.module;
 		if (binding === void 0) continue;
 		let value = params[key];
-		if (binding.mode === "editor-default") {
-			if (typeof value === "string" && value.trim().length > 0) value = Number(value);
-			if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) continue;
-		}
 		if (value === void 0 || value === null) continue;
 		if (definition.kind === "boolean") value = value === true;
 		else if (definition.kind === "string-list") value = engineParamList(value);
@@ -321,11 +337,11 @@ function validateEngineParamValues(overrides) {
 	const errors = [];
 	for (const [key, value] of Object.entries(overrides)) {
 		if (value === void 0 || value === null) continue;
-		const rule = Object.hasOwn(ENGINE_PARAM_DEFINITIONS, key) ? ENGINE_PARAM_DEFINITIONS[key] : void 0;
+		const rule = Object.hasOwn(ENGINE_PARAM_DEFINITIONS, key) ? ENGINE_PARAM_DEFINITIONS[key] : isLegacyPromptParam(key) ? LEGACY_PROMPT_PARAM_DEFINITIONS[key] : void 0;
 		if (rule === void 0) {
 			errors.push({
 				key,
-				message: `${key}: 未知参数键，请按当前参数定义更新预设`
+				message: `${key}: 未知参数键，请按当前参数定义更新模块`
 			});
 			continue;
 		}
@@ -405,12 +421,6 @@ const ENGINE_CAPABILITIES = [
 			}
 		}
 	},
-	{
-		id: "str-replace-editor",
-		moduleKeys: ["filesystem-editor"],
-		rowIds: ["str-replace-editor"],
-		displayLayer: "tool-pipeline"
-	},
 	{
 		id: "tool-config-engine",
 		moduleKeys: ["tool-config-engine"],
@@ -426,7 +436,7 @@ const ENGINE_CAPABILITIES = [
 ];
 /**
 * 非能力编辑组的主归属。能力组不在这里重复登记：它们的 displayLayer 由能力定义本身承载
-* （例如「编辑器输出上限」参数的 card 就是能力 id `str-replace-editor`，已随能力登记）。
+* （例如工具批准策略的 card 就是能力 id `tool-config-engine`，已随能力登记）。
 */
 const ENGINE_EDITOR_GROUPS = [
 	{
@@ -452,9 +462,8 @@ const ENGINE_EDITOR_GROUPS = [
 	},
 	{
 		id: "subagent-model",
-		displayLayer: "subagent-start",
-		relatedLayers: ["agent-request"],
-		hook: "subagent-start"
+		displayLayer: "agent-request",
+		hook: "agent-request"
 	},
 	{
 		id: "subagent-tools",
@@ -493,10 +502,10 @@ function engineRecipe(id) {
 	return ENGINE_RECIPES.find((recipe) => recipe.id === id);
 }
 /**
-* 预设里显式写了的引擎参数 / 行配置所隐含的模块：**参数在 ⇒ 装配在**。
+* 模块里显式写了的引擎参数 / 行配置所隐含的模块：**参数在 ⇒ 装配在**。
 *
 * 只认显式声明（`params` 的登记参数键与 `moduleConfigs` 的行键），组合源自带的默认值不算——
-* 否则任何预设都会把全部能力装回来。返回能力拥有的模块 id（去重，顺序稳定）。
+* 否则任何模块都会把全部能力装回来。返回能力拥有的模块 id（去重，顺序稳定）。
 * 装配入口、模块事实与"移除能力"三处共用这一份派生，避免各自判断漂移。
 */
 function impliedModulesForParams(params, moduleConfigs) {
@@ -519,7 +528,7 @@ function impliedModulesForParams(params, moduleConfigs) {
 	if (moduleConfigs !== void 0 && moduleConfigs !== null) for (const rowId of Object.keys(moduleConfigs)) addRow(rowId);
 	return [...implied];
 }
-/** 显式模块预设中的实际能力；包含当前参数与顶层策略所需的装配。
+/** 显式模块声明中的实际能力；包含当前参数与顶层策略所需的装配。
 *  创建补声明由 host 单独检查 declaredModules；官方组合行不伪装成可编辑能力。 */
 function isEngineCapabilityPresent(id, facts) {
 	if (facts === void 0 || facts.sourceMode !== "explicit") return false;
@@ -582,10 +591,15 @@ function personaRowConfig(persona) {
 }
 //#endregion
 //#region src/shared/preset-ids.ts
-/** 包内模板、用户副本与当前预设共用同名 ID；避免与宿主官方预设重名。 */
-const DEFAULT_PRESET_ID = "pt-standard";
+/**
+* 包内模块与用户副本共用同名 ID；避免与宿主官方预设重名。
+*
+* 内置模块随包分发在仓库根的 `modules/`。旧的内置预设 `pt-*` 已整体退场——它们是官方
+* 预设形态的遗留，重构后不再读取也不再维护；这里指向当前随包分发的内置模块作为兜底。
+*/
+const DEFAULT_MODULE_ID = "ponytail";
 //#endregion
-//#region src/host/preset-install.ts
+//#region src/host/module-install.ts
 function assertPresetId(id) {
 	if (typeof id !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(id)) throw new Error(`非法预设 id：${String(id)}；必须为小写字母、数字和连字符`);
 }
@@ -624,7 +638,7 @@ function canonicalPresetRoot(root, allowMissing = false) {
 	return realpathSync(absoluteRoot);
 }
 /** 根与目标先解析真实路径，拒绝链接目录及定义身份不一致。 */
-function assertPresetDirectory(root, id, allowMissing = false) {
+function assertModuleDirectory(root, id, allowMissing = false) {
 	assertPresetId(id);
 	const canonicalRoot = canonicalPresetRoot(root, allowMissing);
 	const target = join(canonicalRoot, id);
@@ -635,7 +649,7 @@ function assertPresetDirectory(root, id, allowMissing = false) {
 	const stat = lstatSync(target);
 	if (stat.isSymbolicLink() || !stat.isDirectory() || dirname(realpathSync(target)) !== canonicalRoot) throw new Error(`预设路径包含链接或越界：${id}`);
 	if (!readdirSync(canonicalRoot).includes(id)) throw new Error(`预设目录身份不匹配：${id}`);
-	const definition = join(target, "preset.yml");
+	const definition = join(target, MODULE_DEFINITION_FILE);
 	const fileStat = lstatSync(definition);
 	if (fileStat.isSymbolicLink() || !fileStat.isFile()) throw new Error(`预设定义不是普通文件：${id}`);
 	const doc = parseDocument(readFileSync(definition, "utf8"), { logLevel: "silent" });
@@ -676,7 +690,7 @@ function engineModuleFileNames(dir) {
 const ENGINE_MANAGED_PATHS = {
 	"prompt-config-engine.mjs": {
 		field: "configsDir",
-		directory: "prompt-configs"
+		directory: MODULE_CONFIGS_DIR
 	},
 	"tool-config-engine.mjs": {
 		field: "configsDir",
@@ -752,12 +766,10 @@ function rewritePresetEngineReferences(raw, outputId, engineFiles) {
 	return changed ? doc.toString() : raw;
 }
 //#endregion
-//#region src/host/preset-layer-settings.ts
-/** 预设磁盘参数：按编辑组主归属层存储，运行时仍使用 EngineParams 平铺接口。 */
+//#region src/host/module-layer-settings.ts
+/** 模块磁盘参数：按稳定存储层归属，运行时仍使用 EngineParams 平铺接口。 */
 const ENGINE_PARAM_LAYERS = Object.fromEntries(ENGINE_PARAM_KEYS.map((key) => {
-	const layer = ENGINE_EDITOR_GROUP_MAP.find((group) => group.id === ENGINE_PARAM_DEFINITIONS[key].card)?.displayLayer;
-	if (layer === void 0) throw new Error(`引擎参数未登记所属层：${key}`);
-	return [key, layer];
+	return [key, ENGINE_PARAM_DEFINITIONS[key].storageLayer];
 }));
 var PresetLayerSettingsError = class extends Error {
 	code = "preset-layer-settings-invalid";
@@ -766,7 +778,7 @@ var PresetLayerSettingsError = class extends Error {
 		this.name = "PresetLayerSettingsError";
 	}
 };
-const isRecord$3 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isRecord$4 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 function engineParamPath(key) {
 	if (!Object.prototype.hasOwnProperty.call(ENGINE_PARAM_LAYERS, key)) throw new Error(`未知引擎参数：${key}`);
 	return [
@@ -781,11 +793,11 @@ function readLayerSettings(value) {
 		throw new PresetLayerSettingsError(message);
 	};
 	if (value === void 0) return {};
-	if (!isRecord$3(value)) return invalid("layerSettings 必须是对象");
+	if (!isRecord$4(value)) return invalid("layerSettings 必须是对象");
 	const params = {};
 	for (const [layer, settings] of Object.entries(value)) {
 		if (!ENGINE_LAYER_ORDER.includes(layer)) invalid(`未知插入点：layerSettings.${layer}`);
-		if (!isRecord$3(settings)) return invalid(`layerSettings.${layer} 必须是对象`);
+		if (!isRecord$4(settings)) return invalid(`layerSettings.${layer} 必须是对象`);
 		for (const [key, entry] of Object.entries(settings)) {
 			if (!Object.prototype.hasOwnProperty.call(ENGINE_PARAM_LAYERS, key)) continue;
 			const expected = ENGINE_PARAM_LAYERS[key];
@@ -797,7 +809,7 @@ function readLayerSettings(value) {
 }
 /** 仅消费当前 layerSettings；其余段作为未知字段留存，不投影为运行时参数。 */
 function readPresetLayerSettings(source) {
-	if (!isRecord$3(source)) throw new PresetLayerSettingsError("preset.yml 必须是对象");
+	if (!isRecord$4(source)) throw new PresetLayerSettingsError("preset.yml 必须是对象");
 	return readLayerSettings(source.layerSettings);
 }
 //#endregion
@@ -7990,6 +8002,22 @@ function getSessionVar(session, key) {
 	return vars === void 0 || !Object.hasOwn(vars, String(key)) ? void 0 : vars[String(key)];
 }
 //#endregion
+//#region engine/order.mjs
+/** 加载器私有元数据：不进入 YAML、公共配置或客户端载荷。 */
+const FILE_SEQUENCE = Symbol("prompt-tool:file-sequence");
+const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+/** 模块配置按持久序号执行；无物化来源的独立调用保留原 order 语义。 */
+function compareConfigSequence(a, b) {
+	const difference = (a.sequence ?? a.order ?? 0) - (b.sequence ?? b.order ?? 0);
+	if (difference !== 0) return difference;
+	if (a.sourceModuleId === void 0 && b.sourceModuleId === void 0) return 0;
+	return compareText(a.sourceModuleId ?? "", b.sourceModuleId ?? "") || compareText(a.id, b.id);
+}
+/** 官方文本段的定位仍由 order 决定；序号只提供同位置的稳定顺序。 */
+function compareTextPlacement(a, b) {
+	return a.order - b.order || compareConfigSequence(a, b);
+}
+//#endregion
 //#region engine/st-render.mjs
 /** ST 模板变量帧：只求值显式导入的模板，不决定任何官方插入点的执行顺序。 */
 function visible(config, agent) {
@@ -8098,7 +8126,7 @@ function attachStRenderers(configs) {
 			frame.evaluate = evaluate;
 			if (session) sessions.set(session, frame);
 		}
-		for (const config of templates.filter((config) => approved(config) && config.strategy === "static" && config.dedupe === "none" && !frame.text.has(config)).sort((a, b) => a.order - b.order)) frame.evaluate(config);
+		if (target.sequence === void 0 || eligible === void 0) for (const config of templates.filter((config) => approved(config) && config.strategy === "static" && config.dedupe === "none" && !frame.text.has(config)).sort(compareConfigSequence)) frame.evaluate(config);
 		if (token && typeof token === "object") tokens.set(token, frame);
 		if (!frame.text.has(target)) frame.evaluate(target);
 		return frame.text.get(target) ?? "";
@@ -8154,6 +8182,15 @@ function loadTemplate(file, baseUrl = import.meta.url, presetRootUrl) {
 	return { text: raw };
 }
 /**
+* 完整 YAML 解析(vendored yaml 包):提示词配置文件直接使用标准 YAML。
+* 支持缩进 map、列表、block scalar、行尾注释、引号转义等全部语法。
+*/
+function parsePromptConfigYaml(raw) {
+	const parsed = parse$1(raw);
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new TypeError(`${name$2}: prompt config yaml must contain a single object`);
+	return parsed;
+}
+/**
 * 枚举提示词配置候选文件：**两条加载路径共用同一份枚举规则**。
 *
 * 扩展名、排序与跳过名单必须两侧一致——否则 host（编辑/列举）与引擎（注入）会看到不同的
@@ -8169,6 +8206,44 @@ function loadTemplate(file, baseUrl = import.meta.url, presetRootUrl) {
 function promptConfigFileNames(entries) {
 	return entries.filter((entry) => entry.isFile() && /\.(ya?ml|json)$/i.test(entry.name)).sort((a, b) => a.name.localeCompare(b.name)).map((entry) => entry.name).filter((fileName) => fileName !== "variables.yml");
 }
+/**
+* 从提示词配置模块目录加载全部提示词配置描述:按文件名排序扫描 *.yml / *.yaml / *.json。
+* 文件名用数字前缀表达引擎执行顺序(00-…、10-…)。
+*/
+function loadPromptConfigFiles(dirUrl) {
+	let entries;
+	try {
+		entries = readdirSync(dirUrl, { withFileTypes: true });
+	} catch (error) {
+		throw new TypeError(`${name$2}: configsDir ${String(dirUrl)} is not readable: ${String(error?.message ?? error)}`);
+	}
+	let presetVariables = {};
+	try {
+		const parsed = parse$1(readFileSync(new URL("variables.yml", dirUrl), "utf8"));
+		if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) presetVariables = parsed;
+	} catch {}
+	const specs = [];
+	for (const fileName of promptConfigFileNames(entries)) {
+		const raw = readFileSync(new URL(fileName, dirUrl), "utf8");
+		const spec = /\.json$/i.test(fileName) ? JSON.parse(raw) : parsePromptConfigYaml(raw);
+		const prefix = /^(\d+)-/.exec(fileName);
+		if (prefix !== null && spec !== null && typeof spec === "object" && !Array.isArray(spec)) {
+			const sequence = Number(prefix[1]);
+			if (!Number.isSafeInteger(sequence)) throw new TypeError(`${name$2}: unsafe config sequence in ${fileName}`);
+			Object.defineProperty(spec, FILE_SEQUENCE, { value: sequence });
+		}
+		specs.push(spec);
+	}
+	for (const spec of specs) {
+		if (spec === null || typeof spec !== "object" || Array.isArray(spec)) continue;
+		const own = spec.variables !== null && typeof spec.variables === "object" && !Array.isArray(spec.variables) ? spec.variables : {};
+		spec.variables = {
+			...presetVariables,
+			...own
+		};
+	}
+	return specs;
+}
 const KNOWN_STRATEGIES = /* @__PURE__ */ new Set([
 	"static",
 	"placeholder",
@@ -8860,6 +8935,9 @@ function createPromptConfigs(specs, options = {}) {
 			templatePatch,
 			params
 		};
+		const sequence = (Object.hasOwn(options.configOrder ?? {}, spec.id) ? options.configOrder[spec.id] : void 0) ?? spec[FILE_SEQUENCE] ?? (typeof options.sourceModuleId === "string" ? index * 10 : void 0);
+		if (sequence !== void 0) config.sequence = sequence;
+		if (typeof options.sourceModuleId === "string") config.sourceModuleId = options.sourceModuleId;
 		config.matchScan = match === void 0 ? void 0 : createAnchorMatcher(match).scan;
 		config.resolve = bindResolver(config, options.strategyDir);
 		return config;
@@ -8867,6 +8945,7 @@ function createPromptConfigs(specs, options = {}) {
 		config,
 		fileOrder
 	})).sort((a, b) => {
+		if (a.config.sequence !== void 0 || b.config.sequence !== void 0) return compareConfigSequence(a.config, b.config) || a.fileOrder - b.fileOrder;
 		const aAnchor = a.config.configKind === "anchor" ? 0 : 1;
 		const bAnchor = b.config.configKind === "anchor" ? 0 : 1;
 		if (aAnchor !== bAnchor) return aAnchor - bAnchor;
@@ -8933,6 +9012,10 @@ function modelRequestConfigs(params) {
 		params: { patch: mainPatch }
 	});
 	const subagentPatch = patchOf("subagent");
+	if (typeof params.subagentModelProvider === "string" && params.subagentModelProvider.trim().length > 0 && typeof params.subagentModelName === "string" && params.subagentModelName.trim().length > 0) {
+		subagentPatch.provider = params.subagentModelProvider.trim();
+		subagentPatch.model = params.subagentModelName.trim();
+	}
 	if (Object.keys(subagentPatch).length > 0) configs.push({
 		id: "subagent-model-params",
 		name: "模型参数（子代理）",
@@ -9079,6 +9162,112 @@ function listPromptConfigSpecs(dir) {
 	return specs;
 }
 //#endregion
+//#region src/host/legacy-prompt-params.ts
+/** 旧层参数到规则实例的唯一兼容投影；读取、导入物化与旧 API 保存共用。 */
+const isRecord$3 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const text = (value) => value === void 0 || value === null ? "" : String(value);
+function readLegacyPromptParams(source) {
+	const params = {};
+	if (!isRecord$3(source.layerSettings)) return params;
+	for (const [layer, settings] of Object.entries(source.layerSettings)) {
+		if (!isRecord$3(settings)) continue;
+		for (const [key, value] of Object.entries(settings)) {
+			if (!isLegacyPromptParam(key)) continue;
+			if (layer !== "pre-step") throw new PresetLayerSettingsError(`${key} 必须位于 layerSettings.pre-step`);
+			params[key] = value === "on" ? true : value === "off" ? false : value;
+		}
+	}
+	return params;
+}
+function legacyBody(source, moduleDir, supplied) {
+	if (supplied !== void 0) return supplied;
+	if (moduleDir !== void 0) try {
+		const file = join(moduleDir, "preset.md");
+		if (lstatSync(file).isSymbolicLink()) throw new Error(`旧模块正文不能是链接：${file}`);
+		return readFileSync(file, "utf8");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	return text(source.content?.presetText);
+}
+function resolveLegacyPromptConfigs(source, options = {}) {
+	const params = readLegacyPromptParams(source);
+	for (const [key, value] of Object.entries(options.overrides ?? {})) if (isLegacyPromptParam(key) && value !== void 0 && value !== null) params[key] = value;
+	const keys = LEGACY_PROMPT_PARAM_KEYS.filter((key) => Object.hasOwn(params, key));
+	const applies = (id) => keys.some((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.includes(id));
+	const provided = (key) => options.partial !== true || Object.hasOwn(params, key);
+	const projected = (source.promptConfigs ?? []).map((config) => {
+		if (!isRecord$3(config) || !applies(config.id)) return config;
+		const next = {
+			...config,
+			params: { ...config.params }
+		};
+		if (config.id === "near-anchor") {
+			if (provided("firstTurnAnchor")) next.enabled = params.firstTurnAnchor === true;
+			if (provided("firstTurnCustom")) next.params.useCustom = params.firstTurnCustom === true;
+			if (provided("firstTurnText")) next.params.text = text(params.firstTurnText);
+			for (const key of [
+				"buildPattern",
+				"complexPattern",
+				"firstTurnBuild",
+				"firstTurnInspect",
+				"firstTurnDeep"
+			]) if (provided(key)) next.params[key] = text(params[key]);
+		} else if (config.id === "router-guide") {
+			if (provided("guideEnabled")) next.enabled = params.guideEnabled === true;
+			if (provided("guideCustom") || provided("guideEnabled")) {
+				const useCustom = provided("guideCustom") ? params.guideCustom === true : next.params.useCustom === true;
+				next.params.useCustom = useCustom;
+				next.modelScope = useCustom ? "all" : "flash";
+			}
+			if (provided("guideText")) next.params.text = text(params.guideText);
+			for (const key of [
+				"complexPattern",
+				"guideWeak",
+				"guideDeep"
+			]) if (provided(key)) next.params[key] = text(params[key]);
+		}
+		return next;
+	});
+	const configs = mergePromptConfigs(projected, options.promptConfigs).map((config) => {
+		if (config.id !== "prompt-injector" || !applies(config.id)) return config;
+		const body = legacyBody(source, options.moduleDir, options.prompt);
+		const explicitWord = text(options.partial === true && Object.hasOwn(params, "firstTurnWord") ? params.firstTurnWord : config.params?.firstTurnWord ?? params.firstTurnWord);
+		const anchor = projected.find((entry) => entry.id === "near-anchor");
+		const signalWord = (value) => {
+			const sentence = /the exact sentence:\s*([A-Za-z]+)/i.exec(value);
+			const first = /^\P{L}*([\p{L}]+)/u.exec(value.trim());
+			return (sentence?.[1] ?? first?.[1])?.toLowerCase();
+		};
+		const derivedWords = [...new Set([
+			"firstTurnText",
+			"firstTurnBuild",
+			"firstTurnInspect",
+			"firstTurnDeep"
+		].map((key) => signalWord(text(Object.hasOwn(params, key) || options.partial !== true ? params[key] : anchor?.params?.[key === "firstTurnText" ? "text" : key]))).filter((word) => word !== void 0))];
+		const { text: _text, texts: _texts, ...rest } = config;
+		return {
+			...rest,
+			enabled: body.trim().length > 0 && (provided("injectPrompt") ? params.injectPrompt !== false : config.enabled !== false),
+			params: {
+				...config.params,
+				text: body,
+				firstTurnWord: explicitWord,
+				anchorWords: explicitWord.length > 0 ? [explicitWord] : derivedWords
+			}
+		};
+	});
+	const ids = new Set(configs.map((config) => config.id));
+	const consumedKeys = keys.filter((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.some((id) => ids.has(id)));
+	const unhandled = keys.filter((key) => !consumedKeys.includes(key));
+	return {
+		configs,
+		consumedKeys,
+		active: keys.length > 0,
+		warnings: unhandled.length === 0 ? [] : [`旧规则参数没有承接配置，原值保留：${unhandled.join(", ")}`]
+	};
+}
+//#endregion
 //#region src/host/text-file.ts
 /** 共用原子文本替换；来源授权与内容合法性由各领域调用方负责。 */
 function atomicWriteTextFile(file, content, options = {}) {
@@ -9099,24 +9288,38 @@ function atomicWriteTextFile(file, content, options = {}) {
 //#endregion
 //#region src/host/manifest.ts
 /**
-* manifest — 预设模板单一参数 YAML(preset.yml)的加载与引擎参数解析。
+* manifest — 模块模板单一参数 YAML(module.yml)的加载与引擎参数解析。
 *
-* 一个预设 = 一个 preset.yml:
+* 一个模块 = 一个 module.yml:
 *   - modules/layerSettings/content/meta 全部是直读参数,无模板语法;
 *   - layerSettings 展平为内部 params，供引擎生成默认提示词配置，promptConfigs 仅为可选覆盖;
 *   - 组合模块的行级 config 由参数桥 buildModuleConfigsFromParams 按 params
 *     构造对象合并（取代旧 __TOKEN__ 文本渲染，无占位符、无文本往返），
 *     params（UI/基础层）优先于 moduleConfigs 行级直写（旧作者锁定语义已移除）。
-* 本模块负责参数归一化与引擎模块配置装配;所有预设专属行为都在引擎内部。
+* 本模块负责参数归一化与引擎模块配置装配;所有模块专属行为都在引擎内部。
+*/
+/**
+* 模块目录确实存在于本插件存储根（身份判定与官方登记状态无关）。
+*
+* 启用表过滤、工具写入目标、TUI 目标共用这一条判据：本插件管理的模块 = 存储根里含
+* `module.yml` 的目录，与「宿主有没有把它登记成官方预设」是两回事。
+*/
+function moduleDirExists(root, id) {
+	return statSync(join(root, id, MODULE_DEFINITION_FILE), { throwIfNoEntry: false }) !== void 0;
+}
+/**
+* 包根 `modules/` 目录：随包分发的**内置模块库**（模块目录形态与存储根同构）。
+*
+* 兼容源码运行（`src/host/`）与打包运行（`lib/`）。旧的内置预设目录 `preset/` 已整体
+* 退场——那些是官方预设形态的遗留，重构后不再读取也不再维护。
 */
-/** 包根 preset/ 目录(配置/模板文件夹):兼容源码运行(src/host)与打包运行(lib/)。 */
-function packagePresetDir() {
-	const candidates = [new URL("../preset/", import.meta.url), new URL("../../preset/", import.meta.url)];
+function packageModulesDir() {
+	const candidates = [new URL("../modules/", import.meta.url), new URL("../../modules/", import.meta.url)];
 	for (const candidate of candidates) {
 		const dir = fileURLToPath(candidate);
 		if (existsSync(dir)) return dir;
 	}
-	throw new Error("prompt-tool: cannot locate package preset/ directory");
+	throw new Error("prompt-tool: cannot locate package modules/ directory");
 }
 /** 包根 engine/ 目录(插件引擎,与配置文件夹分离):兼容源码与打包运行。 */
 function packageEngineDir() {
@@ -9129,20 +9332,20 @@ function packageEngineDir() {
 }
 /**
 * preset.yml 读缓存：按 mtime+size 签名失效。load()/describe/param-overrides 等
-* 每次请求读盘解析，加缓存后同一文件只解析一次；写盘路径（savePresetParams /
+* 每次请求读盘解析，加缓存后同一文件只解析一次；写盘路径（saveModuleParams /
 * withPresetDoc）与外部编辑（stat 签名变化）都会正确失效。
 */
 const presetSpecCache = /* @__PURE__ */ new Map();
 /** 写盘后失效缓存（调用方在写完 preset.yml 后调用；不调用也安全——stat 签名兜底）。 */
-function invalidatePresetSpec(dir) {
-	presetSpecCache.delete(join(dir, "preset.yml"));
+function invalidateModuleSpec(dir) {
+	presetSpecCache.delete(join(dir, MODULE_DEFINITION_FILE));
 }
 /**
-* 从预设 preset.yml 的 modules 清单移除一个模块 id（YAML Document 保留注释
+* 从模块 module.yml 的 modules 清单移除一个模块 id（YAML Document 保留注释
 * 与其余字段）。返回是否发生修改；文件缺失或没有该模块时返回 false。
 */
 function removePresetModule(dir, moduleId) {
-	const file = join(dir, "preset.yml");
+	const file = join(dir, MODULE_DEFINITION_FILE);
 	if (!existsSync(file)) return false;
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
 	if (doc.errors.length > 0) return false;
@@ -9153,12 +9356,21 @@ function removePresetModule(dir, moduleId) {
 	if (kept.length === modules.items.length) return false;
 	modules.items = kept;
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(dir);
+	invalidateModuleSpec(dir);
 	return true;
 }
-/** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
-function loadPresetSpec(dir) {
-	const file = join(dir, "preset.yml");
+/** 加载某个模块模板的单一参数文件 modules/<name>/module.yml。 */
+function loadModuleSpec(dir, options = {}) {
+	const project = (spec) => {
+		if (options.legacyParams === false) return spec;
+		const legacy = resolveLegacyPromptConfigs(spec, { moduleDir: dir });
+		return legacy.active ? {
+			...spec,
+			...Array.isArray(spec.promptConfigs) ? { promptConfigs: legacy.configs } : {},
+			legacyParamWarnings: legacy.warnings
+		} : spec;
+	};
+	const file = join(dir, MODULE_DEFINITION_FILE);
 	let stat;
 	try {
 		stat = statSync(file);
@@ -9166,7 +9378,7 @@ function loadPresetSpec(dir) {
 		throw new Error(`preset.yml not found in ${dir}（预设模板不存在或目录不完整）`);
 	}
 	const cached = presetSpecCache.get(file);
-	if (cached !== void 0 && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) return cached.spec;
+	if (cached !== void 0 && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) return project(cached.spec);
 	const raw = readFileSync(file, "utf8");
 	let parsed;
 	try {
@@ -9174,58 +9386,43 @@ function loadPresetSpec(dir) {
 	} catch (error) {
 		throw new Error(`preset ${file} YAML 解析失败: ${String(error.message ?? error)}`);
 	}
-	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`preset ${join(dir, "preset.yml")} is not a YAML map`);
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`preset ${join(dir, MODULE_DEFINITION_FILE)} is not a YAML map`);
 	if (typeof parsed.id !== "string" || parsed.id.length === 0) parsed.id = basename(dir);
 	const params = readPresetLayerSettings(parsed);
+	readLegacyPromptParams(parsed);
 	if (parsed.layerSettings !== void 0 || parsed.params !== void 0) parsed.params = params;
 	presetSpecCache.set(file, {
 		mtimeMs: stat.mtimeMs,
 		size: stat.size,
 		spec: parsed
 	});
-	return parsed;
-}
-/** 读取预设模板内容资产(presetText / agentsText);模板缺失时静默降级。
-*  模板目录按 resolvePresetDir 解析（用户自定义预设优先，包内模板回退）。 */
-function loadPresetContent(template = DEFAULT_PRESET_ID, presetRoot = userPresetsDir()) {
-	try {
-		const spec = loadPresetSpec(resolvePresetDir(template, presetRoot));
-		return {
-			presetText: typeof spec.content?.presetText === "string" ? spec.content.presetText : "",
-			agentsText: typeof spec.content?.agentsText === "string" ? spec.content.agentsText : ""
-		};
-	} catch {
-		return {
-			presetText: "",
-			agentsText: ""
-		};
-	}
+	return project(parsed);
 }
 const asString = (value, fallback = "") => {
 	if (typeof value === "string") return value;
 	if (value === void 0 || value === null) return fallback;
 	return String(value);
 };
-/** 预设根：官方 USER_PRESET_DIR（~/.dsh/.agent-presets），导入/新建/种子化的预设都放这里。 */
-function userPresetsDir() {
-	return DEFAULT_PRESET_DIR;
+/** 模块根：本插件的存储根（~/.dsh/.prompt-tool），导入/新建/种子化的模块都放这里。 */
+function userModulesDir() {
+	return MODULES_DIR;
 }
 /** 只按合法目录身份定位；现存坏身份必须报错，不能绕到同名模板。 */
 function findPresetDir(scanDir, template) {
-	const exact = assertPresetDirectory(scanDir, template, true);
+	const exact = assertModuleDirectory(scanDir, template, true);
 	return presetPathExists(exact) ? exact : void 0;
 }
 /**
-* 解析预设模板目录：当前预设根优先，包内模板回退；不读取其他部署根的同名预设。
+* 解析模块模板目录：当前模块根优先，包内模板回退；不读取其他部署根的同名模块。
 * 目录名与声明的 preset.yml id 一致；不扫描其他目录的 id 别名。
 */
-function resolvePresetDir(template, presetRoot = userPresetsDir()) {
-	return findPresetDir(presetRoot, template) ?? findPresetDir(packagePresetDir(), template) ?? join(packagePresetDir(), template);
+function resolveModuleDir(template, moduleRoot = userModulesDir()) {
+	return findPresetDir(moduleRoot, template) ?? findPresetDir(packageModulesDir(), template) ?? join(packageModulesDir(), template);
 }
-/** 预设目录是否含组合源：modules、composition 或官方 agent.cordis.yml。 */
+/** 模块目录是否含组合源：modules、composition 或官方 agent.cordis.yml。 */
 function isRenderablePresetDir(dir) {
 	try {
-		const spec = loadPresetSpec(dir);
+		const spec = loadModuleSpec(dir);
 		if (Array.isArray(spec.modules)) return true;
 		if (typeof spec.composition === "string" && spec.composition.length > 0) return true;
 	} catch (error) {
@@ -9234,13 +9431,13 @@ function isRenderablePresetDir(dir) {
 	}
 	return existsSync(join(dir, "agent.cordis.yml"));
 }
-/** 本插件预设清单；所有目录按同一身份与组合源规则列举。 */
-function listPresets(presetRoot = userPresetsDir()) {
+/** 本插件模块清单；所有目录按同一身份与组合源规则列举。 */
+function listModules(moduleRoot = userModulesDir()) {
 	const scan = (dir) => {
 		try {
 			return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && /^[a-z0-9][a-z0-9-]*$/.test(entry.name)).flatMap((entry) => {
 				try {
-					const spec = loadPresetSpec(assertPresetDirectory(dir, entry.name));
+					const spec = loadModuleSpec(assertModuleDirectory(dir, entry.name));
 					if (typeof spec.id !== "string" || spec.id.length === 0) return [];
 					return [{
 						id: entry.name,
@@ -9259,15 +9456,15 @@ function listPresets(presetRoot = userPresetsDir()) {
 		}
 	};
 	const byId = /* @__PURE__ */ new Map();
-	for (const preset of scan(presetRoot)) byId.set(preset.id, preset);
+	for (const preset of scan(moduleRoot)) byId.set(preset.id, preset);
 	return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
 }
-/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在预设列表）。 */
+/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在模块列表）。 */
 function listBuiltinTemplates() {
 	try {
-		return readdirSync(packagePresetDir(), { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "pt-custom").flatMap((entry) => {
+		return readdirSync(packageModulesDir(), { withFileTypes: true }).filter((entry) => entry.isDirectory()).flatMap((entry) => {
 			try {
-				const spec = loadPresetSpec(join(packagePresetDir(), entry.name));
+				const spec = loadModuleSpec(join(packageModulesDir(), entry.name));
 				return [{
 					id: entry.name,
 					name: spec.name
@@ -9280,16 +9477,16 @@ function listBuiltinTemplates() {
 		return [];
 	}
 }
-/** 按包内同名目录补建缺失预设；已有目录的定义、生成物和资源保持原样。 */
-function ensurePresetSeed(root = userPresetsDir()) {
+/** 按包内同名目录补建缺失的内置模块；已有目录的定义、生成物和资源保持原样。 */
+function ensurePresetSeed(root = userModulesDir()) {
 	const created = [];
 	try {
 		mkdirSync(root, { recursive: true });
-		for (const entry of readdirSync(packagePresetDir(), { withFileTypes: true })) {
+		for (const entry of readdirSync(packageModulesDir(), { withFileTypes: true })) {
 			if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
 			const target = join(root, entry.name);
 			if (existsSync(target)) continue;
-			cpSync(join(packagePresetDir(), entry.name), target, { recursive: true });
+			cpSync(join(packageModulesDir(), entry.name), target, { recursive: true });
 			created.push(entry.name);
 		}
 	} catch {}
@@ -9298,14 +9495,14 @@ function ensurePresetSeed(root = userPresetsDir()) {
 /** 完整复制到隐藏候选；只更新定义 ID 和已知共享引擎配置位置。 */
 function copyPresetDirectory(source, root, targetId) {
 	assertPresetTree(source);
-	loadPresetSpec(source);
-	const target = assertPresetDirectory(root, targetId, true);
+	loadModuleSpec(source);
+	const target = assertModuleDirectory(root, targetId, true);
 	if (presetPathExists(target)) throw new Error(`目标预设已存在：${targetId}`);
 	mkdirSync(root, { recursive: true });
 	const candidate = mkdtempSync(join(root, `.${targetId}.copy-`));
 	try {
 		cpSync(source, candidate, { recursive: true });
-		const definition = join(candidate, "preset.yml");
+		const definition = join(candidate, MODULE_DEFINITION_FILE);
 		const doc = parseDocument(readFileSync(definition, "utf8"), { logLevel: "silent" });
 		if (doc.errors.length > 0 || !(doc.contents instanceof YAMLMap)) throw new Error("预设定义必须是合法 YAML 对象");
 		if (doc.get("id") !== targetId) {
@@ -9340,17 +9537,17 @@ function copyPresetDirectory(source, root, targetId) {
 		});
 	}
 }
-/** 从包内同名目录复制预设；autoSuffix=true 时递增目录名并同步定义身份。 */
-function cloneBuiltinPreset(id, autoSuffix = false, presetRoot = userPresetsDir()) {
+/** 从包内同名目录复制模块；autoSuffix=true 时递增目录名并同步定义身份。 */
+function cloneBuiltinPreset(id, autoSuffix = false, moduleRoot = userModulesDir()) {
 	try {
 		assertPresetId(id);
-		const builtin = findPresetDir(packagePresetDir(), id);
+		const builtin = findPresetDir(packageModulesDir(), id);
 		if (builtin === void 0) return {
 			ok: false,
 			message: `预设 ${id} 不是包内置预设`
 		};
 		let targetId = id;
-		let target = join(presetRoot, targetId);
+		let target = join(moduleRoot, targetId);
 		if (presetPathExists(target)) {
 			if (!autoSuffix) return {
 				ok: false,
@@ -9358,11 +9555,11 @@ function cloneBuiltinPreset(id, autoSuffix = false, presetRoot = userPresetsDir(
 			};
 			for (let suffix = 2;; suffix++) {
 				targetId = `${id}-${suffix}`;
-				target = join(presetRoot, targetId);
+				target = join(moduleRoot, targetId);
 				if (!presetPathExists(target)) break;
 			}
 		}
-		copyPresetDirectory(builtin, presetRoot, targetId);
+		copyPresetDirectory(builtin, moduleRoot, targetId);
 		return {
 			ok: true,
 			id: targetId
@@ -9374,14 +9571,14 @@ function cloneBuiltinPreset(id, autoSuffix = false, presetRoot = userPresetsDir(
 		};
 	}
 }
-/** 复制用户预设目录为新预设（id 自动递增：<id>-copy / <id>-copy-2 / …）。
+/** 复制用户模块目录为新模块（id 自动递增：<id>-copy / <id>-copy-2 / …）。
 *  复制的是用户目录完整副本（preset.yml / agent.cordis.yml / prompt-configs /
 *  内容资产 / 覆盖文件），与「从内置模板新建」互补：后者还原模板，前者备份现状。 */
-function duplicateUserPreset(id, presetRoot = userPresetsDir()) {
+function duplicateUserModule(id, moduleRoot = userModulesDir()) {
 	try {
 		assertPresetId(id);
-		const root = resolve(presetRoot);
-		const source = assertPresetDirectory(root, id);
+		const root = resolve(moduleRoot);
+		const source = assertModuleDirectory(root, id);
 		let targetId = `${id}-copy`;
 		let target = join(root, targetId);
 		for (let suffix = 2; presetPathExists(target); suffix++) {
@@ -9400,8 +9597,8 @@ function duplicateUserPreset(id, presetRoot = userPresetsDir()) {
 		};
 	}
 }
-/** 在系统文件管理器中打开预设目录（尽力而为：无桌面环境时打开失败也返回路径供 UI 展示）。 */
-function openPresetLocation(id, presetRoot = userPresetsDir()) {
+/** 在系统文件管理器中打开模块目录（尽力而为：无桌面环境时打开失败也返回路径供 UI 展示）。 */
+function openModuleLocation(id, moduleRoot = userModulesDir()) {
 	const isBareId = typeof id === "string" && /^[a-z0-9][a-z0-9-]*$/.test(id);
 	const isCardPath = typeof id === "string" && /^\/\.[a-zA-Z0-9_-]+\/[^/\\]+$/.test(id);
 	if (!isBareId && !isCardPath) return {
@@ -9409,8 +9606,8 @@ function openPresetLocation(id, presetRoot = userPresetsDir()) {
 		message: `非法预设 id：${id}`,
 		path: ""
 	};
-	const dir = resolve(join(presetRoot, id));
-	const rootResolved = resolve(presetRoot);
+	const dir = resolve(join(moduleRoot, id));
+	const rootResolved = resolve(moduleRoot);
 	if (dir !== rootResolved && !dir.startsWith(rootResolved + sep)) return {
 		ok: false,
 		message: `预设路径越界：${id}`,
@@ -9422,7 +9619,7 @@ function openPresetLocation(id, presetRoot = userPresetsDir()) {
 		path: dir
 	};
 	try {
-		if (isBareId) assertPresetDirectory(presetRoot, id);
+		if (isBareId) assertModuleDirectory(moduleRoot, id);
 		const command = process.platform === "win32" ? "explorer" : process.platform === "darwin" ? "open" : "xdg-open";
 		spawn(command, [dir], {
 			detached: true,
@@ -9445,24 +9642,41 @@ function deleteYamlPath(doc, path) {
 	if (doc.hasIn(path)) doc.deleteIn(path);
 }
 /**
-* 保存预设参数：写 layerSettings（merge）/ promptConfigs（整体替换）。
+* 保存模块参数：写 layerSettings（merge）/ promptConfigs（整体替换）。
 * parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键删除（'' / []，
 * 回落模板/引擎默认；0 与 false 照常写入——语义与函数内注释、docs §3 一致）。
 */
-function savePresetParams(presetRoot, templateName, params, promptConfigs, variables, variablesEnabled) {
-	const file = join(assertPresetDirectory(presetRoot, templateName), "preset.yml");
+function saveModuleParams(moduleRoot, templateName, params, promptConfigs, variables, variablesEnabled) {
+	const file = join(assertModuleDirectory(moduleRoot, templateName), MODULE_DEFINITION_FILE);
 	if (!existsSync(file)) throw new Error(`preset ${templateName} 无 preset.yml`);
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
 	readPresetLayerSettings(doc.toJS());
+	const previousLegacy = readLegacyPromptParams(doc.toJS());
+	const legacyOverrides = {};
 	if (params !== void 0) for (const [key, value] of Object.entries(params)) {
 		if (value === void 0 || value === null || key.trim().length === 0) continue;
 		const isEmpty = value === "" || Array.isArray(value) && value.length === 0;
-		const path = engineParamPath(key);
+		if (isLegacyPromptParam(key)) legacyOverrides[key] = value;
+		const path = isLegacyPromptParam(key) ? legacyPromptParamPath(key) : engineParamPath(key);
 		if (isEmpty) deleteYamlPath(doc, path);
 		else doc.setIn(path, value);
 	}
-	if (promptConfigs !== void 0) {
-		const cleaned = promptConfigs.map((config) => {
+	const source = doc.toJS();
+	const legacy = resolveLegacyPromptConfigs(source, {
+		moduleDir: join(moduleRoot, templateName),
+		overrides: legacyOverrides,
+		partial: Object.keys(previousLegacy).length === 0
+	});
+	const legacyWrite = Object.keys(legacyOverrides).length > 0 && legacy.consumedKeys.length > 0;
+	if (promptConfigs !== void 0 || legacyWrite) {
+		const cleaned = (promptConfigs === void 0 ? legacy.configs : Object.keys(legacyOverrides).length === 0 ? promptConfigs : resolveLegacyPromptConfigs({
+			...source,
+			promptConfigs
+		}, {
+			moduleDir: join(moduleRoot, templateName),
+			overrides: legacyOverrides,
+			partial: Object.keys(previousLegacy).length === 0
+		}).configs).map((config) => {
 			if (config === null || typeof config !== "object" || Array.isArray(config)) return config;
 			const vars = config.variables;
 			if (vars === null || typeof vars !== "object" || Array.isArray(vars)) return config;
@@ -9473,7 +9687,16 @@ function savePresetParams(presetRoot, templateName, params, promptConfigs, varia
 			return next;
 		});
 		doc.setIn(["promptConfigs"], cleaned);
-	}
+		const accepted = resolveLegacyPromptConfigs({
+			...source,
+			promptConfigs: cleaned
+		}, {
+			moduleDir: join(moduleRoot, templateName),
+			overrides: legacyOverrides
+		});
+		for (const key of accepted.consumedKeys) deleteYamlPath(doc, legacyPromptParamPath(key));
+		for (const warning of accepted.warnings) console.warn(`prompt-tool: ${warning}`);
+	} else for (const warning of legacy.warnings) console.warn(`prompt-tool: ${warning}`);
 	if (variables !== void 0) {
 		const kept = Object.fromEntries(Object.entries(variables).filter(([key, value]) => key.trim().length > 0 && typeof value === "string"));
 		if (Object.keys(kept).length > 0) doc.setIn(["variables"], kept);
@@ -9484,34 +9707,34 @@ function savePresetParams(presetRoot, templateName, params, promptConfigs, varia
 		else doc.setIn(["variablesEnabled"], false);
 	}
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(join(presetRoot, templateName));
+	invalidateModuleSpec(join(moduleRoot, templateName));
 }
 /**
-* 保存激活预设的顶层 persona 段（官方 `@deepseek-ai/dsh-persona` 行 config 同构）。
+* 保存激活模块的顶层 persona 段（官方 `@deepseek-ai/dsh-persona` 行 config 同构）。
 * null = 删除该段（回落宿主部署人设）；默认值不落键（见 personaRowConfig）。
 */
-function savePresetPersona(presetRoot, templateName, persona) {
-	const file = join(assertPresetDirectory(presetRoot, templateName), "preset.yml");
+function savePresetPersona(moduleRoot, templateName, persona) {
+	const file = join(assertModuleDirectory(moduleRoot, templateName), MODULE_DEFINITION_FILE);
 	if (!existsSync(file)) throw new Error(`preset ${templateName} 无 preset.yml`);
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
 	readPresetLayerSettings(doc.toJS());
 	if (persona === null) doc.deleteIn(["persona"]);
 	else doc.setIn(["persona"], personaRowConfig(persona));
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(join(presetRoot, templateName));
+	invalidateModuleSpec(join(moduleRoot, templateName));
 }
-/** 预设文件读-改-写（parseDocument 保留注释与未知键；mutate 内 setIn/deleteIn）。
+/** 模块文件读-改-写（parseDocument 保留注释与未知键；mutate 内 setIn/deleteIn）。
 *  角色卡库（characters）与世界书工具（world-book-tools）共用此入口，避免
 *  各自实现 parseDocument 往返。写盘走原子替换，失败保留旧文件。 */
-function withPresetDoc(presetDir, mutate) {
-	const file = join(presetDir, "preset.yml");
-	if (!existsSync(file)) throw new Error(`${presetDir} 无 preset.yml`);
+function withPresetDoc(moduleDir, mutate) {
+	const file = join(moduleDir, MODULE_DEFINITION_FILE);
+	if (!existsSync(file)) throw new Error(`${moduleDir} 无 preset.yml`);
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
 	readPresetLayerSettings(doc.toJS());
 	mutate(doc);
 	readPresetLayerSettings(doc.toJS());
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(presetDir);
+	invalidateModuleSpec(moduleDir);
 }
 /** 向 preset.yml 的 modules 追加功能模块；空数组保持按需装配语义。 */
 function appendPresetModules(doc, additions) {
@@ -9525,18 +9748,18 @@ function appendPresetModules(doc, additions) {
 	}
 	doc.set("modules", modules);
 }
-/** 删除具有合法身份的预设目录（预设根/<id>）；隐藏备份不经公共接口删除。
-*  仅作用于预设根（官方 USER_PRESET_DIR），包内置模板天然不受影响；路径越界与非法 id 拒绝。
-*  删除后宿主 agent-presets 目录列表自然不再出现该预设（官方 roster 即目录列表）。 */
-function removeUserPreset(id, presetRoot = userPresetsDir()) {
+/** 删除具有合法身份的模块目录（模块根/<id>）；隐藏备份不经公共接口删除。
+*  仅作用于插件自有模块根，包内置模板不受影响；路径越界与非法 id 拒绝。
+*  模块不在宿主预设注册表里，删除后无需撤销官方登记；调用方按需重建当前模块。 */
+function removeUserPreset(id, moduleRoot = userModulesDir()) {
 	try {
-		const target = assertPresetDirectory(presetRoot, id);
+		const target = assertModuleDirectory(moduleRoot, id);
 		assertPresetTree(target);
 		rmSync(target, {
 			recursive: true,
 			force: true
 		});
-		invalidatePresetSpec(target);
+		invalidateModuleSpec(target);
 		return { ok: true };
 	} catch (error) {
 		return {
@@ -9611,7 +9834,9 @@ function buildModuleConfigsFromParams(params, options = {}) {
 /**
 * 组合模块目录分工：
 * - source/local：本项目自有模块的唯一源文件；
-* - library：由 rebuild-composition 原样生成的官方切块与官方预设变体，不含本地补丁。
+* - library：随包分发的官方切块与官方预设变体快照（版本化产物，不手工编辑）；
+*   生成它的 `rebuild-composition` 脚本随内置模块目录 `modules/` 一并退场——输入源已不存在，
+*   快照本体保留为既成事实，不再重建。
 * 同名文件禁止同时存在，避免 source 与产物漂移。
 */
 function compositionModuleDirs() {
@@ -9647,7 +9872,7 @@ function assembleModules(spec) {
 * 行级 config 合并:仅支持 map 型 config 浅合并;
 * 数组型 config(如 delegation 组)按子行 id 嵌套合并;未声明模块原样保留。
 * 未声明 configs 时返回原文(零开销);parseDocument 往返保留注释。
-* 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是预设覆盖通道。
+* 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是模块覆盖通道。
 */
 function applyModuleConfigs(raw, configs) {
 	if (configs === void 0 || Object.keys(configs).length === 0) return raw;
@@ -9692,9 +9917,9 @@ function applyModuleConfigs(raw, configs) {
 	return changed ? doc.toString() : raw;
 }
 /**
-* 加载预设声明的组合(原始 token 文本,未渲染)。
+* 加载模块声明的组合(原始 token 文本,未渲染)。
 *  - `modules:` 清单 → 引擎模块库按序装配;
-*  - `composition: ./xxx.yml` → 预设模板目录内组合文件(官方预设直用);
+*  - `composition: ./xxx.yml` → 模块模板目录内组合文件(官方预设直用);
 *  - `composition:` 内联文本或组合清单名。
 */
 function loadCompositionText(spec, templateDir, runtime = {}) {
@@ -9744,10 +9969,10 @@ function loadCompositionText(spec, templateDir, runtime = {}) {
 	return raw;
 }
 /**
-* 解析预设的模块事实，供 UI 卡片存在性和受控创建共用。
+* 解析模块的模块事实，供 UI 卡片存在性和受控创建共用。
 * 显式模块及当前参数/策略所需的装配是可编辑插件能力；官方组合 row 仅保留为运行事实。
 */
-function resolvePresetModuleFacts(spec, templateDir, editable = false) {
+function resolveModuleFacts(spec, templateDir, editable = false) {
 	const declaredModules = Array.isArray(spec.modules) ? [...new Set(spec.modules.filter((item) => typeof item === "string" && item.trim().length > 0).map((item) => item.trim()))] : null;
 	const sourceMode = Array.isArray(spec.modules) ? "explicit" : typeof spec.composition === "string" && spec.composition.trim().length > 0 ? "composition" : templateDir !== void 0 && existsSync(join(templateDir, "agent.cordis.yml")) ? "official" : "unknown";
 	const effectiveModules = sourceMode === "explicit" ? [...declaredModules ?? []] : null;
@@ -9825,13 +10050,14 @@ function resolvePresetModuleFacts(spec, templateDir, editable = false) {
 		rowIds,
 		sourceMode,
 		editable: editable && sourceMode === "explicit",
-		effectiveConfigs
+		effectiveConfigs,
+		subagentToolPolicyEnabled: spec.subagentToolPolicy !== void 0 && spec.subagentToolPolicy !== null
 	};
 }
-/** 在内存候选文档中展开能力/recipe，校验成功后一次原子替换 preset.yml。 */
-function createEngineCapabilityInPreset(presetDir, request) {
-	const file = join(presetDir, "preset.yml");
-	if (!existsSync(file)) throw new Error(`预设目录缺少 preset.yml：${presetDir}`);
+/** 在内存候选文档中展开能力/recipe，校验成功后一次原子替换 module.yml。 */
+function createEngineCapabilityInPreset(moduleDir, request) {
+	const file = join(moduleDir, MODULE_DEFINITION_FILE);
+	if (!existsSync(file)) throw new Error(`模块目录缺少 preset.yml：${moduleDir}`);
 	const original = readFileSync(file, "utf8");
 	const doc = parseDocument(original, { logLevel: "silent" });
 	const source = doc.toJS();
@@ -9839,7 +10065,7 @@ function createEngineCapabilityInPreset(presetDir, request) {
 	if (!Array.isArray(source.modules)) throw new Error("当前预设没有可编辑的 modules 数组；请先复制为插件用户预设");
 	const capabilityIds = request.action === "create" ? [request.capabilityId] : engineRecipe(request.recipeId)?.capabilities ? [...engineRecipe(request.recipeId).capabilities] : [];
 	if (capabilityIds.length === 0 || capabilityIds.some((id) => engineCapability(id) === void 0)) throw new Error(`未知引擎能力或 recipe：${request.action === "create" ? request.capabilityId : request.recipeId}`);
-	const currentFacts = resolvePresetModuleFacts(source, presetDir, true);
+	const currentFacts = resolveModuleFacts(source, moduleDir, true);
 	const declaredFacts = {
 		...currentFacts,
 		effectiveModules: currentFacts.declaredModules
@@ -9864,7 +10090,7 @@ function createEngineCapabilityInPreset(presetDir, request) {
 		sectionWritten = true;
 	}
 	const candidate = doc.toJS();
-	const rows = assertCompositionArray(renderComposition(candidate, {}, presetDir), candidate);
+	const rows = assertCompositionArray(renderComposition(candidate, {}, moduleDir), candidate);
 	const rowPaths = /* @__PURE__ */ new Map();
 	const visit = (value, path) => {
 		if (Array.isArray(value)) {
@@ -9893,7 +10119,7 @@ function createEngineCapabilityInPreset(presetDir, request) {
 		capabilityIds
 	};
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(presetDir);
+	invalidateModuleSpec(moduleDir);
 	return {
 		changed: true,
 		addedModules,
@@ -9903,9 +10129,9 @@ function createEngineCapabilityInPreset(presetDir, request) {
 /** 删除能力：模块声明、顶层数据段，以及该能力的**显式参数与行配置**一起移除。
 *  参数在 ⇒ 装配在（见 impliedModulesFromParams）：留下参数会让移除立刻被隐含装配拉回来，
 *  所以"移除能力"必须是完整移除。未登记参数、其他能力的数据与未知字段一律不动。 */
-function removeEngineCapabilityFromPreset(presetDir, capabilityId) {
-	const file = join(presetDir, "preset.yml");
-	if (!existsSync(file)) throw new Error(`预设目录缺少 preset.yml：${presetDir}`);
+function removeEngineCapabilityFromPreset(moduleDir, capabilityId) {
+	const file = join(moduleDir, MODULE_DEFINITION_FILE);
+	if (!existsSync(file)) throw new Error(`模块目录缺少 preset.yml：${moduleDir}`);
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
 	const source = doc.toJS();
 	const params = readPresetLayerSettings(source);
@@ -9929,9 +10155,9 @@ function removeEngineCapabilityFromPreset(presetDir, capabilityId) {
 	for (const key of paramKeys) doc.deleteIn(engineParamPath(key));
 	for (const rowId of configRows) doc.deleteIn(["moduleConfigs", rowId]);
 	const candidate = doc.toJS();
-	assertCompositionArray(renderComposition(candidate, {}, presetDir), candidate);
+	assertCompositionArray(renderComposition(candidate, {}, moduleDir), candidate);
 	atomicWriteTextFile(file, doc.toString());
-	invalidatePresetSpec(presetDir);
+	invalidateModuleSpec(moduleDir);
 	return {
 		changed: true,
 		removedModules,
@@ -9939,7 +10165,7 @@ function removeEngineCapabilityFromPreset(presetDir, capabilityId) {
 	};
 }
 /**
-* 预设组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
+* 模块组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
 * 合并优先级:参数桥(params/UI 基础层) > moduleConfigs(模板/ST 行级直写) > 行默认。
 * moduleConfigs 仅补充参数桥未覆盖的行级 config(如 ST 导入的 tool-web.fetch),
 * 不再锁定覆盖 UI 可管理参数(旧作者锁定语义已移除)。
@@ -9979,107 +10205,259 @@ function assertCompositionArray(raw, spec) {
 	if (!Array.isArray(parsed)) throw new Error(`generated agent.cordis.yml is not a YAML array (preset ${spec.id})`);
 	return parsed;
 }
+/** 存储根配置文件名。 */
+const STORAGE_CONFIG_FILE = "config.yml";
+/**
+* 启用表文件位置。
+*
+* 以**模块根**为入口、上溯一级取存储根：模块级常量在 import 时按 `DSH_HOME` 冻结，
+* 而测试会在动态 import 之后才设 `DSH_HOME`，所以这里必须按传入的根现算
+* （与 `charactersDir(moduleRoot)` 同一条约定）。
+*/
+function enableTablePath(moduleRoot) {
+	return join(dirname(moduleRoot), STORAGE_CONFIG_FILE);
+}
+function readDocument(file) {
+	if (!existsSync(file)) return void 0;
+	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
+	if (doc.errors.length > 0 || !isMap(doc.contents)) return void 0;
+	return doc;
+}
+/**
+* 读启用表：返回启用的模块 id（按声明顺序，重复项去掉）。
+*
+* 文件缺失、解析失败、schemaVersion 低于 3、`enabled` 不是字符串数组——一律返回空表。
+* 空表意味着「没有模块参与装配」，这是明确状态，不是错误：旧版本的索引文件里
+* `enabled` 还没有启用语义，当成启用会让历史键意外参与装配。
+*/
+function enabledModuleIds(moduleRoot) {
+	const doc = readDocument(enableTablePath(moduleRoot));
+	if (doc === void 0) return [];
+	if (Number(doc.get("schemaVersion")) < 3) return [];
+	const list = doc.toJS()?.enabled;
+	if (!Array.isArray(list)) return [];
+	return [...new Set(list.filter((id) => typeof id === "string" && id.trim().length > 0).map((id) => id.trim()))];
+}
+/** 写启用表：保留既有注释与未知字段，只改 `schemaVersion` 与 `enabled`。 */
+function writeEnabled(moduleRoot, ids) {
+	const file = enableTablePath(moduleRoot);
+	const doc = readDocument(file);
+	if (doc === void 0) {
+		atomicWriteTextFile(file, [
+			"# Prompt Tool 模块启用表：只记录哪些模块参与运行时装配。",
+			"# 参数、提示词与素材在各模块自己的目录里（modules/<id>/）；这里没有版本指针，也没有配装段。",
+			"",
+			`schemaVersion: 3`,
+			...ids.length === 0 ? ["enabled: []"] : ["enabled:", ...ids.map((id) => `  - ${id}`)],
+			""
+		].join("\n"));
+		return;
+	}
+	doc.set("schemaVersion", 3);
+	doc.set("enabled", [...ids]);
+	atomicWriteTextFile(file, doc.toString());
+}
+/**
+* 解析**编辑目标**模块目录：请求声明了目标就按它定位，没声明则回退启用表首项。
+*
+* 这是「按请求定位编辑目标」的唯一入口——编辑器不必依赖某个全局单选：写请求带上
+* 模块 id 就写那个模块，不带则落到启用表第一项（= 装配顺序首项）。目标不存在时返回
+* 空串，由调用方按「无目标」拒绝，不静默改写到别的模块。
+*/
+function resolveEditDir(moduleRoot, moduleId) {
+	const target = moduleId !== void 0 && moduleId.trim().length > 0 ? moduleId.trim() : enabledModuleIds(moduleRoot)[0];
+	if (target === void 0) return "";
+	return moduleDirExists(moduleRoot, target) ? join(moduleRoot, target) : "";
+}
+/**
+* 启用或停用一个模块。幂等：已在表里再启用不产生第二条，不在表里再停用不报错。
+* 顺序即装配顺序，新模块追加在末尾（同键参数的覆盖顺序因此可预测）。
+*/
+function setModuleEnabled(moduleRoot, id, enabled) {
+	const current = enabledModuleIds(moduleRoot);
+	const next = enabled ? current.includes(id) ? current : [...current, id] : current.filter((existing) => existing !== id);
+	if (next.length === current.length && next.every((value, index) => value === current[index])) return;
+	writeEnabled(moduleRoot, next);
+}
 //#endregion
-//#region src/shared/managed-config-fields.ts
-/** writer 可投影的字段白名单；是否确由参数投影由 ConfigFieldSources 决定。 */
-const MANAGED_CONFIG_FIELDS = [{
-	configId: "near-anchor",
-	fields: [
-		{
-			path: "enabled",
-			sourceParam: "firstTurnAnchor"
-		},
-		{
-			path: "params.useCustom",
-			sourceParam: "firstTurnCustom"
-		},
-		{
-			path: "params.text",
-			sourceParam: "firstTurnText"
-		},
-		{
-			path: "params.buildPattern",
-			sourceParam: "buildPattern"
-		},
-		{
-			path: "params.complexPattern",
-			sourceParam: "complexPattern"
-		},
-		{
-			path: "params.firstTurnBuild",
-			sourceParam: "firstTurnBuild"
-		},
-		{
-			path: "params.firstTurnInspect",
-			sourceParam: "firstTurnInspect"
-		},
-		{
-			path: "params.firstTurnDeep",
-			sourceParam: "firstTurnDeep"
-		}
-	]
-}, {
-	configId: "router-guide",
-	fields: [
-		{
-			path: "enabled",
-			sourceParam: "guideEnabled"
-		},
-		{
-			path: "modelScope",
-			sourceParam: "guideCustom",
-			derived: true,
-			fallbackNote: "followsCustom"
-		},
-		{
-			path: "params.useCustom",
-			sourceParam: "guideCustom",
-			derived: true
-		},
-		{
-			path: "params.text",
-			sourceParam: "guideText"
-		},
-		{
-			path: "params.complexPattern",
-			sourceParam: "complexPattern"
-		},
-		{
-			path: "params.guideWeak",
-			sourceParam: "guideWeak"
-		},
-		{
-			path: "params.guideDeep",
-			sourceParam: "guideDeep"
-		}
-	]
-}];
-/** 严格投影白名单；未知路径、参数键和附加属性都不进入客户端。 */
-function readConfigFieldSources(configId, raw) {
-	const spec = MANAGED_CONFIG_FIELDS.find((entry) => entry.configId === configId);
-	if (spec === void 0 || raw === null || typeof raw !== "object" || Array.isArray(raw)) return void 0;
-	const record = raw;
-	if (record.configId !== configId || !Array.isArray(record.fields)) return void 0;
+//#region src/shared/module-config-order.ts
+const configIdentityKey = (entry) => JSON.stringify([entry.moduleId, entry.configId]);
+/** 不以启用表次序打破同号平局；排序不改变配置卡身份。 */
+function compareModuleConfigOrder(a, b) {
+	const compare = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+	return a.sequence - b.sequence || compare(a.moduleId, b.moduleId) || compare(a.configId, b.configId);
+}
+//#endregion
+//#region src/host/module-config-order.ts
+/** 已启用配置卡的排序：轻量序号归各自 module.yml，文件是可重建投影。 */
+var ModuleConfigOrderError = class extends Error {
+	status;
+	code;
+	constructor(message, conflict = false) {
+		super(message);
+		this.status = conflict ? 409 : 400;
+		this.code = conflict ? "module-config-order-conflict" : "module-config-order-invalid";
+	}
+};
+function readConfigOrder(value) {
+	if (value === void 0) return Object.create(null);
+	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error("configOrder 必须是配置卡序号对象");
+	for (const [id, sequence] of Object.entries(value)) {
+		assertSafeConfigId(id);
+		if (typeof sequence !== "number" || !Number.isSafeInteger(sequence) || sequence < 0) throw new Error(`配置卡 ${id} 的序号必须是非负安全整数`);
+	}
+	return Object.assign(Object.create(null), value);
+}
+function readInput(root, moduleId) {
+	const dir = assertModuleDirectory(root, moduleId);
+	const raw = readFileSync(join(dir, MODULE_DEFINITION_FILE), "utf8");
+	const doc = parseDocument(raw, { logLevel: "silent" });
+	const saved = readConfigOrder(doc.toJS()?.configOrder);
+	const spec = loadModuleSpec(dir);
+	const directory = join(dir, MODULE_CONFIGS_DIR);
+	const files = /* @__PURE__ */ new Map();
+	if (existsSync(directory)) {
+		assertPresetTree(directory);
+		for (const [index, file] of promptConfigFileNames(readdirSync(directory, { withFileTypes: true })).entries()) {
+			const source = readFileSync(join(directory, file), "utf8");
+			const config = /\.json$/i.test(file) ? JSON.parse(source) : parsePromptConfigYaml(source);
+			assertSafeConfigId(config.id);
+			if (files.has(config.id)) throw new Error(`模块 ${moduleId} 存在重复配置卡：${config.id}`);
+			const prefix = /^(\d+)-/.exec(file);
+			files.set(config.id, {
+				config,
+				sequence: prefix === null ? index * 10 : Number(prefix[1])
+			});
+		}
+	}
+	const cards = Array.isArray(spec.promptConfigs) ? mergePromptConfigs(modelRequestConfigs(resolvePresetParams(spec, {})), spec.promptConfigs) : [...files.values()].map((entry) => entry.config);
+	const seen = /* @__PURE__ */ new Set();
 	return {
-		configId,
-		fields: spec.fields.flatMap(({ path }) => {
-			const source = record.fields.find((item) => item !== null && typeof item === "object" && item.path === path)?.source;
-			return source === "preset-param" || source === "prompt-config" ? [{
-				path,
-				source
-			}] : [];
+		moduleId,
+		dir,
+		raw,
+		doc,
+		saved,
+		entries: cards.map((card, index) => {
+			assertSafeConfigId(card.id);
+			if (seen.has(card.id)) throw new Error(`模块 ${moduleId} 存在重复配置卡：${card.id}`);
+			seen.add(card.id);
+			const sequence = saved[card.id] ?? files.get(card.id)?.sequence ?? index * 10;
+			if (!Number.isSafeInteger(sequence) || sequence < 0) throw new Error(`配置卡 ${card.id} 的文件序号无效`);
+			return {
+				moduleId,
+				configId: card.id,
+				name: card.name ?? card.id,
+				layer: card.layer ?? "pre-step",
+				position: card.position ?? "after-user",
+				sequence,
+				enabled: card.enabled !== false,
+				strategy: card.strategy ?? "static",
+				...card.audience === void 0 ? {} : { audience: card.audience },
+				...card.layer === "system-section" || card.layer === "runtime-context" ? { order: card.order ?? 0 } : {}
+			};
 		})
 	};
 }
-/** 来源只用于读回；无论客户端传了什么来源，都不能写入预设定义。 */
-function stripConfigFieldSources(config) {
-	const { fieldSources: _fieldSources, ...definition } = config;
-	return definition;
+function readInputs(root, ids = enabledModuleIds(root)) {
+	return [...new Set(ids)].sort().map((id) => readInput(root, id));
+}
+function snapshotOf(inputs) {
+	return {
+		revision: createHash("sha256").update(JSON.stringify(inputs.map((input) => [
+			input.moduleId,
+			input.raw,
+			input.entries
+		]))).digest("hex"),
+		entries: inputs.flatMap((input) => input.entries).sort(compareModuleConfigOrder)
+	};
+}
+function readModuleConfigOrder(root, moduleId) {
+	return snapshotOf(readInputs(root, moduleId === void 0 ? void 0 : [moduleId]));
+}
+function writeOrders(root, inputs, orders) {
+	const changes = inputs.flatMap((input) => {
+		const next = orders.get(input.moduleId);
+		if (next === void 0 || Object.entries(next).every(([id, value]) => input.saved[id] === value)) return [];
+		for (const [id, sequence] of Object.entries(next)) input.doc.setIn(["configOrder", id], sequence);
+		return [{
+			...input,
+			next: input.doc.toString()
+		}];
+	});
+	const verify = (change) => {
+		const dir = assertModuleDirectory(root, change.moduleId);
+		if (dir !== change.dir || readFileSync(join(dir, "module.yml"), "utf8") !== change.raw) throw new ModuleConfigOrderError("模块版本已变化，请重新读取排序", true);
+	};
+	for (const change of changes) verify(change);
+	const written = [];
+	try {
+		for (const change of changes) {
+			atomicWriteTextFile(join(change.dir, MODULE_DEFINITION_FILE), change.next, { beforeReplace: () => verify(change) });
+			invalidateModuleSpec(change.dir);
+			written.push(change);
+		}
+	} catch (error) {
+		for (const change of written.reverse()) {
+			const file = join(change.dir, MODULE_DEFINITION_FILE);
+			if (readFileSync(file, "utf8") === change.next) {
+				atomicWriteTextFile(file, change.raw, { beforeReplace: () => {
+					assertModuleDirectory(root, change.moduleId);
+					if (readFileSync(file, "utf8") !== change.next) throw new Error("排序恢复时模块再次变化");
+				} });
+				invalidateModuleSpec(change.dir);
+			}
+		}
+		throw error;
+	}
+	return changes.map((change) => change.moduleId);
+}
+/** 新卡或与其他启用模块碰号的卡接在尾部；已保存且无冲突的顺序保持。 */
+function appendModuleConfigOrder(root, moduleId) {
+	const others = readInputs(root, enabledModuleIds(root).filter((id) => id !== moduleId));
+	const input = readInput(root, moduleId);
+	const used = new Set(others.flatMap((item) => item.entries.map((entry) => entry.sequence)));
+	let next = -10;
+	for (const value of used) next = Math.max(next, value);
+	for (const value of Object.values(input.saved)) next = Math.max(next, value);
+	next += 10;
+	const assigned = Object.create(null);
+	const collision = input.entries.some((entry) => input.saved[entry.configId] !== void 0 && used.has(input.saved[entry.configId]));
+	for (const entry of [...input.entries].sort(compareModuleConfigOrder)) {
+		let sequence = input.saved[entry.configId];
+		if (collision || sequence === void 0 || used.has(sequence)) {
+			if (!Number.isSafeInteger(next)) throw new Error("配置卡排序序号超出安全整数范围");
+			sequence = next;
+			next += 10;
+		}
+		used.add(sequence);
+		assigned[entry.configId] = sequence;
+	}
+	return writeOrders(root, [input], /* @__PURE__ */ new Map([[moduleId, assigned]]));
+}
+/** 默认重排启用集合；指定模块只交换其现有槽位，不接受客户端序号、正文或路径。 */
+function saveModuleConfigOrder(root, expectedRevision, entries, moduleId) {
+	const inputs = readInputs(root, moduleId === void 0 ? void 0 : [moduleId]);
+	const current = snapshotOf(inputs);
+	if (expectedRevision !== current.revision) throw new ModuleConfigOrderError("模块版本已变化，请重新读取排序", true);
+	if (!Array.isArray(entries) || entries.length !== current.entries.length) throw new ModuleConfigOrderError("排序配置卡集合已变化", true);
+	const known = new Set(current.entries.map(configIdentityKey));
+	const orders = /* @__PURE__ */ new Map();
+	for (const [index, entry] of entries.entries()) {
+		if (entry === null || typeof entry !== "object" || typeof entry.moduleId !== "string" || typeof entry.configId !== "string" || Object.keys(entry).some((key) => key !== "moduleId" && key !== "configId") || !known.delete(configIdentityKey(entry))) throw new ModuleConfigOrderError("排序包含未知或重复配置卡");
+		let values = orders.get(entry.moduleId);
+		if (values === void 0) {
+			values = Object.create(null);
+			orders.set(entry.moduleId, values);
+		}
+		values[entry.configId] = moduleId === void 0 ? index * 10 : current.entries[index].sequence;
+	}
+	return writeOrders(root, inputs, orders);
 }
 //#endregion
-//#region src/host/preset-triggers.ts
+//#region src/host/module-triggers.ts
 /** 触发器只归属 preset.yml；内容版本覆盖完整定义，写盘复用现有 YAML Document 通道。 */
-/** 声明数据以实际 triggers.yml 为基准；允许根与注册层注入的 presetRoot 一致。 */
+/** 声明数据以实际 triggers.yml 为基准；允许根与注册层注入的 moduleRoot 一致。 */
 function triggerPromptConfigOptions(directory, strategy) {
 	const templatePresetRoot = pathToFileURL(dirname(directory) + "/");
 	const templateBaseUrl = pathToFileURL(join(directory, "triggers.yml"));
@@ -10089,9 +10467,9 @@ function triggerPromptConfigOptions(directory, strategy) {
 		strategyDir: typeof strategy !== "string" || strategy.length === 0 ? void 0 : isAbsolute(strategy) ? pathToFileURL(strategy).href : new URL(strategy, templateBaseUrl).href
 	};
 }
-function readPresetTriggers(directory) {
-	const dir = assertPresetDirectory(dirname(directory), basename(directory));
-	const source = readFileSync(join(dir, "preset.yml"), "utf8");
+function readModuleTriggers(directory) {
+	const dir = assertModuleDirectory(dirname(directory), basename(directory));
+	const source = readFileSync(join(dir, MODULE_DEFINITION_FILE), "utf8");
 	const triggers = parseDocument(source, { logLevel: "silent" }).toJS().triggers ?? [];
 	if (!Array.isArray(triggers)) throw new TypeError("preset.yml 的 triggers 必须是数组");
 	return {
@@ -10100,8 +10478,8 @@ function readPresetTriggers(directory) {
 	};
 }
 /** 同步读改写之间不让出事件循环；版本不符不调用写盘，也不丢弃外部字段和注释。 */
-function savePresetTriggers(directory, triggers, expectedRevision) {
-	if (readPresetTriggers(directory).revision !== expectedRevision) return false;
+function saveModuleTriggers(directory, triggers, expectedRevision) {
+	if (readModuleTriggers(directory).revision !== expectedRevision) return false;
 	withPresetDoc(directory, (doc) => {
 		if (triggers.length === 0) doc.delete("triggers");
 		else doc.set("triggers", triggers);
@@ -10197,16 +10575,16 @@ function buildWorldBookEntry(input) {
 	};
 }
 const isWorldBook = (config) => config !== null && typeof config === "object" && !Array.isArray(config) && config.strategy === "world-book";
-/** 当前预设全部世界书条目（保持文件顺序）。 */
-function listWorldBookEntries(presetDir) {
-	const spec = loadPresetSpec(presetDir);
+/** 当前模块全部世界书条目（保持文件顺序）。 */
+function listWorldBookEntries(moduleDir) {
+	const spec = loadModuleSpec(moduleDir);
 	return Array.isArray(spec.promptConfigs) ? spec.promptConfigs.filter(isWorldBook) : [];
 }
 /** 新增或更新一条世界书条目（按 id 定位；不存在则追加）。返回写入后条目总数。 */
-function upsertWorldBookEntry(presetDir, entry) {
+function upsertWorldBookEntry(moduleDir, 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) => {
+	withPresetDoc(moduleDir, (doc) => {
 		const current = doc.toJS();
 		const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
 		const existing = configs.findIndex((config) => String(config.id ?? "") === entry.id);
@@ -10218,10 +10596,10 @@ function upsertWorldBookEntry(presetDir, entry) {
 	return count;
 }
 /** 删除一条世界书条目；不存在抛错。返回删除后条目总数。 */
-function deleteWorldBookEntry(presetDir, id) {
+function deleteWorldBookEntry(moduleDir, id) {
 	let count = 0;
 	let removed = false;
-	withPresetDoc(presetDir, (doc) => {
+	withPresetDoc(moduleDir, (doc) => {
 		const current = doc.toJS();
 		const configs = Array.isArray(current.promptConfigs) ? current.promptConfigs : [];
 		const kept = configs.filter((config) => !(isWorldBook(config) && String(config.id ?? "") === id));
@@ -10429,7 +10807,7 @@ function stOrderSelectionState(card, options = {}) {
 	};
 	return { needsSelection: false };
 }
-/** SillyTavern JSON 预设卡片 → 本项目 PresetSpec（导入端点直接消费）。 */
+/** SillyTavern JSON 预设卡片 → 本项目 ModuleSpec（导入端点直接消费）。 */
 function convertStToPreset(card, baseName, options = {}) {
 	return convertStToPresetWithReport(card, baseName, options).spec;
 }
@@ -11413,7 +11791,7 @@ function classify(raw, target) {
 function prepareImport(input, target, choices = {}) {
 	const files = normalizeAssetFiles(input);
 	const sourceDigest = assetSourceDigest(files);
-	const named = files.filter((file) => /^(preset|converted)\.ya?ml$/i.test(file.path));
+	const named = files.filter((file) => /^(?:module|preset|converted)\.ya?ml$/i.test(file.path));
 	if (named.length > 1) throw new Error(`存在多个定义候选：${named.map((file) => file.path).join("、")}`);
 	const topFiles = files.filter((file) => !file.path.includes("/"));
 	const structured = topFiles.filter((file) => /\.(json|ya?ml)$/i.test(file.path));
@@ -11454,7 +11832,7 @@ function prepareImport(input, target, choices = {}) {
 				validateCharacterSpec(raw);
 				selfContained = true;
 			} catch {}
-			if (selfContained && fragment && !/^preset\.ya?ml$/i.test(file.path) && !/^converted\.ya?ml$/i.test(file.path) && choices.sourceKind === void 0) return {
+			if (selfContained && fragment && !/^(?:module|preset)\.ya?ml$/i.test(file.path) && !/^converted\.ya?ml$/i.test(file.path) && choices.sourceKind === void 0) return {
 				state: "needs-kind-selection",
 				kinds: ["native-preset", "native-character"],
 				sourceName: file.path
@@ -11531,7 +11909,7 @@ function prepareImport(input, target, choices = {}) {
 	const avatar = first.avatar ?? (avatarFile === void 0 ? void 0 : decodeAssetFile(avatarFile));
 	if (avatar !== void 0 && !isPngBuffer(avatar)) throw new Error("avatar.png 必须提供显式编码的 PNG 原始字节");
 	const preparedFiles = [{
-		path: "preset.yml",
+		path: MODULE_DEFINITION_FILE,
 		content: yaml,
 		encoding: "utf8"
 	}, ...resources];
@@ -11555,9 +11933,11 @@ function prepareImport(input, target, choices = {}) {
 }
 //#endregion
 //#region src/host/characters.ts
-/** 角色卡库：独立于预设根的素材+参数存储（预设根下点前缀目录，官方 discovery 跳过）。
-*  角色卡参数（converted.yml = convertStToPreset 产物）不直接生成预设，而是
-*  由用户按需「导入到当前预设」合并进激活预设 preset.yml（promptConfigs 带
+/** 角色卡库：独立于模块根的素材+参数存储（**存储根**下点前缀目录，官方 discovery 跳过）。
+*  注意区分两种语义：`moduleRoot` 形参指的是**模块根**（`<存储根>/modules`），角色卡库
+*  在它的上一级（`<存储根>/.characters`）——两者是兄弟，不是父子。
+*  角色卡参数（converted.yml = convertStToPreset 产物）不直接生成模块，而是
+*  由用户按需「导入到当前模块」合并进激活模块 module.yml（promptConfigs 带
 *  chara-<cardId>- 前缀防冲突，params 合并，meta.importedCharacters 记录来源），
 *  并可一键移除。 */
 /** 合并写盘时按九层顺序排序（数组序 = 引擎序）：层序只由共享契约提供，这里不再维护第二份。 */
@@ -11603,15 +11983,24 @@ function recordMemory(doc, cardId, config) {
 		contentHash: contentHash(config)
 	});
 }
+/**
+* 并入条目的前缀集合：**写入统一用 `module-<id>-`**，读取端同时接受历史的 `chara-<id>-`。
+*
+* 不迁移老数据：用户已并入的条目 id 就长成 `chara-…`，改写它们等于重写用户的 module.yml；
+* 而「按前缀差集撤销」的移除逻辑必须认得两种前缀，否则老条目会撤不掉、新条目会重复并入。
+*/
+function importPrefixes(id) {
+	return [`module-${id}-`, `chara-${id}-`];
+}
 function availableMemoryId(configs, cardId) {
-	const base = `chara-${cardId}-memory`;
+	const base = `module-${cardId}-memory`;
 	const used = new Set(configs.map((config) => config.id));
 	let id = base;
 	for (let suffix = 2; used.has(id); suffix += 1) id = `${base}-${suffix}`;
 	return id;
 }
 /** 分享副本：只排除本机生成证明仍匹配的记忆；旧项与已编辑项须明确选择。 */
-function projectCharacterMemories(source, choices = {}, presetRoot) {
+function projectCharacterMemories(source, choices = {}, moduleRoot) {
 	const doc = source.clone();
 	const spec = doc.toJS();
 	const records = memoryRecords(spec.meta);
@@ -11626,12 +12015,12 @@ function projectCharacterMemories(source, choices = {}, presetRoot) {
 			excluded.add(index);
 			continue;
 		}
-		const cardId = imported.find((card) => id === `chara-${card}-memory` || id.startsWith(`chara-${card}-memory-`)) ?? proof?.characterId;
+		const cardId = imported.find((card) => importPrefixes(card).some((base) => id === `${base}memory` || id.startsWith(`${base}memory-`))) ?? proof?.characterId;
 		if (cardId === void 0) continue;
-		if (presetRoot !== void 0 && validCardId(cardId)) {
-			const original = loadConverted(cardDir(presetRoot, cardId));
-			if (original?.promptConfigs?.some((entry) => isRecord$1(entry) && `chara-${cardId}-${String(entry.id)}` === id)) continue;
-			const memory = original === void 0 ? void 0 : buildCharacterMemoryEntry(original, readCharacterMemory(presetRoot, cardId));
+		if (moduleRoot !== void 0 && validCardId(cardId)) {
+			const original = loadImportSource(moduleRoot, cardId);
+			if (original?.promptConfigs?.some((entry) => isRecord$1(entry) && importPrefixes(cardId).some((base) => `${base}${String(entry.id)}` === id))) continue;
+			const memory = original === void 0 ? void 0 : buildCharacterMemoryEntry(original, readCharacterMemory(moduleRoot, cardId));
 			if (memory !== void 0 && contentHash({
 				...memory,
 				id
@@ -11694,13 +12083,16 @@ function characterModuleStillNeeded(module, context) {
 		case "world-book-tools": return context.configs.some((config) => config.strategy === "world-book");
 		case "session-var-tools": return context.configs.some((config) => isRecord$1(config.params) && config.params.stMacros === true);
 		case "tool-config-engine": return context.customTools;
-		case "character-tools": return context.importedCharacters.length > 0 || context.configs.some((config) => String(config.id ?? "").startsWith("chara-"));
+		case "character-tools": return context.importedCharacters.length > 0 || context.configs.some((config) => {
+			const id = String(config.id ?? "");
+			return id.startsWith("module-") || id.startsWith("chara-");
+		});
 		default: return true;
 	}
 }
 /** 其他已导入卡「引入过」或「声明过」的模块：移除本卡时不得夺走别人要用的模块。
 *  声明这一路必须读卡库的 converted.yml——第二张卡声明同一模块时差集为空、不会留下引入记录。 */
-function modulesClaimedByOtherCards(presetRoot, importedCards, meta, cardId) {
+function modulesClaimedByOtherCards(moduleRoot, importedCards, meta, cardId) {
 	const claimed = /* @__PURE__ */ new Set();
 	for (const [id, modules] of Object.entries(recordedCharacterModules(meta))) {
 		if (id === cardId || !importedCards.includes(id)) continue;
@@ -11708,7 +12100,7 @@ function modulesClaimedByOtherCards(presetRoot, importedCards, meta, cardId) {
 	}
 	for (const id of importedCards) {
 		if (id === cardId || !validCardId(id)) continue;
-		const spec = loadConverted(cardDir(presetRoot, id));
+		const spec = loadImportSource(moduleRoot, id);
 		if (spec === void 0) continue;
 		for (const module of declaredCharacterModules(spec)) claimed.add(module);
 	}
@@ -11719,22 +12111,22 @@ function readPresetModules(doc) {
 	const source = doc.toJS();
 	return Array.isArray(source.modules) ? source.modules.filter((item) => typeof item === "string") : [];
 }
-/** 角色卡记忆变更后同步已导入预设的 chara-<id>-memory 注入条目
-*  （world_book note 写入卡记忆后调用；未导入当前预设的卡返回 synced=false）。 */
-function syncImportedCharacterMemory(presetRoot, templateName, cardId) {
+/** 角色卡记忆变更后同步已导入模块的 chara-<id>-memory 注入条目
+*  （world_book note 写入卡记忆后调用；未导入当前模块的卡返回 synced=false）。 */
+function syncImportedCharacterMemory(moduleRoot, templateName, cardId) {
 	if (!validCardId(cardId)) return {
 		ok: false,
 		message: `非法角色卡 id：${cardId}`
 	};
 	let synced = false;
 	try {
-		const spec = loadConverted(cardDir(presetRoot, cardId));
+		const spec = loadImportSource(moduleRoot, cardId);
 		if (spec === void 0) return {
 			ok: false,
 			message: `角色卡 ${cardId} 不存在或参数损坏`
 		};
-		const memory = readCharacterMemory(presetRoot, cardId);
-		withPresetDoc(join(presetRoot, templateName), (doc) => {
+		const memory = readCharacterMemory(moduleRoot, cardId);
+		withPresetDoc(join(moduleRoot, 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 : [];
@@ -11774,25 +12166,55 @@ function syncImportedCharacterMemory(presetRoot, templateName, cardId) {
 		};
 	}
 }
-/** 角色卡库根：预设根下的点前缀目录（官方 roster 扫描跳过，与 .engine 同机制）。 */
-function charactersDir(presetRoot) {
-	return join(presetRoot, ".characters");
+/**
+* 角色卡库根：**存储根**下的点前缀目录（`<存储根>/.characters`）。
+*
+* 本模块形参 `moduleRoot` 的语义是**模块根**（`<存储根>/modules`），角色卡库与模块目录
+* 是兄弟：从模块根上溯一级即存储根。**必须由参数推导、不读模块级常量**——常量在
+* import 时按 `DSH_HOME` 冻结，测试内改 `DSH_HOME` 对它无效，会直接写进真实
+* `DSH_HOME`（2026-10-02 实测踩过：5 个用例把夹具角色卡写进了活的数据目录）。
+* 官方 roster 不扫描它（点前缀，与 `.engine` 同机制）。
+*/
+function charactersDir(moduleRoot) {
+	return join(dirname(moduleRoot), ".characters");
 }
-function cardDir(presetRoot, id) {
-	return join(charactersDir(presetRoot), id);
+function cardDir(moduleRoot, id) {
+	return join(charactersDir(moduleRoot), id);
 }
-function loadConverted(dir) {
-	const file = join(dir, "converted.yml");
+/** 读一个 ModuleSpec 形状的定义文件（`converted.yml` 与 `module.yml` 同构）。 */
+function loadSpecFile(file) {
 	assertNoLinks(file);
 	if (!presetPathExists(file)) return void 0;
 	const parsed = parse(readFileSync(file, "utf8"), { logLevel: "silent" });
 	if (!isRecord$1(parsed)) throw new Error(`角色定义不是对象：${file}`);
-	return parsed;
+	const spec = parsed;
+	const legacy = resolveLegacyPromptConfigs(spec, { moduleDir: dirname(file) });
+	return legacy.active ? {
+		...spec,
+		promptConfigs: legacy.configs,
+		legacyParamWarnings: legacy.warnings
+	} : spec;
+}
+function loadConverted(dir) {
+	return loadSpecFile(join(dir, "converted.yml"));
 }
-/** 追加角色卡本地记忆（.characters/<id>/memory.md，跟随角色卡跨预设）。 */
-function appendCharacterMemory(presetRoot, cardId, note) {
+/**
+* 并入与移除的**源**：模块优先（`<模块根>/<id>/module.yml`），回退角色卡库
+* （`.characters/<id>/converted.yml`）。
+*
+* 模块是统一身份——并入因此成为**模块间**能力，而不是只为角色卡存在的一套；
+* 角色卡库保留为素材来源与历史形态，所以仍作回退，已有卡片不迁移。
+* 一个入口、一套前缀（`module-<id>-`），不另立第二套机制。
+*/
+function loadImportSource(moduleRoot, id) {
+	const moduleFile = join(moduleRoot, id, MODULE_DEFINITION_FILE);
+	if (presetPathExists(moduleFile)) return loadSpecFile(moduleFile);
+	return loadConverted(cardDir(moduleRoot, id));
+}
+/** 追加角色卡本地记忆（.characters/<id>/memory.md，跟随角色卡跨模块）。 */
+function appendCharacterMemory(moduleRoot, cardId, note) {
 	assertPresetId(cardId);
-	appendMemoryFile(join(cardDir(presetRoot, cardId), "memory.md"), note, "# 角色记忆");
+	appendMemoryFile(join(cardDir(moduleRoot, cardId), "memory.md"), note, "# 角色记忆");
 }
 /** 检查现有祖先和最终文件，不能通过角色目录 junction 或单文件链接越界。 */
 function assertNoLinks(path) {
@@ -11812,9 +12234,9 @@ function appendMemoryFile(file, note, header = "# 本地记忆") {
 	else writeFileSync(file, `${header}\n${line}`, "utf8");
 }
 /** 读角色卡本地记忆文本（无记忆返回空串）。 */
-function readCharacterMemory(presetRoot, cardId) {
+function readCharacterMemory(moduleRoot, cardId) {
 	assertPresetId(cardId);
-	const file = join(cardDir(presetRoot, cardId), "memory.md");
+	const file = join(cardDir(moduleRoot, cardId), "memory.md");
 	assertNoLinks(file);
 	return presetPathExists(file) ? readFileSync(file, "utf8").trim() : "";
 }
@@ -11858,19 +12280,19 @@ function previewCharacterCard(files, options = {}) {
 		};
 	}
 }
-function persistCharacterCard(presetRoot, converted, sourceText, avatar, convertedYaml = stringify(converted, { lineWidth: 0 })) {
+function persistCharacterCard(moduleRoot, converted, sourceText, avatar, convertedYaml = stringify(converted, { lineWidth: 0 })) {
 	if (!validCardId(converted.id)) return {
 		ok: false,
 		message: `非法角色卡 id：${converted.id}`
 	};
-	const parent = charactersDir(presetRoot);
-	const dir = cardDir(presetRoot, converted.id);
+	const parent = charactersDir(moduleRoot);
+	const dir = cardDir(moduleRoot, converted.id);
 	let tmp;
 	let installed = false;
 	try {
 		assertNoLinks(dir);
 		const before = characterDirectoryDigest(dir);
-		if (presetPathExists(join(dir, "memory.md"))) readCharacterMemory(presetRoot, converted.id);
+		if (presetPathExists(join(dir, "memory.md"))) readCharacterMemory(moduleRoot, converted.id);
 		mkdirSync(parent, { recursive: true });
 		tmp = mkdtempSync(join(parent, `.${converted.id}.tmp-`));
 		if (before !== void 0) {
@@ -11950,14 +12372,14 @@ function characterDirectoryDigest(dir) {
 	return hash.digest("hex");
 }
 /** 角色卡入库：PNG 原图（可选）+ 角色卡 JSON → 转换参数存 converted.yml。 */
-function importCharacterCard(presetRoot, files, options = {}) {
+function importCharacterCard(moduleRoot, files, options = {}) {
 	try {
 		const prepared = prepareImport(files, "character", importChoices(options));
 		if (prepared.state !== "ready") return {
 			ok: false,
 			message: "请先选择角色内容类型或提示顺序组"
 		};
-		return persistCharacterCard(presetRoot, prepared.spec, prepared.sourceText ?? prepared.yaml, prepared.avatar, prepared.yaml);
+		return persistCharacterCard(moduleRoot, prepared.spec, prepared.sourceText ?? prepared.yaml, prepared.avatar, prepared.yaml);
 	} catch (error) {
 		return {
 			ok: false,
@@ -11966,10 +12388,10 @@ function importCharacterCard(presetRoot, files, options = {}) {
 	}
 }
 /** 原始文件流导入：识别 PNG 魔数后在 host 侧提取角色卡，避免客户端 base64 膨胀 JSON。 */
-function importCharacterCardFile(presetRoot, filePath, fileName = basename(filePath), options = {}) {
+function importCharacterCardFile(moduleRoot, filePath, fileName = basename(filePath), options = {}) {
 	try {
 		const buffer = readFileSync(filePath);
-		return importCharacterCard(presetRoot, [{
+		return importCharacterCard(moduleRoot, [{
 			path: basename(fileName),
 			content: buffer.toString("base64"),
 			encoding: "base64"
@@ -11981,16 +12403,16 @@ function importCharacterCardFile(presetRoot, filePath, fileName = basename(fileP
 		};
 	}
 }
-/** 角色卡库清单 + 各卡在当前预设的导入状态。 */
-function listCharacterCards(presetRoot, activeTemplate) {
-	const root = charactersDir(presetRoot);
+/** 角色卡库清单 + 各卡在当前模块的导入状态。 */
+function listCharacterCards(moduleRoot, activeTemplate) {
+	const root = charactersDir(moduleRoot);
 	let importedIds;
 	try {
-		const presetFile = activeTemplate !== void 0 && activeTemplate.length > 0 ? join(presetRoot, activeTemplate, "preset.yml") : "";
-		const list = (existsSync(presetFile) ? parseDocument(readFileSync(presetFile, "utf8"), { logLevel: "silent" }).toJS().meta : void 0)?.importedCharacters;
+		const moduleFile = activeTemplate !== void 0 && activeTemplate.length > 0 ? join(moduleRoot, activeTemplate, MODULE_DEFINITION_FILE) : "";
+		const list = (existsSync(moduleFile) ? parseDocument(readFileSync(moduleFile, "utf8"), { logLevel: "silent" }).toJS().meta : void 0)?.importedCharacters;
 		importedIds = new Set(Array.isArray(list) ? list.map(String) : []);
 	} catch (error) {
-		throw new Error(`读取当前预设角色状态失败：${String(error)}`);
+		throw new Error(`读取当前模块角色状态失败：${String(error)}`);
 	}
 	if (!presetPathExists(root)) return [];
 	assertNoLinks(root);
@@ -12007,12 +12429,12 @@ function listCharacterCards(presetRoot, activeTemplate) {
 	}).sort((a, b) => a.id.localeCompare(b.id));
 }
 /** 删除角色卡库条目。 */
-function deleteCharacterCard(presetRoot, id) {
+function deleteCharacterCard(moduleRoot, id) {
 	if (!validCardId(id)) return {
 		ok: false,
 		message: `非法角色卡 id：${id}`
 	};
-	const dir = cardDir(presetRoot, id);
+	const dir = cardDir(moduleRoot, id);
 	if (!existsSync(dir)) return {
 		ok: false,
 		message: `角色卡 ${id} 不存在`
@@ -12031,17 +12453,17 @@ function deleteCharacterCard(presetRoot, id) {
 		};
 	}
 }
-/** 角色卡参数导入当前预设：promptConfigs 合并（chara-<id>- 前缀防冲突）、
+/** 角色卡参数导入当前模块：promptConfigs 合并（chara-<id>- 前缀防冲突）、
 *  params 合并（角色卡覆盖同键）、meta.importedCharacters 记录来源。 */
-function applyCharacterToPreset(presetRoot, templateName, cardId) {
+function applyCharacterToPreset(moduleRoot, templateName, cardId) {
 	if (!validCardId(cardId)) return {
 		ok: false,
 		message: `非法角色卡 id：${cardId}`
 	};
-	const prefix = `chara-${cardId}-`;
+	const prefix = `module-${cardId}-`;
 	let personaOpened = false;
 	try {
-		const spec = loadConverted(cardDir(presetRoot, cardId));
+		const spec = loadImportSource(moduleRoot, cardId);
 		if (spec === void 0) return {
 			ok: false,
 			message: `角色卡 ${cardId} 不存在或参数损坏`
@@ -12049,7 +12471,7 @@ function applyCharacterToPreset(presetRoot, templateName, cardId) {
 		validateCharacterSpec(spec);
 		const hasSystemSections = (spec.promptConfigs ?? []).some((config) => isRecord$1(config) && config.layer === "system-section");
 		let count = 0;
-		withPresetDoc(join(presetRoot, templateName), (doc) => {
+		withPresetDoc(join(moduleRoot, templateName), (doc) => {
 			const current = doc.toJS();
 			if (hasSystemSections) {
 				const persona = current.persona;
@@ -12074,7 +12496,7 @@ function applyCharacterToPreset(presetRoot, templateName, cardId) {
 				}];
 			});
 			for (const [key, value] of Object.entries(readPresetLayerSettings(spec))) doc.setIn(engineParamPath(key), value);
-			const memory = readCharacterMemory(presetRoot, cardId);
+			const memory = readCharacterMemory(moduleRoot, cardId);
 			const memoryEntry = buildCharacterMemoryEntry(spec, memory);
 			const memoryConfig = memoryEntry === void 0 ? void 0 : {
 				...memoryEntry,
@@ -12128,21 +12550,21 @@ function applyCharacterToPreset(presetRoot, templateName, cardId) {
 		};
 	}
 }
-/** 从当前预设移除角色卡参数：删前缀 promptConfigs、删该卡声明的 params 键、
+/** 从当前模块移除角色卡参数：删前缀 promptConfigs、删该卡声明的 params 键、
 *  meta.importedCharacters 除名。 */
-function removeCharacterFromPreset(presetRoot, templateName, cardId) {
+function removeCharacterFromPreset(moduleRoot, templateName, cardId) {
 	if (!validCardId(cardId)) return {
 		ok: false,
 		message: `非法角色卡 id：${cardId}`
 	};
-	const prefix = `chara-${cardId}-`;
+	const prefixes = importPrefixes(cardId);
 	try {
-		const spec = loadConverted(cardDir(presetRoot, cardId));
+		const spec = loadImportSource(moduleRoot, cardId);
 		let removed = 0;
-		withPresetDoc(join(presetRoot, templateName), (doc) => {
+		withPresetDoc(join(moduleRoot, 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);
+				const isCard = config !== null && typeof config === "object" && prefixes.some((base) => String(config.id ?? "").startsWith(base));
 				if (isCard) removed += 1;
 				return !isCard;
 			});
@@ -12165,7 +12587,7 @@ function removeCharacterFromPreset(presetRoot, templateName, cardId) {
 			const records = recordedCharacterModules(current.meta);
 			const recorded = Object.values(records).flat();
 			if (recorded.length > 0) {
-				const others = modulesClaimedByOtherCards(presetRoot, remainingCards, current.meta, cardId);
+				const others = modulesClaimedByOtherCards(moduleRoot, remainingCards, current.meta, cardId);
 				const after = doc.toJS();
 				const context = {
 					configs: kept.filter(isRecord$1),
@@ -13466,27 +13888,25 @@ function officialChannelText(text, label, registry, warnOnce) {
 	}
 	return result.text;
 }
-/** 文本型层分组:merged 模式按位置分组,否则每条独立。 */
+/** 只合并排序后同来源、同官方档位和位置的连续 merged 卡，不跨过穿插段。 */
 function textLayerGroups(configs) {
-	const sorted = [...configs].sort((a, b) => a.order - b.order);
+	const sorted = [...configs].sort(compareTextPlacement);
 	const groups = [];
-	const index = /* @__PURE__ */ new Map();
 	for (const config of sorted) {
-		const key = config.mergeMode === "merged" ? `merged:${config.position ?? ""}` : void 0;
-		if (key === void 0) {
-			groups.push([config]);
-			continue;
-		}
-		let at = index.get(key);
-		if (at === void 0) {
-			at = groups.length;
-			index.set(key, at);
-			groups.push([]);
-		}
-		groups[at].push(config);
+		const previous = groups.at(-1);
+		const base = previous?.[0];
+		if (config.mergeMode === "merged" && base?.mergeMode === "merged" && config.sourceModuleId === base.sourceModuleId && config.position === base.position && config.order === base.order) previous.push(config);
+		else groups.push([config]);
 	}
 	return groups;
 }
+/** 官方同 order 按 name 排序：默认名编码安全整数序号，显式名仍由作者拥有。 */
+function textRegistrationName(config, field) {
+	const explicit = config.params?.[field];
+	if (typeof explicit === "string" && explicit.length > 0) return explicit;
+	if (config.sourceModuleId === void 0) return config.id;
+	return `prompt-tool:${String(config.sequence).padStart(16, "0")}:${config.sourceModuleId}:${config.id}`;
+}
 /** system-section:注册静态 system prompt 段(支持官方 {{variable}} 渲染与 merged 拼接)。 */
 function wireSystemSections(ctx, configs, registry, warnOnce) {
 	const disposers = [];
@@ -13503,7 +13923,7 @@ function wireSystemSections(ctx, configs, registry, warnOnce) {
 			if (!dynamic && groupText.length === 0) continue;
 			const text = dynamic ? (context) => group.filter((config) => matchesAgentScope(config, context?.agent)).map((config) => configText(config, registry, warnOnce, context)).filter((item) => item.length > 0).join("\n\n") : groupText;
 			keepDisposer(ctx, systemPrompt.section({
-				name: typeof base.params?.sectionName === "string" && base.params.sectionName.length > 0 ? base.params.sectionName : base.id,
+				name: textRegistrationName(base, "sectionName"),
 				order: base.order,
 				text,
 				...base.params?.complete === true ? { complete: true } : {}
@@ -13533,7 +13953,7 @@ function wireRuntimeContexts(ctx, configs, registry, warnOnce) {
 			const text = dynamic ? render : render();
 			if (!dynamic && text.length === 0) continue;
 			keepDisposer(ctx, systemPrompt.context({
-				name: typeof base.params?.contextName === "string" && base.params.contextName.length > 0 ? base.params.contextName : base.id,
+				name: textRegistrationName(base, "contextName"),
 				order: base.order,
 				text
 			}), `${name$1}: context ${base.id}`);
@@ -13541,7 +13961,7 @@ function wireRuntimeContexts(ctx, configs, registry, warnOnce) {
 			warnOnce(`${name$1}: runtime-context config ${base.id} failed: ${String(error?.message ?? error)}`);
 		}
 	}
-	const placeholders = configs.filter(needsResolver).sort((a, b) => a.order - b.order);
+	const placeholders = configs.filter(needsResolver).sort(compareTextPlacement);
 	if (placeholders.length === 0) return disposers;
 	const slotVariable = `pt_runtime_${newMessageId("context").replace(/[^a-z0-9_]/gi, "_").toLowerCase()}`;
 	const slotText = `{{${slotVariable}}}`;
@@ -13552,7 +13972,7 @@ function wireRuntimeContexts(ctx, configs, registry, warnOnce) {
 	}, `${name$1}: runtime-context lifecycle`);
 	keepDisposer(ctx, systemPrompt.variable(slotVariable, () => ""), `${name$1}: runtime-context placeholder`);
 	for (const config of placeholders) try {
-		const contextName = typeof config.params?.contextName === "string" && config.params.contextName.length > 0 ? config.params.contextName : config.id;
+		const contextName = textRegistrationName(config, "contextName");
 		keepDisposer(ctx, systemPrompt.context({
 			name: contextName,
 			order: config.order,
@@ -13631,18 +14051,17 @@ function applyAgentRequestParams(params, base) {
 }
 /** agent-request:对冻结的 LlmCallConfig 做浅合并 / 整体替换 / 按值条件删键。 */
 function wireAgentRequests(ctx, configs, warnOnce) {
-	const disposers = [];
-	for (const config of configs) disposers.push(ctx.on("agent/request", async (payload, next) => {
-		const base = await next();
-		try {
-			if (!matchesAgentScope(config, payload?.agent)) return base;
-			return applyAgentRequestParams(config.params, base);
+	if (configs.length === 0) return [];
+	const ordered = configs.some((config) => config.sequence !== void 0) ? configs : [...configs].reverse();
+	return [ctx.on("agent/request", async (payload, next) => {
+		let result = await next();
+		for (const config of ordered) try {
+			if (matchesAgentScope(config, payload?.agent)) result = applyAgentRequestParams(config.params, result);
 		} catch (error) {
 			warnOnce(`${name$1}: agent-request config ${config.id} failed: ${String(error?.message ?? error)}`);
-			return base;
 		}
-	}));
-	return disposers;
+		return result;
+	})];
 }
 /** 把流替换为提示词配置文本的最小合法 chunk 序列。 */
 async function* replacedStream(text) {
@@ -13815,23 +14234,28 @@ function createTurnStopBudget() {
 function wireTurnStops(ctx, configs, warnOnce) {
 	const disposers = [];
 	if (configs.length === 0) return disposers;
-	const budget = createTurnStopBudget();
-	for (const config of configs) disposers.push(ctx.on("agent/turn-stopping", ({ agent, turn } = {}) => {
-		try {
-			const session = agent?.session;
-			if (session?.id === void 0 || typeof agent.steer !== "function") return;
-			if (!matchesAgentScope(config, agent)) return;
-			const entry = budget.entry(session.id, turn);
-			if (!budget.available(entry, turn)) return;
-			if (!conditionHit(config, { assistantText: lastAssistantText(session) })) return;
-			const text = layerText(config, agent, warnOnce);
-			if (text.length === 0) return;
-			budget.claim(entry, turn);
-			agent.steer(pluginMessage(`turn-stop-${config.id}`, text, `turn-stop ${config.id}`));
-		} catch (error) {
-			warnOnce(`${name$1}: turn-stop config ${config.id} failed: ${String(error?.message ?? error)}`);
-		}
-	}));
+	const budgets = /* @__PURE__ */ new Map();
+	for (const config of configs) {
+		const source = config.sourceModuleId ?? "";
+		if (!budgets.has(source)) budgets.set(source, createTurnStopBudget());
+		const budget = budgets.get(source);
+		disposers.push(ctx.on("agent/turn-stopping", ({ agent, turn } = {}) => {
+			try {
+				const session = agent?.session;
+				if (session?.id === void 0 || typeof agent.steer !== "function") return;
+				if (!matchesAgentScope(config, agent)) return;
+				const entry = budget.entry(session.id, turn);
+				if (!budget.available(entry, turn)) return;
+				if (!conditionHit(config, { assistantText: lastAssistantText(session) })) return;
+				const text = layerText(config, agent, warnOnce);
+				if (text.length === 0) return;
+				budget.claim(entry, turn);
+				agent.steer(pluginMessage(`turn-stop-${config.id}`, text, `turn-stop ${config.id}`));
+			} catch (error) {
+				warnOnce(`${name$1}: turn-stop config ${config.id} failed: ${String(error?.message ?? error)}`);
+			}
+		}));
+	}
 	return disposers;
 }
 /** 沿官方持久 session 血缘找根会话，不根据当前 UI 会话或预设名称猜测。 */
@@ -13934,6 +14358,7 @@ function wireSubagentEvents(ctx, configs, warnOnce) {
 *   变量注册走 keepDisposer（随 ctx fiber 释放），不在本函数的回收面内。
 */
 function wireLayers(ctx, configs, warnOnce) {
+	configs = [...configs].sort(compareConfigSequence);
 	const registry = registerOfficialVariables(ctx, configs.filter((config) => config.layer === "system-section" || config.layer === "runtime-context"), warnOnce);
 	const registered = [
 		wireSystemSections(ctx, configs.filter((config) => config.layer === "system-section"), registry, warnOnce),
@@ -14482,22 +14907,18 @@ async function runPreStepBatch(options) {
 		} catch (error) {
 			warnOnce(`${name}: config ${String(config?.id ?? "<unknown>")} failed, skipping: ${String(error && error.message || error)}`);
 		}
-		due.sort((a, b) => a.config.order - b.config.order);
+		due.sort((a, b) => compareConfigSequence(a.config, b.config));
 		const orderedGroups = [];
-		const groupIndex = /* @__PURE__ */ new Map();
+		const lastAtPosition = /* @__PURE__ */ new Map();
 		for (const entry of due) {
-			const group = entry.config.mergeMode === "merged" ? mergedIdentity(entry.config) : void 0;
-			if (group === void 0) {
-				orderedGroups.push([entry]);
-				continue;
-			}
-			let index = groupIndex.get(group);
-			if (index === void 0) {
-				index = orderedGroups.length;
-				groupIndex.set(group, index);
-				orderedGroups.push([]);
+			const previous = lastAtPosition.get(entry.config.position);
+			const base = previous?.[0].config;
+			if (entry.config.mergeMode === "merged" && base?.mergeMode === "merged" && entry.config.sourceModuleId === base.sourceModuleId) previous.push(entry);
+			else {
+				const group = [entry];
+				orderedGroups.push(group);
+				lastAtPosition.set(entry.config.position, group);
 			}
-			orderedGroups[index].push(entry);
 		}
 		const planned = [];
 		for (const group of orderedGroups) {
@@ -14569,11 +14990,10 @@ async function runPreStepBatch(options) {
 * @param options.officialInstructions 本 mount 的组合是否仍挂着官方指令加载行
 *   (负责人冲突事实;协调器据此拒绝同时注入文件正文)。
 */
-function applyPromptConfigs(ctx, configs, options = {}) {
+function effectivePromptConfigs(configs) {
 	const list = configs.filter((config) => config !== void 0 && config !== null);
-	const sourceId = typeof options.sourceId === "string" && options.sourceId.length > 0 ? options.sourceId : `preset:${String(list[0]?.id ?? "unknown")}`;
 	const claimedGroups = /* @__PURE__ */ new Set();
-	const effectiveList = list.filter((config) => {
+	return list.filter((config) => {
 		if (config.enabled === false) return false;
 		if (config.group !== void 0 && config.exclusive === true) {
 			if (claimedGroups.has(config.group)) return false;
@@ -14581,6 +15001,28 @@ function applyPromptConfigs(ctx, configs, options = {}) {
 		}
 		return true;
 	});
+}
+/** 多模块仍各自拥有来源/互斥组；只有非 pre-step 层汇总接线，避免模块块状执行。 */
+function applyPromptConfigSources(ctx, sources, options = {}) {
+	const selected = sources.map((source) => ({
+		...source,
+		configs: effectivePromptConfigs(source.configs)
+	}));
+	const releases = selected.map((source) => applyPromptConfigs(ctx, source.configs, {
+		...options,
+		...source,
+		layers: false
+	}));
+	const releaseLayers = wireLayers(ctx, selected.flatMap((source) => source.configs).filter((config) => config.layer !== "pre-step"), createWarnOnce(ctx, name));
+	return () => {
+		for (const release of releases) release();
+		releaseLayers();
+	};
+}
+function applyPromptConfigs(ctx, configs, options = {}) {
+	const list = configs.filter((config) => config !== void 0 && config !== null);
+	const sourceId = typeof options.sourceId === "string" && options.sourceId.length > 0 ? options.sourceId : `preset:${String(list[0]?.id ?? "unknown")}`;
+	const effectiveList = effectivePromptConfigs(list);
 	const injectedMemo = /* @__PURE__ */ new Map();
 	const main = createEpochPromotion(PROMOTE_EVENTS.either, { includeSubagents: false });
 	const withSubagents = createEpochPromotion(PROMOTE_EVENTS.either, { includeSubagents: true });
@@ -14617,7 +15059,7 @@ function applyPromptConfigs(ctx, configs, options = {}) {
 		injectedMemo.clear();
 	};
 	keepDisposer(ctx, release);
-	const releaseLayers = wireLayers(ctx, effectiveList.filter((config) => config.layer !== "pre-step"), warnOnce);
+	const releaseLayers = options.layers === false ? () => {} : wireLayers(ctx, effectiveList.filter((config) => config.layer !== "pre-step"), warnOnce);
 	let registeredCoordinator = coordinatorOf(ctx);
 	if (registeredCoordinator !== void 0) registration = registeredCoordinator.registerPreset(ctx, sourceId, source) ?? null;
 	const preStepDisposer = ctx.on("agent/pre-step", async (payload, next) => {
@@ -16031,17 +16473,17 @@ function compileDeclarations(specs, context = {}) {
 //#endregion
 //#region src/host/write-preset.ts
 /**
-* write-preset — 单一参数 YAML 驱动的官方预设目录物化器。
+* write-preset — 单一参数 YAML 驱动的模块目录物化器。
 *
-* 用户只需编写 preset/<template>/preset.yml(纯参数):
+* 用户只需编写 modules/<template>/module.yml(纯参数):
 *   meta + content + modules(模块清单)+ params(直读参数)+ 可选 promptConfigs 覆盖。
 * 默认提示词配置与组合 token 都由引擎按 params 生成,参数文件不含任何模板语法。
-* 输出 = 官方对齐布局：presetDir/<template>/（预设目录，agent.cordis.yml 组合本体
+* 输出 = 官方对齐布局：moduleDir/<template>/（模块目录，agent.cordis.yml 组合本体
 * 直接可挂载）。共享引擎自阶段 2 起由插件包提供（组合行引用包内说明符），不再物化。
 */
 const ENGINE_DIR = packageEngineDir();
 const RENDER_STAMP = `# prompt-tool:render v5`;
-/** 剥离文本中的预设级变量引用（{{key}} → 空串）；内置变量（{{DSH_HOME}} 等）保留。
+/** 剥离文本中的模块级变量引用（{{key}} → 空串）；内置变量（{{DSH_HOME}} 等）保留。
 *  模板变量插值停用时由 writePreset 调用，避免 {{key}} 残留导致官方渲染 unknown variable。 */
 function stripVariableRefs(text, keys) {
 	return text.replace(/\{\{([A-Za-z0-9_.\u4e00-\u9fff-]+)\}\}/g, (whole, key) => keys.has(key) ? "" : whole);
@@ -16050,6 +16492,28 @@ function stripVariableRefs(text, keys) {
 *  ST 导入的设置 dump（SPresetSettings 等）动辄数百 KB 且 enabled=false——
 *  注入与展示都不需要正文，全量落盘只拖慢 rebuild 与引擎启动扫描。 */
 const DISABLED_TEXT_SLIM_THRESHOLD = 32768;
+/** 按模块身份重建：定义与正文均读取该模块，不叠加工作台当前编辑态。 */
+function materializeModule(id, options) {
+	if (enabledModuleIds(options.moduleDir).includes(id)) appendModuleConfigOrder(options.moduleDir, id);
+	const dir = resolveModuleDir(id, options.moduleDir);
+	const spec = loadModuleSpec(dir);
+	const content = (file, fallback) => {
+		try {
+			return readFileSync(join(dir, file), "utf8") || fallback;
+		} catch {
+			return fallback;
+		}
+	};
+	return writePreset(content("preset.md", asString(spec.content?.presetText)), {
+		moduleDir: options.moduleDir,
+		presetOrder: options.presetOrder,
+		presetTemplate: id,
+		outputId: id,
+		promptConfigs: [],
+		agentsInstructionText: content("agents.md", asString(spec.content?.agentsText)),
+		warn: options.warn
+	});
+}
 /** Windows 瞬时文件锁（杀软/宿主短读）下的重试：rename/写文件失败最多重试 3 次、间隔 400ms。 */
 function withLockRetry(action, retries = 3) {
 	for (let attempt = 0;; attempt++) try {
@@ -16092,19 +16556,16 @@ function syncDirInPlace(srcDir, destDir) {
 /**
 * 写盘用的 runtime 参数对象。
 *
-* **导出供测试固化其归一化行为**（`test/shared/engine-param-schema.test.mjs` 的特性断言）：
-* 这些逐键归一化**不是** `ENGINE_PARAM_DEFINITIONS` 类型信息的重复拷贝——规则取决于运行时的
-* 需要，且与 `index.ts` 的 `reloadPresetParams` **不同**（例如 `firstTurnAnchor` 在这里
-* 保留调用方显式的 `false`，读回时却布尔化成 `params.x === true`）。所以它必须被逐键钉住，
-* 不能被「按 kind 统一驱动」取代。
+* 保留外部调用方的显式覆盖语义；普通模块重建不再回传定义中的参数副本。
+* 未提供与显式 false / 0 / 空字符串不同，不能用编辑器默认值补齐。
 */
 function runtimeOf(options, prompt) {
 	/** 未提供的参数保持 undefined：resolvePresetParams 跳过 undefined 键，
-	*  预设 preset.yml 的 params/model 段才是缺省值来源。写成 false/''/true 会把
+	*  模块 module.yml 的 params/model 段才是缺省值来源。写成 false/''/true 会把
 	*  「调用方没给」冒充成「调用方要求」，导入与离线物化时覆盖作者定义。 */
 	const providedBoolean = (value) => typeof value === "boolean" ? value : void 0;
 	return {
-		...Object.fromEntries(ENGINE_PARAM_KEYS.map((key) => [key, options[key]])),
+		...Object.fromEntries(WRITER_PARAM_KEYS.map((key) => [key, options[key]])),
 		promptText: prompt,
 		firstTurnAnchor: providedBoolean(options.firstTurnAnchor),
 		firstTurnCustom: providedBoolean(options.firstTurnCustom),
@@ -16127,7 +16588,7 @@ function runtimeOf(options, prompt) {
 		firstTurnWord: typeof options.firstTurnWord === "string" && options.firstTurnWord.length > 0 ? options.firstTurnWord : void 0
 	};
 }
-/** 手写/导入预设恢复路径：与保存方完整编译同源，但坏定义仍逐条告警跳过。 */
+/** 手写/导入模块恢复路径：与保存方完整编译同源，但坏定义仍逐条告警跳过。 */
 function materializeCustomTool(tool, warn) {
 	try {
 		return compileCustomTool(tool);
@@ -16136,18 +16597,18 @@ function materializeCustomTool(tool, warn) {
 		return;
 	}
 }
-/** 把任意单一参数预设模板物化到生成目录;全部失败 fail loud。 */
+/** 把任意单一参数模块模板物化到生成目录;全部失败 fail loud。 */
 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() : DEFAULT_PRESET_ID;
+	const moduleDir = options.moduleDir.trim().length > 0 ? options.moduleDir : MODULES_DIR;
+	const templateName = typeof options.presetTemplate === "string" && options.presetTemplate.trim().length > 0 ? options.presetTemplate.trim() : DEFAULT_MODULE_ID;
 	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-]*$/`);
 	assertPresetId(templateName);
 	assertPresetId(outputId);
-	const templateDir = options.sourceDir ?? resolvePresetDir(templateName, presetDir);
+	const templateDir = options.sourceDir ?? resolveModuleDir(templateName, moduleDir);
 	assertPresetTree(templateDir);
-	let spec = loadPresetSpec(templateDir);
+	const spec = loadModuleSpec(templateDir, { legacyParams: false });
 	if (Array.isArray(spec.meta?.stWarnings)) {
 		for (const warning of spec.meta.stWarnings) if (typeof warning === "string") options.warn?.(`prompt-tool: ST 导入兼容提示：${warning}`);
 	}
@@ -16165,26 +16626,32 @@ function writePreset(prompt, options) {
 	}
 	const runtime = runtimeOf(options, prompt);
 	const params = resolvePresetParams(spec, runtime);
-	const targetDir = assertPresetDirectory(presetDir, outputId, true);
-	mkdirSync(presetDir, { recursive: true });
-	const tmpDir = mkdtempSync(join(presetDir, `.${outputId}.tmp-`));
+	const legacy = resolveLegacyPromptConfigs(spec, {
+		moduleDir: templateDir,
+		prompt,
+		overrides: runtime,
+		promptConfigs: options.promptConfigs
+	});
+	for (const warning of legacy.warnings) (options.warn ?? console.warn)(`prompt-tool: ${warning}`);
+	const targetDir = assertModuleDirectory(moduleDir, outputId, true);
+	mkdirSync(moduleDir, { recursive: true });
+	const tmpDir = mkdtempSync(join(moduleDir, `.${outputId}.tmp-`));
 	const outDir = tmpDir;
 	try {
-		const composition = renderComposition(Array.isArray(options.promptConfigs) && options.promptConfigs.length > 0 ? {
+		const composition = renderComposition({
 			...spec,
-			promptConfigs: options.promptConfigs
-		} : spec, runtime, templateDir);
+			promptConfigs: legacy.configs
+		}, runtime, templateDir);
 		assertCompositionArray(composition, spec);
 		const subComposition = rewritePresetEngineReferences(composition, outputId, engineModuleFileNames(ENGINE_DIR));
 		writeFileSync(join(outDir, "agent.cordis.yml"), `${RENDER_STAMP}\n${subComposition}`, "utf8");
 		const meta = spec.meta !== null && typeof spec.meta === "object" ? spec.meta : {};
-		const sourceYamlPath = options.sourceDir !== void 0 || !existsSync(join(targetDir, "preset.yml")) ? join(templateDir, "preset.yml") : join(targetDir, "preset.yml");
+		const sourceYamlPath = options.sourceDir !== void 0 || !existsSync(join(targetDir, "module.yml")) ? join(templateDir, MODULE_DEFINITION_FILE) : join(targetDir, MODULE_DEFINITION_FILE);
 		const existingPresetYaml = existsSync(sourceYamlPath) ? readFileSync(sourceYamlPath, "utf8") : void 0;
 		if (existingPresetYaml !== void 0 && existingPresetYaml.trim().length > 0) {
 			const doc = parseDocument(existingPresetYaml, { logLevel: "silent" });
 			if (doc.errors.length > 0) throw new Error(`invalid preset.yml: ${doc.errors[0].message}`);
 			doc.set("id", outputId);
-			doc.setIn(["order"], options.presetOrder);
 			const ensureMetaKey = (key, value) => {
 				if (value === void 0 || value === null) return;
 				const current = doc.get(key);
@@ -16193,18 +16660,15 @@ function writePreset(prompt, options) {
 			ensureMetaKey("name", typeof spec.name === "string" && spec.name.length > 0 ? spec.name : void 0);
 			ensureMetaKey("description", typeof spec.description === "string" && spec.description.length > 0 ? spec.description : void 0);
 			ensureMetaKey("meta", Object.keys(meta).length > 0 ? meta : void 0);
-			writeFileSync(join(outDir, "preset.yml"), doc.toString(), "utf8");
-		} else writeFileSync(join(outDir, "preset.yml"), stringify({
-			...meta,
-			order: options.presetOrder
-		}) + "\n", "utf8");
+			writeFileSync(join(outDir, MODULE_DEFINITION_FILE), doc.toString(), "utf8");
+		} else writeFileSync(join(outDir, MODULE_DEFINITION_FILE), stringify(meta) + "\n", "utf8");
 		if (prompt.trim().length > 0) writeFileSync(join(outDir, "preset.md"), prompt, "utf8");
 		else if (existsSync(join(templateDir, "preset.md"))) cpSync(join(templateDir, "preset.md"), join(outDir, "preset.md"));
 		if (typeof options.agentsInstructionText === "string" && options.agentsInstructionText.trim().length > 0) writeFileSync(join(outDir, "agents.md"), options.agentsInstructionText, "utf8");
 		else if (existsSync(join(templateDir, "agents.md"))) cpSync(join(templateDir, "agents.md"), join(outDir, "agents.md"));
 		const templateEntries = readdirSync(templateDir, { withFileTypes: true });
 		for (const entry of templateEntries) {
-			if (entry.name === "preset.yml" || entry.name === "agent.cordis.yml" || entry.name === "preset.md" || entry.name === "agents.md") continue;
+			if (entry.name === "module.yml" || entry.name === "agent.cordis.yml" || entry.name === "preset.md" || entry.name === "agents.md") continue;
 			const source = join(templateDir, entry.name);
 			const target = join(outDir, entry.name);
 			if (entry.isDirectory()) cpSync(source, target, {
@@ -16213,84 +16677,24 @@ function writePreset(prompt, options) {
 			});
 			else cpSync(source, target, { force: true });
 		}
-		const promptConfigsDir = join(outDir, "prompt-configs");
+		const promptConfigsDir = join(outDir, MODULE_CONFIGS_DIR);
 		rmSync(promptConfigsDir, {
 			recursive: true,
 			force: true
 		});
 		mkdirSync(promptConfigsDir, { recursive: true });
-		const templateConfigs = Array.isArray(spec.promptConfigs) ? spec.promptConfigs : [];
-		let templateDefaults;
-		if (templateConfigs.length > 0) templateDefaults = templateConfigs.map((config) => {
-			const next = {
-				...config,
-				params: { ...config.params }
-			};
-			if (next.id === "near-anchor") {
-				next.enabled = params.firstTurnAnchor === true;
-				next.params = {
-					...next.params,
-					useCustom: params.firstTurnCustom === true,
-					text: asString(params.firstTurnText),
-					buildPattern: asString(params.buildPattern),
-					complexPattern: asString(params.complexPattern),
-					firstTurnBuild: asString(params.firstTurnBuild),
-					firstTurnInspect: asString(params.firstTurnInspect),
-					firstTurnDeep: asString(params.firstTurnDeep)
-				};
-			} else if (next.id === "router-guide") {
-				const guideEnabled = 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),
-					complexPattern: asString(params.complexPattern),
-					guideWeak: asString(params.guideWeak),
-					guideDeep: asString(params.guideDeep)
-				};
-			}
-			return next;
-		});
-		else templateDefaults = [];
-		const merged = mergePromptConfigs(modelRequestConfigs(params), templateDefaults, options.promptConfigs);
+		const merged = mergePromptConfigs(modelRequestConfigs(params), legacy.configs);
 		const presetVariables = {};
 		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");
+		const configOrder = readConfigOrder(spec.configOrder);
 		for (const [index, source] of merged.entries()) {
 			const config = {
 				...source,
 				params: source.params !== void 0 && source.params !== null ? { ...source.params } : source.params
 			};
-			if (config.id === "prompt-injector") {
-				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: explicitWord,
-					anchorWords
-				};
-			}
 			if (!variablesEnabled && presetVariableKeys.size > 0) {
 				const strip = (item) => stripVariableRefs(item, presetVariableKeys);
 				config.texts = (config.texts ?? []).map(strip);
@@ -16305,16 +16709,8 @@ function writePreset(prompt, options) {
 				delete config.text;
 				config.texts = [];
 			}
-			const binding = MANAGED_CONFIG_FIELDS.find((entry) => entry.configId === config.id);
-			const fieldSources = binding === void 0 ? void 0 : {
-				configId: config.id,
-				fields: binding.fields.map(({ path }) => ({
-					path,
-					source: templateDefaults.includes(source) ? "preset-param" : "prompt-config"
-				}))
-			};
-			const provenance = fieldSources === void 0 ? "" : "\n" + stringify({ fieldSources });
-			writeFileSync(join(promptConfigsDir, configFileName(index * 10, config.id)), renderPromptConfigYaml(config) + provenance, "utf8");
+			const sequence = configOrder[config.id] ?? index * 10;
+			writeFileSync(join(promptConfigsDir, configFileName(sequence, config.id)), renderPromptConfigYaml(config), "utf8");
 		}
 		const customToolsDir = join(outDir, "custom-tools");
 		rmSync(customToolsDir, {
@@ -16344,7 +16740,7 @@ function writePreset(prompt, options) {
 		rmSync(triggersFile, { force: true });
 		if (Array.isArray(spec.triggers) && spec.triggers.length > 0) writeFileSync(triggersFile, stringify(spec.triggers, { lineWidth: 0 }), "utf8");
 		if (options.materializeOnly) return outDir;
-		const backupDir = join(presetDir, `.${templateName}.bak-${Date.now().toString(36)}`);
+		const backupDir = join(moduleDir, `.${templateName}.bak-${Date.now().toString(36)}`);
 		let oldMoved = false;
 		let inPlace = false;
 		if (existsSync(targetDir)) try {
@@ -16384,10 +16780,17 @@ function writePreset(prompt, options) {
 	}
 }
 //#endregion
-//#region src/host/preset-package.ts
-/** 预设交换：有界资源、完整候选与可恢复提交，Web 和 CLI 共用。 */
+//#region src/host/module-package.ts
+/** 模块交换：有界资源、完整候选与可恢复提交，Web 和 CLI 共用。 */
 const MANIFEST = "prompt-tool-package.json";
 const PACKAGE_VERSION = 1;
+/**
+* 包内定义文件名：写入用新名，**读取接受历史名**。
+*
+* 包是可分享的外部产物，用户手里可能有旧版导出的包（清单 `definition: preset.yml`）；
+* 导入是信任边界，拒绝它等于把用户已有的包判为损坏。
+*/
+const DEFINITION_NAMES = [MODULE_DEFINITION_FILE, "preset.yml"];
 const sha = (bytes) => createHash("sha256").update(bytes).digest("hex");
 const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 var AssetTransferError = class extends Error {
@@ -16407,7 +16810,7 @@ function assertTransferId(id) {
 function ownedFile(path) {
 	const root = path.split("/")[0];
 	if (root.startsWith(".") || [
-		"prompt-configs",
+		"configs",
 		"custom-tools",
 		"subagent-tools",
 		"skills"
@@ -16442,7 +16845,7 @@ async function expandPresetSource(input) {
 	const manifest = files.find((file) => file.path === MANIFEST);
 	if (manifest !== void 0) {
 		const value = JSON.parse(decodeAssetFile(manifest).toString("utf8"));
-		if (!isRecord(value) || value.version !== PACKAGE_VERSION || value.definition !== "preset.yml" || !isRecord(value.files)) throw new Error("不支持或损坏的预设包清单");
+		if (!isRecord(value) || value.version !== PACKAGE_VERSION || typeof value.definition !== "string" || !DEFINITION_NAMES.includes(value.definition) || !isRecord(value.files)) throw new Error("不支持或损坏的预设包清单");
 		if (isRecord(value.requires) && typeof value.requires.renderVersion === "number" && value.requires.renderVersion > 5) throw new Error("预设包需要较新的 Prompt Tool");
 		const entries = files.filter((file) => file !== manifest);
 		if (Object.keys(value.files).length !== entries.length) throw new Error("包清单与文件集合不一致");
@@ -16450,7 +16853,7 @@ async function expandPresetSource(input) {
 		files = entries;
 	}
 	const yaml = files.filter((file) => !file.path.includes("/") && /\.ya?ml$/i.test(file.path) && file.path !== "agent.cordis.yml");
-	const definition = yaml.find((file) => /^preset\.ya?ml$/i.test(file.path)) ?? (yaml.length === 1 ? yaml[0] : void 0);
+	const definition = yaml.find((file) => /^(?:module|preset)\.ya?ml$/i.test(file.path)) ?? (yaml.length === 1 ? yaml[0] : void 0);
 	if (definition !== void 0) {
 		const doc = parseDocument(decodeAssetFile(definition).toString("utf8"), { logLevel: "silent" });
 		const value = doc.errors.length === 0 ? doc.toJS({ maxAliasCount: 100 }) : void 0;
@@ -16483,7 +16886,7 @@ function presetImportPreview(root, files, request) {
 	});
 	if (prepared.state !== "ready") return prepared;
 	const id = targetId(root, request.targetId ?? prepared.spec.id, request);
-	const version = directoryVersionOf(assertPresetDirectory(root, id, true));
+	const version = directoryVersionOf(assertModuleDirectory(root, id, true));
 	const sourceDigest = assetSourceDigest(files);
 	return {
 		prepared,
@@ -16572,7 +16975,7 @@ async function installPresetPackage(root, files, request) {
 		let moved = false;
 		const backup = join(stage, "previous");
 		try {
-			for (const file of preview.prepared.files.filter((file) => !["preset.yml", MANIFEST].includes(file.path))) {
+			for (const file of preview.prepared.files.filter((file) => file.path !== MANIFEST && !DEFINITION_NAMES.includes(file.path))) {
 				const path = join(source, safeAssetPath(file.path));
 				mkdirSync(dirname(path), { recursive: true });
 				writeFileSync(path, decodeAssetFile(file), { flag: "wx" });
@@ -16581,10 +16984,10 @@ async function installPresetPackage(root, files, request) {
 			setPresetDefinitionId(doc, preview.summary.targetId);
 			doc.set("name", preview.summary.targetName);
 			const spec = doc.toJS();
-			writeFileSync(join(source, "preset.yml"), doc.toString(), "utf8");
+			writeFileSync(join(source, MODULE_DEFINITION_FILE), doc.toString(), "utf8");
 			checkCandidate(spec, source, root, preview.summary.targetId);
 			generated = writePreset(existsSync(join(source, "preset.md")) ? readFileSync(join(source, "preset.md"), "utf8") : "", {
-				presetDir: root,
+				moduleDir: root,
 				presetTemplate: preview.summary.targetId,
 				outputId: preview.summary.targetId,
 				sourceDir: source,
@@ -16610,7 +17013,7 @@ async function installPresetPackage(root, files, request) {
 				}
 				throw error;
 			}
-			invalidatePresetSpec(target);
+			invalidateModuleSpec(target);
 			try {
 				rmSync(stage, {
 					recursive: true,
@@ -16687,7 +17090,7 @@ function dependencyErrors(files, spec) {
 		if (typeof config.templateFile === "string") {
 			const prefix = `../${spec.id}/`;
 			if (!config.templateFile.startsWith(prefix)) errors.add(`外部模板：${config.templateFile}`);
-			else check("./" + config.templateFile.slice(prefix.length), "preset.yml");
+			else check("./" + config.templateFile.slice(prefix.length), MODULE_DEFINITION_FILE);
 		}
 	}
 	for (const file of files) {
@@ -16715,11 +17118,11 @@ function dependencyErrors(files, spec) {
 }
 async function exportPresetPackage(root, request) {
 	assertTransferId(request.id);
-	const dir = resolvePresetDir(request.id, root);
+	const dir = resolveModuleDir(request.id, root);
 	const before = directoryVersionOf(dir);
 	if (before === null) throw new Error("预设不存在");
 	const files = collectFiles(dir);
-	const definition = files.find((file) => file.path === "preset.yml");
+	const definition = files.find((file) => file.path === MODULE_DEFINITION_FILE);
 	if (!definition) throw new Error("缺少预设定义");
 	const original = parseDocument(definition.bytes.toString("utf8"));
 	if (original.errors.length > 0) throw new Error(original.errors[0].message);
@@ -16742,7 +17145,7 @@ async function exportPresetPackage(root, request) {
 		name: spec.name || request.id,
 		content: "",
 		revision,
-		filename: `${request.id}.${mode === "zip" ? "zip" : "preset.yml"}`,
+		filename: `${request.id}.${mode === "zip" ? "zip" : MODULE_DEFINITION_FILE}`,
 		files: files.map((file) => ({
 			path: file.path,
 			bytes: file.bytes.length
@@ -16765,7 +17168,7 @@ async function exportPresetPackage(root, request) {
 	const plugin = JSON.parse(readFileSync(join(dirname(packageEngineDir()), "package.json"), "utf8"));
 	const manifest = Buffer.from(JSON.stringify({
 		version: PACKAGE_VERSION,
-		definition: "preset.yml",
+		definition: MODULE_DEFINITION_FILE,
 		requires: {
 			promptTool: plugin.version,
 			renderVersion: 5
@@ -16789,4 +17192,4 @@ async function exportPresetPackage(root, request) {
 	};
 }
 //#endregion
-export { ensurePresetSeed as $, USER_SKILLS_DIR as $t, decodeAssetFile as A, createWarnOnce as At, MAX_ASSET_BYTES as B, ENGINE_CAPABILITIES as Bt, listCharacterCards as C, KNOWN_AUDIENCES as Ct, removeCharacterFromPreset as D, createEpochPromotion as Dt, recordedCharacterModules as E, KNOWN_PROMOTIONS as Et, stPresetId as F, assertPresetId as Ft, stripConfigFieldSources as G, isEngineCapabilityPresent as Gt, savePresetTriggers as H, ENGINE_RECIPES as Ht, buildWorldBookEntry as I, canonicalPresetRoot as It, asString as J, WRITER_PARAM_KEYS as Jt, appendPresetModules as K, validateCustomToolIdentities as Kt, deleteWorldBookEntry as L, presetPathExists as Lt, convertStToPreset as M, PresetLayerSettingsError as Mt, mergeStPresets as N, PRESET_ENGINE_PREFIX as Nt, requiredCharacterModules as O, isSuccessfulCompactionEnd as Ot, processStText as P, assertPresetDirectory as Pt, duplicateUserPreset as Q, DSH_HOME as Qt, listWorldBookEntries as R, DEFAULT_PRESET_ID as Rt, importCharacterCardFile as S, renderPromptConfigYaml as St, readCharacterMemory as T, KNOWN_POSITIONS as Tt, triggerPromptConfigOptions as U, engineCapability as Ut, readPresetTriggers as V, ENGINE_EDITOR_GROUP_MAP as Vt, readConfigFieldSources as W, engineRecipe as Wt, cloneBuiltinPreset as X, validateEngineParamValues as Xt, buildModuleConfigsFromParams as Y, moduleParamFallbacks as Yt, createEngineCapabilityInPreset as Z, DEFAULT_PRESET_DIR as Zt, characterModuleStillNeeded as _, withPresetDoc as _t, writePreset as a, openPresetLocation as at, deleteCharacterCard as b, configFileName as bt, lastWorldBookDiagnostics as c, removePresetModule as ct, computePreviewRevision as d, resolvePresetDir as dt, invalidatePresetSpec as et, directoryVersionOf as f, resolvePresetModuleFacts as ft, applyCharacterToPreset as g, userPresetsDir as gt, appendMemoryFile as h, savePresetPersona as ht, presetImportPreview as i, loadPresetSpec as it, prepareImport as j, sessionEvents as jt, syncImportedCharacterMemory as k, PROMOTE_EVENTS as kt, validateCustomTools as l, removeUserPreset as lt, appendCharacterMemory as m, savePresetParams as mt, exportPresetPackage as n, listPresets as nt, confirmDelivered as o, packageEngineDir as ot, CHARACTER_MODULES_KEY as p, resolvePresetParams as pt, applyModuleConfigs as q, ENGINE_PARAM_KEYS as qt, installPresetPackage as r, loadPresetContent as rt, runPreStepBatch as s, removeEngineCapabilityFromPreset as st, expandPresetSource as t, listBuiltinTemplates as tt, safeAssetPath as u, renderComposition as ut, charactersDir as v, atomicWriteTextFile as vt, previewCharacterCard as w, KNOWN_MODEL_SCOPES as wt, importCharacterCard as x, listPromptConfigSpecs as xt, declaredCharacterModules as y, assertSafeConfigId as yt, upsertWorldBookEntry as z, readPersonaSpec as zt };
+export { setModuleEnabled as $, moduleParamFallbacks as $t, requiredCharacterModules as A, createPromptConfigs as At, listWorldBookEntries as B, presetPathExists as Bt, importCharacterCard as C, userModulesDir as Ct, readCharacterMemory as D, configFileName as Dt, previewCharacterCard as E, assertSafeConfigId as Et, mergeStPresets as F, createWarnOnce as Ft, triggerPromptConfigOptions as G, ENGINE_RECIPES as Gt, MAX_ASSET_BYTES as H, readPersonaSpec as Ht, processStText as I, PresetLayerSettingsError as It, readConfigOrder as J, isEngineCapabilityPresent as Jt, ModuleConfigOrderError as K, engineCapability as Kt, stPresetId as L, assertModuleDirectory as Lt, decodeAssetFile as M, compareConfigSequence as Mt, prepareImport as N, createEpochPromotion as Nt, recordedCharacterModules as O, listPromptConfigSpecs as Ot, convertStToPreset as P, PROMOTE_EVENTS as Pt, resolveEditDir as Q, WRITER_PARAM_KEYS as Qt, buildWorldBookEntry as R, assertPresetId as Rt, deleteCharacterCard as S, savePresetPersona as St, listCharacterCards as T, atomicWriteTextFile as Tt, readModuleTriggers as U, ENGINE_CAPABILITIES as Ut, upsertWorldBookEntry as V, DEFAULT_MODULE_ID as Vt, saveModuleTriggers as W, ENGINE_EDITOR_GROUP_MAP as Wt, saveModuleConfigOrder as X, ENGINE_PARAM_DEFINITIONS as Xt, readModuleConfigOrder as Y, validateCustomToolIdentities as Yt, enabledModuleIds as Z, ENGINE_PARAM_KEYS as Zt, appendMemoryFile as _, renderComposition as _t, materializeModule as a, MODULE_DEFINITION_FILE as an, duplicateUserModule as at, charactersDir as b, resolvePresetParams as bt, confirmDelivered as c, listBuiltinTemplates as ct, validateCustomTools as d, moduleDirExists as dt, validateEngineParamValues as en, appendPresetModules as et, safeAssetPath as f, openModuleLocation as ft, appendCharacterMemory as g, removeUserPreset as gt, CHARACTER_MODULES_KEY as h, removePresetModule as ht, presetImportPreview as i, MODULE_CONFIGS_DIR as in, createEngineCapabilityInPreset as it, syncImportedCharacterMemory as j, loadPromptConfigFiles as jt, removeCharacterFromPreset as k, renderPromptConfigYaml as kt, runPreStepBatch as l, listModules as lt, directoryVersionOf as m, removeEngineCapabilityFromPreset as mt, exportPresetPackage as n, DSH_HOME as nn, buildModuleConfigsFromParams as nt, writePreset as o, USER_SKILLS_DIR as on, ensurePresetSeed as ot, computePreviewRevision as p, packageEngineDir as pt, appendModuleConfigOrder as q, engineRecipe as qt, installPresetPackage as r, MODULES_DIR as rn, cloneBuiltinPreset as rt, applyPromptConfigSources as s, invalidateModuleSpec as st, expandPresetSource as t, LEGACY_PROMPT_PARAM_KEYS as tn, applyModuleConfigs as tt, lastWorldBookDiagnostics as u, loadModuleSpec as ut, applyCharacterToPreset as v, resolveModuleDir as vt, importCharacterCardFile as w, withPresetDoc as wt, declaredCharacterModules as x, saveModuleParams as xt, characterModuleStillNeeded as y, resolveModuleFacts as yt, deleteWorldBookEntry as z, canonicalPresetRoot as zt };