dsh-plugin-prompt-tool 0.5.0 → 0.6.0

package/lib/index.d.mts

@@ -1,14 +1,21 @@
-import { n as PromptConfigFile, r as PromptConfigSpec } from "./prompt-configs-BcP6miu9.mjs";
+import { n as PromptConfigFile, r as PromptConfigSpec } from "./prompt-configs-B4vH09wx.mjs";
 import { SettingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
-//#region src/config.d.ts
+//#region src/shared/param-keys.d.ts
 /**
  * 引擎行为参数键（按预设存储：激活预设 preset.yml 的 params + promptConfigs）。
  * 不进 Config schema、不进 settings namespace——每预设一份，随预设走（官方范式：
  * Config = 部署轴，引擎行为在预设文件）。
+ *
+ * 这些键在 UI 有专门编辑入口（模型设置 / 工具与深度 / 开关），writePreset 把
+ * 预设级 params 合并进每条 promptConfig 的 params 时排除——「params（高级参数
+ * JSON）」框只保留内容变量与配置自身策略参数，避免 UI 已管理的参数冗余回写。
+ * 放 shared：host（write-preset）与 config/settings-bridge 共用，单一来源。
  */
 declare const PARAM_KEYS: ReadonlySet<string>;
+//#endregion
+//#region src/config.d.ts
 interface Config {
   /** 是否用 AGENTS.md 内容替换本地 instruction-hint 的默认提示文本（默认关闭）。 */
   injectAgentsPrompt: boolean;
@@ -132,7 +139,7 @@ interface WritePresetOptions {
   subagentTemperature?: string;
   /** 子代理输出上限（agent-request patch，audience=subagent；''=不设置）。 */
   subagentMaxTokens?: string;
-  /** 子代理自定义模型人设（per-child shadow；缺省回退 mainPersona，两者缺省=继承主会话）。 */
+  /** 子代理自定义模型人设（per-child shadow；缺省 = 经 scope 链继承主会话 persona 模块）。 */
   subagentPersona?: string;
   /** 委派工具集白名单（toolFilter.allow；支持数组或逗号/空格分隔字符串）。 */
   toolFilterAllow?: string[] | string;
@@ -140,8 +147,6 @@ interface WritePresetOptions {
   toolFilterDeny?: string[] | string;
   /** 委派递归深度上限（0 禁止委派 / provider-managed / 正整数）。 */
   maxDepth?: number | 'provider-managed' | string;
-  /** 主对话自定义模型人设（preset.yml mainPersona；覆盖模板默认）。 */
-  mainPersona?: string;
   /** 注入 kind 白名单（context-gate allowKinds；数组或逗号分隔字符串）。 */
   allowKinds?: string[] | string;
   /** custom-fallback 锚定词（prompt-injector params.firstTurnWord）。 */
@@ -193,6 +198,10 @@ interface PresetSpec {
   composition?: string;
   /** 扁平参数:全部直读(true/false、数字、字符串),on/off 作为兼容写法。 */
   params?: Record<string, unknown>;
+  /** 预设级模板变量（{{key}} 插值源；与引擎行为参数 params 分离，顶层 variables 段）。 */
+  variables?: Record<string, string>;
+  /** 模板变量插值开关（缺省 true = 启用；false = 停用，writePreset 不生成变量文件）。 */
+  variablesEnabled?: boolean;
   /** 宿主层默认值(唯一入口):apply 时合并进 Config,settings 仍可覆盖。 */
   hostDefaults?: Record<string, unknown>;
   /** 可选:模板自定义提示词配置覆盖(纯数据,不使用模板语法)。 */
@@ -230,8 +239,17 @@ declare function listBuiltinTemplates(): Array<{
   id: string;
   name: string;
 }>;
-/** 首次启动种子化：把插件目录全部内置模板复制到预设根（.pt-seeded 标记后不再自动补）。
- *  用户删除的预设不会自动复活；升级新增的模板用「新建」按需复制。 */
+interface PromptToolState {
+  seeded?: boolean;
+  paramsMigrated?: boolean;
+}
+/** 读插件状态；文件缺失/损坏返回空对象（按未标记处理，触发首次动作）。 */
+declare function readPluginState(): PromptToolState;
+/** 原子写插件状态（tmp+rename）。 */
+declare function writePluginState(state: PromptToolState): void;
+/** 首次启动种子化：把插件目录全部内置模板复制到预设根（state.seeded 后不再自动补）。
+ *  用户删除的预设不会自动复活；升级新增的模板用「新建」按需复制。
+ *  兼容旧版预设根内 .pt-seeded 标记：存在即视为已种子化，并迁入状态文件后删除。 */
 declare function ensurePresetSeed(): {
   created: string[];
 };
@@ -250,7 +268,7 @@ declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean): {
  * （保留 preset.yml 模板默认）。写入后删除 prompt-tool.overrides.yml（旧参数覆盖
  * 通道残留——参数已并入 preset.yml，避免旧值覆盖新值）。
  */
-declare function savePresetParams(presetRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined): void;
+declare function savePresetParams(presetRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined, variables?: Record<string, string>, variablesEnabled?: boolean): void;
 /** 删除预设目录（预设根/<id>；含同名导入的 .bak-* 备份目录）。
  *  仅作用于预设根（官方 USER_PRESET_DIR），包内置模板天然不受影响；路径越界与非法 id 拒绝。
  *  删除后宿主 agent-presets 目录列表自然不再出现该预设（官方 roster 即目录列表）。 */
@@ -274,6 +292,13 @@ declare function resolvePresetParams(spec: PresetSpec, runtime: Record<string, u
  */
 declare function applyModuleConfigs(raw: string, configs: Record<string, Record<string, unknown>> | undefined): string;
 //#endregion
+//#region src/host/sillytavern.d.ts
+/** ST 导入预设 id：必须是官方 agent-presets 可发现的目录名（PRESET_ID =
+ *  /^[a-z0-9][a-z0-9-]*$/——含中文的目录会被宿主 discovery 静默跳过，会话
+ *  resume 报 preset not found）。文件名 slug 化（去中文）；纯中文名退化为
+ *  st-<文件名短哈希>（唯一且合法）；显示名 name 仍保留中文原名。 */
+declare function stPresetId(baseName: string): string;
+//#endregion
 //#region src/web-surface.d.ts
 /** 从 loader 根 Include 的 baseUrl 推导 profile 目录。 */
 declare function resolveProfileDir(ctx: Context): string | undefined;
@@ -497,6 +522,7 @@ declare const BRIDGE_ENDPOINTS: {
   readonly presetContent: "/preset-content";
   readonly importPreset: "/import-preset";
   readonly paramOverrides: "/param-overrides";
+  readonly presetVariables: "/preset-variables";
   readonly importPresetPackage: "/import-preset-package";
   readonly exportPreset: "/export-preset";
   readonly presetDelete: "/preset-delete";
@@ -538,4 +564,4 @@ declare const name = "prompt-tool";
 declare const inject: string[];
 declare function apply(ctx: Context, configIn: Config): void;
 //#endregion
-export { BRIDGE_ENDPOINTS, type BridgeEndpoint, type BridgeErrorPayload, type CachedSkillsReader, Config, PARAM_KEYS, type PresetSpec, type PromptConfigTemplate, type PromptConfigValidationError, type PromptConfigValidationResult, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, type SettingsRegistrationHooks, type SkillCatalogEntry, type SkillEntry, type SkillFixResult, type SkillFrontmatter, type WritePresetOptions, apply, applyModuleConfigs, cloneBuiltinPreset, createCachedSkillsReader, detectModels, ensurePresetSeed, ensureSettingsRegistered, ensureWebSurface, fixSkillEntry, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listPresets, listSkillFolders, loadPresetSpec, loadPromptTemplates, mergeSkillDirs, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeUserPreset, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, toKebabName, userPresetsDir, validSkills, validatePromptConfigs, writePreset };
+export { BRIDGE_ENDPOINTS, type BridgeEndpoint, type BridgeErrorPayload, type CachedSkillsReader, Config, PARAM_KEYS, type PresetSpec, type PromptConfigTemplate, type PromptConfigValidationError, type PromptConfigValidationResult, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, type SettingsRegistrationHooks, type SkillCatalogEntry, type SkillEntry, type SkillFixResult, type SkillFrontmatter, type WritePresetOptions, apply, applyModuleConfigs, cloneBuiltinPreset, createCachedSkillsReader, detectModels, ensurePresetSeed, ensureSettingsRegistered, ensureWebSurface, fixSkillEntry, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listPresets, listSkillFolders, loadPresetSpec, loadPromptTemplates, mergeSkillDirs, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, readPluginState, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeUserPreset, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, stPresetId, toKebabName, userPresetsDir, validSkills, validatePromptConfigs, writePluginState, writePreset };