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 倉庫:鏈接。