v2.2 · 深/浅双主题监控台，一屏看完 9 个 AI 编程工具/API 渠道的配额、token 用量和费用： Claude Code / Codex / Kimi Code / DeepSeek / OpenRouter / Grok / Cursor / Antigravity / Gemini API。
纯前端 vanilla HTML/CSS/JS（ES modules），无构建步骤、无外部依赖、无 CDN；本地 server 只用 Node 内置模块，零 npm 依赖。数据全部读取你本机已有的 CLI 凭证/日志，不上传任何数据。
产品原型借鉴自公众号「杂谈by立行」文章 《人生的塞尔达时期：日均40亿Token的那一周》， 供开发学习和自用。
一键分享卡：
1. 前置条件：Node ≥18。
2. 克隆并启动：
git clone https://github.com/isalicema/api-usage-board.git
cd api-usage-board
./serve.command浏览器打开 http://127.0.0.1:8177。
3. 看懂第一屏：你电脑上装了哪个 AI 工具，对应渠道就自动亮起——这些工具登录后都会 在本地留一份凭证文件，这个 dashboard 只是读它们，不需要你额外配置。没装的渠道显示灰色 「未配置」/「未运行」，不影响其他渠道，不需要凑齐 9 个才能用。
4.（可选）配置 OpenRouter：唯一一个需要手动配置的渠道（不是本地 CLI 工具）。 Dashboard 页面 OpenRouter 卡片未配置时会显示「未配置 key → 如何获取 key」，点一下就有 分步说明。不用的话直接忽略。
5.（可选）设置订阅套餐：切到「Token 用量」tab 底部「费用预估与套餐回报」面板， 每个渠道套餐旁边是下拉选择框，选完立刻生效，不需要手改配置文件。
不想每次都手动开终端，可以用 macOS 快捷指令 App 做一个开机自启/桌面一键启动：
新建快捷指令 →「运行 Shell 脚本」操作，内容：
nohup "/path/to/api-usage-board/serve.command" >/dev/null 2>&1 &必须 nohup ... & 后台化：快捷指令会等脚本退出才算完成，serve.command 里的 server 是
常驻前台进程，不后台化的话快捷指令会一直转圈、且脚本被回收时 server 也会被带走。
（可选）把该快捷指令加到登录项，实现开机自启。
服务已经在跑的时候重复运行没关系，serve.command 会先探测 8177 端口，占用了就只打开
浏览器页面，不会重复起一个 server。
- Dashboard：每渠道配额进度条 + 用尽预警横幅（按消耗速度外推还有多久用尽）+ 状态徽标 （ONLINE / STALE / OFFLINE / NO KEY / 未运行）
- Token 用量：今日概览、一年视图热力图、趋势堆叠图、Coding Agent / 模型 / 项目三个 分布面板、费用预估与订阅 ROI
- 深/浅主题切换、server 没起时自动回退示意数据（不会白屏）
| 文件 | 内容 | 说明 |
|---|---|---|
server/.env |
OPENROUTER_MANAGEMENT_KEY=sk-or-... |
cp server/.env.example server/.env 后填真实 key，建议 chmod 600 server/.env |
server/config.json |
projectAliases / modelPrices / subscriptions / cnyUsdRate |
mtime 热加载，改完不用重启。subscriptions 可以在页面上选，不用手改文件；projectAliases/modelPrices 仍需手改，modelPrices 是占位刊例价，请按官方价格页核实 |
- Claude/Codex 的配额直连走的是未公开接口（跟随官方客户端行为），可能随时漂移；都有降级链（直连失败→旧方案→offline），不会直接报错
- Antigravity 配额仍靠机会主义采集，凭证位置未定位，只有 agy 运行时才能查到，不跑则显示"未运行"；Token 用量已从本地会话库解析，跟 agy 是否运行无关（社区 PR #1 贡献）
- Grok 的 token 序列是上下文快照近似值，不是精确计量
- Cursor 没有本地干净日志，不进 Token 用量 tab
- Gemini API 没有官方用量查询接口，只能读客户端留在本地的会话记录：目前支持 Gemini CLI（API key 模式）和 OpenCode（Google provider）。自己写脚本直接调 API 的用量采集不到；费用按官方刊例价估算。两个数据源的格式依据官方源码实现，尚未经真实用户数据验证，欢迎反馈
- key/token 只进 server 进程内存，绝不出现在 API 响应、日志、前端里
- server 只绑
127.0.0.1；静态服务拒绝一切 dotfile 路径（server/.env经 HTTP 不可读） /api/*出错不透出内部细节
更详细的技术实现（各渠道具体接口/凭证路径、缓存策略、验证脚本）见 docs/ARCHITECTURE.md。
MIT
Made with Kimi K3 by Machiwhale Studio