前言¶
DeepSeek Harness 的生態理念是「一切皆插件」。隨着插件數量增加，開發者需要在官方目錄與本地環境之間頻繁切換，管理效率受到影響。dsh-top-leaderboard 旨在解決這一問題，它將插件發現與管理流程集成到 Web GUI 的側欄中，提供瀏覽、搜索、權限檢測與一鍵安裝的一站式能力。
是什麼¶
dsh-top-leaderboard 是一個客戶端插件，由開發者 l541402398 維護，基於 MIT 許可證開源。
它爲 DeepSeek Harness 的 Web 界面側欄底部增加了一個「🏆 榜單」入口。點擊後彈出的窗口允許用戶查看和搜索插件，區分插件類型，檢測訪問權限，並直接完成安裝。插件內置了實時安裝日誌功能，能夠顯示倉庫大小預估和下載進度。
核心功能¶
側欄入口與彈窗交互
在 Web GUI 側欄底部增加「🏆 榜單」按鈕，點擊喚起彈窗。彈窗內支持搜索與排行展示，支持查看插件詳情。
雙源榜單數據
彈窗包含兩個 Tab：
* 熱度榜：展示 dsh-external 生態榜單，數據基於本地快照 data/leaderboard.json。
* 官方 dsh-plugin：實時拉取 GitHub 上帶有 dsh-plugin topic 的公開插件，按 Star 數排序。
信息展示與預警
每個條目展示插件類型徽章（技能 / Bundle / Cordis / Marisa）以及倉庫大小。
* 當倉庫大小 ≥ 100MB 時，顯示橙色警示。
* 熱度榜的大小數據會漸進式補全並緩存。
一鍵安裝流程
* 優先策略：HTTPS 淺克隆優先，強制使用 HTTP/1.1 以規避 HTTP/2 斷流問題。若失敗，自動重試 3 次並退回 SSH 方式。
* 路徑映射：技能類插件安裝至 ~/.dsh/skills/；Bundle 和 Cordis 類插件安裝至 web profile。
* 下載前日誌：安裝前先報告倉庫大小，大倉庫會預估下載時間，避免用戶在不知情的情況下等待過大文件。
* 信任配置：安裝接口會自動信任 loopback 與部署聲明的 trusted-host，通過域名訪問不會出現 403 錯誤。
權限檢測與持久化
* 私有倉庫條目前顯示 🔒，點擊可檢測訪問權限。檢測通過後顯示綠色 🔓，結果在跨刷新後保持持久化。
實時反饋
安裝過程中顯示實時日誌，支持展開查看失敗原因。安裝完成後狀態標記爲「已安裝」，並跨刷新持久化。
安裝與啓用¶
前置條件¶
- 已安裝 DeepSeek Harness 命令行工具（
dsh）。 - 已安裝
pnpm。 - 若需安裝私有倉庫，需配置好 GitHub SSH 密鑰（確保
~/.ssh/config指向正確的密鑰，且ssh -T git@github.com能登錄）。
安裝步驟¶
- 在終端執行安裝命令：
dsh plugin --profile web add github:l541402398/dsh-top-leaderboard
- 重啓 Web 服務以加載插件：
dsh web
- 在瀏覽器訪問 http://127.0.0.1:3080，刷新頁面後，側欄底部會出現「🏆 榜單」按鈕。
適用場景與注意¶
該插件適合需要頻繁探索和安裝 DSH 插件的開發者。由於插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼與許可證，避免引入不安全內容。對於需要訪問私有倉庫的場景，必須提前配置好 SSH 密鑰認證。
總結¶
dsh-top-leaderboard 通過側欄按鈕和彈窗交互，將插件管理從外部目錄遷移到了本地 Web 界面。它通過 HTTPS 淺克隆優先策略規避網絡斷流風險，並提供下載預估與權限檢測，提升了插件安裝的可靠性與可控性。
更多細節與源碼請訪問：GitHub 倉庫
