前言¶
在 DeepSeek Harness（DSH）里，系统提示词由各插件与核心行在 system-prompt/assemble 阶段拼装而成。若只想在默认内容外「加几段」，可以用追加式插件；若希望每条会话发给模型的系统提示词就是一份你亲自写定的全文，则需要能写入设置、保存后即整体替换、并能一键恢复默认的能力。下面介绍社区插件 dsh-system-prompt（维护者 HuiHuanYe），分类为模型推理，在 DSH → 设置 → 系统提示词 中完成编辑、保存与重置。
这是什么¶
dsh-system-prompt 是 DSH 插件：在设置页编辑系统提示词，保存后从下一个模型请求起用保存文本整体替换装配结果，点「重置」恢复框架默认。不追加、不叠加，替换的是系统提示词本身。仓库见 GitHub，目录页见 SkillHub。许可证 MIT；资料记载兼容 DSH 0.2.2-rc.1、Node ≥ 24。
核心功能¶
设置页行为¶
| 操作 | 行为 |
|---|---|
| 打开设置页 | 编辑框显示当前系统提示词；默认展示内容来自最近一次真实请求的装配缓存，可整体编辑 |
| 保存 | 写入 $DSH_HOME/custom-system-prompt.md（未设置 DSH_HOME 时回退 ~/.dsh），从下一模型请求起整体替换，无需重启 |
| 重置 | 删除保存文件，恢复默认；编辑框同步回默认内容 |
| 不保存 | 插件不注册提示词内容，对默认行为无影响 |
页面提供实时反馈：默认/已启用、未保存修改、字节数（上限 256 KiB）、读取或保存失败原因。
替换机制与代价¶
插件在 system-prompt/assemble 上注册最外层（prepend）监听：先让其余装配链执行，再在存在保存内容时将 sections 换成单个字面段；agent-loop 的 step() 对装配结果调用 renderPrompt()，故模型收到的系统提示词即为替换文本。
- 工具声明由框架单独发送，替换后工具仍可用。
- runtime context（工作目录、沙箱、审批策略等）不在系统提示词文本内，框架照常提供。
- 代价：保存替换后，内置提示词段不再出现，包括 Harness 身份、部署人设、plan/team 策略、工具说明与工具 SDK、环境说明等；替换文本需自行包含你依赖的全部约束。
- 默认内容不会自动注入保存文本：编辑框里的默认仅作起点，保存的是你在框内看到的最终文本。
直接编辑 $DSH_HOME/custom-system-prompt.md 同样在下一请求生效。BOM、CRLF、首尾空白会规范化；UTF-8 上限 256 KiB 截断且不切开多字节字符。保存空或纯空白等同删除文件、恢复默认。
安装与启用¶
插件在 DSH 进程权限下运行，安装前应阅读仓库源码与 MIT 许可证。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装方式以仓库 README 为准。
1、从 GitHub 取得源码目录后，在 DSH → 设置 → 插件 → 从目录安装 中选择该目录；桌面 profile 由 Electron 管理，宜用插件页而非 CLI 随手改 profile。
git clone https://github.com/HuiHuanYe/dsh-system-prompt.git
2、或使用 CLI 直接安装仓库（将 <name> 换成你的 profile 名）：
dsh plugin --profile <name> add github:HuiHuanYe/dsh-system-prompt
3、本地目录已存在时，也可用链接安装：
dsh plugin --profile <name> add 'link:<绝对路径>'
安装后若未热加载，重启一次 DSH（已安装插件换新代码不会热替换模块）。卸载：在插件页移除 Bundle，再按需删除 $DSH_HOME/custom-system-prompt.md。
本地开发时，cordis.patch.yml 中 Loader 行 id 须全局唯一（本插件为 custom-system-prompt），勿复用 system-prompt 等核心行 id，否则可能破坏 systemPrompt 服务导致启动失败。
典型用法¶
- 打开 设置 → 系统提示词，在编辑框中查看并修改当前系统提示词。
- 点击「保存」。状态变为已保存、下一请求起生效；从下一条消息开始，所有会话均使用这份文本。
- 若要恢复框架默认内容，点击「重置」。
替换自下一模型请求起作用于所有会话（含当前会话）。若目标是「在默认提示词之外补几句」，应把需要保留的默认内容一并写入替换文本，或改用追加式插件。
适用场景与注意¶
适合：需要固定全文系统提示词、做 A/B 对比、或在遵守 MIT 与自审源码的前提下定制 Harness 行为约束的开发者。
务必注意：
- 整体替换会移除 plan/team 等内置段；plan 模式、团队协作等约束须在替换文本中自行保留。
- 编辑框默认内容来自最近一次真实装配；不同 agent preset 的 scoped 段可能不同，打开页面时所见是「最近一次请求」的版本。
- 插件代码更新后若进程仍加载旧模块，需重启应用与 Host。
- 资料记载 Windows 已实测；设置页在浅色/深色主题下尚未人工目视确认。
仓库 Host 测试 15 项、Client 测试 6 项（共 21 用例）通过；2026-11-11 曾在真实 Host（desktop profile）上端到端验证保存后下一请求系统提示词仅剩替换文本、删除文件后恢复完整默认。
结尾¶
dsh-system-prompt 把「改系统提示词」收敛到设置页：保存即整体替换、重置即回默认，适合需要完全掌控发给模型那一段 system 文本的场景。进一步了解可从 SkillHub 目录页 进入，或直接查看 GitHub 仓库 中的行为说明与测试命令。
