DSH(DeepSeek Harness)的理念是“一切皆插件”。在开发或调试智能体时,经常需要为不同的会话注入特定的系统指令或提示词。通常这需要修改代码或手动粘贴文本。dsh-prompt-lib 插件提供了一个可视化的 Prompt 库,让你在设置页面集中管理提示词,并在聊天界面中为每个会话快速切换。
插件定位¶
该插件由用户 Stmol 维护,采用 MIT 许可证。它为 DSH 增加了一个独立的 Prompts 页面,允许你在本地保存提示库,并在创建对话时通过简单的勾选来应用这些提示。提示一旦激活,会跟随会话的每个模型步骤及其启动的子代理。
核心功能¶
- Prompt 管理:在
Settings菜单下进入Prompts页面,支持编写、编辑和删除提示。 - 会话级切换:在聊天编辑器中,通过控件勾选需要的提示。
- 全局生效:勾选的提示会应用于当前会话的每个模型步骤及其启动的子代理。
安装与启用¶
使用官方命令安装插件。首次安装后需要重启 DSH。
dsh plugin add @stmol/dsh-prompt-lib
插件没有自动更新机制。如需更新,需要先移除插件,然后重新添加。后续的编辑通过 HMR(热模块替换)实时生效。
典型用法¶
-
编写提示:
打开Settings>Prompts,输入标题和指令后保存。标题仅用于你在列表中的识别和搜索,实际发送给模型的是指令文本。 -
激活提示:
进入任意聊天界面,在编辑器工具栏中找到Prompts控件(位于权限下拉框的右侧)。点击控件,勾选需要的提示。按钮上会显示当前激活的提示数量。 -
生效规则:
勾选操作从下一个模型步骤开始生效。你无需重启应用或新建会话即可看到效果。点击Clear或再次勾选可取消提示。- 默认行为:如果某个提示被标记为“在新对话中默认启用”,新会话打开时会自动勾选。一旦你在某个会话中手动修改(勾选/取消),该会话将保留你设定的配置,不再继承默认值。
注意事项¶
- 文件权限:设置文件必须可写。如果权限不足,Prompts 页面会禁用编辑控件,编辑器也会显示拒绝写入的具体原因。
- 容量限制:
- 单个指令最多 8000 个字符。
- 最多保存 100 个提示。
- 渲染时最多读取 500 个库条目。
超出限制的内容不会影响模型输出,但仍然保留在配置中。
- 选择累积:插件会保留每个会话的勾选历史。即使后续删除了某个提示,之前的会话记录仍会保留(即注入空内容),这可能会导致意外的默认行为。
- 子代理继承:如果会话本身没有选择提示,子代理将继承其父会话的选择。只有当整个链条都没有选择时,才会使用“新对话默认值”。
该插件通过将 Prompt 管理集中化,简化了智能体开发中的提示词复用流程。你可以从 GitHub 查看源码或提交问题。