@macily.dots/dsh-prompt-inject

dsh plugin --profile web add @macily.dots/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。

从 npm 装：

dsh plugin --profile desktop add @macily.dots/dsh-prompt-inject

这个包在 npm 上的名字是 @macily.dots/dsh-prompt-inject（无 scope 的

dsh-prompt-inject 已被另一个不相关的包占用）。也可以照下面的手动步骤来——两者等价，

手动那套在离线或想直接盯 node_modules 时更方便。

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

   robocopy "<本仓库路径>" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@macily.dots\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