AX 爱鲜报

GitHub Readme Stats

一个为 GitHub 个人主页 README 动态生成统计卡片的开源项目,可展示提交数、Star 数、常用语言、仓库置顶等数据,只需在 Markdown 中插入图片链接即可使用。

爱鲜报评分

0.0

0 人评分

8k

星数

否

中文

JavaScript

主语言

是

活跃

318

贡献者

人工分析

EDITORIAL

推荐理由

近 8 万 Star 的经典项目,几乎是 GitHub 个人主页美化的标配工具,接入成本极低。虽然原仓库已停止维护,但社区继任项目仍在活跃更新,思路与用法完全兼容。适合想快速提升主页专业感的开发者参考或迁移使用。

适用场景

  • GitHub 个人主页 README 美化
  • 开源项目作者展示贡献数据
  • 团队或组织主页展示技术栈分布
  • 博客/简历中嵌入 GitHub 活跃度卡片

优点

  • 接入极简,Markdown 中插入图片链接即可
  • 支持统计卡片、语言分布、仓库置顶、Gist 置顶等多种卡片
  • 主题与参数丰富,可自定义配色、隐藏字段、图表样式
  • MIT 协议,可自托管部署,支持私有仓库统计

缺点

  • 原仓库已停止维护,官方推荐迁移至 GitHub Stats Extended
  • 公共 Vercel 实例受速率限制影响,稳定性一般
  • 默认仅统计公开仓库,私有数据需自行部署并配置 Token
  • 排名算法与统计口径依赖 GitHub API,数据存在缓存延迟
上手难度 入门

项目简介

GitHub Readme Stats 是一个用于在 GitHub 个人主页 README 中动态生成统计卡片的开源项目。只需在 Markdown 中插入一个图片链接,就能展示提交数、Star 数、PR 数、常用语言分布等信息。

⚠️ 注意:原仓库已停止维护,官方推荐使用继任项目 GitHub Stats Extended 或 GitHub Readme Stats Action,用法基本兼容。

核心功能

  • 统计卡片:展示 Star、提交、PR、Issue、贡献排名等数据
  • 常用语言卡片:以条形图、环形图、饼图等形式展示语言占比
  • 仓库/Gist 置顶:把指定仓库或 Gist 以卡片形式固定在主页
  • WakaTime 卡片:展示编码时长统计
  • 主题系统:内置多套主题,也支持自定义颜色与参数

快速上手

在 README 中插入如下 Markdown(把 username 换成自己的 GitHub 用户名):

[![GitHub 统计](https://github-readme-stats.vercel.app/api?username=yourname)](https://github.com/anuraghazra/github-readme-stats)

语言分布卡片:

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=yourname)](https://github.com/anuraghazra/github-readme-stats)

部署与稳定性

公共 Vercel 实例为尽力而为服务,受速率限制影响可能不稳定。若需要稳定或展示私有仓库数据,建议:

  • 使用 GitHub Actions 在个人主页仓库中定时生成卡片
  • 自托管到 Vercel 或其他平台,并配置自己的 GitHub Token

适用建议

适合希望低成本美化主页、展示技术画像的开发者。新项目建议直接采用社区维护的继任版本,以获得持续更新与更好的稳定性。

评论

登录后才可评论与评分

0 条评论

  • 暂无评论,来写第一条吧。