前言¶
DeepSeek Harness (DSH) 原生支持插件擴展，但在管理本地 Markdown 提示詞模板和跨設備同步方面存在空白。dsh-prompt-switcher 是一個 Web 插件，旨在解決這些問題。它允許用戶通過 / 快捷指令快速選擇本地 .md 模板，支持全局提示詞、環境變量替換以及 WebDAV 同步。
核心功能¶
- 本地模板選擇：通過
/菜單選擇本地目錄下的.md文件。選中後，模板對整個對話持續生效，約束力等同於AGENTS.md。 - 全局提示詞：設置對所有新對話生效的提示詞。在用
/選擇模板時，模板會追加在全局提示詞之後，兩者同時生效。 - 環境變量：支持在模板中使用
{{env:變量名}}語法，在發送給模型前替換爲對應的值。 - WebDAV 同步：支持將模板和環境變量同步到 WebDAV 服務器，實現跨設備管理。
- 會話刪除：支持徹底刪除對話（需 DSH 0.2.0-rc.1 及以上版本）。
安裝與啓用¶
- 確保環境滿足要求：DSH >= 0.1.7-alpha.1，Node >= 22.19。
- 執行安裝命令：
dsh plugin --profile web add github:mikulo/dsh-prompt-switcher
- 安裝完成後，重啓
dsh web並刷新頁面。
典型用法¶
1. 配置模板目錄¶
打開 設置 → 提示詞模板，點擊「選擇文件夾」選中存放 .md 模板的目錄。插件會讀取該目錄第一層的 .md 文件。新目錄中的模板默認全部關閉，需手動開啓。
2. 選擇模板¶
新建對話時，在輸入框輸入 /，已激活的模板會出現在菜單中。選中模板併發送第一條消息後，該模板會對後續每一輪對話生效。
3. 使用環境變量¶
在模板中使用 {{env:變量名}} 引用環境變量。例如變量名爲 api_key，值爲 123456，模板中寫 {{env:api_key}}，發送時會變爲 123456。
4. WebDAV 同步¶
在 設置 → 提示詞模板 中切換到「WebDAV 雲同步」標籤頁。配置服務器地址、用戶名和密碼（密碼僅保存在本機），點擊「測試連接」驗證配置。保存後可進行「同步到本地」或「同步到雲端」。
適用場景與注意¶
- 權限要求：插件以當前 DSH 進程的權限運行，需確保進程有權限讀寫
~/.dsh/目錄。 - 數據安全：環境變量值會以明文出現在發送給模型的內容和會話記錄中，請勿在變量中存儲敏感信息。
- 版本依賴：刪除對話功能依賴 DSH 0.2.0-rc.1 的會話存儲結構。
- 熱更新限制：插件的 Host 半代碼修改後必須重啓
dsh web才能生效，Browser 半支持熱更新。
結語¶
該插件通過標準 DSH bundle 實現，Host 和 Browser 均爲純 ESM，無運行時依賴。適合需要在 DSH 中統一管理本地 Prompt 模板並希望實現雲端同步的用戶。
