合并分支
Body {confirm:true, recursive?}。默认只合直接子卡；recursive:true 合整棵子树。dry-run 列 willMerge[]，先念给用户听。合不了的原样留树（notMergedCount）；摘要卡/子脑图根卡自动跳过（skipped）。整组可撤销。注意这是合并（对方消失），不是链接。
Body {confirm:true, recursive?}。默认只合直接子卡；recursive:true 合整棵子树。dry-run 列 willMerge[]，先念给用户听。合不了的原样留树（notMergedCount）；摘要卡/子脑图根卡自动跳过（skipped）。整组可撤销。注意这是合并（对方消失），不是链接。
Authorization
bearerAuth 安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。
In: header
Path Parameters
卡片 noteid
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/notes/string/merge-branch" \ -H "Content-Type: application/json" \ -d '{ "confirm": true }'原生图片挖空 POST
给已存在图片/PDF 摘录笔记增/替原生遮罩（highlight_pic.maskRects）。Body {coordinateSpace:normalized, operation:add|replace, masks:[{rect:{x,y,w,h},group?,flags?,isText?}](1..200), expectedSourceFingerprint, confirm?, expectedMaskFingerprint?}。须先读 batch-get，用 occlusionBaseContentPath 底图出候选并预览。真 dry-run（422 CONFIRM_REQUIRED + sourceFingerprint/maskFingerprint/映射数/旧复习卡警告）；指纹变了 409 IMAGE_SOURCE_CHANGED/OCCLUSION_CHANGED。persisted:true 才成功；已有复习卡为快照，不自动改写。
改正文 POST
Body 同改标题。对 kind:blank 的 texts[].noteid 用同一端点。改正文前判摘录卡（texts[].excerpt 任一 true，或 sourceAnchor.hasExcerpt；勿用 sourceAnchor.page 判 block 包）。摘录卡改文致文字与原书脱钩（回源不受影响），须告知用户。