这个项目能做什么

# QuotaBar QuotaBar 是一款轻量级、仅菜单栏的 macOS 14+ 工具，用于跟踪多个 AI 编程和聊天服务的剩余订阅配额。它为 **Cursor**、**ChatGPT**（Plus/Pro）、**GLM**（z.ai/BigModel）、**Grok**（消费级 SuperGrok）和 **OpenCode Go** 提供使用限额的可视化指示。该应用以状态栏中的深色胶囊形式低调运行，显示百分比和小型条形图，并配有紧凑弹窗用于详细的账户管理。 ## 主要功能 - **多服务支持**：使用各平台非官方但标准的用量端点，监控五个不同 AI 平台的配额使用情况。 - **菜单栏集成**：在 macOS 状态栏中显示单个图标及百分比指示。当剩余配额低于 25% 时，颜色变为橙色。 - **紧凑弹窗**：固定尺寸弹窗（320x360）为每个提供商或账户显示详细卡片。支持多账户滚动，并包含设置入口。 - **多账户管理**：支持 ChatGPT 和 OpenCode Go 的多个账户。用户可直接在弹窗中切换活动账户，状态栏会反映所选账户的使用情况。 - **本地凭据存储**：密钥安全存储在 macOS 钥匙串中。非密钥偏好设置保存在 `~/.config/quotabar/config.json`，权限受限（模式 0600）。 - **无遥测**：除从各提供商 API 获取必要的配额信息外，该应用不会向外部服务器发送任何使用数据或遥测信息。 - **注重隐私**：设计为非沙盒的 `LSUIElement`，以便读取本地文件（如 Cursor 的状态数据库）和处理浏览器 cookie，而无需复杂的授权。 ## 支持的提供商与方法 ### Cursor - 从本地 Cursor 应用数据库（`state.vscdb`）读取认证令牌，或接受粘贴的会话 cookie。 - 从 `cursor.com/api/usage-summary` 获取使用数据。 - 区分“Cursor 模型”和“其他模型”池。 ### ChatGPT（Plus / Pro） - 通过 Codex CLI（`codex login`）或手动 cookie/JSON 输入支持多账户。 - 使用 `wham/usage` 端点获取会话、每周和每月限额。 - 如果 Codex CLI 可用，则使用公共 OAuth API 自动刷新过期令牌。 ### GLM（z.ai / BigModel） - 通过设置或环境变量接受 API 密钥。 - 支持全球（`api.z.ai`）和中国（`open.bigmodel.cn`）区域。 - 从监控 API 获取配额限制。 ### Grok（消费级 SuperGrok） - 从 Grok CLI 写入的 `~/.grok/auth.json` 读取认证信息，或接受粘贴的 OAuth 令牌。 - 从 Grok CLI 代理 API 获取账单和使用数据。 - 专门针对消费级 SuperGrok 套餐，而非团队管理 API。 ### OpenCode Go - 通过存储在钥匙串中的 API 密钥支持多账户。 - 从 `opencode.ai/zen/go/v1/usage` 获取使用情况。 - 将“已用”百分比转换为“剩余”百分比以进行显示。 ## 安装 推荐的安装方式是通过 Homebrew： ```bash brew tap ttaatoo/quotabar https://github.com/ttaatoo/quotabar brew install --cask ttaatoo/quotabar/quotabar ``` 如果 Gatekeeper 阻止了临时签名的应用，您可能需要运行： ```bash xattr -dr com.apple.quarantine /Applications/QuotaBar.app ``` 然后打开系统设置 > 隐私与安全性，点击 **仍要打开**。 ## 从源码构建 要求：macOS 14+、Xcode 15.4+（Swift 5.9+）。 ```bash git clone https://github.com/ttaatoo/quotabar.git cd quotabar open QuotaBar.xcodeproj ``` 在 Xcode 中运行项目，或通过命令行构建： ```bash xcodebuild -project QuotaBar.xcodeproj -scheme QuotaBar -configuration Release \ MARKETING_VERSION=0.0.13 CURRENT_PROJECT_VERSION=0.0.13 \ CODE_SIGN_IDENTITY="-" CODE_SIGNING_ALLOWED=YES CODE_SIGNING_REQUIRED=NO build ``` ## 免责声明 QuotaBar 是一款独立的非官方工具。它与可能随时更改的私有用量端点交互。它与 Cursor、OpenAI、z.ai、BigModel、xAI 或 OpenCode 无关联。用户需自行管理凭据，并了解使用非官方 API 的风险。