前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的擴展方式：社區裏大量帶 dsh-plugin 主題的 GitHub 倉庫構成插件市場，另有獨立維護的目錄站點彙總這些項目。若只在瀏覽器裏翻 GitHub 或零散收藏鏈接，很難按分類、星標或更新時間系統挑選插件。下面介紹的 Plugin Discovery（倉庫名 dsh-plugin-discovery）由 HiddenPuppy 維護，屬於聯網工具類插件：在 DSH 側邊欄 Automations 下方增加「插件發現」頁，把社區目錄全量接進客戶端，併爲每條目提供中文一句話簡介、篩選與排序，每次打開頁面還會嘗試同步最新目錄。

這是什麼¶

dsh-plugin-discovery 是 DSH 的第三方 bundle 插件。Host 端拉取並解析社區維護的 GitHub 目錄，瀏覽器端只負責渲染；不直接向 GitHub 發請求。安裝後側邊欄會出現 Plugin Discovery，用於瀏覽經 dsh-plugin 主題校驗的倉庫列表（README 寫明當前約 22,785 個），與上游 bruc3van/awesome-dsh-plugin 的分類體系一致。

核心功能¶

全量目錄與分類¶

插件同步社區目錄中每個帶 dsh-plugin 主題的倉庫，並按上游相同的 10 個分類分組展示。篩選條只露出 6 個主分類（head categories），其餘歸入 Other，避免長尾分類佔滿界面。

中文簡介¶

每個項目儘量顯示一句中文說明：優先使用倉庫自帶中文描述；其次使用本倉庫 bundled 的 AI 生成摘要（緩存在 zh-descriptions.json，可編輯後刷新頁面覆蓋）；新收錄且尚無中文時，會按分類與語言自動生成臨時一句，英文原描述仍顯示在下方。README 註明三類來源的大致數量（倉庫中文約 1.1 萬、AI 中文約 1.1 萬），摘要僅供參考，以各插件倉庫爲準。

排序、搜索與分頁¶

支持三種排序：目錄默認順序、星標最多、最近更新。另有關鍵詞搜索，以及每頁 50 / 100 / 200 條。

打開即刷新¶

每次進入頁面先用本地緩存即時渲染，再在後臺同步最新目錄，完成後替換數據。角落 Refresh 可強制同步。頁腳展示上游快照日期與上次同步時間。

生態概覽¶

頁面提供插件總數、分類、語言、近 30 天有更新的項目數、自動生成的中文概覽，以及分類分佈條。點擊行內條目或 Open project ↗ 可跳轉到對應 GitHub 倉庫。

數據獲取方式¶

目錄數據來自 awesome-dsh-plugin 的 13 個分卷 Markdown（catalog/*.md，合計約 6 MB），而非體積更大的 repositories.json，便於在 GitHub raw 較慢的網絡下使用。Host 優先請求 raw.githubusercontent.com，失敗或超時則按文件回退到 jsDelivr 鏡像。上游目錄約 每日 更新一次；本插件在每次打開頁面時嘗試同步。

Host 在 DSH 已認證 API 通道註冊：

• GET /api/plugin-discovery/feed — 規範化後的目錄；?refresh=1 觸發後臺刷新，?wait=1 等待進行中的刷新後再響應
• GET /api/plugin-discovery/meta — 同步狀態（上次同步時間、是否刷新中、錯誤信息）

安裝與啓用¶

需要 DSH V0.2.1-rc.5 或更新版本。

1. 打開 DSH 側邊欄 Plugins → Add plugin → Install a third-party plugin。
2. 粘貼本插件的 Git 倉庫地址：

https://github.com/HiddenPuppy/dsh-plugin-discovery

3. 安裝完成後，Plugin Discovery 出現在側邊欄 Automations 下方；若未立即顯示，刷新窗口即可。

也可通過 Agent 的 plugin_manager → install_bundle 傳入上述 Git URL 或本地絕對路徑安裝。許可證爲 MIT（見倉庫 LICENSE）。

典型用法¶

安裝並打開側邊欄 Plugin Discovery 後，可按主分類 chip 縮小範圍，用搜索框過濾關鍵詞，切換星標或更新時間排序，調整每頁條數瀏覽列表。需要最新目錄時點 Refresh，或依賴「每次打開頁面」的後臺同步。選定插件後通過 Open project ↗ 進入 GitHub 倉庫，再按該倉庫說明安裝目標插件。

維護者提供的本地驗證命令（需在克隆後的倉庫根目錄執行，僅作開發/運維參考）：

node tools/live-test.mjs                     # 一次真實上游同步並打印統計
node tools/route-test.mjs /path/to/catalog   # 使用本地分卷測試路由、緩存與失敗回退
node tools/warm-cache.mjs                    # 預熱當前 profile 的磁盤緩存

適用場景與注意¶

適合經常在 DSH 裏試裝社區插件、希望在一個界面裏按分類和星標對比項目的開發者。插件以當前 DSH 進程權限運行，會從網絡拉取社區目錄並寫入本地緩存；安裝前應閱讀 HiddenPuppy/dsh-plugin-discovery 源碼與 MIT 許可證，確認符合你的環境與安全策略。社區目錄與 DSH 插件市場站點爲社區維護，與 DeepSeek / 幻方無官方從屬關係，本文也不將其描述爲官方應用商店。

結尾¶

dsh-plugin-discovery 把 GitHub 上經 dsh-plugin 主題校驗的全量目錄搬進 DSH 側邊欄，配合中文簡介、主分類篩選、多種排序與打開即刷新，降低在海量插件裏找合適擴展的成本。

• 目錄頁：https://www.skillhub.cn/plugins/HiddenPuppy/dsh-plugin-discovery
• GitHub：https://github.com/HiddenPuppy/dsh-plugin-discovery