viberuler — 给 Vibe Coding 玩家的本地化基准计分板

项目简介

viberuler 是为 Vibe Coding 玩家打造的一款完全本地运行的开源命令行基准计分工具。安装只需一行 npx viberuler，它就会在几秒内扫描本机的 Claude Code、Codex、Antigravity 等编码 Agent 会话日志与 git 仓库，计算出一个叫做"VIBE SCORE"的综合得分，把你烧了多少 Token、每美元换回多少 Token、人写了几行代码（LoC）、连续 commit 了多少天、跑着多少个 Agent 等硬指标一次性摊开，最后输出一张"成绩单"和段位头衔。它默认零网络调用，所有数据在你机器上跑完即丢；想晒成绩再用 --submit 推送到全球排行榜 viberuler.dev，所有上传字段都会先打印出来让你确认。配套的 audit 子命令还能反向审计你的工具链，告诉你 MCP 工具、空读大文件、冷启动 prompt 吞噬了多少 Token，让"上下文到底被谁吃掉了"这件事从直觉变成可测。

核心功能

• VIBE SCORE 综合打分：组合 LoC、tokens、tokens/$、项目数、连续 commit 天数、成就点、Agent 数七项指标，对数压缩防巨鲸垄断，用 1000·log10(1+LoC/1000) + 500·log10(1+tokens/1M) + 800·效率百分位 + 300·log10(1+projects·10) + min(streak,365) + 50·achievements 计算。
• 七大段位头衔：从 Prompt Peasant 一路升到 Vibe Apprentice、Token Burner、Context Goblin、Ship Machine、GIGACHAD SHIPPER，最高是 Singularity Adjacent；没数据的就是 NPC (no vibes detected)。
• 十大成就解锁：Token Billionaire（10 亿 Token）、Free Tier Martyr（百万 Token / 不到 1 美元）、Cache Whisperer（90% 缓存命中）、Polyglot（5 种语言）、Monorepo Menace（单仓 10 万行）等可玩性拉满。
• 全球排行榜 + 共享卡片：--submit 通过 GitHub 登录后把脱敏聚合数据推到全球榜，生成"Vibe 测量证书"页面（含 9:16 竖版故事卡，一键分享到 Instagram/微信/X/LinkedIn/Bluesky）。
• Rig Audit 子命令：审计本机的"上下文浪费"——缓存命中率、冷启动 Token、子 agent 压缩率、超大读取占比、ghost token 实际收益与最重的 MCP 工具，给出可执行优化建议（不承诺节省百分比，只报告观察）。
• Vibe Wrapped 月度回顾：npx viberuler wrapped --month 2026-06 输出当月 Spotify Wrapped 风格总结，含最忙日、Top 语言、Claude Token / 成本。
• 隐私优先：默认零网络；--submit 只发十四个聚合字段（无路径、无仓库名、无 prompt、无代码）；--share 不发任何东西，只打印一个 URL 由你决定是否打开；不上传窗口标题、文件名、任何代码片段。

技术实现

viberuler 整体采用 Node.js + TypeScript 实现，发布为 npm 包 viberuler，执行入口位于 packages/cli/src/，主要模块包括 payload.ts（聚合数据上传前的 JSON 构造器，约 140 行公开源码可直接审计）、submit.ts（GitHub Device Flow 登录 + REST 推送）、扫描器（解析本地 Claude Code 与 Codex 会话日志、git log、commit 作者归属）、计分引擎（对数压缩公式 + 百分位计算）、分享卡片渲染（基于 Satori 的 SSR 9:16 PNG）、Vibe Wrapped 时间窗口切片器。Audit 子命令读取 Claude Code transcript 缓存文件，统计每次会话的冷启动 Token、子 agent 调用成本、缓存命中、单个工具调用 token 体量，并通过 A/B 时间窗口对比（audit --compare A..B）输出"观察值而非因果值"的诚实报告。所有 IO 全部本地完成，进程不监听任何 socket；唯一一次外部请求是用户显式触发 --submit（GitHub OAuth + POST）与 --market（OpenRouter 公开 model 价格目录 GET）。

快速上手

1. 运行扫描：npx viberuler（首次会扫描 $HOME 内所有 git 仓库与 Agent 日志，几秒内输出成绩单）。
2. 查看 JSON 输出：npx viberuler --json 给 Agent 友好的结构化结果。
3. 指定扫描目录：npx viberuler --scan-dir ~/code --since 2026-01-01 只看 2026 年以后的提交，可重复传多个 --scan-dir。
4. 加入排行榜：npx viberuler --submit → GitHub Device Flow 登录 → CLI 先打印将要上传的 JSON 让你看 → 确认后推送。
5. 审计工具链：npx viberuler audit 输出 cache economy / context amplification / cold context / dead MCP weight / ghost tokens 等诊断。
6. 生成月度回顾：npx viberuler wrapped --month 2026-06 输出当月 Wrapped 卡片。

适用人群

• Vibe Coding 重度玩家：每天泡在 Claude Code / Codex 里几个小时，想知道"我到底烧了多少、产了多少、值不值"的人
• AI 编码团队 Lead：想给团队一个相对客观的"AI 杠杆率"指标，但又不想用充满监视意味的屏幕录制软件
• 独立开发者与 OSS Maintainer：一个人维护多个仓库，需要看清哪些是真贡献、哪些是 Agent 生成
• 关注 Token 经济学的工程师：想量化 prompt 缓存、cold context、子 agent 等隐性成本，优化工作流
• MCP / Agent 工具作者：用 audit 子命令发现用户机器上"装了但一次没调用"的死重，找到产品改进方向

官方链接

• GitHub 仓库：https://github.com/master5d/viberuler
• npm 包：https://www.npmjs.com/package/viberuler
• 全球排行榜：https://viberuler.dev
• 方法学白皮书：METHODOLOGY.md（公式、价格表、归一化规则、免责声明）
• 隐私白皮书：PRIVACY.md
• Show HN 原帖：https://news.ycombinator.com/item?id=50009232
• 许可证：开源（仓库自带 LICENSE）