一个 macOS 菜单栏应用，实时显示 Kimi Code 的剩余额度，并可选显示 OpenCode Go 或 Command Code 的额度（二选一，由配置切换）。

以 LSUIElement（accessory）模式运行：不占用 Dock，只在系统菜单栏显示一个状态图标和下拉菜单。

• 菜单栏图标显示 KIMI 与七天额度剩余百分比
• 下拉菜单显示：
  • Kimi Code：本周剩余百分比、5 小时滑动窗口剩余百分比、额度重置时间
  • OpenCode Go（可选）：5 小时 / 每周 / 每月剩余百分比、重置时间
  • Command Code（可选）：5 小时窗口 / 本周剩余（含重置时间）、本月剩余、本期已用金额、月度额度池、月重置时间
• 每 5 分钟自动刷新，点击菜单栏图标可手动刷新
• 刷新失败时保留旧数据，仅追加一行红点错误提示；OpenCode Go 失败后 3 秒自动重试一次
• 设置窗口：图形化编辑配置文件，保存后自动刷新额度
• 开机自启动（SMAppService）
• 单实例运行

• macOS 13.0+
• Swift 5.9+（Xcode 或 Command Line Tools）
• 有效的 Kimi Code API Key
• （可选）OpenCode Go workspace API Key，或 Command Code API Key

从 GitHub Releases 下载最新版的 .dmg，打开后将应用拖入「应用程序」文件夹。

注意：发布包使用临时签名，首次打开时如被 Gatekeeper 拦截，请在「系统设置 → 隐私与安全性」中允许运行。

git clone https://github.com/ijkzen/KimiQuotaBar.git
cd KimiQuotaBar

make build     # 编译
make package   # 打包成 .build/KimiQuotaBar.app
make install   # 安装到 /Applications（可能需要 sudo）

应用从 ~/.config/kimiquotabar/config.json 读取配置。每次刷新都会重读配置文件，修改后点击菜单中的「立即刷新」即可生效，无需重启应用。

{
  "kimi": {
    "api_key": "your_kimi_api_key"
  }
}

API Key 也可通过环境变量 KIMI_API_KEY 提供（兜底，优先级低于配置文件）。

OpenCode Go 提供官方额度接口 GET https://opencode.ai/zen/go/v1/usage，使用 workspace API Key 直查（只认 Bearer 鉴权），返回 5 小时 / 每周 / 每月三个窗口的已用百分比：

{
  "kimi": {
    "api_key": "your_kimi_api_key"
  },
  "opencode_go": {
    "api_key": "your_opencode_go_api_key"
  }
}

在 opencode.ai 的控制台创建 workspace API Key 即可。

Command Code 使用未文档化的 /alpha/* 私有 API，需要 Command Code API Key：

{
  "kimi": {
    "api_key": "your_kimi_api_key"
  },
  "command_code": {
    "api_key": "your_command_code_key"
  }
}

quota_provider 顶层字段决定菜单栏中次要额度区块显示哪个提供方：

{
  "quota_provider": "opencode_go"   // 或 "command_code"，默认 "opencode_go"
}

配置了对应的 API Key 但未设置 quota_provider 时，默认显示 OpenCode Go。

1. 运行应用后，菜单栏出现 KIMI 与剩余百分比图标
2. 点击图标查看详细额度信息，点击「立即刷新」手动更新
3. 点击「设置」打开设置窗口，可编辑全部配置字段（API Key 等敏感字段默认掩码，可切换明文）；保存后自动刷新额度
4. 点击「开机自启动」注册登录项（系统会弹出授权确认）
5. 点击「退出」关闭应用

Kimi Code 使用两种额度限制：

• 7 天周期额度：每周可用的总请求次数
• 5 小时滑动窗口：每 5 小时内可用的请求次数

状态栏图标始终显示 7 天周期额度 的剩余百分比，不随 quota_provider 切换改变。

确保已在 ~/.config/kimiquotabar/config.json 中配置 kimi.api_key，或设置环境变量 KIMI_API_KEY。

Kimi API Key 已过期或无效，请检查并更新。

API 响应结构偶尔会变化。应用已尽量将非必要字段设为可选，若仍出现解析错误，请点击「立即刷新」或重启应用。点击红点错误行可查看完整错误详情。

• 确认 opencode_go.api_key 正确；401 表示 Key 无效，403 表示该 Key 未购买 OpenCode Go 套餐
• 确认 Key 是在 opencode.ai 控制台创建的 workspace API Key

• API Key 只保存在你的 ~/.config/kimiquotabar/config.json（明文）或环境变量中，应用不会将其写入 Bundle 或上传到任何地方。
• 请保护该配置文件的权限（建议 chmod 600）。
• 网络请求只发送给：api.kimi.com、opencode.ai、api.commandcode.ai。

• Swift 5.9
• SwiftUI + AppKit（NSStatusBar）
• Swift Package Manager
• GitHub Actions（构建 + 发版）

欢迎提交 Issue 和 Pull Request，请阅读 CONTRIBUTING.md。

MIT