额度星盘使用指南

把 Codex 公开重置消息接入工具:HTTP API、RSS 与 MCP

用公开 HTTP API、RSS 或 MCP 查询 Codex 重置公告,保留原帖、时间与来源健康度。提供标准库 Python 只读示例,无需 API Key,不提供个人账号额度。

最后核对:中文指南

选一个最短入口

只想在阅读器看消息,用 RSS;要接脚本或看板,用 HTTP API;想让支持 MCP 的 AI 工具查询,用远程 MCP。这些方式读取已有的公开消息,不会重置账号,也不提供个人剩余额度。

HTTP:运行一次只读 Python 查询

将下面代码保存为 check_codex_reset.py,在安装 Python 3.10 或更新版本的环境运行 python3 check_codex_reset.py。只使用 Python 标准库,不需要注册、API Key 或 Codex 账号凭据;它只读取一次已有数据,不建立轮询或订阅。

Python · 标准库 · 只读 GET
import json
from datetime import datetime, timezone
from urllib.error import HTTPError, URLError
from urllib.request import urlopen

url = 'https://www.starshoreai.com/quota-orbit/api/v1/latest.json'
try:
    with urlopen(url, timeout=15) as response:
        data = json.load(response)
    if not isinstance(data, dict) or data.get('schema_version') != 1:
        raise ValueError('不支持的返回结构')
    event = data.get('event')
    if event is not None and not isinstance(event, dict):
        raise ValueError('公告字段格式不正确')
except HTTPError as error:
    message = '至少等待 60 秒再重试' if error.code == 429 else '稍后重试'
    raise SystemExit(f'HTTP {error.code}:{message};失败不代表没有重置。')
except (URLError, OSError, ValueError) as error:
    raise SystemExit(f'读取失败:{error};不能据此判断是否重置。')

checked_text = data.get('source_checked_at')
try:
    checked = datetime.fromisoformat(checked_text.replace('Z', '+00:00'))
    if checked.tzinfo is None:
        raise ValueError('来源检查时间缺少时区')
    age = (datetime.now(timezone.utc) - checked).total_seconds()
    fresh = data.get('source_healthy') is True and 0 <= age <= 30 * 60
except (AttributeError, TypeError, ValueError, OverflowError):
    fresh = False

print('来源检查时间:', checked_text or '未知')
print('来源正常且未过期' if fresh else '来源异常、时间未知或已过期:仅供回看')
if event is None:
    print('没有返回记录;不代表没有发生重置。')
else:
    print('公开公告:')
    print(json.dumps(event, ensure_ascii=False, indent=2))
    links = event.get('source_urls')
    for link in links if isinstance(links, list) else []:
        if isinstance(link, str) and link.startswith('https://'):
            print('原帖或补充依据:', link)
print('这是公开消息,不是对个人账号额度的检测。')

预期输出是来源检查时间、健康度判断,以及公开事件字段和原帖链接。latest 表示最近更新的事件,不保证是一条完成公告;event: null 表示没有返回记录,不能据此推断今天不会重置。completed 也仅表示公开消息宣布完成。

来源不健康、检查时间未知或超过 30 分钟时,只供回看。读取失败应保留旧数据并标记过期,不能转换成“没有重置”。

需要更多记录时,再接分页与缓存

从事件列表地址开始,跟随响应的 next,直到它为 null。相对地址以 https://www.starshoreai.com/quota-orbit/ 为基准解析;按 event_id 去重,revision 变化时更新原记录。当前不支持自定义查询参数。

建议每 60 秒或更慢读取一次,并使用缓存。支持 ETag、If-None-Match 与 304。遇到 429 至少等待 60 秒并逐步退避。完整字段及错误处理见接入文档;上面的一次性示例不实现持久缓存或自动重试。

RSS:把地址加入阅读器

将 https://www.starshoreai.com/quota-orbit/rss.xml 添加到支持 RSS 2.0 的阅读器。正常读取后,应看到公开事件标题、时间、状态与原帖链接。

订阅源提供最近 20 条公开事件,不代表完整历史。条目修订保留同一身份;阅读器是否再次提醒,由它的刷新与通知设置决定。读取到旧条目不能证明来源当前正常。

MCP:让 AI 回答时保留原帖与时间

在支持 Streamable HTTP 的客户端中,按客户端说明新增远程 MCP 服务,地址为 https://www.starshoreai.com/quota-orbit/mcp,无需 API Key。

连接后检查是否出现 latest_reset_signal 和 list_reset_signals 两个只读工具,再发起一次查询:

查询最近更新的 Codex 公开重置消息,列出消息类型、状态、原帖链接和来源检查时间。来源异常或数据过期时明确说明;不要推断我的个人额度已经恢复。

结果应包含可核对的来源与数据新鲜度,不能只有“已重置”的一句结论。如果客户端不支持该传输方式,按文档中的本地 MCP 接入说明配置,不要把普通网页地址当成 MCP 连接。

来源与核对日期

以下公开资料于 2026-10-17 核对;账号和客户端的当前显示仍需在对应环境确认。

额度星盘是独立工具,非 OpenAI 官方产品。公开网页与接入接口不读取个人额度,不保证个人到账,也不提供重置概率。

← 返回公开重置动态 · 接入文档 · 全部指南