codex-helper/README.md

Codex Helper

一个单容器运行的 Codex 账户用量仪表盘，支持每日 Token 历史、限额窗口、重置提醒、Telegram 查询菜单与 SMTP 邮件。

快速启动

docker compose up -d --build

打开 http://localhost:8080 创建管理员。初始化后在“设置中心”完成 Codex 设备码登录、Telegram 和 SMTP 配置。除监听端口与数据卷外，运行期设置均在前端管理。

首次初始化未设置安装码。不要在创建管理员前将端口暴露到不可信网络。

数据与备份

所有持久数据位于 Docker 卷的 /data。可在设置中心下载 SQLite 备份。完整恢复时停止容器，替换数据库及 secret.key、codex/ 后再启动；三者应一起备份。

数据边界

Codex app server 当前提供套餐类型、限额窗口、重置时间、累计及每日总 Token。它不提供调用次数、输入 Token、输出 Token、订阅价格或账单续期日，因此界面会将这些字段标记为不可用。

开发

前端与后端分别位于 frontend/ 和 backend/。启动两个开发进程：

cd frontend
npm install
npm run dev

cd backend
go run ./cmd/server

开发时将 DATA_DIR 指向可写目录，并确保 codex 在 PATH 中。生产环境建议使用 HTTPS 反向代理。