给每个仓库生成一张封面:new-make 制卡室
GitHub 个人主页的 README 是个挺尴尬的地方:想展示数据,但 README 是静态的,写死的数字过两个月就过期了。
new-make 就是解决这个的——把数据变成图片,让 README 每次打开都是新的。
两种形态
同一个数据层,两种跑法:
| 形态 | 谁在跑 | 适合 |
|---|---|---|
| 预渲染(推荐) | GitHub Actions 定时跑,产物是静态 .svg | 公开自用,谁访问都不消耗额度 |
| 按需服务 | 常驻或边缘函数,请求来了现算 | 要给任意用户名出图 |
我用的是预渲染。Actions 定时跑一遍,把 SVG 提交到 Pages,README 里直接 。别人打开你的主页时看到的是 CDN 上的静态图片,不触发任何计算。
有哪些卡片
- 统计卡片:仓库数、Star 数、近 90 天提交数、Fork 数、关注者
- 语言卡片:代码语言分布的圆环图或条形图
- 活跃度卡片:最近事件统计 + 最近 3 条动态
- 精选仓库卡片:双列展示仓库列表
- 连续活跃卡片:当前/最长连续天数 + 90 天热力图
- 徽章卡片:shields.io 风格的单行小徽章
- 项目专属封面:自动发现公开非 Fork 仓库,生成明暗两套封面
主题有 7 种(default、light、dracula、nord、monokai、catppuccin 等),其中 light 和 starlight 带角色插画背景。
项目制卡室
这是我自己最喜欢的一部分。
除了个人统计,每个项目也能有自己的开场图:网络工具画路由、陪伴插件画手记、监控面板画心跳。同一个作者署名,配上各自的故事和配色。
配置写在 projects.config.json 里,每个项目可以单独设置署名、故事、配色和图形。目前给 18 个公开非 Fork 项目写了首版文案。
这里有个原则:没配置的项目不编故事。自动发现的新仓库直接用仓库名、真实描述和稳定的默认图形,不靠 AI 瞎猜功能。宁可朴素,也别写出和项目对不上的宣传词。
为什么不用现成的
现成的 GitHub Readme Stats 类项目很多,但基本只做统计卡片,不管项目封面;而且大多是按需服务,请求量一大就容易被打挂或者限流。
预渲染的好处是稳定:图片在 CDN 上,你被多少人看都不会多花一分钱。缺点是有延迟,数据最多滞后一个定时周期,对我来说完全能接受。
源码:github.com/fanxing724/new-make
效果可以直接看我的主页:fanxing724.github.io
- 标题: 给每个仓库生成一张封面:new-make 制卡室
- 作者: 番星
- 创建于 : 2026-10-19 21:00:00
- 更新于 : 2026-10-21 20:11:26
- 链接: https://xingbox.me/github-cards-new-make/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。