anmol098/waka-readme-stats

这是什么？

核心功能

• 01按 cron 定时自动更新个人主页 README 中标记好的区块。
• 02展示 WakaTime 中的编码时长、编程语言、编辑器、操作系统、项目和时区。
• 03按一天中的时段和星期统计提交情况，可选代码行数统计。
• 04支持 Unicode 文字进度条或可自定义颜色和圆角的 SVG 进度条。
• 05支持多语言输出，并可指向自托管的 Wakapi 实例。

适用场景

• 在 GitHub 个人主页上展示自己的编码习惯和语言分布。
• 无需手动维护，在 README 中持续追踪个人编码时长。
• 使用自托管的 WakaTime 兼容服务，同时在 GitHub 上展示统计数据。

快速上手

1. 1

   在个人资料 README.md 中添加起始和结束区块注释

2. 2

   将 WAKATIME_API_KEY 和 GH_TOKEN 保存为仓库 Secrets

3. 3

   添加使用 anmol098/waka-readme-stats@master 的工作流文件并提交

4. 4

   在 Actions 页面手动运行工作流以查看结果

使用前须知

• !需要 WakaTime API 密钥以及带有 repo 权限的 GitHub 令牌，权限范围较广。
• !代码行数统计功能默认关闭，因为其运行开销较大。
• !只有当你的 WakaTime 账户中有 AI 编码追踪数据时，AI 编码统计才会显示。

标签

常见问题

waka-readme-stats 是什么？

一个 GitHub Action，把 WakaTime 编码统计渲染成图表，自动更新到 GitHub 个人主页 README 中。 waka-readme-stats 是一个 GitHub Action，会定时从 WakaTime 拉取编码数据，并写入你个人主页 README 的指定区块。可展示编码总时长、编程语言、编辑器、操作系统、项目、时区，以及按时段和星期统计的提交情况。

waka-readme-stats 可以免费使用吗？用的什么许可证？

waka-readme-stats 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

waka-readme-stats 还在维护吗？

活跃维护中。waka-readme-stats 最近一次提交是在 2026年11月2日。

waka-readme-stats 适合用来做什么？

在 GitHub 个人主页上展示自己的编码习惯和语言分布。 无需手动维护，在 README 中持续追踪个人编码时长。 使用自托管的 WakaTime 兼容服务，同时在 GitHub 上展示统计数据。

waka-readme-stats 怎么安装和运行？

在个人资料 README.md 中添加起始和结束区块注释 将 WAKATIME_API_KEY 和 GH_TOKEN 保存为仓库 Secrets 添加使用 anmol098/waka-readme-stats@master 的工作流文件并提交 在 Actions 页面手动运行工作流以查看结果

在哪里获取 waka-readme-stats？

源代码和安装说明在 GitHub 上：https://github.com/anmol098/waka-readme-stats