dsh-plugin-prompt-tool 0.8.0 → 1.0.0

package/lib/index.mjs

@@ -1,6 +1,6 @@
-import { $ as ensurePresetSeed, $t as USER_SKILLS_DIR, A as decodeAssetFile, At as createWarnOnce, Bt as ENGINE_CAPABILITIES, C as listCharacterCards, Ct as KNOWN_AUDIENCES, D as removeCharacterFromPreset, Dt as createEpochPromotion, E as recordedCharacterModules, Et as KNOWN_PROMOTIONS, F as stPresetId, Ft as assertPresetId, G as stripConfigFieldSources, Gt as isEngineCapabilityPresent, H as savePresetTriggers, Ht as ENGINE_RECIPES, I as buildWorldBookEntry, It as canonicalPresetRoot, J as asString, Jt as WRITER_PARAM_KEYS, K as appendPresetModules, Kt as validateCustomToolIdentities, L as deleteWorldBookEntry, Lt as presetPathExists, M as convertStToPreset, Mt as PresetLayerSettingsError, N as mergeStPresets, Nt as PRESET_ENGINE_PREFIX, O as requiredCharacterModules, Ot as isSuccessfulCompactionEnd, P as processStText, Pt as assertPresetDirectory, Q as duplicateUserPreset, Qt as DSH_HOME, R as listWorldBookEntries, Rt as DEFAULT_PRESET_ID, S as importCharacterCardFile, St as renderPromptConfigYaml, T as readCharacterMemory, Tt as KNOWN_POSITIONS, U as triggerPromptConfigOptions, Ut as engineCapability, V as readPresetTriggers, Vt as ENGINE_EDITOR_GROUP_MAP, W as readConfigFieldSources, Wt as engineRecipe, X as cloneBuiltinPreset, Xt as validateEngineParamValues, Y as buildModuleConfigsFromParams, Yt as moduleParamFallbacks, Z as createEngineCapabilityInPreset, Zt as DEFAULT_PRESET_DIR, _ as characterModuleStillNeeded, _t as withPresetDoc, a as writePreset, at as openPresetLocation, b as deleteCharacterCard, bt as configFileName, c as lastWorldBookDiagnostics, ct as removePresetModule, d as computePreviewRevision, dt as resolvePresetDir, et as invalidatePresetSpec, f as directoryVersionOf, ft as resolvePresetModuleFacts, g as applyCharacterToPreset, gt as userPresetsDir, h as appendMemoryFile, ht as savePresetPersona, i as presetImportPreview, it as loadPresetSpec, j as prepareImport, jt as sessionEvents, k as syncImportedCharacterMemory, kt as PROMOTE_EVENTS, l as validateCustomTools, lt as removeUserPreset, m as appendCharacterMemory, mt as savePresetParams, n as exportPresetPackage, nt as listPresets, o as confirmDelivered, ot as packageEngineDir, p as CHARACTER_MODULES_KEY, pt as resolvePresetParams, q as applyModuleConfigs, qt as ENGINE_PARAM_KEYS, r as installPresetPackage, rt as loadPresetContent, s as runPreStepBatch, st as removeEngineCapabilityFromPreset, t as expandPresetSource, tt as listBuiltinTemplates, u as safeAssetPath, ut as renderComposition, v as charactersDir, vt as atomicWriteTextFile, w as previewCharacterCard, wt as KNOWN_MODEL_SCOPES, x as importCharacterCard, xt as listPromptConfigSpecs, y as declaredCharacterModules, yt as assertSafeConfigId, z as upsertWorldBookEntry, zt as readPersonaSpec } from "./preset-package-BnJqrU4R.mjs";
-import { accessSync, chmodSync, constants, createWriteStream, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, unwatchFile, watchFile, writeFileSync } from "node:fs";
+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 { 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";
@@ -12,29 +12,10 @@ import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { FileSystemSkillProvider } from "@deepseek-ai/dsh-skill-filesystem";
-import { entryListProblem } from "@deepseek-ai/dsh-agent-preset-registry";
 //#region src/web-surface.ts
 /**
-* prompt-tool 自愈层：补当前 profile manifest 与本插件相关的装配项。
-*
-* 官方 profile 组合规则：`dsh plugin add` 只把声明了 `dsh.bundle` 的
-* **直接依赖**追加进 `dsh.profile.bundles`，而 `@deepseek-ai/dsh-web-app`
-* 是随 dsh 安装自带的 in-box bundle。自定义 profile（如 prompt-tool）
-* 首次初始化只含 `@deepseek-ai/dsh-base`，单独执行
-* `dsh plugin --profile prompt-tool add link:<本仓库>` 后，本插件等待的
-* `webServer` 服务不存在。
-*
-* 因此：
-*  1. 当前 profile 缺 webServer 时，把 web-app 补进当前 profile 的
-*     bundles（base 之后、本插件之前），重启一次后生效；
-*  2. 不再改写同级 `web` / `dsh-tui` profile，也不主动退出进程；
-*     只提示用户重启，让官方装配路径在下次启动时读取新 manifest。
-*
-* 官方 Loader 只会在进程启动时读取 profile 的 bundles 列表，因此本层只
-* 持久化 manifest 并提示重启，不做运行中热挂载。所有写入都是幂等的，
-* 写前会保留一份 `.bak` 备份。
-*
-* 失败只降级为日志告警，绝不阻断启动。
+* Web 能力诊断：profile 由官方插件管理器装配，本插件只报告缺失能力。
+* 保留原公开函数名，启动与卸载均不改写 profile 或包链接。
 */
 /**
 * Web surface bundle：DSH 随安装自带的 in-box bundle。
@@ -43,8 +24,6 @@ import { entryListProblem } from "@deepseek-ai/dsh-agent-preset-registry";
 * 清单看起来像支持该字段，实际无人消费）。
 */
 const WEB_APP_BUNDLE = "@deepseek-ai/dsh-web-app";
-const BASE_BUNDLE = "@deepseek-ai/dsh-base";
-const PLUGIN_BUNDLE = "dsh-plugin-prompt-tool";
 /** 从 loader 根 Include 的 baseUrl 推导 profile 目录。 */
 function resolveProfileDir(ctx) {
 	const baseUrl = ctx.baseUrl;
@@ -63,67 +42,25 @@ function readManifest(packagePath, warn) {
 		return;
 	}
 }
-function writeManifest(packagePath, manifest, warn) {
-	try {
-		if (existsSync(packagePath)) writeFileSync(`${packagePath}.bak`, readFileSync(packagePath, "utf8"), "utf8");
-		const tmp = `${packagePath}.tmp-${process.pid}-${Date.now().toString(36)}`;
-		writeFileSync(tmp, JSON.stringify(manifest, null, 2) + "\n", "utf8");
-		renameSync(tmp, packagePath);
-		return true;
-	} catch (error) {
-		warn(`prompt-tool: cannot update profile manifest ${packagePath}: ${error instanceof Error ? error.message : String(error)}`);
-		return false;
-	}
-}
-/**
-* 把 web-app 补进当前 profile 的 bundles（base 之后、本插件之前）。
-* 只用于当前 prompt-tool profile；dsh-tui 不需要 web-app。
-*/
-function ensureCurrentWebAppBundle(manifest) {
-	const bundles = manifest.dsh?.profile?.bundles;
-	if (!Array.isArray(bundles)) return "invalid";
-	if (bundles.includes(WEB_APP_BUNDLE)) return "already";
-	const pluginIndex = bundles.indexOf(PLUGIN_BUNDLE);
-	const baseIndex = bundles.indexOf(BASE_BUNDLE);
-	const insertAt = pluginIndex >= 0 ? pluginIndex : baseIndex >= 0 ? baseIndex + 1 : bundles.length;
-	bundles.splice(insertAt, 0, WEB_APP_BUNDLE);
-	return "added";
-}
-/**
-* 每次启动：
-*  1. 只处理当前 profile：缺 webServer 时补 web-app 并提示重启；
-*  2. 不修改同级 profile，不主动退出进程。
-*/
+/** 只读诊断；安装与 profile 变更交给官方 plugin_manager。 */
 function ensureWebSurface(ctx, warn) {
+	if (ctx.get("webServer") !== void 0) return;
 	const notify = (message) => {
 		process.stderr.write(message + "\n");
 		warn(message);
 	};
 	const profileDir = resolveProfileDir(ctx);
 	if (profileDir === void 0) {
-		notify("prompt-tool: cannot locate profile directory to repair bundles; add @deepseek-ai/dsh-web-app to dsh.profile.bundles manually");
+		notify(`prompt-tool: Web 服务未就绪，无法定位当前 profile；请通过官方 plugin_manager 检查或安装 ${WEB_APP_BUNDLE}`);
 		return;
 	}
-	const packagePath = join(profileDir, "package.json");
-	const manifest = readManifest(packagePath, notify);
-	if (manifest === void 0) return;
 	const profileName = basename(profileDir);
 	if (profileName === "dsh-tui") return;
-	if (ctx.get("webServer") !== void 0) return;
-	const result = ensureCurrentWebAppBundle(manifest);
-	if (result === "invalid") {
-		notify(`prompt-tool: profile manifest has no dsh.profile.bundles: ${packagePath}`);
-		return;
-	}
-	if (result === "added" && !writeManifest(packagePath, manifest, notify)) return;
-	if (result === "added") {
-		notify(`prompt-tool: auto-added ${WEB_APP_BUNDLE} to dsh.profile.bundles for profile "${profileName}"; next launch will mount the Web surface`);
-		notify("prompt-tool: please restart the app for the repaired profile to take effect");
-	}
+	const bundles = readManifest(join(profileDir, "package.json"), notify)?.dsh?.profile?.bundles;
+	notify(`prompt-tool: profile "${profileName}" 的 Web 服务未就绪${Array.isArray(bundles) && bundles.includes(WEB_APP_BUNDLE) ? "（已声明 Web bundle）" : ""}；请通过官方 plugin_manager 检查或安装 ${WEB_APP_BUNDLE}`);
 }
 /**
-* 把首次启动自愈挂到插件生命周期上：延迟到本轮装配结束后执行，
-* 插件卸载会取消计时器，卸载后不再异步补写 profile。
+* 延迟到本轮装配结束后诊断；插件卸载取消尚未执行的任务。
 */
 function scheduleWebSurfaceRepair(ctx, warn) {
 	ctx.effect(() => {
@@ -136,7 +73,7 @@ function scheduleWebSurfaceRepair(ctx, warn) {
 			cancelled = true;
 			clearTimeout(timer);
 		};
-	}, "prompt-tool: deferred web surface repair");
+	}, "prompt-tool: deferred web surface diagnosis");
 }
 //#endregion
 //#region src/runtime/models.ts
@@ -373,37 +310,124 @@ function resolveSubagentStartOptions(isEnabled, provider, model, getReasoningEff
 //#endregion
 //#region src/shared/param-keys.ts
 /**
-* 引擎行为参数键（按预设存储：激活预设 preset.yml 的 layerSettings + promptConfigs）。
-* 不进 Config schema、不进 settings namespace——每预设一份，随预设走（官方范式：
-* Config = 部署轴，引擎行为在预设文件）。
+* 引擎行为参数键（按模块存储：激活模块 module.yml 的 layerSettings + promptConfigs）。
+* 不进 Config schema、不进 settings namespace——每模块一份，随模块走（官方范式：
+* Config = 部署轴，引擎行为在 module.yml）。
 *
-* = ENGINE_PARAM_KEYS（唯一权威）+ promptConfigs，不再有旁路键清单。
-* 锚定/引导内容键（buildPattern、complexPattern、firstTurnBuild 等）已并入
-* ENGINE_PARAM_DEFINITIONS：它们本来就被 writePreset 映射进 near-anchor / router-guide
-* 的 promptConfig params，只挂在白名单里会让保存链「白名单接受、值校验拒绝」永久断层。
+* = ENGINE_PARAM_KEYS + 旧规则快捷参数兼容白名单 + promptConfigs。
+* 旧快捷参数只转换到规则实例，不重新进入新编辑器的共享字段目录。
 * 注意：variables.yml 的占位键（spec.variables 空值登记，供世界书条目 {{key}} 动态
 * 引用）只读顶层 variables；本集合不再用于推断哪些 params 是模板变量。
 * 放 shared：config/settings-bridge 共用，单一来源。
 */
 const EXTRA_PARAM_KEYS = ["promptConfigs"];
-const PARAM_KEYS = /* @__PURE__ */ new Set([...ENGINE_PARAM_KEYS, ...EXTRA_PARAM_KEYS]);
+const PARAM_KEYS = /* @__PURE__ */ new Set([
+	...ENGINE_PARAM_KEYS,
+	...LEGACY_PROMPT_PARAM_KEYS,
+	...EXTRA_PARAM_KEYS
+]);
 //#endregion
 //#region src/config.ts
 /** 插件配置、settings 数据模型与默认常量（settings 接口层）。 */
 const NS = "prompt-tool";
-const Config = z.object({
-	writePreset: z.boolean().default(true).volatile(),
-	presetTemplate: z.string().default(DEFAULT_PRESET_ID).volatile(),
-	presetOrder: z.natural().default(5).volatile(),
-	fallbackText: z.string().default("").volatile()
-});
-const PromptSettingsSchema = z.object({
-	modelsAvailable: z.boolean().default(true),
-	presetOrder: z.natural().default(5),
-	fallbackText: z.string().default(""),
-	writePreset: z.boolean().default(true),
-	presetTemplate: z.string().default(DEFAULT_PRESET_ID)
-});
+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;
+}
 //#endregion
 //#region src/shared/official-orders.ts
 /** section 侧 6 组，覆盖官方 32 个档位名（顺序即官方数值升序）。 */
@@ -564,7 +588,7 @@ async function validatePromptConfigs(value, options = {}) {
 	const { createPromptConfigs } = await import(pathToFileURL(join(packageEngineDir(), "prompt-config-engine.mjs")).href);
 	const engineOptions = {
 		...options.strategyDir ? { strategyDir: options.strategyDir } : {},
-		...options.presetDir ? { templateBaseUrl: pathToFileURL(join(dirname(options.presetDir), ".engine", "schema.mjs")).href } : {}
+		...options.moduleDir ? { templateBaseUrl: pathToFileURL(join(dirname(options.moduleDir), ".engine", "schema.mjs")).href } : {}
 	};
 	const files = [];
 	for (let index = 0; index < specs.length; index += 1) {
@@ -1359,10 +1383,12 @@ const BRIDGE_ENDPOINTS = {
 	assetUpload: "/asset-upload",
 	assetRelease: "/asset-release",
 	exportPreset: "/export-preset",
-	presetDelete: "/preset-delete",
-	presetClone: "/preset-clone",
-	presetDuplicate: "/preset-duplicate",
-	presetOpen: "/preset-open",
+	moduleDelete: "/module-delete",
+	moduleClone: "/module-clone",
+	moduleDuplicate: "/module-duplicate",
+	moduleOpen: "/module-open",
+	moduleEnable: "/module-enable",
+	moduleConfigOrder: "/module-config-order",
 	charactersImport: "/characters-import",
 	charactersImportStream: "/characters-import-stream",
 	charactersList: "/characters-list",
@@ -1375,6 +1401,15 @@ const BRIDGE_ENDPOINTS = {
 	engineCapability: "/engine-capability",
 	worldBookDiagnostics: "/world-book-diagnostics"
 };
+/** 文件已保存，但宿主未采用新定义；调用方保留草稿并显示失败，不宣称已生效。 */
+const PRESET_ACTIVATION_FAILED = "preset-activation-failed";
+const MODULE_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+/** 读编辑目标：形状不合法（空、超长、含非法字符）一律当「未声明」，由 host 回退启用表首项。 */
+function readEditTarget(value) {
+	if (typeof value !== "string") return void 0;
+	const id = value.trim();
+	return id.length > 0 && id.length <= 64 && MODULE_ID_PATTERN.test(id) ? id : void 0;
+}
 //#endregion
 //#region src/host/skills-policy.ts
 /** 技能调用策略写入：唯一真相是技能文件自己的 frontmatter。
@@ -1744,7 +1779,7 @@ function withSkillWinners(entries, resolved) {
 * 只放两端都要理解的形状：读取快照、工作区上下文与写入结果；
 * 引擎侧的位置/晋升/受众算法不在这里复制。
 */
-/** 单个指令文件正文上限（与官方指令行的 maxBytes 基线对齐；读写限制一致）。 */
+/** 文件卡正文读写上限；官方注入的读取与渲染预算由官方配置决定。 */
 const MAX_INSTRUCTION_FILE_BYTES = 65536;
 const INSTRUCTION_FILE_STATUSES = [
 	"ready",
@@ -1756,12 +1791,10 @@ const INSTRUCTION_FILE_STATUSES = [
 //#region src/host/agents-cards.ts
 /**
 * AGENTS 指令文件探测与文件卡合成。
-* 文件即真相：探测到的 AGENTS.md 不写进 preset.yml，只作为生成目录的 pre-step 卡；
-* 卡内编辑框经 bridge 直接读写该文件；注入侧运行时读该文件正文
-* （fill=instruction-file），文件缺失或空内容就不注入。
+* 文件卡只作编辑视图，不写进 preset.yml 或生成目录；正文经 bridge 写回原文件。
+* 官方负责注入，运行时只复用本模块的文件身份映射应用逐文件开关。
 *
-* 本模块是文件身份、读取快照与读写校验的唯一来源：UI 与运行时都走同一套规则，
-* 不各自实现一套转换。读取失败与「读取成功的空文件」严格区分。
+* 本模块拥有本地卡片的文件身份、读取快照与读写校验；读取失败与空文件严格区分。
 */
 /** 项目目录链候选文件（与 engine/instruction-hint.mjs 的探测候选同源）。 */
 const AGENTS_PROJECT_CANDIDATES = [
@@ -1805,6 +1838,17 @@ function findProjectRoot(cwd) {
 		current = parent;
 	}
 }
+/** 官方展示路径 → 既有卡片身份；只解析路径，不读取正文，也不构成写入授权。 */
+function instructionFileIdFromDisplayPath(displayPath, projectRoot, home = DSH_HOME) {
+	const global = displayPath === "~/.dsh/AGENTS.md" || displayPath === "$DSH_HOME/AGENTS.md";
+	if (!global && (projectRoot === void 0 || isAbsolute(displayPath) || displayPath.includes("\0"))) return void 0;
+	const root = global ? resolve(home) : resolve(projectRoot);
+	const path = global ? join(root, AGENTS_USER_GLOBAL_FILE) : resolve(root, displayPath);
+	if (!within$1(root, path)) return void 0;
+	const realPath = realPathOf(path) ?? path;
+	if (!within$1(realPathOf(root) ?? root, realPath)) return void 0;
+	return agentsFileId(realPath);
+}
 /** 项目根 → cwd 的目录链（broad→specific）。 */
 function ancestorChain(root, cwd) {
 	const stop = resolve(root);
@@ -2043,98 +2087,48 @@ async function writeAgentsFileChecked(options) {
 //#endregion
 //#region src/host/instructions-policy.ts
 /**
-* 指令文件卡策略：独立于预设与 settings 的本插件自有状态。
+* 指令文件卡策略：独立于模块与 settings 的本插件自有状态。
 *
-* 位置：`<DSH_HOME>/.prompt-tool/instructions.yml`（同一 DSH_HOME 下的所有预设共享）。
+* 位置：`<DSH_HOME>/.prompt-tool/instructions.yml`（同一 DSH_HOME 下的所有模块共享）。
 * 只承载行为开关与展示名：正文永远在用户的原文件里，策略文件不存正文、读取版本、
 * 会话 ID 或任意客户端路径——路径与文件身份由服务端探测结果解析。
 *
-* 缺省 `enabled: false`：独立来源必须先完成负责人切换（预设去掉官方指令行），再由用户
-* 在工作台显式开启；键缺失 = 关闭，只有显式 `enabled: true` 才参战。不从各预设的旧
-* agentsHints 推导；文件缺失时用默认值，不因读取自动创建。
+* 缺省放行官方注入；只有逐文件 enabled:false 才拦截后续内容。旧独立来源总开关与
+* 注入参数已退役，读取时忽略，下一次保存清理；文件缺失不因读取自动创建。
 * 写入使用 yaml Document API 保留注释与未知字段；解析失败或 schemaVersion 不认识时
 * 拒绝写入（不把损坏文件当空配置覆盖）。
 */
 /** 相对 DSH_HOME 的策略文件位置（唯一权威定义）。 */
 const INSTRUCTIONS_POLICY_RELATIVE = join(".prompt-tool", "instructions.yml");
-const DEFAULT_VALUES = {
-	order: 30,
-	position: "after-user",
-	promotion: "none",
-	audience: null,
-	modelScope: "all"
-};
-const VALUE_KEYS = [
+const RETIRED_FILE_KEYS = [
 	"order",
 	"position",
 	"promotion",
 	"audience",
 	"modelScope"
 ];
-const OVERRIDE_KEYS = [
-	...VALUE_KEYS,
-	"enabled",
-	"name"
-];
+const OVERRIDE_KEYS = ["enabled", "name"];
 function defaultInstructionPolicy() {
-	return {
-		enabled: false,
-		defaults: { ...DEFAULT_VALUES },
-		files: {}
-	};
+	return { files: {} };
 }
 function instructionPolicyPath(dshHome = DSH_HOME) {
 	return join(dshHome, INSTRUCTIONS_POLICY_RELATIVE);
 }
-const isRecord$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isRecord$3 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
-/** 校验单个字段值；返回错误消息或 undefined。 */
-function valueError(key, value) {
-	if (key === "order") return typeof value === "number" && Number.isFinite(value) && Number.isSafeInteger(value) && value >= 0 ? void 0 : "order 必须是非负安全整数";
-	if (key === "audience") return value === null || typeof value === "string" && KNOWN_AUDIENCES.has(value) ? void 0 : "audience 必须是 null/main/subagent";
-	if (typeof value !== "string") return `${key} 必须是字符串`;
-	return (key === "position" ? KNOWN_POSITIONS : key === "promotion" ? KNOWN_PROMOTIONS : KNOWN_MODEL_SCOPES).has(value) ? void 0 : `${key} 取值非法：${value}`;
-}
 /** 请求体白名单校验：未知键一律拒绝，避免正文/路径/版本混进策略文件。 */
 function validateInstructionPolicyPatch(input) {
-	if (!isRecord$2(input)) return {
+	if (!isRecord$3(input)) return {
 		ok: false,
 		message: "策略载荷必须是对象"
 	};
-	for (const key of Object.keys(input)) if (key !== "enabled" && key !== "defaults" && key !== "files") return {
+	for (const key of Object.keys(input)) if (key !== "files") return {
 		ok: false,
 		message: `未知字段：${key}`
 	};
 	const patch = {};
-	if (input.enabled !== void 0) {
-		if (typeof input.enabled !== "boolean") return {
-			ok: false,
-			message: "enabled 必须是布尔值"
-		};
-		patch.enabled = input.enabled;
-	}
-	if (input.defaults !== void 0) {
-		if (!isRecord$2(input.defaults)) return {
-			ok: false,
-			message: "defaults 必须是对象"
-		};
-		const defaults = {};
-		for (const [key, value] of Object.entries(input.defaults)) {
-			if (!VALUE_KEYS.includes(key)) return {
-				ok: false,
-				message: `defaults 未知字段：${key}`
-			};
-			const error = valueError(key, value);
-			if (error !== void 0) return {
-				ok: false,
-				message: error
-			};
-			defaults[key] = value;
-		}
-		patch.defaults = defaults;
-	}
 	if (input.files !== void 0) {
-		if (!isRecord$2(input.files)) return {
+		if (!isRecord$3(input.files)) return {
 			ok: false,
 			message: "files 必须是对象"
 		};
@@ -2148,7 +2142,7 @@ function validateInstructionPolicyPatch(input) {
 				files[fileId] = null;
 				continue;
 			}
-			if (!isRecord$2(raw)) return {
+			if (!isRecord$3(raw)) return {
 				ok: false,
 				message: `files.${fileId} 必须是对象或 null`
 			};
@@ -2174,12 +2168,6 @@ function validateInstructionPolicyPatch(input) {
 					override.name = value;
 					continue;
 				}
-				const error = valueError(key, value);
-				if (error !== void 0) return {
-					ok: false,
-					message: `files.${fileId}.${error}`
-				};
-				override[key] = value;
 			}
 			files[fileId] = override;
 		}
@@ -2237,7 +2225,7 @@ function readInstructionPolicy(file = instructionPolicyPath()) {
 			error: `指令策略不是合法 YAML：${error instanceof Error ? error.message : String(error)}`
 		};
 	}
-	if (!isRecord$2(data)) return {
+	if (!isRecord$3(data)) return {
 		...empty,
 		exists: true,
 		revision,
@@ -2250,11 +2238,7 @@ function readInstructionPolicy(file = instructionPolicyPath()) {
 		revision,
 		error: `指令策略 schemaVersion 不受支持：${String(version)}`
 	};
-	const validated = validateInstructionPolicyPatch({
-		...data.enabled === void 0 ? {} : { enabled: data.enabled },
-		...data.defaults === void 0 ? {} : { defaults: data.defaults },
-		...data.files === void 0 ? {} : { files: data.files }
-	});
+	const validated = validateInstructionPolicyPatch(data.files === void 0 ? {} : { files: isRecord$3(data.files) ? Object.fromEntries(Object.entries(data.files).map(([id, value]) => [id, isRecord$3(value) ? Object.fromEntries(Object.entries(value).filter(([key]) => !RETIRED_FILE_KEYS.includes(key))) : value])) : data.files });
 	if (!validated.ok) return {
 		...empty,
 		exists: true,
@@ -2263,33 +2247,25 @@ function readInstructionPolicy(file = instructionPolicyPath()) {
 	};
 	const patch = validated.patch;
 	return {
-		policy: {
-			enabled: patch.enabled ?? false,
-			defaults: {
-				...DEFAULT_VALUES,
-				...patch.defaults
-			},
-			files: Object.fromEntries(Object.entries(patch.files ?? {}).flatMap(([fileId, override]) => override === null ? [] : [[fileId, override]]))
-		},
+		policy: { files: Object.fromEntries(Object.entries(patch.files ?? {}).flatMap(([fileId, override]) => override === null ? [] : [[fileId, override]])) },
 		revision,
 		exists: true,
 		path: file
 	};
 }
-/** 单文件的有效策略：部署级开关优先于每文件开关。 */
+/** 单文件的有效策略：未配置时放行官方注入。 */
 function resolveInstructionPolicy(policy, fileId) {
 	const override = policy.files[fileId] ?? {};
 	return {
-		...policy.defaults,
 		...override,
-		enabled: policy.enabled && override.enabled !== false
+		enabled: override.enabled !== false
 	};
 }
 /** 写盘用文档：保留注释与未知字段。 */
 function documentFor(file) {
 	if (!existsSync(file)) {
 		const doc = new Document({});
-		doc.commentBefore = " prompt-tool 指令文件卡策略（独立于预设与 settings）\n enabled: 文件来源是否参与注入（缺省 false，先完成负责人切换再开启）\n defaults: 未单独覆盖的文件使用的行为；files: 按 fileId 的覆盖\n 这里不放正文：正文始终在用户自己的 AGENTS.md/CLAUDE.md 里";
+		doc.commentBefore = " prompt-tool 指令文件卡策略（独立于预设与 settings）\n files: 按 fileId 保存开关和显示名；enabled:false 只拦截后续官方注入\n 这里不放正文：正文始终在用户自己的 AGENTS.md/CLAUDE.md 里";
 		doc.set("schemaVersion", 1);
 		return { doc };
 	}
@@ -2346,19 +2322,28 @@ function writeInstructionPolicy(options) {
 	};
 	const { doc } = prepared;
 	const patch = validated.patch;
-	if (patch.enabled !== void 0) {
-		if (patch.enabled) doc.set("enabled", true);
-		else doc.delete("enabled");
-	}
-	if (patch.defaults !== void 0) {
-		for (const key of VALUE_KEYS) {
-			const value = patch.defaults[key];
-			if (value === void 0) continue;
-			if (value === DEFAULT_VALUES[key]) doc.deleteIn(["defaults", key]);
-			else doc.setIn(["defaults", key], value);
-		}
-		const defaults = doc.get("defaults");
-		if (isMap(defaults) && defaults.items.length === 0) doc.delete("defaults");
+	const existingFiles = doc.get("files");
+	const retiredMaps = new Set(isMap(existingFiles) ? existingFiles.items.flatMap((item) => {
+		const value = item.value;
+		return isMap(value) && RETIRED_FILE_KEYS.some((key) => value.has(key)) ? [value] : [];
+	}) : []);
+	let sharedRetired = false;
+	visit(doc, { Alias(_key, alias) {
+		const target = alias.resolve(doc);
+		if (target === void 0 || !retiredMaps.has(target)) return;
+		sharedRetired = true;
+		return visit.BREAK;
+	} });
+	if (sharedRetired) return {
+		ok: false,
+		status: 400,
+		code: "instructions-policy-invalid",
+		message: "退役指令字段被 YAML alias 共享，无法安全清理；请先解除引用"
+	};
+	doc.delete("enabled");
+	doc.delete("defaults");
+	if (isMap(existingFiles)) {
+		for (const item of existingFiles.items) if (isMap(item.value)) for (const key of RETIRED_FILE_KEYS) item.value.delete(key);
 	}
 	if (patch.files !== void 0) {
 		if (!isMap(doc.get("files"))) doc.setIn(["files"], doc.createNode({}));
@@ -2437,147 +2422,101 @@ function writeInstructionPolicy(options) {
 	};
 }
 //#endregion
-//#region src/runtime/pre-step-coordinator.ts
-/**
-* pre-step 协调器：插件侧的薄装配层，用一个 pre-step 监听器统一执行两类来源。
-*
-*   - 预设来源：各预设 mount 的引擎行（prompt-config-engine）把配置注册到本服务，
-*     作用域与释放仍由注册 ctx（dsh-scope）决定——父/子 scope 继承、兄弟 scope 互不串。
-*     同一 scope 内同名来源再次注册（宿主重挂同一个 preset、HMR 时序下旧 fiber 尚未释放）
-*     时由**后来者接管**：先撤旧登记再插新，绝不让引擎行因重名而挂载失败；
-*   - 独立指令文件来源：本模块按会话工作区现场探测文件、读取独立策略
-*     （`$DSH_HOME/.prompt-tool/instructions.yml`）并编译成同样的提示词配置。
-*
-* 两类来源共用 engine/executor.mjs#runPreStepBatch 这一条批执行算法；本模块只负责
-* 「谁参战」与「参战顺序」：预设来源保留声明顺序，文件卡按全局→项目根→cwd 的探测
-* 顺序追加，最终仍按 order 排序、同值保持声明顺序。
-*
-* 文件版本可见状态（F4）：候选资格 = 文件可读 + 策略启用 + 该 (fileId, revision, epoch)
-* 身份在当前可见上下文里还没有同版本消息。可见性以 `session.deriveMessages()`（当前
-* 模型可见面）为准，缺失时回退「持久日志里最后一次成功 compaction/end 之后的消息」；
-* 因此压缩成功后同版本会重新注入一次，失败压缩不推进 epoch、不重复注入，重挂/恢复
-* 直接从持久记录重建，不依赖进程内已投递集合。
-*
-* 负责人冲突：本 mount 的组合仍挂着官方指令加载行（`@deepseek-ai/dsh-agent-instructions`）
-* 时，独立文件来源整体不参战——同一正文只由一方注入，不同时执行再靠文案去重。
-*/
-/** 协调服务名：引擎行通过 ctx.get 解析本服务决定走管理路径还是独立路径。 */
-const PRE_STEP_COORDINATOR_SERVICE = "promptToolPreStep";
-/** 服务契约版本：引擎与协调器不同步时按「不认识就不接管」处理。 */
-const PRE_STEP_COORDINATOR_VERSION = 1;
-const WARN_LABEL = "prompt-tool:pre-step-coordinator";
-const isRecord$1 = (value) => value !== null && typeof value === "object";
-/** 会话工作区：来自该会话自己的 header.cwd；缺失不拿进程 cwd 兜底。 */
-function sessionCwd(session) {
-	const cwd = isRecord$1(session) && isRecord$1(session.header) ? session.header.cwd : void 0;
-	return typeof cwd === "string" && cwd.length > 0 ? cwd : void 0;
-}
-/**
-* 当前模型可见面的消息。优先 `deriveMessages()`（压缩投影后的真相）；缺失时回退
-* 持久日志里最后一次成功 compaction/end 之后的消息。
-*/
-function visibleMessages(session) {
-	if (isRecord$1(session) && typeof session.deriveMessages === "function") try {
-		const list = session.deriveMessages();
-		if (Array.isArray(list)) return list;
-	} catch {}
-	const events = sessionEvents(session);
-	let boundary = -1;
-	for (const event of events) if (isSuccessfulCompactionEnd(event)) boundary = event?.seq ?? 0;
-	const out = [];
-	for (const event of events) {
-		if ((event?.seq ?? 0) <= boundary) continue;
-		const data = event?.data;
-		if (isRecord$1(data) && isRecord$1(data.source)) out.push(data);
-		if (isRecord$1(data) && isRecord$1(data.message)) out.push(data.message);
-		if (isRecord$1(data) && Array.isArray(data.messages)) out.push(...data.messages);
-		if (isRecord$1(event) && isRecord$1(event.message)) out.push(event.message);
-	}
-	return out;
-}
-const FILE_IDENTITY_PREFIX = "instruction-file:";
-/** 记住的上次探测文件数上限（超限整体清空，只影响失效通知的展示路径）。 */
-const MAX_TRACKED_FILES = 256;
-/** 负责人事实按会话记录的条数上限（超限整体清空，下一次 pre-step 重新填充）。 */
-const MAX_TRACKED_OWNER_SESSIONS = 4096;
+//#region src/runtime/official-instruction-filter.ts
+/** 官方待注入消息的逐文件过滤；不读取或改写会话历史。 */
+const isRecord$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const actionForHeading = (heading) => heading === "Updated instructions from:" ? "replace" : heading === "Instructions removed:" ? "remove" : "set";
 /**
-* 旧版 writePreset 在生成目录里物化的文件卡（id `agents-file-*` / sourceKind
-* `instruction-file`）。独立来源接管后它们不再参战：既有用户目录在重新物化前
-* 仍会带着这些卡，否则同一份正文会被注入两次。
+* 路径来自 source.changes；标题仅用于定位正文，不用于恢复官方加载状态。
+* 重复标题、未知包装或来源与段落不一致时原样放行，避免误删其他文件。
 */
-function isLegacyFileCard(config) {
-	return config.id.startsWith("agents-file-") || config.sourceKind === "instruction-file";
-}
-/** 当前可见面里已存在的文件来源身份（只收本插件命名的身份）。 */
-function visibleFileIdentities(session) {
-	const seen = /* @__PURE__ */ new Set();
-	for (const message of visibleMessages(session)) {
-		const plugin = isRecord$1(message) && isRecord$1(message.source) ? message.source.plugin : void 0;
-		if (typeof plugin === "string" && plugin.startsWith(FILE_IDENTITY_PREFIX)) seen.add(plugin);
-	}
-	return seen;
-}
-/** 文件来源身份：fileId + 内容版本 + 当前 surface epoch 编码进 plugin 命名空间。 */
-function fileIdentity(file, epoch) {
-	if (!file.available) return `${FILE_IDENTITY_PREFIX}${file.fileId}:unavailable:e${Math.max(epoch, 0)}`;
-	return `${FILE_IDENTITY_PREFIX}${file.fileId}:${file.revision.slice(0, 16)}:e${Math.max(epoch, 0)}`;
-}
-/** 某一身份是否属于某个 fileId（含历史版本与失效通知）。 */
-function identityFileId(identity) {
-	return identity.slice(17).split(":")[0] ?? "";
-}
-function messageIdOf(identity) {
-	return identity.replaceAll(":", "-");
-}
-/** 文件候选 → 批执行算法可消费的提示词配置（正文 literal，不经预设变量插值）。 */
-function fileCardConfig(file, identity) {
-	return cardConfig(file, identity, `Instructions from: ${file.displayPath}\n\n${file.text}`);
-}
-/** 失效通知：正文已消失，历史和旧版本仍在会话日志里，不谎称已撤回。 */
-function unavailableCardConfig(file, identity) {
-	const reason = file.reason ?? "文件当前不可读或为空";
-	return cardConfig(file, identity, `Instructions from: ${file.displayPath} are no longer available (${reason}). The previously injected content is stale; do not rely on it.`);
-}
-function cardConfig(file, identity, text) {
-	return {
-		id: `agents-file-${file.fileId}`,
-		layer: "pre-step",
-		enabled: true,
-		order: file.order,
-		position: file.position,
-		promotion: file.promotion,
-		audience: file.audience,
-		modelScope: file.modelScope,
-		role: "user",
-		dedupe: "none",
-		mergeMode: "separate",
-		sourceKind: "instruction-file",
-		form: "instructions",
-		texts: [],
-		params: {},
-		variables: {},
-		identity: {
-			field: "plugin",
-			value: identity
-		},
-		resolve: () => ({
-			id: messageIdOf(identity),
-			content: [{
-				type: "text",
-				text
-			}],
+function filterOfficialInstructionMessages(messages, isDisabled) {
+	const diagnostics = [];
+	let changed = false;
+	const filtered = messages.flatMap((message) => {
+		if (!isRecord$2(message) || !isRecord$2(message.source) || message.source.kind !== "agent-instructions") return [message];
+		const source = message.source;
+		if (!Array.isArray(source.changes)) return [message];
+		const changes = source.changes;
+		const disabled = new Set(changes.flatMap((change) => isRecord$2(change) && typeof change.path === "string" && isDisabled(change.path, source) ? [change.path] : []));
+		if (disabled.size === 0) return [message];
+		const keepOriginal = () => {
+			diagnostics.push(`无法可靠分段官方指令消息 ${String(message.id ?? "")}，已原样放行`);
+			return [message];
+		};
+		if (!changes.every((change) => isRecord$2(change) && typeof change.path === "string" && [
+			"set",
+			"replace",
+			"remove"
+		].includes(change.action)) || !Array.isArray(message.content)) return keepOriginal();
+		const entries = changes;
+		if (source.baseline === true && entries.some((entry) => entry.action === "remove")) return keepOriginal();
+		const counts = /* @__PURE__ */ new Map();
+		const keyOf = (path, action) => `${action}\0${path}`;
+		for (const entry of entries) {
+			const key = keyOf(entry.path, entry.action);
+			counts.set(key, (counts.get(key) ?? 0) + 1);
+		}
+		const paths = new Set(entries.map((entry) => entry.path));
+		const observed = /* @__PURE__ */ new Map();
+		const content = [];
+		for (const block of message.content) {
+			if (!isRecord$2(block) || block.type !== "text" || typeof block.text !== "string") return keepOriginal();
+			const text = block.text;
+			const close = text.lastIndexOf("\n</system-reminder>");
+			if (!text.startsWith("<system-reminder>\n") || close < 0 || text.slice(close) !== "\n</system-reminder>" || text.indexOf("</system-reminder>") !== close + 1) return keepOriginal();
+			const headings = [...text.matchAll(/^(Instructions from:|Additional instructions from:|Updated instructions from:|Instructions removed:) ([^\r\n]+)\r?$/gm)].filter((match) => paths.has(match[2]));
+			for (const heading of headings) {
+				const key = keyOf(heading[2], actionForHeading(heading[1]));
+				const count = (observed.get(key) ?? 0) + 1;
+				if (count > (counts.get(key) ?? 0)) return keepOriginal();
+				observed.set(key, count);
+			}
+			if (!headings.some((heading) => disabled.has(heading[2]))) {
+				content.push(block);
+				continue;
+			}
+			const kept = [];
+			for (const [index, heading] of headings.entries()) {
+				const next = headings[index + 1]?.index;
+				if (next !== void 0 && text.slice(next - 2, next) !== "\n\n") return keepOriginal();
+				if (!disabled.has(heading[2])) kept.push(text.slice(heading.index, next === void 0 ? close : next - 2));
+			}
+			if (kept.length > 0) {
+				const body = text.slice(0, headings[0].index) + kept.join("\n\n");
+				content.push({
+					...block,
+					text: body + text.slice(close)
+				});
+			}
+		}
+		for (const [key, count] of counts) if (observed.get(key) !== count) return keepOriginal();
+		const remaining = entries.filter((entry) => !disabled.has(entry.path));
+		changed = true;
+		if (remaining.length === 0) return [];
+		return [{
+			...message,
+			content,
 			source: {
-				kind: "instruction-file",
-				plugin: identity,
-				form: "instructions"
+				...source,
+				changes: remaining
 			}
-		})
+		}];
+	});
+	return {
+		messages: changed ? filtered : messages,
+		diagnostics
 	};
 }
-/**
-* 独立策略解析（进程内按 mtime+size 缓存）：策略缺失或损坏都返回 undefined，
-* 即「不参战」——不能把损坏的策略文件当成空配置继续注入。
-*/
+//#endregion
+//#region src/runtime/pre-step-coordinator.ts
+/** 模块 pre-step 批执行与官方指令逐文件过滤；正文发现、读取和重注入归官方所有。 */
+const PRE_STEP_COORDINATOR_SERVICE = "promptToolPreStep";
+const PRE_STEP_COORDINATOR_VERSION = 1;
+const WARN_LABEL = "prompt-tool:pre-step-coordinator";
+const MAX_TRACKED_OWNER_SESSIONS = 4096;
+const isRecord$1 = (value) => value !== null && typeof value === "object";
+/** 文件修改时重读；损坏策略不猜，报告诊断并保留官方原消息。 */
 function createPolicyReader(policyFile) {
 	let cached;
 	return () => {
@@ -2585,113 +2524,19 @@ function createPolicyReader(policyFile) {
 		let stamp;
 		try {
 			const info = statSync(path);
-			stamp = `${info.mtimeMs}:${info.size}`;
+			stamp = `${path}:${info.mtimeMs}:${info.ctimeMs}:${info.size}`;
 		} catch {
-			stamp = "missing";
+			stamp = `${path}:missing`;
 		}
-		if (cached !== void 0 && cached.path === path && cached.stamp === stamp) return cached.policy;
-		const read = readInstructionPolicy(path);
-		const policy = read.error === void 0 ? read.policy : void 0;
+		if (cached?.stamp === stamp) return cached.snapshot;
+		const snapshot = readInstructionPolicy(path);
 		cached = {
-			path,
 			stamp,
-			policy
+			snapshot
 		};
-		return policy;
-	};
-}
-/** 缺省文件来源：按会话工作区探测 → 独立策略过滤 → 单次读取形成一致快照。 */
-function defaultCollectFiles(readPolicy, home) {
-	/**
-	* fileId → 上次探测到的展示路径与策略值：文件被删除或移出范围后，用它发一次
-	* 失效通知（是否真发由 fileConfigsFor 按「该会话曾注入过这个文件」判定）。
-	*/
-	const lastSeen = /* @__PURE__ */ new Map();
-	return (_agent, session) => {
-		const policy = readPolicy();
-		if (policy === void 0 || policy.enabled !== true) return [];
-		const cwd = sessionCwd(session);
-		const cards = cwd === void 0 ? detectAgentsFiles({
-			projects: false,
-			home
-		}) : detectAgentsFiles({
-			cwd,
-			home
-		});
-		if (lastSeen.size > MAX_TRACKED_FILES) lastSeen.clear();
-		const out = [];
-		const detected = /* @__PURE__ */ new Set();
-		for (const card of cards) {
-			detected.add(card.fileId);
-			const values = resolveInstructionPolicy(policy, card.fileId);
-			if (!values.enabled) continue;
-			const snapshot = readAgentsFileSnapshot(card);
-			const base = {
-				fileId: card.fileId,
-				displayPath: card.displayPath,
-				order: values.order,
-				position: values.position,
-				promotion: values.promotion,
-				audience: values.audience,
-				modelScope: values.modelScope
-			};
-			lastSeen.set(card.fileId, {
-				displayPath: card.displayPath,
-				values
-			});
-			if (snapshot.status !== "ready" || snapshot.revision === null) {
-				out.push({
-					...base,
-					revision: "unavailable",
-					text: "",
-					available: false,
-					reason: snapshot.message ?? snapshot.status
-				});
-				continue;
-			}
-			const text = snapshot.text.trim();
-			if (text.length === 0) {
-				out.push({
-					...base,
-					revision: "unavailable",
-					text: "",
-					available: false,
-					reason: "file is empty"
-				});
-				continue;
-			}
-			out.push({
-				...base,
-				revision: snapshot.revision,
-				text,
-				available: true
-			});
-		}
-		for (const [fileId, known] of lastSeen) {
-			if (detected.has(fileId)) continue;
-			out.push({
-				fileId,
-				displayPath: known.displayPath,
-				revision: "unavailable",
-				text: "",
-				available: false,
-				reason: "file is missing",
-				order: known.values.order,
-				position: known.values.position,
-				promotion: known.values.promotion,
-				audience: known.values.audience,
-				modelScope: known.values.modelScope
-			});
-		}
-		return out;
+		return snapshot;
 	};
 }
-/**
-* 安装协调器：发布 `promptToolPreStep` 服务并注册唯一的 pre-step 监听器。
-* 普通监听器留在 prepend 门控内侧；来源监听器只登记后交出执行权。
-* 即使服务迟到或重挂，下游的 pre-step 过滤（声明式触发器的 `pre-step-filter` 动作）
-* 仍能在本监听器交出执行权之后过滤最终消息批。
-*/
 function installPreStepCoordinator(ctx, options = {}) {
 	const layers = new ScopedLayers(() => {
 		const entries = new NamedEntries((key) => /* @__PURE__ */ new Error(`prompt-tool: duplicate pre-step source ${key}`));
@@ -2706,61 +2551,62 @@ function installPreStepCoordinator(ctx, options = {}) {
 		withSubagents: createEpochPromotion(PROMOTE_EVENTS.either, { includeSubagents: true })
 	};
 	const memo = /* @__PURE__ */ new Map();
+	const officialOwner = /* @__PURE__ */ new Map();
+	const warnOnce = createWarnOnce(ctx, WARN_LABEL);
+	const readPolicy = createPolicyReader(options.policyFile);
+	let active = true;
+	const filterInstructions = (agent, messages) => {
+		if (!active || !messages.some((message) => isRecord$1(message) && message.source?.kind === "agent-instructions")) return messages;
+		const snapshot = readPolicy();
+		if (snapshot.error !== void 0) {
+			warnOnce(`${WARN_LABEL}: ${snapshot.error}；已放行官方指令`);
+			return messages;
+		}
+		if (!Object.values(snapshot.policy.files).some((file) => file.enabled === false)) return messages;
+		const session = isRecord$1(agent) ? agent.session : void 0;
+		const cwd = isRecord$1(session) && typeof session.header?.cwd === "string" ? session.header.cwd : void 0;
+		let baseline = messages.findLast((message) => isRecord$1(message) && message.source?.kind === "agent-instructions" && message.source.baseline === true);
+		if (baseline === void 0 && isRecord$1(session) && typeof session.deriveMessages === "function") try {
+			const visible = session.deriveMessages();
+			if (Array.isArray(visible)) baseline = visible.findLast((message) => isRecord$1(message) && message.source?.kind === "agent-instructions" && message.source.baseline === true);
+		} catch {
+			warnOnce(`${WARN_LABEL}: 无法确认官方基线项目根，已放行身份不明的项目指令`);
+		}
+		const result = filterOfficialInstructionMessages(messages, (path, source) => {
+			const identity = source.baselineIdentity ?? (isRecord$1(baseline) ? baseline.source.baselineIdentity : void 0);
+			let projectRoot;
+			if (cwd !== void 0 && typeof identity === "string") try {
+				const parsed = JSON.parse(identity);
+				if (isRecord$1(parsed) && typeof parsed.projectRoot === "string" && !parsed.projectRoot.includes("\0")) projectRoot = resolve(cwd, parsed.projectRoot);
+			} catch {}
+			const id = instructionFileIdFromDisplayPath(path, projectRoot, options.home);
+			return id !== void 0 && !resolveInstructionPolicy(snapshot.policy, id).enabled;
+		});
+		for (const diagnostic of result.diagnostics) warnOnce(`${WARN_LABEL}: ${diagnostic}`);
+		return result.messages;
+	};
 	ctx.on("session/event", (session, event) => {
 		promotion.main.observe(session, event);
 		promotion.withSubagents.observe(session, event);
 		confirmDelivered(memo, session, event);
 	});
-	const warnOnce = createWarnOnce(ctx, WARN_LABEL);
-	const officialOwner = /* @__PURE__ */ new Map();
-	const readPolicy = createPolicyReader(options.policyFile);
-	const collectFiles = options.collectFiles ?? defaultCollectFiles(readPolicy, options.home);
-	const fileConfigsFor = (agent, session) => {
-		const contributions = collectFiles(agent, session);
-		if (contributions.length === 0) return [];
-		const visible = visibleFileIdentities(session);
-		const injectedFileIds = new Set([...visible].map(identityFileId));
-		const epoch = promotion.withSubagents.status(agent).boundary;
-		const out = [];
-		for (const file of contributions) {
-			const identity = fileIdentity(file, epoch);
-			if (!file.available && !injectedFileIds.has(file.fileId)) continue;
-			if (visible.has(identity)) continue;
-			out.push(file.available ? fileCardConfig(file, identity) : unavailableCardConfig(file, identity));
-		}
-		return out;
-	};
 	ctx.on("agent/pre-step", async (payload, next) => {
 		const decision = await next();
-		if (!isRecord$1(decision) || decision.kind === "reject") return decision;
+		if (!active || !isRecord$1(decision) || decision.kind === "reject") return decision;
 		const agent = isRecord$1(payload) ? payload.agent : void 0;
 		const session = isRecord$1(agent) ? agent.session : void 0;
 		if (agent === void 0 || session === void 0) return decision;
 		try {
 			const scope = isRecord$1(agent) && agent.ctx !== void 0 ? scopeOf(agent.ctx) : void 0;
 			const sources = [...layers.merge(scope, (layer) => layer.entries).values()];
-			let official = false;
-			const configs = [];
-			for (const source of sources) {
-				if (source.officialInstructions === true) official = true;
-				for (const config of source.configs) {
-					if (isLegacyFileCard(config)) {
-						warnOnce(`${WARN_LABEL}: skipping legacy generated file card ${config.id} (independent file source owns instruction injection)`);
-						continue;
-					}
-					configs.push(config);
-				}
-			}
+			const configs = sources.flatMap((source) => source.configs).filter((config) => !config.id.startsWith("agents-file-") && config.sourceKind !== "instruction-file").sort(compareConfigSequence);
 			const sessionId = isRecord$1(session) && typeof session.id === "string" ? session.id : void 0;
-			const verified = sources.length > 0;
 			if (sessionId !== void 0) {
 				if (officialOwner.size >= MAX_TRACKED_OWNER_SESSIONS) officialOwner.clear();
-				if (verified) officialOwner.set(sessionId, official);
+				if (sources.length > 0) officialOwner.set(sessionId, sources.some((source) => source.officialInstructions === true));
 				else officialOwner.delete(sessionId);
 			}
-			if (verified && !official) configs.push(...fileConfigsFor(agent, session));
-			if (configs.length === 0) return decision;
-			return await runPreStepBatch({
+			return configs.length === 0 ? decision : await runPreStepBatch({
 				ctx,
 				agent,
 				decision,
@@ -2774,12 +2620,23 @@ function installPreStepCoordinator(ctx, options = {}) {
 			return decision;
 		}
 	});
+	ctx.on("agent/pre-step", async (payload, next) => {
+		const decision = await next();
+		if (!active || !isRecord$1(decision) || decision.kind === "reject" || !Array.isArray(decision.messages)) return decision;
+		const messages = filterInstructions(isRecord$1(payload) ? payload.agent : void 0, decision.messages);
+		return messages === decision.messages ? decision : {
+			...decision,
+			messages
+		};
+	}, { prepend: true });
 	ctx.effect(() => () => {
+		active = false;
 		officialOwner.clear();
 		memo.clear();
 	});
 	const service = {
 		version: 1,
+		filterInstructions,
 		registerPreset(sourceCtx, sourceId, source) {
 			const boundSource = {
 				...source,
@@ -2806,9 +2663,7 @@ function installPreStepCoordinator(ctx, options = {}) {
 				};
 			}, { label: `prompt-tool: pre-step source ${sourceId}` });
 		},
-		officialOwnerOf(sessionId) {
-			return officialOwner.get(sessionId);
-		}
+		officialOwnerOf: (sessionId) => officialOwner.get(sessionId)
 	};
 	ctx.provide(PRE_STEP_COORDINATOR_SERVICE, service);
 	return service;
@@ -2941,7 +2796,7 @@ function readImportRequestParams(record) {
 	};
 	if (record.targetId !== void 0 && (typeof record.targetId !== "string" || record.targetId.length > 128 || !/^[a-z0-9][a-z0-9-]*$/.test(record.targetId))) return {
 		ok: false,
-		message: "targetId 必须是合法小写预设 ID（最多 128 字符）"
+		message: "targetId 必须是合法小写模块 ID（最多 128 字符）"
 	};
 	if (record.targetName !== void 0 && (typeof record.targetName !== "string" || record.targetName.trim().length === 0 || record.targetName.length > 256)) return {
 		ok: false,
@@ -3041,7 +2896,7 @@ function withSnapshot(card, file) {
 	};
 }
 /**
-* 两类卡合并：预设卡原样保留，文件卡换成本次工作区的文件快照。
+* 两类卡合并：模块卡原样保留，文件卡换成本次工作区的文件快照。
 * 生成目录里属于其他工作区的文件卡不再展示（写盘白名单也不含它们）；
 * 当前工作区里没有对应生成卡的文件按默认文件卡补齐。
 */
@@ -3101,8 +2956,8 @@ function projectToolSchemas(schemas) {
 	}
 	return [...unique.values()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
 }
-function isEditablePresetDir(dir, presetRoot = userPresetsDir()) {
-	const root = resolve(presetRoot);
+function isEditablePresetDir(dir, moduleRoot = userModulesDir()) {
+	const root = resolve(moduleRoot);
 	const target = resolve(dir);
 	return target !== root && target.startsWith(root + sep);
 }
@@ -3111,7 +2966,7 @@ function guardEditablePresetDir(dir, res) {
 	writeBridgeJson(res, 403, {
 		ok: false,
 		code: "preset-readonly",
-		message: "system preset 只读，请先复制为用户预设"
+		message: "system preset 只读，请先复制为用户模块"
 	});
 	return false;
 }
@@ -3205,7 +3060,7 @@ function uploadFileName(req) {
 		throw new Error("上传文件名编码无效");
 	}
 }
-/** 自定义工具声明需要的预设模块（模块缺失时保存动作自动补齐）。 */
+/** 自定义工具声明需要的模块（模块缺失时保存动作自动补齐）。 */
 function customToolModules(tools) {
 	const modules = /* @__PURE__ */ new Set();
 	if (tools.length > 0) modules.add("tool-config-engine");
@@ -3227,19 +3082,28 @@ function customToolModules(tools) {
 function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngineStrategyDir, afterSkillsChange, getPresetConfigsDir, afterPresetImport, afterOverridesChange, afterPresetPackageImport, afterCapabilityChange, afterPresetListChange) {
 	let invalidateCachedDescriptor = () => {};
 	let capabilityQueue = Promise.resolve();
-	const refreshPresetList = async () => {
+	let moduleOrderQueue = Promise.resolve();
+	/** 写盘已完成：等待重建，失败立即返回统一错误，不覆盖持久化结果。 */
+	const finishPresetChange = async (res, activate) => {
 		try {
-			await afterPresetListChange?.();
+			await activate();
+			return true;
 		} catch (error) {
-			ctx.logger?.warn(`prompt-tool: 预设目录已更新，但注册刷新失败：${String(error)}`);
+			writeBridgeJson(res, 500, {
+				ok: false,
+				code: PRESET_ACTIVATION_FAILED,
+				message: `更改已保存，但模块未生效；请重试：${String(error)}`
+			});
+			return false;
 		}
 	};
-	/** 等待当前预设重建；不传播附加回调的返回值。 */
-	const runOverridesChange = async () => {
-		try {
-			await afterOverridesChange?.();
-		} catch {}
-	};
+	const runOverridesChange = (res, moduleId) => finishPresetChange(res, () => afterOverridesChange?.(moduleId));
+	/**
+	* 本次请求的编辑目标目录：读 `x-module-id` 头（形状不合法当未声明），交给注入的实现定位。
+	* 所有「读/写哪个模块的配置」都走这里，端点不再各自记一个全局目标。
+	*/
+	const editDir = (req) => getPresetConfigsDir?.(readEditTarget(req.headers["x-module-id"])) ?? "";
+	const refreshPresetList = (res, id) => finishPresetChange(res, () => afterPresetListChange?.(id));
 	ctx.inject(["settings", "webServer"], (sctx) => {
 		sctx.effect(() => {
 			const assetSources = createAssetSources(join(DSH_HOME, ".prompt-tool-uploads"));
@@ -3253,6 +3117,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				cachedAt = now;
 				return cachedDescriptor;
 			};
+			/** 已解析的编辑目标只投影到本次响应，不改宿主设置或缓存描述符。 */
+			const descriptorForTarget = (descriptor, dir) => dir.length === 0 ? descriptor : {
+				...descriptor,
+				value: {
+					...asRecord(descriptor.value),
+					presetTemplate: basename(dir)
+				}
+			};
 			/** mutate 成功后强制失效，下次 findDescriptor 重查宿主（响应必须带新 view）。 */
 			const invalidateDescriptor = () => {
 				cachedDescriptor = void 0;
@@ -3280,29 +3152,36 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			const guardPresetFormat = (dir, res) => {
 				if (dir.length === 0) return true;
 				try {
-					loadPresetSpec(dir);
+					loadModuleSpec(dir);
 				} catch (error) {
 					if (writeLayerSettingsError(res, error)) return false;
 				}
 				return true;
 			};
 			const guardPresetWrite = (dir, res) => guardEditablePresetDir(dir, res) && guardPresetFormat(dir, res);
-			/** 预设身份只作一致性检查，绝不用客户端 ID 构造写入路径。 */
-			const guardPresetIdentity = (record, dir, res) => {
+			const writeModuleOrderError = (res, error) => {
+				writeBridgeJson(res, error instanceof ModuleConfigOrderError ? error.status : 500, {
+					ok: false,
+					code: error instanceof ModuleConfigOrderError ? error.code : "module-config-order-failed",
+					message: String(error?.message ?? error)
+				});
+			};
+			/** 模块身份只作一致性检查，绝不用客户端 ID 构造写入路径。 */
+			const guardPresetIdentity = (req, record, dir, res) => {
 				const expected = 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"
+						message: "expectedPresetId 必须是非空模块 ID"
 					});
 					return false;
 				}
-				if ((getPresetConfigsDir?.() ?? "") !== dir || expected !== void 0 && expected !== basename(dir)) {
+				if (editDir(req) !== dir || expected !== void 0 && expected !== basename(dir)) {
 					writeBridgeJson(res, 409, {
 						ok: false,
 						code: "preset-changed",
-						message: "当前预设已切换；旧草稿未写入，请重新读取后保存"
+						message: "当前模块已切换；旧草稿未写入，请重新读取后保存"
 					});
 					return false;
 				}
@@ -3314,7 +3193,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			const loadEngineMeta = async () => {
 				const { getEngineMeta } = await import(pathToFileURL(join(packageEngineDir(), "schema.mjs")).href);
 				const meta = getEngineMeta();
-				meta.presets = listPresets();
+				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) => ({
+					...preset,
+					enabled: enabledSet.has(preset.id),
+					...diagnostics.get(preset.id) === void 0 ? {} : { broken: diagnostics.get(preset.id) }
+				}));
 				meta.builtinTemplates = listBuiltinTemplates();
 				meta.editorGroups = ENGINE_EDITOR_GROUP_MAP.map(({ id, displayLayer, relatedLayers, hook }) => ({
 					id,
@@ -3333,7 +3220,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				return meta;
 			};
 			/** describe 运行时事实（describe 端点与 /bootstrap 共用）：检测状态、技能快照、
-			*  宿主默认模型、模型目录缓存、激活预设参数。不触网（模型目录只读 10min 缓存）。 */
+			*  宿主默认模型、模型目录缓存、激活模块参数。不触网（模型目录只读 10min 缓存）。 */
 			const collectSkills = async (sessionId) => {
 				const cwd = sessionId === void 0 ? void 0 : localAgentCwd(sctx, sessionId);
 				const agents = sctx.get?.("agents");
@@ -3367,7 +3254,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					};
 				}
 			};
-			const collectDescribeExtras = async (sessionId) => {
+			const collectDescribeExtras = async (activeDir, sessionId) => {
 				const detection = getModelsState();
 				const skillsState = getSkillsState();
 				const skillsSnapshot = await collectSkills(sessionId);
@@ -3389,18 +3276,18 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				let moduleFacts;
 				let templatePreStepCount = 0;
 				try {
-					const activeDir = getPresetConfigsDir?.() ?? "";
-					const templateName = activeDir.length > 0 ? basename(activeDir) : DEFAULT_PRESET_ID;
-					const spec = loadPresetSpec(activeDir.length > 0 ? activeDir : resolvePresetDir(templateName));
+					const templateName = activeDir.length > 0 ? basename(activeDir) : DEFAULT_MODULE_ID;
+					const spec = loadModuleSpec(activeDir.length > 0 ? activeDir : resolveModuleDir(templateName));
 					presetParams = resolvePresetParams(spec, {});
-					const resolvedFacts = resolvePresetModuleFacts(spec, activeDir.length > 0 ? activeDir : void 0, isEditablePresetDir(activeDir.length > 0 ? activeDir : resolvePresetDir(templateName)));
+					const resolvedFacts = resolveModuleFacts(spec, activeDir.length > 0 ? activeDir : void 0, isEditablePresetDir(activeDir.length > 0 ? activeDir : resolveModuleDir(templateName)));
 					mergeModuleConfigFallbacks(presetParams, resolvedFacts);
 					moduleFacts = {
 						declaredModules: resolvedFacts.declaredModules,
 						effectiveModules: resolvedFacts.effectiveModules,
 						rowIds: resolvedFacts.rowIds,
 						sourceMode: resolvedFacts.sourceMode,
-						editable: resolvedFacts.editable
+						editable: resolvedFacts.editable,
+						subagentToolPolicyEnabled: resolvedFacts.subagentToolPolicyEnabled === true
 					};
 					if (Array.isArray(spec.promptConfigs)) presetParams.promptConfigs = spec.promptConfigs;
 					templatePreStepCount = (spec.promptConfigs ?? []).filter((config) => {
@@ -3426,10 +3313,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					skillFolders: skillsState.folders
 				};
 			};
-			/** 激活预设的引擎参数子集（/param-overrides 读取；preset.yml 按 mtime 缓存）。 */
+			/** 激活模块的引擎参数子集（/param-overrides 读取；preset.yml 按 mtime 缓存）。 */
 			const readParamOverrides = (dir) => {
 				try {
-					const spec = loadPresetSpec(dir);
+					const spec = loadModuleSpec(dir);
 					const params = {};
 					for (const key of PARAM_KEYS) {
 						if (key === "promptConfigs") continue;
@@ -3441,10 +3328,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					return {};
 				}
 			};
-			/** 预设级模板变量（/preset-variables 读取）。 */
+			/** 模块级模板变量（/preset-variables 读取）。 */
 			const readPresetVariables = (dir) => {
 				try {
-					const spec = loadPresetSpec(dir);
+					const spec = loadModuleSpec(dir);
 					const variables = {};
 					for (const [key, value] of Object.entries(spec.variables ?? {})) if (typeof value === "string") variables[key] = value;
 					return {
@@ -3462,13 +3349,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 			/** 生成目录实际生效配置（/prompt-configs 读取）。 */
 			const readPromptConfigs = (dir) => {
 				try {
-					return dir.length > 0 ? listPromptConfigSpecs(join(dir, "prompt-configs")).map((config) => {
+					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 }
+							...fieldSources === void 0 ? {} : { fieldSources },
+							...Object.hasOwn(order, config.id) ? { sequence: order[config.id] } : {}
 						};
 					}) : [];
 				} catch {
@@ -3482,6 +3371,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.bootstrap,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
+						const dir = editDir(req);
 						const descriptor = findDescriptor();
 						if (descriptor === void 0) {
 							writeBridgeJson(res, 404, {
@@ -3504,12 +3394,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						try {
 							const meta = await loadEngineMeta();
-							const dir = getPresetConfigsDir?.() ?? "";
-							const extras = await collectDescribeExtras(session.sessionId);
+							const extras = await collectDescribeExtras(dir, session.sessionId);
 							const scope = resolveInstructionScope(sctx, session.sessionId);
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: descriptor,
+								value: descriptorForTarget(descriptor, dir),
 								meta: { meta },
 								overrides: { overrides: dir.length > 0 ? readParamOverrides(dir) : {} },
 								variables: dir.length > 0 ? readPresetVariables(dir) : {
@@ -3539,10 +3428,18 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.meta,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						writeBridgeJson(res, 200, {
-							ok: true,
-							value: { meta: await loadEngineMeta() }
-						});
+						try {
+							writeBridgeJson(res, 200, {
+								ok: true,
+								value: { meta: await loadEngineMeta() }
+							});
+						} catch (error) {
+							writeBridgeJson(res, 503, {
+								ok: false,
+								code: "meta-unavailable",
+								message: String(error)
+							});
+						}
 					}
 				}),
 				sctx.webServer.register({
@@ -3550,6 +3447,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.describe,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
+						const dir = editDir(req);
 						const descriptor = findDescriptor();
 						if (descriptor === void 0) {
 							writeBridgeJson(res, 404, {
@@ -3562,8 +3460,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						try {
 							writeBridgeJson(res, 200, {
 								ok: true,
-								value: descriptor,
-								...await collectDescribeExtras()
+								value: descriptorForTarget(descriptor, dir),
+								...await collectDescribeExtras(dir)
 							});
 						} catch (error) {
 							if (!writeLayerSettingsError(res, error)) throw error;
@@ -3650,7 +3548,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "settings-rejected",
-								message: "引擎参数按预设存储：请用设置页保存（/param-overrides），settings 只接受全局开关"
+								message: "引擎参数按模块存储：请用设置页保存（/param-overrides），settings 只接受全局开关"
 							});
 							return;
 						}
@@ -3710,7 +3608,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							ok: true,
 							value: await validatePromptConfigs(record.promptConfigs, {
 								strategyDir: getEngineStrategyDir(),
-								presetDir: getPresetConfigsDir?.()
+								moduleDir: editDir(req)
 							})
 						});
 					}
@@ -4072,7 +3970,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (!guardPresetFormat(dir, res)) return;
 						const scope = resolveInstructionScope(sctx, session.sessionId);
 						writeBridgeJson(res, 200, {
@@ -4239,7 +4137,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const { body } = parsedBody;
 						const scope = (body ?? {}).scope === "agents" ? "agents" : "preset";
 						try {
-							const dir = getPresetConfigsDir?.() ?? "";
+							const dir = editDir(req) ?? "";
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { content: dir.length > 0 ? readFileSync(join(dir, scope === "preset" ? "preset.md" : "agents.md"), "utf8") : "" }
@@ -4301,21 +4199,21 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								content: item.content
 							});
 						}
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
 						if (!guardPresetWrite(dir, res)) return;
 						try {
-							if (!guardPresetIdentity(record, dir, res)) return;
+							if (!guardPresetIdentity(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");
-							afterPresetImport?.(contents.map((entry) => entry.scope));
+							if (!await finishPresetChange(res, () => afterPresetImport?.(contents.map((entry) => entry.scope), basename(dir)))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { scopes: contents.map((entry) => entry.scope) }
@@ -4334,12 +4232,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.triggers,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "当前预设目录不可用"
+								message: "当前模块目录不可用"
 							});
 							return;
 						}
@@ -4355,11 +4253,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "triggers-invalid",
-								message: "声明请求字段、预设身份或版本格式不合法"
+								message: "声明请求字段、模块身份或版本格式不合法"
 							});
 							return;
 						}
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						const writing = record.triggers !== void 0 && record.validateOnly !== true;
 						if (writing && typeof record.expectedRevision !== "string") {
 							writeBridgeJson(res, 400, {
@@ -4373,10 +4271,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						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(record, dir, res)) return;
-							const snapshot = readPresetTriggers(dir);
+							if (!guardPresetIdentity(req, record, dir, res)) return;
+							const snapshot = readModuleTriggers(dir);
 							if (record.triggers !== void 0) try {
-								const strategy = loadPresetSpec(dir).moduleConfigs?.["declared-triggers"]?.strategyDir;
+								const strategy = loadModuleSpec(dir).moduleConfigs?.["declared-triggers"]?.strategyDir;
 								compileDeclarations(record.triggers, { promptConfigOptions: triggerPromptConfigOptions(dir, strategy) });
 							} catch (error) {
 								writeBridgeJson(res, 400, {
@@ -4387,7 +4285,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								return;
 							}
 							if (writing) {
-								if (!Array.isArray(loadPresetSpec(dir).modules)) {
+								if (!Array.isArray(loadModuleSpec(dir).modules)) {
 									writeBridgeJson(res, 400, {
 										ok: false,
 										code: "triggers-composition-readonly",
@@ -4395,26 +4293,26 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									});
 									return;
 								}
-								if (!savePresetTriggers(dir, record.triggers, record.expectedRevision)) {
+								if (!saveModuleTriggers(dir, record.triggers, record.expectedRevision)) {
 									writeBridgeJson(res, 409, {
 										ok: false,
 										code: "triggers-conflict",
-										message: "预设文件已变化；草稿未写入，请重新读取后保存"
+										message: "模块文件已变化；草稿未写入，请重新读取后保存"
 									});
 									return;
 								}
 								try {
-									await afterOverridesChange?.();
+									await afterOverridesChange?.(basename(dir));
 								} catch (error) {
 									writeBridgeJson(res, 500, {
 										ok: false,
 										code: "triggers-rebuild-failed",
-										message: `声明已保存，但预设重建失败；请重新读取后重试：${String(error)}`
+										message: `声明已保存，但模块重建失败；请重新读取后重试：${String(error)}`
 									});
 									return;
 								}
 							}
-							const result = writing ? readPresetTriggers(dir) : snapshot;
+							const result = writing ? readModuleTriggers(dir) : snapshot;
 							if (writing && !isDeepStrictEqual(result.triggers, record.triggers)) {
 								writeBridgeJson(res, 409, {
 									ok: false,
@@ -4445,22 +4343,22 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.paramOverrides,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
-						const presetRoot = dirname(dir);
+						const moduleRoot = dirname(dir);
 						const templateName = basename(dir);
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						if (record.rebuild !== void 0 && typeof record.rebuild !== "boolean") {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -4527,7 +4425,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							if (Array.isArray(record.promptConfigs)) {
 								const validation = await validatePromptConfigs(record.promptConfigs, {
 									strategyDir: getEngineStrategyDir(),
-									presetDir: dir
+									moduleDir: dir
 								});
 								if (!validation.valid) {
 									writeBridgeJson(res, 400, {
@@ -4537,7 +4435,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									});
 									return;
 								}
-								const spec = loadPresetSpec(dir);
+								const spec = loadModuleSpec(dir);
 								const conflicting = record.promptConfigs.some((config) => {
 									if (config === null || typeof config !== "object" || Array.isArray(config)) return false;
 									const entry = config;
@@ -4552,9 +4450,9 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									return;
 								}
 							}
-							if (!guardPresetIdentity(record, dir, res)) return;
-							savePresetParams(presetRoot, templateName, rawOverrides, record.promptConfigs);
-							if (record.rebuild !== false) await runOverridesChange();
+							if (!guardPresetIdentity(req, record, dir, res)) return;
+							saveModuleParams(moduleRoot, templateName, rawOverrides, record.promptConfigs);
+							if (record.rebuild !== false && !await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
@@ -4577,22 +4475,22 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetVariables,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
-						const presetRoot = dirname(dir);
+						const moduleRoot = dirname(dir);
 						const templateName = basename(dir);
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						if (record.variables === void 0 && record.enabled === void 0) {
 							writeBridgeJson(res, 200, {
 								ok: true,
@@ -4618,9 +4516,9 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						if (!guardPresetWrite(dir, res)) return;
 						try {
-							if (!guardPresetIdentity(record, dir, res)) return;
-							savePresetParams(presetRoot, templateName, void 0, void 0, record.variables, record.enabled);
-							runOverridesChange();
+							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;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { variables: record.variables }
@@ -4639,12 +4537,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.customTools,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -4652,10 +4550,10 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						if (record.customTools === void 0) {
 							try {
-								const spec = loadPresetSpec(dir);
+								const spec = loadModuleSpec(dir);
 								writeBridgeJson(res, 200, {
 									ok: true,
 									value: { customTools: Array.isArray(spec.customTools) ? spec.customTools : [] }
@@ -4690,7 +4588,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								return;
 							}
 							if (!guardPresetWrite(dir, res)) return;
-							if (!guardPresetIdentity(record, dir, res)) return;
+							if (!guardPresetIdentity(req, record, dir, res)) return;
 							withPresetDoc(dir, (doc) => {
 								if (customTools.length === 0) doc.deleteIn(["customTools"]);
 								else {
@@ -4698,7 +4596,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									appendPresetModules(doc, customToolModules(customTools));
 								}
 							});
-							runOverridesChange();
+							if (!await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { customTools }
@@ -4717,24 +4615,24 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.persona,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const record = parsedBody.body ?? {};
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						if (record.persona === void 0) {
 							try {
 								writeBridgeJson(res, 200, {
 									ok: true,
-									value: { persona: readPersonaSpec(loadPresetSpec(dir).persona) ?? null }
+									value: { persona: readPersonaSpec(loadModuleSpec(dir).persona) ?? null }
 								});
 							} catch (error) {
 								if (writeLayerSettingsError(res, error)) return;
@@ -4758,7 +4656,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								return;
 							}
 							if (persona?.complete === true) {
-								if ((loadPresetSpec(dir).promptConfigs ?? []).some((config) => {
+								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;
@@ -4772,7 +4670,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								}
 							}
 							savePresetPersona(dirname(dir), basename(dir), persona);
-							runOverridesChange();
+							if (!await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: { persona }
@@ -4864,7 +4762,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						try {
 							const files = await expandPresetSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
-							const preview = presetImportPreview(userPresetsDir(), files, request.params);
+							const preview = presetImportPreview(userModulesDir(), files, request.params);
 							if (!("prepared" in preview)) {
 								if (!request.params.preview) throw new Error("请先选择内容类型或提示顺序组并重新预览");
 								writeBridgeJson(res, 200, {
@@ -4891,21 +4789,15 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							const installed = await installPresetPackage(userPresetsDir(), files, request.params);
+							const installed = await installPresetPackage(userModulesDir(), files, request.params);
 							invalidateDescriptor();
-							let refreshWarning;
-							try {
-								await afterPresetPackageImport?.(installed.id);
-							} catch (error) {
-								refreshWarning = `预设已安装，但刷新失败：${error instanceof Error ? error.message : String(error)}`;
-							}
+							if (!await finishPresetChange(res, () => afterPresetPackageImport?.(installed.id))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
 									...installed,
 									sourceDigest,
-									...prepared.report === void 0 ? {} : { report: prepared.report },
-									...refreshWarning === void 0 ? {} : { refreshWarning }
+									...prepared.report === void 0 ? {} : { report: prepared.report }
 								}
 							});
 						} catch (error) {
@@ -4937,14 +4829,14 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							]);
 							if (Object.keys(record).some((key) => !allowed.has(key))) throw new Error("导出请求包含未知字段");
 							assertPresetId(record.id);
-							if (record.id.length > 128) throw new Error("预设 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 必须是布尔值");
 							if (record.expectedRevision !== void 0 && (typeof record.expectedRevision !== "string" || !SHA256_HEX_RE.test(record.expectedRevision))) throw new Error("expectedRevision 必须是 SHA-256 摘要");
 							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(userPresetsDir(), record)
+								value: await exportPresetPackage(userModulesDir(), record)
 							});
 						} catch (error) {
 							const message = error instanceof Error ? error.message : String(error);
@@ -4959,7 +4851,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetDelete,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleDelete,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -4971,19 +4863,16 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-delete-rejected",
-								message: "缺少预设 id"
+								message: "缺少模块 id"
 							});
 							return;
 						}
-						const descriptor = findDescriptor();
-						const value = descriptor?.value ?? {};
-						const base = descriptor?.base ?? {};
-						const active = typeof value.presetTemplate === "string" ? value.presetTemplate : typeof base.presetTemplate === "string" ? base.presetTemplate : void 0;
-						if (typeof active === "string" && active.length > 0 && active === id) {
+						const activeDir = editDir(req);
+						if (activeDir.length > 0 && basename(activeDir) === id) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-in-use",
-								message: `预设「${id}」正在使用中，请先切换其他预设再删除`
+								message: `模块「${id}」正在使用中，请先切换其他模块再删除`
 							});
 							return;
 						}
@@ -4996,7 +4885,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						await refreshPresetList();
+						if (!await refreshPresetList(res, id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id }
@@ -5005,7 +4894,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetClone,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleClone,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -5017,7 +4906,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-clone-rejected",
-								message: "缺少预设 id"
+								message: "缺少模块 id"
 							});
 							return;
 						}
@@ -5030,7 +4919,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						await refreshPresetList();
+						if (!await refreshPresetList(res, result.id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id: result.id }
@@ -5039,7 +4928,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetDuplicate,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleDuplicate,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -5051,11 +4940,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-duplicate-rejected",
-								message: "缺少预设 id"
+								message: "缺少模块 id"
 							});
 							return;
 						}
-						const result = duplicateUserPreset(id);
+						const result = duplicateUserModule(id);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -5064,7 +4953,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						await refreshPresetList();
+						if (!await refreshPresetList(res, result.id)) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: { id: result.id }
@@ -5073,7 +4962,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 				}),
 				sctx.webServer.register({
 					kind: "exact",
-					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.presetOpen,
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleOpen,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
 						const parsedBody = await readBridgeBodyForHandler(req, res);
@@ -5085,11 +4974,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-open-rejected",
-								message: "缺少预设 id"
+								message: "缺少模块 id"
 							});
 							return;
 						}
-						const result = openPresetLocation(id);
+						const result = openModuleLocation(id);
 						if (!result.ok) {
 							writeBridgeJson(res, 400, {
 								ok: false,
@@ -5104,17 +4993,109 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						});
 					}
 				}),
+				sctx.webServer.register({
+					kind: "exact",
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleEnable,
+					handler: async (req, res) => {
+						if (!guard(req, res)) 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: "preset-enable-rejected",
+								message: "缺少模块 id"
+							});
+							return;
+						}
+						if (typeof record.enabled !== "boolean") {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "preset-enable-rejected",
+								message: "enabled 必须是布尔值"
+							});
+							return;
+						}
+						if (record.enabled && !moduleDirExists(userModulesDir(), id)) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "preset-enable-rejected",
+								message: `模块 ${id} 不存在`
+							});
+							return;
+						}
+						const enabled = record.enabled;
+						const run = moduleOrderQueue.then(async () => {
+							try {
+								if (enabled) {
+									const changed = appendModuleConfigOrder(userModulesDir(), id);
+									if (!changed.includes(id) && !enabledModuleIds(userModulesDir()).includes(id) && readModuleConfigOrder(userModulesDir(), id).entries.length > 0) changed.push(id);
+									for (const changedId of changed) if (!await runOverridesChange(res, changedId)) return;
+								}
+								setModuleEnabled(userModulesDir(), id, enabled);
+								if (!await runOverridesChange(res)) return;
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: { enabled: enabledModuleIds(userModulesDir()) }
+								});
+							} catch (error) {
+								writeModuleOrderError(res, error);
+							}
+						});
+						moduleOrderQueue = run.catch(() => {});
+						await run;
+					}
+				}),
+				sctx.webServer.register({
+					kind: "exact",
+					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.moduleConfigOrder,
+					handler: async (req, res) => {
+						if (!guard(req, res)) return;
+						const parsed = await readBridgeBodyForHandler(req, res);
+						if (parsed === void 0) return;
+						const body = parsed.body;
+						const writing = isRecord(body) && (body.entries !== void 0 || body.expectedRevision !== void 0);
+						if (body !== void 0 && (!isRecord(body) || Object.keys(body).some((key) => key !== "moduleId" && key !== "entries" && key !== "expectedRevision") || body.moduleId !== void 0 && (typeof body.moduleId !== "string" || readEditTarget(body.moduleId) !== body.moduleId) || writing && (typeof body.expectedRevision !== "string" || !SHA256_HEX_RE.test(body.expectedRevision) || !Array.isArray(body.entries) || body.entries.some((entry) => !isRecord(entry) || Object.keys(entry).some((key) => key !== "moduleId" && key !== "configId") || typeof entry.moduleId !== "string" || readEditTarget(entry.moduleId) !== entry.moduleId || typeof entry.configId !== "string" || entry.configId.length === 0 || entry.configId.length > 256)))) {
+							writeBridgeJson(res, 400, {
+								ok: false,
+								code: "module-config-order-invalid",
+								message: "排序只接受配置身份列表和读取时的版本"
+							});
+							return;
+						}
+						const run = moduleOrderQueue.then(async () => {
+							try {
+								const moduleId = isRecord(body) ? body.moduleId : void 0;
+								if (writing) {
+									const changedIds = saveModuleConfigOrder(userModulesDir(), body.expectedRevision, body.entries, moduleId);
+									for (const id of changedIds) if (!await runOverridesChange(res, id)) return;
+								}
+								writeBridgeJson(res, 200, {
+									ok: true,
+									value: readModuleConfigOrder(userModulesDir(), moduleId)
+								});
+							} catch (error) {
+								writeModuleOrderError(res, error);
+							}
+						});
+						moduleOrderQueue = run.catch(() => {});
+						await run;
+					}
+				}),
 				sctx.webServer.register({
 					kind: "exact",
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersImport,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5142,11 +5123,11 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (!guardPresetWrite(dir, res)) return;
 						try {
 							const files = await expandPresetSource(request.params.sourceId === void 0 ? readBridgeFiles(record.files) : assetSources.read(request.params.sourceId));
-							if (getPresetConfigsDir?.() !== dir) {
+							if (editDir(req) !== dir) {
 								writeBridgeJson(res, 409, {
 									ok: false,
 									code: "characters-preview-stale",
-									message: "当前预设已切换，请重新预览"
+									message: "当前模块已切换，请重新预览"
 								});
 								return;
 							}
@@ -5162,8 +5143,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							const root = canonicalPresetRoot(userPresetsDir());
-							if (assertPresetDirectory(root, basename(dir)) !== realpathSync(dir)) throw new Error("当前预设不属于可写的官方预设根");
+							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) {
@@ -5276,12 +5257,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersList,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5296,12 +5277,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersDelete,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5339,12 +5320,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersApply,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5371,7 +5352,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						runOverridesChange();
+						if (!await runOverridesChange(res, basename(dir))) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: {
@@ -5386,12 +5367,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.charactersRemove,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5418,7 +5399,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							});
 							return;
 						}
-						runOverridesChange();
+						if (!await runOverridesChange(res, basename(dir))) return;
 						writeBridgeJson(res, 200, {
 							ok: true,
 							value: {
@@ -5433,12 +5414,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.subagentToolPolicy,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5446,12 +5427,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						if (parsedBody === void 0) return;
 						const { body } = parsedBody;
 						const record = body ?? {};
-						if (!guardPresetIdentity(record, dir, res)) return;
+						if (!guardPresetIdentity(req, record, dir, res)) return;
 						if (record.policy === void 0) {
 							try {
 								writeBridgeJson(res, 200, {
 									ok: true,
-									value: { policy: loadPresetSpec(dir).subagentToolPolicy ?? null }
+									value: { policy: loadModuleSpec(dir).subagentToolPolicy ?? null }
 								});
 							} catch (error) {
 								if (writeLayerSettingsError(res, error)) return;
@@ -5477,7 +5458,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 								});
 								return;
 							}
-							if (!guardPresetIdentity(record, dir, res)) return;
+							if (!guardPresetIdentity(req, record, dir, res)) return;
 							withPresetDoc(dir, (doc) => {
 								if (isEmpty) doc.deleteIn(["subagentToolPolicy"]);
 								else {
@@ -5485,7 +5466,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									appendPresetModules(doc, ["subagent-tool-policy"]);
 								}
 							});
-							runOverridesChange();
+							if (!await runOverridesChange(res, basename(dir))) return;
 							writeBridgeJson(res, 200, {
 								ok: true,
 								value: {
@@ -5507,12 +5488,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.subagentToolPolicyPreview,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
@@ -5521,12 +5502,12 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						const { body } = parsedBody;
 						const record = body ?? {};
 						try {
-							const spec = loadPresetSpec(dir);
+							const spec = loadModuleSpec(dir);
 							if (spec.subagentToolPolicy === void 0 || spec.subagentToolPolicy === null) {
 								writeBridgeJson(res, 400, {
 									ok: false,
 									code: "subagent-tool-policy-missing",
-									message: "当前预设未配置 subagentToolPolicy"
+									message: "当前模块未配置 subagentToolPolicy"
 								});
 								return;
 							}
@@ -5560,19 +5541,19 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 					path: SETTINGS_BRIDGE_PREFIX + BRIDGE_ENDPOINTS.engineCapability,
 					handler: async (req, res) => {
 						if (!guard(req, res)) return;
-						const dir = getPresetConfigsDir?.() ?? "";
+						const dir = editDir(req) ?? "";
 						if (dir.length === 0) {
 							writeBridgeJson(res, 400, {
 								ok: false,
 								code: "preset-dir-unavailable",
-								message: "presetDir 未配置"
+								message: "模块目录未配置"
 							});
 							return;
 						}
 						const parsedBody = await readBridgeBodyForHandler(req, res);
 						if (parsedBody === void 0) return;
 						const body = asRecord(parsedBody.body);
-						if (!guardPresetIdentity(body, dir, res)) return;
+						if (!guardPresetIdentity(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) {
@@ -5585,8 +5566,8 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 						}
 						if (!guardPresetWrite(dir, res)) return;
 						const run = capabilityQueue.then(async () => {
-							if (!guardPresetIdentity(body, dir, res)) return;
-							const file = join(dir, "preset.yml");
+							if (!guardPresetIdentity(req, body, dir, res)) return;
+							const file = join(dir, MODULE_DEFINITION_FILE);
 							let original;
 							try {
 								original = readFileSync(file, "utf8");
@@ -5597,7 +5578,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 									action: "create-recipe",
 									recipeId: id.trim()
 								});
-								if (result.changed) afterCapabilityChange?.();
+								if (result.changed && !await finishPresetChange(res, () => afterCapabilityChange?.(basename(dir)))) return;
 								writeBridgeJson(res, 200, {
 									ok: true,
 									value: result
@@ -5605,7 +5586,7 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 							} catch (error) {
 								if (original !== void 0) try {
 									atomicWriteTextFile(file, original);
-									invalidatePresetSpec(dir);
+									invalidateModuleSpec(dir);
 								} catch {}
 								writeBridgeJson(res, 409, {
 									ok: false,
@@ -5821,18 +5802,48 @@ function registerSettingsBridge(ctx, ns, getModelsState, getSkillsState, getEngi
 	return { invalidateDescriptor: () => invalidateCachedDescriptor() };
 }
 //#endregion
+//#region src/host/module-tool-target.ts
+/**
+* 工具目标来自执行 Agent 的**运行时配装记录**：这个 Agent 实际装上了哪几层提示词。
+*
+* 不再查询宿主 `agentPresets.composedPreset()`——模块与官方预设已解耦，会话绑定哪个
+* 官方预设与本插件的写入目标无关（那正是「装的是 A 的提示词、工具却写进 B」的成因）。
+* 装了多层时取启用表里的第一个，与配装顺序同源。
+*
+* 目标 id 只来自装配记录（宿主 `agent/created` 事件建立），**不取自工具参数或模型输出**；
+* 落点仍由 `assertModuleDirectory` 做存在性、链接与身份校验。
+*/
+function resolveModuleToolTarget(exec, root, moduleIdsOf) {
+	const agent = exec.agent;
+	const id = agent === void 0 ? void 0 : moduleIdsOf(agent.id)[0];
+	if (id === void 0) throw new Error("当前会话未配装提示词层：请先在模块页启用至少一个模块");
+	return {
+		id,
+		root,
+		dir: assertModuleDirectory(root, id)
+	};
+}
+/** 定义已经保存时，不把重建失败伪装成整个写入未发生。 */
+async function rebuildSavedPreset(host, id) {
+	try {
+		await host.rebuild(id);
+	} catch (error) {
+		throw new Error(`模块 ${id} 已保存，但重建失败：${String(error)}`, { cause: error });
+	}
+}
+//#endregion
 //#region src/runtime/character-tools.ts
 const text$2 = (text) => [{
 	type: "text",
 	text
 }];
-/** 注册角色卡库模型工具；返回 disposer，随 character-tools 预设模块生命周期清理。 */
+/** 注册角色卡库模型工具；返回 disposer，随 character-tools 模块生命周期清理。 */
 function registerCharacterTools(ctx, host) {
 	const fiber = ctx.inject(["tools"], (toolsCtx) => {
 		const disposers = [];
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_list",
-			description: "列出角色卡库：每张卡（id / 名称 / 描述 / 是否已导入当前预设）。导入角色卡、应用到当前预设或移除前先调用本工具获取 id。",
+			description: "列出角色卡库：每张卡（id / 名称 / 描述 / 是否已导入当前模块）。导入角色卡、应用到当前模块或移除前先调用本工具获取 id。",
 			parameters: {},
 			output: {
 				schema: {
@@ -5868,16 +5879,19 @@ function registerCharacterTools(ctx, host) {
 				},
 				render: (_args, value) => text$2(JSON.stringify(value.characters))
 			},
-			execute: async () => ({ characters: listCharacterCards(host.presetRoot(), host.templateName()) })
+			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 应用到当前预设。",
+			description: "导入一张 SillyTavern 角色卡或自包含原生角色片段到角色卡库：接收 JSON / YAML 文本内容（可先读取文件）。PNG 角色卡请让用户从 UI 角色管理页导入。导入后需调用 character_apply 应用到当前模块。",
 			parameters: {
 				name: {
 					type: "string",
 					required: true,
-					description: "角色卡文件名（不含 .json 扩展名），将作为预设/角色卡 id 基础。"
+					description: "角色卡文件名（不含 .json 扩展名），将作为模块/角色卡 id 基础。"
 				},
 				content: {
 					type: "string",
@@ -5900,10 +5914,11 @@ function registerCharacterTools(ctx, host) {
 						}
 					}
 				},
-				render: (_args, value) => text$2(`角色卡已入库：${value.name}（id=${value.id}）。调用 character_apply 可应用到当前预设。`)
+				render: (_args, value) => text$2(`角色卡已入库：${value.name}（id=${value.id}）。调用 character_apply 可应用到当前模块。`)
 			},
-			execute: async (args) => {
-				const result = importCharacterCard(host.presetRoot(), [{
+			execute: async (args, exec) => {
+				const target = host.target(exec);
+				const result = importCharacterCard(target.root, [{
 					path: `${args.name}.json`,
 					content: args.content
 				}]);
@@ -5916,7 +5931,7 @@ function registerCharacterTools(ctx, host) {
 		})));
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_apply",
-			description: "把角色卡库中一张角色卡的参数（角色设定 / 系统提示 / 开场白 / 世界书 / 提示词配置）合并进当前激活预设（promptConfigs 带 chara-<id>- 前缀防冲突，params 合并，meta.importedCharacters 记录），并立即重建生成目录。重复应用幂等。",
+			description: "把角色卡库中一张角色卡的参数（角色设定 / 系统提示 / 开场白 / 世界书 / 提示词配置）合并进当前会话绑定的模块（promptConfigs 带 chara-<id>- 前缀防冲突，params 合并，meta.importedCharacters 记录），并立即重建生成目录。重复应用幂等。",
 			parameters: { id: {
 				type: "string",
 				required: true,
@@ -5937,12 +5952,13 @@ function registerCharacterTools(ctx, host) {
 						}
 					}
 				},
-				render: (_args, value) => text$2(`已导入到当前预设（${value.count} 条配置），生成目录已重建。`)
+				render: (_args, value) => text$2(`已导入到当前模块（${value.count} 条配置），生成目录已重建。`)
 			},
-			execute: async (args) => {
-				const result = applyCharacterToPreset(host.presetRoot(), host.templateName(), args.id);
+			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);
-				host.rebuild();
+				await rebuildSavedPreset(host, target.id);
 				return {
 					id: args.id,
 					count: result.count
@@ -5951,7 +5967,7 @@ function registerCharacterTools(ctx, host) {
 		})));
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_remove",
-			description: "从当前激活预设移除一张已导入角色卡的参数（删 chara-<id>- 前缀配置、该卡声明的 params 键、meta.importedCharacters 除名），并立即重建生成目录。角色卡库条目不受影响。",
+			description: "从当前会话绑定的模块移除一张已导入角色卡的参数（删 chara-<id>- 前缀配置、该卡声明的 params 键、meta.importedCharacters 除名），并立即重建生成目录。角色卡库条目不受影响。",
 			parameters: { id: {
 				type: "string",
 				required: true,
@@ -5972,12 +5988,13 @@ function registerCharacterTools(ctx, host) {
 						}
 					}
 				},
-				render: (_args, value) => text$2(`已从当前预设移除（${value.count} 条配置），生成目录已重建。`)
+				render: (_args, value) => text$2(`已从当前模块移除（${value.count} 条配置），生成目录已重建。`)
 			},
-			execute: async (args) => {
-				const result = removeCharacterFromPreset(host.presetRoot(), host.templateName(), args.id);
+			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);
-				host.rebuild();
+				await rebuildSavedPreset(host, target.id);
 				return {
 					id: args.id,
 					count: result.count
@@ -5986,7 +6003,7 @@ function registerCharacterTools(ctx, host) {
 		})));
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "character_delete",
-			description: "从角色卡库删除一张角色卡（含其转换参数与头像）。已导入当前预设的参数不受影响（如需清理请先调用 character_remove）。",
+			description: "从角色卡库删除一张角色卡（含其转换参数与头像）。已导入当前模块的参数不受影响（如需清理请先调用 character_remove）。",
 			parameters: { id: {
 				type: "string",
 				required: true,
@@ -6003,8 +6020,8 @@ function registerCharacterTools(ctx, host) {
 				},
 				render: (_args, value) => text$2(`角色卡 ${value.id} 已从库中删除。`)
 			},
-			execute: async (args) => {
-				const result = deleteCharacterCard(host.presetRoot(), args.id);
+			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 };
 			}
@@ -6023,37 +6040,38 @@ const text$1 = (text) => [{
 	type: "text",
 	text
 }];
-/** 从条目 id 解析来源角色卡（chara-<cardId>- 前缀，cardId 可含连字符：遍历库目录取最长匹配）。 */
-function sourceCardId(presetRoot, entryId) {
-	const root = join(presetRoot, ".characters");
-	if (!entryId.startsWith("chara-")) return void 0;
+/** 从条目 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(`chara-${dir.name}-`) && (best === void 0 || dir.name.length > best.length)) best = dir.name;
+			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 预设模块生命周期清理。 */
+/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 模块生命周期清理。 */
 function registerWorldBookTools(ctx, host) {
 	const fiber = ctx.inject(["tools"], (toolsCtx) => {
 		const disposers = [];
-		/** note 归属写入：角色卡条目 → 卡记忆；其他 → 预设记忆。 */
-		const writeNote = (entryId, note) => {
+		/** note 归属写入：角色卡条目 → 卡记忆；其他 → 模块记忆。 */
+		const writeNote = (target, entryId, note) => {
 			if (note === void 0 || note.trim().length === 0) return;
-			const cardId = entryId !== void 0 ? sourceCardId(host.presetRoot(), entryId) : void 0;
+			const cardId = entryId !== void 0 ? sourceCardId(target.root, entryId) : void 0;
 			if (cardId !== void 0) {
-				appendMemoryFile(join(host.presetRoot(), ".characters", cardId, "memory.md"), note, "# 角色记忆");
+				appendMemoryFile(join(target.root, ".characters", cardId, "memory.md"), note, "# 角色记忆");
 				try {
-					syncImportedCharacterMemory(host.presetRoot(), basename(host.activeDir()), cardId);
+					syncImportedCharacterMemory(target.root, target.id, cardId);
 				} catch {}
-			} else appendMemoryFile(join(host.activeDir(), "memory.md"), note, "# 本地记忆");
+			} 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。",
+			description: "列出当前模块的世界书条目（world-book 策略配置：id / 名称 / 关键字 / 常驻 / 启用）。世界书 = 上下文条目：无 keys 的全局条目每次注入，有 keys 条目命中聊天内容才注入。增删改前先调用本工具获取 id。",
 			parameters: {},
 			output: {
 				schema: {
@@ -6086,8 +6104,8 @@ function registerWorldBookTools(ctx, host) {
 				},
 				render: (_args, value) => text$1(JSON.stringify(value.entries))
 			},
-			execute: async () => {
-				return { entries: listWorldBookEntries(host.activeDir()).map((config) => {
+			execute: async (_args, exec) => {
+				return { entries: listWorldBookEntries(host.target(exec).dir).map((config) => {
 					const params = config.params;
 					const keys = params?.keys;
 					return {
@@ -6102,7 +6120,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，条目 id 带 chara-<卡>- 前缀时）或模块记忆——持久记忆跨会话跟随角色卡（与 session_var 会话变量的临时状态不同，适合长期关系记录）。写盘后立即重建生成目录。",
 			parameters: {
 				id: {
 					type: "string",
@@ -6142,7 +6160,7 @@ function registerWorldBookTools(ctx, host) {
 				},
 				note: {
 					type: "string",
-					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md，跨会话跟随角色卡）或预设记忆。"
+					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md，跨会话跟随角色卡）或模块记忆。"
 				}
 			},
 			output: {
@@ -6162,8 +6180,8 @@ function registerWorldBookTools(ctx, host) {
 				},
 				render: (_args, value) => text$1(`世界书条目 ${value.id} 已保存（当前共 ${value.count} 条），生成目录已重建。`)
 			},
-			execute: async (args) => {
-				const dir = host.activeDir();
+			execute: async (args, exec) => {
+				const target = host.target(exec);
 				const targetId = args.id !== void 0 && args.id.length > 0 ? args.id : `lore-${Date.now().toString(36)}`;
 				const entry = buildWorldBookEntry({
 					id: targetId,
@@ -6175,12 +6193,12 @@ function registerWorldBookTools(ctx, host) {
 					keys: Array.isArray(args.keys) && args.keys.length > 0 ? args.keys : void 0,
 					secondaryKeys: Array.isArray(args.secondaryKeys) && args.secondaryKeys.length > 0 ? args.secondaryKeys : void 0
 				});
-				const count = upsertWorldBookEntry(dir, {
+				const count = upsertWorldBookEntry(target.dir, {
 					...entry,
 					id: targetId
 				});
-				writeNote(targetId, typeof args.note === "string" ? args.note : "");
-				host.rebuild();
+				writeNote(target, targetId, typeof args.note === "string" ? args.note : "");
+				await rebuildSavedPreset(host, target.id);
 				return {
 					id: targetId,
 					count
@@ -6189,7 +6207,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，跨会话跟随角色卡）或模块记忆。删除后立即重建生成目录。",
 			parameters: {
 				id: {
 					type: "string",
@@ -6198,7 +6216,7 @@ function registerWorldBookTools(ctx, host) {
 				},
 				note: {
 					type: "string",
-					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md）或预设记忆。"
+					description: "可选：操作笔记，写入来源角色卡持久记忆（memory.md）或模块记忆。"
 				}
 			},
 			output: {
@@ -6218,11 +6236,11 @@ function registerWorldBookTools(ctx, host) {
 				},
 				render: (_args, value) => text$1(`世界书条目 ${value.id} 已删除（剩余 ${value.count} 条），生成目录已重建。`)
 			},
-			execute: async (args) => {
-				const dir = host.activeDir();
-				const keptCount = deleteWorldBookEntry(dir, args.id);
-				writeNote(args.id, typeof args.note === "string" ? args.note : "");
-				host.rebuild();
+			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);
 				return {
 					id: args.id,
 					count: keptCount
@@ -6243,13 +6261,13 @@ const text = (value) => [{
 	type: "text",
 	text: value
 }];
-/** 注册会话变量模型工具；返回 disposer，随 session-var-tools 预设模块生命周期清理。 */
+/** 注册会话变量模型工具；返回 disposer，随 session-var-tools 模块生命周期清理。 */
 function registerSessionVarTools(ctx) {
 	const fiber = ctx.inject(["tools"], (toolsCtx) => {
 		const disposers = [];
 		disposers.push(toolsCtx.tools.register(defineTool({
 			name: "session_var",
-			description: "会话变量管理（SillyTavern setvar/getvar 语义）：list 查看当前会话全部变量、get 读取、set 设置、clear 清除。提示词/世界书文本中的模板占位符（形如 {变量名}，即双花括号包裹变量名）会在注入时替换为会话变量值（会话级覆盖预设默认值）；适合维护角色状态（如 {心情}、{接受度} 等）。注意：会话变量仅存于当前会话（结束即失）；跨会话长期记忆请用 world_book 工具的 note 参数写入角色卡记忆（持久，跟随角色卡）。",
+			description: "会话变量管理（SillyTavern setvar/getvar 语义）：list 查看当前会话全部变量、get 读取、set 设置、clear 清除。提示词/世界书文本中的模板占位符（形如 {变量名}，即双花括号包裹变量名）会在注入时替换为会话变量值（会话级覆盖模块默认值）；适合维护角色状态（如 {心情}、{接受度} 等）。注意：会话变量仅存于当前会话（结束即失）；跨会话长期记忆请用 world_book 工具的 note 参数写入角色卡记忆（持久，跟随角色卡）。",
 			parameters: {
 				action: {
 					type: "string",
@@ -6354,22 +6372,11 @@ 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_PARAM_SWITCHES = [
-	["injectPrompt", "锚定确认后注入 preset.md"],
-	["firstTurnAnchor", "追加任务引导"],
-	["guideEnabled", "每轮引导（独立开关；缺省关闭）"],
-	["firstTurnCustom", "使用自定义引导（首句）"],
-	["guideCustom", "使用自定义引导（每轮）"]
-];
-/** 参数显示行（从激活预设 preset.yml params 读）。 */
+const TUI_GLOBAL_SWITCHES = [["writePreset", "模块运行总开关"]];
+/** dsh-tui 参数开关：写激活模块 preset.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 = [
-	[
-		"firstTurnText",
-		"firstTurnText",
-		"（空 = 按任务自动选择）"
-	],
 	[
 		"modelProvider",
 		"modelProvider",
@@ -6423,20 +6430,20 @@ const TUI_PARAM_TEXT_LINES = [
 ];
 /** 把布尔开关渲染成 dsh-tui 命令输出。 */
 /** 实际生效配置：生成目录优先（引擎加载源），settings 覆盖层作回退。 */
-function resolvePromptConfigs(presetDir, fallback) {
-	if (presetDir === void 0 || presetDir.length === 0) return fallback;
+function resolvePromptConfigs(moduleDir, fallback) {
+	if (moduleDir === void 0 || moduleDir.length === 0) return fallback;
 	try {
-		const actual = listPromptConfigSpecs(join(presetDir, "prompt-configs"));
+		const actual = listPromptConfigSpecs(join(moduleDir, MODULE_CONFIGS_DIR));
 		return actual.length > 0 ? actual : fallback;
 	} catch {
 		return fallback;
 	}
 }
-/** 激活预设参数（status 显示与参数开关来源；settings 不再承载引擎参数）。 */
-function readPresetParams(presetDir) {
-	if (presetDir === void 0 || presetDir.length === 0) return {};
+/** 激活模块参数（status 显示与参数开关来源；settings 不再承载引擎参数）。 */
+function readPresetParams(moduleDir) {
+	if (moduleDir === void 0 || moduleDir.length === 0) return {};
 	try {
-		const spec = loadPresetSpec(presetDir);
+		const spec = loadModuleSpec(moduleDir);
 		const params = resolvePresetParams(spec, {});
 		if (Array.isArray(spec.promptConfigs)) params.promptConfigs = spec.promptConfigs;
 		return params;
@@ -6446,7 +6453,7 @@ function readPresetParams(presetDir) {
 }
 function renderTuiStatus(source, params, promptConfigs) {
 	const onOff = (value) => value ? "开" : "关";
-	const paramBoolean = (key) => params[key] === true;
+	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 : "";
@@ -6458,9 +6465,9 @@ function renderTuiStatus(source, params, promptConfigs) {
 			return `${key.padEnd(22)}${onOff(typeof value === "boolean" ? value : false)}  ${label}`;
 		}),
 		...TUI_PARAM_SWITCHES.map(([key, label]) => {
-			return `${key.padEnd(22)}${onOff(paramBoolean(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}`;
@@ -6561,12 +6568,15 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 			handler: async (invocation) => {
 				const usage = () => ({
 					kind: "error",
-					text: "用法：/prompt-tool status\n      /prompt-tool on|off|toggle <writePreset|injectPrompt|firstTurnAnchor|firstTurnCustom|guideEnabled|guideCustom>\n      /prompt-tool skill <frontmatter 技能名> on|off|toggle\n      /prompt-tool config <id>（id 可含空格）\n      /prompt-tool config <id> on|off|toggle"
+					text: `用法：/prompt-tool status
+      /prompt-tool on|off|toggle <${[...TUI_GLOBAL_SWITCHES, ...TUI_PARAM_SWITCHES].map(([key]) => key).join("|")}>\n      /prompt-tool skill <frontmatter 技能名> on|off|toggle
+      /prompt-tool config <id>（id 可含空格）
+      /prompt-tool config <id> on|off|toggle`
 				});
 				const persistPresetParam = async (key, value) => {
 					if (savePresetParam === void 0) return {
 						kind: "error",
-						text: `无法保存 ${key}：预设参数保存回调不可用`
+						text: `无法保存 ${key}：模块参数保存回调不可用`
 					};
 					try {
 						await savePresetParam(key, value);
@@ -6580,9 +6590,9 @@ function registerTuiCommand(ctx, ns, getSource, getModelsState, getModelCatalog,
 				};
 				const tokens = invocation.rawInput.trim().split(/\s+/).filter((token) => token.length > 0);
 				const source = getSource();
-				const presetDir = getPresetConfigsDir?.();
-				const params = readPresetParams(presetDir);
-				const promptConfigs = resolvePromptConfigs(presetDir, Array.isArray(params.promptConfigs) ? params.promptConfigs : []);
+				const moduleDir = getPresetConfigsDir?.();
+				const params = readPresetParams(moduleDir);
+				const promptConfigs = resolvePromptConfigs(moduleDir, Array.isArray(params.promptConfigs) ? params.promptConfigs : []);
 				if (tokens.length === 0 || tokens[0] === "status") {
 					const detection = getModelsState();
 					const catalog = await getModelCatalog();
@@ -6656,7 +6666,7 @@ ${renderConfigDetail(getSource(), id, resolvePromptConfigs(getPresetConfigsDir?.
 				if (action !== "on" && action !== "off" && action !== "toggle") return usage();
 				if (key === void 0 || !TUI_GLOBAL_SWITCHES.some(([candidate]) => candidate === key) && !TUI_PARAM_SWITCHES.some(([candidate]) => candidate === key)) return usage();
 				const globalSwitch = TUI_GLOBAL_SWITCHES.some(([candidate]) => candidate === key);
-				const currentValue = globalSwitch ? source[key] : params[key];
+				const currentValue = globalSwitch ? source[key] : params[key] ?? ENGINE_PARAM_DEFINITIONS[key]?.defaultValue;
 				if (typeof currentValue !== "boolean") return {
 					kind: "error",
 					text: `${key} 不是布尔开关，不能这样切换`
@@ -7013,175 +7023,265 @@ function createSkillsRuntime(ctx, options = {}) {
 	};
 }
 //#endregion
-//#region src/host/preset-registry.ts
+//#region src/runtime/agent-assembly.ts
 /**
-* 共享引擎模块的受管配置字段：值按**历史语义**相对 `<预设根>/.engine/` 书写
-* （如 `../<id>/prompt-configs`），装配期换算为绝对 `file://`。
+* agent-assembly — 运行时配装通道。
+*
+* 目标形态：模块不再靠「注册进官方 agent-presets + 由宿主 Loader 挂载插件树」装配，
+* 而是插件在**每个 Agent 自己的 scope** 里建一份装配。
+*
+* 判据（与原模块形态逐项对齐，能力一项不删）：
+*   - 挂的是插件自己的引擎模块（`engine/*.mjs` 的 `apply(ctx, config)`），
+*     不再声明 `agent.cordis.yml` 这类「给宿主 Loader 用的组合本体」；
+*   - 官方工具行（`dsh-tool-*` 等）由宿主提供；模块人设通过 systemPrompt 注册，
+*     本通道**不**装第二棵官方插件树——那些包也不在插件包的解析面内；
+*   - 物化目录优先：`configs/`（原 `prompt-configs/`）、`custom-tools/` 存在就按它装配，
+*     缺失时回退 `module.yml` 内嵌，两条路径的切片同源（`resolveModuleFacts`）。
+*
+* 与官方挂载并存时不会重复：官方树里没有引擎行，引擎贡献只由本通道提供。
 */
-const MANAGED_FIELDS = {
-	"prompt-config-engine.mjs": ["configsDir", "strategyDir"],
-	"tool-config-engine.mjs": ["configsDir"],
-	"subagent-tool-policy.mjs": ["policyFile"],
-	"declared-triggers.mjs": ["triggersFile"]
+/** 引擎模块的受管配置字段：值按历史语义相对模块根书写（如 `../<id>/custom-tools`）。 */
+const MANAGED_FIELDS = [
+	"configsDir",
+	"strategyDir",
+	"policyFile",
+	"triggersFile"
+];
+/** 私有工具适配器依赖的服务；适配器仍复用包内引擎入口。 */
+const PRIVATE_SERVICES = {
+	"character-tools": "pt-character-tools",
+	"world-book-tools": "pt-world-book-tools",
+	"session-var-tools": "pt-session-var-tools"
 };
-/** 需要注入预设根基准的引擎模块——只有它们的 configContract 声明了 `presetRoot` 键。 */
-const PRESET_ROOT_MODULES = /* @__PURE__ */ new Set([
-	"prompt-config-engine.mjs",
-	"tool-config-engine.mjs",
-	"declared-triggers.mjs"
-]);
-function isJsExpr(value) {
-	return typeof value === "object" && value !== null && typeof value.__jsExpr === "string";
-}
-/** 行名引用的共享引擎模块名；只认插件包的说明符前缀（不再兼容旧布局）。 */
-function engineModuleOf(name) {
-	return typeof name === "string" && name.startsWith("dsh-plugin-prompt-tool/engine/") ? name.slice(PRESET_ENGINE_PREFIX.length) : void 0;
-}
-/** config 层换算：受管字段 → 绝对 `file://`；需要基准的引擎行注入预设根。 */
-function absolutizeConfig(config, engineModule, context) {
-	const fields = engineModule === void 0 ? void 0 : MANAGED_FIELDS[engineModule];
-	const out = {};
-	for (const [key, value] of Object.entries(config)) if (fields !== void 0 && fields.includes(key) && typeof value === "string" && value.startsWith(".")) out[key] = pathToFileURL(resolve(context.engineDir, value)).href;
-	else out[key] = value;
-	if (engineModule !== void 0 && PRESET_ROOT_MODULES.has(engineModule)) out.presetRoot = context.presetRootUrl;
+/**
+* 受管字段的路径换算：`configsDir` / `strategyDir` / `policyFile` / `triggersFile`
+* 一律解析到**当前模块目录内的真实位置**——声明怎么写都按模块目录作基准，三种形态同结果：
+*   - `./configs`（新形态）→ `<模块目录>/configs`；
+*   - `../<id>/triggers.yml`（历史形态：`ENGINE_MANAGED_PATHS` 的改写成这样，语义是
+*     「从历史引擎位置 `<模块根>/.engine/` 回到 `<模块根>/<id>/`」）→ `<模块目录>/triggers.yml`；
+*   - `../subagent-tools/policy.yml`（组合源初值）→ 相对模块内历史引擎位置，
+*     同样落进当前模块目录；引擎继续负责资源越界校验。
+* 已是 `file:` URL 的值原样保留。
+*/
+function absolutizeManagedFields(config, moduleDir) {
+	const out = { ...config };
+	for (const field of MANAGED_FIELDS) {
+		const value = out[field];
+		if (typeof value !== "string" || value.length === 0) continue;
+		if (value.startsWith("file:")) continue;
+		const base = value.startsWith("../") && !value.startsWith(`../${basename(moduleDir)}/`) ? join(moduleDir, ".engine") : moduleDir;
+		out[field] = pathToFileURL(resolve(base, value)).href;
+	}
 	return out;
 }
-/** 行级换算：只认行对象自己的 `name` 与 `config`，不误伤 config 里的同名业务字段。 */
-function absolutizeRow(row, context) {
-	if (row === null || typeof row !== "object" || Array.isArray(row) || isJsExpr(row)) return row;
-	const source = row;
-	const engineModule = engineModuleOf(source.name);
-	const out = {};
-	for (const [key, item] of Object.entries(source)) if (key === "name" && typeof item === "string") out[key] = item.startsWith(".") && engineModule === void 0 ? pathToFileURL(resolve(context.presetDir, item)).href : item;
-	else if (key === "config" && Array.isArray(item)) out[key] = item.map((child) => absolutizeRow(child, context));
-	else if (key === "config" && item !== null && typeof item === "object" && !isJsExpr(item)) out[key] = absolutizeConfig(item, engineModule, context);
-	else out[key] = item;
-	return out;
+/** 该模块 id 是不是插件自带的引擎能力（官方工具行与未知 id 一律跳过）。 */
+function engineModuleFile(engineDir, id) {
+	const file = join(engineDir, `${id}.mjs`);
+	return existsSync(file) ? file : void 0;
 }
 /**
-* 装配期换算：把组合里的本地引用换成 Loader 与引擎都能解析的绝对形态。
+* 读一份模块的装配输入：切片、引擎模块、所需宿主能力。
 *
-* 三件事，全部只发生在内存注册定义，正本 `agent.cordis.yml` 一字不改：
-* 1. **本地模块说明符**（`name` 以 `.` 开头）：相对预设目录 → 绝对 `file://`。注册用的 Loader
-*    树必须以**宿主锚点**建（`register()` 取调用方 ctx 的 `baseUrl` 解析每一行），否则组合内的
-*    包名行会从预设目录起解析、整份注册被拒；锚点归宿主后，预设目录内的相对说明符必须在此换算。
-* 2. **受管配置字段**（`configsDir` / `strategyDir` / `policyFile` / `triggersFile`）：按历史语义
-*    相对 `<预设根>/.engine/` 解析为绝对 `file://`。引擎由插件包提供后其 `import.meta.url` 不再
-*    位于该目录，`file://` 也是对全部受管字段一致有效的唯一形态。
-* 3. **预设根基准**：给需要 `templateFile` 越界校验的引擎行注入 `presetRoot`。
-*
-* 共享引擎行本身写 `dsh-plugin-prompt-tool/engine/*.mjs`（由生成侧 `rewritePresetEngineReferences`
-* 产出），本函数不改写它。**不兼容旧预设**：仍写 `./engine/`、`../.engine/` 的预设按普通本地
-* 说明符处理，指向已不再物化的目录并因此挂载失败，需重建后重新物化。
+* 纯读缝（只依赖包内引擎与模块目录），供挂载与回归测试共用；`hasService` 是宿主能力探针。
 */
-function absolutizeLocalModules(rows, presetDir) {
-	if (!Array.isArray(rows)) return rows;
-	const presetRoot = resolve(presetDir, "..");
-	const context = {
-		presetDir,
-		engineDir: join(presetRoot, ".engine"),
-		presetRootUrl: `${pathToFileURL(presetRoot).href}/`
-	};
-	return rows.map((row) => absolutizeRow(row, context));
-}
-function readDefinition(root, id) {
-	const preset = loadPresetSpec(join(root, id));
-	const file = join(root, id, "agent.cordis.yml");
-	const source = readFileSync(file, "utf8");
-	const plugins = parse(source, {
-		version: "1.2",
-		customTags: [{
-			tag: "tag:yaml.org,2002:js",
-			resolve: (__jsExpr) => ({ __jsExpr })
-		}]
+async function prepareAssembly(moduleRoot, moduleId, hasService) {
+	assertPresetId(moduleId);
+	const moduleDir = resolveModuleDir(moduleId, moduleRoot);
+	const spec = loadModuleSpec(moduleDir);
+	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,
+		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 problem = entryListProblem(plugins);
-	if (problem !== void 0) throw new Error(`预设 ${preset.id}：${problem}`);
-	const order = typeof preset.order === "number" && Number.isFinite(preset.order) ? preset.order : 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;
+	});
+	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;
+		const privateService = PRIVATE_SERVICES[id];
+		if (privateService !== void 0) {
+			if (!hasService(privateService)) throw new Error(`配装所需能力不可用：${privateService}`);
+			services.add(privateService);
+		}
+		const file = engineModuleFile(engineDir, id);
+		if (file === void 0) continue;
+		const module = await import(pathToFileURL(file).href);
+		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;
+		module.configContract?.parse?.(config, id);
+		modules.push({
+			id,
+			apply: module.apply,
+			config
+		});
+	}
+	if (configs.length > 0) {
+		services.add("systemPrompt");
+		services.add("tools");
+		services.add("llm");
+	}
+	if (spec.persona !== void 0) services.add("systemPrompt");
+	for (const name of services) if (!hasService(name)) throw new Error(`配装所需宿主能力不可用：${name}`);
 	return {
-		id,
-		...typeof preset.name === "string" && preset.name.length > 0 ? { name: preset.name } : {},
-		...typeof preset.description === "string" ? { description: preset.description } : {},
-		...order === void 0 ? {} : { order },
-		plugins: absolutizeLocalModules(plugins, join(root, id))
+		configs,
+		modules,
+		services,
+		moduleId,
+		persona: spec.persona
 	};
 }
-/** Register generated user preset compositions with the v0.1.7 registry. */
-function createPresetRegistrySync(ctx, root) {
-	const registrations = /* @__PURE__ */ new Map();
-	let queue = Promise.resolve();
-	let closed = false;
-	const refresh = (forceIds = []) => {
-		const turn = queue.then(async () => {
-			if (closed) return;
-			const errors = [];
-			for (const [id, current] of registrations) try {
-				if (statSync(join(root, id), { throwIfNoEntry: false }) !== void 0) continue;
-				await current.dispose();
-				registrations.delete(id);
-			} catch (error) {
-				errors.push(error);
-			}
-			for (const preset of listPresets(root)) try {
-				const definition = readDefinition(root, preset.id);
-				const fingerprint = JSON.stringify(definition);
-				const current = registrations.get(preset.id);
-				if (current?.fingerprint === fingerprint && !forceIds.includes(preset.id)) continue;
-				const registry = ctx.agentPresets;
-				const register = async (candidate) => {
-					const dispose = await registry.register(candidate);
-					try {
-						const result = await registry.resolve(candidate.id);
-						if (result.broken !== void 0) throw new Error(result.broken);
-						return dispose;
-					} catch (error) {
-						await dispose();
-						throw error;
-					}
-				};
-				if (current !== void 0) {
-					await (await register({
-						...definition,
-						id: `prompt-tool-candidate-${randomUUID()}`
-					}))();
-					await current.dispose();
-					registrations.delete(preset.id);
-				}
-				try {
-					const dispose = await register(definition);
-					registrations.set(preset.id, {
-						definition,
-						fingerprint,
-						dispose
+function createAgentAssembly(ctx, options) {
+	const mounts = /* @__PURE__ */ new Map();
+	const disposed = /* @__PURE__ */ new WeakSet();
+	const queues = /* @__PURE__ */ new Map();
+	let active = true;
+	const warn = (error) => {
+		const message = `prompt-tool: 运行时配装失败：${error instanceof Error ? error.message : String(error)}`;
+		if (options.warn !== void 0) options.warn(message);
+		else ctx.logger?.warn?.(message);
+	};
+	const serial = (sessionId, task) => {
+		const next = (queues.get(sessionId) ?? Promise.resolve()).then(task);
+		const settled = next.then(() => {}, () => {});
+		queues.set(sessionId, settled);
+		settled.then(() => {
+			if (queues.get(sessionId) === settled) queues.delete(sessionId);
+		});
+		return next;
+	};
+	const release = async (sessionId, agent) => {
+		const current = mounts.get(sessionId);
+		if (current === void 0) return;
+		if (agent !== void 0 && current.agent !== agent) return;
+		mounts.delete(sessionId);
+		await current.fiber.dispose();
+	};
+	const mount = async (agent, prepared) => {
+		const services = /* @__PURE__ */ new Set();
+		for (const item of prepared) for (const name of item.services) services.add(name);
+		const fiber = agent.ctx.plugin({
+			name: "prompt-tool-assembly",
+			inject: [...services],
+			apply: async (scopeCtx) => {
+				for (const item of prepared) if (item.persona !== void 0) {
+					const persona = item.persona;
+					scopeCtx.systemPrompt.section({
+						name: `prompt-tool:${item.moduleId}:persona-prefix`,
+						order: scopeCtx.systemPrompt.getSectionOrder("DEPLOYMENT_PERSONA_PREFIX"),
+						text: persona.prefix,
+						complete: persona.complete === true
 					});
-				} catch (error) {
-					if (current !== void 0) {
-						const dispose = await register(current.definition);
-						registrations.set(preset.id, {
-							...current,
-							dispose
-						});
-					}
-					throw error;
+					scopeCtx.systemPrompt.section({
+						name: `prompt-tool:${item.moduleId}:persona-suffix`,
+						order: scopeCtx.systemPrompt.getSectionOrder("DEPLOYMENT_PERSONA_SUFFIX"),
+						text: persona.suffix ?? ""
+					});
+					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 }));
+				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);
 				}
-			} catch (error) {
-				errors.push(error);
-				ctx.logger?.warn?.(`prompt-tool: 预设 ${preset.id} 注册刷新失败：${String(error)}`);
 			}
-			if (errors.length > 0) throw new AggregateError(errors, "预设注册刷新失败");
 		});
-		queue = turn.catch(() => {});
-		return turn;
+		const disposeFiber = ctx.effect(() => () => fiber.dispose(), `prompt-tool assembly ${agent.id}`);
+		try {
+			await fiber;
+		} catch (error) {
+			await disposeFiber();
+			throw error;
+		}
+		if (!active || disposed.has(agent)) {
+			await disposeFiber();
+			return;
+		}
+		mounts.set(agent.id, {
+			agent,
+			fiber: { dispose: async () => {
+				await disposeFiber();
+			} },
+			prepared,
+			moduleIds: prepared.map((item) => item.moduleId)
+		});
+	};
+	const install = async (agent, refresh = false) => {
+		if (!active || disposed.has(agent)) return;
+		const previous = mounts.get(agent.id);
+		if (!refresh && previous?.agent === agent) return;
+		const prepared = [];
+		for (const id of options.enabledModules()) prepared.push(await prepareAssembly(options.moduleRoot, id, (name) => agent.ctx.get(name) !== void 0));
+		if (!active || disposed.has(agent)) return;
+		await release(agent.id);
+		try {
+			await mount(agent, prepared);
+		} catch (error) {
+			if (previous?.agent === agent && active && !disposed.has(agent)) await mount(agent, previous.prepared);
+			throw error;
+		}
 	};
+	const listeners = [ctx.on("agent/created", async ({ agent }) => {
+		await serial(agent.id, async () => {
+			try {
+				await install(agent);
+			} catch (error) {
+				warn(error);
+			}
+		});
+	}), ctx.on("agent/disposed", ({ agent }) => {
+		disposed.add(agent);
+		serial(agent.id, () => release(agent.id, agent)).catch(warn);
+	})];
+	ctx.effect(() => () => {
+		active = false;
+		for (const remove of listeners) remove();
+		return Promise.all(queues.values()).then(async () => {
+			for (const id of mounts.keys()) await release(id);
+		});
+	}, "prompt-tool assembly runtime");
+	try {
+		for (const agent of ctx.agents.list()) serial(agent.id, () => install(agent)).catch(warn);
+	} catch (error) {
+		warn(error);
+	}
 	return {
-		refresh,
+		settled: () => Promise.all(queues.values()).then(() => void 0),
+		hasMounted: (sessionId) => mounts.has(sessionId),
+		moduleIds: (sessionId) => mounts.get(sessionId)?.moduleIds ?? [],
+		refresh: async (moduleId) => {
+			if (!active) throw new Error("运行时配装已释放");
+			const errors = (await Promise.allSettled(ctx.agents.list().map((agent) => serial(agent.id, async () => {
+				const current = mounts.get(agent.id);
+				if (moduleId !== void 0 && current !== void 0 && !current.moduleIds.includes(moduleId) && !options.enabledModules().includes(moduleId)) return;
+				await install(agent, true);
+			})))).filter((result) => result.status === "rejected");
+			if (errors.length > 0) throw new AggregateError(errors.map((result) => result.reason), "模块已保存，但运行时配装更新失败");
+		},
 		dispose: async () => {
-			closed = true;
-			await queue;
-			const results = await Promise.allSettled([...registrations.values()].map((registration) => registration.dispose()));
-			registrations.clear();
-			const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
-			if (errors.length > 0) throw new AggregateError(errors, "预设注册释放失败");
+			active = false;
+			for (const remove of listeners) remove();
+			await Promise.all(queues.values());
+			for (const id of mounts.keys()) await release(id);
 		}
 	};
 }
@@ -7194,169 +7294,32 @@ const inject = [
 	"llm",
 	"subagents"
 ];
-function readPromptFile(template, fallbackText) {
-	const text = loadPresetContent(template).presetText;
-	return text.length > 0 ? text : fallbackText;
-}
-function readAgents(template) {
-	return loadPresetContent(template).agentsText;
-}
-/** 生成目录内容文件（writePreset 落盘；大文本存文件而非 settings）。 */
-function readGeneratedContent(presetDir, name) {
-	try {
-		return readFileSync(join(presetDir, name), "utf8");
-	} catch {
-		return "";
-	}
-}
 function warn(ctx, message) {
 	try {
 		ctx.logger?.warn(message);
 	} catch {}
 }
 function apply(ctx, configIn) {
-	const seededPresets = new Set(ensurePresetSeed(DEFAULT_PRESET_DIR).created);
-	const readConfig = () => ({
-		writePreset: configIn.writePreset.get(),
-		presetTemplate: configIn.presetTemplate.get(),
-		presetOrder: configIn.presetOrder.get(),
-		fallbackText: configIn.fallbackText.get()
-	});
+	const seededPresets = new Set(ensurePresetSeed(MODULES_DIR).created);
+	const readConfig = () => ({ writePreset: configIn.writePreset.get() });
 	const config = readConfig();
-	let registrySync;
-	const refreshPresets = (forceIds) => registrySync?.refresh(forceIds) ?? Promise.resolve();
+	/** 运行时配装通道的运行态：工具写入目标按它报告的「本 Agent 装了哪几层提示词」解析。 */
+	let assembly;
 	const modelsState = () => detectModels(ctx);
 	const getModelsState = () => modelsState();
-	const initialTemplate = typeof config.presetTemplate === "string" && config.presetTemplate.length > 0 ? config.presetTemplate : DEFAULT_PRESET_ID;
-	const initialPresetDir = join(DEFAULT_PRESET_DIR, /^[a-zA-Z0-9_-]+$/.test(initialTemplate) ? initialTemplate : DEFAULT_PRESET_ID);
-	let initialParams = {};
-	let initialSpec;
-	try {
-		initialSpec = loadPresetSpec(resolvePresetDir(initialTemplate));
-		initialParams = resolvePresetParams(initialSpec, {});
-	} catch (error) {
-		warn(ctx, `prompt-tool: 激活预设参数读取失败（使用默认值）：${error instanceof Error ? error.message : String(error)}`);
-	}
-	let current = readGeneratedContent(initialPresetDir, "preset.md") || readPromptFile(initialTemplate, config.fallbackText);
-	let currentAgents = readGeneratedContent(initialPresetDir, "agents.md") || readAgents(initialTemplate);
-	/** 从激活预设 preset.yml 重读引擎参数到 runtime（参数保存/切换后调用）。 */
-	const reloadPresetParams = () => {
-		let spec;
-		try {
-			spec = loadPresetSpec(resolvePresetDir(runtime.presetTemplate));
-		} catch (error) {
-			warn(ctx, `prompt-tool: 读取激活预设参数失败：${error instanceof Error ? error.message : String(error)}`);
-			return;
-		}
-		const params = resolvePresetParams(spec, {});
-		for (const key of ENGINE_PARAM_KEYS) runtime[key] = params[key];
-		runtime.firstTurnAnchor = params.firstTurnAnchor === true;
-		runtime.firstTurnText = asString(params.firstTurnText);
-		runtime.firstTurnCustom = params.firstTurnCustom === true;
-		runtime.guideText = asString(params.guideText);
-		runtime.guideCustom = params.guideCustom === true;
-		runtime.guideEnabled = typeof params.guideEnabled === "boolean" ? params.guideEnabled : void 0;
-		runtime.modelProvider = asString(params.modelProvider);
-		runtime.modelName = asString(params.modelName);
-		runtime.subagentModelProvider = asString(params.subagentModelProvider);
-		runtime.subagentModelName = asString(params.subagentModelName);
-		runtime.modelReasoningEffort = asString(params.modelReasoningEffort);
-		runtime.modelTemperature = asString(params.modelTemperature);
-		runtime.modelMaxTokens = asString(params.modelMaxTokens);
-		runtime.subagentReasoningEffort = asString(params.subagentReasoningEffort);
-		runtime.subagentTemperature = asString(params.subagentTemperature);
-		runtime.subagentMaxTokens = asString(params.subagentMaxTokens);
-		runtime.injectPrompt = params.injectPrompt !== false;
-		runtime.maxDepth = params.maxDepth;
-		runtime.firstTurnWord = asString(params.firstTurnWord) || void 0;
-		runtime.promptConfigs = Array.isArray(spec.promptConfigs) ? spec.promptConfigs : [];
+	const runtime = { ...config };
+	const materialize = (id) => {
+		materializeModule(id, {
+			moduleDir: MODULES_DIR,
+			warn: (message) => warn(ctx, message)
+		});
 	};
-	/** 重建生成目录并刷新官方注册；writePreset 关闭时保留空组合。 */
-	const rebuildPreset = (initial = false) => {
-		reloadPresetParams();
-		if (runtime.writePreset) {
-			const presetPrompt = runtime.injectPrompt && current.length > 0 ? current : "";
-			const options = {
-				...Object.fromEntries(ENGINE_PARAM_KEYS.map((key) => [key, runtime[key]])),
-				firstTurnAnchor: runtime.firstTurnAnchor,
-				firstTurnText: runtime.firstTurnText,
-				firstTurnCustom: runtime.firstTurnCustom,
-				guideText: runtime.guideText,
-				guideCustom: runtime.guideCustom,
-				guideEnabled: runtime.guideEnabled,
-				injectPrompt: runtime.injectPrompt,
-				modelProvider: runtime.modelProvider,
-				modelName: runtime.modelName,
-				subagentModelProvider: runtime.subagentModelProvider,
-				subagentModelName: runtime.subagentModelName,
-				modelReasoningEffort: runtime.modelReasoningEffort,
-				modelTemperature: runtime.modelTemperature,
-				modelMaxTokens: runtime.modelMaxTokens,
-				subagentReasoningEffort: runtime.subagentReasoningEffort,
-				subagentTemperature: runtime.subagentTemperature,
-				subagentMaxTokens: runtime.subagentMaxTokens,
-				maxDepth: runtime.maxDepth,
-				firstTurnWord: runtime.firstTurnWord,
-				agentsInstructionText: currentAgents,
-				presetDir: DEFAULT_PRESET_DIR,
-				presetOrder: runtime.presetOrder,
-				promptConfigs: runtime.promptConfigs,
-				presetTemplate: runtime.presetTemplate,
-				outputId: runtime.presetTemplate,
-				warn: (message) => warn(ctx, message)
-			};
-			for (const preset of listPresets()) {
-				if (preset.id === runtime.presetTemplate) continue;
-				const targetDir = join(DEFAULT_PRESET_DIR, preset.id);
-				if (!seededPresets.has(preset.id) && !readGeneratedContent(targetDir, "agent.cordis.yml").startsWith("# prompt-tool writePreset disabled")) continue;
-				try {
-					const spec = loadPresetSpec(resolvePresetDir(preset.id));
-					if (!(Array.isArray(spec.modules) || spec.params !== null && typeof spec.params === "object") && existsSync(join(targetDir, "agent.cordis.yml"))) continue;
-				} catch {}
-				try {
-					writePreset(readPromptFile(preset.id, runtime.fallbackText), {
-						...resolvePresetParams(loadPresetSpec(resolvePresetDir(preset.id)), {}),
-						presetDir: DEFAULT_PRESET_DIR,
-						presetOrder: runtime.presetOrder,
-						presetTemplate: preset.id,
-						outputId: preset.id,
-						promptConfigs: [],
-						agentsInstructionText: ""
-					});
-				} catch (error) {
-					warn(ctx, `prompt-tool: 补建预设 ${preset.id} 失败（切换时可重试）：${error instanceof Error ? error.message : String(error)}`);
-				}
-			}
-			if (!initial || seededPresets.has(runtime.presetTemplate) || readGeneratedContent(activePresetDir(), "agent.cordis.yml").startsWith("# prompt-tool writePreset disabled")) writePreset(presetPrompt, options);
-			seededPresets.clear();
-		} else {
-			let cleaned = 0;
-			for (const preset of listPresets()) {
-				const dir = join(DEFAULT_PRESET_DIR, preset.id);
-				for (const name of [
-					"prompt-configs",
-					"custom-tools",
-					"preset.md",
-					"agents.md",
-					"agents-instruction.md",
-					"engine"
-				]) try {
-					rmSync(join(dir, name), {
-						recursive: true,
-						force: true
-					});
-				} catch {}
-				try {
-					writeFileSync(join(dir, "agent.cordis.yml"), "# prompt-tool writePreset disabled\n[]\n", "utf8");
-				} catch {}
-				cleaned += 1;
-			}
-			warn(ctx, `prompt-tool: writePreset 已关闭，清空 ${cleaned} 个预设目录的组合（preset.yml 参数保留）`);
-		}
-		refreshPresets(runtime.writePreset ? [runtime.presetTemplate] : listPresets().map((preset) => preset.id)).catch((error) => warn(ctx, `prompt-tool: 重建后的预设注册刷新失败：${String(error)}`));
+	const rebuildPreset = async (id = basename(activeModuleDir())) => {
+		materialize(id);
+		await assembly?.refresh(id);
 	};
-	/** 激活预设目录（内容按预设根 <template>/ 隔离；非法名回退 standard）。 */
-	const activePresetDir = () => join(DEFAULT_PRESET_DIR, /^[a-zA-Z0-9\u4e00-\u9fff_-]+$/.test(runtime.presetTemplate) ? runtime.presetTemplate : DEFAULT_PRESET_ID);
+	/** 无请求目标时供TUI使用的模块；编辑器的显式ID始终单独解析。 */
+	const activeModuleDir = () => resolveEditDir(MODULES_DIR) || (moduleDirExists(MODULES_DIR, "ponytail") ? join(MODULES_DIR, "ponytail") : "");
 	const skillsRuntime = createSkillsRuntime(ctx);
 	const settingsBridge = registerSettingsBridge(ctx, NS, getModelsState, () => ({
 		skillsRoot: skillsRuntime.skillsRoot,
@@ -7370,139 +7333,12 @@ function apply(ctx, configIn) {
 		readSkillContent: skillsRuntime.readContent,
 		writeSkillContent: skillsRuntime.writeContent,
 		patchSkillFolders: skillsRuntime.setFolders
-	}), () => "", skillsRuntime.invalidate, () => activePresetDir(), (scopes) => {
-		for (const scope of scopes) if (scope === "preset") current = readGeneratedContent(activePresetDir(), "preset.md");
-		else currentAgents = readGeneratedContent(activePresetDir(), "agents.md");
-		try {
-			rebuildPreset();
-		} catch (error) {
-			warn(ctx, `prompt-tool: preset import rebuild failed: ${String(error)}`);
-		}
-	}, () => {
-		try {
-			rebuildPreset();
-		} catch (error) {
-			warn(ctx, `prompt-tool: overrides rebuild failed: ${String(error)}`);
-			throw error;
-		}
-	}, async (id) => {
-		if (id === runtime.presetTemplate) {
-			current = readGeneratedContent(activePresetDir(), "preset.md");
-			currentAgents = readGeneratedContent(activePresetDir(), "agents.md");
-			reloadPresetParams();
-		}
+	}), () => "", 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();
-		await refreshPresets([id]);
-	}, () => {
-		rebuildPreset();
-	}, () => refreshPresets());
+		await assembly?.refresh(id);
+	}, (id) => rebuildPreset(id), () => assembly?.refresh());
 	scheduleWebSurfaceRepair(ctx, (message) => warn(ctx, message));
 	ctx.effect(() => ctx.on("llm/adapters-updated", () => invalidateModelCatalog(ctx)));
-	const runtime = {
-		...Object.fromEntries(ENGINE_PARAM_KEYS.map((key) => [key, initialParams[key]])),
-		writePreset: config.writePreset,
-		presetTemplate: initialTemplate,
-		firstTurnAnchor: initialParams.firstTurnAnchor === true,
-		firstTurnText: asString(initialParams.firstTurnText),
-		firstTurnCustom: initialParams.firstTurnCustom === true,
-		guideText: asString(initialParams.guideText),
-		guideCustom: initialParams.guideCustom === true,
-		guideEnabled: typeof initialParams.guideEnabled === "boolean" ? initialParams.guideEnabled : void 0,
-		injectPrompt: initialParams.injectPrompt !== false,
-		modelProvider: asString(initialParams.modelProvider),
-		modelName: asString(initialParams.modelName),
-		subagentModelProvider: asString(initialParams.subagentModelProvider),
-		subagentModelName: asString(initialParams.subagentModelName),
-		modelReasoningEffort: asString(initialParams.modelReasoningEffort),
-		modelTemperature: asString(initialParams.modelTemperature),
-		modelMaxTokens: asString(initialParams.modelMaxTokens),
-		subagentReasoningEffort: asString(initialParams.subagentReasoningEffort),
-		subagentTemperature: asString(initialParams.subagentTemperature),
-		subagentMaxTokens: asString(initialParams.subagentMaxTokens),
-		maxDepth: initialParams.maxDepth,
-		firstTurnWord: asString(initialParams.firstTurnWord) || void 0,
-		presetOrder: config.presetOrder,
-		fallbackText: config.fallbackText,
-		promptConfigs: Array.isArray(initialSpec?.promptConfigs) ? initialSpec.promptConfigs : []
-	};
-	const agentPresetsNs = "agent-preset-registry";
-	let hostSettingsService;
-	const settingsDocument = (service, ns) => service.describe().find((item) => String(item.ns) === ns)?.value;
-	const readHostDefault = (value) => {
-		if (value === null || typeof value !== "object") return void 0;
-		const candidate = value.selectedDefault;
-		return typeof candidate === "string" && candidate.length > 0 ? candidate : void 0;
-	};
-	let agentPresetsService;
-	let modeSelectionWarned = false;
-	/**
-	* 官方 modeSelectionEnabled=false 时忽略 selectedDefault，使用部署 default。
-	*/
-	const modeSelectionEnabled = (value) => {
-		if (value === null || typeof value !== "object") return void 0;
-		const flag = value.modeSelectionEnabled;
-		return typeof flag === "boolean" ? flag : void 0;
-	};
-	const warnModeSelectionOnce = () => {
-		if (modeSelectionWarned) return;
-		modeSelectionWarned = true;
-		warn(ctx, "prompt-tool: 宿主已关闭 agent-preset-registry 模式选择（modeSelectionEnabled=false）：写入 selectedDefault 不影响新会话。请修改 profile 的 agent-preset-registry config.default，或重新开启模式选择。");
-	};
-	/**
-	* 生效默认预设（与官方 selectionPolicy 同源）：开关关闭时 official 只认
-	* `config.default`，该值只有服务 getter 能给出；服务未就绪时返回 undefined，
-	* 由 agentPresets 的迟到回调再对齐一次。
-	*/
-	const effectiveHostDefault = (value) => {
-		const document = value ?? (hostSettingsService === void 0 ? void 0 : settingsDocument(hostSettingsService, agentPresetsNs));
-		if (modeSelectionEnabled(document) !== false && readHostDefault(document) !== void 0) return readHostDefault(document);
-		const effective = agentPresetsService?.defaultId;
-		return typeof effective === "string" && effective.length > 0 ? effective : void 0;
-	};
-	const managedPresetExists = (id) => {
-		try {
-			return listPresets().some((preset) => preset.id === id);
-		} catch {
-			return false;
-		}
-	};
-	/** 把本插件当前预设写进官方 selectedDefault。 */
-	const syncHostDefault = () => {
-		const s = hostSettingsService;
-		if (s === void 0) return;
-		const template = runtime.presetTemplate;
-		if (!/^[a-z0-9][a-z0-9-]*$/.test(template)) {
-			warn(ctx, `prompt-tool: 预设 id ${JSON.stringify(template)} 不符合预设目录命名（^[a-z0-9][a-z0-9-]*$），跳过 selectedDefault 同步`);
-			return;
-		}
-		if (modeSelectionEnabled(settingsDocument(s, agentPresetsNs)) === false) {
-			warnModeSelectionOnce();
-			return;
-		}
-		if (readHostDefault(settingsDocument(s, agentPresetsNs)) === template) return;
-		s.update(agentPresetsNs, { selectedDefault: template }).catch((error) => {
-			warn(ctx, `prompt-tool: 同步宿主 selectedDefault 失败：${error instanceof Error ? error.message : String(error)}`);
-		});
-	};
-	const syncTemplateFromHostDefault = (value, initial = false) => {
-		const s = hostSettingsService;
-		if (s === void 0) return;
-		const raw = effectiveHostDefault(value);
-		if (raw === void 0) return;
-		const template = raw;
-		if (template === runtime.presetTemplate) return;
-		if (!managedPresetExists(template)) {
-			if (initial && managedPresetExists(runtime.presetTemplate)) {
-				syncHostDefault();
-				return;
-			}
-			warn(ctx, `prompt-tool: 官方默认预设已切换为 ${JSON.stringify(template)}，但该预设不在提示词工具管理目录中，跳过反向同步`);
-			return;
-		}
-		s.update(NS, { presetTemplate: template }).catch((error) => {
-			warn(ctx, `prompt-tool: 跟随官方默认预设失败：${error instanceof Error ? error.message : String(error)}`);
-		});
-	};
 	const currentSource = () => ({
 		...readConfig(),
 		modelsAvailable: getModelsState().available
@@ -7511,11 +7347,10 @@ function apply(ctx, configIn) {
 		...currentSource(),
 		skillCatalog: skillsRuntime.listSkills(),
 		activeSkillsDirs: [skillsRuntime.skillsRoot]
-	}), getModelsState, () => listAdvertisedModels(ctx), () => activePresetDir(), (key, value) => {
-		if (key === "promptConfigs") savePresetParams(DEFAULT_PRESET_DIR, runtime.presetTemplate, void 0, Array.isArray(value) ? value : void 0);
-		else savePresetParams(DEFAULT_PRESET_DIR, runtime.presetTemplate, { [key]: value }, void 0);
-		reloadPresetParams();
-		rebuildPreset();
+	}), 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();
 	}, (name, enabled) => {
 		const matches = skillsRuntime.listSkills().filter((skill) => skill.name === name);
 		if (matches.length !== 1) return {
@@ -7534,94 +7369,53 @@ function apply(ctx, configIn) {
 		};
 	});
 	let needsInitialApply = true;
-	const applyState = () => {
+	const applyState = async () => {
 		const next = currentSource();
-		const nextTemplate = typeof next.presetTemplate === "string" && next.presetTemplate.length > 0 ? next.presetTemplate : DEFAULT_PRESET_ID;
-		const nextRuntime = {
-			writePreset: typeof next.writePreset === "boolean" ? next.writePreset : config.writePreset,
-			presetTemplate: nextTemplate,
-			presetOrder: Number.isSafeInteger(next.presetOrder) && next.presetOrder >= 0 ? next.presetOrder : config.presetOrder,
-			fallbackText: typeof next.fallbackText === "string" ? next.fallbackText : config.fallbackText
-		};
-		const fallbackTextChanged = runtime.fallbackText !== nextRuntime.fallbackText;
-		const presetTemplateChanged = runtime.presetTemplate !== nextRuntime.presetTemplate;
-		const settingsChanged = runtime.writePreset !== nextRuntime.writePreset || runtime.presetTemplate !== nextRuntime.presetTemplate || runtime.presetOrder !== nextRuntime.presetOrder || fallbackTextChanged;
-		if (!needsInitialApply && !settingsChanged) return;
+		const nextRuntime = { writePreset: typeof next.writePreset === "boolean" ? next.writePreset : config.writePreset };
+		const writePresetChanged = runtime.writePreset !== nextRuntime.writePreset;
+		if (!needsInitialApply && !writePresetChanged) return;
 		const initial = needsInitialApply;
 		needsInitialApply = false;
-		if (presetTemplateChanged) {
-			const newDir = join(DEFAULT_PRESET_DIR, /^[a-zA-Z0-9\u4e00-\u9fff_-]+$/.test(nextRuntime.presetTemplate) ? nextRuntime.presetTemplate : DEFAULT_PRESET_ID);
-			current = readGeneratedContent(newDir, "preset.md") || readPromptFile(nextRuntime.presetTemplate, nextRuntime.fallbackText);
-			currentAgents = readGeneratedContent(newDir, "agents.md") || readAgents(nextRuntime.presetTemplate);
+		Object.assign(runtime, nextRuntime);
+		if (initial) {
+			for (const id of seededPresets) materialize(id);
+			seededPresets.clear();
 		}
-		runtime.writePreset = nextRuntime.writePreset;
-		runtime.presetTemplate = nextRuntime.presetTemplate;
-		runtime.presetOrder = nextRuntime.presetOrder;
-		runtime.fallbackText = nextRuntime.fallbackText;
-		rebuildPreset(initial);
-		if (presetTemplateChanged) syncHostDefault();
+		await assembly?.refresh();
 	};
-	ctx.provide("pt-character-tools", { mount: (scopeCtx) => registerCharacterTools(scopeCtx, {
-		presetRoot: () => dirname(activePresetDir()),
-		templateName: () => basename(activePresetDir()),
-		rebuild: () => {
-			try {
-				rebuildPreset();
-			} catch (error) {
-				warn(ctx, "prompt-tool: character tool rebuild failed: " + String(error));
-			}
-		}
-	}) });
-	ctx.provide("pt-world-book-tools", { mount: (scopeCtx) => registerWorldBookTools(scopeCtx, {
-		activeDir: () => activePresetDir(),
-		presetRoot: () => dirname(activePresetDir()),
-		rebuild: () => {
-			try {
-				rebuildPreset();
-			} catch (error) {
-				warn(ctx, "prompt-tool: world-book tool rebuild failed: " + String(error));
-			}
-		}
-	}) });
+	const moduleToolHost = {
+		target: (exec) => resolveModuleToolTarget(exec, MODULES_DIR, (sessionId) => assembly?.moduleIds(sessionId) ?? []),
+		rebuild: (id) => rebuildPreset(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) });
 	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)) : [],
+			warn: (message) => warn(ctx, message)
+		});
+		assembly = mounted;
+		actx.effect(() => () => {
+			if (assembly === mounted) assembly = void 0;
+			return mounted.dispose();
+		}, "prompt-tool assembly");
+	});
 	const applyConfig = () => {
 		settingsBridge.invalidateDescriptor();
-		try {
-			applyState();
-		} catch (error) {
-			warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`);
-		}
+		applyState().catch((error) => warn(ctx, `prompt-tool: applyState failed: ${error instanceof Error ? error.message : String(error)}`));
 	};
 	applyConfig();
 	ctx.effect(() => ctx.on("loader/volatile-update", applyConfig));
-	ctx.inject(["agentPresets"], (apctx) => {
-		agentPresetsService = apctx.get("agentPresets");
-		const sync = createPresetRegistrySync(apctx, DEFAULT_PRESET_DIR);
-		registrySync = sync;
-		apctx.effect(() => async () => {
-			if (registrySync === sync) {
-				registrySync = void 0;
-				agentPresetsService = void 0;
-			}
-			await sync.dispose();
-		});
-		sync.refresh().catch((error) => warn(ctx, `prompt-tool: 初始预设注册失败：${String(error)}`));
-		syncTemplateFromHostDefault(void 0, true);
-	});
 	ctx.inject(["settings"], (sctx) => {
-		hostSettingsService = sctx.settings;
 		sctx.effect(() => sctx.settings.configure({ auto: false }, ctx.fiber));
-		sctx.effect(() => () => {
-			if (hostSettingsService === sctx.settings) hostSettingsService = void 0;
-		});
 		sctx.effect(() => sctx.on("settings/document-updated", (ns) => {
-			if (String(ns) === agentPresetsNs) syncTemplateFromHostDefault();
 			if (String(ns) === "prompt-tool") applyConfig();
 		}), "prompt-tool: follow settings documents");
 		settingsBridge.invalidateDescriptor();
-		syncTemplateFromHostDefault(void 0, true);
 	});
 }
 //#endregion
-export { BRIDGE_ENDPOINTS, CHARACTER_MODULES_KEY, Config, DEFAULT_PRESET_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, PromptSettingsSchema, 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, listPresets, listWorldBookEntries, loadPresetSpec, loadPromptTemplates, loadToolTemplates, mergeInstructionCards, mergeStPresets, name, parseFrontmatter, peekModelCatalog, presetImportPreview, processStText, readAgentsFileSnapshot, readCharacterMemory, readSkillInvocation, readSkillsState, recordedCharacterModules, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeCharacterFromPreset, removeEngineCapabilityFromPreset, removePresetModule, removeUserPreset, renderComposition, requiredCharacterModules, resolvePresetDir, resolvePresetModuleFacts, resolvePresetParams, resolveProfileDir, resolveProjectRoot, resolveSubagentStartOptions, savePresetParams, savePresetPersona, scanRoot, scanRoots, scheduleWebSurfaceRepair, scopeOfInvocation, setSkillInvocation, skillRoots, skillsStatePath, stPresetId, syncImportedCharacterMemory, upsertWorldBookEntry, userPresetsDir, validateCustomToolIdentities, validateEngineParamValues, validatePromptConfigs, writeAgentsFile, writeAgentsFileChecked, writePreset, writeSkillsState };
+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 };