前言¶
在使用 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 的完全掌控權。