lizill/ai-meter

# AI Meter [English](./README.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) AI Meter 是一款 macOS 菜单栏应用，可让您一目了然地掌握本地 coding-agent 的使用情况。它通过 `ccusage` 读取使用数据，并在紧凑的仪表板中显示每个 agent 的剩余预算、使用周期和重置日期。

Claude Code、Codex、GitHub Copilot CLI 和 Gemini CLI 会被自动检测。为每个 agent 设置自定义预算和使用窗口，然后直接从菜单栏环形图中监控最活跃的 agent。 ## 环境要求 用于本地开发： - macOS - Node.js 20+ - `ccusage` 支持的本地使用数据 对于打包应用用户： - macOS - `ccusage` 支持的本地使用数据 - 无需安装 Node.js、npm 或 npx ## 运行 ``` npm install npm run dev ``` 默认情况下，该应用使用 Electron 的 Node 运行时运行内置的 `ccusage@20.0.14` 包，因此用户无需安装 Node、npm 或 npx。 ## 构建 要创建用于本地或受信任测试的打包应用，请使用安装了 Node.js 20 或更高版本的 macOS： ``` npm ci npm run build ``` 构建针对当前的 Mac 架构，并将以下产物写入 `dist/` 目录： - `AI Meter--.dmg` - `AI Meter--.zip` 本地构建使用 ad-hoc 签名，尚不适用于公开发布。公开发布需要 Developer ID 签名、hardened runtime、Apple notarization 以及 ticket stapling。详情请参阅[分发说明](./docs/DISTRIBUTION.md)。 ## 功能 - 菜单栏弹出式仪表板 - 菜单栏图标中最多可显示三个环形片段 - 自动检测 Claude、Codex、Copilot 和 Gemini - 每个 agent 的自定义限制 - 每个 agent 的自定义每周和每月使用周期，以及过去 7 天和日历周窗口 - 仅关注剩余预算的成本显示 - 可配置的刷新间隔 ## 生产环境说明 对于公开发布，请保持 `ccusage` 固定版本并打包在内。请参阅[分发说明](./docs/DISTRIBUTION.md)。 ## 许可证 AI Meter 采用 [MIT 许可证](./LICENSE)授权。第三方许可证声明可在 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) 中查看。

标签：AI辅助编程, Claude Code, Electron, GitHub Copilot, MITM代理, 数据可视化, 桌面应用, 用量监控, 自定义脚本