額度星盤使用指南

將 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('Unsupported response schema')
    event = data.get('event')
    if event is not None and not isinstance(event, dict):
        raise ValueError('Invalid event field')
except HTTPError as error:
    error.close()
    message = 'Wait at least 60 seconds before retrying' if error.code == 429 else 'Retry later'
    raise SystemExit(f'HTTP {error.code}: {message}; a failed request does not mean no reset occurred.')
except (URLError, OSError, ValueError) as error:
    raise SystemExit(f'Read failed: {error}; reset status cannot be inferred from this failure.')

checked_text = data.get('source_checked_at')
try:
    checked = datetime.fromisoformat(checked_text.replace('Z', '+00:00'))
    if checked.tzinfo is None:
        raise ValueError('Source check time has no timezone')
    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('Source checked at: ', checked_text or 'unknown')
print('Source is healthy and fresh' if fresh else 'Source is unhealthy, unknown or stale: historical reference only')
if event is None:
    print('No record returned; this does not mean no reset occurred.')
else:
    print('Public announcement:')
    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('Original post or supporting source: ', link)
print('This is public information, not a check of your personal account quota.')

預期輸出為來源檢查時間、健康度判斷,以及公開事件欄位和原帖連結。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 官方產品。公開網頁與串接介面不讀取個人額度,不保證個人額度到帳,也不提供重置機率。

← 返回公開重置動態 · 接入文件(簡體中文) · 全部指南