dsh-plugin-prompt-tool

一切皆可注入：把 DSH 官方开放的全部注入层级收敛为一个可配置提示词注入引擎——注入什么、注入到哪一层、何时注入，全由提示词配置决定。

DSH 生态的提示词注入标准层：一个 prompt-config-engine.mjs 接线官方六个注入层级（agent/pre-step、systemPrompt.section、systemPrompt.context、agent/request、llm/stream、tools/*），内置 anchored 默认预设，开箱即用。

策略来源：工具目录锚定 dsh-anchored-standard、近距离引导 dsh-router-standard、缓存铁律 dsh-super-injector。

安装

dsh plugin --profile prompt-tool add dsh-plugin-prompt-tool        # npm 安装
dsh plugin --profile prompt-tool add link:<本仓库绝对路径>          # 本地源码（link 覆盖 registry）
dsh --profile prompt-tool                                          # 首次启动自动补 dsh-web-app，二次启动生效

需要 DSH 0.1.1-rc.1+。

特性

• 🔌 六层一次接线：一个引擎注册全部可注入层级，共享同一套过滤与降级语义
• ✍️ 一切皆可配置：layer / strategy / position / promotion / subagents / modelScope / mergeMode / order / text / texts / fill / variables / params 全开放
• 🧑‍🤝‍🧑 子代理三态：subagents: none / inherit / only，身份类提示词可只注入子代理
• 🗂️ 内容与执行分离：每条提示词配置一个 yml/json 放 prompt-configs/，引擎按文件名数字前缀顺序扫描
• 🧩 三源合并：默认提示词配置 < 目录文件 < settings 数组，同名 id 覆盖
• 🖥️ 独立工作台：侧边栏「提示词工具」入口（主会话/子代理/注入层/技能设置/预设配置五页）+ 设置面板提示词配置页（列表/表单/模板插入/保存前校验）
• 🧪 七种内容策略：static / first-turn-anchor / guide-auto / custom-fallback / instruction-hint / placeholder / world-book
• 🛡️ 失败不伤会话：单条失败跳过 + warnOnce；配置错误挂载时 fail loud；dedupe: session 持久幂等
• 🎭 SillyTavern 导入：JSON 预设卡片一键转换为本地预设——prompts[] 映射提示词配置、采样参数进 params.model*、enable_web_search 按开关装配工具
• 🎴 角色卡库：SillyTavern 角色卡（PNG tEXt chunk ccv3/chara，或 chara_card JSON）导入独立库（.characters/<id>/，含原图/转换参数/角色记忆），按需「导入到当前预设」（chara-<卡>- 前缀合并、幂等可移除），多文件自动合并
• 📚 世界书：character_book 转 world-book 策略配置（keys 命中触发 / constant 常驻 / useRegex 正则），与模块卡片同一存储与编辑（模块列表「世界书」过滤 + 批量启用/禁用）；ST 变量规则（setvar/getvar 含默认值）由 params fallback 插值承载

预设参数体系

预设行为由一份 preset.yml 单一配置源下发，共四层默认值，各层职责不重叠：

层	职责
hostDefaults	settings 层默认值（开关/路径），被用户 settings 覆盖
params	引擎行为默认（锚定/引导/PTC/门控/模型/工具），被运行时 settings 覆盖
moduleConfigs	引擎组合行级 config（persona 文本/超时/白名单）
promptConfigs	注入提示词配置（策略/层/位置/时机），与目录、settings 三源合并

params 一览（全部可选，缺省 = 官方默认）

分类	键
锚定	firstTurnAnchor firstTurnCustom firstTurnText firstTurnWord firstTurnBuild firstTurnInspect firstTurnDeep
引导	guideCustom guideText guideComplexPattern guideWeak guideDeep buildPattern complexPattern
PTC/门控	usePtcMode bootstrapMaxTokens injectPrompt allowKinds
主对话模型	modelProvider modelName modelReasoningEffort modelTemperature modelMaxTokens
子代理模型	subagentModelProvider subagentModelName subagentReasoningEffort subagentTemperature subagentMaxTokens
人设	mainPersona（主对话 Flash 档）subagentPersona（子代理，回退 mainPersona → 继承主会话）
工具集	toolFilterAllow toolFilterDeny（子代理 toolFilter；主对话 tool-filter 模块共用）
深度	maxDepth（0 禁止委派 / provider-managed / 正整数）

根目录 preset.yml 是配置参数齐全、逐项注释的完整模板，复制即得自定义预设起点。

提示词配置（六层全家桶）

layer	官方通道	关键参数
pre-step	agent/pre-step 消息批（默认层）	position / dedupe / promotion / subagents / modelScope / strategy
system-section	ctx.systemPrompt.section 静态段	order / text / templateFile / variables / params.complete / params.sectionName
runtime-context	ctx.systemPrompt.context 动态快照	order / text / variables / params.contextName
agent-request	agent/request（LlmCallConfig）	params.patch（浅合并）/ params.replace（整体替换）
llm-stream	llm/stream（流包装）	params.mode=pass|replace
tool-pipeline	tools/*（pre/execute/post）	params.toolNames、preDecision=allow|deny|ask、postAction=accept|replace|block

默认四条：00-near-anchor（首句锚点）、10-router-guide（每轮引导）、20-prompt-injector（we 确认后注入 preset.md 一次）、30-instruction-hint（指令文件提示）。

• mergeMode：separate（默认）同位置多条为独立消息；merged 同位置拼接为一条
• order：数值小者更靠近插入锚点，同时决定 merged 组内拼接顺序
• 文本插值：仅 pre-step 支持内置环境变量与 filler 变量；system-section 额外走官方 {{variable}} 渲染

SillyTavern 导入

工作台「预设配置」页导入 SillyTavern JSON 预设卡片（导入包无定义文件、仅含单个 .json 时自动识别转换），按注入层级映射为本地预设：

• prompts[] → promptConfigs：system_prompt + role=system → system-section（多条可 mergeMode: merged 拼接）；其余 → pre-step（injection_position=0 → before-all，否则 after-user）；OFF 状态与 injection_order 原样保留
• 采样参数 → 顶层 params.model*：temperature / openai_max_tokens / reasoning_effort
• enable_web_search：true → 组装 tool-web（fetch 启用）；false → 不组装，改加 tool-filter 黑名单 web_search / web_fetch
• modules 按需装配：prompt-config-engine 始终；含 system-section 时补 persona（complete: false 允许 system 段生效）

转换结果是一个普通预设（id 由文件名生成），可在工作台预设切换器中直接使用。字段级参数对照与完整示例见 SillyTavern.md。

角色卡（PNG / JSON）与角色卡库

工作台「角色管理」页导入角色卡到角色卡库（~/.dsh/.agent-presets/.characters/<id>/）：

• PNG：tEXt chunk（ccv3 优先 / chara 兜底）base64 解析，原图存 avatar.png（字节无损）
• JSON：chara_card_v2/v3 直接转换；多文件（角色卡 × 响应预设）自动合并
• 正文映射：first_mes → 开场白（dedupe: session）、alternate_greetings → 备用开场白、 description/personality/scenario → 角色设定、采样参数 → params.model*
• 导入到当前预设：参数合并进当前预设 promptConfigs（chara-<卡>- 前缀、幂等）；可一键移除
• 角色记忆：memory.md 跟随角色卡跨预设，应用时合并为 world-book constant 配置注入

世界书（world-book 策略）

character_book 条目转 world-book 策略配置（与普通模块同一存储/编辑）：

• 注入语义：constant 常驻注入；有 keys 命中聊天内容才注入；无 keys 全局每次注入
• 匹配选项：caseSensitive / wholeWords / useRegex（keys 按正则）
• 管理：模块列表顶部下拉选「世界书」过滤（完整模块卡片编辑 + 批量启用/禁用）； 模型工具 world_book_list/upsert/delete（note 写入角色卡记忆）
• ST 变量：setvar 收集进 params、getvar（含默认值）改写为 {{key}} 由引擎插值兜底； trim/注释/ERA 剥离，{{user}}/{{char}} 替换；TavernHelper 扩展注入物自动剥离

详细转换规则见 SillyTavern.md。

开发与验证

pnpm install && pnpm build
pnpm test          # 235 单测：渲染/合并/六层接线/preset 生成
pnpm typecheck && pnpm lint
pnpm sync:anchored       # 刷新 upstream/dsh-anchored-standard 内联快照
pnpm sync:yaml           # 刷新 engine/vendor/yaml（生成目录运行时 YAML 解析器）
pnpm rebuild:composition # 从官方内置预设源码重建组合模块

许可

插件本体 MIT（Czerror）。默认预设策略来源见顶部引用；preset/ 下 cordis 模板与脚本基于 DeepSeek Harness 官方 Standard 预设修改，版权声明见 upstream/dsh-anchored-standard/。