中文 | English
你的 Codex 还可以跑多久？
Codex Runway 是一个原生 macOS 状态栏应用，帮你在菜单栏查看 Codex 配额、今日是否重置、reset credits、API 等价成本与本机会话，并支持多账号管理、安全切号与内置更新检测。
- 菜单栏查看 Codex 剩余额度。
- 查看 5 小时、每周和附加额度窗口。
- 查看今日速率限制是否已重置（项目自托管公开状态源），并可跳转到相关公开动态。
- 设置中可开关「今日是否重置」栏目，并单独配置其刷新间隔（默认开启、每 1 小时）。
- 管理多个 Codex 账号：浏览器登录、导入本机
auth.json、粘贴 token / JSON（含/auth/session）、导入文件或 API Key。 - 确认后安全切号，原子写回
~/.codex/auth.json，可选立即重启 Codex，使 CLI / IDE 同步。 - 显示当前账号、订阅类型与到期信息。
- 查看 reset credits 数量、状态和到期时间。
- 查看 API 等价成本与 token 用量：今日、本周期、上周期、本月或自定义范围；设置可改主弹窗默认范围。
- 主弹窗配额下方显示本年 token 用量图表（热力图 / 折线图 / 柱状图，每日 / 每周 / 累计），设置中可切换样式或关闭；默认热力图。
- 本机会话增量索引，加速成本扫描。
- 查看最近 Codex 会话、项目、状态和用量摘要。
- 修复本机会话索引。
- 支持浅色、深色、跟随系统和中英文界面。
- 支持内置更新检测。
从 GitHub Release 下载与你的 Mac 匹配的压缩包：
- Apple Silicon：
CodexRunway-macos-arm64.zip - Intel：
CodexRunway-macos-x86_64.zip
解压后把 CodexRunway.app 放到 Applications 或任意目录运行。
当前 Release 是 ad-hoc signed，未 notarized。首次打开如果提示“无法验证开发者”或“未经安全验证”，请右键点击 CodexRunway.app，选择“打开”，或在“系统设置 > 隐私与安全性”中点击“仍要打开”。
如果提示“CodexRunway.app 已损坏，无法打开。您应该将它移到废纸篓”，通常是下载隔离属性导致的。把 app 放入 Applications 后运行：
xattr -dr com.apple.quarantine /Applications/CodexRunway.app然后再次打开应用。
- macOS 12+
- 推荐已安装并使用过 Codex
- 可通过本机
~/.codex/auth.json导入，或在应用内添加账号（浏览器登录、粘贴凭据、导入文件等）
swift run CodexRunway自检命令：
swift run CodexRunway --self-check自检会输出本地诊断信息，token 会被 redacted。
- token 从本机
~/.codex/auth.json读取；多账号凭据仅保存在~/.codex-runway/accounts/<id>/auth.json（目录0700、文件0600）。账号索引index.json不含 token。 - 用户主动切号时，才会将选中凭据原子写回
~/.codex/auth.json，以便 Codex CLI / IDE 同步使用。 - 刷新非当前托管账号 token 时只更新账号库副本，不写官方
auth.json；刷新当前账号时同步官方 auth 与副本。 - 无效或 mock 凭据不会写回官方
~/.codex/auth.json。 - access token、refresh token、id token、API key 不会写入日志、README、issue 模板或自检输出。
- API 等价成本默认来自本机会话 JSONL 日志，并在
~/.codex-runway/下维护本地增量索引等派生数据；不上传会话内容。 - API 等价成本的在线用量只在本地没有可用 token 数据时作为补全。Token 图表的“官方统计（多端）”来自当前账号的官方资料统计，可能延迟或后续修订；“本机日志（全部本机会话）”扫描本机现有会话，历史记录可能跨账号。两者口径不同，不能视为包含关系或直接相减。
- 会话修复只处理
~/.codex/session_index.jsonl，写入前会创建备份，不删除会话文件。 - 「今日是否重置」只下载本项目发布的派生状态 JSON，不附带 Codex 账号、token 或本机会话内容。后台 AI 分析只检索公开 X 动态，不接收应用用户的数据。
- 更新检测只访问版本信息，不上传 Codex 账号或会话数据。
- 今日是否重置：状态来自本仓库监控任务发布的静态 feed（应用默认读取 codexreset.gitcdn.top/api/status.json）。后台使用 Grok 检索
@thsottiaux的公开动态并生成结构化事件，应用再按用户本地自然日计算结果。该结果由 AI 分析，非官方且仅供参考；定时任务和发布都是尽力运行，可能延迟或暂时不可用。 - 配额 / reset credits / Token 用量官方统计 / 部分在线用量：在你已登录的前提下，通过本机凭据访问官方 ChatGPT / Codex 后端接口；官方 Token 统计仅对应当前账号，并显示服务端统计截至日期。
- Token 用量本机日志 / API 等价成本 / 最近会话：默认基于本机
~/.codex会话日志与本地索引计算。本机历史日志没有可靠的账号归属，因此可能包含多个账号的数据。
npm test --prefix api/hasreset
swift test
swift build
swift build -c release服务源码位于 api/hasreset，定时发布由 .github/workflows/update-hasreset.yml 负责。部署自己的 fork 时：
- 在仓库的 Actions Secrets 中添加
GROK_API_BASE_URL、GROK_MODEL、GROK_API_KEY。Base URL 应为 HTTPS API 版本根路径，例如https://api.x.ai/v1；所选模型需支持 Responses API、X Search 和 Structured Outputs。可选设置GROK_USE_WS=true以改用 WebSocket（默认 HTTP）。 - 在 Settings > Actions > General > Workflow permissions 中允许
GITHUB_TOKEN读写仓库内容；无需创建 PAT。 - 在 Settings > Pages 中把 Source 设为 GitHub Actions。
- 手动运行一次 Update reset-today status workflow 完成首次发布，并检查 Pages 页面和
api/status.json。
workflow 在 UTC 每小时第 13 / 43 分钟各有一个触发槽（主槽 + 备份，错开整点高峰）；同一 UTC 小时内若已有成功 run，后续自动触发会跳过，因此完整监控每小时最多一次。不重试失败的上游请求；只有状态变化或每日心跳时才更新 orphan gh-pages 分支并部署 Pages。GitHub 的定时任务不是实时调度，仍可能延迟或丢失；也可用 workflow_dispatch 手动补跑，或用外部 cron 发 repository_dispatch（event_type=update-hasreset）保活。
此设计将 Actions 限制为低频、低负载的项目静态内容发布，不把它作为按请求执行的 serverless 服务。不要直接改成 5/15 分钟轮询、商业服务或通用 API；扩大频率或用途前应重新核对 GitHub 的 Actions 附加条款 与 Pages 限制，必要时联系 GitHub Support。
Grok 密钥和原始响应不会写入仓库、Pages 或日志；公开 feed 只包含派生事件、时间、来源链接和安全错误码，不包含完整动态正文。公开说明文字由事件类型映射为固定文案，不发布模型生成的自由文本。请勿在 workflow 调试输出中打印 Secrets。
贡献说明见 CONTRIBUTORS.md。
本项目遵循仓库中的 LICENSE。