1.2 KiB
1.2 KiB
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 不算用户跑完的一轮,计入会让热力图虚高 |