这个项目能做什么

PokeTokenBar 是一款 macOS 菜单栏应用，它把你的 token 消耗变成一只宝可梦伙伴，从而将 AI 编程 token 用量游戏化。它通过直接读取本地日志来追踪 Claude Code、Codex、Gemini CLI、Antigravity、OpenCode、Hermes Agent、Cursor、Grok CLI、Copilot CLI、Kiro CLI、Pi Agent、omp 和 Aside 的用量——无需外部 CLI。 **核心机制：** - 🥚 **孵化**：你消耗的 token 会孵化一枚蛋，从中孵出第 1–5 世代的宝可梦（329 种可能初始形态），按官方捕获率加权——传说宝可梦很稀有（129 分之一）。每次孵化会随机获得 25 种性格之一，并有小概率出现 ✨ 闪光。 - ⚡ **进化**：持续编程会让你的宝可梦沿其真实进化树成长（1/2/3 阶段，可分支），每一步都有闪光庆祝。 - 🎓 **毕业与收集**：达到最终形态 + 阈值后，它会永久归档到你的宝可梦图鉴中（越稀有耗时越长：重度使用下普通约 3 天 → 传说约 24 天），随后会来一枚新蛋。 - 🍬 **神奇糖果**：填满 5 小时或每周用量限制即可获得神奇糖果，可在背包中花费来让当前宝可梦成长。 - 🛒 **商店**：你已使用的 token 可作为货币，用于购买神奇糖果、薄荷（重掷性格）、闪光护符（永久提高闪光概率）或蛋（宝可梦蛋、非普通蛋、稀有蛋）以重新开始。 **功能：** - **菜单栏**：今日总 token 数旁显示动态第 V 世代精灵图（紧凑格式，如 `200.7M`），可选显示费用或限制百分比。 - **桌面浮动宠物**：可将伙伴移到桌面上，任意大小（48–384px），支持悬停提示、点击打开、右键菜单和气泡限制提醒。 - **图鉴与捕获日志**：每个物种一个格子（每页 24 个，按图鉴编号排序，✨ 表示闪光），另有捕获日志，包含完整进化线、稀有度、性格和捕获日期。 - **官方限制**：追踪 Claude、Codex 和 Antigravity 的 5 小时/每周利用率，带重置倒计时和消耗速率预测。 - **按模型细分**：当多个模型共用同一会话日志时，Pi Agent 用量会归属到真实模型 ID。 - **设置**：菜单栏项目、刷新间隔（1–15 分钟或手动）、登录时启动、钥匙串退出选项、带阈值的限制提醒、伙伴通知，以及完整的 KO/EN/JA/ES/FR/PT/DE 界面和宝可梦名称。 - **成长难度**：可将阈值和商店价格从 10% 调整到 200%；已毕业进化线的孵化成长速度提高 2 倍。 - **每日图表**：紧凑的月度图表，显示每日 token（和费用）。 - **额外扫描文件夹**：可指向内置路径之外的日志（按提供商，支持通配符）。 - **claude.ai 会话密钥**：可选粘贴，以便在无钥匙串访问的情况下获取官方限制。 - **低电量模式**：菜单栏动画以省电质量继续运行。 - **应用内更新**：一键检查更新。 **支持的工具与追踪：** | 工具 | 追踪 | 官方限制 | |---|---|---| | Claude Code | 今日 · 5 小时区块 · 周 · 月 | ✅ 5 小时 / 每周 | | Codex | 今日 · 周 · 月 | ✅ 5 小时 / 每周 | | Gemini CLI | 今日 · 周 · 月 | — | | Antigravity | 今日 · 5 小时区块 · 周 · 月 | ✅ 5 小时 / 每周 | | OpenCode | 今日 · 5 小时区块 · 周 · 月 | — | | Hermes Agent | 今日 · 5 小时区块 · 周 · 月 | — | | Cursor | 今日 · 5 小时区块 · 周 · 月 | — | | Grok CLI | 今日 · 5 小时区块 · 周 · 月 | — | | Copilot CLI | 今日 · 5 小时区块 · 周 · 月 | — | | Kiro CLI | 今日 · 5 小时区块 · 周 · 月 | —（估算） | | Pi Agent | 今日 · 5 小时区块 · 周 · 月 | — | | omp (oh-my-pi) | 今日 · 5 小时区块 · 周 · 月 | — | | Aside | 今日 · 5 小时区块 · 周 · 月 | — | **数据来源：** 从各工具的标准路径读取本地日志（JSONL、SQLite 等），并使用 PokéAPI 获取物种/进化数据和精灵图（运行时获取，本地缓存）。官方限制使用非官方端点（Anthropic、codex app-server、Antigravity Google APIs），仅在手动刷新时访问钥匙串。 **隐私：** 设备优先——不上传用量数据。对外请求会发送到 12 个主机（PokéAPI、GitHub 精灵图、Anthropic、claude.ai、cursor.com、Google APIs、状态页、GitHub 更新检查），但绝不携带用量日志、提示词或项目路径。钥匙串为可选，且仅在手动刷新时读取。 **安装：** macOS 14+（Apple Silicon 或 Intel）。Homebrew cask（`brew install --cask chattymin/tap/poke-token-bar`）、手动下载 zip，或使用 Swift 6 从源码构建。采用临时/自签名，因此首次启动会出现 Gatekeeper 警告（可通过右键 → 打开或 `xattr -dr com.apple.quarantine` 清除）。 **许可证：** MIT（仅涵盖原始源代码；宝可梦素材未捆绑——运行时获取）。非官方、非商业的宝可梦粉丝项目。