dsh-prompt-inject
DSH 插件：注册可配置的提示词变量，使使用 complete:true 人格的代理预设（会丢弃其他所有系统提示词部分）仍能接收注入的文本块。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:MacilyDots/dsh-prompt-inject#fd22c0551713d5255c6404a9f41c0ed8ab3137a8Prompt Inject 以 dsh-prompt-inject 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给「用了 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。
把本仓库放进 profile 的 node_modules：
robocopy "<本仓库路径>" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-prompt-inject" /E /XD .git
挂进 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 列表不会。
给目标预设挂上变量引用：
node tools/enable.mjs --preset preset-<你的预设 id>
复查配对：
node tools/check.mjs
重启 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 里的插件目录
assemble() 检测到多个 complete: true 会直接抛
multiple complete prompt sections are active。本插件不注册 section，不参与这个约束。prompt variable "x" is already registered。
和别的插件撞名时换一个 variable 值即可。assemble() 同步调用每个 provider，provider 一抛会话就废。
所以插件内部所有读文件、读状态的动作都被 try/catch 兜住，最坏情况返回空串（等于不注入）。MIT