CodexPanel

把 Codex 额度、会员和 Token 日统计放进原生 macOS 面板与菜单栏。

下载最新版 · 安装说明 · 隐私说明 · 反馈问题

CodexPanel 是 AstroLeap 开发的开源原生 macOS 应用。它通过本机 Codex App Server 读取当前账户状态，不调用未公开的远程接口，也不会上传身份凭据。

• 当前版本：V0.4.0（2026007）
• 系统要求：macOS 26.0 或更高版本
• 支持架构：Apple Silicon（arm64）
• 开源协议：MIT
• 不支持 Intel / x86_64 Mac

截图全部使用内置演示数据（演示账户 / demo@example.com），不包含开发者或真实用户的姓名、邮箱、额度、Token 等个人信息。

特色

• 原生 macOS 26 界面：SwiftUI、NavigationSplitView、MenuBarExtra、Liquid Glass、SF Symbols。
• Dock 主窗口与常驻菜单栏共享同一份实时状态。
• 5 小时与周额度按窗口时长识别，显示剩余比例、已用比例、倒计时和精确恢复时间。
• 支持 Plus、Pro、API Key 及 Codex 返回的其他会员类型。
• Token 页面采用完整月历点阵，支持悬停或点击查看每日精确数量。
• Token 范围支持昨日、30 天、90 天和全部；范围只改变统计口径，不改变月历布局。
• 检测本地账号切换，清除旧账号快照后重新加载，避免串号数据。
• 菜单栏快速查看额度、官方日统计 Token、会员与可用重置次数。
• 前台、后台和 Token 历史刷新间隔均可自定义。
• GitHub Releases 自动更新：检查正式版、下载 ARM64 DMG、校验 SHA-256、验证签名和架构、替换应用并重新打开。
• 简体中文与英文跟随系统语言。
• 无第三方运行时依赖。

下载与安装

1. 打开 Releases。
2. 下载 CodexPanel-0.4.0-arm64.dmg。
3. 双击 DMG，把 CodexPanel 拖到右侧“应用程序”文件夹。
4. 从 Finder 的“应用程序”中打开 CodexPanel。

Release 同时提供 .sha256 文件，便于手动核对安装包完整性。

如果 macOS 提示无法验证开发者或未知来源

当前公开安装包使用 ad-hoc 签名，尚未使用 Apple Developer ID 公证。因此，从互联网下载后，macOS 可能阻止第一次直接打开。这不代表需要关闭系统安全功能。

推荐使用以下任一方式：

1. 在 Finder 的“应用程序”中右键点按 CodexPanel，选择“打开”，再在确认窗口中选择“打开”。
2. 如果仍被拦截，打开“系统设置” → “隐私与安全性”，在安全提示旁选择“仍要打开”，确认只允许这一个应用。

请不要全局关闭 Gatekeeper，也不要为了安装本应用开启“允许任何来源”。更完整的图文说明见 安装说明。

使用前准备

• 已安装 Codex App 或 Codex CLI。
• 已在 Codex App / CLI 中登录需要查看的账户。
• 首次启动按引导打开 Codex；CodexPanel 读到账户后会立即进入主面板，再在后台补齐额度与 Token 数据。

CodexPanel 依次查找：

1. 设置中选择的自定义 Codex 可执行文件。
2. /Applications/Codex.app/Contents/Resources/codex
3. /usr/local/bin/codex
4. /opt/homebrew/bin/codex
5. 当前 PATH

数据准确性

• 额度与账号来自本机官方 codex app-server。
• 5 小时与周额度根据 windowDurationMins 识别，不依赖字段顺序。
• Codex App Server 当前没有可验证的实时“今日 Token”正式字段。
• CodexPanel 不读取本机会话内容估算 Token，也不猜测今日数值。
• 概览和菜单栏优先显示昨天的官方日统计；若昨天未返回，则明确显示最近一个官方统计日期。
• 会员有效期来自本地登录令牌中的当前会员有效期，不宣称等同于下次扣费日。

自动更新

打开“设置” → “关于” → “检查更新”。CodexPanel 只读取本仓库的最新正式 GitHub Release：

1. 比较语义化版本号。
2. 选择名称匹配的 Apple Silicon DMG。
3. 下载并校验 GitHub Release 提供的 SHA-256。
4. 验证 DMG 内应用的代码签名与 ARM64 架构。
5. 备份并替换当前应用，然后自动重新打开。

如果当前应用所在目录不可写，CodexPanel 不会绕过系统权限，而会在 Finder 中显示下载的 DMG，供用户手动拖入“应用程序”。

隐私与安全

• 不展示、不缓存、不记录原始身份令牌。
• 只在内存中解析 ~/.codex/auth.json 的 JWT payload，以读取名称和会员有效期。
• 本地只缓存脱敏后的仪表盘快照。
• 不上传账号、额度、Token 统计或本机会话内容。
• App Sandbox 按设计关闭，以启动本机 Codex 并读取共享登录元数据。
• 额度重置必须在主窗口二次确认；自动化测试不会消耗真实重置次数。

详见 隐私说明。

从源码构建

需要 Xcode 26 或更高版本：

xcodebuild \
  -project CodexPanel.xcodeproj \
  -scheme CodexPanel \
  -destination 'platform=macOS,arch=arm64' \
  build

xcodebuild \
  -project CodexPanel.xcodeproj \
  -scheme CodexPanel \
  -destination 'platform=macOS,arch=arm64' \
  test

生成 DMG：

chmod +x Scripts/build-dmg.sh
Scripts/build-dmg.sh

项目结构

• CodexPanel/Services：App Server JSON-RPC、账户服务、GitHub 更新、元数据与缓存。
• CodexPanel/Stores：主窗口和菜单栏共享状态、刷新与账号切换处理。
• CodexPanel/Views：概览、Token 月历、账户、菜单栏、设置和首次引导。
• CodexPanelTests：Swift Testing 单元测试与假的 App Server。
• CodexPanelUITests：macOS UI 导航测试。
• Scripts：图标、DMG 背景与 ARM64 安装包生成。

参与贡献

欢迎提交 Issue 和 Pull Request。请先阅读 CONTRIBUTING.md 与 SECURITY.md。

品牌说明

CodexPanel 是 AstroLeap 开发的独立第三方工具，与 OpenAI 不存在隶属、授权、合作或背书关系。OpenAI、Codex、ChatGPT 及相关名称和标识归各自权利人所有，仅用于说明兼容性。

本项目不使用 OpenAI 官方 Logo 作为自身品牌，不包含、不复制、不分发 Codex 或其他 OpenAI 软件，只连接用户已经安装的官方本机 Codex App Server。

License

Copyright © 2026 AstroLeap. Released under the MIT License.