前言¶
DeepSeek Harness (DSH) 的核心架构基于插件。当开发者需要在所有智能体预设中统一注入特定的行为约束或上下文信息时,逐一修改每个预设的配置会带来维护成本。dsh-custom-prompt 插件提供了一个全局可编辑的系统提示词区域,允许在 DSH 的全局提示层中添加自定义文本,并自动应用到所有智能体。
这是什么¶
这是一个由 johnvictorio 维护的 DSH 插件。它将用户定义的文本注册为全局系统提示词的一个部分(顺序 50),并为用户提供了一个设置页面来管理这段文本。该插件不依赖隔离环境,直接在宿主平面注册服务。
核心功能¶
插件主要实现了以下能力:
- 注册持久的 custom-prompt 设置命名空间,存储结构为 { enabled, text }。
- 将文本注册为系统提示词部分,插入位置为顺序 50(位于 persona 和工具指导之间)。
- 实时重新注册:当设置变更时,插件会自动重新注册提示词部分,文本修改无需重启。
- 全局应用:该提示词部分位于全局层,对所有智能体预设(标准、代码、最小、cordis 及任何自定义预设)均有效。
- 提供设置界面:在 DSH 的 Settings 面板中新增 Custom Prompt 页面。
安装与启用¶
- 在插件源码目录下打包:
npm pack
- 将生成的
.tgz包添加到 web profile:
dsh plugin --profile web add file:/absolute/path/to/dsh-custom-prompt-1.0.0.tgz
- 编辑
~/.dsh/profiles/web/package.json,在dsh.profile.bundles数组中添加"dsh-custom-prompt"。 - 重启 profile 以加载新插件:
dsh web
典型用法¶
- 打开 Settings,进入 Custom Prompt 页面。
- 勾选 Enabled。
- 在文本框中输入提示词内容,例如一组工作规则。
- 点击 Save。更改会在后续对话步骤中立即生效。
- 变量使用:文本中可使用{{customnote}}变量获取固定提醒行。
- 重置:点击 Reset 会清除存储的字段并返回默认状态(禁用且为空)。
注意事项¶
- 环境要求:浏览器必须通过 loopback 连接。DSH 设置写入仅限本地,远程连接会导致设置功能不可用。
- 变量严格性:DSH 严格渲染提示词变量。仅支持
{{customnote}},其他未注册的变量会导致提示词组装报错,从而中断模型回合。 - 状态控制:当文本为空,或
enabled为false时,插件不会注册任何提示词部分。 - 重启要求:代码层面的修改需要重启 profile,但文本内容的编辑不需要重启。
- 权限与合规:插件以当前 DSH 进程权限运行。安装前应检查源码与许可证。
结尾¶
该插件解决了在 DSH 中统一管理全局提示词的需求,为开发者提供了灵活的配置手段。项目源码与文档位于 GitHub。