CodeBar

必须用 Mac。 这是 Xcode 工程（CodeBar.xcodeproj，scheme CodeBar），没有 Package.swift，不能用 Swift Package Manager 安装，也不能在 Linux / Windows 上构建或运行。本仓库的 GitHub Actions 只在 macos-15 上做 xcodebuild 编译与脚本测试，不会启动 GUI。

多模块监控	Codex 用量	额度刷新通知

• 阿里云百炼：监控 Coding Plan 用量（账单月、5 小时、周）
• ZenMux：监控 Flow 用量（5 小时、7 天），支持按账号添加独立监控模块
• 小米 MiMo：监控 Token 用量（月用量、总用量）
• Codex：自动读取 Codex CLI 的 ChatGPT OAuth 凭据，查询官方 5 小时 / 7 天订阅额度
• Gemini：自动读取 Gemini CLI 的 Google OAuth 凭据，查询官方 Code Assist 配额

想支持更多平台？欢迎提交 PR。

• 通过「添加模块」逐个添加供应商账号或凭据
• 每个模块可配置别名，方便区分个人、团队或项目账号
• 每个模块可独立选择是否监控、是否显示在菜单栏、是否显示在详情页
• 设置页支持拖动模块排序，详情页和菜单栏按模块顺序展示
• 菜单栏多模块展示支持「独立」和「轮播」两种模式
• 弹窗按模块独立展示用量、套餐、重置时间和额外信息
• 每个模块的配额周期可独立选择是否展示，以及是否展示剩余重置时间
• ZenMux 支持添加多个 Management API Key，每个账号都是一个独立模块
• ZenMux 展示账号用量和完整订阅信息（套餐、费用、单价、到期时间等）
• ZenMux 额度刷新通知（5 小时 / 7 天周期自动提醒）
• Codex 自动读取本机 Codex CLI OAuth，无需在 CodeBar 中配置 token
• Codex 支持可选代理请求 chatgpt.com/backend-api/wham/usage
• Gemini 自动读取本机 Gemini CLI OAuth，无需在 CodeBar 中配置 token
• Gemini 支持可选代理请求 Google Code Assist 配额接口
• 自动刷新（每 60 秒，带随机 jitter 避免风控）

Linux、GitHub ubuntu-* runner、Windows 都无法编译这个 app。CI 用的是 macos-15 + Xcode 16.x。

1. 前往 Releases 下载最新 CodeBar.dmg（当前最新 tag 为 v2.2.6）
2. 双击打开 DMG，将 CodeBar 拖到 Applications
3. 首次打开时 macOS 可能提示“无法验证开发者”或“已损坏”，这是因为 DMG 未经 Apple 公证。解决方法：
   • 打开「系统设置 → 隐私与安全性」，拉到最下方，点击「仍要打开」
   • 或在终端执行：

   xattr -cr /Applications/CodeBar.app

4. 启动后看菜单栏，不要在 Dock 里找图标

HTTPS 克隆（不要求配置 GitHub SSH key）：

git clone https://github.com/wayyoungboy/code_bar.git
cd code_bar

推荐：用 Xcode GUI

open CodeBar.xcodeproj

在 Xcode 里选 scheme CodeBar，destination 选 My Mac，然后 Run（⌘R）。第一次运行若弹出签名/开发者证书提示，选本地开发团队或改用下面的无签名命令行构建。

命令行 Debug 构建并启动：

xcodebuild -project CodeBar.xcodeproj \
  -scheme CodeBar \
  -configuration Debug \
  -destination 'generic/platform=macOS' \
  -derivedDataPath build \
  CODE_SIGN_IDENTITY="" \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGNING_ALLOWED=NO \
  ENABLE_USER_SCRIPT_SANDBOXING=NO \
  COMPILER_INDEX_STORE_ENABLE=NO \
  build

open build/Build/Products/Debug/CodeBar.app

Debug 构建会顺带跑 CodeBarTests/run_module_behavior_tests.sh（这是工程里的 Run Script build phase，不是 XCTest target，所以不要用 xcodebuild test）。脚本只在 CONFIGURATION=Debug 时执行。

产物路径：build/Build/Products/Debug/CodeBar.app。不要用不带 -derivedDataPath 的 xcodebuild，否则 .app 会落到 ~/Library/Developer/Xcode/DerivedData/，很难找。

也可以打无签名 Release 包：

./build.sh

build.sh 必须在 Mac 的交互式终端里跑：它会 read 询问是否打开构建目录、是否创建 DMG。非交互环境（CI、管道）会卡住。脚本内部同样关闭 code signing，产物在 build/Build/Products/Release/CodeBar.app。CI 发版不走这个脚本：推送 v* tag 会触发 .github/workflows/release.yml，在 macos-15 上 xcodebuild、adhoc codesign、打 CodeBar.dmg 并上传 Release。

1. 运行应用后，点击菜单栏的 CodeBar 图标（没有 Dock 图标是正常的）
2. 点击设置按钮（齿轮图标）
3. 点击「添加模块」，选择供应商并填写该模块需要的凭据
4. 保存后，可在模块列表中切换「监控」「bar栏」「详情页」
5. 拖动模块列表调整展示顺序
6. 进入模块编辑页，勾选需要展示的配额周期和重置时间

在设置界面点击「添加模块」，选择「阿里云百炼」，填入：

• Cookie：从浏览器复制的完整 Cookie 字符串
• Sec Token：从请求中复制的 sec_token 值
• 区域：选择 cn-beijing、cn-shanghai、cn-shenzhen 或 cn-hangzhou

获取步骤：

1. 登录 https://bailian.console.aliyun.com/
2. 打开开发者工具，切到 Network
3. 进入 Coding Plan 页面
4. 找到 api.json 请求
5. 从请求头复制 Cookie 和 sec_token

在设置界面点击「添加模块」，选择「ZenMux」。每个 ZenMux 账号对应一个独立模块，填入：

• 账号别名：用于区分项目、团队或个人账号
• Management API Key：从 ZenMux 管理页面复制的 Management API Key

注意：仅支持 Management API Key，标准 API Key 无效。

每个账号模块可以独立勾选是否展示 5 小时 / 7 天配额，以及是否展示对应重置时间。详情页中每个 ZenMux 账号会作为独立模块展示，不再按平台聚合。

ZenMux 5 小时或 7 天额度周期刷新时，CodeBar 可发送 macOS 系统通知。同一周期内不会重复提醒，设置界面可开关通知并发送测试通知。

在设置界面点击「添加模块」，选择「小米 MiMo」，填入：

• Service Token：浏览器 Cookie 中的 api-platform_serviceToken
• User ID：浏览器 Cookie 中的 userId

获取步骤：

1. 访问 https://platform.xiaomimimo.com/ 并登录
2. 打开开发者工具，切到 Application
3. 在 Cookies 中找到 platform.xiaomimimo.com
4. 复制 api-platform_serviceToken 和 userId

在设置界面点击「添加模块」，选择「Codex」。Codex 不需要在 CodeBar 中配置 token，CodeBar 会自动读取本机 Codex CLI 的 ChatGPT OAuth 文件凭据：~/.codex/auth.json。

要求：

• Codex CLI 已登录 ChatGPT
• auth_mode 为 chatgpt
• OAuth 凭据中存在 tokens.access_token

CodeBar 请求的官方接口：

GET https://chatgpt.com/backend-api/wham/usage

请求头与 Codex CLI / cc-switch 对齐：

Authorization: Bearer <access_token>
User-Agent: codex-cli
Accept: application/json
ChatGPT-Account-Id: <account_id>   # 如存在

支持展示：

• plan_type，例如 Pro
• 主 rate_limit 的 5 小时 / 7 天窗口
• additional_rate_limits
• credits
• spend_control
• rate_limit_reset_credits.available_count

如果直连 chatgpt.com 不稳定，可以在 Codex 模块中填写代理地址：

http://127.0.0.1:7890
socks5://127.0.0.1:7890

不配置代理时会直接请求，行为与 cc-switch 的默认模式一致。

在设置界面点击「添加模块」，选择「Gemini」。Gemini 不需要在 CodeBar 中配置 token，CodeBar 会自动读取本机 Gemini CLI 的 Google OAuth 文件凭据：~/.gemini/oauth_creds.json。

要求：

• Gemini CLI 已使用 Google OAuth 登录
• OAuth 凭据中存在 access_token
• 如果 access_token 过期，凭据中需要有 refresh_token 用于刷新

CodeBar 请求的官方接口与 cc-switch 对齐：

POST https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist
POST https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuota

支持展示：

• Gemini Pro
• Gemini Flash
• Gemini Flash Lite

如果直连 Google Code Assist 接口不稳定，可以在 Gemini 模块中填写代理地址：

http://127.0.0.1:7890
socks5://127.0.0.1:7890

当前可运行的应用是 Swift 菜单栏 app。仓库里还有旧 Go/Wails 残留，构建时不要用它们。

code_bar/
├── CodeBar.xcodeproj/             # 唯一构建入口（不是 SPM）
│   ├── project.pbxproj
│   └── xcshareddata/xcschemes/CodeBar.xcscheme
├── CodeBar/
│   ├── CodeBarApp.swift           # 应用入口、菜单栏和弹窗管理
│   ├── MenuBarView.swift          # 弹窗 UI
│   ├── IslandMode.swift           # 刘海 Island 展示
│   ├── IslandPanelController.swift
│   ├── SettingsWindow.swift       # 设置窗口
│   ├── UsageTracker.swift         # 用量追踪器
│   ├── Constants.swift
│   ├── CodeBarFileStore.swift     # ~/.code_bar 文件存储
│   ├── StatusBarIconRenderer.swift
│   ├── StatusBarUsagePresentation.swift
│   ├── UpdateChecker.swift
│   ├── Info.plist                 # 版本 2.2.6，LSUIElement
│   └── Providers/
│       ├── PlatformProvider.swift
│       ├── BailianProvider.swift
│       ├── ZenMuxProvider.swift
│       ├── MimoProvider.swift
│       ├── CodexProvider.swift
│       └── GeminiProvider.swift
├── CodeBarTests/                  # Debug 构建期脚本测试，不是 XCTest target
│   ├── ModuleBehaviorTests.swift
│   ├── TestNotifications.swift
│   └── run_module_behavior_tests.sh
├── .github/workflows/
│   ├── ci.yml                     # macos-15 xcodebuild Debug + 行为测试
│   └── release.yml                # 推送 v* tag 后打 DMG
├── build.sh                       # Mac 交互式 Release 打包
├── create_dmg.sh
├── frontend/                      # 遗留：旧 Go/Wails 前端产物，当前 app 不用
├── internal/tray/                 # 遗留：旧 Go tray，当前 app 不用
└── docs/

扩展 Provider 的步骤见 docs/developer-guide.md。仓库没有 Package.swift，不要运行 swift build / swift test。

xcodebuild -project CodeBar.xcodeproj \
  -scheme CodeBar \
  -configuration Debug \
  -destination 'generic/platform=macOS' \
  -derivedDataPath build \
  CODE_SIGN_IDENTITY="" \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGNING_ALLOWED=NO \
  ENABLE_USER_SCRIPT_SANDBOXING=NO \
  COMPILER_INDEX_STORE_ENABLE=NO \
  build

xcodebuild -project CodeBar.xcodeproj \
  -scheme CodeBar \
  -configuration Release \
  -destination 'generic/platform=macOS' \
  -derivedDataPath build \
  CODE_SIGN_IDENTITY="" \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGNING_ALLOWED=NO \
  ENABLE_USER_SCRIPT_SANDBOXING=NO \
  COMPILER_INDEX_STORE_ENABLE=NO \
  build

单独跑行为测试（同样需要 Mac 上的 swiftc / macOS SDK）：

CONFIGURATION=Debug CodeBarTests/run_module_behavior_tests.sh

CI 与此相同：.github/workflows/ci.yml 在 macos-15 上选 Xcode 16.x，关签名后 Debug xcodebuild，再跑同一脚本。它不能代替真机点开菜单栏。

1. 同步更新 CodeBar/Info.plist 的 CFBundleShortVersionString 和 project.pbxproj 的 MARKETING_VERSION
2. 提交版本变更
3. 创建并推送 tag：

git tag -a v2.2.6 -m "CodeBar v2.2.6"
git push origin v2.2.6

GitHub Actions（macos-15）会自动构建、adhoc 签名、创建 DMG 并上传到 GitHub Release。发版 runner 也必须是 Mac；本地 ./build.sh 只适合自己做安装包。

• CodeBar 自身配置存储在 ~/.code_bar/
• Codex OAuth 凭据只从 Codex CLI 已存在的位置读取，不复制 token 到 CodeBar 配置
• Gemini OAuth 凭据只从 Gemini CLI 已存在的位置读取，不复制 token 到 CodeBar 配置
• 不会上传或分享任何凭据信息
• 默认不写运行期请求、用量或凭据相关日志

项目中展示的平台 Logo 仅用于标识对应服务，相关商标和 Logo 归各自权利方所有。CodeBar 与阿里云、ZenMux、小米、OpenAI、Google 无官方从属、授权或背书关系。

• ZenMux Logo 来源：zenmux.ai
• Xiaomi / Mi Logo 来源：mi.com
• OpenAI / ChatGPT Logo 来源：chatgpt.com/codex
• Gemini Logo 来源：gstatic.com

如相关权利方希望调整或移除展示，请通过 Issue 联系。

MIT License - 详见 LICENSE

欢迎提交 Issue 和 Pull Request。请在 Mac + Xcode 15+ 上按上面的 xcodebuild 命令验证 Debug 构建；不要新增 Linux CI。改 UI 后需要在真机菜单栏里点一遍，Actions 编译通过不等于 GUI 可用。

• 阿里云百炼 — Code Plan 用量监控
• ZenMux — AI Coding 平台
• 小米 MiMo — AI 编程平台
• OpenAI Codex — Codex CLI / ChatGPT OAuth 用量