v0.2.0 论坛首发草稿
只有在 v0.2.0 tag 发布后，并且 GitHub Release、PyPI、GHCR image 和文档站都
通过 release checklist 后，再复制这份草稿发帖。
可复制主帖
我发布了 Codex Quota Monitor v0.2.0。它是一个自托管的小看板，面向已经在 CLIProxyAPI 后面跑 Codex OAuth 账号池的人。
它主要做一件事：把账号池里的 5h 和 weekly quota 折成 Plus 等价剩余容量，
告诉你池子现在还能不能继续接活。它也会展示账号健康、reset 时间、usage / stats
趋势、diagnostics、alerts，以及给 wrapper / agent 用的账号推荐接口。
适合这些场景：
- 你有多个 Codex OAuth 账号放在 CLIProxyAPI 后面；
- 你想在一个页面里看 quota、reset、账号健康和 live usage；
- 你想给 wrapper / agent 接
/api/v1/*、Prometheus metrics 或账号推荐； - 你想要 loopback-first 的自托管工具，而不是托管 analytics 服务。
两分钟看界面：
uv tool install codex-quota-monitor==0.2.0
cqm --demo
然后打开 http://127.0.0.1:4516/。Demo 模式用内置示例数据，不需要 CLIProxyAPI、management key 或 auth files。
连接已有本机 CLIProxyAPI management endpoint：
cqm \
--management-base-url http://127.0.0.1:8317 \
--management-key-file /path/to/management-key \
--gateway-health-url http://127.0.0.1:8317/healthz \
--auth-dir /path/to/auth-files
其它安装方式：
- Docker:
ghcr.io/xsyxnx/codex-quota-monitor:0.2.0 - Nix:
nix run github:xsyxnx/codex-quota-monitor/v0.2.0#codex-quota-monitor -- --help - NixOS module:
inputs.codexQuotaMonitor.nixosModules.default
链接：
- 项目：https://github.com/xsyxnx/codex-quota-monitor
- 文档：https://xsyxnx.github.io/codex-quota-monitor/
- Quick Start：https://xsyxnx.github.io/codex-quota-monitor/quick-start.html
- 安全自审计：https://xsyxnx.github.io/codex-quota-monitor/security-audit.html
安全边界和范围：
- 这个项目连接已有 CLIProxyAPI；不负责安装、升级或管理 CLIProxyAPI。
- 默认只监听
127.0.0.1；要给局域网或公网 tunnel 用，请先放到有鉴权的 reverse proxy 后面。 - 它不内置登录、RBAC、托管 analytics 或账号开通功能。
- 报 bug 时，最好带上安装方式、版本、部署形态和脱敏后的
cqm doctor输出。
反馈入口：