dsh-github-radar:DSH 右侧栏 GitHub 起量项目雷达

前言

在 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 为准。

羽毛球分组比赛记分
小程序二维码

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

Xiaoye