打学习集快照

Body {description}（不加 Agent: 前缀，服务端加）。无 confirm 门，发即执行。无变化时复用并回 created:false + warnings；旧服务端无 created 字段时须回读列表核对条数。批量写前必打。

Authorization

bearerAuth

AuthorizationBearer <token>

安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。

In: header

id*string

学习集 topicid

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?string

版本点说明，不加 Agent: 前缀

curl -X POST "https://example.com/study-sets/string/snapshots" \  -H "Content-Type: application/json" \  -d '{}'

Empty

打开学习集 POST

Body {bookmd5?}。不给即主文档；文档须本机有文件（否则 422 DOCUMENT_FILE_MISSING）。可临时打开非本集KERSEY（tempOpen:true）。异步跳转，事后 GET /context 对账。不改数据，无需 confirm。

文档目录 GET

返回 segments（字段名是 segments，不是 entries）+ hasToc + pageCount（pageCount 在离屏打开失败时可能为 0，以 pages 二分探末页为准）。