
Glancecard:通过自有 GitHub Action 渲染 README 统计卡片
来源标题:Show HN: Glancecard – README stats cards rendered by your own GitHub Action
Glancecard 让开发者在自己的仓库中用 GitHub Actions 生成 README 统计 SVGs,无需服务器、第三方服务或依赖。它支持仓库卡片和个人资料卡片,仓库卡片包含提交、星标、语言等 26 周趋势数据,个人卡片则展示粉丝、贡献和热门仓库等信息。项目提供九种外观主题。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
你的 GitHub 个人主页和仓库,一目了然。
由 GitHub Actions 在你自己的仓库中每天渲染的 README SVG 卡片:无需服务器,无需第三方服务,无需依赖。
本仓库自己的卡片,每天由作者的个人主页仓库用 glancecard 自身渲染。它会跟随你的 GitHub 主题。
任意公开仓库的仓库卡片:状态、创建时长和最新标签,描述和主题,最近 30 天的提交及 26 周迷你走势图,十二个统计图块,一整年的提交与连续提交记录(每日提交数图表,或 GitHub 的贡献日历),仓库整个生命周期的 star 数及最近 30 天、最近一年和最佳一周,每周节律(星期 × 小时),语言与基本要素(README、许可证、贡献指南、安全策略、CI),最新提交和发布及其频率,贡献者。
任意用户的个人主页卡片:关注者、star、仓库、拉取请求、issue、提交,一整年的贡献(以图表或 GitHub 贡献日历呈现),其所有公开仓库自第一个仓库以来的 star 数,star 最多的仓库及其语言。
两种卡片各有九种外观,沿用 FinderGit 的 Profile Card 风格:Midnight、Aurora 和 Daylight;Upside Down、Hyperspace、Bridge 和 Nebula;以及当季的 Halloween 和 Christmas。dark 和 light 即 Midnight 和 Daylight,是一对文件,供 <picture> 显示与读者 GitHub 主题匹配的那一个;其他每种深色外观也都有自己的浅色版本,例如 nebula-light,供使用 GitHub 浅色主题的读者查看。
由你自己的 workflow 按你的时间表刷新,使用 GitHub Actions 每次运行本就提供的 token。卡片就是提交到你仓库中的普通文件。
一次粘贴即可完成设置
将以下内容粘贴到 Claude Code、Codex 或任何能运行 shell 的编程 agent 中。填写第一行,或者保持原样。该 agent 需要已登录的 GitHub CLI(gh);它会替你完成「手动设置」中的步骤,并在每次推送前向你展示所有改动。
帮我设置 glancecard(https://github.com/gfazioli/glancecard):它通过 GitHub Action 每天为我的 README 渲染我的 GitHub 个人主页和我的仓库的 SVG 卡片。 需要生成卡片的仓库:<owner/name, owner/name —— 或保持此行原样,选取我最 star 最多的 3 个非 fork 公开仓库> 使用 gh CLI;如果它缺失或未登录,停下来并告诉我如何修复。每次推送前向我展示所有 diff 并等待我确认。
- 用
gh api user --jq .login找到我的登录名。卡片将存放在我的个人主页仓库 <login>/<login> 中:将其克隆到临时文件夹,并记下其默认分支。如果它不存在,停下来并在创建前询问我。 - 添加 .github/workflows/glancecard.yml,内容完全如下,填入我的登录名、仓库(每行一个)和本机的 IANA 时区: name: glancecard on: schedule:
- cron: "30 5 * * *" workflow_dispatch: permissions: contents: write jobs: cards: runs-on: ubuntu-latest timeout-minutes: 10 steps:
- uses: actions/checkout@v7
- uses: gfazioli/glancecard@v0.6.1 with: profile: <login> repos: | <owner/name> time-zone: <zone> 然后确保 .github/dependabot.yml 保持该 action 更新:如果文件缺失,就用以下内容精确创建;如果已存在,则把 github-actions 条目添加到其 updates 中: version: 2 updates:
- package-ecosystem: github-actions directory: / schedule: interval: weekly 将两者以「ci: render glancecard cards」提交并推送。
- 用
gh workflow run glancecard.yml -R <login>/<login>运行一次,用gh run watch跟踪,并检查 glancecard/profile-dark.svg 现在是否已在默认分支上。如果运行失败,向我展示其日志并停止。 - 将我的个人主页卡片添加到我的个人主页 README 中最合适的位置(不确定就问我),然后提交并推送:
<picture><source media="(prefers-color-scheme: dark)" srcset="glancecard/profile-dark.svg"><img src="glancecard/profile-light.svg" width="880" alt="<login>'s GitHub activity"></picture><br><sub>Made with <a href="https://github.com/gfazioli/glancecard">glancecard</a> · refreshed daily</sub> - 对上述每个仓库,打开一个 pull request,将其卡片添加到 README 标题正下方,使用同样的
<picture>,指向 https://raw.githubusercontent.com/<login>/<login>/<default branch>/glancecard/<name>-dark.svg 和 -light.svg,并在其下方添加同样的那一行。不要合并它们:把它们的链接给我。 其他任何内容都不要改动,也不要添加 token 或 secret:workflow 使用的是 GitHub Actions 本就提供的 token。
手动设置
- 向将存放卡片的仓库添加一个 workflow —— 你的个人主页仓库(<you>/<you>)是个不错的选择,因为它的 README 是人们最先看到的:
.github/workflows/glancecard.yml
name: glancecard on: schedule:
- cron: "30 5 * * *" # every day workflow_dispatch: permissions: contents: write jobs: cards: runs-on: ubuntu-latest timeout-minutes: 10 steps:
- uses: actions/checkout@v7
- uses: gfazioli/glancecard@v0.6.1 with: profile: your-login repos: | your-login/your-repo your-login/another-repo
- 从 Actions 标签页运行一次(Run workflow)。它会提交 glancecard/profile-dark.svg、glancecard/profile-light.svg,以及每个仓库一对文件。
- 在 README 中展示卡片。在同一仓库中:
<picture><source media="(prefers-color-scheme: dark)" srcset="glancecard/your-repo-dark.svg"><img src="glancecard/your-repo-light.svg" width="880" alt="your-repo at a glance"></picture><br><sub>Made with <a href="https://github.com/gfazioli/glancecard">glancecard</a> · refreshed daily</sub>从另一个仓库引用时,改为指向原始文件:https://raw.githubusercontent.com/<you>/<you>/main/glancecard/your-repo-dark.svg。这样项目自身的历史记录就不会有机器人提交;卡片存放在一个地方,并在那里刷新。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。