dsh-brain/docs/http-api.md

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