把你的 Token Forest 秀到 GitHub README 上
一张实时徽章——显示你的展示昵称、树种、成长阶段、总 token 和全球排名——只需贴进你的 GitHub 个人主页 README 一次。它会随你的森林成长自己更新,你再也不用碰 README。
更新于 2026-07-17
它是什么
徽章是一张从网址实时生成的小图片,所以永远显示你当前的数据——你不用为了保持最新去改 README。它只显示那些已 opt-in 的玩家在排行榜上本就公开的字段,不会暴露任何关于你的新信息。
第 1 步 — 先开启排行榜
只有加入排行榜之后,你才有徽章。打开 Token Forest,点开菜单,在「🏆 排行榜」下把它切到「开启」。App 会弹一次窗,列出它将上传的确切内容——确认即可。在此之前,「徽章设置…」是灰的点不动,而且你的徽章只会显示一张通用的 Token Forest 图,而不是你的数据。
第 2 步 — 在 App 里打开徽章设置
在菜单里点开「🏆 排行榜」,然后选「徽章设置…」。

第 3 步 — 复制你的徽章
在「徽章设置」窗口里,点「复制我的排行榜徽章」。它会把一行 Markdown 复制到你的剪贴板——你自己的 ID 已经填好了,不用改任何东西。

第 4 步 — 粘进你的 GitHub 主页
- 在 GitHub 新建一个与你用户名完全同名的仓库(username/username)——这是你的专属「个人主页」仓库。它必须设为 Public(公开),否则 README 不会显示在你的主页上。建仓时勾选「Add a README」。
- 打开这个仓库的 README.md,把刚复制的那行粘进去,保存。
- 刷新你的 GitHub 主页——徽章就出现了,并随你的排行榜成绩自动更新。
你粘进去的那行长这样——App 会替你填好 ID:
[](https://tokenforest.com.au/en/leaderboard)
没显示你的数据?
- ✦显示的是一棵普通树而不是你的名字:排行榜没开,或你刚开还没同步(App 大约每 30 分钟同步一次)。开启、稍等,再刷新。
- ✦看起来是旧数据:图片会缓存约 10 分钟,好让 README 加载够快。下次再看就是最新数字了。
- ✦主页上什么都没出现:仓库名必须与你的用户名完全一致(username/username),必须是 Public(公开),并且带有 README。
隐私
徽章只显示你的展示昵称、树种、成长阶段、总 token 和排名——都是公开排行榜上本就可见、且只在你 opt-in 后才有的字段。它绝不暴露你的代码、prompt 或任何按时段的明细。你若退出排行榜,徽章会回退成一张通用的 Token Forest 图——已缓存的副本约 10 分钟内刷新。
常见问题
我需要 Token Forest 账号吗?
不需要账号,也不用登录。徽章绑定的是 App 已经保存在你设备上的匿名 ID——所以这一步只能在 App 里复制,而不是在本网站。
徽章能放到 GitHub README 以外的地方吗?
可以。它就是一个普通的图片网址,任何允许放图片的地方都能用——GitLab 的 README、个人网站、博客都行。那行 Markdown 只是同一张图对 GitHub 友好的写法。
为什么我的徽章显示的是一棵通用的树,而不是我的数据?
要么排行榜没开(去 App 里开启),要么你刚开还没同步,要么 ID 未被识别。那张通用图也正是陌生人看到的样子——所以它绝不会透露某个账号是否存在。
养一片值得炫耀的森林
Token Forest 把你花掉的 Claude Code 和 Codex token 变成一棵会生长的像素树,背后是一个全球排行榜。免费,支持 Windows 与 macOS。