提示词注入器 MacilyDots/dsh-prompt-inject

dsh-prompt-inject

给「用了 complete: true 的 DSH agent 预设」注入一段附加提示文本。

为什么需要它

DSH 的系统提示（system prompt）由若干 section 拼装而成，注册入口是 @deepseek-ai/dsh-system-prompt 的 ctx.systemPrompt.section()。

但 assemble() 里有一条硬规则：

sections: completeSection === void 0 ? transformed.sections : [completeSection]

只要有任何一个 section 带 complete: true（典型用法是 persona 独占整个人格，例如 @deepseek-ai/dsh-persona 配 complete: true），最终只剩它一个 section —— 往注册表里再 section() 加多少段，都会被整段丢掉。

还能进得去的入口只剩一个：prompt 变量插值。complete 段虽然不是拼接对象，但它照样过 renderPrompt() 的 interpolate()，所以只要在它的文本里写
{{变量名}}，就会被展开成变量 provider 的返回值。

这个插件把「一段文本」注册成一个 prompt 变量，供预设前缀引用。
插件本身不含任何内容，文本由使用者通过配置提供。

⚠️ 一条必须先知道的规则

interpolate() 对未注册的变量是抛错，不是忽略：

unknown prompt variable "{{x}}" in section "..."

这个错误发生在渲染系统提示的时候 —— 那个预设的整条会话链路都会失败 （对话、回信、任何模型调用都发不出去）。

所以：

- 前缀里写了 {{x}}，就必须保证注册 x 的插件处于加载状态；
- 卸载插件之前，先用 tools/disable.mjs 摘掉引用；
- tools/check.mjs 检查这个配对，tools/uninstall.mjs 在还有引用时会拒绝执行。

安装

下文用 %DSH_HOME% 指 DSH 主目录（Windows 默认 %USERPROFILE%\.dsh，其它平台 ~/.dsh），profile 名默认 desktop。

1. 把本仓库放进 profile 的 node_modules：

robocopy "<本仓库路径>" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-prompt-inject" /E /XD .git

2. 挂进 bundle 列表：

node tools/install.mjs

DSH 的 profile 加载顺序是 package.json 的 dsh.profile.bundles → cordis.patch.yml → --patch overlays（见 profile 目录里 cordis.yml 的注释）。
所以「插件有没有被加载」由 bundles 决定，而不是 cordis.patch.yml。
这一点很关键：cordis.patch.yml 会被 GUI 重写，bundles 列表不会。

3. 给目标预设挂上变量引用：

node tools/enable.mjs --preset preset-<你的预设 id>

4. 复查配对：

node tools/check.mjs

5. 重启 DSH。

配置

在 profile 的 cordis.patch.yml 里覆盖插件配置：

- id: prompt-inject
config:
variable: inject
textFile: '<文本文件的绝对路径>'

| 字段 | 默认 | 说明 |
| variable | inject | 注册的变量名；预设前缀里写 {{<这个名字>}}。必须匹配 [a-z][a-z0-9_]* |
| textFile | '' | 文本文件路径（UTF-8）。改动后按 mtime 自动重载，不必重启 DSH |
| text | '' | 内联文本。textFile 优先；两者都空则不注入任何内容 |
| presets | [] | agent 预设 id 白名单（对应会话创建记录里的 agentPreset）。空 = 不限制 |
| sessions | [] | 会话 id 白名单。空 = 不限制 |
| cwds | [] | 工作目录白名单（会话 header.cwd）。空 = 不限制 |
| enabled | true | 总开关 |
| stateFile | '' | 外部开关文件（JSON）。用于跟随别的插件的开关状态 |
| stateKey | enabled | 在上面那个 JSON 里读哪个键；该键必须严格等于 true 才注入 |
| debug | false | 往 %DSH_HOME%/prompt-inject.log 记每次求值的结果 |

variable 和 presets 是两道独立的闸门：引用决定「谁能拿到」（没写引用的预设根本不会展开这个变量），provider 决定「什么时候返回空」（白名单、开关、外部状态）。

工具

| 脚本 | 作用 |
| tools/check.mjs | 检查配对状态，并列出 profile 里全部变量引用。退出码 1 = 危险 |
| tools/enable.mjs --preset <id> | 往该预设 persona 的 prefix 末尾追加 {{variable}}（幂等） |
| tools/disable.mjs --preset <id> | 摘掉引用（幂等） |
| tools/install.mjs | 挂进 dsh.profile.bundles |
| tools/uninstall.mjs | 从 bundles 移除；还有引用时拒绝执行 |
所有写操作都会先在同目录留一份 .bak-prompt-inject-<时间戳>。加 --dry 可以只看改动不落盘。

卸载

node tools/disable.mjs --preset <preset-id>
node tools/uninstall.mjs
重启 DSH，然后自行删除 node_modules 里的插件目录

已知边界

- 一个 complete 段：assemble() 检测到多个 complete: true 会直接抛 multiple complete prompt sections are active。本插件不注册 section，不参与这个约束。
- 变量名不能撞车：同名变量重复注册会抛 prompt variable "x" is already registered。
和别的插件撞名时换一个 variable 值即可。
- provider 永不抛错：assemble() 同步调用每个 provider，provider 一抛会话就废。
所以插件内部所有读文件、读状态的动作都被 try/catch 兜住，最坏情况返回空串（等于不注入）。

许可

MIT