前言¶
DSH 採用「一切皆插件」的架構，社區插件數量在 dsh-plugin 話題下持續增長。開發者找插件時，常見做法是翻 GitHub 搜索結果、掃 awesome 列表或憑 README 裏的 star 數判斷——這些方式要麼覆蓋面不全，要麼缺少統一維度，也難以在 DSH 裏直接查詢或安裝。
下面介紹維護者 zp-home 的聯網工具插件 dsh-recommend。它每 5 小時自動抓取全 GitHub 的 dsh-plugin 話題倉庫，按公開評分模型排序，並把同一份數據供給靜態排行站、DSH 模型工具與設置頁。SkillHub 目錄頁將其歸類爲「聯網工具」，當前版本 v0.3.0。
這是什麼¶
dsh-recommend 是 DSH 插件生態的透明排行與推薦服務，倉庫地址爲 github.com/zp-home/dsh-recommend。維護者 zp-home 將評分公式、權重與原始數據全部公開在倉庫中；任何人 clone 後執行 node scripts/sync.mjs 即可復算榜單。
數據以 data/registry.json 爲唯一事實源。GitHub Actions 每 5 小時全量重算並提交 data/ 目錄，包括排行、歷史快照、徽章與發展榜派生數據。當前管道覆蓋 2200+ 個 dsh-plugin 話題倉庫，排除佔位、空倉庫、官方本體及深掃未檢出插件特徵的條目後，約 1900+ 個上榜。
核心功能¶
公開評分與過濾¶
綜合分公式爲：0.35×維護性 + 0.30×熱度 + 0.20×質量 + 0.15×生態，細節見倉庫 docs/scoring.md。排除條目仍保留在 data/registry.json 並附原因（fork、已歸檔、空倉庫、無描述、佔位特徵、官方本體、深掃未檢出插件特徵等）。
榜單前 200 名會經 scripts/scan.mjs 深掃，檢測 dsh 聲明、@deepseek-ai/* 依賴、cordis 配置與 skills 特徵；未檢出特徵的倉庫排除出榜並透明標註。官方本體與非插件 denylist 位於 scripts/exclude-list.json。
靜態排行站（無需安裝）¶
不安裝插件也可瀏覽排行。打開綜合榜首頁：
https://zp-home.github.io/dsh-recommend/site/
頁面支持搜索、分類篩選、四種排序（綜合分 / 熱度 / 最近更新 / 最新發布）、分頁、詳情展開與近 N 天綜合分走勢圖，並可一鍵複製安裝命令。
發展排行榜爲獨立頁面，覆蓋 star 增長（7/30/90 天）、排名上升、npm 下載量、本週新上榜與精選認證：
https://zp-home.github.io/dsh-recommend/site/rankings.html
原始 JSON 數據同樣公開：data/rankings.json（每 5 小時更新）、data/history.json（每日趨勢）、data/trends.json（發展榜派生）。
DSH 內的模型工具與設置頁¶
安裝後在 DSH 中獲得五類模型工具：
| 工具 | 用途 |
|---|---|
rank_plugins |
榜單查詢，可按分類與維度過濾 |
search_plugins |
插件檢索 |
recommend_plugins |
按目標推薦，支持中英同義詞與 keywords 參數 |
trend_plugins |
發展榜（star 增長、排名上升、下載量、新上榜、精選） |
sync_registry |
刷新本地數據，報告 hub 與深掃健康度 |
設置頁路徑爲「設置 → 插件 → 插件排行」，提供緊湊排行榜、一鍵刷新、一鍵安裝、安裝命令複製、詳情展開、認證徽章與趨勢圖，支持 zh/en 雙語並隨 DSH 亮/暗主題適配。
插件還會檢查當前 profile 的 Git/NPM 直接依賴版本，默認僅提醒更新；點擊「更新」後執行官方 dsh plugin update，完成後需手動重啓 DSH。
插件作者相關能力¶
上榜項目每 5 小時自動生成 shields 徽章（data/badges/<owner>__<name>.json），可在 README 中引用。精選認證通過提交 收錄/認證 Issue 申請，審覈通過後顯示 🏅 標識；認證是展示層激勵，不改變評分。
安裝與啓用¶
DSH 插件以當前 dsh 進程權限運行。安裝前應閱讀倉庫源碼與 MIT 許可證，自行判斷是否適合你的環境。
方式 A：npm 安裝（國內用戶可優先嚐試）¶
dsh plugin --profile web add dsh-recommend
安裝完成後重啓 dsh web 生效。
方式 B：GitHub 直裝¶
dsh plugin --profile web add github:zp-home/dsh-recommend
dsh --profile web --dump-config
dump-config 輸出中應出現 # == dsh-recommend 配置層。同樣需重啓 dsh web。
方式 C：本地目錄安裝¶
dsh plugin --profile web add /你的路徑/dsh-recommend
適用於離線拷貝插件目錄的場景。
國內網絡提示¶
插件榜單數據默認從 raw.githubusercontent.com 拉取（sync_registry 工具）。若該域名不可達，可編輯已安裝包中的 cordis.patch.yml（路徑如 node_modules/dsh-recommend/cordis.patch.yml），將 dataUrl 改爲 jsDelivr CDN：
https://cdn.jsdelivr.net/gh/zp-home/dsh-recommend@main/data/registry.json
改後重啓 DSH。CDN 數據可能有數小時緩存延遲。
典型用法¶
在瀏覽器裏查榜並複製安裝命令¶
1、打開 https://zp-home.github.io/dsh-recommend/site/。
2、用搜索或分類篩選定位目標插件。
3、展開詳情，複製頁面提供的一鍵安裝命令，在終端執行後重啓 dsh web。
在對話中讓模型查榜或推薦¶
安裝並重啓後，可在 DSH 對話中直接調用工具，例如查詢綜合榜、按關鍵詞檢索、按場景推薦插件，或查看 star 增長等發展指標。需要刷新本地緩存時，調用 sync_registry。
自行復算數據管道¶
若需審計或本地調試排行邏輯，在 Node 18+ 環境下執行：
node scripts/sync.mjs
node scripts/validate.mjs
node scripts/smoke.mjs
深掃步驟需要 GITHUB_TOKEN；未設置時使用 GitHub API 未認證限額，夠跑一輪但會自動跳過深掃。CI 中會自動注入 token。
適用場景與注意¶
適合誰
- 想在 DSH 內快速查榜、檢索、按目標推薦插件的開發者。
- 需要對比插件維護性、熱度、質量與生態信號，而非只看 star 數的用戶。
- 插件作者希望展示透明評分徽章或申請精選認證。
需要注意
- 本插件及 SkillHub 目錄均爲社區生態，與 DeepSeek / 幻方無官方從屬關係，不是官方應用商店。
- 倉庫 README 提到靜態安全掃描（見 docs/security-scanning.md），未命中規則不等於安全；提示僅供參考，不影響評分或安裝資格。
- 插件只讀
registry.json並展示，不執行被收錄插件的代碼；但你安裝的dsh-recommend本身仍以 dsh 進程權限運行，安裝前請審查源碼。 - 設置頁排行標籤、數據路由與一鍵安裝等功能面向
--profile web；host 側模型工具可在其他 profile 使用，具體以倉庫cordis.patch.yml爲準。
結尾¶
dsh-recommend 把 DSH 插件生態的採集、評分、過濾與展示做成一條可審計的自動化管道，並用同一份 registry.json 服務靜態站、模型工具與設置頁。若你正在擴展 DSH 插件棧，可以先打開排行站瀏覽，再按需安裝到 web profile 使用。
- SkillHub 目錄頁：skillhub.cn/plugins/zp-home/dsh-recommend
- GitHub 倉庫：github.com/zp-home/dsh-recommend
