前言¶
在使用 DeepSeek Harness (DSH) 开发智能体时,system prompt 通常由多个插件共同拼接而成。要定位某一段文本的来源、排查重复规则或发现潜在的矛盾,直接查看配置文件往往不够直观。dsh-prompt-desk 插件提供了一个工作台视图,帮助开发者看清当前 prompt 的完整构成。
是什么¶
这是一个工作流插件,由 Hwayn 维护。它的核心职责是“观察”和“辅助”,而不是自动接管。它让你查看当前 system prompt 的各个部分(名称、来源、字节数、原始文本),并允许你添加自己的规则,同时检查重复与矛盾。
安装与启用¶
安装命令如下:
dsh plugin --profile web add dsh-prompt-desk
安装后,在 Web 界面进入 设置 → 提示词工作台 即可使用。
核心功能¶
1. 查看当前 Prompt 构成¶
插件会列出当前 system prompt 的所有部分,包括每个部分的名称、来源、字节数以及原始文本。它使用的是 ctx.systemPrompt.assemble() 的真实组装结果,而非猜测。
2. 添加“家规”¶
你可以输入自定义文本,并选择将其放置在提示词的前置、中间或后置。修改会立即生效,无需重启。
3. Inspection 检查¶
插件提供 Inspection 功能,用于发现潜在问题:
* 在多个部分出现的相同行(长度 >= 30 的标准化行)。
* 相互矛盾的规则(例如一个说“做”,另一个说“不做”)。
* 异常大的规则段落。
4. 撤销更改¶
所有通过该插件添加的内容都使用插件自己的 section 名称。要撤销,只需在设置中关闭插件或移除该插件,其他插件贡献的内容不会被修改。
典型用法¶
添加规则¶
在“家规”输入框中填写内容,选择 前置、中间 或 后置 位置,保存后即可生效。
查看实时组装¶
插件提供了一个接口用于查看实时组装情况:
curl http://localhost:3080/dsh-prompt-desk/prompt
返回的 JSON 包含 sections、rendered、tools 等字段。
注意事项¶
- 仅支持添加:目前插件只能添加部分,无法删除或重写其他插件贡献的部分。
- 检测阈值:重复检测仅针对长度 >= 30 的标准化行。
- 预览限制:预览可能不解析变量(如
{{model}}),且可能缺少具体代理作用域,导致工具列表显示为 0。 - 命名限制:插件 ID 不支持 npm 范围名,必须使用非作用域名称(如
dsh-prompt-desk,而非@hwayn/dsh-prompt-desk)。 - 阴影机制:插件不使用 DSH 的阴影机制,而是添加一层用户声音,不会静默替换其他插件的内容。
生态背景¶
DSH 采用“一切皆插件”的架构。此插件仅是社区维护的组件,用于辅助开发调试。
结语¶
dsh-prompt-desk 适合需要在开发阶段精细控制 prompt 构成的开发者。它通过可视化的方式解决了 prompt 调试的痛点,同时保持了对 prompt 的完全掌控权。