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