前言¶
在 DSH Web GUI 裏寫提示詞，常見做法是複製粘貼外部文檔，或在編輯器裏翻歷史記錄。條目一多，分類、搜索和「插入時還要改佔位符」都會拖慢節奏。把模板放在雲端又涉及隱私與離線可用性。
下面介紹維護者 JianhangLy 的客戶端插件 dsh-prompt-library（社區目錄分類：客戶端）：把常用提示詞存成本機一個 JSON 文件，在對話輸入框旁用按鈕或快捷鍵打開取用浮層，支持分組、分詞搜索、{{變量}} 填值後再寫入草稿，並自帶 13 套內置模板。數據不聯網、不上傳。
這是什麼¶
dsh-prompt-library 是 DSH 的「提示詞庫」插件：宿主側提供迴環 HTTP 讀寫與落盤，客戶端在 composer 輸入區註冊 ▤ 按鈕、取用浮層和設置頁。解決的是「反覆寫同類提示、又要本地可控」的問題，與單純依賴剪貼板或外部筆記相比，插入、追加、置頂和整庫導入導出都在同一界面完成。
- 倉庫：JianhangLy/dsh-prompt-library
- 社區目錄：SkillHub 插件頁
- 當前 package 版本：0.3.0，許可證 MIT
核心功能¶
取用浮層（composer）¶
- 輸入框工具行有 ▤ 按鈕，或按 Alt+P 打開浮層。
- 頂部分類行：全部 / 未分組 / 各分組（帶條數），可與搜索、置頂疊加。
- 搜索按空格分詞、逐詞 AND，匹配標題、正文、分組。
- 點擊一條：正文替換當前草稿；Shift+點擊：追加到草稿末尾（空行分隔）。
- 鍵盤：↑↓ 選擇，Enter 插入，Esc 關閉。
- 每條右側 ▸ 可展開完整正文（限高 40vh，可多條同時展開）。
- 正文含
{{變量}}時，插入前彈小表單；{{date}}、{{time}}自動填當天日期與時間，留空變量保留原樣。 - 「存當前草稿」可把草稿存成一條，存前可填標題與分組。
設置頁（設置 → 提示詞庫）¶
- 列表上方搜索框與分類 chips；單條「編輯」在條目下方內聯展開，同一時間只編輯一條。
- ★ 置頂；刪除二次確認後 6 秒內可撤銷。
- 導入併合並（按 id 覆蓋同名、保留其餘）/ 導入並替換（清空後寫入，再確認）；導出 下載整庫 JSON。
- 分組管理：重命名（與已有組名相同即合併）、解散（只清分組名不刪條目）。
- 補齊內置模板：按
id（builtin:*）補缺失項，不覆蓋已改過的正文。 - 頁面會顯示數據文件與備份文件路徑。
內置模板¶
首次加載自動補 13 套模板，分 6 組（開工、排錯、驗收、工程、寫作、學習），正文預留 {{變量}}。播種只補缺失 id，每個版本在瀏覽器 localStorage 記 dsh-prompt-library:builtin 自動補一次；內置條目可像普通條目一樣編輯、改分組或刪除。
數據與併發¶
- 文件名固定
prompt-library.json，目錄優先級：DSH_PROFILE_DIR→DSH_HOME→~/.dsh→ 插件目錄（兜底）。 - 整庫字段含
version、rev（單調遞增）、prompts數組；排序：置頂 → 最近使用 → 最近修改。 - PUT 帶
rev做樂觀鎖；與磁盤不一致返回 409 並帶回最新整庫。寫盤先.tmp再rename；整庫保存前複製上一版爲prompt-library.backup.json（僅更新lastUsedAt的寫入不備份）。 - 請求體上限 200 KB，單條正文上限 64 K 字符。
宿主註冊三條迴環路由（僅迴環 Host，無鑑權）：GET/PUT /prompt-library、POST /prompt-library/used。
安裝與啓用¶
從 GitHub 安裝（命令來自倉庫 README）：
dsh plugin --profile desktop add github:JianhangLy/dsh-prompt-library
本地開發可 link，改客戶端後刷新頁面即可；改 lib/index.js 需重啓 DSH：
dsh plugin --profile desktop add link:<插件目錄>
卸載：
dsh plugin --profile desktop remove dsh-prompt-library
典型用法¶
- 在輸入框旁點 ▤（或 Alt+P）打開浮層。
- 點分類 chip 縮小範圍，或在搜索框輸入關鍵詞。
- 點某一條 → 替換草稿；要在後面接着寫 → Shift+點擊。
- 有
{{變量}}時先填值再進入草稿。 - 改內容、分組、置頂 → 「設置 → 提示詞庫」。
導出得到純 JSON，可手工編輯後用「導入並替換」灌回。
適用場景與注意¶
適合：經常在 DSH 裏複用審查清單、排錯話術、文檔潤色模板等，且希望數據只在本機、可備份可遷移的開發者。
注意：
- 選中即替換草稿，無確認步驟；插錯需自行重寫。
- 備份僅保留「上一版」，長期留底請用導出。
- 浮層爲
position: fixed貼按鈕定位；個別主題位置偏時需改client/client.js裏LibraryPanel的樣式計算。 - 列表全量渲染，百條以內無壓力；上千條需虛擬滾動（README 已知限制）。
- 接口只允許迴環訪問、無鑑權；勿將 DSH 端口暴露到公網。
- 插件以當前 dsh 進程權限 運行；安裝前請自行查看源碼與 MIT 許可證，確認符合你的安全策略。
DSH 生態強調「一切皆插件」；SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-prompt-library 把提示詞庫嵌進 composer：分組 chips、分詞搜索、變量填值、替換或追加草稿，以及單文件本地存儲與 rev 樂觀鎖，適合把日常模板收攏在 DSH 裏一鍵取用。
- 目錄頁：https://www.skillhub.cn/plugins/JianhangLy/dsh-prompt-library
- GitHub：https://github.com/JianhangLy/dsh-prompt-library
