dsh-plugin-prompt-tool 1.0.0 → 2.0.0

package/lib/index.mjs

@@ -1,12 +1,13 @@
-import { $ as setModuleEnabled, $t as moduleParamFallbacks, A as requiredCharacterModules, At as createPromptConfigs, B as listWorldBookEntries, Bt as presetPathExists, C as importCharacterCard, Ct as userModulesDir, D as readCharacterMemory, Dt as configFileName, E as previewCharacterCard, Et as assertSafeConfigId, F as mergeStPresets, Ft as createWarnOnce, G as triggerPromptConfigOptions, Gt as ENGINE_RECIPES, Ht as readPersonaSpec, I as processStText, It as PresetLayerSettingsError, J as readConfigOrder, Jt as isEngineCapabilityPresent, K as ModuleConfigOrderError, Kt as engineCapability, L as stPresetId, Lt as assertModuleDirectory, M as decodeAssetFile, Mt as compareConfigSequence, N as prepareImport, Nt as createEpochPromotion, O as recordedCharacterModules, Ot as listPromptConfigSpecs, P as convertStToPreset, Pt as PROMOTE_EVENTS, Q as resolveEditDir, Qt as WRITER_PARAM_KEYS, R as buildWorldBookEntry, Rt as assertPresetId, S as deleteCharacterCard, St as savePresetPersona, T as listCharacterCards, Tt as atomicWriteTextFile, U as readModuleTriggers, Ut as ENGINE_CAPABILITIES, V as upsertWorldBookEntry, Vt as DEFAULT_MODULE_ID, W as saveModuleTriggers, Wt as ENGINE_EDITOR_GROUP_MAP, X as saveModuleConfigOrder, Xt as ENGINE_PARAM_DEFINITIONS, Y as readModuleConfigOrder, Yt as validateCustomToolIdentities, Z as enabledModuleIds, Zt as ENGINE_PARAM_KEYS, _ as appendMemoryFile, _t as renderComposition, a as materializeModule, an as MODULE_DEFINITION_FILE, at as duplicateUserModule, b as charactersDir, bt as resolvePresetParams, c as confirmDelivered, ct as listBuiltinTemplates, d as validateCustomTools, dt as moduleDirExists, en as validateEngineParamValues, et as appendPresetModules, f as safeAssetPath, ft as openModuleLocation, g as appendCharacterMemory, gt as removeUserPreset, h as CHARACTER_MODULES_KEY, ht as removePresetModule, i as presetImportPreview, in as MODULE_CONFIGS_DIR, it as createEngineCapabilityInPreset, j as syncImportedCharacterMemory, jt as loadPromptConfigFiles, k as removeCharacterFromPreset, kt as renderPromptConfigYaml, l as runPreStepBatch, lt as listModules, m as directoryVersionOf, mt as removeEngineCapabilityFromPreset, n as exportPresetPackage, nn as DSH_HOME, nt as buildModuleConfigsFromParams, o as writePreset, on as USER_SKILLS_DIR, ot as ensurePresetSeed, p as computePreviewRevision, pt as packageEngineDir, q as appendModuleConfigOrder, qt as engineRecipe, r as installPresetPackage, rn as MODULES_DIR, rt as cloneBuiltinPreset, s as applyPromptConfigSources, st as invalidateModuleSpec, t as expandPresetSource, tn as LEGACY_PROMPT_PARAM_KEYS, tt as applyModuleConfigs, u as lastWorldBookDiagnostics, ut as loadModuleSpec, v as applyCharacterToPreset, vt as resolveModuleDir, w as importCharacterCardFile, wt as withPresetDoc, x as declaredCharacterModules, xt as saveModuleParams, y as characterModuleStillNeeded, yt as resolveModuleFacts, z as deleteWorldBookEntry, zt as canonicalPresetRoot } from "./module-package-Cm3fHHlp.mjs";
+import { $ as wireTriggerObservers, A as packageEngineDir, At as INJECTION_POINT_ORDER, B as userModulesDir, Bt as validateEngineParamValues, C as ensureModuleSeed, Ct as assertModuleTree, D as loadModuleSpec, Dt as readPersonaSpec, E as listModules, F as resolveModuleDir, Ft as validateCustomToolIdentities, Gt as USER_SKILLS_DIR, H as editModuleRules, Ht as DSH_HOME, I as resolveModuleFacts, It as ENGINE_PARAM_DEFINITIONS, J as rulePromptConfigOptions, K as ensureModuleSlices, L as resolveModuleParams, Lt as ENGINE_PARAM_KEYS, M as removeModuleCapabilityDeclaration, Mt as engineRecipe, N as removeUserModule, Nt as isModuleCapabilityPresent, O as moduleDirExists, Ot as ENGINE_EDITOR_GROUP_MAP, P as renderComposition, Pt as moduleCapability, R as saveModuleParams, Rt as WRITER_PARAM_KEYS, S as duplicateUserModule, St as assertModuleId, T as listBuiltinTemplates, Tt as modulePathExists, U as readModuleRules, Ut as MODULES_DIR, V as withModuleDefinition, Vt as LEGACY_PROMPT_PARAM_KEYS, W as ModuleRulesError, Z as compileRules, _ as applyModuleConfigs, _t as RULE_OWNED_MODEL_PARAMS, at as runPreStepBatch, b as cloneBuiltinModule, bt as readModuleLayerSettings, c as readConfigOrder, ct as actionMatches, d as assertSafeConfigId, et as compileWhen, f as configFileName, g as appendModuleCapabilities, gt as atomicWriteTextFile, h as setModuleEnabled, ht as createWarnOnce, it as confirmDelivered, j as removeModuleCapability, jt as MODULE_CAPABILITIES, k as openModuleLocation, kt as ENGINE_RECIPES, l as readModuleConfigOrder, lt as ruleFrame, m as resolveEditDir, mt as PROMOTE_EVENTS, nt as prepareAction, o as ModuleConfigOrderError, ot as lastWorldBookDiagnostics, p as enabledModuleIds, pt as createEpochPromotion, q as loadModuleDefinition, rt as applyPromptConfigSources, s as appendModuleConfigOrder, st as wireLayers, tt as loadStandingMountFor, u as saveModuleConfigOrder, ut as compareConfigSequence, vt as ModuleLayerSettingsError, wt as canonicalModulesRoot, x as createModuleCapability, xt as assertModuleDirectory, y as buildModuleConfigsFromParams, z as saveModulePersona, zt as moduleParamFallbacks } from "./rules-migration-DJ6vASB5.mjs";
+import { C as mergeStModulesWithReport, D as deleteWorldBookEntry, E as buildWorldBookEntry, M as DEFAULT_MODULE_ID, O as listWorldBookEntries, S as mergeStModules, T as stModuleId, _ as readModuleMemory, a as installModulePackage, b as convertStToModule, c as writeModule, d as validateCustomTools, f as safeAssetPath, g as mergeModuleIntoModule, h as importCharacterCardFile, i as exportModulePackage, j as ruleInjections, k as upsertWorldBookEntry, l as writePreset, m as importCharacterCard, o as moduleImportPreview, p as appendModuleMemory, r as expandModuleSource, s as ensureModuleReady, u as compileCustomTool, v as removeMergedModule, w as processStText, x as convertStToModuleWithReport, y as prepareImport } from "./module-package-Cnd1_mwx.mjs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { accessSync, chmodSync, constants, createWriteStream, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, unwatchFile, watchFile, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Document, isMap, isScalar, parse, parseDocument, visit } from "yaml";
 import { homedir } from "node:os";
+import { isDeepStrictEqual } from "node:util";
 import { createHash, randomUUID } from "node:crypto";
 import { NamedEntries, ScopedLayers, scopeOf } from "@deepseek-ai/dsh-scope";
-import { isDeepStrictEqual } from "node:util";
 import z from "@deepseek-ai/schemastery";
 import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
@@ -327,107 +328,34 @@ const PARAM_KEYS = /* @__PURE__ */ new Set([
 	...EXTRA_PARAM_KEYS
 ]);
 //#endregion
+//#region src/shared/module-settings.ts
+/** 部署总闸的新旧字段只在读写边界归一。 */
+function readModulesEnabled(value) {
+	const { modulesEnabled, writePreset } = value;
+	if (modulesEnabled !== void 0 && typeof modulesEnabled !== "boolean") throw new TypeError("modulesEnabled 必须是布尔值");
+	if (writePreset !== void 0 && typeof writePreset !== "boolean") throw new TypeError("旧 writePreset 必须是布尔值");
+	if (modulesEnabled !== void 0 && writePreset !== void 0 && modulesEnabled !== writePreset) throw new Error("modulesEnabled 与旧 writePreset 冲突");
+	return modulesEnabled ?? writePreset ?? true;
+}
+/** 一次官方 settings 事务完成改值与旧键退役，不产生新旧冲突中间态。 */
+function modulesEnabledOps(enabled) {
+	return [{
+		op: "set",
+		path: ["modulesEnabled"],
+		value: enabled
+	}, {
+		op: "unset",
+		path: ["writePreset"]
+	}];
+}
+//#endregion
 //#region src/config.ts
 /** 插件配置、settings 数据模型与默认常量（settings 接口层）。 */
 const NS = "prompt-tool";
-const Config = z.object({ writePreset: z.boolean().default(true).volatile() });
-//#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;
-	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
-			}] : [];
-		})
-	};
-}
-/** 来源只用于读回；无论客户端传了什么来源，都不能写入模块定义。 */
-function stripConfigFieldSources(config) {
-	const { fieldSources: _fieldSources, sequence: _sequence, ...definition } = config;
-	return definition;
-}
+const Config = z.object({
+	modulesEnabled: z.boolean().volatile(),
+	writePreset: z.boolean().volatile()
+});
 //#endregion
 //#region src/shared/official-orders.ts
 /** section 侧 6 组，覆盖官方 32 个档位名（顺序即官方数值升序）。 */
@@ -538,89 +466,6 @@ function readOfficialOrderSegments(lookup) {
 	};
 }
 //#endregion
-//#region src/runtime/configs-validate.ts
-/** 数组整体不是数组时返回单条 -1 错误；元素问题逐条收集。 */
-function shapeErrors(value) {
-	if (!Array.isArray(value)) return [{
-		index: -1,
-		id: "",
-		message: "promptConfigs must be an array"
-	}];
-	const errors = [];
-	const seenIds = /* @__PURE__ */ new Set();
-	for (let index = 0; index < value.length; index += 1) {
-		const item = value[index];
-		const label = `configs[${index}]`;
-		if (item === null || typeof item !== "object" || Array.isArray(item)) {
-			errors.push({
-				index,
-				id: "",
-				message: `${label} must be an object`
-			});
-			continue;
-		}
-		const id = item.id;
-		if (typeof id !== "string" || id.length === 0) errors.push({
-			index,
-			id: typeof id === "string" ? id : "",
-			message: `${label}.id must be a non-empty string`
-		});
-		else if (seenIds.has(id)) errors.push({
-			index,
-			id,
-			message: `${label} duplicate id ${JSON.stringify(id)} (后者覆盖前者会静默丢卡)`
-		});
-		else seenIds.add(id);
-	}
-	return errors;
-}
-/**
-* 逐条调用引擎权威校验并渲染预览文件。
-* 逐条（而非整组一次）校验保证一条坏配置不吞掉其余错误，且 index 可直接映射。
-*/
-async function validatePromptConfigs(value, options = {}) {
-	const errors = shapeErrors(value);
-	if (errors.length > 0 || !Array.isArray(value)) return {
-		valid: false,
-		errors
-	};
-	const specs = value;
-	const { createPromptConfigs } = await import(pathToFileURL(join(packageEngineDir(), "prompt-config-engine.mjs")).href);
-	const engineOptions = {
-		...options.strategyDir ? { strategyDir: options.strategyDir } : {},
-		...options.moduleDir ? { templateBaseUrl: pathToFileURL(join(dirname(options.moduleDir), ".engine", "schema.mjs")).href } : {}
-	};
-	const files = [];
-	for (let index = 0; index < specs.length; index += 1) {
-		const spec = specs[index];
-		const id = spec !== null && typeof spec === "object" && typeof spec.id === "string" ? spec.id : "";
-		try {
-			createPromptConfigs([spec], engineOptions);
-			files.push({
-				file: configFileName(index * 10, spec.id),
-				content: renderPromptConfigYaml(spec)
-			});
-		} catch (error) {
-			const message = error instanceof Error ? error.message : String(error);
-			errors.push({
-				index,
-				id,
-				message
-			});
-		}
-	}
-	if (errors.length > 0) return {
-		valid: false,
-		errors
-	};
-	return {
-		valid: true,
-		errors: [],
-		configs: specs,
-		files
-	};
-}
-//#endregion
 //#region src/host/templates.ts
 /**
 * 默认提示词配置模板库：包内 templates/ 目录的只读扫描与解析。
@@ -637,6 +482,7 @@ function loadPromptTemplates() {
 		const content = readFileSync(join(TEMPLATES_DIR, entry.name), "utf8");
 		const parsed = parse(content, { logLevel: "silent" });
 		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed) || typeof parsed.id !== "string" || parsed.id.length === 0) throw new Error(`prompt config template ${entry.name} must contain a single config object with a non-empty string id`);
+		compileRules([parsed]);
 		return {
 			file: entry.name,
 			content,
@@ -1358,7 +1204,6 @@ const BRIDGE_ENDPOINTS = {
 	models: "/models",
 	modelReasoning: "/model-reasoning",
 	mutate: "/mutate",
-	configsValidate: "/configs-validate",
 	skillsList: "/skills-list",
 	skillPolicy: "/skill-policy",
 	skillRead: "/skill-read",
@@ -1372,17 +1217,18 @@ const BRIDGE_ENDPOINTS = {
 	promptConfigs: "/prompt-configs",
 	agentsFile: "/agents-file",
 	instructionsPolicy: "/instructions-policy",
-	presetContent: "/preset-content",
+	moduleContent: "/module-content",
 	importPreset: "/import-preset",
 	paramOverrides: "/param-overrides",
 	triggers: "/triggers",
+	rules: "/rules",
 	persona: "/persona",
-	presetVariables: "/preset-variables",
+	moduleVariables: "/module-variables",
 	customTools: "/custom-tools",
-	importPresetPackage: "/import-preset-package",
+	importModulePackage: "/import-module-package",
 	assetUpload: "/asset-upload",
 	assetRelease: "/asset-release",
-	exportPreset: "/export-preset",
+	exportModule: "/export-module",
 	moduleDelete: "/module-delete",
 	moduleClone: "/module-clone",
 	moduleDuplicate: "/module-duplicate",
@@ -1391,18 +1237,16 @@ const BRIDGE_ENDPOINTS = {
 	moduleConfigOrder: "/module-config-order",
 	charactersImport: "/characters-import",
 	charactersImportStream: "/characters-import-stream",
-	charactersList: "/characters-list",
-	charactersDelete: "/characters-delete",
-	charactersApply: "/characters-apply",
-	charactersRemove: "/characters-remove",
+	moduleMerge: "/module-merge",
+	moduleUnmerge: "/module-unmerge",
 	subagentToolPolicy: "/subagent-tool-policy",
 	subagentToolPolicyPreview: "/subagent-tool-policy-preview",
 	toolSurface: "/tool-surface",
-	engineCapability: "/engine-capability",
+	moduleCapability: "/module-capability",
 	worldBookDiagnostics: "/world-book-diagnostics"
 };
 /** 文件已保存，但宿主未采用新定义；调用方保留草稿并显示失败，不宣称已生效。 */
-const PRESET_ACTIVATION_FAILED = "preset-activation-failed";
+const MODULE_ACTIVATION_FAILED = "module-activation-failed";
 const MODULE_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
 /** 读编辑目标：形状不合法（空、超长、含非法字符）一律当「未声明」，由 host 回退启用表首项。 */
 function readEditTarget(value) {
@@ -2600,17 +2444,20 @@ function installPreStepCoordinator(ctx, options = {}) {
 			const scope = isRecord$1(agent) && agent.ctx !== void 0 ? scopeOf(agent.ctx) : void 0;
 			const sources = [...layers.merge(scope, (layer) => layer.entries).values()];
 			const configs = sources.flatMap((source) => source.configs).filter((config) => !config.id.startsWith("agents-file-") && config.sourceKind !== "instruction-file").sort(compareConfigSequence);
+			const ruleActions = sources.flatMap((source) => source.ruleActions ?? []);
 			const sessionId = isRecord$1(session) && typeof session.id === "string" ? session.id : void 0;
 			if (sessionId !== void 0) {
 				if (officialOwner.size >= MAX_TRACKED_OWNER_SESSIONS) officialOwner.clear();
 				if (sources.length > 0) officialOwner.set(sessionId, sources.some((source) => source.officialInstructions === true));
 				else officialOwner.delete(sessionId);
 			}
-			return configs.length === 0 ? decision : await runPreStepBatch({
+			return configs.length === 0 && ruleActions.length === 0 ? decision : await runPreStepBatch({
 				ctx,
 				agent,
+				payload,
 				decision,
 				configs,
+				ruleActions,
 				promotion,
 				memo,
 				warnOnce
@@ -2707,7 +2554,15 @@ function writeBridgeJson(res, status, body) {
 const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 /** 当前层参数格式错误统一反馈，不能在读回时伪装成空配置。 */
 function writeLayerSettingsError(res, error) {
-	if (!(error instanceof PresetLayerSettingsError)) return false;
+	if (error instanceof ModuleRulesError) {
+		writeBridgeJson(res, error.status, {
+			ok: false,
+			code: error.code,
+			message: error.message
+		});
+		return true;
+	}
+	if (!(error instanceof ModuleLayerSettingsError)) return false;
 	writeBridgeJson(res, 400, {
 		ok: false,
 		code: error.code,
@@ -2900,10 +2755,10 @@ function withSnapshot(card, file) {
 * 生成目录里属于其他工作区的文件卡不再展示（写盘白名单也不含它们）；
 * 当前工作区里没有对应生成卡的文件按默认文件卡补齐。
 */
-function mergeInstructionCards(presetCards, files) {
+function mergeInstructionCards(moduleCards, files) {
 	const byId = new Map(files.map((file) => [file.fileId, file]));
 	const kept = [];
-	for (const card of presetCards) {
+	for (const card of moduleCards) {
 		if (!isFileCardSpec(card)) {
 			kept.push(card);
 			continue;
@@ -2956,16 +2811,16 @@ function projectToolSchemas(schemas) {
 	}
 	return [...unique.values()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
 }
-function isEditablePresetDir(dir, moduleRoot = userModulesDir()) {
+function isEditableModuleDir(dir, moduleRoot = userModulesDir()) {
 	const root = resolve(moduleRoot);
 	const target = resolve(dir);
 	return target !== root && target.startsWith(root + sep);
 }
-function guardEditablePresetDir(dir, res) {
-	if (isEditablePresetDir(dir)) return true;
+function guardEditableModuleDir(dir, res) {
+	if (isEditableModuleDir(dir)) return true;
 	writeBridgeJson(res, 403, {
 		ok: false,
-		code: "preset-readonly",
+		code: "module-readonly",
 		message: "system preset 只读，请先复制为用户模块"
 	});
 	return false;
@@ -3079,31 +2934,31 @@ function customToolModules(tools) {
 	return [...modules];
 }
 /** 自建 loopback settings bridge：替代 registerConfigurableProviders，避免模型设置区出现插件条目。 */
-function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngineStrategyDir, afterSkillsChange, getPresetConfigsDir, afterPresetImport, afterOverridesChange, afterPresetPackageImport, afterCapabilityChange, afterPresetListChange) {
+function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, _getEngineStrategyDir, afterSkillsChange, getModuleDirectory, afterModuleContentImport, afterOverridesChange, afterModulePackageImport, afterCapabilityChange, afterModuleListChange) {
 	let invalidateCachedDescriptor = () => {};
 	let capabilityQueue = Promise.resolve();
 	let moduleOrderQueue = Promise.resolve();
 	/** 写盘已完成：等待重建，失败立即返回统一错误，不覆盖持久化结果。 */
-	const finishPresetChange = async (res, activate) => {
+	const finishModuleChange = async (res, activate) => {
 		try {
 			await activate();
 			return true;
 		} catch (error) {
 			writeBridgeJson(res, 500, {
 				ok: false,
-				code: PRESET_ACTIVATION_FAILED,
+				code: MODULE_ACTIVATION_FAILED,
 				message: `更改已保存，但模块未生效；请重试：${String(error)}`
 			});
 			return false;
 		}
 	};
-	const runOverridesChange = (res, moduleId) => finishPresetChange(res, () => afterOverridesChange?.(moduleId));
+	const runOverridesChange = (res, moduleId) => finishModuleChange(res, () => afterOverridesChange?.(moduleId));
 	/**
 	* 本次请求的编辑目标目录：读 `x-module-id` 头（形状不合法当未声明），交给注入的实现定位。
 	* 所有「读/写哪个模块的配置」都走这里，端点不再各自记一个全局目标。
 	*/
-	const editDir = (req) => getPresetConfigsDir?.(readEditTarget(req.headers["x-module-id"])) ?? "";
-	const refreshPresetList = (res, id) => finishPresetChange(res, () => afterPresetListChange?.(id));
+	const editDir = (req) => getModuleDirectory?.(readEditTarget(req.headers["x-module-id"])) ?? "";
+	const refreshModuleList = (res, id) => finishModuleChange(res, () => afterModuleListChange?.(id));
 	ctx.inject(["settings", "webServer"], (sctx) => {
 		sctx.effect(() => {
 			const assetSources = createAssetSources(join(DSH_HOME, ".prompt-tool-uploads"));
@@ -3118,12 +2973,16 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				return cachedDescriptor;
 			};
 			/** 已解析的编辑目标只投影到本次响应，不改宿主设置或缓存描述符。 */
-			const descriptorForTarget = (descriptor, dir) => dir.length === 0 ? descriptor : {
-				...descriptor,
-				value: {
-					...asRecord(descriptor.value),
-					presetTemplate: basename(dir)
-				}
+			const descriptorForTarget = (descriptor, dir) => {
+				const value = { ...asRecord(descriptor.value) };
+				value.modulesEnabled = readModulesEnabled(value);
+				delete value.writePreset;
+				delete value.presetTemplate;
+				if (dir.length > 0) value.moduleId = basename(dir);
+				return {
+					...descriptor,
+					value
+				};
 			};
 			/** mutate 成功后强制失效，下次 findDescriptor 重查宿主（响应必须带新 view）。 */
 			const invalidateDescriptor = () => {
@@ -3149,16 +3008,16 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}
 				return true;
 			};
-			const guardPresetFormat = (dir, res) => {
+			const guardModuleFormat = (dir, res) => {
 				if (dir.length === 0) return true;
 				try {
-					loadModuleSpec(dir);
+					readModuleLayerSettings(loadModuleDefinition(dir).source);
 				} catch (error) {
 					if (writeLayerSettingsError(res, error)) return false;
 				}
 				return true;
 			};
-			const guardPresetWrite = (dir, res) => guardEditablePresetDir(dir, res) && guardPresetFormat(dir, res);
+			const guardModuleWrite = (dir, res) => guardEditableModuleDir(dir, res) && guardModuleFormat(dir, res);
 			const writeModuleOrderError = (res, error) => {
 				writeBridgeJson(res, error instanceof ModuleConfigOrderError ? error.status : 500, {
 					ok: false,
@@ -3167,25 +3026,33 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				});
 			};
 			/** 模块身份只作一致性检查，绝不用客户端 ID 构造写入路径。 */
-			const guardPresetIdentity = (req, record, dir, res) => {
-				const expected = record.expectedPresetId;
+			const guardModuleIdentity = (req, record, dir, res) => {
+				if (record.expectedModuleId !== void 0 && record.expectedPresetId !== void 0 && record.expectedModuleId !== record.expectedPresetId) {
+					writeBridgeJson(res, 400, {
+						ok: false,
+						code: "module-identity-invalid",
+						message: "新旧模块身份字段冲突"
+					});
+					return false;
+				}
+				const expected = record.expectedModuleId ?? record.expectedPresetId;
 				if (expected !== void 0 && (typeof expected !== "string" || expected.length === 0 || expected.length > 256)) {
 					writeBridgeJson(res, 400, {
 						ok: false,
-						code: "preset-identity-invalid",
-						message: "expectedPresetId 必须是非空模块 ID"
+						code: "module-identity-invalid",
+						message: "expectedModuleId 必须是非空模块 ID"
 					});
 					return false;
 				}
 				if (editDir(req) !== dir || expected !== void 0 && expected !== basename(dir)) {
 					writeBridgeJson(res, 409, {
 						ok: false,
-						code: "preset-changed",
+						code: "module-changed",
 						message: "当前模块已切换；旧草稿未写入，请重新读取后保存"
 					});
 					return false;
 				}
-				return guardPresetFormat(dir, res);
+				return guardModuleFormat(dir, res);
 			};
 			/** 官方刻度取值失败只告警一次：本函数被 /meta 与 /bootstrap 共用，不能每次调用都刷屏。 */
 			let warnedOfficialOrders = false;
@@ -3193,16 +3060,13 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			const loadEngineMeta = async () => {
 				const { getEngineMeta } = await import(pathToFileURL(join(packageEngineDir(), "schema.mjs")).href);
 				const meta = getEngineMeta();
-				const registry = sctx.get?.("agentPresets");
-				const roster = registry === void 0 ? [] : await registry.list();
-				const diagnostics = new Map(roster.map(({ id, broken }) => [id, broken]));
 				const enabledSet = new Set(enabledModuleIds(userModulesDir()));
-				meta.presets = listModules().map((preset) => ({
+				meta.modules = listModules().map((preset) => ({
 					...preset,
-					enabled: enabledSet.has(preset.id),
-					...diagnostics.get(preset.id) === void 0 ? {} : { broken: diagnostics.get(preset.id) }
+					enabled: enabledSet.has(preset.id)
 				}));
 				meta.builtinTemplates = listBuiltinTemplates();
+				if (modulePathExists(join(dirname(userModulesDir()), ".characters"))) meta.moduleWarnings = ["检测到旧 .characters 角色库；其内容尚未作为模块导入。请通过模块导入入口显式导入，旧目录不会自动迁移或删除。"];
 				meta.editorGroups = ENGINE_EDITOR_GROUP_MAP.map(({ id, displayLayer, relatedLayers, hook }) => ({
 					id,
 					displayLayer,
@@ -3272,15 +3136,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					}
 				} catch {}
 				const modelCatalog = peekModelCatalog(sctx);
-				let presetParams = {};
+				let moduleParams = {};
 				let moduleFacts;
 				let templatePreStepCount = 0;
 				try {
 					const templateName = activeDir.length > 0 ? basename(activeDir) : DEFAULT_MODULE_ID;
 					const spec = loadModuleSpec(activeDir.length > 0 ? activeDir : resolveModuleDir(templateName));
-					presetParams = resolvePresetParams(spec, {});
-					const resolvedFacts = resolveModuleFacts(spec, activeDir.length > 0 ? activeDir : void 0, isEditablePresetDir(activeDir.length > 0 ? activeDir : resolveModuleDir(templateName)));
-					mergeModuleConfigFallbacks(presetParams, resolvedFacts);
+					moduleParams = resolveModuleParams(spec, {});
+					const resolvedFacts = resolveModuleFacts(spec, activeDir.length > 0 ? activeDir : void 0, isEditableModuleDir(activeDir.length > 0 ? activeDir : resolveModuleDir(templateName)));
+					mergeModuleConfigFallbacks(moduleParams, resolvedFacts);
 					moduleFacts = {
 						declaredModules: resolvedFacts.declaredModules,
 						effectiveModules: resolvedFacts.effectiveModules,
@@ -3289,17 +3153,13 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						editable: resolvedFacts.editable,
 						subagentToolPolicyEnabled: resolvedFacts.subagentToolPolicyEnabled === true
 					};
-					if (Array.isArray(spec.promptConfigs)) presetParams.promptConfigs = spec.promptConfigs;
-					templatePreStepCount = (spec.promptConfigs ?? []).filter((config) => {
-						const layer = config.layer;
-						return layer === void 0 || layer === "pre-step";
-					}).length;
+					templatePreStepCount = (spec.rules ?? []).filter((rule) => rule.layer === "pre-step").length;
 				} catch (error) {
-					if (error instanceof PresetLayerSettingsError) throw error;
+					if (error instanceof ModuleLayerSettingsError || error instanceof ModuleRulesError) throw error;
 					templatePreStepCount = 0;
 				}
 				return {
-					presetParams,
+					moduleParams,
 					moduleFacts,
 					hostDefaultModel,
 					templatePreStepCount,
@@ -3313,7 +3173,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					skillFolders: skillsState.folders
 				};
 			};
-			/** 激活模块的引擎参数子集（/param-overrides 读取；preset.yml 按 mtime 缓存）。 */
+			/** 激活模块的引擎参数子集（/param-overrides 读取；module.yml 按 mtime 缓存）。 */
 			const readParamOverrides = (dir) => {
 				try {
 					const spec = loadModuleSpec(dir);
@@ -3324,45 +3184,18 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					}
 					return params;
 				} catch (error) {
-					if (error instanceof PresetLayerSettingsError) throw error;
+					if (error instanceof ModuleLayerSettingsError || error instanceof ModuleRulesError) throw error;
 					return {};
 				}
 			};
-			/** 模块级模板变量（/preset-variables 读取）。 */
-			const readPresetVariables = (dir) => {
-				try {
-					const spec = loadModuleSpec(dir);
-					const variables = {};
-					for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string") variables[key] = value;
-					return {
-						variables,
-						enabled: spec.variablesEnabled !== false
-					};
-				} catch (error) {
-					if (error instanceof PresetLayerSettingsError) throw error;
-					return {
-						variables: {},
-						enabled: true
-					};
-				}
-			};
-			/** 生成目录实际生效配置（/prompt-configs 读取）。 */
-			const readPromptConfigs = (dir) => {
-				try {
-					const order = loadModuleSpec(dir).configOrder ?? {};
-					return dir.length > 0 ? listPromptConfigSpecs(join(dir, MODULE_CONFIGS_DIR)).map((config) => {
-						const raw = config;
-						const definition = stripConfigFieldSources(raw);
-						const fieldSources = readConfigFieldSources(config.id, raw.fieldSources);
-						return {
-							...definition,
-							...fieldSources === void 0 ? {} : { fieldSources },
-							...Object.hasOwn(order, config.id) ? { sequence: order[config.id] } : {}
-						};
-					}) : [];
-				} catch {
-					return [];
-				}
+			/** 完整已提交定义的只读变量快照，不因发布失败而再次触发切片恢复。 */
+			const readModuleVariables = (dir) => {
+				const snapshot = loadModuleDefinition(dir);
+				return {
+					variables: snapshot.variables,
+					enabled: snapshot.variablesEnabled,
+					revisions: snapshot.revisions
+				};
 			};
 			const disposers = [
 				assetSources.dispose,
@@ -3396,16 +3229,18 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							const meta = await loadEngineMeta();
 							const extras = await collectDescribeExtras(dir, session.sessionId);
 							const scope = resolveInstructionScope(sctx, session.sessionId);
+							const variables = dir.length > 0 ? readModuleVariables(dir) : {
+								variables: {},
+								enabled: true
+							};
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: descriptorForTarget(descriptor, dir),
 								meta: { meta },
 								overrides: { overrides: dir.length > 0 ? readParamOverrides(dir) : {} },
-								variables: dir.length > 0 ? readPresetVariables(dir) : {
-									variables: {},
-									enabled: true
-								},
-								promptConfigs: { promptConfigs: mergeInstructionCards(readPromptConfigs(dir), scope.files) },
+								variables,
+								..."revisions" in variables ? { variablesRevisions: variables.revisions } : {},
+								promptConfigs: { promptConfigs: mergeInstructionCards([], scope.files) },
 								instructions: {
 									context: scope.context,
 									files: scope.files,
@@ -3554,7 +3389,21 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						const expectedRevision = typeof record.expectedRevision === "number" ? record.expectedRevision : void 0;
 						try {
-							await sctx.settings.mutate(ns, record.ops, expectedRevision);
+							const ops = record.ops;
+							const toggles = ops.filter((op) => op.path.length === 1 && ["modulesEnabled", "writePreset"].includes(String(op.path[0])));
+							const values = Object.fromEntries(toggles.filter((op) => op.op === "set").map((op) => [op.path[0], op.value]));
+							if (toggles.length > 0) {
+								readModulesEnabled(values);
+								const normalized = ops.map((op) => op.path.length === 1 && op.path[0] === "writePreset" ? {
+									...op,
+									path: ["modulesEnabled"]
+								} : op);
+								normalized.push({
+									op: "unset",
+									path: ["writePreset"]
+								});
+								await sctx.settings.mutate(ns, normalized, expectedRevision);
+							} else await sctx.settings.mutate(ns, ops, expectedRevision);
 						} catch (error) {
 							writeBridgeJson(res, 409, {
 								ok: false,
@@ -3575,41 +3424,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						writeBridgeJson(res, 200, {
 							ok: true,
-							value: descriptor
-						});
-					}
-				}),
-				sctx.webServer.register({
-					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.configsValidate,
-					handler: async (req, res) => {
-						if (!guard(req, res)) return;
-						const parsedBody = await readBridgeBodyForHandler(req, res);
-						if (parsedBody === void 0) return;
-						const { body } = parsedBody;
-						if (body === null || body === void 0 || typeof body !== "object") {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "settings-rejected",
-								message: "unreadable JSON body"
-							});
-							return;
-						}
-						const record = body;
-						if (!Array.isArray(record.promptConfigs)) {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "prompt-configs-invalid",
-								message: "promptConfigs must be an array"
-							});
-							return;
-						}
-						writeBridgeJson(res, 200, {
-							ok: true,
-							value: await validatePromptConfigs(record.promptConfigs, {
-								strategyDir: getEngineStrategyDir(),
-								moduleDir: editDir(req)
-							})
+							value: descriptorForTarget(descriptor, editDir(req))
 						});
 					}
 				}),
@@ -3971,12 +3786,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							return;
 						}
 						const dir = editDir(req) ?? "";
-						if (!guardPresetFormat(dir, res)) return;
+						if (!guardModuleFormat(dir, res)) return;
 						const scope = resolveInstructionScope(sctx, session.sessionId);
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: {
-								promptConfigs: mergeInstructionCards(readPromptConfigs(dir), scope.files),
+								promptConfigs: mergeInstructionCards([], scope.files),
 								instructions: {
 									context: scope.context,
 									files: scope.files,
@@ -4129,7 +3944,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetContent,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleContent,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -4203,17 +4018,17 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!guardModuleWrite(dir, res)) return;
 						try {
-							if (!guardPresetIdentity(req, record, dir, res)) return;
+							if (!guardModuleIdentity(req, record, dir, res)) return;
 							mkdirSync(dir, { recursive: true });
 							for (const entry of contents) writeFileSync(join(dir, entry.scope === "preset" ? "preset.md" : "agents.md"), entry.content, "utf8");
-							if (!await finishPresetChange(res, () => afterPresetImport?.(contents.map((entry) => entry.scope), basename(dir)))) return;
+							if (!await finishModuleChange(res, () => afterModuleContentImport?.(contents.map((entry) => entry.scope), basename(dir)))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { scopes: contents.map((entry) => entry.scope) }
@@ -4221,7 +4036,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						} catch (error) {
 							writeBridgeJson(res, 500, {
 								ok: false,
-								code: "preset-import-failed",
+								code: "module-import-failed",
 								message: error instanceof Error ? error.message : String(error)
 							});
 						}
@@ -4230,13 +4045,25 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				sctx.webServer.register({
 					kind: "exact",
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.triggers,
+					handler: async (req, res) => {
+						if (!guard(req, res)) return;
+						writeBridgeJson(res, 410, {
+							ok: false,
+							code: "rules-route-retired",
+							message: "声明规则已统一为 rules；请离线迁移旧模块并刷新客户端，使用 /rules 编辑。"
+						});
+					}
+				}),
+				sctx.webServer.register({
+					kind: "exact",
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.rules,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "当前模块目录不可用"
 							});
 							return;
@@ -4244,95 +4071,139 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const parsed = await readBridgeBodyForHandler(req, res);
 						if (parsed === void 0) return;
 						const record = parsed.body ?? {};
-						if (typeof record.expectedPresetId !== "string" || record.expectedPresetId.length === 0 || Object.keys(record).some((key) => ![
+						if (!isRecord(record) || Object.keys(record).some((key) => ![
+							"expectedModuleId",
 							"expectedPresetId",
-							"triggers",
 							"expectedRevision",
-							"validateOnly"
-						].includes(key)) || record.validateOnly !== void 0 && typeof record.validateOnly !== "boolean" || record.triggers !== void 0 && !Array.isArray(record.triggers) || record.expectedRevision !== void 0 && (typeof record.expectedRevision !== "string" || !SHA256_HEX_RE.test(record.expectedRevision))) {
+							"expectedRevisions",
+							"edits",
+							"activateRuleId",
+							"validateOnly",
+							"refreshOnly"
+						].includes(key)) || typeof (record.expectedModuleId ?? record.expectedPresetId) !== "string" || (record.expectedModuleId ?? record.expectedPresetId) === "" || record.expectedRevision !== void 0 && (typeof record.expectedRevision !== "string" || !SHA256_HEX_RE.test(record.expectedRevision)) || record.edits !== void 0 && !Array.isArray(record.edits) || record.activateRuleId !== void 0 && (typeof record.activateRuleId !== "string" || record.activateRuleId.length === 0) || record.validateOnly !== void 0 && typeof record.validateOnly !== "boolean" || record.refreshOnly !== void 0 && typeof record.refreshOnly !== "boolean" || record.refreshOnly === true && (record.edits !== void 0 || record.activateRuleId !== void 0 || record.validateOnly !== void 0)) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "triggers-invalid",
-								message: "声明请求字段、模块身份或版本格式不合法"
+								code: "rules-invalid",
+								message: "规则请求字段、模块身份或版本格式不合法"
+							});
+							return;
+						}
+						if (!guardModuleIdentity(req, record, dir, res)) return;
+						if (record.refreshOnly === true) {
+							if (!guardModuleWrite(dir, res)) return;
+							const { getRuleEditorMeta } = await import(pathToFileURL(join(packageEngineDir(), "rule-spec.mjs")).href);
+							try {
+								await afterOverridesChange?.(basename(dir));
+							} catch (error) {
+								const committed = loadModuleDefinition(dir);
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: {
+										rules: committed.rules,
+										revisions: committed.revisions,
+										meta: getRuleEditorMeta(),
+										persisted: true,
+										publicationPending: true,
+										publicationError: `运行刷新失败：${String(error)}`
+									}
+								});
+								return;
+							}
+							const committed = loadModuleDefinition(dir);
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: {
+									rules: committed.rules,
+									revisions: committed.revisions,
+									meta: getRuleEditorMeta(),
+									publicationPending: false
+								}
 							});
 							return;
 						}
-						if (!guardPresetIdentity(req, record, dir, res)) return;
-						const writing = record.triggers !== void 0 && record.validateOnly !== true;
-						if (writing && typeof record.expectedRevision !== "string") {
+						const editing = record.edits !== void 0 || record.activateRuleId !== void 0;
+						const writing = editing && record.validateOnly !== true;
+						if (editing && record.expectedRevisions === void 0 && typeof record.expectedRevision !== "string") {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "triggers-invalid",
-								message: "保存声明必须提供读取时的 expectedRevision"
+								code: "rules-invalid",
+								message: "修改规则必须提供读取时的 expectedRevisions"
 							});
 							return;
 						}
-						if (writing && !guardPresetWrite(dir, res)) return;
+						if (writing && !guardModuleWrite(dir, res)) return;
 						try {
-							const { compileDeclarations } = await import(pathToFileURL(join(packageEngineDir(), "trigger-spec.mjs")).href);
-							const { getTriggerEditorMeta } = await import(pathToFileURL(join(packageEngineDir(), "trigger-editor-meta.mjs")).href);
-							if (!guardPresetIdentity(req, record, dir, res)) return;
-							const snapshot = readModuleTriggers(dir);
-							if (record.triggers !== void 0) try {
-								const strategy = loadModuleSpec(dir).moduleConfigs?.["declared-triggers"]?.strategyDir;
-								compileDeclarations(record.triggers, { promptConfigOptions: triggerPromptConfigOptions(dir, strategy) });
+							const { getRuleEditorMeta } = await import(pathToFileURL(join(packageEngineDir(), "rule-spec.mjs")).href);
+							if (!guardModuleIdentity(req, record, dir, res)) return;
+							const candidate = editing ? editModuleRules(dir, {
+								...record.expectedRevision === void 0 ? {} : { expectedRevision: record.expectedRevision },
+								...record.expectedRevisions === void 0 ? {} : { expectedRevisions: record.expectedRevisions },
+								...record.edits === void 0 ? {} : { edits: record.edits },
+								...record.activateRuleId === void 0 ? {} : { activateRuleId: record.activateRuleId },
+								...record.validateOnly === void 0 ? {} : { validateOnly: record.validateOnly }
+							}) : isEditableModuleDir(dir) ? readModuleRules(dir) : ensureModuleSlices(dir, { writable: false });
+							if (writing) try {
+								await afterOverridesChange?.(basename(dir));
 							} catch (error) {
-								writeBridgeJson(res, 400, {
-									ok: false,
-									code: "triggers-invalid",
-									message: String(error.message ?? error)
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: {
+										rules: candidate.rules,
+										revisions: candidate.revisions,
+										meta: getRuleEditorMeta(),
+										persisted: true,
+										publicationPending: true,
+										publicationError: `规则已保存，但运行刷新失败：${String(error)}`
+									}
 								});
 								return;
 							}
-							if (writing) {
-								if (!Array.isArray(loadModuleSpec(dir).modules)) {
-									writeBridgeJson(res, 400, {
-										ok: false,
-										code: "triggers-composition-readonly",
-										message: "当前组合没有可编辑的 modules 清单，无法自动装配声明引擎"
-									});
-									return;
-								}
-								if (!saveModuleTriggers(dir, record.triggers, record.expectedRevision)) {
-									writeBridgeJson(res, 409, {
-										ok: false,
-										code: "triggers-conflict",
-										message: "模块文件已变化；草稿未写入，请重新读取后保存"
-									});
-									return;
-								}
-								try {
-									await afterOverridesChange?.(basename(dir));
-								} catch (error) {
-									writeBridgeJson(res, 500, {
-										ok: false,
-										code: "triggers-rebuild-failed",
-										message: `声明已保存，但模块重建失败；请重新读取后重试：${String(error)}`
-									});
-									return;
-								}
-							}
-							const result = writing ? readModuleTriggers(dir) : snapshot;
-							if (writing && !isDeepStrictEqual(result.triggers, record.triggers)) {
+							const result = writing ? readModuleRules(dir) : candidate;
+							if (writing && !isDeepStrictEqual(result.rules, candidate.rules)) {
 								writeBridgeJson(res, 409, {
 									ok: false,
-									code: "triggers-conflict",
-									message: "重建期间规则已再次变化；请重新读取，当前草稿仍保留"
+									code: "rules-conflict",
+									message: "重建期间规则再次变化；请重新读取，当前草稿仍保留"
 								});
 								return;
 							}
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
-									...result,
-									meta: getTriggerEditorMeta()
+									rules: result.rules,
+									revisions: result.revisions,
+									meta: getRuleEditorMeta()
 								}
 							});
 						} catch (error) {
+							if (error instanceof ModuleRulesError) {
+								if (error.persisted) {
+									const committed = loadModuleDefinition(dir);
+									const { getRuleEditorMeta } = await import(pathToFileURL(join(packageEngineDir(), "rule-spec.mjs")).href);
+									writeBridgeJson(res, 200, {
+										ok: true,
+										value: {
+											rules: committed.rules,
+											revisions: committed.revisions,
+											meta: getRuleEditorMeta(),
+											persisted: true,
+											publicationPending: true,
+											publicationError: error.message
+										}
+									});
+									return;
+								}
+								writeBridgeJson(res, error.status, {
+									ok: false,
+									code: error.code,
+									message: error.message
+								});
+								return;
+							}
 							if (writeLayerSettingsError(res, error)) return;
 							writeBridgeJson(res, 500, {
 								ok: false,
-								code: "triggers-failed",
+								code: "rules-failed",
 								message: String(error.message ?? error)
 							});
 						}
@@ -4347,7 +4218,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -4358,7 +4229,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(req, record, dir, res)) return;
+						if (!guardModuleIdentity(req, record, dir, res)) return;
 						if (record.rebuild !== void 0 && typeof record.rebuild !== "boolean") {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -4367,7 +4238,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (record.overrides === void 0 && record.promptConfigs === void 0) {
+						if (record.promptConfigs !== void 0) {
+							writeBridgeJson(res, 410, {
+								ok: false,
+								code: "rules-route-retired",
+								message: "提示词配置已统一为 rules，请使用带版本的 /rules 事务编辑。"
+							});
+							return;
+						}
+						if (record.overrides === void 0) {
 							if (record.rebuild !== void 0) {
 								writeBridgeJson(res, 400, {
 									ok: false,
@@ -4390,17 +4269,16 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (record.promptConfigs !== void 0 && !Array.isArray(record.promptConfigs)) {
-							writeBridgeJson(res, 400, {
+						if (!guardModuleWrite(dir, res)) return;
+						const rawOverrides = record.overrides;
+						if (rawOverrides !== void 0 && RULE_OWNED_MODEL_PARAMS.some((key) => Object.hasOwn(rawOverrides, key))) {
+							writeBridgeJson(res, 410, {
 								ok: false,
-								code: "prompt-configs-invalid",
-								message: "promptConfigs must be an array"
+								code: "rules-route-retired",
+								message: "模型路由和采样参数已归入 request-params 规则动作，请通过 /rules 编辑。"
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
-						if (Array.isArray(record.promptConfigs)) record.promptConfigs = record.promptConfigs.map((config) => isRecord(config) ? stripConfigFieldSources(config) : config);
-						const rawOverrides = record.overrides;
 						if (rawOverrides !== void 0) {
 							const unknownKeys = Object.keys(rawOverrides).filter((key) => key === "promptConfigs" || !PARAM_KEYS.has(key));
 							if (unknownKeys.length > 0) {
@@ -4422,43 +4300,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							return;
 						}
 						try {
-							if (Array.isArray(record.promptConfigs)) {
-								const validation = await validatePromptConfigs(record.promptConfigs, {
-									strategyDir: getEngineStrategyDir(),
-									moduleDir: dir
-								});
-								if (!validation.valid) {
-									writeBridgeJson(res, 400, {
-										ok: false,
-										code: "prompt-configs-invalid",
-										message: validation.errors.map(({ index, id, message }) => `[${index}] ${id}: ${message}`).join("; ")
-									});
-									return;
-								}
-								const spec = loadModuleSpec(dir);
-								const conflicting = record.promptConfigs.some((config) => {
-									if (config === null || typeof config !== "object" || Array.isArray(config)) return false;
-									const entry = config;
-									return entry.enabled !== false && entry.params?.complete === true;
-								});
-								if (spec.persona?.complete === true && conflicting) {
-									writeBridgeJson(res, 400, {
-										ok: false,
-										code: "overrides-invalid-value",
-										message: "顶层人设已开启「独占」；提示词配置的「独占」与之互斥，请先关闭其一"
-									});
-									return;
-								}
-							}
-							if (!guardPresetIdentity(req, record, dir, res)) return;
-							saveModuleParams(moduleRoot, templateName, rawOverrides, record.promptConfigs);
+							if (!guardModuleIdentity(req, record, dir, res)) return;
+							saveModuleParams(moduleRoot, templateName, rawOverrides, void 0);
 							if (record.rebuild !== false && !await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: {
-									...record.overrides !== void 0 ? { overrides: record.overrides } : {},
-									...record.promptConfigs !== void 0 ? { promptConfigs: record.promptConfigs } : {}
-								}
+								value: { overrides: record.overrides }
 							});
 						} catch (error) {
 							if (writeLayerSettingsError(res, error)) return;
@@ -4472,14 +4319,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetVariables,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleVariables,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -4490,18 +4337,51 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(req, record, dir, res)) return;
+						if (!guardModuleIdentity(req, record, dir, res)) return;
+						if (record.refreshOnly !== void 0 && (typeof record.refreshOnly !== "boolean" || record.refreshOnly === true && (record.variables !== void 0 || record.enabled !== void 0))) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "module-variables-invalid",
+								message: "refreshOnly 不能与变量写入混用"
+							});
+							return;
+						}
+						if (record.refreshOnly === true) {
+							if (!guardModuleWrite(dir, res)) return;
+							try {
+								await afterOverridesChange?.(basename(dir));
+							} catch (error) {
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: {
+										...readModuleVariables(dir),
+										persisted: true,
+										publicationPending: true,
+										publicationError: `运行刷新失败：${String(error)}`
+									}
+								});
+								return;
+							}
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: {
+									...readModuleVariables(dir),
+									publicationPending: false
+								}
+							});
+							return;
+						}
 						if (record.variables === void 0 && record.enabled === void 0) {
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: readPresetVariables(dir)
+								value: readModuleVariables(dir)
 							});
 							return;
 						}
 						if (record.variables !== void 0 && (!isRecord(record.variables) || Object.values(record.variables).some((value) => typeof value !== "string"))) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-variables-invalid",
+								code: "module-variables-invalid",
 								message: "variables must be an object with string values"
 							});
 							return;
@@ -4509,25 +4389,64 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (record.enabled !== void 0 && typeof record.enabled !== "boolean") {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-variables-invalid",
+								code: "module-variables-invalid",
 								message: "enabled must be a boolean"
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!isRecord(record.expectedRevisions) || Object.keys(record.expectedRevisions).some((key) => ![
+							"rules",
+							"settings",
+							"variables"
+						].includes(key)) || record.variables !== void 0 && (typeof record.expectedRevisions.variables !== "string" || !SHA256_HEX_RE.test(record.expectedRevisions.variables)) || record.enabled !== void 0 && (typeof record.expectedRevisions.settings !== "string" || !SHA256_HEX_RE.test(record.expectedRevisions.settings))) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "module-variables-invalid",
+								message: "保存变量或开关必须提供对应 expectedRevisions"
+							});
+							return;
+						}
+						if (!guardModuleWrite(dir, res)) return;
 						try {
-							if (!guardPresetIdentity(req, record, dir, res)) return;
-							saveModuleParams(moduleRoot, templateName, void 0, void 0, record.variables, record.enabled);
-							if (!await runOverridesChange(res, basename(dir))) return;
+							if (!guardModuleIdentity(req, record, dir, res)) return;
+							saveModuleParams(moduleRoot, templateName, void 0, void 0, record.variables, record.enabled, record.expectedRevisions);
+							const committed = readModuleVariables(dir);
+							try {
+								await afterOverridesChange?.(basename(dir));
+							} catch (error) {
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: {
+										...committed,
+										persisted: true,
+										publicationPending: true,
+										publicationError: `变量已保存，但运行刷新失败：${String(error)}`
+									}
+								});
+								return;
+							}
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: { variables: record.variables }
+								value: committed
 							});
 						} catch (error) {
-							writeBridgeJson(res, 409, {
+							if (error instanceof ModuleRulesError && error.persisted) {
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: {
+										...readModuleVariables(dir),
+										persisted: true,
+										publicationPending: true,
+										publicationError: error.message
+									}
+								});
+								return;
+							}
+							const message = error instanceof Error ? error.message : String(error);
+							writeBridgeJson(res, error instanceof ModuleRulesError ? error.status : 409, {
 								ok: false,
-								code: "preset-variables-rejected",
-								message: `模板变量保存失败：${error instanceof Error ? error.message : String(error)}`
+								code: error instanceof ModuleRulesError ? error.code : "module-variables-rejected",
+								message: `模板变量保存失败：${message}`
 							});
 						}
 					}
@@ -4541,7 +4460,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -4550,7 +4469,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(req, record, dir, res)) return;
+						if (!guardModuleIdentity(req, record, dir, res)) return;
 						if (record.customTools === void 0) {
 							try {
 								const spec = loadModuleSpec(dir);
@@ -4587,13 +4506,13 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							if (!guardPresetWrite(dir, res)) return;
-							if (!guardPresetIdentity(req, record, dir, res)) return;
-							withPresetDoc(dir, (doc) => {
+							if (!guardModuleWrite(dir, res)) return;
+							if (!guardModuleIdentity(req, record, dir, res)) return;
+							withModuleDefinition(dir, (doc) => {
 								if (customTools.length === 0) doc.deleteIn(["customTools"]);
 								else {
 									doc.setIn(["customTools"], customTools);
-									appendPresetModules(doc, customToolModules(customTools));
+									appendModuleCapabilities(doc, customToolModules(customTools));
 								}
 							});
 							if (!await runOverridesChange(res, basename(dir))) return;
@@ -4619,7 +4538,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -4627,7 +4546,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const record = parsedBody.body ?? {};
-						if (!guardPresetIdentity(req, record, dir, res)) return;
+						if (!guardModuleIdentity(req, record, dir, res)) return;
 						if (record.persona === void 0) {
 							try {
 								writeBridgeJson(res, 200, {
@@ -4643,33 +4562,29 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							}
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!guardModuleWrite(dir, res)) return;
 						try {
 							const raw = record.persona;
 							const persona = raw === null ? null : readPersonaSpec(raw);
 							if (persona === void 0) {
 								writeBridgeJson(res, 400, {
 									ok: false,
-									code: "preset-persona-invalid",
+									code: "module-persona-invalid",
 									message: "persona 必须包含字符串 prefix（可选 suffix / complete / includeRuntimeContext）"
 								});
 								return;
 							}
 							if (persona?.complete === true) {
-								if ((loadModuleSpec(dir).promptConfigs ?? []).some((config) => {
-									if (config === null || typeof config !== "object" || Array.isArray(config)) return false;
-									const entry = config;
-									return entry.enabled !== false && entry.params?.complete === true;
-								})) {
+								if (ruleInjections(loadModuleSpec(dir).rules).some(({ rule, config }) => rule.enabled !== false && config.enabled !== false && config.params?.complete === true)) {
 									writeBridgeJson(res, 400, {
 										ok: false,
-										code: "preset-persona-complete-conflict",
+										code: "module-persona-complete-conflict",
 										message: "提示词配置已有「独占」段；顶层人设的「独占」与之互斥，请先关闭其一"
 									});
 									return;
 								}
 							}
-							savePresetPersona(dirname(dir), basename(dir), persona);
+							saveModulePersona(dirname(dir), basename(dir), persona);
 							if (!await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
@@ -4678,7 +4593,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						} catch (error) {
 							writeBridgeJson(res, 409, {
 								ok: false,
-								code: "preset-persona-rejected",
+								code: "module-persona-rejected",
 								message: `人设保存失败：${error instanceof Error ? error.message : String(error)}`
 							});
 						}
@@ -4736,7 +4651,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.importPresetPackage,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.importModulePackage,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -4755,14 +4670,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (!request.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-package-invalid",
+								code: "module-package-invalid",
 								message: request.message
 							});
 							return;
 						}
 						try {
-							const files = await expandPresetSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
-							const preview = presetImportPreview(userModulesDir(), files, request.params);
+							const files = await expandModuleSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
+							const preview = moduleImportPreview(userModulesDir(), files, request.params);
 							if (!("prepared" in preview)) {
 								if (!request.params.preview) throw new Error("请先选择内容类型或提示顺序组并重新预览");
 								writeBridgeJson(res, 200, {
@@ -4789,9 +4704,9 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							const installed = await installPresetPackage(userModulesDir(), files, request.params);
+							const installed = await installModulePackage(userModulesDir(), files, request.params);
 							invalidateDescriptor();
-							if (!await finishPresetChange(res, () => afterPresetPackageImport?.(installed.id))) return;
+							if (!await finishModuleChange(res, () => afterModulePackageImport?.(installed.id))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
@@ -4801,8 +4716,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								}
 							});
 						} catch (error) {
-							const code = typeof error.code === "string" ? String(error.code) : "preset-package-invalid";
-							writeBridgeJson(res, code === "preset-preview-stale" ? 409 : 400, {
+							const code = typeof error.code === "string" ? String(error.code) : "module-package-invalid";
+							writeBridgeJson(res, code === "module-preview-stale" ? 409 : 400, {
 								ok: false,
 								code,
 								message: error instanceof Error ? error.message : String(error)
@@ -4812,7 +4727,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.exportPreset,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.exportModule,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -4828,7 +4743,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								"memoryChoices"
 							]);
 							if (Object.keys(record).some((key) => !allowed.has(key))) throw new Error("导出请求包含未知字段");
-							assertPresetId(record.id);
+							assertModuleId(record.id);
 							if (record.id.length > 128) throw new Error("模块 ID 过长");
 							if (record.mode !== void 0 && record.mode !== "definition" && record.mode !== "zip") throw new Error("mode 必须是 definition 或 zip");
 							if (record.preview !== void 0 && typeof record.preview !== "boolean") throw new Error("preview 必须是布尔值");
@@ -4836,11 +4751,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							if (record.memoryChoices !== void 0 && (!isRecord(record.memoryChoices) || Object.keys(record.memoryChoices).length > 2048 || Object.entries(record.memoryChoices).some(([key, value]) => key.length === 0 || key.length > 256 || value !== "include" && value !== "exclude"))) throw new Error("memoryChoices 必须包含合法条目 ID 和 include/exclude 选择");
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: await exportPresetPackage(userModulesDir(), record)
+								value: await exportModulePackage(userModulesDir(), record)
 							});
 						} catch (error) {
 							const message = error instanceof Error ? error.message : String(error);
-							const code = typeof error.code === "string" ? String(error.code) : "preset-export-failed";
+							const code = typeof error.code === "string" ? String(error.code) : "module-export-failed";
 							writeBridgeJson(res, code.includes("stale") ? 409 : 400, {
 								ok: false,
 								code,
@@ -4862,7 +4777,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (id.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-delete-rejected",
+								code: "module-delete-rejected",
 								message: "缺少模块 id"
 							});
 							return;
@@ -4871,21 +4786,21 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (activeDir.length > 0 && basename(activeDir) === id) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-in-use",
+								code: "module-in-use",
 								message: `模块「${id}」正在使用中，请先切换其他模块再删除`
 							});
 							return;
 						}
-						const result = removeUserPreset(id);
+						const result = removeUserModule(id);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-delete-rejected",
+								code: "module-delete-rejected",
 								message: result.message
 							});
 							return;
 						}
-						if (!await refreshPresetList(res, id)) return;
+						if (!await refreshModuleList(res, id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id }
@@ -4905,21 +4820,21 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (id.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-clone-rejected",
+								code: "module-clone-rejected",
 								message: "缺少模块 id"
 							});
 							return;
 						}
-						const result = cloneBuiltinPreset(id, record.autoSuffix === true);
+						const result = cloneBuiltinModule(id, record.autoSuffix === true);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-clone-rejected",
+								code: "module-clone-rejected",
 								message: result.message
 							});
 							return;
 						}
-						if (!await refreshPresetList(res, result.id)) return;
+						if (!await refreshModuleList(res, result.id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id: result.id }
@@ -4939,7 +4854,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (id.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-duplicate-rejected",
+								code: "module-duplicate-rejected",
 								message: "缺少模块 id"
 							});
 							return;
@@ -4948,12 +4863,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-duplicate-rejected",
+								code: "module-duplicate-rejected",
 								message: result.message
 							});
 							return;
 						}
-						if (!await refreshPresetList(res, result.id)) return;
+						if (!await refreshModuleList(res, result.id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id: result.id }
@@ -4973,7 +4888,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (id.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-open-rejected",
+								code: "module-open-rejected",
 								message: "缺少模块 id"
 							});
 							return;
@@ -4982,7 +4897,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-open-rejected",
+								code: "module-open-rejected",
 								message: `${result.message}（${result.path}）`
 							});
 							return;
@@ -5006,7 +4921,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (id.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-enable-rejected",
+								code: "module-enable-rejected",
 								message: "缺少模块 id"
 							});
 							return;
@@ -5014,7 +4929,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (typeof record.enabled !== "boolean") {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-enable-rejected",
+								code: "module-enable-rejected",
 								message: "enabled 必须是布尔值"
 							});
 							return;
@@ -5022,7 +4937,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (record.enabled && !moduleDirExists(userModulesDir(), id)) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-enable-rejected",
+								code: "module-enable-rejected",
 								message: `模块 ${id} 不存在`
 							});
 							return;
@@ -5094,7 +5009,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5120,9 +5035,9 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!guardModuleWrite(dir, res)) return;
 						try {
-							const files = await expandPresetSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
+							const files = await expandModuleSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
 							if (editDir(req) !== dir) {
 								writeBridgeJson(res, 409, {
 									ok: false,
@@ -5143,98 +5058,40 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							const root = canonicalPresetRoot(userModulesDir());
-							if (assertModuleDirectory(root, basename(dir)) !== realpathSync(dir)) throw new Error("当前模块不属于可写的官方模块根");
-							const cards = canonicalPresetRoot(charactersDir(root), true);
-							let targetId = request.params.targetId ?? prepared.spec.id;
-							if (request.params.targetId === void 0 && request.params.overwrite !== true) {
-								const wanted = targetId;
-								for (let n = 1; presetPathExists(join(cards, targetId)); n++) targetId = `${wanted}-copy${n === 1 ? "" : "-" + n}`;
-							}
-							assertPresetId(targetId);
-							const options = {
-								...request.params,
-								targetId
-							};
-							const converted = previewCharacterCard(files, options);
-							if (!converted.ok) throw new Error(converted.message);
-							const version = directoryVersionOf(join(cards, targetId));
-							const previewRevision = computePreviewRevision({
-								files: [{
-									path: "source",
-									content: converted.sourceDigest
-								}, {
-									path: "choices",
-									content: JSON.stringify([
-										targetId,
-										request.params.targetName ?? "",
-										request.params.overwrite === true,
-										request.params.sourceKind ?? null
-									])
-								}],
-								...request.params.promptOrderCharacterId === void 0 ? {} : { orderCharacterId: request.params.promptOrderCharacterId },
-								converter: "asset-character/1",
-								target: {
-									kind: "character-card",
-									targetId,
-									targetVersion: version,
-									ownerPreset: JSON.stringify([
-										root,
-										basename(dir),
-										directoryVersionOf(dir)
-									])
-								}
-							});
+							const root = userModulesDir();
+							const preview = moduleImportPreview(root, files, request.params);
+							if (!("prepared" in preview)) throw new Error("角色来源未形成有效模块候选");
+							const { summary, sourceDigest, previewRevision } = preview;
 							if (request.params.preview) {
-								const summary = {
-									sourceName: converted.sourceName,
-									kind: converted.kind,
-									targetId,
-									targetName: converted.name,
-									exists: version !== null,
-									files: files.map((file) => ({
-										path: file.path,
-										bytes: decodeAssetFile(file).length
-									})),
-									configCount: prepared.spec.promptConfigs?.length ?? 0,
-									warnings: []
-								};
 								writeBridgeJson(res, 200, {
 									ok: true,
 									value: {
 										preview: true,
 										state: "ready",
-										name: converted.name,
+										name: summary.targetName,
 										summary,
-										sourceDigest: converted.sourceDigest,
+										sourceDigest,
 										previewRevision,
-										...converted.report === void 0 ? {} : { report: converted.report }
+										...prepared.report === void 0 ? {} : { report: prepared.report }
 									}
 								});
 								return;
 							}
-							if (request.params.expectedPreviewRevision !== previewRevision || request.params.expectedSourceDigest !== converted.sourceDigest) {
-								writeBridgeJson(res, 409, {
-									ok: false,
-									code: "characters-preview-stale",
-									message: "预览已过期：来源、选择或目标版本已变化，请重新预览"
-								});
-								return;
-							}
-							if (version !== null && request.params.overwrite !== true) throw new Error("角色已存在，请明确选择更新或另存");
-							const result = importCharacterCard(root, files, options);
-							if (!result.ok) throw new Error(result.message);
+							const result = await installModulePackage(root, files, request.params, { preserveAssets: true });
+							invalidateDescriptor();
+							if (!await finishModuleChange(res, () => afterModulePackageImport?.(result.id))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
 									id: result.id,
-									name: result.name
+									name: summary.targetName
 								}
 							});
 						} catch (error) {
-							writeBridgeJson(res, 400, {
+							const code = typeof error.code === "string" ? String(error.code) : "characters-rejected";
+							writeBridgeJson(res, code.includes("stale") ? 409 : 400, {
 								ok: false,
-								code: "characters-rejected",
+								code,
 								message: error instanceof Error ? error.message : String(error)
 							});
 						}
@@ -5254,34 +5111,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersList,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleMerge,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
-								message: "模块目录未配置"
-							});
-							return;
-						}
-						writeBridgeJson(res, 200, {
-							ok: true,
-							value: { characters: listCharacterCards(dirname(dir), basename(dir)) }
-						});
-					}
-				}),
-				sctx.webServer.register({
-					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersDelete,
-					handler: async (req, res) => {
-						if (!guard(req, res)) return;
-						const dir = editDir(req) ?? "";
-						if (dir.length === 0) {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5299,51 +5136,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
-						const result = deleteCharacterCard(dirname(dir), id);
-						if (!result.ok) {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "characters-rejected",
-								message: result.message
-							});
-							return;
-						}
-						writeBridgeJson(res, 200, {
-							ok: true,
-							value: { id }
-						});
-					}
-				}),
-				sctx.webServer.register({
-					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersApply,
-					handler: async (req, res) => {
-						if (!guard(req, res)) return;
-						const dir = editDir(req) ?? "";
-						if (dir.length === 0) {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "preset-dir-unavailable",
-								message: "模块目录未配置"
-							});
-							return;
-						}
-						const parsedBody = await readBridgeBodyForHandler(req, res);
-						if (parsedBody === void 0) return;
-						const { body } = parsedBody;
-						const record = body ?? {};
-						const id = typeof record.id === "string" ? record.id.trim() : "";
-						if (id.length === 0) {
-							writeBridgeJson(res, 400, {
-								ok: false,
-								code: "characters-rejected",
-								message: "缺少角色卡 id"
-							});
-							return;
-						}
-						if (!guardPresetWrite(dir, res)) return;
-						const result = applyCharacterToPreset(dirname(dir), basename(dir), id);
+						if (!guardModuleWrite(dir, res)) return;
+						const result = mergeModuleIntoModule(dirname(dir), basename(dir), id);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -5364,14 +5158,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersRemove,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleUnmerge,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5389,8 +5183,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
-						const result = removeCharacterFromPreset(dirname(dir), basename(dir), id);
+						if (!guardModuleWrite(dir, res)) return;
+						const result = removeMergedModule(dirname(dir), basename(dir), id);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -5418,7 +5212,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5427,7 +5221,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(req, record, dir, res)) return;
+						if (!guardModuleIdentity(req, record, dir, res)) return;
 						if (record.policy === void 0) {
 							try {
 								writeBridgeJson(res, 200, {
@@ -5443,7 +5237,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							}
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!guardModuleWrite(dir, res)) return;
 						try {
 							const policy = record.policy;
 							const core = await import(pathToFileURL(join(packageEngineDir(), "subagent-tool-policy-core.mjs")).href);
@@ -5458,12 +5252,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							if (!guardPresetIdentity(req, record, dir, res)) return;
-							withPresetDoc(dir, (doc) => {
+							if (!guardModuleIdentity(req, record, dir, res)) return;
+							withModuleDefinition(dir, (doc) => {
 								if (isEmpty) doc.deleteIn(["subagentToolPolicy"]);
 								else {
 									doc.setIn(["subagentToolPolicy"], policy);
-									appendPresetModules(doc, ["subagent-tool-policy"]);
+									appendModuleCapabilities(doc, ["subagent-tool-policy"]);
 								}
 							});
 							if (!await runOverridesChange(res, basename(dir))) return;
@@ -5492,7 +5286,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5538,14 +5332,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.engineCapability,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleCapability,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
-								code: "preset-dir-unavailable",
+								code: "module-dir-unavailable",
 								message: "模块目录未配置"
 							});
 							return;
@@ -5553,7 +5347,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const body = asRecord(parsedBody.body);
-						if (!guardPresetIdentity(req, body, dir, res)) return;
+						if (!guardModuleIdentity(req, body, dir, res)) return;
 						const action = body.action;
 						const id = action === "create" || action === "remove" ? body.capabilityId : action === "create-recipe" ? body.recipeId : void 0;
 						if (action !== "create" && action !== "remove" && action !== "create-recipe" || typeof id !== "string" || id.trim().length === 0 || id.length > 128) {
@@ -5564,30 +5358,31 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						if (!guardPresetWrite(dir, res)) return;
+						if (!guardModuleWrite(dir, res)) return;
 						const run = capabilityQueue.then(async () => {
-							if (!guardPresetIdentity(req, body, dir, res)) return;
-							const file = join(dir, MODULE_DEFINITION_FILE);
-							let original;
+							if (!guardModuleIdentity(req, body, dir, res)) return;
 							try {
-								original = readFileSync(file, "utf8");
-								const result = action === "remove" ? removeEngineCapabilityFromPreset(dir, id.trim()) : createEngineCapabilityInPreset(dir, action === "create" ? {
+								const result = action === "remove" ? removeModuleCapability(dir, id.trim()) : createModuleCapability(dir, action === "create" ? {
 									action: "create",
 									capabilityId: id.trim()
 								} : {
 									action: "create-recipe",
 									recipeId: id.trim()
 								});
-								if (result.changed && !await finishPresetChange(res, () => afterCapabilityChange?.(basename(dir)))) return;
+								if (result.changed && !await finishModuleChange(res, () => afterCapabilityChange?.(basename(dir)))) return;
 								writeBridgeJson(res, 200, {
 									ok: true,
 									value: result
 								});
 							} catch (error) {
-								if (original !== void 0) try {
-									atomicWriteTextFile(file, original);
-									invalidateModuleSpec(dir);
-								} catch {}
+								if (error instanceof ModuleRulesError && error.persisted) {
+									writeBridgeJson(res, 500, {
+										ok: false,
+										code: MODULE_ACTIVATION_FAILED,
+										message: `能力变更已保存，但切片未发布；请重试刷新：${error.message}`
+									});
+									return;
+								}
 								writeBridgeJson(res, 409, {
 									ok: false,
 									code: "engine-capability-rejected",
@@ -5802,6 +5597,61 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 	return { invalidateDescriptor: () => invalidateCachedDescriptor() };
 }
 //#endregion
+//#region src/runtime/character-tools.ts
+function registerCharacterTools(ctx, host) {
+	const fiber = ctx.inject(["tools"], (toolsCtx) => toolsCtx.tools.register(defineTool({
+		name: "character_import",
+		description: "把一张 SillyTavern 角色卡或自包含原生角色片段直接导入为普通模块，接收 JSON / YAML 文本。PNG 从模块页导入。默认同名另存，不自动启用；导入后通过模块管理选择启用，不再使用角色卡库或应用步骤。",
+		parameters: {
+			name: {
+				type: "string",
+				required: true,
+				description: "来源文件名（不含扩展名），作为普通模块 id 的基础。"
+			},
+			content: {
+				type: "string",
+				required: true,
+				description: "角色卡 JSON / YAML 文本；原生片段含 id/name/rules，规则注入动作使用内嵌 text/texts，不支持外部文件。"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					id: {
+						type: "string",
+						required: true
+					},
+					name: {
+						type: "string",
+						required: true
+					}
+				}
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: `已导入普通模块：${value.name}（id=${value.id}）。在模块管理中启用后参与装配。`
+			}]
+		},
+		execute: async (args, exec) => {
+			const target = host.target(exec);
+			const result = await importCharacterCard(target.root, [{
+				path: `${args.name}.json`,
+				content: args.content
+			}]);
+			if (!result.ok) throw new Error(result.message);
+			return {
+				id: result.id,
+				name: result.name
+			};
+		}
+	})));
+	return () => {
+		fiber.dispose();
+	};
+}
+//#endregion
 //#region src/host/module-tool-target.ts
 /**
 * 工具目标来自执行 Agent 的**运行时配装记录**：这个 Agent 实际装上了哪几层提示词。
@@ -5824,7 +5674,7 @@ function resolveModuleToolTarget(exec, root, moduleIdsOf) {
 	};
 }
 /** 定义已经保存时，不把重建失败伪装成整个写入未发生。 */
-async function rebuildSavedPreset(host, id) {
+async function refreshModuleAfterSave(host, id) {
 	try {
 		await host.rebuild(id);
 	} catch (error) {
@@ -5832,243 +5682,35 @@ async function rebuildSavedPreset(host, id) {
 	}
 }
 //#endregion
-//#region src/runtime/character-tools.ts
-const text$2 = (text) => [{
+//#region src/runtime/world-book-tools.ts
+const text$1 = (text) => [{
 	type: "text",
 	text
 }];
-/** 注册角色卡库模型工具；返回 disposer，随 character-tools 模块生命周期清理。 */
-function registerCharacterTools(ctx, host) {
+/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 模块生命周期清理。 */
+function registerWorldBookTools(ctx, host) {
 	const fiber = ctx.inject(["tools"], (toolsCtx) => {
 		const disposers = [];
+		const writeNote = (target, note) => {
+			appendModuleMemory(target.dir, note);
+		};
 		disposers.push(toolsCtx.tools.register(defineTool({
-			name: "character_list",
-			description: "列出角色卡库：每张卡（id / 名称 / 描述 / 是否已导入当前模块）。导入角色卡、应用到当前模块或移除前先调用本工具获取 id。",
+			name: "world_book_read_memory",
+			description: "读取当前模块的持久记忆 memory.md。每次调用读取最新文件；没有记忆时返回空文本。记忆不会自动注入，读取失败会报错。",
 			parameters: {},
 			output: {
 				schema: {
 					type: "object",
 					additionalProperties: false,
-					properties: { characters: {
-						type: "array",
-						required: true,
-						items: {
-							type: "object",
-							additionalProperties: false,
-							properties: {
-								id: {
-									type: "string",
-									required: true
-								},
-								name: {
-									type: "string",
-									required: true
-								},
-								description: { type: "string" },
-								hasAvatar: {
-									type: "boolean",
-									required: true
-								},
-								imported: {
-									type: "boolean",
-									required: true
-								}
-							}
-						}
-					} }
-				},
-				render: (_args, value) => text$2(JSON.stringify(value.characters))
-			},
-			execute: async (_args, exec) => {
-				const target = host.target(exec);
-				return { characters: listCharacterCards(target.root, target.id) };
-			}
-		})));
-		disposers.push(toolsCtx.tools.register(defineTool({
-			name: "character_import",
-			description: "导入一张 SillyTavern 角色卡或自包含原生角色片段到角色卡库：接收 JSON / YAML 文本内容（可先读取文件）。PNG 角色卡请让用户从 UI 角色管理页导入。导入后需调用 character_apply 应用到当前模块。",
-			parameters: {
-				name: {
-					type: "string",
-					required: true,
-					description: "角色卡文件名（不含 .json 扩展名），将作为模块/角色卡 id 基础。"
-				},
-				content: {
-					type: "string",
-					required: true,
-					description: "角色卡 JSON / YAML 文本：SillyTavern chara_card_v2/v3，或含 id/name/promptConfigs 的原生片段。原生片段只支持内嵌 text/texts 和控制配置，不支持外部文件。"
-				}
-			},
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: {
-						id: {
-							type: "string",
-							required: true
-						},
-						name: {
-							type: "string",
-							required: true
-						}
-					}
-				},
-				render: (_args, value) => text$2(`角色卡已入库：${value.name}（id=${value.id}）。调用 character_apply 可应用到当前模块。`)
-			},
-			execute: async (args, exec) => {
-				const target = host.target(exec);
-				const result = importCharacterCard(target.root, [{
-					path: `${args.name}.json`,
-					content: args.content
-				}]);
-				if (!result.ok) throw new Error(result.message);
-				return {
-					id: result.id,
-					name: result.name
-				};
-			}
-		})));
-		disposers.push(toolsCtx.tools.register(defineTool({
-			name: "character_apply",
-			description: "把角色卡库中一张角色卡的参数（角色设定 / 系统提示 / 开场白 / 世界书 / 提示词配置）合并进当前会话绑定的模块（promptConfigs 带 chara-<id>- 前缀防冲突，params 合并，meta.importedCharacters 记录），并立即重建生成目录。重复应用幂等。",
-			parameters: { id: {
-				type: "string",
-				required: true,
-				description: "角色卡 id（character_list 返回）。"
-			} },
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: {
-						id: {
-							type: "string",
-							required: true
-						},
-						count: {
-							type: "integer",
-							required: true
-						}
-					}
-				},
-				render: (_args, value) => text$2(`已导入到当前模块（${value.count} 条配置），生成目录已重建。`)
-			},
-			execute: async (args, exec) => {
-				const target = host.target(exec);
-				const result = applyCharacterToPreset(target.root, target.id, args.id);
-				if (!result.ok) throw new Error(result.message);
-				await rebuildSavedPreset(host, target.id);
-				return {
-					id: args.id,
-					count: result.count
-				};
-			}
-		})));
-		disposers.push(toolsCtx.tools.register(defineTool({
-			name: "character_remove",
-			description: "从当前会话绑定的模块移除一张已导入角色卡的参数（删 chara-<id>- 前缀配置、该卡声明的 params 键、meta.importedCharacters 除名），并立即重建生成目录。角色卡库条目不受影响。",
-			parameters: { id: {
-				type: "string",
-				required: true,
-				description: "角色卡 id（character_list 返回，imported=true 的卡）。"
-			} },
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: {
-						id: {
-							type: "string",
-							required: true
-						},
-						count: {
-							type: "integer",
-							required: true
-						}
-					}
-				},
-				render: (_args, value) => text$2(`已从当前模块移除（${value.count} 条配置），生成目录已重建。`)
-			},
-			execute: async (args, exec) => {
-				const target = host.target(exec);
-				const result = removeCharacterFromPreset(target.root, target.id, args.id);
-				if (!result.ok) throw new Error(result.message);
-				await rebuildSavedPreset(host, target.id);
-				return {
-					id: args.id,
-					count: result.count
-				};
-			}
-		})));
-		disposers.push(toolsCtx.tools.register(defineTool({
-			name: "character_delete",
-			description: "从角色卡库删除一张角色卡（含其转换参数与头像）。已导入当前模块的参数不受影响（如需清理请先调用 character_remove）。",
-			parameters: { id: {
-				type: "string",
-				required: true,
-				description: "角色卡 id（character_list 返回）。"
-			} },
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: { id: {
+					properties: { memory: {
 						type: "string",
 						required: true
 					} }
 				},
-				render: (_args, value) => text$2(`角色卡 ${value.id} 已从库中删除。`)
+				render: (_args, value) => text$1(value.memory)
 			},
-			execute: async (args, exec) => {
-				const result = deleteCharacterCard(host.target(exec).root, args.id);
-				if (!result.ok) throw new Error(result.message);
-				return { id: args.id };
-			}
+			execute: async (_args, exec) => ({ memory: readModuleMemory(host.target(exec).dir) })
 		})));
-		return () => {
-			for (const dispose of disposers) dispose();
-		};
-	});
-	return () => {
-		fiber.dispose();
-	};
-}
-//#endregion
-//#region src/runtime/world-book-tools.ts
-const text$1 = (text) => [{
-	type: "text",
-	text
-}];
-/** 从条目 id 解析来源角色卡（并入前缀 + cardId，cardId 可含连字符：遍历库目录取最长匹配）。
-*  前缀**两种都认**：新写入是 `module-<id>-`，用户既有的老条目仍是 `chara-<id>-`。 */
-function sourceCardId(moduleRoot, entryId) {
-	const root = charactersDir(moduleRoot);
-	if (!entryId.startsWith("module-") && !entryId.startsWith("chara-")) return void 0;
-	let best;
-	try {
-		for (const dir of readdirSync(root, { withFileTypes: true })) {
-			if (!dir.isDirectory() || dir.name.startsWith(".")) continue;
-			if ((entryId.startsWith(`module-${dir.name}-`) || entryId.startsWith(`chara-${dir.name}-`)) && (best === void 0 || dir.name.length > best.length)) best = dir.name;
-		}
-	} catch {}
-	return best;
-}
-/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 模块生命周期清理。 */
-function registerWorldBookTools(ctx, host) {
-	const fiber = ctx.inject(["tools"], (toolsCtx) => {
-		const disposers = [];
-		/** note 归属写入：角色卡条目 → 卡记忆；其他 → 模块记忆。 */
-		const writeNote = (target, entryId, note) => {
-			if (note === void 0 || note.trim().length === 0) return;
-			const cardId = entryId !== void 0 ? sourceCardId(target.root, entryId) : void 0;
-			if (cardId !== void 0) {
-				appendMemoryFile(join(target.root, ".characters", cardId, "memory.md"), note, "# 角色记忆");
-				try {
-					syncImportedCharacterMemory(target.root, target.id, cardId);
-				} catch {}
-			} else appendMemoryFile(join(target.dir, "memory.md"), note, "# 本地记忆");
-		};
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_list",
 			description: "列出当前模块的世界书条目（world-book 策略配置：id / 名称 / 关键字 / 常驻 / 启用）。世界书 = 上下文条目：无 keys 的全局条目每次注入，有 keys 条目命中聊天内容才注入。增删改前先调用本工具获取 id。",
@@ -6120,7 +5762,7 @@ function registerWorldBookTools(ctx, host) {
 		})));
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_upsert",
-			description: "新增或更新当前模块的一条世界书条目（world-book 策略配置）：按 id 更新（不存在则新增，id 自动生成 lore-<n>）。constant=true 常驻注入；否则命中 keys（或 secondaryKeys）任一关键字注入；无 keys 条目按全局每次注入。note 可选：写入来源角色卡的持久记忆（memory.md，条目 id 带 chara-<卡>- 前缀时）或模块记忆——持久记忆跨会话跟随角色卡（与 session_var 会话变量的临时状态不同，适合长期关系记录）。写盘后立即重建生成目录。",
+			description: "新增或更新当前模块的一条世界书条目（world-book 策略配置）：按 id 更新（不存在则新增，id 自动生成 lore-<n>）。constant=true 常驻注入；否则命中 keys（或 secondaryKeys）任一关键字注入；无 keys 条目按全局每次注入。note 可选：写入当前模块的持久记忆 memory.md，使用 world_book_read_memory 按需读取。写盘后立即重新装配。",
 			parameters: {
 				id: {
 					type: "string",
@@ -6160,7 +5802,7 @@ function registerWorldBookTools(ctx, host) {
 				},
 				note: {
 					type: "string",
-					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md，跨会话跟随角色卡）或模块记忆。"
+					description: "可选：操作笔记，写入当前模块的 memory.md，不自动注入。"
 				}
 			},
 			output: {
@@ -6197,8 +5839,8 @@ function registerWorldBookTools(ctx, host) {
 					...entry,
 					id: targetId
 				});
-				writeNote(target, targetId, typeof args.note === "string" ? args.note : "");
-				await rebuildSavedPreset(host, target.id);
+				writeNote(target, typeof args.note === "string" ? args.note : "");
+				await refreshModuleAfterSave(host, target.id);
 				return {
 					id: targetId,
 					count
@@ -6207,7 +5849,7 @@ function registerWorldBookTools(ctx, host) {
 		})));
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "world_book_delete",
-			description: "删除当前模块的一条世界书条目（world_book_list 获取 id）。note 可选：写入来源角色卡持久记忆（memory.md，跨会话跟随角色卡）或模块记忆。删除后立即重建生成目录。",
+			description: "删除当前模块的一条世界书条目（world_book_list 获取 id）。note 可选：写入当前模块的 memory.md，使用 world_book_read_memory 按需读取。删除后立即重新装配。",
 			parameters: {
 				id: {
 					type: "string",
@@ -6216,7 +5858,7 @@ function registerWorldBookTools(ctx, host) {
 				},
 				note: {
 					type: "string",
-					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md）或模块记忆。"
+					description: "可选：操作笔记，写入当前模块的 memory.md，不自动注入。"
 				}
 			},
 			output: {
@@ -6239,8 +5881,8 @@ function registerWorldBookTools(ctx, host) {
 			execute: async (args, exec) => {
 				const target = host.target(exec);
 				const keptCount = deleteWorldBookEntry(target.dir, args.id);
-				writeNote(target, args.id, typeof args.note === "string" ? args.note : "");
-				await rebuildSavedPreset(host, target.id);
+				writeNote(target, typeof args.note === "string" ? args.note : "");
+				await refreshModuleAfterSave(host, target.id);
 				return {
 					id: args.id,
 					count: keptCount
@@ -6372,92 +6014,22 @@ function registerSessionVarTools(ctx) {
 //#endregion
 //#region src/runtime/tui.ts
 /** dsh-tui 全局开关：键名与 settings 路径一致（settings mutate）。 */
-const TUI_GLOBAL_SWITCHES = [["writePreset", "模块运行总开关"]];
-/** dsh-tui 参数开关：写激活模块 preset.yml（settings 不再承载引擎参数）。 */
+const TUI_GLOBAL_SWITCHES = [["modulesEnabled", "模块运行总开关"]];
+/** dsh-tui 参数开关：写激活模块 module.yml（settings 不再承载引擎参数）。 */
 const TUI_PARAM_SWITCHES = Object.entries(ENGINE_PARAM_DEFINITIONS).filter(([, definition]) => definition.kind === "boolean").map(([key]) => [key, key]);
-/** 参数显示行（从激活模块 preset.yml params 读）。 */
-const TUI_PARAM_TEXT_LINES = [
-	[
-		"modelProvider",
-		"modelProvider",
-		"（空 = 不设置）"
-	],
-	[
-		"modelName",
-		"modelName",
-		"（空 = 不设置）"
-	],
-	[
-		"subagentModelProvider",
-		"subagentModelProvider",
-		"（空 = 不设置）"
-	],
-	[
-		"subagentModelName",
-		"subagentModelName",
-		"（空 = 不设置）"
-	],
-	[
-		"modelReasoningEffort",
-		"modelReasoningEffort",
-		"（空 = 不设置）"
-	],
-	[
-		"modelTemperature",
-		"modelTemperature",
-		"（空 = 不设置）"
-	],
-	[
-		"modelMaxTokens",
-		"modelMaxTokens",
-		"（空 = 不设置）"
-	],
-	[
-		"subagentReasoningEffort",
-		"subagentReasoningEffort",
-		"（空 = 不设置）"
-	],
-	[
-		"subagentTemperature",
-		"subagentTemperature",
-		"（空 = 不设置）"
-	],
-	[
-		"subagentMaxTokens",
-		"subagentMaxTokens",
-		"（空 = 不设置）"
-	]
-];
-/** 把布尔开关渲染成 dsh-tui 命令输出。 */
-/** 实际生效配置：生成目录优先（引擎加载源），settings 覆盖层作回退。 */
-function resolvePromptConfigs(moduleDir, fallback) {
-	if (moduleDir === void 0 || moduleDir.length === 0) return fallback;
-	try {
-		const actual = listPromptConfigSpecs(join(moduleDir, MODULE_CONFIGS_DIR));
-		return actual.length > 0 ? actual : fallback;
-	} catch {
-		return fallback;
-	}
-}
 /** 激活模块参数（status 显示与参数开关来源；settings 不再承载引擎参数）。 */
-function readPresetParams(moduleDir) {
+function readModuleParams(moduleDir) {
 	if (moduleDir === void 0 || moduleDir.length === 0) return {};
 	try {
 		const spec = loadModuleSpec(moduleDir);
-		const params = resolvePresetParams(spec, {});
-		if (Array.isArray(spec.promptConfigs)) params.promptConfigs = spec.promptConfigs;
-		return params;
+		return resolveModuleParams(spec, {});
 	} catch {
 		return {};
 	}
 }
-function renderTuiStatus(source, params, promptConfigs) {
+function renderTuiStatus(source, params, rules) {
 	const onOff = (value) => value ? "开" : "关";
 	const paramBoolean = (key) => (params[key] ?? ENGINE_PARAM_DEFINITIONS[key]?.defaultValue) === true;
-	const paramText = (key) => {
-		const value = params[key];
-		return typeof value === "string" && value.length > 0 ? value : "";
-	};
 	const lines = [
 		"提示词工具开关",
 		...TUI_GLOBAL_SWITCHES.map(([key, label]) => {
@@ -6467,16 +6039,11 @@ function renderTuiStatus(source, params, promptConfigs) {
 		...TUI_PARAM_SWITCHES.map(([key, label]) => {
 			return `${key.padEnd(22)}${onOff(paramBoolean(key))}  ${label}（模块）`;
 		}),
-		"模型请求参数:",
-		...TUI_PARAM_TEXT_LINES.map(([key, label, emptyText]) => {
-			const text = paramText(key);
-			return `  ${label.padEnd(26)}${text.length > 0 ? text : emptyText}`;
-		}),
 		`  modelsAvailable         ${source.modelsAvailable ? "是" : "否（未检测到模型服务商）"}`,
 		`  activeSkillsDirs        ${source.activeSkillsDirs.length > 0 ? source.activeSkillsDirs.join(" → ") : "（未解析到技能目录）"}`,
-		"提示词配置:"
+		"行为规则（条件 → 动作）:"
 	];
-	for (const config of promptConfigs) lines.push(`${("config " + config.id).padEnd(22)}${onOff(config.enabled !== false)}  layer=${config.layer ?? "pre-step"} strategy=${config.strategy ?? "static"}`);
+	for (const rule of rules) lines.push(`${("config " + rule.id).padEnd(22)}${onOff(rule.enabled !== false)}  ${rule.then.map((action) => action.kind).join(" → ")}`);
 	lines.push("技能开关:");
 	for (const skill of source.skillCatalog) {
 		const value = skill.modelInvocable || skill.userInvocable;
@@ -6485,49 +6052,10 @@ function renderTuiStatus(source, params, promptConfigs) {
 	}
 	return lines.join("\n");
 }
-/** 渲染单条提示词配置详情（params 以 JSON 摘要输出）。 */
-function renderConfigDetail(source, id, promptConfigs) {
-	const config = promptConfigs.find((item) => item.id === id);
-	if (config === void 0) return `未找到提示词配置 ${id}`;
-	const lines = [`提示词配置 ${config.id}`, ""];
-	const fields = [
-		["name", config.name],
-		["enabled", config.enabled !== false],
-		["layer", config.layer],
-		["strategy", config.strategy],
-		["position", config.position],
-		["dedupe", config.dedupe],
-		["promotion", config.promotion],
-		["audience", config.audience ?? void 0],
-		["modelScope", config.modelScope],
-		["configKind", config.configKind],
-		["order", config.order],
-		["role", config.role],
-		["mergeMode", config.mergeMode],
-		["sourceKind", config.sourceKind],
-		["form", config.form],
-		["fill", config.fill],
-		["templateFile", config.templateFile],
-		["variables", config.variables],
-		["params", config.params]
-	];
-	for (const [key, value] of fields) {
-		if (value === void 0 || value === "" || Array.isArray(value) && value.length === 0) continue;
-		if (key === "variables" || key === "params") {
-			lines.push(`${key.padEnd(14)}${JSON.stringify(value)}`);
-			continue;
-		}
-		lines.push(`${key.padEnd(14)}${String(value)}`);
-	}
-	if (typeof config.text === "string" && config.text.length > 0) {
-		lines.push("text:");
-		lines.push(config.text);
-	}
-	if (Array.isArray(config.texts) && config.texts.length > 0) {
-		lines.push("texts:");
-		for (const item of config.texts) lines.push(`  - ${item}`);
-	}
-	return lines.join("\n");
+/** 详情呈现唯一声明，不把动作投影误当可独立启停的配置。 */
+function renderConfigDetail(id, rules) {
+	const rule = rules.find((item) => item.id === id);
+	return rule === void 0 ? `未找到规则 ${id}` : JSON.stringify(rule, null, 2);
 }
 /** 解析 on/off/toggle 三种输入。 */
 function parseTuiBoolean(token, current) {
@@ -6559,7 +6087,7 @@ function parseIdentifierAndAction(tokens, exists) {
 	return { id: tokens.join(" ") };
 }
 /** 通过 DSH 命令注册表暴露 /prompt-tool，Web 与 dsh-tui 都能执行。 */
-function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog, getPresetConfigsDir, savePresetParam, toggleSkillState) {
+function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog, getModuleDirectory, saveModuleParam, toggleSkillState, refreshModule) {
 	ctx.inject(["settings"], (sctx) => {
 		return sctx.commands.register({
 			name: "prompt-tool",
@@ -6573,13 +6101,13 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
       /prompt-tool config <id>（id 可含空格）
       /prompt-tool config <id> on|off|toggle`
 				});
-				const persistPresetParam = async (key, value) => {
-					if (savePresetParam === void 0) return {
+				const persistModuleParam = async (key, value) => {
+					if (saveModuleParam === void 0) return {
 						kind: "error",
 						text: `无法保存 ${key}：模块参数保存回调不可用`
 					};
 					try {
-						await savePresetParam(key, value);
+						await saveModuleParam(key, value);
 						return;
 					} catch (error) {
 						return {
@@ -6590,9 +6118,18 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 				};
 				const tokens = invocation.rawInput.trim().split(/\s+/).filter((token) => token.length > 0);
 				const source = getSource();
-				const moduleDir = getPresetConfigsDir?.();
-				const params = readPresetParams(moduleDir);
-				const promptConfigs = resolvePromptConfigs(moduleDir, Array.isArray(params.promptConfigs) ? params.promptConfigs : []);
+				const moduleDir = getModuleDirectory?.();
+				const params = readModuleParams(moduleDir);
+				let snapshot;
+				try {
+					if (moduleDir) snapshot = readModuleRules(moduleDir);
+				} catch (error) {
+					return {
+						kind: "error",
+						text: `读取规则失败：${error instanceof Error ? error.message : String(error)}`
+					};
+				}
+				const rules = snapshot?.rules ?? [];
 				if (tokens.length === 0 || tokens[0] === "status") {
 					const detection = getModelsState();
 					const catalog = await getModelCatalog();
@@ -6601,7 +6138,7 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 					const modelsLine = catalogEntries.length > 0 ? `检测到的模型名: ${catalogEntries.map(([provider, models]) => `${provider} → ${models.join(", ")}`).join("；")}` : "未检测到模型名（adapter 未公布或查询失败）";
 					return {
 						kind: "success",
-						text: renderTuiStatus(source, params, promptConfigs) + "\n" + providersLine + "\n" + modelsLine
+						text: renderTuiStatus(source, params, rules) + "\n" + providersLine + "\n" + modelsLine
 					};
 				}
 				if (tokens[0] === "skill") {
@@ -6632,33 +6169,55 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 						kind: "success",
 						text: `已把技能 ${id} 设为 ${next ? "开" : "关"}
 
-${renderTuiStatus(getSource(), readPresetParams(getPresetConfigsDir?.()), resolvePromptConfigs(getPresetConfigsDir?.(), []))}`
+${renderTuiStatus(getSource(), readModuleParams(moduleDir), rules)}`
 					};
 				}
 				if (tokens[0] === "config") {
-					const { id, action } = parseIdentifierAndAction(tokens.slice(1), (candidate) => promptConfigs.some((config) => config.id === candidate));
+					const { id, action } = parseIdentifierAndAction(tokens.slice(1), (candidate) => rules.some((rule) => rule.id === candidate));
 					if (id.length === 0) return usage();
-					const current = promptConfigs.find((config) => config.id === id);
+					const current = rules.find((rule) => rule.id === id);
 					if (current === void 0) return {
 						kind: "error",
-						text: `未找到提示词配置 ${id}；用 /prompt-tool status 查看全部 id。`
+						text: `未找到规则 ${id}；用 /prompt-tool status 查看全部 id。`
 					};
 					if (action === void 0) return {
 						kind: "success",
-						text: renderConfigDetail(source, id, promptConfigs)
+						text: renderConfigDetail(id, rules)
 					};
 					const next = parseTuiBoolean(action, current.enabled !== false);
 					if (next === void 0) return usage();
-					const failure = await persistPresetParam("promptConfigs", promptConfigs.map((config) => config.id === id ? {
-						...config,
-						enabled: next
-					} : config));
-					if (failure !== void 0) return failure;
+					if (!moduleDir || !snapshot || !refreshModule) return {
+						kind: "error",
+						text: "规则保存通道不可用"
+					};
+					try {
+						editModuleRules(moduleDir, {
+							expectedRevision: snapshot.revision,
+							...next ? { activateRuleId: id } : { edits: [{
+								previousId: id,
+								rule: {
+									...current,
+									enabled: false
+								}
+							}] }
+						});
+					} catch (error) {
+						return {
+							kind: "error",
+							text: `保存规则失败：${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+					try {
+						await refreshModule(basename(moduleDir));
+					} catch (error) {
+						return {
+							kind: "error",
+							text: `规则已保存，但重新装配失败：${error instanceof Error ? error.message : String(error)}`
+						};
+					}
 					return {
 						kind: "success",
-						text: `已把提示词配置 ${id} 设为 ${next ? "开" : "关"}
-
-${renderConfigDetail(getSource(), id, resolvePromptConfigs(getPresetConfigsDir?.(), []))}`
+						text: `已把规则 ${id} 设为 ${next ? "开" : "关"}\n\n${renderConfigDetail(id, readModuleRules(moduleDir).rules)}`
 					};
 				}
 				const action = tokens[0];
@@ -6673,20 +6232,16 @@ ${renderConfigDetail(getSource(), id, resolvePromptConfigs(getPresetConfigsDir?.
 				};
 				const next = parseTuiBoolean(action, currentValue);
 				if (next === void 0) return usage();
-				if (globalSwitch) await sctx.settings.mutate(ns, [{
-					op: "set",
-					path: [key],
-					value: next
-				}]);
+				if (globalSwitch) await sctx.settings.mutate(ns, modulesEnabledOps(next));
 				else {
-					const failure = await persistPresetParam(key, next);
+					const failure = await persistModuleParam(key, next);
 					if (failure !== void 0) return failure;
 				}
 				return {
 					kind: "success",
 					text: `已把 ${key} 设为 ${next ? "开" : "关"}
 
-${renderTuiStatus(getSource(), readPresetParams(getPresetConfigsDir?.()), resolvePromptConfigs(getPresetConfigsDir?.(), []))}`
+${renderTuiStatus(getSource(), readModuleParams(moduleDir), moduleDir ? readModuleRules(moduleDir).rules : [])}`
 				};
 			}
 		});
@@ -7023,6 +6578,162 @@ function createSkillsRuntime(ctx, options = {}) {
 	};
 }
 //#endregion
+//#region engine/rule-runtime.mjs
+const noNext = /* @__PURE__ */ new Set([
+	"agent/inbox/inserted",
+	"agent/turn-stopping",
+	"subagent/start",
+	"subagent/end"
+]);
+const compare = (a, b) => a.action.channelOrder - b.action.channelOrder || a.moduleId.localeCompare(b.moduleId) || a.ruleIndex - b.ruleIndex || a.action.actionIndex - b.action.actionIndex;
+/** 所有来源只进入这个装配入口；注入保留原有批处理和协调器所有权。 */
+function mountRuleSources(ctx, sources, options = {}) {
+	const warnOnce = options.warnOnce ?? createWarnOnce(ctx, options.plugin ?? "rule-engine");
+	const releases = [];
+	const points = /* @__PURE__ */ new Map();
+	const injections = new Map(sources.map((source) => [source.moduleId, {
+		sourceId: `module:${source.moduleId}`,
+		configs: [],
+		ruleActions: [],
+		officialInstructions: source.officialInstructions === true
+	}]));
+	const rules = sources.flatMap((source) => source.rules.filter((rule) => rule.enabled !== false));
+	const observer = wireTriggerObservers(ctx, rules, {
+		plugin: options.plugin ?? "rule-engine",
+		warnOnce
+	});
+	if (observer) releases.push(observer);
+	let active = true;
+	const bind = (item, on) => prepareAction(item.action, {
+		plugin: options.plugin,
+		warnOnce,
+		promptConfigOptions: item.rule.promptConfigOptions,
+		on
+	})(ctx);
+	try {
+		for (const source of sources) for (const [ruleIndex, rule] of source.rules.entries()) {
+			if (rule.enabled === false) continue;
+			for (const action of rule.actions) {
+				const item = {
+					moduleId: source.moduleId,
+					ruleIndex,
+					rule,
+					action
+				};
+				if (action.execution.lifecycle === "registration" && action.kind === "guard") {
+					releases.push(bind(item));
+					continue;
+				}
+				const point = action.execution;
+				const key = `${point.channel}:${point.phase}:${action.waterfallPosition}`;
+				const bucket = points.get(key) ?? {
+					...point,
+					waterfallPosition: action.waterfallPosition,
+					items: []
+				};
+				bucket.items.push(item);
+				points.set(key, bucket);
+			}
+		}
+		for (const point of points.values()) {
+			point.items.sort(compare);
+			const handlers = [];
+			let textConfigs = [];
+			const flushLayers = () => {
+				if (!textConfigs.length) return;
+				releases.push(wireLayers(ctx, textConfigs, warnOnce, { on: (channel, handler) => {
+					if (channel !== point.channel) throw new TypeError(`rule action registered outside ${point.channel}: ${channel}`);
+					handlers.push({ handler });
+					return () => {};
+				} }));
+				textConfigs = [];
+			};
+			for (const item of point.items) {
+				const { action, rule, moduleId } = item;
+				if (action.kind === "inject-text") {
+					const config = {
+						...action.compiledConfig,
+						rule,
+						sourceModuleId: moduleId,
+						group: void 0,
+						exclusive: false,
+						enabled: true,
+						actionWhen: action.actionWhen,
+						bypassRuleWhen: action.bypassRuleWhen
+					};
+					if (config.layer === "pre-step") injections.get(moduleId).configs.push(config);
+					else textConfigs.push(config);
+					continue;
+				}
+				flushLayers();
+				const on = (channel, handler) => {
+					if (channel !== point.channel) throw new TypeError(`rule action registered outside ${point.channel}: ${channel}`);
+					const entry = {
+						rule,
+						handler,
+						sequence: action.channelOrder,
+						sourceModuleId: moduleId,
+						ruleId: rule.id,
+						ruleActionIndex: action.actionIndex,
+						id: action.id,
+						actionWhen: action.actionWhen,
+						bypassRuleWhen: action.bypassRuleWhen
+					};
+					if (channel === "agent/pre-step" && point.waterfallPosition === "default") injections.get(moduleId).ruleActions.push(entry);
+					else handlers.push(entry);
+					return () => {};
+				};
+				releases.push(bind(item, on));
+			}
+			flushLayers();
+			if (!handlers.length) continue;
+			releases.push(ctx.on(point.channel, (...args) => {
+				const free = noNext.has(point.channel);
+				const payload = free ? args : args.slice(0, -1);
+				const next = free ? () => void 0 : args[args.length - 1];
+				if (!active) return next();
+				const frame = ruleFrame(point.channel, payload, warnOnce, ctx);
+				if (free) {
+					let pending;
+					for (const entry of handlers) {
+						const invoke = () => active && actionMatches(entry, frame) ? entry.handler(...payload, void 0, frame) : void 0;
+						pending = pending?.then ? pending.then(invoke) : invoke();
+					}
+					return pending;
+				}
+				if (point.phase === "after-next") return Promise.resolve(next()).then(async (initial) => {
+					let result = initial;
+					for (const entry of handlers) {
+						if (!active || !actionMatches(entry, frame)) continue;
+						result = await entry.handler(...payload, () => result, frame);
+					}
+					return result;
+				});
+				const invoke = (index) => {
+					if (!active || index === handlers.length) return next();
+					const entry = handlers[index];
+					return actionMatches(entry, frame) ? entry.handler(...payload, () => invoke(index + 1), frame) : invoke(index + 1);
+				};
+				return invoke(0);
+			}, point.waterfallPosition === "outermost" ? { prepend: true } : void 0));
+		}
+		const preStep = [...injections.values()].filter((source) => source.configs.length || source.ruleActions.length);
+		if (preStep.length) releases.push(applyPromptConfigSources(ctx, preStep, { layers: false }));
+	} catch (error) {
+		active = false;
+		for (const dispose of releases.reverse()) try {
+			dispose?.();
+		} catch {}
+		throw error;
+	}
+	return () => {
+		active = false;
+		for (const dispose of releases.splice(0).reverse()) try {
+			dispose?.();
+		} catch {}
+	};
+}
+//#endregion
 //#region src/runtime/agent-assembly.ts
 /**
 * agent-assembly — 运行时配装通道。
@@ -7035,8 +6746,7 @@ function createSkillsRuntime(ctx, options = {}) {
 *     不再声明 `agent.cordis.yml` 这类「给宿主 Loader 用的组合本体」；
 *   - 官方工具行（`dsh-tool-*` 等）由宿主提供；模块人设通过 systemPrompt 注册，
 *     本通道**不**装第二棵官方插件树——那些包也不在插件包的解析面内；
-*   - 物化目录优先：`configs/`（原 `prompt-configs/`）、`custom-tools/` 存在就按它装配，
-*     缺失时回退 `module.yml` 内嵌，两条路径的切片同源（`resolveModuleFacts`）。
+*   - 规则从校验发布的 rules/ 快照编译；工具与子代理策略从模块定义内联装配。
 *
 * 与官方挂载并存时不会重复：官方树里没有引擎行，引擎贡献只由本通道提供。
 */
@@ -7045,7 +6755,7 @@ const MANAGED_FIELDS = [
 	"configsDir",
 	"strategyDir",
 	"policyFile",
-	"triggersFile"
+	"rulesFile"
 ];
 /** 私有工具适配器依赖的服务；适配器仍复用包内引擎入口。 */
 const PRIVATE_SERVICES = {
@@ -7054,7 +6764,7 @@ const PRIVATE_SERVICES = {
 	"session-var-tools": "pt-session-var-tools"
 };
 /**
-* 受管字段的路径换算：`configsDir` / `strategyDir` / `policyFile` / `triggersFile`
+* 受管字段的路径换算：`configsDir` / `strategyDir` / `policyFile` / `rulesFile`
 * 一律解析到**当前模块目录内的真实位置**——声明怎么写都按模块目录作基准，三种形态同结果：
 *   - `./configs`（新形态）→ `<模块目录>/configs`；
 *   - `../<id>/triggers.yml`（历史形态：`ENGINE_MANAGED_PATHS` 的改写成这样，语义是
@@ -7085,34 +6795,37 @@ function engineModuleFile(engineDir, id) {
 * 纯读缝（只依赖包内引擎与模块目录），供挂载与回归测试共用；`hasService` 是宿主能力探针。
 */
 async function prepareAssembly(moduleRoot, moduleId, hasService) {
-	assertPresetId(moduleId);
+	assertModuleId(moduleId);
 	const moduleDir = resolveModuleDir(moduleId, moduleRoot);
 	const spec = loadModuleSpec(moduleDir);
+	if (spec.customTools !== void 0 && !Array.isArray(spec.customTools)) throw new TypeError("customTools must be an array");
+	const toolErrors = validateCustomTools(spec.customTools ?? []);
+	if (toolErrors.length > 0) throw new Error(`invalid customTools: ${toolErrors.join("; ")}`);
 	const facts = resolveModuleFacts(spec, moduleDir);
 	if (facts.effectiveModules === null) throw new Error(`模块 ${moduleId} 的模块声明无效，无法配装`);
 	const configsByModule = facts.effectiveConfigs ?? {};
-	const promptDir = join(moduleDir, MODULE_CONFIGS_DIR);
-	const specs = existsSync(promptDir) ? loadPromptConfigFiles(pathToFileURL(promptDir + sep)) : spec.promptConfigs ?? [];
-	const promptConfig = absolutizeManagedFields(configsByModule["prompt-config-engine"] ?? {}, moduleDir);
-	const configs = createPromptConfigs(specs, {
-		sourceModuleId: moduleId,
+	const ruleConfig = absolutizeManagedFields(configsByModule["rule-engine"] ?? {}, moduleDir);
+	const rules = compileRules(spec.rules ?? [], {
+		moduleId,
 		configOrder: readConfigOrder(spec.configOrder),
-		templateBaseUrl: pathToFileURL(join(moduleRoot, ".engine", "prompt-config-engine.mjs")),
-		templatePresetRoot: pathToFileURL(moduleRoot + sep),
-		strategyDir: typeof promptConfig.strategyDir === "string" ? promptConfig.strategyDir.replace(/\/?$/, "/") : void 0
-	});
-	const exclusiveConfigs = configs.filter((config) => {
-		if (config === null || typeof config !== "object") return false;
-		const entry = config;
-		return entry.enabled !== false && entry.params?.complete === true;
+		variables: spec.variables,
+		variablesEnabled: spec.variablesEnabled,
+		promptConfigOptions: rulePromptConfigOptions(moduleDir, ruleConfig.strategyDir)
 	});
+	const ruleConditions = new Map((spec.rules ?? []).map((rule) => [rule.id, structuredClone(rule.if)]));
+	const exclusiveConfigs = (spec.rules ?? []).filter((rule) => rule.enabled !== false).flatMap((rule) => rule.then.filter((action) => {
+		const config = action.config;
+		return action.kind === "inject-text" && config?.params?.complete === true;
+	}));
 	const personaComplete = spec.persona?.complete === true;
 	if (exclusiveConfigs.length > 1 || personaComplete && exclusiveConfigs.length > 0) throw new Error(`模块 ${moduleId} 有多个生效的「独占」段（顶层人设${personaComplete ? "已" : "未"}开启），同一模块只能有一个：请先关闭其一`);
 	const engineDir = packageEngineDir();
 	const services = /* @__PURE__ */ new Set();
 	const modules = [];
 	for (const id of /* @__PURE__ */ new Set([...facts.effectiveModules, ...facts.rowIds])) {
-		if (id === "prompt-config-engine") continue;
+		if (id === "rule-engine") continue;
+		if (id === "subagent-tool-policy" && (spec.subagentToolPolicy === void 0 || spec.subagentToolPolicy === null)) continue;
+		if (id === "prompt-config-engine" || id === "declared-triggers") throw new Error(`模块 ${moduleId} 仍声明旧规则引擎 ${id}，请先离线迁移`);
 		const privateService = PRIVATE_SERVICES[id];
 		if (privateService !== void 0) {
 			if (!hasService(privateService)) throw new Error(`配装所需能力不可用：${privateService}`);
@@ -7124,7 +6837,12 @@ async function prepareAssembly(moduleRoot, moduleId, hasService) {
 		if (typeof module.apply !== "function") throw new Error(`引擎能力缺少 apply：${id}`);
 		for (const dependency of module.inject ?? []) services.add(dependency);
 		const config = absolutizeManagedFields(configsByModule[id] ?? {}, moduleDir);
-		if (id === "tool-config-engine" || id === "declared-triggers") config.presetRoot = pathToFileURL(moduleRoot + sep).href;
+		if (id === "tool-config-engine") {
+			config.tools = (spec.customTools ?? []).map((tool) => compileCustomTool(tool));
+			config.resourceRoot = pathToFileURL(moduleRoot + sep).href;
+			delete config.presetRoot;
+		}
+		if (id === "subagent-tool-policy") config.policy = structuredClone(spec.subagentToolPolicy);
 		module.configContract?.parse?.(config, id);
 		modules.push({
 			id,
@@ -7132,7 +6850,7 @@ async function prepareAssembly(moduleRoot, moduleId, hasService) {
 			config
 		});
 	}
-	if (configs.length > 0) {
+	if (rules.length > 0) {
 		services.add("systemPrompt");
 		services.add("tools");
 		services.add("llm");
@@ -7140,7 +6858,8 @@ async function prepareAssembly(moduleRoot, moduleId, hasService) {
 	if (spec.persona !== void 0) services.add("systemPrompt");
 	for (const name of services) if (!hasService(name)) throw new Error(`配装所需宿主能力不可用：${name}`);
 	return {
-		configs,
+		rules,
+		ruleConditions,
 		modules,
 		services,
 		moduleId,
@@ -7180,6 +6899,20 @@ function createAgentAssembly(ctx, options) {
 			name: "prompt-tool-assembly",
 			inject: [...services],
 			apply: async (scopeCtx) => {
+				const standingMountFor = await loadStandingMountFor();
+				const ruleSources = prepared.filter((item) => item.rules.length > 0).map((item) => ({
+					moduleId: item.moduleId,
+					rules: item.rules.map((value) => {
+						const rule = value;
+						return {
+							...rule,
+							when: compileWhen(item.ruleConditions.get(rule.id), {
+								ctx: scopeCtx,
+								standingMountFor
+							})
+						};
+					})
+				}));
 				for (const item of prepared) if (item.persona !== void 0) {
 					const persona = item.persona;
 					scopeCtx.systemPrompt.section({
@@ -7195,10 +6928,7 @@ function createAgentAssembly(ctx, options) {
 					});
 					if (persona.includeRuntimeContext === false) scopeCtx.systemPrompt.suppressRuntimeContext();
 				}
-				scopeCtx.effect(() => applyPromptConfigSources(scopeCtx, prepared.filter((item) => item.configs.length > 0).map((item) => ({
-					sourceId: `module:${item.moduleId}`,
-					configs: item.configs
-				})), { prepend: true }));
+				scopeCtx.effect(() => mountRuleSources(scopeCtx, ruleSources, { prepend: true }));
 				for (const item of prepared) for (const module of item.modules) {
 					const result = await module.apply(scopeCtx, module.config);
 					if (typeof result === "function") scopeCtx.effect(() => result, module.id);
@@ -7300,22 +7030,25 @@ function warn(ctx, message) {
 	} catch {}
 }
 function apply(ctx, configIn) {
-	const seededPresets = new Set(ensurePresetSeed(MODULES_DIR).created);
-	const readConfig = () => ({ writePreset: configIn.writePreset.get() });
+	const seededModules = new Set(ensureModuleSeed(MODULES_DIR).created);
+	const readConfig = () => ({ modulesEnabled: readModulesEnabled({
+		modulesEnabled: configIn.modulesEnabled?.get(),
+		writePreset: configIn.writePreset?.get()
+	}) });
 	const config = readConfig();
 	/** 运行时配装通道的运行态：工具写入目标按它报告的「本 Agent 装了哪几层提示词」解析。 */
 	let assembly;
 	const modelsState = () => detectModels(ctx);
 	const getModelsState = () => modelsState();
 	const runtime = { ...config };
-	const materialize = (id) => {
-		materializeModule(id, {
-			moduleDir: MODULES_DIR,
+	const refreshModuleSlices = (id) => {
+		ensureModuleReady(id, {
+			modulesRoot: MODULES_DIR,
 			warn: (message) => warn(ctx, message)
 		});
 	};
-	const rebuildPreset = async (id = basename(activeModuleDir())) => {
-		materialize(id);
+	const refreshModuleRuntime = async (id = basename(activeModuleDir())) => {
+		refreshModuleSlices(id);
 		await assembly?.refresh(id);
 	};
 	/** 无请求目标时供TUI使用的模块；编辑器的显式ID始终单独解析。 */
@@ -7333,10 +7066,10 @@ function apply(ctx, configIn) {
 		readSkillContent: skillsRuntime.readContent,
 		writeSkillContent: skillsRuntime.writeContent,
 		patchSkillFolders: skillsRuntime.setFolders
-	}), () => "", skillsRuntime.invalidate, (moduleId) => moduleId === void 0 ? activeModuleDir() : resolveEditDir(MODULES_DIR, moduleId), (_scopes, id) => rebuildPreset(id), (id) => id === void 0 ? assembly?.refresh() : rebuildPreset(id), async (id) => {
+	}), () => "", skillsRuntime.invalidate, (moduleId) => moduleId === void 0 ? activeModuleDir() : resolveEditDir(MODULES_DIR, moduleId), (_scopes, id) => refreshModuleRuntime(id), (id) => id === void 0 ? assembly?.refresh() : refreshModuleRuntime(id), async (id) => {
 		skillsRuntime.invalidate();
 		await assembly?.refresh(id);
-	}, (id) => rebuildPreset(id), () => assembly?.refresh());
+	}, (id) => refreshModuleRuntime(id), () => assembly?.refresh());
 	scheduleWebSurfaceRepair(ctx, (message) => warn(ctx, message));
 	ctx.effect(() => ctx.on("llm/adapters-updated", () => invalidateModelCatalog(ctx)));
 	const currentSource = () => ({
@@ -7348,9 +7081,8 @@ function apply(ctx, configIn) {
 		skillCatalog: skillsRuntime.listSkills(),
 		activeSkillsDirs: [skillsRuntime.skillsRoot]
 	}), getModelsState, () => listAdvertisedModels(ctx), () => activeModuleDir(), async (key, value) => {
-		if (key === "promptConfigs") saveModuleParams(MODULES_DIR, basename(activeModuleDir()), void 0, Array.isArray(value) ? value : void 0);
-		else saveModuleParams(MODULES_DIR, basename(activeModuleDir()), { [key]: value }, void 0);
-		await rebuildPreset();
+		saveModuleParams(MODULES_DIR, basename(activeModuleDir()), { [key]: value }, void 0);
+		await refreshModuleRuntime();
 	}, (name, enabled) => {
 		const matches = skillsRuntime.listSkills().filter((skill) => skill.name === name);
 		if (matches.length !== 1) return {
@@ -7367,34 +7099,41 @@ function apply(ctx, configIn) {
 			ok: false,
 			message: result.message
 		};
-	});
+	}, (id) => refreshModuleRuntime(id));
 	let needsInitialApply = true;
 	const applyState = async () => {
-		const next = currentSource();
-		const nextRuntime = { writePreset: typeof next.writePreset === "boolean" ? next.writePreset : config.writePreset };
-		const writePresetChanged = runtime.writePreset !== nextRuntime.writePreset;
-		if (!needsInitialApply && !writePresetChanged) return;
+		const nextRuntime = { modulesEnabled: currentSource().modulesEnabled };
+		const modulesEnabledChanged = runtime.modulesEnabled !== nextRuntime.modulesEnabled;
+		if (!needsInitialApply && !modulesEnabledChanged) return;
 		const initial = needsInitialApply;
 		needsInitialApply = false;
 		Object.assign(runtime, nextRuntime);
 		if (initial) {
-			for (const id of seededPresets) materialize(id);
-			seededPresets.clear();
+			for (const id of seededModules) refreshModuleSlices(id);
+			seededModules.clear();
 		}
 		await assembly?.refresh();
 	};
 	const moduleToolHost = {
 		target: (exec) => resolveModuleToolTarget(exec, MODULES_DIR, (sessionId) => assembly?.moduleIds(sessionId) ?? []),
-		rebuild: (id) => rebuildPreset(id)
+		rebuild: (id) => refreshModuleRuntime(id)
 	};
 	ctx.provide("pt-character-tools", { mount: (scopeCtx) => registerCharacterTools(scopeCtx, moduleToolHost) });
 	ctx.provide("pt-world-book-tools", { mount: (scopeCtx) => registerWorldBookTools(scopeCtx, moduleToolHost) });
 	ctx.provide("pt-session-var-tools", { mount: (scopeCtx) => registerSessionVarTools(scopeCtx) });
+	import(new URL("../engine/skill-search.mjs", import.meta.url).href).then((mod) => {
+		if (typeof mod.apply !== "function") return;
+		ctx.inject(mod.inject ?? ["tools"], (skillCtx) => {
+			mod.apply?.(skillCtx);
+		});
+	}).catch((error) => {
+		warn(ctx, `prompt-tool: skill-search 未挂载（skill_search/skill_load 不可用）：${error instanceof Error ? error.message : String(error)}`);
+	});
 	installPreStepCoordinator(ctx);
 	ctx.inject(["agents"], (actx) => {
 		const mounted = createAgentAssembly(actx, {
 			moduleRoot: MODULES_DIR,
-			enabledModules: () => runtime.writePreset ? enabledModuleIds(MODULES_DIR).filter((id) => moduleDirExists(MODULES_DIR, id)) : [],
+			enabledModules: () => runtime.modulesEnabled ? enabledModuleIds(MODULES_DIR).filter((id) => moduleDirExists(MODULES_DIR, id)) : [],
 			warn: (message) => warn(ctx, message)
 		});
 		assembly = mounted;
@@ -7418,4 +7157,4 @@ function apply(ctx, configIn) {
 	});
 }
 //#endregion
-export { BRIDGE_ENDPOINTS, CHARACTER_MODULES_KEY, Config, DEFAULT_MODULE_ID, ENGINE_CAPABILITIES, ENGINE_PARAM_KEYS, ENGINE_RECIPES, INSTRUCTION_FILE_STATUSES, MAX_BRIDGE_BODY_BYTES, MAX_CHARACTER_CARD_STREAM_BYTES, MAX_INSTRUCTION_FILE_BYTES, PARAM_KEYS, PRE_STEP_COORDINATOR_SERVICE, PRE_STEP_COORDINATOR_VERSION, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_PATTERN, USER_SKILLS_DIR, WRITER_PARAM_KEYS, agentsFileCardSpecs, agentsFileId, appendCharacterMemory, appendMemoryFile, apply, applyCharacterToPreset, applyModuleConfigs, assertSafeConfigId, buildModuleConfigsFromParams, buildWorldBookEntry, catalogFromScan, characterModuleStillNeeded, cloneBuiltinPreset, configFileName, convertStToPreset, createEngineCapabilityInPreset, createSkillsReloader, createSkillsRuntime, declaredCharacterModules, deleteCharacterCard, deleteWorldBookEntry, detectAgentsFileSnapshots, detectAgentsFiles, detectModels, engineCapability, engineRecipe, ensurePresetSeed, ensureWebSurface, expandPresetSource, exportPresetPackage, importCharacterCard, importCharacterCardFile, importSkillsPackage, inject, installPreStepCoordinator, installPresetPackage, invalidateModelCatalog, invocationForScope, isEngineCapabilityPresent, listAdvertisedModels, listBuiltinTemplates, listCharacterCards, listModules, listWorldBookEntries, loadModuleSpec, loadPromptTemplates, loadToolTemplates, mergeInstructionCards, mergeStPresets, moduleDirExists, name, parseFrontmatter, peekModelCatalog, presetImportPreview, processStText, readAgentsFileSnapshot, readCharacterMemory, readSkillInvocation, readSkillsState, recordedCharacterModules, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeCharacterFromPreset, removeEngineCapabilityFromPreset, removePresetModule, removeUserPreset, renderComposition, requiredCharacterModules, resolveModuleDir, resolveModuleFacts, resolvePresetParams, resolveProfileDir, resolveProjectRoot, resolveSubagentStartOptions, saveModuleParams, savePresetPersona, scanRoot, scanRoots, scheduleWebSurfaceRepair, scopeOfInvocation, setSkillInvocation, skillRoots, skillsStatePath, stPresetId, syncImportedCharacterMemory, upsertWorldBookEntry, userModulesDir, validateCustomToolIdentities, validateEngineParamValues, validatePromptConfigs, writeAgentsFile, writeAgentsFileChecked, writePreset, writeSkillsState };
+export { BRIDGE_ENDPOINTS, Config, DEFAULT_MODULE_ID, MODULE_CAPABILITIES as ENGINE_CAPABILITIES, MODULE_CAPABILITIES, ENGINE_PARAM_KEYS, ENGINE_RECIPES, INJECTION_POINT_ORDER, INSTRUCTION_FILE_STATUSES, MAX_BRIDGE_BODY_BYTES, MAX_CHARACTER_CARD_STREAM_BYTES, MAX_INSTRUCTION_FILE_BYTES, ModuleLayerSettingsError, PARAM_KEYS, PRE_STEP_COORDINATOR_SERVICE, PRE_STEP_COORDINATOR_VERSION, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_PATTERN, USER_SKILLS_DIR, WRITER_PARAM_KEYS, agentsFileCardSpecs, agentsFileId, appendModuleCapabilities, appendModuleMemory, apply, applyModuleConfigs, assertModuleDirectory, assertModuleId, assertModuleTree, assertSafeConfigId, buildModuleConfigsFromParams, buildWorldBookEntry, canonicalModulesRoot, catalogFromScan, cloneBuiltinModule, cloneBuiltinModule as cloneBuiltinPreset, configFileName, convertStToModule, convertStToModule as convertStToPreset, convertStToModuleWithReport, createModuleCapability as createEngineCapabilityInPreset, createModuleCapability, createSkillsReloader, createSkillsRuntime, deleteWorldBookEntry, detectAgentsFileSnapshots, detectAgentsFiles, detectModels, moduleCapability as engineCapability, moduleCapability, engineRecipe, ensureModuleReady, ensureModuleSeed, ensureModuleSeed as ensurePresetSeed, ensureWebSurface, expandModuleSource, expandModuleSource as expandPresetSource, exportModulePackage, exportModulePackage as exportPresetPackage, importCharacterCard, importCharacterCardFile, importSkillsPackage, inject, installModulePackage, installModulePackage as installPresetPackage, installPreStepCoordinator, invalidateModelCatalog, invocationForScope, isModuleCapabilityPresent as isEngineCapabilityPresent, isModuleCapabilityPresent, listAdvertisedModels, listBuiltinTemplates, listModules, listWorldBookEntries, loadModuleSpec, loadPromptTemplates, loadToolTemplates, mergeInstructionCards, mergeModuleIntoModule, mergeStModules, mergeStModules as mergeStPresets, mergeStModulesWithReport, moduleDirExists, moduleImportPreview, moduleImportPreview as presetImportPreview, modulePathExists, name, parseFrontmatter, peekModelCatalog, processStText, readAgentsFileSnapshot, readModuleLayerSettings, readModuleMemory, readSkillInvocation, readSkillsState, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeModuleCapability as removeEngineCapabilityFromPreset, removeModuleCapability, removeMergedModule, removeModuleCapabilityDeclaration, removeModuleCapabilityDeclaration as removePresetModule, removeUserModule, removeUserModule as removeUserPreset, renderComposition, resolveModuleDir, resolveModuleFacts, resolveModuleParams, resolveModuleParams as resolvePresetParams, resolveProfileDir, resolveProjectRoot, resolveSubagentStartOptions, saveModuleParams, saveModulePersona, saveModulePersona as savePresetPersona, scanRoot, scanRoots, scheduleWebSurfaceRepair, scopeOfInvocation, setSkillInvocation, skillRoots, skillsStatePath, stModuleId, stModuleId as stPresetId, upsertWorldBookEntry, userModulesDir, validateCustomToolIdentities, validateEngineParamValues, withModuleDefinition, writeAgentsFile, writeAgentsFileChecked, writeModule, writePreset, writeSkillsState };