将重置信号接入你的工具

读取公开公告、重置卡发放消息与来源链接。用熟悉的 HTTP 请求，把这些信息带进脚本、看板或 AI 工作流。

匿名读取 · 无需 API KeyJSON · API v1HTTP API · GET / HEAD

快速接入

先读取最近更新的一条事件，无需注册或鉴权请求头。示例使用线上地址；本地同源调用可使用相对路径。JavaScript 可在支持 fetch 的运行时执行；网页前端跨站调用还需目标服务允许 CORS。

curl -fsS 'https://www.starshoreai.com/quota-orbit/api/v1/latest.json'

const response = await fetch(
  'https://www.starshoreai.com/quota-orbit/api/v1/latest.json'
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
// 先检查来源健康度，再使用公告；空记录不是重置结论。
console.log(data.source_healthy, data.event);

import json
from urllib.request import urlopen

url = 'https://www.starshoreai.com/quota-orbit/api/v1/latest.json'
with urlopen(url, timeout=15) as response:
    data = json.load(response)
print(data['source_healthy'], data['event'])

公告描述的是公开消息，不包含个人额度。即使 state 为 completed，也不能据此保证你的账号已经到账。

接口与分页

GET/api/v1/latest.json ↗

最近更新的公开事件；没有记录时 event 为 null。

GET/api/v1/events.json ↗

每页最多 20 条事件，附带统计、覆盖范围与下一页地址。

从 api/v1/events.json 开始读取。
将返回的 next 相对于站点前缀 https://www.starshoreai.com/quota-orbit/ 解析。
重复读取，直到 next 为 null。分页期间数据可能更新，按 event_id 去重。

当前不支持自定义查询参数；请使用响应提供的分页链接。

字段参考

所有时间使用 ISO 8601 UTC 字符串。null 表示未知或不适用，不等同于零。

字段	含义与使用方式
`schema_version`	固定为 1。升级时按版本处理。
`event_id / root_id / revision`	主帖标识及内容版本。补充回复合并到主帖；按 event_id 去重，revision 变化时更新。
`type / state`	type：reset / credit。state：scheduled / announced / completed / cancelled / unconfirmed。completed 仅表示公开公告宣布完成。
`scope / scope_verified`	global / paid / plus-pro-business / unknown。scope_verified 只有显式核验时才为 true。
`published_at / updated_at`	公告发布时间 / 最新补充时间，均为 ISO 8601 UTC；未知为 null。
`effective_at`	明确记录的实际发生时间，通常未知。不要用发布时间补填。
`window_start / window_end / expected_at`	分别为开始、截止、预计时刻；只有截止不补造起点，取消或未知修订会清除旧预计时间。
`time_kind / original_timezone`	window / deadline / start / expected / null。保留原帖时区；PST 为 UTC−8，PT 按洛杉矶夏令时换算。
`source_urls / provenance`	原帖和补充来源链接；区分公开转录与历史补录。
`source_healthy / source_checked_at`	来源是否健康、最近检查时间。失败或超过 30 分钟时，仅供回看。
`generated_at`	这份数据的生成时间，不是事件发生时间。
`coverage / stats`	complete_history 为 false；间隔统计只采用已核验实际时间与连续覆盖的相邻全局事件，样本不足为 null。

返回结构

以下是字段节选，用于说明结构，不代表当前实时状态。更多字段请读取接口。

JSON · 列表结构节选

{
  "schema_version": 1,
  "source_healthy": false,
  "coverage": { "complete_history": false },
  "events": [],
  "total": 0,
  "next": null
}

历史不完整。间隔统计只采用已核验范围、实际发生时间与连续覆盖的相邻全局事件。样本不足时返回 null，不补成 0。

刷新、缓存与错误

建议每 60 秒或更慢读取一次，缓存 60 秒。支持 ETag / If-None-Match 与 304；倒计时在客户端计算。请求只读取已有数据，不触发上游采集或 AI。

响应或状态	建议处理
`304`	继续使用已有缓存。
`404`	确认请求路径，分页跟随 next。
`429`	至少等待 60 秒，并逐步退避。生产按网络地址限速：平均每秒 2 次，允许 10 次短暂突发。
`5xx / 无效 JSON`	保留旧数据并标记过期，不能解释为“没有重置”。
`source_healthy=false` 或超过 30 分钟	仅供回看，等待恢复后再判断当前状态。

本地预览不模拟生产限流。接口不承诺完整历史、秒级采集或个人账号状态。

RSS 订阅

将订阅地址添加到支持 RSS 2.0 的阅读器，跟踪最近 20 条公开事件。每条包含状态、类型、时间与原帖链接。

RSS 订阅地址

./rss.xml

打开订阅源 ↗

复制上方订阅地址，添加到你的 RSS 阅读器。修订保留同一条目身份，阅读器是否再次提醒取决于它的设置。来源异常时仍可回看旧条目，不代表今天没有重置。

Skill 技能包

适合已经能执行 HTTP 请求的 AI 工具。技能说明会引导它查询公告、保留来源，并区分预告、完成和过期数据。

下载 quota-orbit 技能包 ↓ · 查看技能内容 ↗

下载并解压，保留 quota-orbit/SKILL.md 结构。
将 quota-orbit 文件夹放入客户端支持的技能目录；具体位置以客户端说明为准。
让 AI 使用这个技能查询“最近一次公开重置消息是什么？请附原帖”。

需要支持 Agent Skills 的客户端与联网能力，无需 API Key。技能包不会自动安装到你的工具，也不会替你开启通知。

MCP 工具服务

为 AI 提供两个只读工具：latest_reset_signal 查询最新更新，list_reset_signals 按页读取历史。返回来源链接和数据新鲜度。

下载 MCP 本地服务包 ↓

远程 MCP 接入

在支持 Streamable HTTP 的客户端添加以下服务地址，无需 API Key：

Streamable HTTP · HTTPS

https://www.starshoreai.com/quota-orbit/mcp

本地 stdio 接入

需要 Python 3.10 或更新版本。解压后进入目录，创建独立环境并安装包内依赖：

macOS / Linux

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

在支持本地 MCP 的客户端添加配置，先把下面的路径换成真实解压目录：

客户端配置示例

{
  "mcpServers": {
    "quota-orbit": {
      "command": "/absolute/path/quota-orbit-mcp/.venv/bin/python",
      "args": ["/absolute/path/quota-orbit-mcp/mcp_server.py"]
    }
  }
}

Windows 请将 command 换成虚拟环境中的 Scripts/python.exe。只支持远程 MCP 的客户端，请使用上方 HTTPS 地址。

本机 HTTP 调试

Streamable HTTP

.venv/bin/python mcp_server.py --http --port 8798

启动后，本机客户端连接 http://127.0.0.1:8798/mcp。这是本机调试地址；远程客户端使用上方 HTTPS 地址。

采用官方 MCP SDK，缓存 60 秒；源不可用时返回错误或标记过期的缓存。无账号、密钥、LLM 调用或写操作。最新更新不一定是完成公告，公告完成不代表个人到账。