/will-codex-quota-reset

name: will-codex-quota-reset
description: 查询 willcodexquotareset.com 的 Codex 配额重置预测，返回 forecast 中的重置概率（score 百分比）、距上次重置的天数与小时数、最近重置时间、是否已宣布重置和评分构成。当用户询问 Codex quota 是否会重置、重置概率、上次重置多久、Will Codex Quota Reset 网站预测或要求调用 /api/forecast 时使用；不用于查询用户个人账户的实际用量或官方配额余额。

Will Codex Quota Reset

通过只读公开接口获取预测，并把庞大的响应裁剪为可读的关键信息。

工作流

1. 运行：

   python3 scripts/fetch_forecast.py

2. 读取输出中的 `forecast`，至少向用户报告：

• `score`：重置概率，数值本身就是百分比，例如 `3` 表示 `3%`
• `daysSinceReset`：距上次确认重置的天数
• `hoursSinceReset`：距上次确认重置的小时数
• `latestResetAt`：最近一次确认重置时间
• `resetAnnounced`：当前是否存在已宣布的重置信号

3. 按以下格式简洁回答：

   Codex 配额重置概率：{score}%
   距上次重置：{daysSinceReset} 天（约 {hoursSinceReset} 小时）
   最近重置时间：{latestResetAt}
   已宣布重置：是/否
   评分依据：{breakdown}
   数据抓取时间：{fetchedAt}

4. 对 `hoursSinceReset` 最多保留两位小数。保留接口时间的 ISO 8601 原值；仅在用户要求时换算到本地时区。 5. 任一可选字段为 `null` 时回答“暂无数据”，不要把 `null` 当成 `0`；`score` 或两个时长字段缺失时按脚本错误停止。

可选操作

• 用户明确要求完整接口数据时，运行 `python3 scripts/fetch_forecast.py --raw`。
• 下游程序需要单行 JSON 时，添加 `--compact`。
• 网络环境不稳定时，用 `--retries N` 调整网络错误后的重试次数；默认重试一次。

Gotchas

• 这是第三方预测，不是 OpenAI 官方承诺，也不是用户账户的实际配额状态。回答中称为“预测概率”，不要称为“官方重置概率”。
• 不要发送浏览器的 ETag、Cookie、`sec-*` 或完整指纹请求头；接口只需要公开的 `Accept`、`Referer` 和普通 `User-Agent`。
• 网络失败、HTTP 非 2xx、JSON 无效或关键字段缺失时，直接报告脚本错误；不要猜测概率或沿用旧结果。
• 运行依赖只有 Python 3 标准库和可访问的 HTTPS 接口。若 `python3 --version` 失败或网络不可达，说明缺失条件并停止，不要临时安装第三方包。
• `daysSinceReset` 与 `hoursSinceReset` 都描述距同一次最近重置的时间，只是单位不同，不要把 `hoursSinceReset` 误写成“距上次充值”。