新增与净增，
分开说清。

今日实时榜与昨日完整榜如何计算

每个用户对同一仓库每天最多计一次，重复事件按事件 ID 去重。实时榜每小时读取 GH Archive 已完整发布的小时文件，从北京时间 00:00 累计至页面标明的截止时间；因为当日尚未结束，数字与排名都可能继续变动。

次日完整榜使用 BigQuery 重新扫描北京时间 00:00 至次日 00:00 的完整窗口，只在 24/24 个 WatchEvent 小时全部通过校验后发布。两张榜都按唯一用户数降序、WatchEvent 数降序、仓库 ID 升序排序。

它是“新增”信号，不扣除用户同日或之后取消 Star 的数量，因此不等于 Star 总数的净变化。

候选池净增榜如何计算

每天通过 GitHub Repository Search 合并最近创建、近期活跃和成熟活跃项目，候选池最多保留 2,000 个非 Fork、未归档、未禁用的公开仓库。

采集任务在北京时间每日 00:20 调度，并保存实际执行时间。有效快照必须位于 00:00–03:00，相邻快照日期连续且实际间隔为 21–27 小时。只有同时满足这些条件的快照对才可生成榜单。

新发现项目必须拥有两个有效快照才可比较。缺失、无效日期不补采、不补零、不插值；7 日和 30 日榜需要完整的连续窗口，不会用部分日期凑数。

“净增”已经包含取消 Star 的影响，所以数字可能为负数。出现同分时依次比较当前总 Star，并以仓库全名稳定排序。

GH Archive 覆盖边界与延迟

GH Archive 是第三方的 GitHub 公开事件归档。事件榜扫描目标时间窗口内它实际归档的全部公开事件，但不覆盖私有活动，也不保证等同 GitHub 内部的完整记录。

实时榜在北京时间 01:45–23:45 每小时运行，只纳入已发布并能完整解析的小时文件；任何已完成小时不可用时保留上一次成功版。完整榜在北京时间 07:30 汇总前一自然日，并严格校验 24 个 UTC 小时。

BigQuery 费用保护

每次正式查询前必须执行 dry-run，且只读取目标北京时间窗口涉及的两张日表与必需字段，不读取体积较大的 payload。dry-run 估算或实际扫描超过 24 GiB 时立即失败，不发布任何部分结果。

采集项目必须使用未绑定结算账号的 BigQuery Sandbox，不创建自有表、不流式写入。免费额度不足时任务失败，而不是产生费用；扫描字节与硬上限会随榜单公开。

查看 BigQuery 价格与免费额度 →

为什么仍保留候选池榜

GitHub Search API 每条搜索最多返回 1,000 个结果，也不能按每日 Star 增量排序；因此候选池净增榜不是全站完整榜。但它能观察负增长、语言榜、7/30 日完整窗口与稳定项目历史，这些不能从 WatchEvent 新增信号直接推导。

语言榜在当日全部可比较候选项目中排名，不是从全局前 100 项中二次筛选，最多发布 500 项。项目历史按 repository ID 跟踪；空值保留为缺失，不解释为零增长。

查看 GitHub Search API 限制 →

失败时如何保护数据

实时、完整日榜和候选池三条流水线独立校验与发布。小时文件不可用、BigQuery 身份、dry-run、24 小时覆盖、GitHub 元数据或 JSON Schema 任一校验失败时，任务不会提交残缺文件、不会覆盖 Pages；线上保留上一份成功版。

事件榜先按 repository ID 汇总，再从 GitHub 补充当前名称与状态；重命名不会拆成两个项目。404、转私有、Fork、归档、禁用项目会被过滤；限流或连续网络失败则整个任务失败。

公开 Top 500 永久保留，并按每页 100 项生成五页静态 HTML；当日全部获星仓库的精简聚合状态保留 30 日，用于计算真实 7 日趋势。该状态不形成公开 JSON 接口；某仓库当日没有可用公开加星事件时，趋势保留为空值，不解释为 0。

中文项目名称与简介

中文功能名和简介用于帮助中文用户快速理解项目，由 GitHub Models 根据公开仓库名称和原始描述生成，并经过结构、长度和关键标识校验。中文内容不是仓库作者提供的官方译名，也不改变项目真实身份。

页面始终保留 GitHub 的 owner/repository 原名和跳转链接。用户可以在页头切换“中文 / 原文”；模型限流、免费额度耗尽或译文失效时直接显示 GitHub 原文，不阻塞榜单采集与发布。

译文按 repository ID 缓存；原名称或描述变化后旧译文自动失效。人工校订优先于模型结果，公开状态页会披露覆盖率、待处理数量、模型与提示词版本。

了解 GitHub Models →

项目方向、产品形态与适用场景

项目分类是帮助理解用途的展示层。GitHub Models 只使用公开仓库名、原始描述、编程语言及已验证的中文内容，从版本化的固定词表中选择一个主方向、一个产品形态和 1–4 个适用场景。不读取 README，也不增加 GitHub API 请求。

结果按 repository ID 缓存；来源描述、语言、中文内容或词表版本变化时自动失效。人工修正始终优先于模型结果；模型不可用时保留旧缓存或显示“分类待生成”，不阻断日榜。

分类直接服务于各榜单页面的实时筛选：语言、方向、形态和场景各维度单选，维度之间取交集。事件榜从最多 1,000 项扩展池中重排，候选池日榜和周期榜从最多 2,000 项可比较候选中重排；筛选结果最多显示 500 项，同时标明筛选名次与原总榜名次。

全部历史星标 Top 1000

历史星标榜按 GitHub 搜索的累计 Star 数降序收录前 1,000 个公开仓库，剔除 fork、已归档、已禁用与私有项目。GitHub 单次搜索最多返回 1,000 条结果，恰好覆盖发布深度，因此它是搜索口径下真实的全站累计榜。

该榜每周更新一次，反映长期累计的关注度；它不统计每日变化，也不扣除取消 Star。选择分类条件后会在 Top 1000 母集中重新排列并最多显示 500 项。