AiGoodBro · AgentHub（2.5）

把额度、用量、重置消息和本机任务放在一页看清；需要时，让任务使用自己的 Codex 账号池。

AiGoodBro 是面向个人自用的 macOS AI 工作台。它集中查看 Codex 多账号、Claude 订阅、已连接 CLI 的额度与状态，统计 Token 用量，接收公开重置消息，并提供可选的本地反代。界面支持中文和 English，主页名称为 AgentHub。

[中文] | English

本页介绍 2.5.0（143）· 1011v2。本版集中修复反代控制通道、账号冷却恢复、规则保存与微信通知，保留现有定制。Token Monitor 0.68.0、TokScale 4.18.0 与 CLIProxyAPI 8.0.20 沿用 2.4 基线。安装包和演示视频见 GitHub Releases。

DMG（Apple Silicon） · ZIP 备用包 · 发布说明

宣传片与界面展示 · 1012v1： 中文原片（48 秒 MP4） · English（48 秒 MP4） · 英文展示源码 · 英文完整资料包（ZIP，含英文原视频）

英文展示页整理主界面巡游、重置倒计时、飞书／微信消息、屏幕边缘侧栏、反代浮窗和多账号卡片，并附可复现源码。

主界面 · 重置消息 · 反代 · 账号 · Claude · Token Monitor · 其他 CLI · 重置卡自动使用 · 邀请 · 微信 · 飞书 · 侧栏 · 任务占用 · 引导与更新 · 主题 · 下载与构建 · 源码与文档 · 实际软件截图

01 · 主界面：一页看清工作状态

它是做什么的： 主界面把最常用的状态集中起来：顶部是公告和重置消息，中央是已连接工具与推荐入口，下面是 Token 用量统计，底部是 Codex 账号、Claude 订阅和其他工具状态。公开公告、账号真实额度、用量统计和任务占用分开显示，避免把不同来源的数字混在一起。

怎么进入： 启动 AiGoodBro 后进入 AgentHub 主页；点击分区标题可展开或收起，账号区可在“卡片／列表”间切换，分区宽度和部分缩放设置会保存在本机。

图片说明： 前部配图取自宣传片演示界面，账号别名、额度与状态为脚本内容；实际软件截图集中展示在文末。

主界面上几个数字各自代表什么：

• 重置消息是公开消息源的公告和历史记录，不等于某个账号已经读到的官方额度。
• **可用点数（点）**是已读取账号的点数快照；**可用金额（美元）**由同一份点数按现有比例换算（1 美元 = 25 点），不是另一笔余额；未知值不写成 0。
• Token 总量、成本和趋势来自本机用量记录；成本是估算值，不是供应商账单。
• 账号卡片显示账号身份、5 小时／7 天窗口、重置时间、重置卡和任务占用；缺少可信返回时显示“—”或旧快照标记。

02 · 重置消息：先看公开公告，再核对账号

它是做什么的： “重置消息”用于接收和查看公开的额度重置公告，帮助判断最近是否出现新的重置、公告内容和待确认状态。它与账号额度读取分开，不能用公告替代账号核验，也不会因为看到公告就自动兑换重置卡。

怎么使用： 在主页的“重置消息”分区打开消息列表；“最近 3 条”用于快速浏览，展开后可查看公告来源、时间和状态。首次建立历史基线，之后只提示新消息；历史读取失败会保留已核验内容并标出缺口。

消息和账号数据的边界： 公开消息不会改写账号官方重置记录，不会改变参与调度、优先级或点数底线，也不会自动发送任务。若要执行重置卡，请使用下方的“重置卡自动使用”入口，并逐账号明确开启。

03 · 本机反代：把请求交给自己的账号队列

它是做什么的： 本地反代是一个可选的本机服务。兼容客户端把模型请求发到本机端点，AiGoodBro 再按照账号的参与状态、优先级、最后使用和保存顺序选择本人已经连接的账号。它适合个人账号池和本机任务，不是公共代理，也不提供账号或额度转售。

怎么开启：

1. 在 AiGoodBro 的反代面板手动点击“开启反代”；应用重启后不会自动启动。
2. 等待连接信息就绪，退出 Codex 后使用“接入桌面”重新启动并接入本机路由。已经运行的 Codex 进程不会自动改走反代。
3. 完成任务后在面板点击“停止反代”。关闭主窗口只会隐藏窗口；退出应用时会询问是否停止服务。

队列怎么工作： 参与、优先、最后使用和排序只影响新请求，并与账号页同步；Pro20x 默认最后使用，可调整。普通组暂时忙碌时先在原有时限内等待，不立即转用最后使用账号。额度不足或未参与的账号继续跳过；身份、冷却和额度检查保持。订阅额度先于点数，点数接续默认关闭，用户主动开启后才会在额度耗尽时进入点数档。忙碌或未知账号不会被当成额度耗尽。

运行中取消参与后，尚未准入的等待和重试会跳过该账号，已经接入的流式响应继续完成。网关拒绝、超时、取消和普通转发失败分别提示；HTTP 503 保留，不自动重连。2.5 把阻塞读取移出协作线程池，并保护断线回包；有明确来源的额度冷却，仅在核验更新的订阅额度后解除。来源不明的旧冷却，可停止反代后在对应账号下选择“清理旧版冷却…”，通过最新额度和身份核验、备份确认后清理，再手动重新开启反代。自定义 5 小时已用上限按保存值执行，规则摘要与编辑框保持一致。已确认退出的子进程清理租约时，忙碌锁最多短暂重试 3 次，并保护新的运行和仍活跃的子进程。历史“必须重启才恢复”的故障根因仍未完全确认，不能把本次修复写成永久稳定保证。

04 · Codex 账号：额度、重置卡和任务占用

它是做什么的： 账号区把多个 Codex 身份放在同一页，显示 5 小时／7 天额度、重置时间、点数、重置卡、最近到期时间和任务占用。卡片适合快速浏览，列表适合逐行调整；刷新、排序、备注、邀请和独立 CLI 入口保留。