DeepSeek Harness (DSH) 提供了插件化架构，允许开发者精细化管理提示词。dsh-granular-prompt 是一个用于提示词组合管理的插件，它提供了一套实时查看、抑制、替换和还原系统提示词各部分的机制，并支持自定义系统提示词和 persona 库。
定位¶
这是一个由 joao-paulo-santos 维护的客户端插件。它不改变底层逻辑，而是通过“Granular Settings”中的“Prompt”标签页和聊天编辑器中的“Persona Picker”，提供可视化的提示词编辑与管理能力。
核心功能¶
1. 实时提示词清单
在 Granular Settings 的 Prompt 标签页中，列出即将发送的请求中包含的所有系统提示词部分。每个部分支持查看全文、禁用、替换（基于 scratchpad）和还原操作。
2. 自定义系统提示词
支持库管理。提供“加法模式”和“完整模式”。完整模式下，用户输入的文本将成为整个提示词（受注册表强制约束）。
3. Persona 库与选择器
支持全局默认 persona 和按会话选择。在聊天编辑器中集成了 persona 选择器，可快速切换当前会话使用的 persona。解析逻辑为：会话设置 > 默认 persona > 无。
安装与启用¶
插件需要先检出 DeepSeek Harness 源码并指定 profile（示例中使用 web）。
- 确保已安装依赖：
dsh-granular-settings、dsh-scratchpad（UI 必需）以及可选的dsh-event-relay。 - 执行安装命令：
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-prompt
- 重启 Harness，在 Granular Settings 中即可看到 Prompt 标签页。
典型用法¶
- 查看即将发送的提示词：打开 Granular Settings 中的 Prompt 标签页，这里会实时展示下一次请求的提示词构成。
- 替换或禁用特定部分：勾选某个部分的 Suppress 复选框可将其移除；使用 Replace 功能可从 Scratchpad 中选择文本覆盖该部分。
- 自定义系统提示词：在 Persona 或 System Prompt 库中添加内容，并在聊天界面选择生效。若使用“完整模式”，你需要提供完整的提示词文本。
适用场景与注意¶
- 运行权限：插件以当前 DSH 进程权限运行。
- 依赖检查：安装前需确认依赖项（特别是
dsh-scratchpad）已正确链接，否则 UI 可能无法激活。 - 数据存储：配置存储在
~/.dsh/settings/prompt-manager.目录。
该插件通过可视化的方式解决了 DSH 提示词组装过程不可见的问题，适合需要对提示词进行精确控制或调试的开发者。更多细节请参考 GitHub 仓库：链接。
