企业官网建设流程全解析

如果你已经在 GitHub 个人主页使用 github-readme-stats 风格的统计卡片，那么GitHub Stats Extended值得你重点关注：它是社区积极维护的增强版后继项目，不仅能生成 GitHub stats 卡片、语言排行与 WakaTime 卡片，还新增了跨组织统计、全历史贡献计数等一批进阶能力。本文将带你快速吃透这些新特性，让你的 README 卡片从"基础展示"进化为"数据看板"。🚀

项目定位：github-readme-stats 的增强后继者

GitHub Stats Extended 是 github-readme-stats 的兼容性说明）。

它默认提供四种卡片类型，覆盖个人主页的常见展示需求：

新特性一：跨组织统计，把团队仓库的贡献算进你的卡片

默认情况下，统计卡片只计算你**作为仓库所有者（OWNER）**的仓库数据。如果你还是公司/组织仓库的协作者，这部分贡献就被"漏算"了。这正是原项目中呼声最高的需求，而 GitHub Stats Extended 用三个参数把它彻底解决了。

1.role参数：一键纳入组织成员与协作者仓库

在卡片 URL 后追加&role=OWNER,ORGANIZATION_MEMBER,COLLABORATOR，即可把你担任组织成员或协作者角色的仓库纳入统计。这意味着：

• Stats Card：Stars、贡献仓库数等指标会包含所在组织的仓库；
• Top Languages Card：同样支持role参数，语言占比也能覆盖组织仓库中的代码量。

该功能的过滤逻辑实现在 ops.ts 的orgFilter中，参数解析入口见 api/index.js。

2.owner与repo参数：按组织或仓库精确过滤

如果你只想突出某个项目的贡献，可以用过滤参数：

• &owner=userA,organizationB：只统计你指定组织或用户名下的仓库；
• &repo=userA/repositoryA,organizationB/repositoryB：只统计指定仓库列表。

这两个参数作用于通过show启用的细粒度指标：prs_authored（发起的 PR）、prs_commented（评论的 PR）、prs_reviewed（审查的 PR）、issues_authored（发起的 Issue）、issues_commented（评论的 Issue），以及配合include_all_commits=true时的commits。参数传递链路可参考 fetchStats 的实现。

3. 开源贡献者的"个人战绩牌"

对长期参与开源项目的开发者，一个很实用的组合是：用Repo Pin Card固定展示某个项目，并追加&show=prs_authored,prs_commented,prs_reviewed,issues_authored,issues_commented，把你对该项目的全部贡献集中呈现（示例见 fork.md）。再配合&custom_title改标题、&hide_rank=true隐藏排名、&card_width调整宽度，一张专属"贡献战绩牌"就完成了。

新特性二：全历史贡献统计，告别"只看最近一年"

默认卡片中的contribs只统计最近一年参与的仓库数。GitHub Stats Extended 新增了两项跨全历史（all-time）的指标，通过show参数开启：

1.contributions：跨年贡献总数

追加&show=contributions后，卡片会显示你账户所有年份的贡献总数（commit、PR、Issue 等，GitHub 官方定义的贡献口径）。私有贡献是否计入，取决于你 GitHub 个人资料中的贡献可见性设置。

2.all_time_contribs：全历史参与仓库数

追加&show=all_time_contribs后，卡片会显示你历年累计参与贡献的仓库数量，而非仅去年。若希望把自己拥有的仓库也算进去，再加&contribs_include_own_repos=true——默认这两项统计只计算他人或组织拥有的仓库。

其数据抓取分别实现在 fetchTotalContributions 与 fetchAllTimeReposContributedTo；卡片渲染逻辑在 cards/stats.ts。

3. 配套的时间维度参数

• &include_all_commits=true：统计全部历史 commit数，而不是仅当前年度；
• &commits_year=2020：只统计指定年份的 commit，适合做"年度总结"卡片。

新特性三：更完整的升级清单

除了上述两大核心能力，本次版本还有多项值得升级的理由：

• 可视化卡片向导（Wizard）🎨：官方提供网页版配置向导，按"登录 → 选卡片 → 调参数 → 选主题 → 预览"五步操作，所见即所得地生成卡片 Markdown，无需手写参数。向导源码位于 apps/frontend/src/wizard/。
• 单 URL 同时适配浅色/深色主题：新增theme_light、theme_dark及*_light/*_dark颜色变体，一张卡片 URL 跟随访问者系统自动切换，连 GitHub 赞助页都能生效。
• 更快的首次加载：服务端会预先计算并缓存卡片，解决了原项目"首次访问不显示卡片"的老问题。
• 更准的 Stars 统计：支持多页抓取，最多拉取 1000 个你 Star 过的仓库来精确计算，原项目上限为 100 个。
• Top Languages 卡片定制：hide_values隐藏百分比数字、prog_bar_bg_color设置进度条背景色（可设为透明）。
• 私有贡献支持：通过向导的 "GitHub Private Access" 登录授权后，无需自行部署即可在卡片中包含私有仓库统计。

快速上手：三步完成迁移

1. 换域名：把现有卡片 URL 的域名从github-readme-stats.vercel.app替换为github-stats-extended.vercel.app，卡片样式完全不变；
2. 加参数：按本文介绍追加role、show=all_time_contribs等进阶参数；
3. 用向导调优：打开官方卡片向导（入口见 README.md 的 Quick Start），把 URL 粘贴进去可视化微调，最后复制生成的 Markdown 到 Profile README。

💡 进阶选项：如需完全私有部署，仓库支持自行运行。克隆仓库：git clone https://gitcode.com/gh_mirrors/gi/github-stats-extended，部署细节参考 deploy.md。

写在最后

GitHub Stats Extended 用跨组织统计补上了团队协作场景的短板，用全历史贡献让数据不再被"一年窗口"截断，再配合卡片向导与双主题等体验优化，是目前 GitHub stats 卡片生态中功能最完整的方案之一。对于进阶玩家，建议优先体验role+owner的组合和show=contributions,all_time_contribs的升级效果——你的个人主页，值得一张信息量更大的数据看板。📊