overflow

Overflow 作为一个已运行的服务提供于 overflow.nitjsefni.eu。用户使用 GitHub 登录，使用托管实例无需部署。仓库的设置指令是用于运行开发环境，而非使用该服务。 注册的公共 GitHub 仓库拥有一个开启目录（opening catalog）和一个实际目录（actual catalog）。注册会在仓库上创建目录标签并安装 webhook。赞助者为议题添加开启标签；在关闭议题的 pull request 最终提交之后且在合并之前，他们添加实际目录标签并发布一条命名该标签的评论。已结算的信用转移记录具有可审计的证明；目录的更改是版本化的，且不会重新定价已结算的工作。 登录成员可以阅读 Ledger、Issues、Settlements、Register a repository、Calibration 和 Rules 页面。该账本还支持使用 Overflow 颁发的 API 令牌进行程序化仓库注册。账户仍需通过浏览器 GitHub 登录手动注册。令牌在 Register a repository 页面生成，仅显示一次，以哈希形式存储，且可以重新生成（这将使之前的令牌失效）。POST /api/tokens 使用同源会话 cookie 铸造令牌；它要求 Origin 标头与 APP_URL 匹配，且请求体为空或 Content-Type 为 application/json。POST /api/repositories 接受 bearer 令牌以及包含 repositoryUrl、openingName、actualName、openingLabels 和 actualLabels 的 JSON；实际目录必须恰好包含涵盖 1 到 10 点的十个条目。错误使用包含代码和消息的 JSON 错误信封。PATCH /api/repositories 追加一个新的目录版本；该版本从更改时刻起生效，因此早期的证据窗口保留其记录的数值。 读取端点返回与页面渲染相同的 JSON：GET /api/dashboard，GET /api/issues（带有可选的 repository、openingLabel 和 claimState 过滤器），GET /api/settlements，GET /api/settlements/id 以及 GET /api/calibration。它们使用 bearer ovf_ 令牌或浏览器 cookie；读取操作没有原点检查且不接收请求体。响应范围限定在已验证的账户内；结算证明仅对该结算的参与方可见。当读取失败时，某些字段会降级为 null，且列表读取上限为最近的 200 行。 API 还通过 POST /api/mcp 作为 MCP 工具向代理框架开放。身份验证使用相同的 ovf_ 令牌。传输方式是无状态的可流式 HTTP：每次 POST 一个 JSON-RPC 请求，调用之间没有会话状态，initialize 回答协议版本 2025-06-18，且通知接收空的 HTTP 202。通过 MCP 进行的 Cookie 验证写入被拒绝，因为合成的内部调用缺乏用于同源防护的 Origin 标头。