dsh-plugin-prompt-tool 2.0.1 → 2.1.0

package/lib/index.mjs

@@ -1,7 +1,7 @@
-import { $ as wireTriggerObservers, A as packageEngineDir, At as INJECTION_POINT_ORDER, B as userModulesDir, Bt as validateEngineParamValues, C as ensureModuleSeed, Ct as assertModuleTree, D as loadModuleSpec, Dt as readPersonaSpec, E as listModules, F as resolveModuleDir, Ft as validateCustomToolIdentities, Gt as USER_SKILLS_DIR, H as editModuleRules, Ht as DSH_HOME, I as resolveModuleFacts, It as ENGINE_PARAM_DEFINITIONS, J as rulePromptConfigOptions, K as ensureModuleSlices, L as resolveModuleParams, Lt as ENGINE_PARAM_KEYS, M as removeModuleCapabilityDeclaration, Mt as engineRecipe, N as removeUserModule, Nt as isModuleCapabilityPresent, O as moduleDirExists, Ot as ENGINE_EDITOR_GROUP_MAP, P as renderComposition, Pt as moduleCapability, R as saveModuleParams, Rt as WRITER_PARAM_KEYS, S as duplicateUserModule, St as assertModuleId, T as listBuiltinTemplates, Tt as modulePathExists, U as readModuleRules, Ut as MODULES_DIR, V as withModuleDefinition, Vt as LEGACY_PROMPT_PARAM_KEYS, W as ModuleRulesError, Z as compileRules, _ as applyModuleConfigs, _t as RULE_OWNED_MODEL_PARAMS, at as runPreStepBatch, b as cloneBuiltinModule, bt as readModuleLayerSettings, c as readConfigOrder, ct as actionMatches, d as assertSafeConfigId, et as compileWhen, f as configFileName, g as appendModuleCapabilities, gt as atomicWriteTextFile, h as setModuleEnabled, ht as createWarnOnce, it as confirmDelivered, j as removeModuleCapability, jt as MODULE_CAPABILITIES, k as openModuleLocation, kt as ENGINE_RECIPES, l as readModuleConfigOrder, lt as ruleFrame, m as resolveEditDir, mt as PROMOTE_EVENTS, nt as prepareAction, o as ModuleConfigOrderError, ot as lastWorldBookDiagnostics, p as enabledModuleIds, pt as createEpochPromotion, q as loadModuleDefinition, rt as applyPromptConfigSources, s as appendModuleConfigOrder, st as wireLayers, tt as loadStandingMountFor, u as saveModuleConfigOrder, ut as compareConfigSequence, vt as ModuleLayerSettingsError, wt as canonicalModulesRoot, x as createModuleCapability, xt as assertModuleDirectory, y as buildModuleConfigsFromParams, z as saveModulePersona, zt as moduleParamFallbacks } from "./rules-migration-DJ6vASB5.mjs";
-import { C as mergeStModulesWithReport, D as deleteWorldBookEntry, E as buildWorldBookEntry, M as DEFAULT_MODULE_ID, O as listWorldBookEntries, S as mergeStModules, T as stModuleId, _ as readModuleMemory, a as installModulePackage, b as convertStToModule, c as writeModule, d as validateCustomTools, f as safeAssetPath, g as mergeModuleIntoModule, h as importCharacterCardFile, i as exportModulePackage, j as ruleInjections, k as upsertWorldBookEntry, l as writePreset, m as importCharacterCard, o as moduleImportPreview, p as appendModuleMemory, r as expandModuleSource, s as ensureModuleReady, u as compileCustomTool, v as removeMergedModule, w as processStText, x as convertStToModuleWithReport, y as prepareImport } from "./module-package-Cnd1_mwx.mjs";
+import { A as packageEngineDir, At as modulePathExists, B as userModulesDir, Bt as validateCustomToolIdentities, C as ensureModuleSeed, Ct as ModuleLayerSettingsError, D as loadModuleSpec, Dt as assertModuleId, E as listModules, Et as assertModuleDirectory, F as resolveModuleDir, Ft as INJECTION_POINT_ORDER, Gt as validateEngineParamValues, H as editModuleRules, Ht as ENGINE_PARAM_KEYS, I as resolveModuleFacts, It as MODULE_CAPABILITIES, J as loadModuleDefinition, L as resolveModuleParams, Lt as engineRecipe, M as removeModuleCapabilityDeclaration, Mt as readPersonaSpec, N as removeUserModule, Nt as ENGINE_EDITOR_GROUP_MAP, O as moduleDirExists, Ot as assertModuleTree, P as renderComposition, Pt as ENGINE_RECIPES, Q as compileRules, Qt as USER_SKILLS_DIR, R as saveModuleParams, Rt as isModuleCapabilityPresent, S as duplicateUserModule, St as RULE_OWNED_MODEL_PARAMS, T as listBuiltinTemplates, Tt as readModuleLayerSettings, U as readModuleRules, Ut as WRITER_PARAM_KEYS, V as withModuleDefinition, Vt as ENGINE_PARAM_DEFINITIONS, W as ModuleRulesError, Wt as moduleParamFallbacks, Xt as MODULES_DIR, Y as rulePromptConfigOptions, Yt as DSH_HOME, _ as applyModuleConfigs, _t as createEpochPromotion, a as appendModuleConfigOrder, at as confirmDelivered, b as cloneBuiltinModule, bt as createWarnOnce, c as saveModuleConfigOrder, ct as wireLayers, et as wireTriggerObservers, g as appendModuleCapabilities, h as setModuleEnabled, i as ModuleConfigOrderError, it as applyPromptConfigSources, j as removeModuleCapability, k as openModuleLocation, kt as canonicalModulesRoot, l as assertSafeConfigId, lt as actionMatches, m as resolveEditDir, mt as compareConfigSequence, nt as loadStandingMountFor, o as readConfigOrder, ot as runPreStepBatch, p as enabledModuleIds, q as ensureModuleSlices, qt as LEGACY_PROMPT_PARAM_KEYS, rt as prepareAction, s as readModuleConfigOrder, st as lastWorldBookDiagnostics, tt as compileWhen, u as configFileName, ut as ruleFrame, x as createModuleCapability, xt as atomicWriteTextFile, y as buildModuleConfigsFromParams, yt as PROMOTE_EVENTS, z as saveModulePersona, zt as moduleCapability } from "./rule-builder-DMrJten6.mjs";
+import { C as mergeStModulesWithReport, D as deleteWorldBookEntry, E as buildWorldBookEntry, M as DEFAULT_MODULE_ID, O as listWorldBookEntries, S as mergeStModules, T as stModuleId, _ as readModuleMemory, a as installModulePackage, b as convertStToModule, c as writeModule, d as validateCustomTools, f as safeAssetPath, g as mergeModuleIntoModule, h as importCharacterCardFile, i as exportModulePackage, j as ruleInjections, k as upsertWorldBookEntry, l as writePreset, m as importCharacterCard, o as moduleImportPreview, p as appendModuleMemory, r as expandModuleSource, s as ensureModuleReady, u as compileCustomTool, v as removeMergedModule, w as processStText, x as convertStToModuleWithReport, y as prepareImport } from "./module-package-q2gDRu9H.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 { accessSync, chmodSync, constants, cpSync, 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";
@@ -1095,6 +1095,35 @@ function deleteSkillTarget(allowedRoots, path) {
 		};
 	}
 }
+/** 包根 `skills/` 目录：随包分发的**内置技能库**（目录形态与用户技能根同构）。兼容源码与打包运行。 */
+function packageSkillsDir() {
+	const candidates = [new URL("../skills/", import.meta.url), new URL("../../skills/", import.meta.url)];
+	for (const candidate of candidates) {
+		const dir = fileURLToPath(candidate);
+		if (existsSync(dir)) return dir;
+	}
+	throw new Error("prompt-tool: cannot locate package skills/ directory");
+}
+/**
+* 按包内同名目录补建缺失的内置技能；已有目录的正文、资源与调用策略保持原样。
+*
+* 与内置模块的种子化同一纪律：只补缺失项，用户改过或删过的技能不会被重新铺写；
+* 失败（包内无 `skills/`、目标不可写等）不阻断启动，用户仍可经 UI 创建或导入。
+*/
+function ensureSkillSeed(root = USER_SKILLS_DIR) {
+	const created = [];
+	try {
+		mkdirSync(root, { recursive: true });
+		for (const entry of readdirSync(packageSkillsDir(), { withFileTypes: true })) {
+			if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
+			const target = join(root, entry.name);
+			if (existsSync(target)) continue;
+			cpSync(join(packageSkillsDir(), entry.name), target, { recursive: true });
+			created.push(entry.name);
+		}
+	} catch {}
+	return { created };
+}
 //#endregion
 //#region src/host/asset-sources.ts
 /** 原始上传只进入当前 bridge 生命周期拥有的暂存目录。 */
@@ -7031,6 +7060,7 @@ function warn(ctx, message) {
 }
 function apply(ctx, configIn) {
 	const seededModules = new Set(ensureModuleSeed(MODULES_DIR).created);
+	ensureSkillSeed();
 	const readConfig = () => ({ modulesEnabled: readModulesEnabled({
 		modulesEnabled: configIn.modulesEnabled?.get(),
 		writePreset: configIn.writePreset?.get()

package/lib/migrate-rules.mjs

@@ -1,5 +1,576 @@
 #!/usr/bin/env node
-import { a as rollbackRulesMigration, r as planRulesMigration, t as applyRulesMigration } from "./rules-migration-DJ6vASB5.mjs";
+import { $ as injectionConfigSpec, Ct as ModuleLayerSettingsError, Et as assertModuleDirectory, Jt as isLegacyPromptParam, K as decomposeModule, Kt as LEGACY_PROMPT_PARAM_DEFINITIONS, Ot as assertModuleTree, Q as compileRules, St as RULE_OWNED_MODEL_PARAMS, Tt as readModuleLayerSettings, X as validateModuleDefinitionText, Y as rulePromptConfigOptions, Z as withModuleLock, Zt as MODULE_DEFINITION_FILE, d as mergePromptConfigs, dt as createPromptConfigs, f as modelRequestConfigs, ft as loadPromptConfigFiles, kt as canonicalModulesRoot, n as legacyPolicyDefaults, o as readConfigOrder, pt as FILE_SEQUENCE, qt as LEGACY_PROMPT_PARAM_KEYS, r as promptConfigToRule, t as fillMissing, vt as actionExecutionPoint, w as invalidateModuleSpec, xt as atomicWriteTextFile } from "./rule-builder-DMrJten6.mjs";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { isMap, isSeq, parseDocument } from "yaml";
+import { createHash } from "node:crypto";
+//#region src/host/legacy-prompt-params.ts
+/** 旧层参数到规则实例的唯一兼容投影；读取、导入物化与旧 API 保存共用。 */
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const text = (value) => value === void 0 || value === null ? "" : String(value);
+function readLegacyPromptParams(source) {
+	const params = {};
+	if (!isRecord(source.layerSettings)) return params;
+	for (const [layer, settings] of Object.entries(source.layerSettings)) {
+		if (!isRecord(settings)) continue;
+		for (const [key, value] of Object.entries(settings)) {
+			if (!isLegacyPromptParam(key)) continue;
+			if (layer !== "pre-step") throw new ModuleLayerSettingsError(`${key} 必须位于 layerSettings.pre-step`);
+			params[key] = value === "on" ? true : value === "off" ? false : value;
+		}
+	}
+	return params;
+}
+function legacyBody(source, moduleDir, supplied) {
+	if (supplied !== void 0) return supplied;
+	if (moduleDir !== void 0) try {
+		const file = join(moduleDir, "preset.md");
+		if (lstatSync(file).isSymbolicLink()) throw new Error(`旧模块正文不能是链接：${file}`);
+		return readFileSync(file, "utf8");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	return text(source.content?.presetText);
+}
+function resolveLegacyPromptConfigs(source, options = {}) {
+	const params = readLegacyPromptParams(source);
+	for (const [key, value] of Object.entries(options.overrides ?? {})) if (isLegacyPromptParam(key) && value !== void 0 && value !== null) params[key] = value;
+	const keys = LEGACY_PROMPT_PARAM_KEYS.filter((key) => Object.hasOwn(params, key));
+	const applies = (id) => keys.some((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.includes(id));
+	const provided = (key) => options.partial !== true || Object.hasOwn(params, key);
+	const projected = (source.promptConfigs ?? []).map((config) => {
+		if (!isRecord(config) || !applies(config.id)) return config;
+		const next = {
+			...config,
+			params: { ...config.params }
+		};
+		if (config.id === "near-anchor") {
+			if (provided("firstTurnAnchor")) next.enabled = params.firstTurnAnchor === true;
+			if (provided("firstTurnCustom")) next.params.useCustom = params.firstTurnCustom === true;
+			if (provided("firstTurnText")) next.params.text = text(params.firstTurnText);
+			for (const key of [
+				"buildPattern",
+				"complexPattern",
+				"firstTurnBuild",
+				"firstTurnInspect",
+				"firstTurnDeep"
+			]) if (provided(key)) next.params[key] = text(params[key]);
+		} else if (config.id === "router-guide") {
+			if (provided("guideEnabled")) next.enabled = params.guideEnabled === true;
+			if (provided("guideCustom") || provided("guideEnabled")) {
+				const useCustom = provided("guideCustom") ? params.guideCustom === true : next.params.useCustom === true;
+				next.params.useCustom = useCustom;
+				next.modelScope = useCustom ? "all" : "flash";
+			}
+			if (provided("guideText")) next.params.text = text(params.guideText);
+			for (const key of [
+				"complexPattern",
+				"guideWeak",
+				"guideDeep"
+			]) if (provided(key)) next.params[key] = text(params[key]);
+		}
+		return next;
+	});
+	const configs = mergePromptConfigs(projected, options.promptConfigs).map((config) => {
+		if (config.id !== "prompt-injector" || !applies(config.id)) return config;
+		const body = legacyBody(source, options.moduleDir, options.prompt);
+		const explicitWord = text(options.partial === true && Object.hasOwn(params, "firstTurnWord") ? params.firstTurnWord : config.params?.firstTurnWord ?? params.firstTurnWord);
+		const anchor = projected.find((entry) => entry.id === "near-anchor");
+		const signalWord = (value) => {
+			const sentence = /the exact sentence:\s*([A-Za-z]+)/i.exec(value);
+			const first = /^\P{L}*([\p{L}]+)/u.exec(value.trim());
+			return (sentence?.[1] ?? first?.[1])?.toLowerCase();
+		};
+		const derivedWords = [...new Set([
+			"firstTurnText",
+			"firstTurnBuild",
+			"firstTurnInspect",
+			"firstTurnDeep"
+		].map((key) => signalWord(text(Object.hasOwn(params, key) || options.partial !== true ? params[key] : anchor?.params?.[key === "firstTurnText" ? "text" : key]))).filter((word) => word !== void 0))];
+		const { text: _text, texts: _texts, ...rest } = config;
+		return {
+			...rest,
+			enabled: body.trim().length > 0 && (provided("injectPrompt") ? params.injectPrompt !== false : config.enabled !== false),
+			params: {
+				...config.params,
+				text: body,
+				firstTurnWord: explicitWord,
+				anchorWords: explicitWord.length > 0 ? [explicitWord] : derivedWords
+			}
+		};
+	});
+	const ids = new Set(configs.map((config) => config.id));
+	const consumedKeys = keys.filter((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.some((id) => ids.has(id)));
+	const unhandled = keys.filter((key) => !consumedKeys.includes(key));
+	return {
+		configs,
+		consumedKeys,
+		active: keys.length > 0,
+		warnings: unhandled.length === 0 ? [] : [`旧规则参数没有承接配置，原值保留：${unhandled.join(", ")}`]
+	};
+}
+//#endregion
+//#region src/host/rules-migration.ts
+/** 旧规则只在显式离线迁移或外部导入时转换；运行时不调用此模块。 */
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const condition = (items) => items.length === 0 ? void 0 : items.length === 1 ? items[0] : { all: items };
+/** 只递归条件语法树；正文、正则字符串及未知对象字段均不扫描或改写。 */
+function migrateConditionDefaults(value) {
+	if (!record(value)) return value;
+	if (Object.keys(value).length !== 1) return value;
+	if (record(value.phase) && value.phase.promoteGate === true) {
+		const phase = structuredClone(value.phase);
+		fillMissing(phase, legacyPolicyDefaults().promotionGate);
+		return { phase };
+	}
+	for (const key of [
+		"all",
+		"any",
+		"notAny"
+	]) if (Array.isArray(value[key])) return { [key]: value[key].map(migrateConditionDefaults) };
+	if (Object.hasOwn(value, "not")) return { not: migrateConditionDefaults(value.not) };
+	return value;
+}
+/** 参数桥优先于行配置；仅旧定义里确已打开的指令提示才携入旧非空模板。 */
+function instructionHintPolicyPatch(source) {
+	const params = readModuleLayerSettings(source);
+	const modules = record(source.moduleConfigs) ? source.moduleConfigs : {};
+	const current = record(modules["instruction-hint"]) ? modules["instruction-hint"] : {};
+	if (!(Object.hasOwn(params, "instructionHint") ? params.instructionHint === true : current.enabled === true)) return void 0;
+	const patched = { ...current };
+	fillMissing(patched, legacyPolicyDefaults().instructionHint);
+	return JSON.stringify(current) === JSON.stringify(patched) ? void 0 : patched;
+}
+function rebaseTemplate(config, directory, previousBase) {
+	if (typeof config.templateFile !== "string" || config.templateFile.length === 0) return config;
+	const resolved = isAbsolute(config.templateFile) ? resolve(config.templateFile) : fileURLToPath(new URL(config.templateFile, previousBase));
+	const path = relative(directory, resolved);
+	if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path)) throw new Error(`模板路径不在模块目录，无法安全迁移：${config.templateFile}`);
+	if (!existsSync(resolved)) throw new Error(`模板文件缺失，无法验证迁移：${config.templateFile}`);
+	return {
+		...config,
+		templateFile: `./${path.replaceAll(sep, "/")}`
+	};
+}
+function convertLegacyModuleRules(source, options = {}) {
+	if (!record(source)) throw new TypeError("模块定义必须是对象");
+	const directory = options.directory;
+	const legacy = resolveLegacyPromptConfigs(source, { moduleDir: directory });
+	if (legacy.warnings.length > 0) throw new Error(`旧快捷参数没有无损承接规则：${legacy.warnings.join("; ")}`);
+	if (source.promptConfigs !== void 0 && !Array.isArray(source.promptConfigs)) throw new Error("promptConfigs 必须是数组");
+	if (source.triggers !== void 0 && !Array.isArray(source.triggers)) throw new Error("triggers 必须是数组");
+	if (source.rules !== void 0 && !Array.isArray(source.rules)) throw new Error("rules 必须是数组");
+	const root = directory === void 0 ? void 0 : dirname(directory);
+	let configs = mergePromptConfigs(modelRequestConfigs(readModuleLayerSettings(source)), legacy.configs);
+	const rules = structuredClone(source.rules ?? []);
+	const configOrder = readConfigOrder(source.configOrder);
+	if (directory !== void 0 && existsSync(join(directory, "configs"))) {
+		const actual = loadPromptConfigFiles(pathToFileURL(join(directory, "configs") + sep));
+		for (const [index, config] of actual.entries()) if (configOrder[config.id] === void 0) configOrder[config.id] = config[FILE_SEQUENCE] ?? index * 10;
+		if (!Object.hasOwn(source, "promptConfigs") && configs.length === 0) configs = actual;
+		else {
+			const options = {
+				sourceModuleId: source.id,
+				configOrder,
+				templateBaseUrl: pathToFileURL(join(root, ".engine", "prompt-config-engine.mjs")),
+				templateModuleRoot: pathToFileURL(root + sep)
+			};
+			const prepared = configs.map((config) => injectionConfigSpec({ id: config.id }, {
+				id: "inject",
+				kind: "inject-text",
+				config
+			}, source));
+			const comparable = (config) => config.strategy === "custom-fallback" ? {
+				...config,
+				strategy: "anchor-notice"
+			} : config;
+			const expected = createPromptConfigs(prepared.map(comparable), options);
+			const running = createPromptConfigs(actual.map(comparable), options);
+			const fingerprint = (entries) => contentHash(entries.map((config) => {
+				const value = { ...config };
+				if (value.enabled === false) delete value.texts;
+				return value;
+			}));
+			if (fingerprint(expected) !== fingerprint(running)) throw new Error(`模块 ${String(source.id ?? directory)} 的定义与旧实际物化内容不一致，无法无损迁移；请先明确选择来源`);
+		}
+	}
+	const append = (rule, sequence) => {
+		if (rules.some((item) => item.id === rule.id)) throw new Error(`规则身份冲突，须先明确改名：${rule.id}`);
+		rules.push(rule);
+		if (configOrder[rule.id] === void 0) configOrder[rule.id] = sequence;
+	};
+	for (const [index, config] of configs.entries()) {
+		const rebased = directory === void 0 ? config : rebaseTemplate(config, directory, pathToFileURL(join(root, ".engine", "prompt-config-engine.mjs")));
+		append(promptConfigToRule(rebased), index * 10);
+	}
+	for (const [index, raw] of (source.triggers ?? []).entries()) {
+		if (!record(raw) || typeof raw.id !== "string" || raw.id.length === 0) throw new Error("旧声明必须有唯一 id");
+		const rawActions = Array.isArray(raw.do) ? raw.do : [raw.do];
+		let enabled;
+		const gates = raw.when == null ? [] : [migrateConditionDefaults(raw.when)];
+		const liftCondition = (gate) => {
+			if (gate === void 0) return;
+			if (rawActions.length !== 1) throw new Error(`声明 ${raw.id} 的动作局部条件不能无损提升为整卡条件；请先拆分声明`);
+			gates.push(gate);
+		};
+		const actions = rawActions.map((action, actionIndex) => {
+			if (!record(action) || typeof action.kind !== "string") throw new Error(`旧声明 ${raw.id} 的动作不合法`);
+			const point = actionExecutionPoint(action);
+			if (raw.channel !== point.channel || raw.phase !== void 0 && raw.phase !== point.phase) throw new Error(`旧声明 ${raw.id} 的执行点不合法`);
+			const next = structuredClone(action);
+			if (next.kind === "inject-text" && record(next.config)) {
+				const converted = promptConfigToRule(next.config);
+				if (converted.enabled === false && rawActions.length !== 1) throw new Error(`声明 ${raw.id} 的动作局部停用不能无损提升为整卡开关；请先拆分声明`);
+				if (rawActions.length === 1) enabled = converted.enabled;
+				liftCondition(converted.if);
+				const payload = converted.then[0]?.config;
+				const config = {
+					...next.config,
+					...record(payload) ? payload : {}
+				};
+				delete config.enabled;
+				const params = record(config.params) ? config.params : {};
+				if (params.complete !== true && params.suppressRuntimeContext !== true) for (const key of [
+					"audience",
+					"modelScope",
+					"promotion",
+					"subject",
+					"match"
+				]) delete config[key];
+				next.config = config;
+			}
+			if (next.kind === "request-params") {
+				const modelScope = Object.hasOwn(next, "modelScope") ? next.modelScope : "pro";
+				const scope = {
+					...next.audience == null || next.audience === "" ? {} : { audience: next.audience },
+					...modelScope == null || modelScope === "" || modelScope === "all" ? {} : { modelScope }
+				};
+				if (Object.keys(scope).length > 0) liftCondition({ scope });
+				delete next.audience;
+				delete next.modelScope;
+			}
+			if (next.kind === "inject-text" && record(next.config) && directory !== void 0) next.config = rebaseTemplate(next.config, directory, pathToFileURL(join(directory, "triggers.yml")));
+			return {
+				...next,
+				id: typeof next.id === "string" && next.id.length > 0 ? next.id : `action-${actionIndex + 1}`,
+				kind: action.kind,
+				channelOrder: typeof raw.channelOrder === "number" ? raw.channelOrder : 0,
+				...raw.waterfallPosition === void 0 ? {} : { waterfallPosition: raw.waterfallPosition }
+			};
+		});
+		if (actions.length > 1 && actions.some((action) => actionExecutionPoint(action).phase === "after-next")) throw new Error(`声明 ${raw.id} 含多个 after-next 动作，须先核对实际执行顺序再迁移`);
+		const layer = actions.find((action) => action.kind === "inject-text" && record(action.config))?.config;
+		append({
+			id: raw.id,
+			...enabled === void 0 ? {} : { enabled },
+			...layer?.layer === void 0 ? {} : { layer: layer.layer },
+			...condition(gates) === void 0 ? {} : { if: condition(gates) },
+			then: actions
+		}, (configs.length + index) * 10);
+	}
+	compileRules(rules, {
+		configOrder,
+		...directory === void 0 ? {} : {
+			moduleId: source.id,
+			promptConfigOptions: rulePromptConfigOptions(directory)
+		}
+	});
+	return {
+		rules,
+		configOrder,
+		consumedLegacyKeys: Object.keys(readLegacyPromptParams(source))
+	};
+}
+const MODEL_KEYS = RULE_OWNED_MODEL_PARAMS;
+const OLD_ENGINES = /* @__PURE__ */ new Set(["prompt-config-engine", "declared-triggers"]);
+const digest = (value) => createHash("sha256").update(value).digest("hex");
+const sortedValue = (value) => Array.isArray(value) ? value.map(sortedValue) : record(value) ? Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortedValue(value[key])])) : value;
+const contentHash = (value) => digest(JSON.stringify(sortedValue(value)));
+/** 原证明仍匹配旧卡时才推进角色记忆哈希；用户改过的卡保持未认领。 */
+function migrateMemoryProofs(doc, source, rules) {
+	const proofs = record(source.meta) && record(source.meta.characterMemories) ? source.meta.characterMemories : {};
+	const configs = Array.isArray(source.promptConfigs) ? source.promptConfigs : [];
+	for (const [cardId, proof] of Object.entries(proofs)) {
+		if (!record(proof) || typeof proof.configId !== "string") continue;
+		const old = configs.find((config) => record(config) && config.id === proof.configId);
+		const rule = rules.find((item) => item.id === proof.configId);
+		if (old !== void 0 && rule !== void 0 && proof.contentHash === contentHash(old)) doc.setIn([
+			"meta",
+			"characterMemories",
+			cardId,
+			"contentHash"
+		], contentHash(rule));
+	}
+}
+/** 旧字段移入动作后仍把原注释保留在所属规则上，不把用户说明随旧段删除。 */
+function setMigratedRules(doc, rules) {
+	const comments = (node) => {
+		const own = record(node) ? [node.commentBefore, node.comment].filter((value) => typeof value === "string" && value.length > 0) : [];
+		if (isMap(node)) return [...own, ...node.items.flatMap((pair) => [...comments(pair.key), ...comments(pair.value)])];
+		if (isSeq(node)) return [...own, ...node.items.flatMap(comments)];
+		return own;
+	};
+	const previous = [
+		"rules",
+		"promptConfigs",
+		"triggers"
+	].map((key) => doc.get(key, true)).filter(isSeq);
+	const nodes = doc.createNode(rules);
+	if (isSeq(nodes)) {
+		const groupComments = previous.flatMap((node) => [node.commentBefore, node.comment].filter((value) => typeof value === "string"));
+		if (groupComments.length > 0) nodes.commentBefore = groupComments.join("\n");
+		for (const node of nodes.items) if (isMap(node)) {
+			const text = comments(previous.flatMap((item) => item.items).find((item) => isMap(item) && item.get("id") === node.get("id"))).join("\n");
+			if (text.length > 0) node.commentBefore = text;
+		}
+	}
+	doc.set("rules", nodes);
+}
+function assertAssetDirectory(root, id, definitionFile) {
+	if (definitionFile !== "module.yml") throw new Error("迁移只接受模块定义");
+	return assertModuleDirectory(root, id);
+}
+/** 包括资产和生成物的整个模块指纹；回滚不覆盖迁移后出现的任意用户改动。 */
+function treeHash(directory) {
+	assertModuleTree(directory);
+	const hash = createHash("sha256");
+	const visit = (dir) => {
+		for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
+			const file = join(dir, entry.name);
+			const key = relative(directory, file).replaceAll(sep, "/");
+			hash.update(JSON.stringify([
+				key,
+				entry.isDirectory() ? "directory" : "file",
+				lstatSync(file).mode
+			]));
+			if (entry.isDirectory()) visit(file);
+			else hash.update(readFileSync(file));
+		}
+	};
+	visit(directory);
+	return hash.digest("hex");
+}
+/** 全量只读预检。root 必须显式提供，不从真实 DSH_HOME 推断。 */
+function planRulesMigration(root, options = {}) {
+	if (typeof root !== "string" || root.trim().length === 0 || !isAbsolute(root)) throw new Error("迁移必须显式指定绝对 --root（模块根目录）");
+	const canonical = canonicalModulesRoot(root);
+	const definitionFile = MODULE_DEFINITION_FILE;
+	const items = [];
+	for (const entry of readdirSync(canonical, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+		if (entry.name.startsWith(".")) continue;
+		if (entry.isSymbolicLink() && existsSync(join(canonical, entry.name, definitionFile))) throw new Error(`迁移目录不能是链接：${entry.name}`);
+		if (!entry.isDirectory()) continue;
+		if (!existsSync(join(canonical, entry.name, definitionFile))) continue;
+		const directory = assertAssetDirectory(canonical, entry.name, definitionFile);
+		assertModuleTree(directory);
+		const bytes = readFileSync(join(directory, definitionFile));
+		const doc = parseDocument(new TextDecoder("utf-8", { fatal: true }).decode(bytes), { logLevel: "silent" });
+		if (doc.errors.length > 0) throw new Error(`模块 ${entry.name} YAML 无效：${doc.errors[0].message}`);
+		const source = doc.toJS();
+		if (!record(source)) throw new Error(`模块 ${entry.name} 定义必须是对象`);
+		const layerParams = readModuleLayerSettings(source);
+		const oldModules = Array.isArray(source.modules) && source.modules.some((id) => OLD_ENGINES.has(String(id)));
+		const oldRules = Object.hasOwn(source, "promptConfigs") || Object.hasOwn(source, "triggers") || Object.keys(readLegacyPromptParams(source)).length > 0 || MODEL_KEYS.some((key) => Object.hasOwn(layerParams, key)) || oldModules;
+		const hintPatch = oldRules || !Object.hasOwn(source, "rules") ? instructionHintPolicyPatch(source) : void 0;
+		if (!(oldRules || hintPatch !== void 0)) {
+			validateModuleDefinitionText(directory, doc.toString());
+			if (options.decompose) items.push({
+				moduleId: entry.name,
+				directory,
+				definitionFile,
+				originalHash: treeHash(directory),
+				sourceHash: digest(bytes),
+				nextDefinition: new TextDecoder("utf-8", { fatal: true }).decode(bytes)
+			});
+			continue;
+		}
+		if (options.decompose) throw new Error(`模块 ${entry.name} 仍含旧规则来源，请先运行 --apply 迁移再分解`);
+		if (!Array.isArray(source.modules)) throw new Error(`模块 ${entry.name} 使用手写组合，无法证明旧引擎装配替换；请先显式整理 modules`);
+		if (record(source.params) && LEGACY_PROMPT_PARAM_KEYS.some((key) => Object.hasOwn(source.params, key))) throw new Error(`模块 ${entry.name} 含曾被运行时忽略的顶层旧参数，无法推测激活语义`);
+		const converted = convertLegacyModuleRules(source, { directory });
+		if (hintPatch !== void 0) {
+			for (const [key, value] of Object.entries(hintPatch)) if (!doc.hasIn([
+				"moduleConfigs",
+				"instruction-hint",
+				key
+			])) doc.setIn([
+				"moduleConfigs",
+				"instruction-hint",
+				key
+			], value);
+		}
+		migrateMemoryProofs(doc, source, converted.rules);
+		setMigratedRules(doc, converted.rules);
+		doc.set("configOrder", converted.configOrder);
+		doc.delete("promptConfigs");
+		doc.delete("triggers");
+		if (Array.isArray(source.modules)) doc.set("modules", [...new Set(source.modules.map((id) => OLD_ENGINES.has(String(id)) ? "rule-engine" : id))]);
+		if (record(source.layerSettings)) {
+			for (const [layer, values] of Object.entries(source.layerSettings)) if (record(values)) {
+				for (const key of [...converted.consumedLegacyKeys, ...MODEL_KEYS]) if (Object.hasOwn(values, key)) doc.deleteIn([
+					"layerSettings",
+					layer,
+					key
+				]);
+			}
+		}
+		if (record(source.moduleConfigs)) {
+			if ([source.moduleConfigs["prompt-config-engine"], source.moduleConfigs["declared-triggers"]].filter(record).map((value) => value.strategyDir).filter((value) => typeof value === "string" && value.length > 0).length > 0) throw new Error(`模块 ${entry.name} 使用自定义策略目录，需先确认统一基准后迁移`);
+			for (const id of OLD_ENGINES) doc.deleteIn(["moduleConfigs", id]);
+		}
+		validateModuleDefinitionText(directory, doc.toString());
+		items.push({
+			moduleId: entry.name,
+			directory,
+			definitionFile,
+			originalHash: treeHash(directory),
+			sourceHash: digest(bytes),
+			nextDefinition: doc.toString()
+		});
+	}
+	return {
+		root: canonical,
+		kind: "modules",
+		items
+	};
+}
+const BACKUP_DIR = ".rules-migration-backup";
+/** 先完整生成所有候选，再复核全根；每个模块以目录 rename 原子交换并保留原树备份。 */
+async function applyRulesMigration(plan) {
+	if (canonicalModulesRoot(plan.root) !== plan.root) throw new Error("迁移根目录身份已变化");
+	if (plan.items.length === 0) return { changed: [] };
+	const backup = join(plan.root, BACKUP_DIR);
+	if (existsSync(backup)) throw new Error(`已存在迁移备份，请先处理：${backup}`);
+	const workspace = mkdtempSync(join(plan.root, ".rules-migration-stage-"));
+	const staged = /* @__PURE__ */ new Map();
+	const manifest = {
+		version: 1,
+		root: plan.root,
+		status: "applying",
+		entries: []
+	};
+	const manifestFile = join(backup, "manifest.json");
+	const verify = (item) => {
+		if (assertAssetDirectory(plan.root, item.moduleId, item.definitionFile) !== item.directory || treeHash(item.directory) !== item.originalHash || digest(readFileSync(join(item.directory, item.definitionFile))) !== item.sourceHash) throw new Error(`来源 ${item.moduleId} 在预检后已变化，未覆盖`);
+	};
+	try {
+		for (const item of plan.items) {
+			verify(item);
+			const source = join(workspace, item.moduleId);
+			cpSync(item.directory, source, {
+				recursive: true,
+				errorOnExist: true,
+				force: false
+			});
+			atomicWriteTextFile(join(source, item.definitionFile), item.nextDefinition);
+			decomposeModule(source);
+			for (const path of [
+				"rules.yml",
+				"configs",
+				"agent.cordis.yml",
+				"custom-tools",
+				"subagent-tools"
+			]) rmSync(join(source, path), {
+				recursive: true,
+				force: true
+			});
+			const generated = source;
+			staged.set(item.moduleId, generated);
+			manifest.entries.push({
+				moduleId: item.moduleId,
+				definitionFile: item.definitionFile,
+				before: item.originalHash,
+				after: treeHash(generated),
+				written: false
+			});
+		}
+		for (const item of plan.items) verify(item);
+		mkdirSync(backup);
+		atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
+		for (const item of plan.items) withModuleLock(plan.root, item.moduleId, () => {
+			verify(item);
+			const old = join(backup, item.moduleId);
+			renameSync(item.directory, old);
+			try {
+				renameSync(staged.get(item.moduleId), item.directory);
+			} catch (error) {
+				if (!existsSync(item.directory)) renameSync(old, item.directory);
+				throw error;
+			}
+			manifest.entries.find((entry) => entry.moduleId === item.moduleId).written = true;
+			invalidateModuleSpec(item.directory);
+			atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
+		});
+		manifest.status = "applied";
+		atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
+		return {
+			changed: plan.items.map((item) => item.moduleId),
+			backup
+		};
+	} catch (error) {
+		for (const entry of [...manifest.entries].reverse()) if (entry.written) {
+			const current = join(plan.root, entry.moduleId);
+			const original = join(backup, entry.moduleId);
+			withModuleLock(plan.root, entry.moduleId, () => {
+				if (existsSync(current) && treeHash(current) === entry.after && existsSync(original)) {
+					const retired = join(workspace, `failed-${entry.moduleId}`);
+					renameSync(current, retired);
+					renameSync(original, current);
+					entry.written = false;
+					invalidateModuleSpec(current);
+				}
+			});
+		}
+		if (existsSync(manifestFile)) atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
+		throw error;
+	} finally {
+		if (dirname(workspace) === plan.root && workspace.startsWith(join(plan.root, ".rules-migration-stage-"))) rmSync(workspace, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function rollbackRulesMigration(root, options = {}) {
+	if (typeof root !== "string" || !isAbsolute(root)) throw new Error("回滚必须显式指定绝对 --root");
+	const canonical = canonicalModulesRoot(root);
+	const backup = join(canonical, BACKUP_DIR);
+	if (lstatSync(backup).isSymbolicLink()) throw new Error("迁移备份不能是链接");
+	const file = join(backup, "manifest.json");
+	const manifest = JSON.parse(readFileSync(file, "utf8"));
+	if (manifest.version !== 1 || manifest.root !== canonical || !Array.isArray(manifest.entries)) throw new Error("迁移备份不属于当前根");
+	if (manifest.status === "rolled-back") return { restored: [] };
+	const targets = manifest.entries.filter((entry) => entry.written);
+	for (const entry of targets) {
+		if (entry.definitionFile !== "module.yml") throw new Error("迁移备份定义类型无效");
+		const current = assertAssetDirectory(canonical, entry.moduleId, entry.definitionFile);
+		const original = assertAssetDirectory(backup, entry.moduleId, entry.definitionFile);
+		if (treeHash(current) !== entry.after || treeHash(original) !== entry.before) throw new Error(`模块 ${entry.moduleId} 或备份已变化，拒绝回滚覆盖`);
+		if (existsSync(join(backup, `${entry.moduleId}.migrated`))) throw new Error(`模块 ${entry.moduleId} 的回滚保留目录已存在`);
+	}
+	if (options.checkOnly === true) return { restored: targets.map((entry) => entry.moduleId) };
+	for (const entry of targets) {
+		const current = join(canonical, entry.moduleId);
+		const retired = join(backup, `${entry.moduleId}.migrated`);
+		withModuleLock(canonical, entry.moduleId, () => {
+			if (treeHash(current) !== entry.after || treeHash(join(backup, entry.moduleId)) !== entry.before) throw new Error(`模块 ${entry.moduleId} 在回滚期间变化，未覆盖`);
+			renameSync(current, retired);
+			try {
+				renameSync(join(backup, entry.moduleId), current);
+			} catch (error) {
+				if (!existsSync(current)) renameSync(retired, current);
+				throw error;
+			}
+			entry.written = false;
+			invalidateModuleSpec(current);
+			atomicWriteTextFile(file, JSON.stringify(manifest, null, 2) + "\n");
+		});
+	}
+	manifest.status = "rolled-back";
+	atomicWriteTextFile(file, JSON.stringify(manifest, null, 2) + "\n");
+	return { restored: targets.map((entry) => entry.moduleId) };
+}
+//#endregion
 //#region src/migrate-rules.ts
 const args = process.argv.slice(2).filter((value) => value !== "--");
 let root;

package/lib/{module-package-CHPFweqK.mjs → module-package-DqJZaE71.mjs}

@@ -1,2 +1,2 @@
-import { a as installModulePackage, o as moduleImportPreview } from "./module-package-Cnd1_mwx.mjs";
+import { a as installModulePackage, o as moduleImportPreview } from "./module-package-q2gDRu9H.mjs";
 export { installModulePackage, installModulePackage as installPresetPackage, moduleImportPreview, moduleImportPreview as presetImportPreview };