GitHub Hot Board

GitHub 火线榜 · GitHub Hot Board

English

GitHub 排行榜 · 趋势榜 · 飙升榜(周榜 / 月榜 / 总榜 / 黑马 / 里程碑),中英文双语界面,每 6 小时自动更新:https://git.vaiox.xyz

十个视角的 GitHub 开源热榜。数据只有公开数据一种来源,口径贴在每一页上,中英文双语,站点刷新每 60 秒一次。

本周飙升 Top 10 · 打开完整榜单 →

本月飙升 Top 10 · 打开完整榜单 →

累计 Star Top 10 · 打开完整榜单 →

先说三件不掺假的事:

• 不伪造数据。榜单页面写的是哪种口径,数出来就是哪种口径;口径失效时页面明示,不悄悄换数。
• 不碰付费数据。只用 GitHub Search API 和官方 trending 页,不需要任何特殊权限。
• 不装没有的历史。往日榜从 2026-10-18 起积累,之前的日期不提供。

十个榜

总榜、周榜、月榜有语言分榜(javascript / typescript / python / go / rust / java / c / c++),URL 形如 /zh/boards/weekly/python。c++ 在路径里写成 /cpp,因为 + 进路径段会在路由匹配层直接死掉——查询时仍用 GitHub 原生语言名,旧链接由 proxy.ts 在路由前 308 归一。

站点语言(16 种)

/en /zh /zh-TW /ja /ko /de /fr /es /pt /it /ru /uk /pl /tr /vi /id,根路径默认进英文(带 Accept-Language 时按浏览器语言挑)。全部 UI 文案逐语种成套(app/[lang]/dict/),SEO 每页带全语 hreflang + canonical,sitemap 覆盖 16 语 × 全榜。

行描述与抽屉 README 按站点语言取仓库自身的本地化版本(切换器解析 + 命名候选两级),读不到就诚实回退仓库原文。描述缓存在 repo_desc 表(仓库粒度),两条填充通道:浏览行为驱动(访客打开哪个语言就近补上,60 秒轮询自动送达)与同步期主动收割(每轮同步尾部按热度序扫描全部榜头仓库,一次拿齐 15 种语言,探测结论 30 天免重试;站点读取路径依旧只查库)。

The site ships in 16 languages (default English). UI copy is fully translated per locale; row descriptions and the in-drawer README follow the repo's own localized files when available, falling back to the original text. Descriptions are cached per repo (repo_desc) and filled two ways — on demand by visitors, and proactively at the tail of every sync run (one sweep per repo covers all 15 locales; resolved probes are skipped for 30 days). The serving path always reads from the database only.

数据架构

一句话:卖货的通道不进货。

GitHub ──(只有同步任务碰)──> Postgres(Neon 或自托管)──(站点只 SELECT)──> 访客

• 同步任务(lib/sync.ts)顺序抓全部 34 个键(10 榜 + 语言分面),写两张表:
• board_head:每个键的最新一拍,站点读它。插新的,前拍自然被覆盖。
• board_snapshots:逐仓逐名次的明细行,本次同步是历史事实的存档。
• 触发方式:npm run sync(本地,需站点在跑)、POST /api/sync(带 CRON_SECRET)、 GitHub Actions 每 6 小时一轮(.github/workflows/sync.yml)。
• 站点渲染路径对 GitHub 零请求。降级链:数据库 → 磁盘快照(本地 .data/,重建时不打 GitHub)→ 现场拉取。同步停太久时数据会旧,但不会假。
• Trending 页被风控挡住时,周榜/月榜内部自行换到 Search 口径补命,页面上如实标注,不糊弄。

往日榜

每次同步把完整榜单拍进 board_snapshots,所以任意一天切任意名字都能回看:

/zh/history/overall/2026-10-19

入口在 footer(往日榜 → 总榜)。历史拍只存排名、仓库和数字,不存实时简介;数据保留 SNAPSHOT_RETENTION_DAYS(默认 60 天)。页面 noindex,属工具页,不在 sitemap 里占道。

本地跑起来

npm install

cp .env.example .env.local

填 GITHUB_TOKEN / NEXT_PUBLIC_SITE_URL / DATABASE_URL(见下表)

npm run dev

本地调试开关:GHB_FILL_DEBUG=1 看读路(数据库命中还是水合),GHB_SQL_DEBUG=1 看发往库的 SQL。

部署

1. 在 Neon 建个项目,拿 Pooled connection 连接串。
2. Vercel 导入仓库,配四个环境变量(上表 + CRON_SECRET 自定义一个长随机串)。
3. 仓库 Actions secrets 配 SYNC_URL(你的域名 /api/sync)和 CRON_SECRET,6 小时一次的同步就转起来了。
4. https://域名/robots.txt 里已有 sitemap 指向;搜索引擎控制台提交一次即可。

自托管也成立(本项目生产即此形态):npm run build && npm run start,数据面只要求能连上 Postgres——Neon 托管或自建实例(Docker/1Panel 等)均可,对 Host/Vercel 无偏好。自建库建议配每日 pg_dump 滚动备份,参考 scripts/ghb-backup.sh(每日一备、保留最近 7 份,cron 挂机即可)。

诊断与运维

npm run sync                       # 本地手动拉一轮(30 榜,~4 分钟,一次重试)

curl -H "Authorization: Bearer $CRON_SECRET" https://域名/api/dbcheck # 库状态:head 键数、明细行数 gh run watch # 看 Actions 同步跑完没有

同步是顺序慢跑(为控边界与限流),一轮约 4 分钟;6 小时一次绰绰有余。明细行过 60 天自动清,board_head 只留最新,不需要人手干预。

徽章 · 状态页 · 跨线提醒

• 上榜徽章:项目被任何一张榜收录后,维护者都可以把名次徽章贴进自家 README——徽章自动显示当前最好名次(现役 / 曾上榜 / 未上榜三态),点击回到站内档案页。这也是本站唯一的外链请求:

  [![GitHub 火线榜](https://git.vaiox.xyz/api/badge/{owner}/{repo}.svg)](https://git.vaiox.xyz/zh/repo/{owner}/{repo})

档案页(任意 /zh/repo/{owner}/{repo})顶部有徽章预览与一键复制的嵌入码。

• 数据健康页:/{lang}/status(footer 入口)—— 34 个键各自的来源、新鲜度、降级状态,与站点读路径同一张表,不涂脂抹粉。
• 跨线提醒(可选):配置 VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY 后,关注页出现"跨线提醒"开关 —— 无账号 Web Push,关注的仓库向上跨过 1k/10k/50k/100k 时推送;未配置则整条链路静默不存在。订阅只存推送端点与关注列表,退订即刻删除。

市场分析(可选,与站点无关)

站点只服务榜单本身;历史维度的深挖走独立脚本 scripts/market.mjs,数据来自 GH Archive 公共镜像(约 10% 抽样,看形状用):

node scripts/market.mjs repo vercel/next.js --days 60   # 单仓库爆发日/拐点(自动兼容改名)

node scripts/market.mjs track agent --months 12 # 赛道趋势(新星数/活跃仓库数) node scripts/market.mjs risers --days 30 --limit 15 # 涨星火箭榜

顺带一个探明的平台事实(2026-10):GitHub 已把 REST stargazers/subscribers 明细端点平台级撤下,逐星时间线只存在于事件归档里。仓库改名后归档仍按旧名存,查询需新旧名都算——repo 命令已处理。

如何新增一个榜

1. lib/boards.ts:写一个 getXxxData(),在 getBoardData 分发,BOARD_META 登记排行与排序语义。
2. app/[lang]/dictionaries.ts:补 BoardCopy(名称 / 口径 / FAQ,中英都要)。
3. 想有语言分面就在 BOARD_META 开 facets。
4. 路由、导航、footer、sitemap 随 BOARD_ORDER 自动生效,不手改。

MCP server(agent-native 数据口)

榜单数据以 MCP 协议直供 agent,不依赖爬虫路径:

• URL:https://git.vaiox.xyz/api/mcp(Streamable HTTP,无状态 JSON,最新 protocolVersion 2026-07-28,老客户端自动降档)
• 工具(只读 + 结构化输出):list_boards / get_board / get_board_movers / get_repo / search_library(库内关键词搜索)/ `get_repo_history`(仓库级小时名次 + 星数时间线,自有无一物快照序列独供,别的服务拿不出这份数)
• 全部零 GitHub 配额消耗;限流 60 次/分钟/IP;数据一小时一拍,别连点
• 接入示例:Claude Code claude mcp add --transport http github-hot-board https://git.vaiox.xyz/api/mcp

已知限制,如实说

• Trending 数字在缓存期内(同步后 ≤6 小时)可能与官方页面存在偏差。
• Search API 单查询 1000 条上限;总榜展示 Top 500,头部故事全覆盖。
• 潜力/黑马榜主口径 = 本站快照实测(近 7 天星数差 / 增速百分比,星速层随总榜收盘);旧"90 天斜率"口径降为兜底,启用时会标注 degraded。
• 黑红榜的候选池是总榜(前 300)中 ≥3000 星的仓库,即"明星仓内部"的争议对比;open_issues 口径含 PR(GitHub 字段如此,页面已明示)。请勿读成"情感评分"。
• 黑马榜按斜率取前 100(页面口径文案同此)。
• 里程碑跨线检测发生在页面停留期间,服务器不留历史状态;想看"历史上谁跨过 1k",等往日榜攒几天再回看。
• 往日榜当前只存基准口径(全语言),语言分面的历史拍在库里,页面上还没有入口。
• 本项目与 GitHub 无官方关系,榜单仅为研究参考。