前言¶

DeepSeek Harness（DSH）通過插件擴展能力；技能（Skill）通常以 SKILL.md 等形式放在 $DSH_HOME/skills 下供 Agent 使用。若手工從 Skillhub 站點查找、下載 ZIP 再解壓到對應目錄，搜索、排序和重複安裝時的覆蓋確認都靠人工完成。下面介紹的 dsh-skillhub-market 在 DSH Web GUI 中對接 Skillhub 公開 API，完成市場列表、篩選、下載安裝，並掃描本地已裝技能、維護自定義顯示名與備註。

這是什麼¶

• 插件名稱：@local/dsh-skillhub-market（倉庫 MRevenger/dsh-skillhub-market）
• 維護者：MRevenger
• 分類：聯網工具（社區目錄 skillhub.cn/plugins/MRevenger/dsh-skillhub-market）
• 當前版本（資料來源 package.json）：1.1.0
• 許可：MIT
• 定位：Skillhub 技能市場的 DSH 插件——在線搜索、篩選和安裝 Skillhub 技能，並管理已下載技能的簡介、SKILL.md 正文、自定義顯示名和備註。

插件以 DSH host + Web 客戶端 bundle 形式接入；聯網請求指向 api.skillhub.cn，屬社區生態能力，並非 DeepSeek / 幻方官方應用商店。

核心功能¶

技能市場¶

• 列表：關鍵詞搜索（350 ms 防抖）、分頁，以及加載、空結果、錯誤與重試狀態。
• 排序：全部、近期飆升、下載量、最近上新（見下文 API 映射說明）。
• 篩選：來源、場景分類、是否需要 API Key；無時間範圍篩選。
• 技能卡片：名稱、簡介、來源/分類、下載量/Star、API Key 標記、更新時間；支持詳情、GitHub（不可用時回退 Skillhub 詳情頁）、下載。

下載與本地安裝¶

• 安全解壓到 $DSH_HOME/skills/<slug>/；目錄已存在時先詢問是否覆蓋。
• Host 端校驗 slug、ZIP 頭與解壓路徑，設有條目數與體積上限（資料：500 條目、單文件 16 MB、解壓總量 64 MB；下載 ZIP 120 s 超時、32 MB 上限）。

已下載技能管理¶

• 掃描 $DSH_HOME/skills 下技能目錄，解析 YAML frontmatter 與 Markdown 正文。
• 支持查看詳情、打開本地目錄、打開 GitHub（鏈接規則見「已知限制」）。

自定義元數據¶

• 顯示名與備註保存在 $DSH_HOME/skillhub-custom.json，不會寫回 SKILL.md 的 name。
• 重裝同一 slug 時保留 displayName、note 等字段。

列表主顯示名優先級：displayName > frontmatter name > 目錄名。

安裝與啓用¶

前置要求¶

• DeepSeek Harness >= 0.2.2-rc.1
• Node.js >= 22（推薦 24；本地構建/開發時）
• Git（部分安裝路徑需要）
• 一個 DSH profile（下文以 desktop 爲例，請替換爲你的 profile 名）

推薦：DSH CLI 從 GitHub 安裝¶

官方 README 給出的命令如下（版本標籤與資料一致）：

dsh plugin --profile desktop add github:MRevenger/dsh-skillhub-market#v1.1.0

該命令將 GitHub 倉庫作爲依賴安裝到 profile。若安裝後未自動加入 bundle 列表，在 profile 的 dsh.profile.bundles 中加入 @local/dsh-skillhub-market，或在插件管理器中啓用它。

其他方式¶

1. 插件管理器（本地 bundle）：構建或解壓得到插件根目錄後，在 DSH 插件管理界面選擇「安裝本地 bundle」，指向含 package.json、cordis.patch.yml、lib/ 的目錄；管理器會讀取 dsh.bundle.patch 與 dsh.client 並應用補丁。
2. Release 壓縮包：從 Releases 下載 dsh-skillhub-market-v1.1.0.zip，解壓後按方式 1 安裝，或執行：

dsh plugin --profile desktop add /absolute/path/to/dsh-skillhub-market

安裝後檢查¶

• 重啓 DSH，或刷新 Web GUI。
• 側邊欄應出現「Skillhub 技能市場」。
• 若未出現，在插件管理器中確認 @local/dsh-skillhub-market 已 enabled。

典型用法¶

在市場頁搜索並安裝¶

1. 打開側邊欄「Skillhub 技能市場」。
2. 輸入關鍵詞（觸發 350 ms 防抖後請求列表）、選擇排序與篩選（來源、場景分類、API Key）。
3. 在卡片上查看詳情或 GitHub/Skillhub 鏈接，點擊下載。
4. 若 $DSH_HOME/skills/<slug>/ 已存在，確認覆蓋後安裝；解壓成功後列表會記錄 downloadedAt 與 sourceHomepage。

管理已下載技能¶

1. 在插件「已下載」區域查看本地技能；可打開詳情、本地目錄或 GitHub。
2. 編輯顯示名或備註，失焦或點擊保存後寫入 skillhub-custom.json；重裝同一 slug 時這些字段會保留。

自定義元數據文件示例¶

$DSH_HOME 優先取插件配置 dshHome，否則取環境變量 DSH_HOME，最後回退 ~/.dsh：

{
  "pdf-skill": {
    "slug": "pdf-skill",
    "displayName": "我的 PDF 助手",
    "note": "每週報表處理專用",
    "downloadedAt": "2026-11-07T...",
    "sourceHomepage": "https://github.com/..."
  }
}

聯網 API 與排序說明¶

映射集中在倉庫 src/host/api-map.ts。常用端點：

列表參數包括：page、pageSize（≤100）、keyword、sortBy、order、category、source、labels。

UI「近期飆升」對應 sortBy=score&order=desc：Skillhub API 不支持 trending，否則會返回 400；插件與站點均回退到 score。

適用場景與注意¶

適合誰：需要在 DSH 內直接瀏覽 Skillhub、按分類/來源/API Key 篩選並安裝技能，同時在同一界面維護本地 skills 目錄與個性化備註的開發者。

權限與安全：

• 插件不會執行下載技能包中的任何代碼，僅讀取 SKILL.md 及文件內容供展示。
• 插件以當前 DSH 進程權限運行；安裝前應查看倉庫源碼與 MIT 許可證，並確認你信任其聯網與寫本地目錄的行爲。
• 「打開本地目錄」在 host 端通過 node:child_process 調用系統文件管理器（Windows explorer.exe、macOS open、Linux xdg-open），路徑限定在 $DSH_HOME/skills/<dir>；沙箱環境下可能失敗。靜態掃描可能將該能力標爲 MEDIUM。

已知限制（摘自 README）：

• source 爲列表流篩選，結果中仍可能混合其他來源；卡片按站點規則展示實際來源。
• 無 GitHub URL 時鏈接回退 https://skillhub.cn/skills/{slug}。
• 分類接口失敗時使用內置 13 個分類回退（資料註明爲 2026-11 時點值）。

結尾¶

dsh-skillhub-market 把 Skillhub 的搜索、篩選、下載與本地技能元數據管理收攏進 DSH 側邊欄，減少手工下 ZIP 與對齊目錄名的步驟。查閱插件說明與 Issue 請訪問 GitHub 倉庫；社區目錄頁：skillhub.cn/plugins/MRevenger/dsh-skillhub-market。