oh-myusage：macOS 菜单栏 AI 用量监控

项目简介

oh-myusage 是一款面向 macOS 菜单栏的 AI 订阅、额度与账号状态控制台。它把官方订阅额度、模型使用窗口、第三方中转余额、本地桌面端账号状态和异常诊断统一放到菜单栏里，常驻运行、低打扰。

适合同时使用多个 AI 官方产品、依赖多个第三方中转站，或经常在 Codex / Claude 本地账号之间切换的用户。

主要功能

• 菜单栏状态驾驶舱：直接显示额度、百分比、余额、倒计时、刷新状态和异常状态；支持固定单模型、多模型轮换和多用量展示；提供低额度、鉴权失效、连续失败提醒；状态栏外观可跟随壁纸或强制深色 / 浅色。
• 官方订阅与本地账号：统一管理官方 Provider、本地桌面端会话和账号资料，支持 Codex / Claude OAuth 导入与账号槽位管理，支持 Codex 本地多账号识别、保存与切换，非当前账号的额度窗口和倒计时也会保留展示。
• 第三方中转账本：内置常见站点模板，减少手工填写接口路径与字段解析；支持余额通道、Token 通道、账号信息、有效期等字段；凭证策略支持 Manual Preferred、Browser Preferred、Browser Only；对认证失败、限流、端点配置错误、网络不可达给出可读诊断。
• 本地历史用量：读取 Codex、Claude、Kimi、Grok、Gemini 的本地使用记录，Cursor 优先使用 dashboard 用量事件并支持本地回退；缓存聚合结果，刷新失败时保留旧数据并标记缓存回退；不保存原始聊天内容。
• 更新与发布：支持由 GitHub Release 驱动的应用内更新检测与更新说明展示。

支持的服务

• 官方 / 本地桌面端：Codex、Claude、Gemini、GitHub Copilot、Cursor、Grok Bot、Windsurf、Grok
• 官方 / API 或网页来源：Kimi / Moonshot、DeepSeek、MiniMax、Xiaomi MiMo、Amp、Z.ai、OpenCode Go
• 官方 / 本地数据来源：JetBrains AI、Kiro
• 第三方中转模板：Generic New API（Bearer 或 Cookie）

完整说明见 docs/PROVIDERS.md。

安装与使用

1. 打开 Latest Release，下载 oh-myusage.dmg。
2. 打开 DMG，把 oh-myusage.app 拖入 Applications（不要从 DMG 内直接启动）。
3. 首次启动若被拦截，右键应用选择「打开」，在弹窗中再点「打开」（仅需一次）。
4. 如仍被拦截，到「系统设置 -> 隐私与安全性」点击「仍要打开」。

系统要求：macOS 14 或更高版本；当前通过 GitHub Releases 分发，非 App Store 安装包。

注意事项

• 发布构建使用 ad-hoc / 自签名代码签名，未使用 Apple Developer ID 签名，也未经 Apple 公证（notarization），Gatekeeper 首次打开提示无法消除。
• 覆盖升级后 macOS 可能将新版视为不同的代码主体，会再次弹出钥匙串访问确认，已保存的凭证可能需要重新授权或重新输入一次。
• 从浏览器自动续期登录态需要 Chrome、Arc、Edge 等 Chromium 系浏览器，Safari 与 Firefox 的登录读不出来；API 密钥被吊销、登录态锁在 App 自身数据里的站点（如 Windsurf、Amp、JetBrains、Kiro）仍需手动处理。
• 本地用量统计结合本地日志与可用的 Cursor dashboard，不等同于官方账单或剩余额度，部分结果会标记完整性。

本作品整理自 GitHub 开源项目 Four-JJJJ/oh-myusage，原作者 @Four-JJJJ，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。