看清额度、用量和任务占用；需要时，让本机任务使用自己的 Codex 账号池。
AiGoodBro 是面向个人自用的 macOS AI 工作台，汇总 Codex 多账号额度、Token 用量、本机 CLI 和公开重置消息，并提供可选的本地反代。界面支持中文和英文，主页名为 AgentHub。
中文 | English
当前 GitHub 公开安装版为 2.2 · 1006v3，内部更新版本 9.6.80 (130)。主页与菜单栏的累计 Token、估算成本共用同一份总计快照；包含异常退出修复、可查看更新内容的下载弹窗，以及新用户／老用户安装引导。可识别的新装或覆盖后，新用户走完整引导，老用户检查微信、飞书和新设置，保留原有配置。见使用说明和变更记录。
下载 Apple Silicon 安装包 · 更新内容与备用 ZIP
2026-10-09 从本机运行的 2.3.0 (137) 导出的主界面实机图；数值为当时快照。公开下载仍为 130。点击图片可查看原尺寸。
AiGoodBro，macOS 上的 AI 工作台，把账号、额度、任务和消息集中到一起。
- 多账号一页掌握：剩余额度、重置时间、任务占用，一页看完，随时知道哪个账号还能用。
- Token 消耗看得清：用量统计、热图、趋势和成本估算，快速了解哪些工具、模型用得最多。
- 多个工具一起管理：不光 Codex，Kimi、Grok、Claude Code 等已连接工具的额度与状态也能集中查看。内置 Token Monitor，其官方最新版支持 35+ 种工具的 Token 用量追踪、28+ 家提供方的额度检测。本版基于固定上游并选择性回移修复，具体已接通的额度见读取范围。
- 自己的账号池接请求：可开启本地反代，设置参与账号、优先级和调用顺序；账号页与反代面板同步调整。
- 邀请好友更省事：批量邀请好友、查看邀请状态和邀请点数，都能在工作台完成；奖励按官方条件发放。
- 重置卡到期不容易忘：最近到期时间直接展示，鼠标悬停查看全部明细；可按账号开启临期自动使用，默认提前 30 分钟，时间自行调整，减少忘记使用造成的过期浪费。
- 微信、飞书接收提醒：可配置额度、重置和重置卡消息；微信还支持查询状态、继续选定的 Codex 对话。
- 侧栏随叫随到：⌘I 唤出或隐藏，悬停展开详情，图钉一键固定；查看额度圆环、反代请求与账号状态，移动到侧栏条目时可获得触控板轻触反馈。
- 安装、更新有引导：新用户引导完整设置，老用户重点检查微信、飞书与新功能；更新弹窗展示变更内容，点击即可下载新版安装包，覆盖安装由用户完成。
- 界面按你的习惯来：支持中文、英文，多套明暗主题，卡片与列表切换，让信息清楚、操作顺手。
**减少忘记使用造成的重置卡过期浪费：**点击账号的重置卡数量、最近到期时间或信息按钮，打开「到期自动使用」设置。默认关闭，逐账号选择；默认提前 30 分钟，可自行调整。桌面账号通过已核验同身份的独立入口执行；缺少入口、任务状态不明或不空闲时暂停。应用须保持运行，结果不明时提示核对并阻止重发。详见功能边界。
**界面资料更新 · 1009v1：**旧版截图、合成图册和 HTML 设计稿已退出公开展示，现补充完整首页实机图和用户提供的侧栏局部截图。截至 2026-10-09，本机已核验的安装版为 2.3.0 (137)；该版及后续候选尚未公开发行。图中数据仅代表截图当时的状态；首页图来自本机 137，侧栏图未显示版本编号。见界面资料与版本范围。
首页查看各账号剩余额度、重置时间和任务占用；公开重置消息与账号实际额度分开显示。用量统计汇总 Token、模型和工具活动，费用是本机数据估算，不是供应商账单。
紧凑首页支持分区缩放、卡片与列表切换，重置消息两列共用可用宽度，并保存用户调整的比例。
Codex 独立 CLI 可使用各自的本机登录目录；其他工具按提供商能力读取。账号卡片和列表可以刷新额度、调整顺序、选择模型或启动独立 CLI。可读取范围与限制见账号与额度说明。
工作台会显示已连接工具的额度与状态，读取范围随工具和登录状态而异。ZCode 是桌面工具，不是 CLI；WorkBuddy 桌面额度目前不可读。Kimi CLI 页面显示上次快照，使用前请刷新确认。
执行状态与成果状态分开显示，保留剩余事项和原聊天入口。
用户提供的实机局部截图；账号状态、额度和点数为截图当时的数据。
侧栏贴在屏幕边缘，集中显示所选账号额度、Token 统计等项目；额度支持圆环、小鱼等样式。按 ⌘I 唤出或隐藏，悬停展开详情，拖动顶部调整位置，图钉可固定侧栏或将详情保持置顶。
悬停侧栏的反代条目，展开「反代状态」浮窗：查看运行状态、请求数和账号列表，各账号显示 5h / 7d 额度圆环、重置倒计时与点数余额，并提供「反代设置」入口。请求快照每分钟更新，额度来自最近一次读取；缺少额度时显示「—」。
指针进入或切换侧栏条目时，支持触感反馈的触控板会给出轻触反馈，让移动和定位更有手感。可在侧栏设置关闭「触控板轻触反馈」。
按引导登录官方工具或账号，再回到工作台查看连接状态；需要哪个工具时，再按需连接。
本地反代是可选的个人工具。兼容客户端把模型请求发到本机代理，再由 AiGoodBro 按参与状态、优先级和保存顺序选择本人已连接的账号。全部参与账号的可用订阅额度先于点数使用；当前 Desktop 账号在每个额度阶段最后尝试。
点数接续默认关闭；只有用户主动开启后，订阅额度用尽才会进入点数档。忙碌或未知状态不算额度用尽；点数底线用于请求间的账号轮换，不是单次请求的硬限额。
反代只转发推理请求。Codex Desktop 保留自己的 OpenAI 登录身份、每段对话的模型和推理强度；使用代理不改系统认证文件或全局配置。未退出并重新接入的现有 Codex 进程不会自动改走代理。
自己开启与停止：
- 在 AiGoodBro 中手动开启反代；应用重启后不会自动启动它。
- 先退出 Codex。反代成功启动且连接信息就绪后，“接入桌面”按钮才会出现；点击后重新启动 Codex 并使用本机路由。
- 工作完成后，在反代面板停用服务。关闭主窗口只会隐藏窗口；退出应用前会确认是否停止反代。停用后正常重新打开 Codex。
已开始输出的流式响应不会切换到另一个账号重放；请求结果不明时也不会自动再次发送，避免重复执行任务。反代开关和“接入桌面”入口的存在不等于真实端到端验收完成。
反代为个人自用场景设计，用于自己的账号和本机任务；本项目不提供账号、凭据共享、额度转售或公共代理服务。
个人微信通过腾讯官方 iLink 扫码连接，同一入口接收重置通知、查询缓存状态，并在明确开启后继续选定的 Codex 原聊天。项目工作台区分执行状态与成果状态，保留手动暂缓、取消、完成及剩余事项。普通展示不调用模型；手机收件与真实对话仍待验收。详见微信与项目工作台。
在设置的“外观”中选择配色，分别支持浅色和深色。默认灰保留原有中性界面；其他主题用统一的原生玻璃、颜色和渐变呈现，玻璃透明度与深度可调，系统“减少透明度”和“增强对比度”优先。
| 主题 | 视觉特点 |
|---|---|
| 默认灰 · Default | 中性灰背景与蓝紫强调色，保持默认选择。 |
| 液态键帽 · Liquid Keycap | 冷调蓝青，轻盈的玻璃层次。 |
| 青花瓷 · Blue & White Porcelain | 瓷白与钴蓝，清晰克制。 |
| 蒙特雷曙霞 · Monterey Dawn | 兰紫、粉色与黎明暖色。 |
| 千里江山 · A Thousand Li of Rivers | 青绿与矿物色。 |
| 敦煌飞天 · Dunhuang Apsara | 沙金、赭色与青绿。 |
| 故宫红墙 · Forbidden City Red | 红墙、金色与深色对照。 |
| 紫蓝流光 · Violet Glow | 默认蓝紫配色的独立玻璃背景变体。 |
| WAICY 流彩 | 粉红到橙色的三段渐变，借鉴工牌候选的色值。 |
主题仅提供色值；WAICY 主题没有复制品牌图形、工牌、吉祥物或字体，也不表示官方背书。
130 提供 macOS 13+ 的 Apple Silicon 安装包，采用本地 ad-hoc 签名，尚未 Apple 公证。更新弹窗展示版本与内容，点击下载后校验大小和 SHA256；打开安装包后由用户完成覆盖安装。下载不会自动退出应用或替换文件。
安装前等待任务结束并正常退出旧版，保留旧 App 与本机数据备份。新装与覆盖后的引导会检查微信、飞书和新功能。隔离测试及预览不代表真实重置卡兑换、微信／飞书送达或全局快捷键交互验收，详见本次验证与校验值。
源码与安装包对应 v9.6.80：
git clone --branch v9.6.80 https://github.com/BLACKIELF/AgentHub-AiGoodBro.git AiGoodBro-2.2
cd AiGoodBro-2.2源码构建要求 macOS、Go 1.26+ 和经 SHA256 校验的 Token Monitor v0.62.0 macOS 运行时；将 TOKEN_MONITOR_DESKTOP_RUNTIME 和 TOKEN_MONITOR_DESKTOP_DMG 指向对应官方输入，再运行 make build。本次不提供 Intel 或 Windows 安装包，既有 Windows 源码保留。历史安装记录见 114 发布记录。
功能设计借鉴了相关开源项目；实际直接复用或适配的代码与资源在下表列明，并保留对应许可证和版权声明。
| 项目 | 来源关系 |
|---|---|
| Tencent/openclaw-weixin 2.4.9 | iLink 协议与扫码流程的原生适配；MIT 声明保留，不安装 OpenClaw。 |
| codexU | 历史固定源码的二次开发与宿主适配：SwiftUI、额度、配色和 Windows 基础承接后由 AiGoodBro 维护。 |
| Token Monitor v0.62.0 | 基于固定上游源码的二次开发与原生集成：统计引擎、桌面看板、图表和资源随包保留，AiGoodBro 通过 bridge、hooks 和 Swift 外壳接入。v0.63 以后上游更新的适用性与本机已有零额度修复见本轮发布记录。 |
| Tokscale fork · 原项目 | 基于固定提交的二次开发与原生集成；统计采集基础和许可证随包保留，打包修订为 06a9f1625d5a505f01b39eff29f7be44a2c52188。 |
| CLIProxyAPI v8.0.2 | 固定上游代码的宿主适配：复用 SDK 调度、Codex 执行器和 Responses 处理器，并窄适配 v8.0.7 首帧前断流的 502/failover 行为；未升级整套依赖。 |
| Codex-Manager | 协议适配与静态研究参考；暖号请求结构与 SSE 完成规则独立实现，见 CodexAccountActions.swift。 |
| Hazmat wrapper 脚本 | 协议适配与静态研究参考：仅参考 CODEX_CLI_PATH 的 stdio wrapper 入口，未集成 Hazmat 沙箱或服务。 |
| BlackHole1/aswap v1.1.0 | X 帖子对应的 Claude 多账号 CLI/Chrome 资料隔离工具；协议适配与静态研究参考，未复制、未打包，也未接入 Codex、Feishu 或企业微信。 |
AiGoodBro 使用 MIT 许可证。第三方完整许可和版权文本见 Resources/THIRD_PARTY_NOTICES.txt、Companion/LocalProxy/LICENSE.CLIProxyAPI、Companion/LocalProxy/LICENSE.Hazmat 与 Companion/LocalProxy/THIRD-PARTY-NOTICES.txt。
详细使用说明 · 本机 CLI 额度范围 · 反代实现与验证记录 · 公开 130 发布记录 · 界面资料与版本范围 · 问题反馈 · 安全说明