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](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](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 # 从官方内置预设源码重建组合模块

dsh-plugin-prompt-tool

安装

检查来源文件

dsh-plugin-prompt-tool — 层级提示词注入器

安装

特性

预设参数体系

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

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

SillyTavern 导入

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

世界书（world-book 策略）

开发与验证

许可

来源信息

安装

检查来源文件

dsh-plugin-prompt-tool — 层级提示词注入器

安装

特性

预设参数体系

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

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

SillyTavern 导入

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

世界书（world-book 策略）

开发与验证

许可

更多相关插件

dsh-hooks-claude-code

dsh-hooks-codex

WeKnora#dsh-weknora