系统提示注入 datawork-technology/dsh-system-prompt

dsh-system-prompt

一个 DeepSeek Harness (DSH) 插件，用于向本地配置的模型追加自定义系统提示文本：规则匹配精确的 provider/model 路由或提供商级别的 provider/ 通配符，并注入到系统提示的末尾。规则按模型在设置页面中管理，并且在 DSH 重启后仍然保留。

功能特性

- 按路由注入 —— 在每个模型步骤中，匹配规则中的提示会被追加到系统提示中（注册顺序为 9950，位于所有内置工具和结构化输出部分之后）。适用于主会话、子代理以及工作流子级。
- 两级规则 —— provider/ 规则适用于该提供商的所有模型；provider/model 规则仅适用于该精确模型。当两者同时存在时，它们按顺序叠加：先是提供商级别，然后是精确模型级别。
- 设置页面 —— 设置 → System Prompt 会列出每个本地配置的提供商及其模型（与 Models 设置页面使用相同的数据源）。每一行都可以添加/编辑/清除规则；已注入的行会显示一个徽章和内容预览。
- 持久化 —— 规则保存在 /system-prompt/config.json（默认 ~/.dsh/system-prompt/config.json），并在 DSH 重启后恢复。
- 即时生效 —— 保存规则后会在下一次模型请求时生效，无需重启。

安装（标准 DSH 包）

dsh plugin --profile web add @datawork-technology/dsh-system-prompt --registry=https://registry.npmjs.org

显式指定 npmjs 注册表，以免本地/镜像注册表配置重定向安装。之后重启 DSH（主机加载、typert 注册和客户端包注入都在启动时进行）；随后 System Prompt 页面会出现在设置中。

卸载：

dsh plugin --profile web remove @datawork-technology/dsh-system-prompt

使用方法

1. 打开 设置 → System Prompt（紧挨着 Models 页面之后）。
2. 页面会为每个本地配置的提供商显示一张卡片；每张卡片的第一行是 All models (provider-wide)，后面是该提供商配置中每个模型对应的一行。
3. 点击某一行上的 Add prompt / Edit，填写要追加的文本，然后点击 Save —— 它会立即生效。Clear rule 会删除该条目。
4. 匹配采用精确的路由匹配（provider/model，区分大小写，例如 minimax-cn/MiniMax-M3）；模型 id 与 Models 设置页面中配置的完全一致。

规则示例

| 规则键 | 作用范围 |
| deepseek-official/ | DeepSeek 官方路由上的所有模型 |
| minimax-cn/MiniMax-M3 | 仅 MiniMax-M3 |
| zai-coding-cn/glm-5.3 | 仅 GLM-5.3 |

典型用法：向较弱的模型追加严格的工作协议（先验证再声明、最小差异、契约对齐……），或将项目约定/输出格式要求附加到特定模型。

实现说明
- 注入是 systemPrompt 服务上的一个动态 section：该 section 的文本是一个函数，在每次组装模型步骤时都会被求值。运行时组装上下文携带 agent，而此请求的目标路由会按照宿主模型选择层所使用的相同优先级进行解析（UI 选择 → 记录的请求头 → 创建时选项；自 DSH 0.1.5 起，单独的 agent.options 仅是一个创建时快照）。未匹配的路由返回 ""，渲染器会丢弃空 section（零开销）。
- 该 section 以顺序 9950 注册（index.js 中的 SECTION_ORDER）。这位于所有已发布的工具 / 结构化输出 section 之后，但并非较新宿主上的绝对最后顺序，后者还会注册 HARNESS_SOURCE = 10000、WEB_SURFACE = 10100 和 DEPLOYMENT_PERSONA_SUFFIX = 10200。如果文本也必须落在这些之后，请将该常量提高到它们之上。
- 规则通过插件自有的 Typert Remote 服务（systemPromptInjector.getState / setRule）进行读写；客户端通过 ctx.remote.$mount 自行挂载该命名空间。

开发

npm run check # node --check index.js client.js typert.host.js

本地链接：安装（插件目录必须已有 node_modules，参见 AGENTS.md）：

npm install --no-save --registry=https://registry.npmjs.org @deepseek-ai/cordis@4.0.2 @deepseek-ai/dsh-typert-protocol@0.1.2-rc.1 zod@4.5.4
dsh plugin --profile web add /path/to/dsh-system-prompt
restart DSH to take effect

发布

推送一个 v 标签：.github/workflows/release.yml 会构建 tgz、发布 GitHub Release，并通过 OIDC Trusted Publishing 发布到 npm（请先在 npmjs.com 上配置受信任发布者：此仓库 + .github/workflows/release.yml）。

归属

dsh-system-prompt 是 MoonlitDropOfBlood/dsh-model-prompt-injector（MIT © duke）的更名衍生作品。逻辑未变；包名、标识符（插件 id、服务名、section 名、持久化目录）、仓库元数据、UI 品牌和文档均已更名。上游 MIT 声明保留在 LICENSE 中。

许可证

MIT © datawork-technology — 参见 LICENSE。