# HTTP 接口与状态语义 > 插件暴露的所有本地接口,以及回合结束状态如何映射为上报状态。 --- ## HTTP 接口 | 方法 | 路径 | 用途 | | --- | --- | --- | | GET | `/cloud-memory` | 配置页面 | | GET | `/cloud-memory/status` | 设置 + 上报计数 + 最近 50 条记录(令牌只返回掩码) | | PUT | `/cloud-memory/config` | 应用设置补丁(令牌留空表示不修改) | | POST | `/cloud-memory/login` | 账号密码登录,换取两个令牌并保存(密码不落盘) | | POST | `/cloud-memory/test` | 分别校验两个令牌(活动令牌用空载荷探测,鉴权先于载荷校验,返回 400 即代表令牌有效,不会写入记录) | | POST | `/cloud-memory/flush` | 立即补发待重试队列 | 写接口会校验同源 `Origin`,跨站请求返回 403。 ## 状态语义 `TurnEndReason.kind` → 上报状态: | kind | status | 说明 | | --- | --- | --- | | `completed` | `completed` | 正常结束;只有它计入热力图 | | `aborted` / `interrupted` / `blocked` | `cancelled` | 用户中断或被阻止 | | `error` / `max-tokens` | `failed` | 出错或超长截断 | | `forked` | 不上报 | fork 不算用户跑完的一轮,计入会让热力图虚高 |