日增 298★ 到底算不算热:49 万星标项目的增速该怎么读
日增 298★ 到底算不算热:49 万星标项目的增速该怎么读
对 public-apis 这样的项目来说,单日新增 298 个 star 是一个容易被误读的数字。放在一个刚开源的 Side Project 上,298★/天意味着它正处在爆发期,大概率已经出现在 GitHub Trending 首页;但放在一个已经有 49 万 star、创建超过十年的仓库上,同一串数字的含义会完全不同:它既不算“突然爆红”,也绝不意味着“没人看了”。
这篇文章不谈虚的。我们用三个可复算的口径——绝对增量、相对增速、与自身基线的对比——把 298 这个数字放回它的坐标系里,再结合仓库里真实存在的 README.md、校验脚本和 CI 工作流,说明一件事:读增速,读的不是 star 数,而是 star 数与这个项目“体量、年龄、维护强度”之间的关系。
先把三个数字分开:1 小时、6 小时、日增
各种榜单和监控面板通常会给三个口径:近 1 小时新增、近 6 小时新增、日增。它们看起来只是同一个量的不同时间窗,实际上误差结构完全不同,直接拿 1 小时乘 24 是最常见的错误。
star 增量本质上是计数过程。如果某仓库在一天内稳定获得约 298 个 star,那么把它切成 24 个小时,每小时期望约 12.4 个;这种离散事件的相对波动约等于 1/√N。也就是说:
| 观察窗口 | 期望新增 N | 相对波动 1/√N | 折算日增的 1σ 误差 |
|---|---|---|---|
| 1 小时 | ≈ 12 | ≈ 29% | 298 ± 86 |
| 6 小时 | ≈ 75 | ≈ 12% | 298 ± 34 |
| 24 小时 | ≈ 298 | ≈ 6% | 298 ± 17 |
一小时只有 12 个样本,±3 个 star 的抖动就能让你的“日增预测”跳 ±25%。所以三个数字的正确用法是:
- 1 小时只用来判断“此刻有没有异常脉冲”(比如某篇帖子刚发出去),不能外推;
- 6 小时用来做当天趋势的粗估,注意跨时区效应——GitHub 的活跃高峰集中在北美工作时段,用 UTC 白天窗口外推会系统性偏低;
- 日增才是可以进表格、做同比的量。
这里还有一个工程层面的坑:想自己做高频采样,最容易想到的 GET /repos/{owner}/{repo} 是不带认证每小时 60 次的接口。本文取材时直接用无 token 请求 api.github.com,返回的就是 403 rate limit exceeded。想抽 1 小时粒度,要么上 token,要么改用分页遍历 stargazers 列表做差分——而对一个 49 万 star 的仓库来说,per_page=100 意味着近 5000 页,单次全量扫描的代价远超收益。高频口径的精度,往往被采样成本先一步锁死。
合理的参照系:先算清这个仓库自己的基线
把 298 放进 public-apis 的历史曲线里,需要两个锚点。
第一个是生命周期均值。仓库创建于 2016 年 3 月 20 日,截至 2026 年 11 月初 star 数为 494,211,跨度约 3,878 天:
494211 / 3878 ≈ 127.4 star/day
第二个是近期实测。社区情报里 2026 年 9 月中旬的十余篇文章普遍引用“474k Star”,而 11 月 1 日的实际计数是 494,211。从 474,000 到 494,211,52 天增长 20,211:
20211 / 52 ≈ 388.7 star/day
于是 298 的位置就很清楚了:
- 是生命周期均值的 2.34 倍——它不是“衰退中的老项目”,而是明显高于自身长期斜率的阶段;
- 略低于最近两个月的 389/天——属于同一量级内的正常回落,而不是断崖;
- 占存量的 0.060%——
298 / 494211 ≈ 0.000603。
第三个数最容易被忽略,也最重要。0.06%/天如果按复利年化,是 (1.000603)^365 - 1 ≈ 24.6%。一个大基数项目能维持 0.06%/天的相对增速,本身已经是相当健康的信号;但反过来,同样的 0.06% 放到 5 万 star 的仓库上只有 30/天,看上去就像“凉了”。绝对增量会被体量绑架,相对增速才可跨项目比较。
顺便算一下体量带来的“天花板感”:在 298/天 的节奏下,再涨 10 万 star 需要 100000 / 298 ≈ 336 天。对 49 万的基数来说,这不是“还能不能涨”的问题,而是“一年内能不能再翻两成”的问题——数学上完全可行,但任何单日数字都无法回答它。
大基数项目的增速天花板,来自分母而不是热度
一个 49 万 star 的仓库,日增的天花板由三件事共同决定,没有一件与“营销”直接相关。
第一,可触达人群的渗透率。 每天新增 298 个 star,意味着每天要有约 300 个此前没点过星的账号做出这个动作。在近 50 万存量之上,这已经是每天要说服“存量之外”的千分之零点六。当渗透率接近目标人群上限时,增速一定趋缓,这与内容质量无关。
第二,star 是累计存量,不是流量。 存量越大,边际增量的分母越大,相对增速天然衰减。任何用“新增 star 数”跨项目横比的榜单,本质上都在奖励小项目——这是指标设计的问题,不是项目的问题。
第三,二手数字自身的噪声,可能比你想研究的波动还大。 同一周内的社区文章,星标数分别写成“47 万”“47.4 万”“474k”,条目数写成“1400+”。而本地仓库实测是:README.md 共 2,720 行、322,196 字节,51 个 API 分类、2,191 条 API 条目,另有 25 条 MCP Server 条目。也就是说,“1400+”这个流传甚广的数字,与真实条目数差了三分之一以上。
这提醒我们:做增速分析前,先把二手数字换成一手快照。 一条 git clone 加一次接口读数,比引用十篇文章都可靠。
为什么“增速慢”不等于“不受关注”:看存量的使用强度
star 只能证明“曾经被收藏”,不能证明“现在被使用”。要判断一个资源型仓库是否仍在被真实使用,得看几类二阶信号。public-apis 在这几项上都留有可查的痕迹。
收藏与关注的比值。 当前 55,170 fork、4,760 watch,对应 494,211 star:fork/star ≈ 11.2%,watch/star ≈ 0.96%。对一个纯文档仓库来说,fork 的主要动机是“留一份离线可查的清单”,而不是提 PR——11% 的 fork 率说明相当一部分人把它当作本地工具书收进了自己的账号,这属于典型的高频回访型使用,而不是一次性点赞。
贡献流的持续度。 仓库 HEAD 是一个合并提交,来自 PR #8167。GitHub 的 issue 与 PR 共用递增序号,8,167 个编号分布在约 3,878 天里,平均每天产生约 2.1 个编号条目。这个量级谈不上热闹,但十年不断,说明维护管线是活的。
内容结构在跟随生态演进。 最能说明问题的是 README.md 里新增的 MCP Servers 区块:它不再用 HTTPS/CORS 描述条目,而是换成 Transport(stdio/HTTP/SSE)和 Install(Cursor、Anthropic、Glama 等市场上的收录情况)。CONTRIBUTING.md 里对此有完整规范,甚至明确写了“只链接真实存在的市场页面,404 会让 PR 被关闭”。一个纯清单项目愿意为 AI Agent 生态改表结构,说明它维护的不是一份静态文档,而是一套仍在迭代的信息模型。
自动化维护的深度。 这类仓库真正的护城河不是条目数,而是“条目还能不能用”。见 .github/workflows/validate_links.yml:每天 cron: '0 0 * * *' 跑一次全量链接校验;.github/workflows/test_of_push_and_pull.yml 在每次 PR 上跑格式校验与增量改动校验,push 到 master 时跑重复链接检查。
而校验逻辑本身写得相当克制:
# scripts/validate/format.py
auth_keys = ['apiKey', 'OAuth', 'X-Mashape-Key', 'User-Agent', 'No']
https_keys = ['Yes', 'No']
cors_keys = ['Yes', 'No', 'Unknown']
num_segments = 5
min_entries_per_category = 3
max_description_length = 100
scripts/validate/format.py 会检查:每条目必须凑齐 5 列、每列前后恰好一个空格、分类内按标题字母序、描述首字母大写且不以标点结尾、长度不超过 100 字符、标题不能以 " API" 结尾、分类条目数不得少于 3 条,以及每个分类标题必须出现在 ## Index 里。这些规则把“人工策展”的随意性压到了很低——.github/PULL_REQUEST_TEMPLATE.md 里的九项勾选清单,几乎就是这套脚本的自然语言版本。
scripts/validate/links.py 则负责可用性:25 秒超时、随机 User-Agent、补 host 头,并把 Cloudflare 的 403/503 挑战页识别为“可访问”而不是坏链(见 has_cloudflare_protection() 里那串 _cf_chl、Ray ID: 特征串)。这个设计选择很务实:宁可漏报,也不要每天被误报的 403 淹没。
一处值得注意的覆盖盲区。 find_links_in_file() 的实现是这样的:
readme = file.read()
index_section = readme.find('## Index')
if index_section == -1:
index_section = 0
content = readme[index_section:]
也就是说,链接校验只从 ## Index 开始往后扫。而 MCP Servers 区块位于 ## Index 之前(README 中约在第 60 行,Index 在第 108 行),这 25 条 MCP 条目的链接实际上不在夜间巡检范围内。对贡献者来说这有现实含义:你那行 MCP 记录如果链接到不存在的市场页面,CI 不会替你发现,只能靠人工 review。类似地,本地跑一遍重复检测会发现 2,192 条链接、去重后 2,187 个 URL,仍有 5 条重复(如 api.nasa.gov、open-meteo.com),集中在跨分类的同一服务上——这是纯 Markdown 手工策展在大体量下必然留下的噪声。
这些细节共同指向一个结论:判断“是否受关注”,看的是维护者还在不在为“可用性”付成本。 一个每天跑全量链接巡检、为每条新增记录做格式门禁的项目,哪怕日增从 389 掉到 298,也远比一个日增 500 但半年没合并过 PR 的项目更值得关注。
顺手可用的数据体检:这些字段比 star 更能说明清单质量
既然把 README.md 解析了一遍,不妨看看这 2,191 条条目的元信息分布,它比 star 数更能反映“这份清单今天好不好用”。
| 字段 | 分布 | 解读 |
|---|---|---|
Auth = No |
1,050(47.9%) | 近一半接口无需注册,适合原型与教学 |
Auth = apiKey |
980(44.7%) | 主流形态,成本在“注册 + 配额” |
Auth = OAuth |
150(6.8%) | 需要代表用户操作时才值得付这个复杂度 |
HTTPS = Yes |
2,101(95.9%) | 明文 HTTP 仅 88 条,已属边缘 |
CORS = Yes |
892(40.7%) | 可直接从浏览器调用 |
CORS = Unknown |
1,038(47.4%) | 近半数条目的跨域能力其实是未知的 |
最值得警惕的是最后一行:47.4% 的条目 CORS 字段写的是 Unknown。这意味着“按 CORS=Yes 筛选”这个在社区文章里被反复推荐的动作,实际只能覆盖四成条目;而 Auth = No 且 CORS = Yes 的“零成本直调”组合只有 528 条,占 24.1%。
分类分布同样说明这份清单的重心:Development 220 条、Government 126、Geocoding 113、Games & Comics 111、Finance 97、Transportation 97。开发工具与政府开放数据构成了主体,而“动物图片”这类常被文章拿来做标题的分类只有 24 条。热度叙事偏爱猎奇条目,真实需求集中在工程与公共数据上。
顺带一提,用脚本聚合时还会撞见 2 行取值异常的记录(列值分别是 Auth/HTTPS/CORS,形态上像重复表头)。这不算 bug,但足以说明:任何基于这份 Markdown 做二次统计的工具,都必须容忍人工文档的脏数据,而不是假设它是一张规整的表。
给选题与投资的通用读表法
把上面的分析抽象成一套可以套用到任何“大基数项目”的读表顺序:
- 先划窗口,别混口径。 1 小时、6 小时、24 小时是三个不同的统计量。用
1/√N先估一遍噪声,噪声大于你要解释的差异时,这个数字就不该进结论。 - 绝对增量换成相对增速。
日增 / 当前存量才是可比的量。298/494,211 ≈ 0.06%/天,年化约 24.6%——这个数放在任何成熟项目上都不算慢。 - 和自身基线比,而不是和榜单第一名比。 生命周期均值 127/天、近两月 389/天、当前 298/天,三者构成一条可解释的曲线;跨项目横比只会得到“小项目更热”的错觉。
- 找二阶信号验证“是否还在被用”。 fork/star ≈ 11.2%、watch/star ≈ 0.96%、PR 编号日均 2.1 个、每日全量链接巡检、表结构为 MCP 生态而改——这些都指向“仍在使用”,且都不依赖 star 增量。
- 最后检查数字的出处。 同一周的二手文章能把 49.4 万写成 47 万、把 2,191 条写成“1400+”。凡是无法回源到一手快照的数字,只能当趋势参考,不能当论据。
回到标题的问题:日增 298★ 算不算热?
在一个 49 万 star、十年历史、日增基线 127、近两月 389 的项目上,298 是一次正常偏强的呼吸——它高于长期均值,略低于近期高点,相对增速仍足以支撑一年再涨两成的数学可能。把它读成“爆红”是误判,把它读成“过气”同样是误判。
真正该被记住的,是那个不起眼的比值:0.06%/天。它比任何单日绝对值都更接近事实,也更难被情绪带偏。而支撑这个比值持续成立的,不是 star 本身,是仓库里那套每天凌晨跑一次、把 2,192 条链接逐条敲一遍的脚本——以及愿意为一条 404 链接关闭 PR 的维护者。