页视觉注释面

?studySet= 仅调旧 blank map 解析优先级，仍合并该文档所在全部 topic（topicFilteringApplied:false）。返回 parts[]（可读图像清单）与 blanks[]（逻辑留白，contentIds 指向图像）。mapBacked:false 为恢复项。

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

id*string

文档 bookmd5

index*string

PDF 页序（第一页=1，勿传留白虚拟页号）

studySet?string

仅调旧 blank map 解析优先级，仍合并全部 topic

curl -X GET "https://example.com/documents/string/pages/string/parts"

Empty

取页手写/留白合成图 GET

?maxEdge=64–4096 &studySet=。先读 parts 再按需取图，不逐页盲渲染。

读文档页文本 GET

?start=&end=（≤60 页/次）。start/end 与 prepare segments 同为 PDF 页序（第一页=1）。&blocks=1 变块探针（返回块清单 {index,text,label}，较慢，探 1-2 页）。读正文用它，不绕 prepare。