模型提示词装甲 caixuf/dsh-prompt-armor

dsh-prompt-armor

在 DeepSeek Harness 里，给每个模型配自己的系统提示词。

配置档由名字、提示词和适用的模型模式组成。智能体组装系统提示词时，匹配当前模型的配置档会被注入。于是同一个 Harness 下，不同模型拿到不同指令，不用重启，也不用改核心文件。

为什么需要它

社区插件 dsh-purge 做的是同一件事——给每个模型注入提示词——但它的做法是用一张 355 KB 的字符串替换表，重写 @deepseek-ai/ 里的文件。这种做法有三个后果：

- 对版本很脆弱。 替换表匹配的是源码里的字面字符串，Harness 发版时挪一个空格，插件就悄悄失效。每发一版，表里就得加一个分支。
- 会被包管理器抹掉。 补丁打在 node_modules 里，重装一次就没了，插件下次启动还得重新打。
- 只能靠猜。 官方工作区的基线是一条用户消息，不是提示词段落，所以插件那个「丢掉基线」的过滤器按名字和文本匹配，通常根本不会触发。

这个插件走的是官方接口。Harness 专门为这个用途暴露了 ctx.systemPrompt.section()，Harness 自己也用它给每个工具写引导文本。段落注册在插件自己的上下文上，卸载插件就一并移除，系统提示词回到默认形态。

它还实现了 dsh-purge 只在宣传里提过的东西：按模型分发。上游 README 说「按模型换提示词」，但它的代码里找不到任何模型、服务商或路由的键——注入的提示词对所有模型都一样。这里模型 id 从组装上下文里读，分发是真的。

安装

dsh plugin --profile desktop add <path-to-this-directory>

或者在桌面客户端里打开 Settings → Plugins，在安装框里填目录。

使用

打开 Settings → Model Prompts。面板左侧列出配置档，右侧编辑选中的那个。

| 字段 | 含义 |
| Name | 面板里显示的名字，也可以选择显示在注入文本上方。 |
| Applies to | 模型模式，一行一个。 是通配符。 |
| Enabled | 这个配置档是否参与。 |
| Prompt | 注入系统提示词的文本。 |

提示词正文里会替换两个变量：{{model}} 和 {{provider}}。其他 {{…}} 原样保留。

匹配

最具体的模式胜出：

- 精确的模型 id 胜过通配符；
- 长的通配符胜过短的；
- 禁用的配置档永不生效；
- 没有匹配时，什么都不注入，系统提示词保持不变。

所以列出 deepseek-v4.1-flash 的配置档只作用于那个模型，列出 deepseek- 的作用于所有 DeepSeek 模型，列出 的则是兜底。

文件

Host 把规则保存在磁盘上，位于 $DSH_HOME/prompt-armor/ 下：

index.json the profile list and their model patterns
profiles/<id>.md one profile's prompt text

面板通过 Host 写入，但这些文件就是普通文本：用任意编辑器修改，运行中的智能体下一步就会读到改动。

配置

插件在 cordis.patch.yml 中的那一行接受这些键：

| 键 | 默认值 | 含义 |
| enabled | true | 插件是否提供这一段内容。 |
| dataDir | $DSH_HOME/prompt-armor | 配置档存放的位置。 |
| order | -100000 | 注入文本在提示词中的位置。 |
| showProfileName | true | 注入文本开头是否显示配置档名称。 |

order 是普通数字，不依赖某个具名槽位，将来版本重新编号也不受影响。默认值把注入文本放在最前面，排在 harness 自己的身份行之前，这样人设读起来是整体框架，而不是附带说明。取值大于 10200 时，文本改放到部署人设后缀之后，读起来像一条收尾指令。

工作原理

Host 这一半注册一个提示词段：

ctx.systemPrompt.section({
name: 'dsh-prompt-armor:profile',
order: config.order,
interpolate: false,
text: (context) => {
const model = context.agent?.options?.model
const profile = selectProfile(store.profiles, model)
return profile === null ? '' : store.text(profile.id)
},
})

text 是函数，每次组装提示词都会求值，因此能读到本次组装对应的模型。注册这一段时用了 interpolate: false，因为用户提示词里可能合法地包含 {{…}}，而 harness 遇到未知变量引用会抛错。

浏览器这一半是纯 JavaScript，没有构建步骤：它注册一个 settings.section 条目，通过 harness 自带 web 服务器上的一条小型 JSON 路由与 Host 通信。写操作的请求带自定义请求头，跨源页面无法驱动它们。

测试

node test/rules.test.mjs # the matcher and the store
DSH_ASAR=<resources>/app.asar node test/integration.test.mjs

集成测试从桌面版 app.asar 中解出已安装的 @deepseek-ai/dsh-system-prompt，把 Host 这一半挂到真实注册表上，再断言组装出的提示词——所以「注入文本能到达模型」是针对实际安装的 harness 验证的。

许可

MIT。