前言¶
在 DeepSeek Harness（DSH）裏反覆寫同類提示——代碼審查模板、需求拆解句式、帶佔位符的說明——通常會複製舊對話裏的片段，或依賴瀏覽器書籤與外部筆記。這些內容不進輸入框上下文，改一版也要多處同步。dsh-prompt-shelf 把常用提示詞收進輸入框底部工具行：列表裏搜索、在光標處插入或整框替換，支持 {{變量}} 與回收站，數據落在本機宿主目錄，不依賴按 origin 隔離的 localStorage。
這是什麼¶
dsh-prompt-shelf 是社區維護的 DSH 插件（維護者 taoziliyouchong，MIT 許可，當前包版本 0.1.4）。它在會話輸入框卡片底部、「完全權限」右側增加「常用提示詞」入口（帶條數）；新會話空白頁同樣有該入口。分類上屬於 DSH 社區目錄中的「記憶」類插件，解決的是：在本機會話裏快速存取、複用提示詞模板，並與 DSH 輸入框草稿 API 對接，而不改編輯器 DOM。
入口與界面¶
界面掛在 list 槽 conversation.input.left（session 範圍，渲染在 permission / plan 之後）。點開列表後是覆蓋層窗口（createPortal 到 document.body，避免輸入框容器裁剪）；可用右上角 ×、點窗口外暗區或 Esc 關閉（編輯中 Esc 先退出編輯）。
核心功能¶
存、寫、找、用、改、刪¶
- 存：「存入當前輸入」把輸入框現有內容存成一條；空框時按鈕不可用，與已有正文相同則不會重複存。
- 寫：「＋ 新建」在窗口內寫標題與正文，保存後排在卡片最前。
- 找：頂部搜索框按標題和正文過濾。
- 用：卡片頭右側「插入」在光標處追加內容；「替換」將整框換成該條正文。插入不關窗口，可連續選多條。
- 改：卡片內展開可編輯標題與正文；標題留空時自動取正文首行。
- 刪：條目進入回收站，默認保留 3 天；工具行右側「回收站」可查看剩餘天數並一鍵恢復。保留天數可在 1～365 之間修改，改完後按新規則清理過期項。
變量模板¶
正文中使用 {{名稱}} 或 {{名稱=默認值}}，使用卡片時該位置變爲輸入框：插入時用填寫值替換，未填則用默認值；同名變量共用一份值。變量框內輸入 @ 可引用工作區文件（見下文 @ 選用）。
編輯時看到的是帶 {{…}} 的原文。新建或編輯時，正文框下方有「＋ 變量」；光標放到目標位置後點擊，會在光標處插入 {{變量}} 並選中「變量」兩字以便改名。正文框內 Alt+V（或 Ctrl+Alt+V）等效，僅在該框生效。
@ 引用¶
- 任務輸入框內
@：先只出現「常用提示詞」；選中後展開條目列表，再選一條將正文落到光標處。展開後可按關鍵詞過濾；Esc 關閉後草稿可能殘留@常用提示詞，刪掉即可。 - 新建 / 編輯卡片的標題框、正文框內
@：候選分「常用提示詞 / 文件與文件夾 / 對話 / 插件」；標題框選常用提示詞插條目名，正文框插整段正文；選文件與文件夾插@路徑（目錄帶尾斜槓，路徑含空格時用@"路徑"）。 - 卡片上的變量框內
@：同樣分類；選常用提示詞填整段正文，選文件填@路徑；插入或替換進任務輸入框後，模型按 @ 引用讀取。
數據存儲¶
真源在宿主側 $DSH_HOME/data/dsh-prompt-shelf/state.json（寫入先落 .tmp 再改名，舊文件留 .bak），經插件本機路由讀寫；瀏覽器側另存 localStorage 緩存（鍵 dsh.prompt-shelf.v1）用於首屏。與插件包分開存放，重裝或升級插件不影響條目。插件不聯網、不上傳內容。
宿主註冊三條僅接受迴環地址的本機路由：GET/POST /dsh-prompt-shelf/api/state（讀寫條目）、GET /dsh-prompt-shelf/api/files（按查詢詞列工作區文件，遞歸 3 層、最多 400 條）、GET /dsh-prompt-shelf/api/plugins（插件加載器實時表中的第三方插件）。
安裝與啓用¶
要求 DSH >= 0.2.1-alpha.1；README 記載在 0.2.1-alpha.3、0.2.2-rc.1 上驗證通過，更高版本未驗證。適用桌面端或 dsh web。
桌面 profile 從 GitHub 安裝：
dsh plugin --profile desktop add github:taoziliyouchong/dsh-prompt-shelf
發佈到 npm 後也可：
dsh plugin --profile desktop add dsh-prompt-shelf
裝完後重啓 DSH。若使用其他 profile，將命令中的 desktop 換成你的 profile 名。
插件以當前 dsh 進程權限運行；安裝前建議在 GitHub 倉庫查看源碼與 MIT 許可證，並確認環境滿足 engines.dsh 與 Node 要求（package.json：node 爲 ^22.19.0 || >=24.0.0，dsh 爲 >=0.2.1-alpha.1）。
典型用法¶
- 在輸入框寫好一段常用提示，打開「常用提示詞」，點「存入當前輸入」歸檔。
- 需要時打開列表，搜索標題或正文，對目標卡片點「插入」拼進當前草稿，或點「替換」整框使用。
- 對要經常改動的片段，在卡片正文裏寫
{{項目名=默認名}}，使用時在變量框填值再插入。 - 變量或正文裏用
@選工作區文件路徑，讓模型按 DSH 的 @ 機制讀取文件內容。
適用場景與限制¶
適合需要在本機會話中高頻複用提示模板、又希望與輸入框草稿和 @ 引用打通的 DSH 用戶。
已知限制（來自 README）：
- 條目上限 5000 條、單次寫入上限 1MB，超出會被拒並提示。
- 僅在本機迴環地址下可用；遠程訪問 DSH 時相關路由返回 403。
- 「替換」會覆蓋輸入框全部現有內容；「插入」不會。
社區插件目錄站（如 skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，屬社區「一切皆插件」生態內的獨立收錄。
反饋與鏈接¶
問題可按 README 建議：先在 https://github.com/taoziliyouchong/dsh-prompt-shelf/issues 開 Issue；或 QQ 2171960697（請註明所裝插件）。反饋時建議附帶 DSH 版本、插件版本、報錯原文與截圖。
- 社區目錄頁：https://www.skillhub.cn/plugins/taoziliyouchong/dsh-prompt-shelf
- 源碼與文檔：https://github.com/taoziliyouchong/dsh-prompt-shelf
dsh-prompt-shelf 把提示詞收進輸入框工具行一側：本機持久化、搜索與變量模板、插入/替換與 @ 聯動，適合把重複勞動從剪貼板遷回 DSH 會話內完成。
