单文档同步对账
[?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。
[?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。
Authorization
bearerAuth 安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。
In: header
Path Parameters
文档 bookmd5
Query Parameters
=1 计算内容 hash（全文件扫描，大 PDF 慢）
Response Body
curl -X GET "https://example.com/documents/string/sync-status"读文档页文本 GET
?start=&end=（≤60 页/次）。start/end 与 prepare segments 同为 PDF 页序（第一页=1）。&blocks=1 变块探针（返回块清单 {index,text,label}，较慢，探 1-2 页）。读正文用它，不绕 prepare。
AI 目录标题候选 GET
?start=&end=（≤60 页/次硬上限）。每页渲染+OCR+版面模型，扫描件约 3s/页；服务端 45s 预算，超限返回部分 + truncated:true/nextStart/hint，按 hint 从 nextStart 续扫。并发上限 2（与 pages 共享），超限 429 SCAN_BUSY。返回 {page,text,height,anchor}（anchor 原样回带；height 为字号代理）。