前言¶
DeepSeek Harness (DSH) 采用插件化架构,旨在让智能体开发更灵活。在开发过程中,我们经常需要为所有对话设置一个全局的“前置指令”,例如统一的安全约束、角色设定或特定的输出格式要求。如果通过修改源码来实现,改动成本较高且不易维护;如果每次请求手动拼接,则容易出错。
dsh-session-prompt 插件解决了这个问题。它提供了一个在 Web 界面即可实时编辑的注入点,能够将自定义的提示词插入到每个会话系统提示词的最顶部。
插件介绍¶
这是一个由 masknull 维护的 DSH 客户端插件。它的核心作用是在每次模型请求组装系统提示词时,将用户配置的内容作为最优先的层级进行注入。该插件自带构建产物,无需本地编译即可安装使用。
核心功能¶
- 顶部注入:将自定义提示词注入到系统提示词的最顶部(位于内置身份设定之前),对每个会话、每一次请求生效。
- Web 界面编辑:通过设置页的插件配置卡片,支持多行编辑、启用/禁用开关、保存、放弃修改以及恢复默认配置。
- 即时生效:保存配置后,下一次模型请求即会使用最新的提示词内容,无需重启 DSH 服务。
安装与启用¶
该插件依赖宿主环境版本,请确保满足要求。
环境要求:
* DSH 版本需 ≥ 0.1.7-rc.1。
* 安装了 Web UI 的 DSH 实例,且 dsh CLI 命令行工具在系统路径中。
安装命令:
dsh plugin --profile <你的profile名> add github:masknull/dsh-session-prompt
执行完命令后,建议重启 DSH 以确保新的 bundle 层生效。
使用方法¶
1、打开 Web 界面,进入 设置;
2、点击 插件配置 标签;
3、展开「会话头部提示词」卡片;
4、勾选 启用注入,编辑 提示词内容,点击 保存。
注意事项¶
- 作用域:注入的提示词属于全局根 section,适用于所有会话,而非单个会话特定。
- 版本兼容:如果宿主 DSH 版本低于
0.1.7-rc.1,该插件将无法加载。 - 文本安全限制:系统提示词渲染器对
{{变量}}模板有严格插值要求。为了防止错误的模板语法导致请求报错,插件在保存时会拒绝包含完整{{…}}组的文本。单独的{{(无闭合}})作为字面量文本是允许的。