前言¶
在 DeepSeek Harness（DSH）裏做智能體時，SKILL.md 往往不只在 ~/.dsh/skills 裏：WorkBuddy、Claude Code、Codex、豆包工作版各自有一套目錄，GitHub 上還有大量倉庫只放一個技能文件。要回答「我手裏到底有哪些技能」「這份 SKILL.md 寫了什麼」「怎麼裝一份新的」，過去多半隻能開文件管理器逐個翻。
維護者 fenshal 的客戶端插件 dsh-skillbox（包名 @local/dsh-skillbox，當前版本 0.2.0，MIT）把彙總、預覽、導入與 GitHub 發現做成左側欄裏的整頁三欄界面。下面按安裝順序說明它做什麼、怎麼用，以及配置與邊界。
這是什麼¶
DSH Skill Library 是 DSH 的 bundle 插件：依賴客戶端提供 @deepseek-ai/dsh-client-ui-layout 與 @deepseek-ai/dsh-client-ui-sidebar（README 寫明 DSH 0.1.x 起自帶）。入口在左側欄「插件 / 自動化任務」同一組，點「技能庫」圖標進入整頁佈局——左分類、中卡片網格、右詳情。
插件在主機側掃描多個來源目錄（只讀），在 Web 側渲染 UI，並支持會話裏按輪次選擇「專家」人設。導入技能時是複製到 ~/.dsh/skills，不改動原始目錄。
核心功能¶
資料中的能力可以概括爲下表；每一項都對應 README 裏寫明的行爲。
| 能力 | 說明 |
|---|---|
| 彙總 | 掃描 DSH、WorkBuddy、Claude Code、Codex、豆包等技能目錄，合併爲可搜索的卡片列表 |
| 預覽 | 右側展示文件樹、SKILL.md 摘要，支持「查看全文」彈層 |
| 導入 / 移除 | 一鍵複製爲 DSH 常駐技能；移除只刪除本插件導入的那份 |
| 專家 | 讀取 WorkBuddy 專家包、豆包「工作夥伴」導出包，可導入爲帶人設的技能 |
| 發現 | 在 GitHub 上按 SKILL.md 搜索，預覽後安裝到 ~/.dsh/skills |
| 會話專家膠囊 | 輸入框下方選專家，按輪次生效；助手回覆上方顯示頭像與名字 |
技能頁籤：左側按來源分組（全部、已安裝、各平臺），頂部搜索實時過濾；卡片含標題、平臺徽章、簡介、路徑，星標表示已安裝。可切換排序（默認 / 名稱 / 大小 / 最近使用）與中文/原文顯示。
專家頁籤：不導入也可在輸入框下方膠囊裏選用，人設注入當前會話；導入則複製到 ~/.dsh/skills/expert-<名字>。選擇按輪次記錄（例如第 3 輪選中，第 4 輪起才顯示頭像）。
發現頁籤：分類含 Claude / Codex / DSH / 通用 Agent；支持「技能」模式（GitHub 代碼搜索 filename:SKILL.md）與「倉庫」模式。確認預覽後可「安裝到技能庫」。
安裝與啓用¶
插件以本地 bundle 方式安裝，README 未提供 dsh plugin add github:... 一類命令。任選其一：
方式一：本地目錄（README 標註爲推薦，適合開發或自用）
克隆倉庫後，在 DSH 內把該目錄裝成 bundle（路徑換成你的實際位置）：
git clone https://github.com/fenshal/dsh-skillbox.git
plugin_manager install_bundle <克隆目錄的絕對路徑>
方式二：壓縮包
從 Releases 下載 dsh-skillbox-0.2.0.zip，解壓後同樣執行：
plugin_manager install_bundle <解壓目錄的絕對路徑>
裝完後在左側欄點「技能庫」即可。若你自行修改了 client.js 等客戶端代碼，README 要求改完後重掛 bundle（先 enabled:false 再 enabled:true），否則頁面仍是舊代碼。
典型用法¶
- 打開技能頁籤，用來源分組或搜索框定位一份本地
SKILL.md，在右側看摘要或全文，再執行導入。 - 在專家頁籤瀏覽 WorkBuddy / 豆包導出裏的專家；需要長期常駐時再導入，臨時對話可直接用輸入框下方膠囊。
- 在發現頁籤選分類與「技能 / 倉庫」模式，預覽 GitHub 上的
SKILL.md，確認後安裝到~/.dsh/skills。
無 GitHub Token 時發現頁仍可用，但受匿名 API 限流（代碼搜索 10 次/分、倉庫搜索 30 次/分），且拿不到 star / fork 統計；頁面會提示配置 Token。
配置要點¶
| 配置項 | 位置 | 說明 |
|---|---|---|
| GitHub Token | 發現頁提示條，或 ~/.dsh/skillbox-github.json 的 {"token":"..."} |
可選；優先級高於 GH_TOKEN / GITHUB_TOKEN |
| 導出包目錄 | DSH_SKILLBOX_IMPORTS（; 分隔）、~/.dsh/skillbox-imports.json 的 {"dirs":[...]}、或默認 ~/.dsh/imports |
合併去重，用於掃描豆包「工作夥伴」導出包 |
| 數據與日誌 | ~/.dsh/skillbox-*.json、~/.dsh/skillbox-inject.log |
專家選擇、翻譯緩存、Token、注入排查等 |
Token 還可從已登錄的 gh CLI（gh auth token）回落；最終可匿名。簡介翻譯走 MyMemory 公共接口，僅發送簡介文本。發現頁只調用 GitHub 官方 API；Token 明文存本機，不上傳第三方。
適用場景與注意¶
適合誰：經常在多平臺之間搬運 SKILL.md、需要從 GitHub 試裝社區技能、或希望在一個界面裏預覽再導入 DSH 的開發者。
權限與信任：插件隨當前 DSH 進程權限讀取本機目錄與調用 GitHub API；安裝前應瀏覽 源碼倉庫 與 MIT 許可證，確認 Token 與導出目錄配置符合你的環境策略。
已知限制（README 原文）：專家導入只搬運人設與技能文本，不帶工具集和連接器；依賴豆包/美圖雲服務的專家導入後雲端調用無法復現。豆包工作版專家頭像/介紹本地不可用。機翻對產品名不友好，標題保留原名。GitHub 無下載量，發現頁只能用 star / fork 近似熱度。
掃描來源時只讀不寫；僅解析明文 SKILL.md / plugin.json / manifest.json，加密或二進制存儲會跳過。
鏈接¶
- 社區目錄頁：https://www.skillhub.cn/plugins/fenshal/dsh-skillbox
- 源碼與說明：https://github.com/fenshal/dsh-skillbox
在「技能分散、安裝靠手工翻目錄」的場景裏，dsh-skillbox 把瀏覽、預覽、導入和 GitHub 發現收到同一面板；按 README 用 plugin_manager install_bundle 掛上 bundle 後即可從側欄進入使用。
