前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在讓智能體開發更靈活。在開發過程中，我們經常需要爲所有對話設置一個全局的“前置指令”，例如統一的安全約束、角色設定或特定的輸出格式要求。如果通過修改源碼來實現，改動成本較高且不易維護；如果每次請求手動拼接，則容易出錯。
dsh-session-prompt 插件解決了這個問題。它提供了一個在 Web 界面即可實時編輯的注入點，能夠將自定義的提示詞插入到每個會話系統提示詞的最頂部。
插件介紹¶
這是一個由 masknull 維護的 DSH 客戶端插件。它的核心作用是在每次模型請求組裝系統提示詞時，將用戶配置的內容作爲最優先的層級進行注入。該插件自帶構建產物，無需本地編譯即可安裝使用。
核心功能¶
- 頂部注入：將自定義提示詞注入到系統提示詞的最頂部（位於內置身份設定之前），對每個會話、每一次請求生效。
- Web 界面編輯：通過設置頁的插件配置卡片，支持多行編輯、啓用/禁用開關、保存、放棄修改以及恢復默認配置。
- 即時生效：保存配置後，下一次模型請求即會使用最新的提示詞內容，無需重啓 DSH 服務。
安裝與啓用¶
該插件依賴宿主環境版本，請確保滿足要求。
環境要求：
* DSH 版本需 ≥ 0.1.7-rc.1。
* 安裝了 Web UI 的 DSH 實例，且 dsh CLI 命令行工具在系統路徑中。
安裝命令：
dsh plugin --profile <你的profile名> add github:masknull/dsh-session-prompt
執行完命令後，建議重啓 DSH 以確保新的 bundle 層生效。
使用方法¶
1、打開 Web 界面，進入 設置；
2、點擊 插件配置 標籤；
3、展開「會話頭部提示詞」卡片；
4、勾選 啓用注入，編輯 提示詞內容，點擊 保存。
注意事項¶
- 作用域：注入的提示詞屬於全局根 section，適用於所有會話，而非單個會話特定。
- 版本兼容：如果宿主 DSH 版本低於
0.1.7-rc.1，該插件將無法加載。 - 文本安全限制：系統提示詞渲染器對
{{變量}}模板有嚴格插值要求。爲了防止錯誤的模板語法導致請求報錯，插件在保存時會拒絕包含完整{{…}}組的文本。單獨的{{（無閉合}}）作爲字面量文本是允許的。
