前言¶
在 DeepSeek Harness(DSH)裏寫智能體或查資料時,很多人仍會切到瀏覽器單獨刷 GitHub Trending,或在搜索裏翻頁找「最近漲星快」的倉庫。GitHub 自帶排序多按總星數,新近起量的項目容易被壓在後面。社區插件 dsh-github-radar(維護者 goodboys155,分類:聯網工具)把一塊右側欄面板直接放進 DSH:四個按星標增速整理的榜單,外加關鍵詞搜索,點一行即可打開倉庫。下文介紹它做什麼、怎麼裝、用起來要注意什麼。
這是什麼¶
dsh-github-radar 是面向 DSH web 配置文件的客戶端插件:右側欄會出現「雷達」標籤頁,打開即展示 GitHub 上公開倉庫的起量情況。數據來自 GitHub Search REST API 的 repositories 端點,不需要 GitHub 賬號、token 或 OAuth;只訪問 api.github.com,自述無遙測。當前 package.json 版本爲 1.1.0,許可證 MIT。目錄頁:https://www.skillhub.cn/plugins/goodboys155/dsh-github-radar;源碼:https://github.com/goodboys155/dsh-github-radar。
DSH 社區插件目錄由 SkillHub 等站點維護,與 DeepSeek / 幻方無官方從屬關係;安裝插件前宜自行覈對源碼與許可證——插件在當前 dsh 進程權限下運行。
四個榜單與排序邏輯¶
插件固定提供四檔榜單,並在列表裏對前三檔顯示近似「星/天」速率(例如 +460/天):
| 榜單 | 查詢條件 | 排序方式 |
|---|---|---|
| 今日 | 2 天內新建,≥3 星 | 每天漲星數 |
| 本週 | 7 天內新建,≥20 星 | 每天漲星數 |
| 本月 | 30 天內新建,≥100 星 | 每天漲星數 |
| 常青 | ≥2 萬星,30 天內有推送 | 星標總數 |
README 說明:前三個榜先在遠端拉一批候選,再在本地按「星數 ÷ 建倉天數」重排,以便突出短期起量;「常青」看體量,仍按總星數。每個榜單最多 30 條,無「加載更多」。
關鍵詞搜索¶
搜索框直連 GitHub 搜索,規則與 GitHub 一致(名字、描述、README、話題等)。多個空格分隔的詞由 GitHub 做 AND 組合;結果按星數排序,最多 30 條。交互上有 500ms 防抖;中文等輸入法在組詞未上屏(compositionend 前)不會發請求。
安裝與啓用¶
1、確認環境:需要 DeepSeek Harness 0.2.0 及以後;支持 Windows / macOS / Linux(宿主端僅使用 Node 內置模塊)。
2、安裝(命令須與官方 README 一致):
dsh plugin --profile web add github:goodboys155/dsh-github-radar
3、重啓 DSH。文檔寫明:DSH 只在啓動時掃描客戶端插件,改磁盤文件不會熱重載瀏覽器側;裝完後右側欄應出現「雷達」標籤頁。
典型用法¶
經過上面的安裝與重啓,在 DSH 右側打開「雷達」即可:
1、在「今日 / 本週 / 本月 / 常青」之間切換,查看當前榜單;需要更新數據時點刷新(會強制重新拉取,見下文限額說明)。
2、在搜索框輸入關鍵詞(如技術棧名、話題詞),等待防抖結束後查看結果,點擊一行跳轉到對應 GitHub 倉庫。
網絡能直連 GitHub 時通常開箱即用;連不上時的退避與代理探測見下一節。
網絡、緩存與架構要點¶
出站請求:優先直連,使用 Node 全局 fetch(undici)。直連失敗時,會探測本機若干常見代理端口(如 127.0.0.1:10808、127.0.0.1:7890 等),僅嘗試正在監聽的端口;直連失敗且無可用代理時,約 6 秒報錯。第一個成功的代理會在本進程內複用。
緩存:四個榜單內存 + 磁盤緩存 30 分鐘(路徑形如 $DSH_HOME/github-radar/trending-<period>.json);單個搜索詞內存緩存 5 分鐘。GitHub 不可達時,若有歷史成功數據,會帶「離線緩存」標記繼續渲染。
架構(簡述):宿主 index.js 提供僅迴環、僅 GET 的路由 GET /api/github-radar/trending?period=day|week|month|all 與 GET /api/github-radar/search?q=<keywords>;瀏覽器側 client.js 負責右側欄 UI。出站請求放在宿主端,避免瀏覽器 CORS 與代理配置暴露。
權限:聲明能力僅爲網絡;除 $DSH_HOME/github-radar/ 緩存目錄外不寫文件;不起 shell、不讀環境變量、不接觸 GitHub 憑據。
匿名 Search API 限額爲每分鐘 10 次;正常緩存下用量低於限額,但頻繁點刷新可能觸發 403 直至窗口重置。
適用場景與已知限制¶
適合:在 DSH 工作臺內快速掃一眼「按增速起量」的倉庫,或順手搜公開倉庫,無需登錄 GitHub。
需注意:
- 描述以 GitHub 原樣顯示,以英文爲主,插件不翻譯。
- 「今日」榜要求倉庫 2 天內新建且已有一定漲星,冷清時列表可能較薄。
- 搜索按星數排序,精確匹配但星少的倉庫可能排在熱門近似匹配之下。
- 星數爲快照,榜單最長可能已緩存 30 分鐘。
結尾¶
dsh-github-radar 把 GitHub 起量發現收進 DSH 右側欄:四檔增速榜單、可搜索、免登錄,並說明了緩存、代理與 API 限額等行爲。安裝使用官方命令並重啓即可;細節以倉庫 README 爲準。