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