dsh-plugin-prompt-tool 0.8.1 → 1.0.0

package/lib/{paths-CY5psBqE.d.mts → paths-BgL42sSM.d.mts}

@@ -1,11 +1,80 @@
 import { parseDocument } from "yaml";
+//#region src/shared/engine-capabilities.d.ts
+type ModuleSourceMode = 'explicit' | 'composition' | 'official' | 'unknown';
+/** 官方九个注入层：与 engine/schema.mjs 的 LAYER_ORDER 同源，改一处必须同步另一处。 */
+type EngineLayer = 'pre-step' | 'system-section' | 'runtime-context' | 'agent-request' | 'llm-stream' | 'tool-pipeline' | 'turn-stop' | 'subagent-start' | 'subagent-end';
+interface ModuleFacts {
+  declaredModules: string[] | null;
+  effectiveModules: string[] | null;
+  rowIds: string[];
+  sourceMode: ModuleSourceMode;
+  editable: boolean;
+  effectiveConfigs?: Record<string, Record<string, unknown>>;
+  /** 策略段真实存在；能力声明仍在并不代表策略已开启。 */
+  subagentToolPolicyEnabled?: boolean;
+}
+interface EngineCapability {
+  id: string;
+  moduleKeys: readonly string[];
+  rowIds: readonly string[];
+  displayLayer: EngineLayer;
+  /** 真实跨层影响的相关层（只在确有第二通道时登记，避免把归属铺满九层）。 */
+  relatedLayers?: readonly EngineLayer[];
+  /**
+   * 该能力拥有的 preset 顶层数据段（不是行级 config）。
+   * 创建时若段缺失则写入 `skeleton`（保证"模块在 ⇒ 数据在"）；删除时一并移除该段。
+   */
+  ownSection?: {
+    /** preset.yml 顶层键名。 */
+    key: string;
+    /** 启用时写入的可用骨架（必须能通过该段的校验）。 */
+    skeleton: Readonly<Record<string, unknown>>;
+  };
+}
+/** 首期只登记已有 typed editor 的能力，避免万能 key/value 表单。 */
+declare const ENGINE_CAPABILITIES: readonly EngineCapability[];
+/**
+ * 编辑组 = 前端一张可编辑卡（能力卡或专用卡）的主归属层。
+ * id 必须是代码里真实存在的 card / 展开键名，不新增臆造 id。
+ */
+interface EngineEditorGroup {
+  id: string;
+  displayLayer: EngineLayer;
+  /** 真实跨层影响的相关层（只有确有第二通道时才写）。 */
+  relatedLayers?: readonly EngineLayer[];
+  /** 真实生效通道的只读说明键（如 'agent-request' / 'system-section'）：供 UI 显示「实际生效通道」，
+   *  只写代码里可核对的事实，不承诺未验证的通道。 */
+  hook: string;
+}
+interface EngineRecipe {
+  id: string;
+  capabilities: readonly string[];
+  initialParams?: Readonly<Record<string, unknown>>;
+}
+/**
+ * 只保留已有真实工作流的一键组合；recipe 本身不写入 preset.yml。
+ *
+ * B7 T3 清空：三条 recipe 的成员都是随本轮退场的专用能力（phase-control /
+ * phase-control-ptc / deliberation），没有任何一条还能组成合法能力集合。
+ * export 与 `engineRecipe()` 保留——调用点（创建菜单、bridge 校验）不必跟着改，
+ * 空表天然让组合项整个消失。
+ */
+declare const ENGINE_RECIPES: readonly EngineRecipe[];
+declare function engineCapability(id: string): EngineCapability | undefined;
+declare function engineRecipe(id: string): EngineRecipe | undefined;
+/** 显式模块声明中的实际能力；包含当前参数与顶层策略所需的装配。
+ *  创建补声明由 host 单独检查 declaredModules；官方组合行不伪装成可编辑能力。 */
+declare function isEngineCapabilityPresent(id: string, facts: ModuleFacts | undefined): boolean;
+/** custom tool 的运行时名称缺省回落 id；保存前拒绝会导致同层注册失败的重复项。 */
+declare function validateCustomToolIdentities(tools: readonly unknown[]): string[];
+//#endregion
 //#region src/shared/instructions.d.ts
 /**
  * 指令文件（AGENTS.md / CLAUDE.md 等）跨 host/client 的最小契约。
  * 只放两端都要理解的形状：读取快照、工作区上下文与写入结果；
  * 引擎侧的位置/晋升/受众算法不在这里复制。
  */
-/** 单个指令文件正文上限（与官方指令行的 maxBytes 基线对齐；读写限制一致）。 */
+/** 文件卡正文读写上限；官方注入的读取与渲染预算由官方配置决定。 */
 declare const MAX_INSTRUCTION_FILE_BYTES: number;
 declare const INSTRUCTION_FILE_STATUSES: readonly ["ready", "missing", "unreadable", "too-large"];
 /**
@@ -53,8 +122,7 @@ interface InstructionsSnapshot {
 }
 /**
  * 指令负责人事实：本会话实际装配里是否仍挂着官方指令加载行。
- * `true` 时独立文件来源整体不参战（同一正文只由一方注入）；`false` 表示由本插件
- * 的独立来源负责；`null` 表示本次请求还没有该会话的装配观察结果（不猜）。
+ * `true` 表示官方负责注入；`false` 表示模块未装配官方来源；`null` 表示尚未观察到。
  */
 interface InstructionsOwnerView {
   officialInstructions: boolean | null;
@@ -65,37 +133,23 @@ interface InstructionFileWriteResult {
   revision: string;
 }
 /**
- * 指令文件卡策略（独立于预设与 settings 的本插件自有状态）。
+ * 指令文件卡策略（独立于模块与 settings 的本插件自有状态）。
  *
- * 只承载行为开关与展示名：正文永远在用户的原文件里，策略不存正文、读取版本、
- * 会话 ID 或任意客户端路径。缺省 `enabled: false`——独立来源必须先完成负责人
- * 切换验收，再由用户显式开启。
+ * 只承载逐文件开关与展示名；正文、读取版本、会话 ID 和路径不进入策略。
+ * 默认放行官方注入，关闭只过滤后续消息，不撤回已持久历史。
  */
-interface InstructionPolicyValues {
-  order: number;
-  position: string;
-  promotion: string;
-  audience: string | null;
-  modelScope: string;
-}
-interface InstructionPolicyFileOverride extends Partial<InstructionPolicyValues> {
-  /** 每文件可关闭注入（默认开启）；部署级 enabled 为 false 时整体不注入。 */
+interface InstructionPolicyFileOverride {
+  /** 缺省开启；false 拦截该文件后续的官方注入。 */
   enabled?: boolean;
   /** 可选显示名（只影响 UI 标题）。 */
   name?: string;
 }
 interface InstructionPolicy {
-  /** 部署级开关：文件来源是否参与注入。 */
-  enabled: boolean;
-  /** 未单独覆盖的文件使用这些值。 */
-  defaults: InstructionPolicyValues;
-  /** 按 fileId 的覆盖；缺省即用 defaults，删除覆盖恢复默认。 */
+  /** 按 fileId 的覆盖；删除覆盖恢复默认放行。 */
   files: Record<string, InstructionPolicyFileOverride>;
 }
 /** 局部更新：只写传入的键；files[fileId] = null 表示删除该覆盖。 */
 interface InstructionPolicyPatch {
-  enabled?: boolean;
-  defaults?: Partial<InstructionPolicyValues>;
   files?: Record<string, InstructionPolicyFileOverride | null>;
 }
 //#endregion
@@ -122,6 +176,28 @@ interface PersonaSpec {
   includeRuntimeContext?: boolean;
 }
 //#endregion
+//#region src/shared/module-config-order.d.ts
+/** 配置卡身份与排序快照；序号归模块定义，正文不进入排序载荷。 */
+interface ModuleConfigIdentity {
+  moduleId: string;
+  configId: string;
+}
+interface ModuleConfigOrderEntry extends ModuleConfigIdentity {
+  name: string;
+  layer: string;
+  position: string;
+  sequence: number;
+  enabled: boolean;
+  audience?: 'main' | 'subagent' | null;
+  strategy?: string;
+  /** 官方文本层的定位档位；其他层不使用。 */
+  order?: number;
+}
+interface ModuleConfigOrderSnapshot {
+  revision: string;
+  entries: ModuleConfigOrderEntry[];
+}
+//#endregion
 //#region src/shared/asset-transfer.d.ts
 /** 资产传输使用显式编码；省略编码仅兼容旧文本请求。 */
 interface AssetFile {
@@ -184,73 +260,6 @@ interface PresetExportResult {
   excludedMemoryCount?: number;
 }
 //#endregion
-//#region src/shared/engine-capabilities.d.ts
-type ModuleSourceMode = 'explicit' | 'composition' | 'official' | 'unknown';
-/** 官方九个注入层：与 engine/schema.mjs 的 LAYER_ORDER 同源，改一处必须同步另一处。 */
-type EngineLayer = 'pre-step' | 'system-section' | 'runtime-context' | 'agent-request' | 'llm-stream' | 'tool-pipeline' | 'turn-stop' | 'subagent-start' | 'subagent-end';
-interface PresetModuleFacts {
-  declaredModules: string[] | null;
-  effectiveModules: string[] | null;
-  rowIds: string[];
-  sourceMode: ModuleSourceMode;
-  editable: boolean;
-  effectiveConfigs?: Record<string, Record<string, unknown>>;
-}
-interface EngineCapability {
-  id: string;
-  moduleKeys: readonly string[];
-  rowIds: readonly string[];
-  displayLayer: EngineLayer;
-  /** 真实跨层影响的相关层（只在确有第二通道时登记，避免把归属铺满九层）。 */
-  relatedLayers?: readonly EngineLayer[];
-  /**
-   * 该能力拥有的 preset 顶层数据段（不是行级 config）。
-   * 创建时若段缺失则写入 `skeleton`（保证"模块在 ⇒ 数据在"）；删除时一并移除该段。
-   */
-  ownSection?: {
-    /** preset.yml 顶层键名。 */
-    key: string;
-    /** 启用时写入的可用骨架（必须能通过该段的校验）。 */
-    skeleton: Readonly<Record<string, unknown>>;
-  };
-}
-/** 首期只登记已有 typed editor 的能力，避免万能 key/value 表单。 */
-declare const ENGINE_CAPABILITIES: readonly EngineCapability[];
-/**
- * 编辑组 = 前端一张可编辑卡（能力卡或专用卡）的主归属层。
- * id 必须是代码里真实存在的 card / 展开键名，不新增臆造 id。
- */
-interface EngineEditorGroup {
-  id: string;
-  displayLayer: EngineLayer;
-  /** 真实跨层影响的相关层（只有确有第二通道时才写）。 */
-  relatedLayers?: readonly EngineLayer[];
-  /** 真实生效通道的只读说明键（如 'agent-request' / 'system-section'）：供 UI 显示「实际生效通道」，
-   *  只写代码里可核对的事实，不承诺未验证的通道。 */
-  hook: string;
-}
-interface EngineRecipe {
-  id: string;
-  capabilities: readonly string[];
-  initialParams?: Readonly<Record<string, unknown>>;
-}
-/**
- * 只保留已有真实工作流的一键组合；recipe 本身不写入 preset.yml。
- *
- * B7 T3 清空：三条 recipe 的成员都是随本轮退场的专用能力（phase-control /
- * phase-control-ptc / deliberation），没有任何一条还能组成合法能力集合。
- * export 与 `engineRecipe()` 保留——调用点（创建菜单、bridge 校验）不必跟着改，
- * 空表天然让组合项整个消失。
- */
-declare const ENGINE_RECIPES: readonly EngineRecipe[];
-declare function engineCapability(id: string): EngineCapability | undefined;
-declare function engineRecipe(id: string): EngineRecipe | undefined;
-/** 显式模块预设中的实际能力；包含当前参数与顶层策略所需的装配。
- *  创建补声明由 host 单独检查 declaredModules；官方组合行不伪装成可编辑能力。 */
-declare function isEngineCapabilityPresent(id: string, facts: PresetModuleFacts | undefined): boolean;
-/** custom tool 的运行时名称缺省回落 id；保存前拒绝会导致同层注册失败的重复项。 */
-declare function validateCustomToolIdentities(tools: readonly unknown[]): string[];
-//#endregion
 //#region src/shared/managed-config-fields.d.ts
 interface ConfigFieldSources {
   configId: string;
@@ -388,10 +397,12 @@ declare const BRIDGE_ENDPOINTS: {
   readonly assetUpload: "/asset-upload";
   readonly assetRelease: "/asset-release";
   readonly exportPreset: "/export-preset";
-  readonly presetDelete: "/preset-delete";
-  readonly presetClone: "/preset-clone";
-  readonly presetDuplicate: "/preset-duplicate";
-  readonly presetOpen: "/preset-open";
+  readonly moduleDelete: "/module-delete";
+  readonly moduleClone: "/module-clone";
+  readonly moduleDuplicate: "/module-duplicate";
+  readonly moduleOpen: "/module-open";
+  readonly moduleEnable: "/module-enable";
+  readonly moduleConfigOrder: "/module-config-order";
   readonly charactersImport: "/characters-import";
   readonly charactersImportStream: "/characters-import-stream";
   readonly charactersList: "/characters-list";
@@ -513,6 +524,7 @@ interface BridgeRequestMap {
    * 指令文件卡策略（独立存储，默认禁用）：省略 `policy` = 读取；
    * 写入必须带读取时的 `expectedRevision`（文件缺失为 null）。
    */
+  /** 逐文件启停/名称；无 policy 时读取，写入仍校验原始字节版本。 */
   instructionsPolicy: {
     policy?: InstructionPolicyPatch;
     expectedRevision?: string | null;
@@ -552,7 +564,7 @@ interface BridgeRequestMap {
     expectedPresetId?: string;
   } | undefined;
   /**
-   * 预设包导入（原生/ST/PNG/ZIP）。`preview: true` 只转换并返回报告，不写目标；
+   * 模块包导入（原生/ST/PNG/ZIP）。`preview: true` 只转换并返回报告，不写目标；
    * 提交必须携带 expectedSourceDigest 和 expectedPreviewRevision，服务端重算并拒绝过期预览。
    * `expectedPreviewRevision` 是预览返回的版本凭据：绑定文件、实际选组、转换器版本与
    * 目标身份（含目标当前内容），服务端提交时重算，不符返回 409 且零写盘。
@@ -566,19 +578,30 @@ interface BridgeRequestMap {
     sourceId: string;
   };
   exportPreset: PresetExportRequest;
-  presetDelete: {
+  moduleDelete: {
     id: string;
   };
-  presetClone: {
+  moduleClone: {
     id: string;
     autoSuffix?: boolean;
   };
-  presetDuplicate: {
+  moduleDuplicate: {
     id: string;
   };
-  presetOpen: {
+  moduleOpen: {
     id: string;
   };
+  moduleEnable: {
+    id: string;
+    enabled: boolean;
+  };
+  moduleConfigOrder: {
+    moduleId: string;
+  } | {
+    moduleId?: string;
+    entries: ModuleConfigIdentity[];
+    expectedRevision: string;
+  } | undefined;
   /** 角色卡 PNG/JSON/YAML 导入；预览不写角色库，提交必验版本，目标和选组均绑定预览。 */
   charactersImport: AssetImportRequest;
   charactersImportStream: undefined;
@@ -780,6 +803,8 @@ interface EngineMetaLayerContract {
 /** 物化配置的只读来源；与配置一同读回，不能作为写入字段或授权。 */
 interface PromptConfigSourceView {
   fieldSources?: ConfigFieldSources;
+  /** 只读排序投影；不能作为客户端提供的写盘序号。 */
+  sequence?: number;
 }
 /** 端点级响应 value 契约（value 字段形状；扩展字段仍以 value 旁可选字段出现）。 */
 interface BridgeValueMap {
@@ -861,7 +886,7 @@ interface BridgeValueMap {
   importPreset: {
     scopes: Array<'preset' | 'agents'>;
   };
-  /** 参数/提示词配置只保存当前预设，不同步宿主全局默认模型。 */
+  /** 参数/提示词配置只保存当前模块，不同步宿主全局默认模型。 */
   paramOverrides: {
     overrides?: Record<string, unknown>;
     promptConfigs?: unknown[];
@@ -894,7 +919,6 @@ interface BridgeValueMap {
     report?: StConversionReport;
     summary?: AssetSummary;
     kinds?: ImportKind[];
-    refreshWarning?: string;
   };
   assetUpload: {
     sourceId: string;
@@ -905,18 +929,22 @@ interface BridgeValueMap {
     released: boolean;
   };
   exportPreset: PresetExportResult;
-  presetDelete: {
+  moduleDelete: {
     id: string;
   };
-  presetClone: {
+  moduleClone: {
     id: string;
   };
-  presetDuplicate: {
+  moduleDuplicate: {
     id: string;
   };
-  presetOpen: {
+  moduleOpen: {
     path: string;
   };
+  moduleEnable: {
+    enabled: string[];
+  };
+  moduleConfigOrder: ModuleConfigOrderSnapshot;
   charactersImport: {
     id?: string;
     name?: string;
@@ -987,7 +1015,14 @@ interface BridgeValueMap {
 }
 //#endregion
 //#region src/host/manifest.d.ts
-interface PresetSpec {
+/**
+ * 模块目录确实存在于本插件存储根（身份判定与官方登记状态无关）。
+ *
+ * 启用表过滤、工具写入目标、TUI 目标共用这一条判据：本插件管理的模块 = 存储根里含
+ * `module.yml` 的目录，与「宿主有没有把它登记成官方预设」是两回事。
+ */
+declare function moduleDirExists(root: string, id: string): boolean;
+interface ModuleSpec {
   id: string;
   name: string;
   /** 官方预设列表顺序；省略时由宿主排序。 */
@@ -1009,9 +1044,11 @@ interface PresetSpec {
   params?: Record<string, unknown>;
   /** 共享引擎参数按编辑组的主归属插入点存储；规则实例仍拥有各自 params。 */
   layerSettings?: Record<string, Record<string, unknown>>;
+  /** 兼容读取诊断，不写回模块定义。 */
+  legacyParamWarnings?: string[];
   /** 顶层人设段（官方 @deepseek-ai/dsh-persona 行同构）：prefix/suffix/complete/includeRuntimeContext。 */
   persona?: PersonaSpec;
-  /** 预设级模板变量（{{key}} 插值源；与 layerSettings 分离，顶层 variables 段）。 */
+  /** 模块级模板变量（{{key}} 插值源；与 layerSettings 分离，顶层 variables 段）。 */
   variables?: Record<string, string>;
   /** 自定义工具定义（tool-config-engine 渲染进 custom-tools/ 后运行时注册）。 */
   customTools?: unknown[];
@@ -1019,7 +1056,7 @@ interface PresetSpec {
   subagentToolPolicy?: Record<string, unknown>;
   /**
    * 触发器声明（`triggers` 顶层段）：`{ id, channel, when?, do, … }` 的数组。
-   * 声明**由预设提供**（引擎不带默认），物化为 `triggers.yml` 后由 `declared-triggers`
+   * 声明**由模块提供**（引擎不带默认），物化为 `triggers.yml` 后由 `declared-triggers`
    * 运行时模块读入并注册；形状与校验归 `engine/trigger-spec.mjs` 的声明编译器。
    */
   triggers?: unknown[];
@@ -1027,26 +1064,30 @@ interface PresetSpec {
   variablesEnabled?: boolean;
   /** 可选:模板自定义提示词配置覆盖(纯数据,不使用模板语法)。 */
   promptConfigs?: unknown[];
+  /** 配置卡的持久文件序号；跨模块UI排序只改此轻量元数据。 */
+  configOrder?: Record<string, number>;
   /** 可选:引擎组合模块行参数直写(行级 map config 浅合并;参数桥未覆盖的键生效,参数桥优先)。 */
   moduleConfigs?: Record<string, Record<string, unknown>>;
   upstream?: Record<string, unknown>;
 }
 /**
- * 从预设 preset.yml 的 modules 清单移除一个模块 id（YAML Document 保留注释
+ * 从模块 module.yml 的 modules 清单移除一个模块 id（YAML Document 保留注释
  * 与其余字段）。返回是否发生修改；文件缺失或没有该模块时返回 false。
  */
 declare function removePresetModule(dir: string, moduleId: string): boolean;
-/** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
-declare function loadPresetSpec(dir: string): PresetSpec;
-/** 预设根：官方 USER_PRESET_DIR（~/.dsh/.agent-presets），导入/新建/种子化的预设都放这里。 */
-declare function userPresetsDir(): string;
+/** 加载某个模块模板的单一参数文件 modules/<name>/module.yml。 */
+declare function loadModuleSpec(dir: string, options?: {
+  legacyParams?: boolean;
+}): ModuleSpec;
+/** 模块根：本插件的存储根（~/.dsh/.prompt-tool），导入/新建/种子化的模块都放这里。 */
+declare function userModulesDir(): string;
 /**
- * 解析预设模板目录：当前预设根优先，包内模板回退；不读取其他部署根的同名预设。
+ * 解析模块模板目录：当前模块根优先，包内模板回退；不读取其他部署根的同名模块。
  * 目录名与声明的 preset.yml id 一致；不扫描其他目录的 id 别名。
  */
-declare function resolvePresetDir(template: string, presetRoot?: string): string;
-/** 本插件预设清单；所有目录按同一身份与组合源规则列举。 */
-declare function listPresets(presetRoot?: string): Array<{
+declare function resolveModuleDir(template: string, moduleRoot?: string): string;
+/** 本插件模块清单；所有目录按同一身份与组合源规则列举。 */
+declare function listModules(moduleRoot?: string): Array<{
   id: string;
   name: string;
   user: boolean;
@@ -1054,17 +1095,17 @@ declare function listPresets(presetRoot?: string): Array<{
   description?: string;
   meta?: Record<string, unknown>;
 }>;
-/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在预设列表）。 */
+/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在模块列表）。 */
 declare function listBuiltinTemplates(): Array<{
   id: string;
   name: string;
 }>;
-/** 按包内同名目录补建缺失预设；已有目录的定义、生成物和资源保持原样。 */
+/** 按包内同名目录补建缺失的内置模块；已有目录的定义、生成物和资源保持原样。 */
 declare function ensurePresetSeed(root?: string): {
   created: string[];
 };
-/** 从包内同名目录复制预设；autoSuffix=true 时递增目录名并同步定义身份。 */
-declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean, presetRoot?: string): {
+/** 从包内同名目录复制模块；autoSuffix=true 时递增目录名并同步定义身份。 */
+declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean, moduleRoot?: string): {
   ok: true;
   id: string;
 } | {
@@ -1072,27 +1113,27 @@ declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean, presetRoot
   message: string;
 };
 /**
- * 保存预设参数：写 layerSettings（merge）/ promptConfigs（整体替换）。
+ * 保存模块参数：写 layerSettings（merge）/ promptConfigs（整体替换）。
  * parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键删除（'' / []，
  * 回落模板/引擎默认；0 与 false 照常写入——语义与函数内注释、docs §3 一致）。
  */
-declare function savePresetParams(presetRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined, variables?: Record<string, string>, variablesEnabled?: boolean): void;
+declare function saveModuleParams(moduleRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined, variables?: Record<string, string>, variablesEnabled?: boolean): void;
 /**
- * 保存激活预设的顶层 persona 段（官方 `@deepseek-ai/dsh-persona` 行 config 同构）。
+ * 保存激活模块的顶层 persona 段（官方 `@deepseek-ai/dsh-persona` 行 config 同构）。
  * null = 删除该段（回落宿主部署人设）；默认值不落键（见 personaRowConfig）。
  */
-declare function savePresetPersona(presetRoot: string, templateName: string, persona: PersonaSpec | null): void;
-/** 删除具有合法身份的预设目录（预设根/<id>）；隐藏备份不经公共接口删除。
- *  仅作用于预设根（官方 USER_PRESET_DIR），包内置模板天然不受影响；路径越界与非法 id 拒绝。
- *  删除后宿主 agent-presets 目录列表自然不再出现该预设（官方 roster 即目录列表）。 */
-declare function removeUserPreset(id: string, presetRoot?: string): {
+declare function savePresetPersona(moduleRoot: string, templateName: string, persona: PersonaSpec | null): void;
+/** 删除具有合法身份的模块目录（模块根/<id>）；隐藏备份不经公共接口删除。
+ *  仅作用于插件自有模块根，包内置模板不受影响；路径越界与非法 id 拒绝。
+ *  模块不在宿主预设注册表里，删除后无需撤销官方登记；调用方按需重建当前模块。 */
+declare function removeUserPreset(id: string, moduleRoot?: string): {
   ok: true;
 } | {
   ok: false;
   message: string;
 };
 /** 当前 layerSettings 与显式运行参数合并；不从旧磁盘 params 段回退取值。 */
-declare function resolvePresetParams(spec: PresetSpec, runtime: Record<string, unknown>): Record<string, unknown>;
+declare function resolvePresetParams(spec: ModuleSpec, runtime: Record<string, unknown>): Record<string, unknown>;
 /**
  * 参数桥：params 扁平键 → 引擎模块行 config 对象（取代旧 __TOKEN__ 文本渲染）。
  *
@@ -1110,14 +1151,14 @@ declare function buildModuleConfigsFromParams(params: Record<string, unknown>, o
  * 行级 config 合并:仅支持 map 型 config 浅合并;
  * 数组型 config(如 delegation 组)按子行 id 嵌套合并;未声明模块原样保留。
  * 未声明 configs 时返回原文(零开销);parseDocument 往返保留注释。
- * 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是预设覆盖通道。
+ * 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是模块覆盖通道。
  */
 declare function applyModuleConfigs(raw: string, configs: Record<string, Record<string, unknown>> | undefined): string;
 /**
- * 解析预设的模块事实，供 UI 卡片存在性和受控创建共用。
+ * 解析模块的模块事实，供 UI 卡片存在性和受控创建共用。
  * 显式模块及当前参数/策略所需的装配是可编辑插件能力；官方组合 row 仅保留为运行事实。
  */
-declare function resolvePresetModuleFacts(spec: PresetSpec, templateDir?: string, editable?: boolean): PresetModuleFacts;
+declare function resolveModuleFacts(spec: ModuleSpec, templateDir?: string, editable?: boolean): ModuleFacts;
 type EngineCapabilityCreateRequest = {
   action: 'create';
   capabilityId: string;
@@ -1135,19 +1176,19 @@ interface EngineCapabilityRemoveResult {
   removedModules: string[];
   capabilityIds: string[];
 }
-/** 在内存候选文档中展开能力/recipe，校验成功后一次原子替换 preset.yml。 */
-declare function createEngineCapabilityInPreset(presetDir: string, request: EngineCapabilityCreateRequest): EngineCapabilityCreateResult;
+/** 在内存候选文档中展开能力/recipe，校验成功后一次原子替换 module.yml。 */
+declare function createEngineCapabilityInPreset(moduleDir: string, request: EngineCapabilityCreateRequest): EngineCapabilityCreateResult;
 /** 删除能力：模块声明、顶层数据段，以及该能力的**显式参数与行配置**一起移除。
  *  参数在 ⇒ 装配在（见 impliedModulesFromParams）：留下参数会让移除立刻被隐含装配拉回来，
  *  所以"移除能力"必须是完整移除。未登记参数、其他能力的数据与未知字段一律不动。 */
-declare function removeEngineCapabilityFromPreset(presetDir: string, capabilityId: string): EngineCapabilityRemoveResult;
+declare function removeEngineCapabilityFromPreset(moduleDir: string, capabilityId: string): EngineCapabilityRemoveResult;
 /**
- * 预设组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
+ * 模块组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
  * 合并优先级:参数桥(params/UI 基础层) > moduleConfigs(模板/ST 行级直写) > 行默认。
  * moduleConfigs 仅补充参数桥未覆盖的行级 config(如 ST 导入的 tool-web.fetch),
  * 不再锁定覆盖 UI 可管理参数(旧作者锁定语义已移除)。
  */
-declare function renderComposition(spec: PresetSpec, runtime: Record<string, unknown>, templateDir?: string): string;
+declare function renderComposition(spec: ModuleSpec, runtime: Record<string, unknown>, templateDir?: string): string;
 //#endregion
 //#region src/host/sillytavern.d.ts
 /** ST marker prompts（marker: true）：content 不发送给模型（仅标记注入位置，ST
@@ -1157,7 +1198,7 @@ declare function renderComposition(spec: PresetSpec, runtime: Record<string, unk
 /** 显式文本求值工具；导入本身仅 prepare，避免执行禁用卡的副作用。 */
 declare function processStText(text: string, cardName: string, variables: Record<string, string | number>): string;
 /** 合并多个转换结果为一个预设（角色卡 × 响应预设 → 单预设）。 */
-declare function mergeStPresets(specs: PresetSpec[]): PresetSpec;
+declare function mergeStPresets(specs: ModuleSpec[]): ModuleSpec;
 /** 转换选项：多 prompt_order 分组时显式选择来源角色，避免照搬「默认任取首组」。 */
 interface StConversionOptions {
   characterId?: string;
@@ -1167,8 +1208,8 @@ interface StOrderGroupSummary {
   characterId: string;
   entries: number;
 }
-/** SillyTavern JSON 预设卡片 → 本项目 PresetSpec（导入端点直接消费）。 */
-declare function convertStToPreset(card: unknown, baseName: string, options?: StConversionOptions): PresetSpec;
+/** SillyTavern JSON 预设卡片 → 本项目 ModuleSpec（导入端点直接消费）。 */
+declare function convertStToPreset(card: unknown, baseName: string, options?: StConversionOptions): ModuleSpec;
 /** ST 导入预设 id：必须是官方 agent-presets 可发现的目录名（PRESET_ID =
  *  /^[a-z0-9][a-z0-9-]*$/——含中文的目录会被宿主 discovery 静默跳过，会话
  *  resume 报 preset not found）。文件名 slug 化（去中文）；纯中文名退化为
@@ -1179,7 +1220,7 @@ declare function stPresetId(baseName: string): string;
 type PreparedImport = {
   state: 'ready';
   kind: ImportKind;
-  spec: PresetSpec;
+  spec: ModuleSpec;
   yaml: string;
   files: AssetFile[];
   sourceName: string;
@@ -1199,7 +1240,7 @@ type PreparedImport = {
 /** 字节集合 → 同一规范化候选；没有目标写入和静默的未知 JSON 回退。 */
 declare function prepareImport(input: AssetFile[], target: 'preset' | 'character', choices?: ImportChoices): PreparedImport;
 //#endregion
-//#region src/host/preset-package.d.ts
+//#region src/host/module-package.d.ts
 declare function expandPresetSource(input: AssetFile[]): Promise<AssetFile[]>;
 type ReadyImport = Extract<ReturnType<typeof prepareImport>, {
   state: 'ready';
@@ -1223,11 +1264,12 @@ declare function exportPresetPackage(root: string, request: PresetExportRequest)
  *  插件不再内置任何技能：包内没有 skills 目录，也不再有安装副本与内容账本。 */
 declare const USER_SKILLS_DIR: string;
 /**
- * 预设根：官方 USER_PRESET_DIR（DSH_HOME/.agent-presets）。
- * 每个预设一个官方预设目录（agent.cordis.yml 组合本体 + preset.yml 参数），
- * 宿主 agent-presets 直接可挂载；共享引擎自阶段 2 起由**插件包**提供（组合行写包名说明符），
- * 不再物化到预设根下。
+ * 存储根下的**模块根**：一个模块一个目录（`modules/<id>/`），定义与物化产物都在其内。
+ *
+ * 这是 `resolveModuleDir` / `assertModuleDirectory` / `listModules` 的扫描根，
+ * 也是「本插件管理的模块」身份判定的基准。模块目录必须是它的**直接子目录**
+ * （`assertModuleDirectory` 的一层深度契约由此成立）。
  */
-declare const DEFAULT_PRESET_DIR: string;
+declare const MODULES_DIR: string;
 //#endregion
-export { ENGINE_RECIPES as $, resolvePresetParams as A, MAX_CHARACTER_CARD_STREAM_BYTES as B, loadPresetSpec as C, renderComposition as D, removeUserPreset as E, BridgeEndpoint as F, SkillPolicyChange as G, SkillCatalogEntry as H, BridgeErrorPayload as I, SkillsCatalogSnapshot as J, SkillPolicyScope as K, BridgeRequestMap as L, savePresetPersona as M, userPresetsDir as N, resolvePresetDir as O, BRIDGE_ENDPOINTS as P, ENGINE_CAPABILITIES as Q, BridgeValueMap as R, listPresets as S, removePresetModule as T, SkillContentSnapshot as U, SETTINGS_BRIDGE_PREFIX as V, SkillInvocation as W, invocationForScope as X, SkillsState as Y, scopeOfInvocation as Z, buildModuleConfigsFromParams as _, installPresetPackage as a, isEngineCapabilityPresent as at, ensurePresetSeed as b, convertStToPreset as c, ImportChoices as ct, stPresetId as d, InstructionFileSnapshot as dt, EngineCapability as et, EngineCapabilityCreateRequest as f, InstructionFileStatus as ft, applyModuleConfigs as g, PresetSpec as h, exportPresetPackage as i, engineRecipe as it, savePresetParams as j, resolvePresetModuleFacts as k, mergeStPresets as l, INSTRUCTION_FILE_STATUSES as lt, EngineCapabilityRemoveResult as m, USER_SKILLS_DIR as n, PresetModuleFacts as nt, presetImportPreview as o, validateCustomToolIdentities as ot, EngineCapabilityCreateResult as p, MAX_INSTRUCTION_FILE_BYTES as pt, SkillSourceKind as q, expandPresetSource as r, engineCapability as rt, StConversionOptions as s, AssetFile as st, DEFAULT_PRESET_DIR as t, ModuleSourceMode as tt, processStText as u, InstructionContextView as ut, cloneBuiltinPreset as v, removeEngineCapabilityFromPreset as w, listBuiltinTemplates as x, createEngineCapabilityInPreset as y, MAX_BRIDGE_BODY_BYTES as z };
+export { AssetFile as $, resolveModuleFacts as A, MAX_BRIDGE_BODY_BYTES as B, loadModuleSpec as C, removeUserPreset as D, removePresetModule as E, BRIDGE_ENDPOINTS as F, SkillInvocation as G, SETTINGS_BRIDGE_PREFIX as H, BridgeEndpoint as I, SkillSourceKind as J, SkillPolicyChange as K, BridgeErrorPayload as L, saveModuleParams as M, savePresetPersona as N, renderComposition as O, userModulesDir as P, scopeOfInvocation as Q, BridgeRequestMap as R, listModules as S, removeEngineCapabilityFromPreset as T, SkillCatalogEntry as U, MAX_CHARACTER_CARD_STREAM_BYTES as V, SkillContentSnapshot as W, SkillsState as X, SkillsCatalogSnapshot as Y, invocationForScope as Z, buildModuleConfigsFromParams as _, installPresetPackage as a, MAX_INSTRUCTION_FILE_BYTES as at, ensurePresetSeed as b, convertStToPreset as c, EngineCapability as ct, stPresetId as d, engineCapability as dt, ImportChoices as et, EngineCapabilityCreateRequest as f, engineRecipe as ft, applyModuleConfigs as g, ModuleSpec as h, exportPresetPackage as i, InstructionFileStatus as it, resolvePresetParams as j, resolveModuleDir as k, mergeStPresets as l, ModuleFacts as lt, EngineCapabilityRemoveResult as m, validateCustomToolIdentities as mt, USER_SKILLS_DIR as n, InstructionContextView as nt, presetImportPreview as o, ENGINE_CAPABILITIES as ot, EngineCapabilityCreateResult as p, isEngineCapabilityPresent as pt, SkillPolicyScope as q, expandPresetSource as r, InstructionFileSnapshot as rt, StConversionOptions as s, ENGINE_RECIPES as st, MODULES_DIR as t, INSTRUCTION_FILE_STATUSES as tt, processStText as u, ModuleSourceMode as ut, cloneBuiltinPreset as v, moduleDirExists as w, listBuiltinTemplates as x, createEngineCapabilityInPreset as y, BridgeValueMap as z };

package/lib/preset-transfer.d.mts

@@ -1,2 +1,2 @@
-import { i as exportPresetPackage, r as expandPresetSource, t as DEFAULT_PRESET_DIR } from "./paths-CY5psBqE.mjs";
-export { DEFAULT_PRESET_DIR, expandPresetSource, exportPresetPackage };
+import { i as exportPresetPackage, r as expandPresetSource, t as MODULES_DIR } from "./paths-BgL42sSM.mjs";
+export { MODULES_DIR, expandPresetSource, exportPresetPackage };

package/lib/preset-transfer.mjs

@@ -1,2 +1,2 @@
-import { Zt as DEFAULT_PRESET_DIR, n as exportPresetPackage, t as expandPresetSource } from "./preset-package-BnJqrU4R.mjs";
-export { DEFAULT_PRESET_DIR, expandPresetSource, exportPresetPackage };
+import { n as exportPresetPackage, rn as MODULES_DIR, t as expandPresetSource } from "./module-package-Cm3fHHlp.mjs";
+export { MODULES_DIR, expandPresetSource, exportPresetPackage };