前言¶
在 DeepSeek Harness（DSH）裏用技能，常見做法是輸入 / 從菜單裏選，或直接敲 /技能英文名。技能一多，要記住幾十個英文標識並不輕鬆，也未必記得每個技能是幹什麼的。dsh-skill-quickpick 是社區維護的客戶端插件（作者 fxdfx），在輸入框旁增加「技能」入口：打開按來源分組的列表，顯示中文名與說明，點一項把 /技能名 插進當前草稿，不自動發送，也不覆蓋你已寫的內容。下面按安裝、日常用法、能力與開關說明如何落地。
這是什麼¶
- 名稱：
dsh-skill-quickpick（npm 包名與插件市場檢索名一致） - 維護者：fxdfx
- 分類：客戶端（
platform: web，向 DSH 桌面/Web 客戶端注入 UI） - 許可證：MIT（見 GitHub 倉庫）
- 當前包版本：
0.1.0（package.json）；README 標註狀態爲 pre-release，適配 DSH 0.2.x - 倉庫與目錄： GitHub · SkillHub 目錄頁
一句話：用宿主已有的 skills.list（與輸入框 / 菜單同源）做可視化快選，並把插入行爲限定爲草稿編輯，不調用 submit()。
核心能力¶
列出、分組與搜索¶
| 能力 | 說明 | 默認 |
|---|---|---|
| 列出技能 | 來自宿主 skills.list |
開 |
| 按來源分組 | 我的技能 / 項目技能 / 內置 / 其他 | 開 |
| 中英搜索 | 匹配中文名、中文說明、英文名、英文原文 | 開 |
| 防重複 | 草稿裏已有 /技能名 的條目會置灰 |
開 |
組內支持拖拽調整顯示順序（寫入 dsh-home 下 skill-quickpick-order.json，不改技能源文件）；排序可在「自定義 / 按使用頻率 / 按名稱」之間三態循環。
中文名與說明¶
顯示優先級（高到低）：
- 你在面板裏編輯並保存的內容
- 插件內置中文對照表
- 自動機翻緩存
- 英文原文
用戶編輯寫在 dsh-home/skill-quickpick-user.json；機翻緩存寫在 skill-quickpick-zh.json。三層互不累加覆蓋，刪掉任一文件不會破壞其它層。
默認不開啓自動翻譯；開啓後，宿主側 POST /skill-quickpick/translate 只把技能名和描述發給模型翻譯（不發正文），每個技能只翻一次並寫緩存。
一鍵插入草稿¶
點選一項後調用 insertText 在光標處插入 /技能名；失敗時回退爲 setDraft 追加。插入後焦點回到輸入框，可繼續編輯並用回車發送。插件不會替你按發送鍵，也不鎖定模型只能使用該技能。
默認關閉的「高風險」能力¶
面板頂部齒輪可逐項打開以下能力（默認全部關閉）：
| 開關 | 默認 | 開啓後的主要行爲 |
|---|---|---|
| 禁用 / 啓用技能 | 關 | 改寫本地 SKILL.md frontmatter 的 disable-model-invocation |
| 卸載 / 回收站 | 關 | 將技能目錄移入 dsh-home/skill-quickpick-trash/，到期自動清理 |
| 自動翻譯技能說明 | 關 | 按上述接口批量補中文緩存 |
| 使用統計 | 關 | 讀本會話日誌壓縮包，統計模型加載與手動 /技能名 次數 |
關閉開關時，宿主會對寫操作返回 403，不僅是在 UI 上隱藏按鈕。禁用技能的「重新啓用」與「全部恢復（↺ N）」在開關關閉時仍可用，避免鎖死後無法解鎖。
安裝與啓用¶
從插件市場（推薦）¶
DSH 桌面版打開 Settings → Plugins，搜索 dsh-skill-quickpick，安裝。
命令行（普通 dsh web）¶
在 profile 中加入包後重啓：
dsh plugin --profile <你的 profile 名> add dsh-skill-quickpick
裝完後需完全退出客戶端再打開：host 半邊改動只有重啓才生效。
SkillHub 與 DeepSeek / 幻方無官方從屬關係；安裝前請自行查看源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，開啓禁用、卸載、統計等開關會讀寫 dsh-home 與會話日誌，請只在理解風險後打開。
典型用法¶
- 重啓客戶端，確認插件已加載。
- 在會話輸入框旁找到「技能」按鈕，打開面板。
- 用搜索框按中文或英文名篩選；在分組內點選目標技能。
- 確認草稿中出現
/技能名（末尾帶空格），補全參數後自行發送。
若你曾開啓「禁用技能」：停用或卸載本插件前，先在面板搜索框右側點 ↺ N（全部恢復），否則插件停止後無人再替你去掉 disable-model-invocation 標記。
需要調整中文展示時，在列表行上使用編輯入口，修改會進入 skill-quickpick-user.json，優先級最高。
適用場景與注意¶
適合誰：日常在 DSH 裏頻繁手動 /技能名、技能數量較多、希望用中文瀏覽和搜索的開發者。
不適合當作什麼：不是技能市場，不能替代 DSH 自帶的 / 補全；也不負責自動挑選或發送消息。
項目技能與禁用/卸載：服務端從會話日誌 header 裏的 cwd 推斷項目根，只有 DSH 會話裏出現過的項目，其 .dsh/skills、.agents/skills 纔會進入可信根。內置技能（無本地可寫 path）不能禁用或卸載。
卸載本插件（非卸載某個 skill）：若使用過禁用功能，先「全部恢復」；再用 DSH 插件管理卸載，或按 README 中的 dsh plugin 子命令移除（截斷資料未給出完整一行，以倉庫 README「卸載」小節爲準）。
結尾¶
dsh-skill-quickpick 把同源技能列表做成中文快選面板，默認只做分組、搜索與草稿插入；需要治理技能庫時再按需打開統計、機翻、禁用與回收站。查閱說明與提 issue 請到 GitHub 倉庫，在生態裏檢索可到 SkillHub 目錄頁。
