系统提示词覆盖 Espboxx/dsh-system-prompt-override

dsh-system-prompt-override

在 DSH（DeepSeek Harness）的设置面板中自定义覆盖系统提示词（dsh-system-prompt），运行时即时生效，无需重启。

设置 → 系统提示词：启用开关 + 自定义正文（支持 {{model}} / {{cwd}} 等变量插值），支持「完全替换」模式。

功能

- 设置面板（设置 → 系统提示词）：
- 启用自定义系统提示词（开关）
- 完全替换模式：整个系统提示词只剩自定义文本（连 Harness 身份段一起去掉）
- 正文支持 {{model}} / {{cwd}} 等提示词变量插值（与部署 persona 一致）
- 保存后写入 settings.yaml 的 system-prompt-override 段，下一轮对话即生效，无需重启
- 「停用并清空」一键复位
- 优先级最高：即使 agent-preset（如 router-standard）在装配期接管了会话 persona，本插件以 system-prompt/assemble waterfall 最外层监听器在最后改写，确定性覆盖。

原理

- 装配钩子：ctx.on('system-prompt/assemble', ..., { prepend: true }) —— 共享 hook 列表最前的监听器位于 waterfall 最外层，post-next() 改写最后生效（router preset 的 applyPersona 会把所有 /persona/i 段替换成它自己的，本插件随后再替换一遍）。
- persona 模式：保留 Harness 身份与运行时上下文，只替换 persona 段； complete 模式：sections 只剩自定义文本。
- 设置持久化：@deepseek-ai/dsh-settings 的 installSettingsSection，命名空间 system-prompt-override，UI 通过 wire API settings.describe / settings.replace 读写。
- 设置面板在别处被修改（如手动编辑 settings.yaml）时会自动刷新。

安装

开发机热装（免重启）

在 DSH 会话中调用 dev_install_package 指向本目录（改 profile package.json bundles + junction + loader.create）。

通过 profile patch 装配

在 profile 的 cordis.patch.yml 中插入插件并配置默认值：

- insert:
- id: dsh-system-prompt-override
name: 'dsh-system-prompt-override'
config:
enabled: false # 默认启用状态 complete: false # 默认是否完全替换 persona: '' # 默认提示词正文

配置项

| 字段 | 类型 | 默认值 | 说明 |
| enabled | boolean | false | 是否启用自定义系统提示词 |
| complete | boolean | false | 完全替换：整个系统提示词只剩自定义文本 |
| persona | string | '' | 自定义提示词正文（支持 {{model}} 等插值）|

开发

- 本插件为纯手写 JS（lib/ 即源码，无构建步骤），client 端为手写 __ModuleLoader__ factory。
- 依赖（peerDependencies）：@deepseek-ai/cordis、@deepseek-ai/dsh-settings、@deepseek-ai/schemastery。

License

MIT © Espboxx