用 dsh-recommend 給 DeepSeek Harness 裝上透明插件排行

DeepSeek Harness 插件 DeepSeek DSH dsh-recommend 插件排行 工具與能力 2026-08-17 93 閱讀

前言

DeepSeek Harness（dsh）的核心理念是「一切皆插件」：模型、工具、會話、沙箱、界面都可以換成插件包。GitHub 上打了 dsh-plugin 話題的倉庫已經漲到幾千個，選插件時常見的麻煩不是「沒有」，而是不知道哪份還在維護、哪份只是佔位，以及榜單分數到底怎麼算出來的。

dsh-recommend 做的是另一件事：按公開公式給生態打分，把原始數據和排行一起放進倉庫。你可以在瀏覽器裏看靜態榜，也可以裝進 dsh，讓模型和設置頁讀同一份 JSON。本文按社區目錄頁、倉庫 README、docs/scoring.md、data/meta.json 和 host 源碼覈對後整理。

需要先分清兩件事。DeepSeek Harness 本體在 deepseek-ai/deepseek-harness。下面用到的插件目錄 deepseek-harness-plugin.com 是社區站點，和 DeepSeek / 幻方沒有官方從屬關係，不是官方應用商店。

這是什麼

dsh-recommend 是一款 DeepSeek Harness 的「工具與能力」插件，由 zp-home 維護，GitHub 倉庫爲 zp-home/dsh-recommend，許可證 MIT，package.json 中的版本爲 0.3.0。2026-08-17 從 GitHub API 讀取的 star 數爲 18（目錄頁當時顯示 11，以倉庫頁面爲準）。

它解決的問題可以壓成一句：把 dsh-plugin 話題裏的公開倉庫抓下來，按可復算的評分模型排序，再把同一份數據交給靜態站和 dsh 插件使用。設計文檔寫明瞭它明確不做的事：不負責安裝或更新插件，不做兼容性實測，也不執行任何被收錄倉庫的代碼。

數據管道由 GitHub Actions 驅動，README 與工具描述均爲每 2 小時全量重算並提交 data/。目錄頁短簡介寫成「每日抓取」，更接近歷史快照的粒度；以倉庫當前說明爲準時，抓取週期是 2 小時。

核心功能

一份數據，多個消費端

倉庫把 data/registry.json 當作唯一事實源。靜態排行站、dsh 裏的模型工具、設置頁「插件排行」標籤都讀這份數據，另外還有 data/rankings.json（降序榜）、data/history.json（每日趨勢）、data/trends.json（發展榜）。

2026-08-17 當天 data/meta.json 的快照是：話題倉庫 4534 個，排除 601 個，上榜 3933 個；hub 目錄鏡像 271 條、9 個分類；榜單前 200 名深掃完成 200 個，其中 145 個檢出插件特徵、55 個未檢出。README 裏仍寫着「2200+ / 1900+」，和當日 JSON 不一致，數量以 data/meta.json 爲準。該文件還記錄了 GitHub Search 翻頁溢出（fetchOverflow），快照會隨接口限額波動。

公開的四維評分

評分模型當前版本爲 2，公式寫在 docs/scoring.md，並同步進 scripts/score.mjs 與生成後的 meta.json。總分：

score = 0.35×維護性 + 0.30×熱度 + 0.20×質量 + 0.15×生態

四個維度都落在 [0, 1]：

  • 維護性（0.35）：exp(-距最近 push 天數 / 180)，半衰期 180 天。文檔把插件漂移當作生態裏最要緊的信號。
  • 熱度（0.30）：min(1, log10(stars + 1) / 3)，對數壓縮，大約 1000 star 封頂。文檔也寫了侷限：star 可刷，不等於使用量。
  • 質量（0.20）：有許可證、描述不少於 40 字符、倉庫體積大於 0，三項加權。
  • 生態（0.15）：被 hub 目錄或任一 awesome 列表提及則爲 1.0，否則 0.2。未收錄不會被清零。

進 registry.json 但不進榜的條目會帶排除原因，例如 fork、已歸檔、空倉庫、無描述、佔位/WIP、官方本體 denylist，以及深掃未檢出插件特徵。深掃檢查 dsh 聲明、@deepseek-ai/* 依賴、cordis 配置、skills 等；被 hub 或 awesome 人工收錄的倉庫不因缺文件特徵被踢出。並列時按 star 降序破平。公式改動要走版本號和評審，不在流水線裏悄悄調參。

裝進 dsh 之後能用什麼

README 把插件能力分成兩面，host 源碼實際註冊了 5 個模型工具：

面 內容
模型工具 rank_plugins 查榜；search_plugins 按名稱/描述/分類檢索；recommend_plugins 按目標推薦（中英同義詞擴展，可傳 keywords）；trend_plugins 看 star 增長、排名上升、下載量、新上榜、精選；sync_registry 刷新本地緩存並報告 hub / 深掃健康度
設置頁 設置 → 插件 →「插件排行」：搜索、分類、排序、分頁、一鍵刷新、一鍵安裝、複製安裝命令、詳情展開、認證徽章、趨勢圖；跟隨 dsh 亮/暗主題，中英雙語

倉庫根目錄就是插件包，同時聲明 dsh.bundle 和 dsh.client，構建產物 lib/ 隨庫提交，從 git 安裝不必再本地構建。插件只讀 JSON，不執行被收錄插件的代碼。

不裝 dsh 也可以用網頁版：

  • 綜合榜：https://zp-home.github.io/dsh-recommend/site/
  • 發展榜：https://zp-home.github.io/dsh-recommend/site/rankings.html

靜態站支持搜索、分類、按綜合分 / 熱度 / 最近更新 / 最新發布排序，以及複製安裝命令。發展榜看 7/30/90 天 star 增長、排名上升、npm 下載、本週新上榜和精選認證。

安裝與啓用

社區目錄頁給出的安裝命令是：

dsh plugin add github:zp-home/dsh-recommend

要用 Web UI 裏的設置頁標籤，倉庫 README 建議裝進 web profile（README 標註已真機驗證）：

dsh plugin --profile web add github:zp-home/dsh-recommend
dsh --profile web --dump-config   # 應出現 "# == dsh-recommend" 層

國內網絡也可以走 npm 包名（README 寫明會走 npmmirror）：

dsh plugin --profile web add dsh-recommend

需要可復現安裝時，按目錄頁說明固定 commit：

dsh plugin add github:zp-home/dsh-recommend#<commit哈希>

改完後重啓 dsh web 纔會生效。本地離線安裝可以把倉庫目錄拷過去，再 dsh plugin --profile web add <本地路徑>。

插件默認從 raw.githubusercontent.com 拉 registry.json。訪問不了該域名時，README 的做法是改已安裝包裏的 cordis.patch.yml（node_modules/dsh-recommend/cordis.patch.yml），把 dataUrl 換成：

https://cdn.jsdelivr.net/gh/zp-home/dsh-recommend@main/data/registry.json

jsDelivr 可能有數小時緩存延遲，改完同樣要重啓 dsh。

目錄頁和官方安裝指南都提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。裝之前應檢查源碼倉庫和許可證。

典型用法

1. 只看榜，不裝插件

打開靜態站即可。當日 data/rankings.json 前幾名包括 anywhere-labs/deepseek-harness-desktop、zhu1090093659/dsh-web-ui、ccch1mneyyy/dsh-TUI 等，分數會隨 2 小時管道重算變化，不要把某一刻的名次當成長期結論。原始 JSON 也可以直接讀：

  • https://github.com/zp-home/dsh-recommend/blob/main/data/rankings.json
  • https://github.com/zp-home/dsh-recommend/blob/main/data/meta.json

2. 在設置頁瀏覽和安裝

重啓 Web UI 後進入 設置 → 插件 →「插件排行」。這裏可以按分類篩選、換排序、展開詳情，也可以一鍵安裝或複製 dsh plugin 命令。界面上的 🏅 是展示層「精選認證」，README 寫明它不改變評分。

3. 讓模型代查

本地緩存沒有數據時，要先讓模型調用 sync_registry。之後可以按工具參數提問，例如：

  • 查綜合榜前 10：調用 rank_plugins（limit 默認 10、最大 50；category 可按 hub 分類過濾；sortBy 爲 score / stars / updated）
  • 搜關鍵字：search_plugins，必填 query
  • 按目標推薦：recommend_plugins，必填 goal。源碼註釋裏的例子是「給 Web 界面加側邊欄」；可選 keywords 數組。相關度公式爲 0.6×匹配度 + 0.4×綜合分，匹配度再對直接命中和同義擴展各一半
  • 看趨勢：trend_plugins，必填 board，可選值爲 starsGain7d / starsGain30d / starsGain90d / rankGain30d / downloads30d / newlyListed / certified

這些是模型工具，不是你在終端裏手敲的 CLI 子命令。對話裏直接說目標即可，例如「按綜合分列出 UI 相關插件前 10 個，並給出安裝命令」。

4. 自己復算（可選）

信任排行的方式是把公式跑一遍。需要 Node 18+：

node scripts/sync.mjs            # fetch → score → 深掃 → history → trends → badge → validate
node scripts/validate.mjs        # 只校驗
node scripts/smoke.mjs           # 管道純函數冒煙測試

未設置 GITHUB_TOKEN 時走未認證限額，並自動跳過深掃；CI 裏會注入 token。

插件作者若已進入榜單前 200，可用倉庫生成的 shields 徽章。申請 🏅 精選認證走 Issue 表單。只打 dsh-plugin 話題也會被管道收錄，不必先填表。

適用場景與注意事項

比較適合這幾類人：已經在用 dsh、面對大量第三方插件需要一個可覈對來源的目錄；插件作者想看自己掉沒掉出維護窗口；不想裝插件、只想在瀏覽器裏掃一眼生態。

使用時有幾條邊界，倉庫 SECURITY.md 和目錄頁寫得很明確：

  1. 收錄、上榜、高分都不是安全審計。 分數來自維護性、star、文檔完整度和精選信號，不包含代碼審計或運行時行爲評估。裝任何第三方插件前，仍要自己看源碼、依賴、許可證，以及它要的權限是否超出功能所需。
  2. 本插件以當前 dsh 進程權限運行。 git 源安裝可能執行構建 / prepare 腳本。目錄頁建議先讀倉庫再裝；需要可復現時固定 commit。
  3. 它只讀元數據。 不會 clone、安裝或運行被收錄倉庫。深掃目前覆蓋榜單前 200 名，未掃到的倉庫按文檔採取保守策略：不因「還沒掃」而排除。
  4. 推薦仍是規則式匹配。 路線圖把「推薦邏輯升級 + 人工精選層」標爲進行中；同義詞擴展已經落地，但不是模型語義檢索。npm 下載量信號在評分文檔裏仍寫「規劃中 / 發展榜使用」，不要把它理解成已經進入綜合分權重。
  5. 社區目錄 ≠ 官方商店。 安裝命令以目錄頁原文爲準，插件來源仍是 GitHub 上的社區倉庫。

小結

dsh-recommend 把 DSH 插件生態的抓取、過濾、打分和展示拆開：公式和原始數據公開，靜態站和 dsh 插件讀同一份 JSON。它幫你縮小候選範圍，並不代替你審查將要安裝的那一個插件。

  • 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-recommend/
  • GitHub：https://github.com/zp-home/dsh-recommend
  • 靜態榜：https://zp-home.github.io/dsh-recommend/site/
  • 評分模型：https://github.com/zp-home/dsh-recommend/blob/main/docs/scoring.md

相關文章

快速從零部署一個DeepSeek-R1服務 2025-04-05 使用 dsh-anchored-standard 爲 DeepSeek Harness 配置兩階段 Agent 預設 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 網頁界面補成工作臺 2026-08-17 用 modlens 給 DeepSeek Harness 的純文本模型補上視覺 2026-08-17 用 dsh-TUI 給 DeepSeek Harness 補上全屏終端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜