dsh-prompt-library：DeepSeek Harness 可複用提示詞庫

前言¶

DeepSeek Harness（DSH）採用插件化架構。在調試智能體或構建複雜工作流時，提示詞的複用往往依賴手動複製粘貼，不僅效率低下，也不利於維護。dsh-prompt-library 插件旨在解決這一問題，它將可複用提示詞集中管理，提供保存、搜索和編輯的能力。

插件定位¶

該插件由 ManoloRemiddi 維護，屬於記憶類插件。它允許在 DSH 的設置界面中保存、搜索、預覽、編輯和刪除提示詞。提示詞文本以純文本形式渲染，保存時不會調用模型或發送聊天消息。該插件可以獨立運行，也可以連接現有的 Augmentor 服務。

核心功能¶

界面管理：在 DSH 的 Settings → Prompt library 中進行增刪改查。
獨立存儲：使用本地 SQLite 數據庫存儲提示詞。
服務集成：連接現有的 Augmentor 提示詞服務。
併發處理：通過版本（revision）機制處理併發保存衝突。

安裝與啓用¶

該插件以 .tgz 壓縮包形式分發。

下載安裝包
從 v0.2.1 的發佈頁面下載 .tgz 資產。
執行安裝
使用 DSH 的插件管理命令安裝。假設使用 web profile：

    dsh plugin --profile web add https://github.com/ManoloRemiddi/dsh-prompt-library/releases/download/v0.2.1/dsh-prompt-library-0.2.1.tgz

完成配置
安裝需要 Linux 環境、Node.js 22.19+ 以及一個可用的 DSH web profile。獨立模式還需要 Python 3（標準 Python 構建通常已包含 SQLite 支持）。
安裝完成後，重啓 DSH 進程並刷新頁面，進入 Settings → Prompt library 即可開始使用。

使用方式¶

安裝後，可以通過以下步驟使用提示詞庫。

創建與保存¶

在設置頁面點擊 New prompt，輸入快捷方式名稱和提示詞文本，點擊 Save prompt。

存儲模式¶

插件提供兩種存儲模式：
* 獨立模式（默認）：數據存儲在 $XDG_DATA_HOME/dsh-prompt-library/prompts.sqlite3。可以通過環境變量 DSH_PROMPT_LIBRARY_DATA 指定不同目錄，通過 AUGMENTOR_PYTHON 指定 Python 解釋器。
* Augmentor 服務模式：將環境變量 DSH_PROMPT_LIBRARY_SOCKET 指向現有的 Augmentor Unix socket，例如 $HOME/.local/state/augmentor/prompts.sock。插件會連接該服務，無需啓動 Python 進程。

插入提示詞¶

在聊天編輯器中插入提示詞需要兼容的 Augmentor 接口（如斜槓菜單）。[clipboard] 標記會被原樣存儲，具體展開由消費應用處理。

注意事項¶

數據遷移：版本 0.2.1 不會自動遷移 0.1.0 或 0.2.0 的數據。新安裝的獨立模式會從空數據庫開始，舊的數據庫保持不變。若要保留數據，需手動複製或配置 Augmentor 服務模式。
併發衝突：處理併發保存時，如果發生衝突，過時的草稿稿仍會可見。遇到衝突時，建議將內容複製到安全位置，刷新並重新選擇當前提示詞後再應用更改。插件不會自動重試寫入。
存儲限制：獨立模式存在硬性限制：最多 1,000 條提示詞，總內容大小不超過 500,000 字節。快捷方式名稱僅支持 1-128 個字母、數字、連字符或下劃線。
卸載清理：執行 dsh plugin --profile web remove dsh-prompt-library 僅卸載插件界面。已保存的數據庫文件和 Augmentor 服務保持不變，需手動刪除。
版本兼容性：插件在 DSH 0.1.5-rc.1 上驗證過，其他版本可能會改變 web/UI 界面。

結語¶

dsh-prompt-library 爲 DSH 提供了一個輕量級的本地提示詞管理方案，適合需要在本地管理大量 Prompt 的工作流。更多詳情或反饋，請訪問其 GitHub 倉庫或技能中心插件目錄。