AI 目录标题候选
?start=&end=（≤60 页/次硬上限）。每页渲染+OCR+版面模型，扫描件约 3s/页；服务端 45s 预算，超限返回部分 + truncated:true/nextStart/hint，按 hint 从 nextStart 续扫。并发上限 2（与 pages 共享），超限 429 SCAN_BUSY。返回 {page,text,height,anchor}（anchor 原样回带；height 为字号代理）。
?start=&end=（≤60 页/次硬上限）。每页渲染+OCR+版面模型，扫描件约 3s/页；服务端 45s 预算，超限返回部分 + truncated:true/nextStart/hint，按 hint 从 nextStart 续扫。并发上限 2（与 pages 共享），超限 429 SCAN_BUSY。返回 {page,text,height,anchor}（anchor 原样回带；height 为字号代理）。
Authorization
bearerAuth 安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。
In: header
Path Parameters
文档 bookmd5
Query Parameters
起始页
结束页，单次 ≤60 页硬上限
Response Body
curl -X GET "https://example.com/documents/string/toc-candidates"单文档同步对账 GET
[?verifyHash=1]（默认不算 hash；verifyHash 会全文件扫描，大 PDF 慢）。以 state 为准：database_reference_without_document_mapping/waiting_for_icloud_download 且 hasLearningData判学习数据先行；library_record_only 勿称笔记已到；available_local_only 先看 expectedByCurrentSettings；verified_mismatch/icloud_error/mapped_but_not_materialized 才列异常。databaseQueryErrors 存在时为部分证据；全失败回 SYNC_DIAGNOSTIC_QUERY_FAILED。
导出文档扁平 PDF POST
Body {topicid(必填，定标注层), selectedPageNos(真实 PDF 页，省略=全书，空数组拒), includeRelatedBlankPages?=true}。留白页由 native 隐式带上，不计数、不入 selectedPageNos（拒绝 66000+ 虚拟页）。输出到外部导出根 DocumentExports。只建文件不改数据。若已有导出在跑 429 EXPORT_BUSY。