DeepSeek Harness 技能列表與翻譯插件

DeepSeek Harness（DSH）支持插件化擴展，開發者通常會在 ~/.agents/skills 目錄下存放自定義技能。當技能數量增多時，在聊天框手動輸入 /skillname 並查看長描述會降低效率。DSH 插件 weilantianhai/dsh-command-skill-list 解決了這個問題，它通過聊天指令列出所有可用技能，並將描述自動精簡翻譯爲系統語言。

這是一個 DSH 客戶端插件。它通過 / 或 /sk 前綴命令，掃描 ~/.agents/skills 目錄，將技能描述自動翻譯爲中文（≤24字）或英文（≤15詞），並支持自定義註釋。選中後直接調用技能。

核心功能¶

• 快捷觸發：輸入 / 顯示入口，輸入 /sk、/ski 等任意前綴直接彈出完整技能列表。
• 自動翻譯：描述自動精簡爲一句話摘要（中文 ≤ 24 字 / 英文 ≤ 15 詞），優先複用 DSH 內置模型（零配置），支持自定義 DeepSeek API Key 作爲備用。
• 自定義註釋：在設置頁爲技能添加註釋，菜單直接顯示註釋（跳過翻譯）。
• 性能優化：翻譯結果磁盤緩存，啓動時預熱，並行翻譯，失敗自動回退，不阻塞菜單。
• 即插即用：選中技能後自動插入 /skillname，由 DSH 內建機制加載。

安裝¶

使用官方插件安裝命令添加該插件：

dsh plugin --profile web add github:weilantianhai/dsh-command-skill-list

配置與使用¶

安裝完成後，在 DSH 的設置頁會出現「技能翻譯」欄目：

• 翻譯通道：默認使用 DSH 內置模型，無需配置。也可填入自定義 DeepSeek API Key 作爲備用。
• 技能自定義註釋：列出已安裝技能，每行一個輸入框。填寫註釋後菜單顯示註釋（灰字），留空則恢復自動翻譯。
• 清空緩存：換語言或需強制重翻時使用。

配置文件¶

所有配置存於 ~/.dsh/plugins/command-skill-list/config.json（也可通過設置頁修改）：

{
  "deepseekApiKey": "sk-xxx",
  "notes": {
    "tdd": "測試驅動開發：紅-綠-重構",
    "code-review": "按倉庫規範與需求規格雙維度審查代碼"
  }
}

• deepseekApiKey：備用翻譯通道，也可通過環境變量 DEEPSEEK_API_KEY 設置。
• notes：技能名對應自定義註釋，有註釋的技能不再翻譯。

環境依賴與注意事項¶

• 依賴項：依賴 DSH Web (dsh web) 和 Node.js 18+（Host 端使用 fetch）。
• 權限：插件以當前 DSH 進程權限運行，建議安裝前檢查源碼與許可證（MIT）。
• 適用場景：適合擁有大量技能配置、需要快速切換或跨語言閱讀技能描述的用戶。

該插件通過緩存和並行翻譯機制，解決了技能列表瀏覽與描述閱讀的痛點。如需查看更多插件或獲取源碼，請訪問 GitHub 或 社區目錄。