# 文档

- [简介](/docs): MarginNote 4 本地 Agent Bridge 完整 HTTP 接口文档（Bridge API v0.49 / 72 路由）
- 指南
  - [连接与鉴权发现](/docs/guide/auth-discovery): 同机发现、跨设备配对、开场对账三步
  - [标准工作流](/docs/guide/workflows): 拆书 prepare/submit、目录、整理、复习卡组的顺序与纪律
  - [错误处理与纪律](/docs/guide/errors): 状态码速查、confirm 门清单、鉴权与订阅
- 接口参考
  - [接口总览（72 路由）](/docs/reference/overview): 72 路由总表：方法、路径、Max 与 confirm 速查
  - [危险端点纪律](/docs/reference/dangerous-endpoints): submit、快照、安装辅助、界面状态、目录写入的 confirm 与调用纪律
  - [System / Setup](/docs/reference/system): 状态、能力清单、规程、上下文、安装与 MCP 通道
  - [Library](/docs/reference/library): 学习集的新建与列出、文档上传删除、文件夹
  - [Study Sets](/docs/reference/study-sets): 文档归属、脑图结构、快照删除、标签色板、脑图打印
  - [Documents](/docs/reference/documents): 目录、页文本、视觉注释面、AI 目录、定位、导出、同步对账
  - [Notes](/docs/reference/notes): 批量读卡、标签样式、移动复制删除、评论标题正文、合并折叠、挖空
  - [Decks](/docs/reference/decks): 复习卡组的创建、组卡管理与打开
  - [Bundles（拆书）](/docs/reference/bundles): 拆书任务包：prepare、轮询、submit、回执对账、discard
  - [Search / Snapshots / Sync / UI](/docs/reference/misc): 全库搜索、快照回退、旧同步诊断、界面状态

- **交互式 API**
- [运行时能力清单](/docs/system/get-capabilities): 返回实际注册的全部路由 {method,path,requiresMax}、presets/anchorModes/accessPolicy 等机器可读契约。能力边界以它为准。
- [用户此刻上下文](/docs/system/get-context): 只读。返回 studySet/currentPage/documents(含focused)/selectedNotes/focusedNote。currentPage.page 为 PDF 页序；blank 页用换算后的真实页。available:false 按 reason 回退，不重试。
- [运行时操作规程 Markdown](/docs/system/get-guide): 用现有 Bearer token 读取，与已加载 Skill 的 guideVersion/guideHash 比对，不一致则以返回为准。只读刷新，不轮换 token。
- [服务状态（免鉴权）](/docs/system/get-status): 唯一免 token 端点。返回 bridgeApiVersion/routeCount/apiFingerprint/guideVersion/guideHash/authorized。连通性判据只看它，不要用 lsof。
- [安装脚本（一次性码）](/docs/setup/get-install): GET /bridge/v1/install?code=xxx。code 10 分钟有效、只能用一次。成功返回 shell 安装脚本（写 token + 装 Skill）；失败 403 返回无效/过期提示脚本。
- [安装码相关](/docs/setup/post-install-code): 安装辅助路由，无 confirm 门，不轮换 token、不写 Skill 文件。具体语义以运行时 GET /guide 为准；刷新规程只读 GET /guide。
- [MCP 通道](/docs/setup/post-mcp): MCP 客户端接入点：claude mcp add --transport http marginnote http://127.0.0.1:{port}/bridge/v1/mcp --header "Authorization: Bearer $TOKEN"。工具仅 mn_guide（规程）与 mn_call（{method,path,body} 转发）。GET /mcp 未实现（501），以 POST 通道为准。
- [列文档文件夹](/docs/library/get-library-folders): ?path=&depth=。"" 为根。文件夹与学习集/标签互不影响，挪文件夹不破坏卡片。
- [列出学习集](/docs/library/get-library-study-sets): 返回学习集列表。不含复习卡组（卡组走 GET /decks）。支持 ?query= 过滤。
- [删除资料库文档（干净撤销）](/docs/library/post-library-documents-id-delete): 仅无卡片锚定该书时执行，否则 409 DOCUMENT_IN_USE。虚拟文档拒删。无回收站，删完回读自证（partial:true 即半删）。导入时自动建的空文档笔记本会留下。
- [上传文档进资料库](/docs/library/post-library-documents-upload): Body 为文件原始字节，参数走 query：?filename=必填&folder=可选&topicid=可选&confirm=1。filename 决定 MN 内名字；folder 为文档根相对路径；topicid 顺手绑集（以 addedToStudySet 为准）；confirm=1 必填（确认前已传完一遍，直接带最省流量）。同名不覆盖。无按本机路径导入。
- [新建空学习集](/docs/library/post-library-study-sets): Body {title, confirm:true}。返回 {topicid, isStudySet}，必须校验 isStudySet:true。空集含一张与集同名的根卡。
- [列学习集文档](/docs/studysets/get-study-sets-id-documents): 返回该集引用的文档（含 sourceState normal/missing_file、主文档信息）。
- [学习集标签树](/docs/studysets/get-study-sets-id-hashtags): 返回实际存储 hashtags[]、派生扁平 nodes[]、嵌套 tree[]。directCardCount 仅直存；cardCount 含后代；derived:true 为推导层。
- [学习集摘录色板](/docs/studysets/get-study-sets-id-note-palette): 返回恰好 16 项 {colorIndex(0-based),baseColor,displayColor(hex+rgba)}。source 为 default/study-set。拆书 [style:] 与 metadata 选色前必读，禁止硬编码颜色名。
- [学习集引用的文档笔记本](/docs/studysets/get-study-sets-id-notebooks): 返回该集引用了哪些文档笔记本。
- [列学习集快照](/docs/studysets/get-study-sets-id-snapshots): 版本点列表。复用语义注意：内容无变化时复用既有版本点。
- [列子脑图](/docs/studysets/get-study-sets-id-sub-maps): 每项 {noteid(根卡),title,cardCount,parentPath,depth}，顺序同 App。depth>0 为嵌套。
- [脑图树](/docs/studysets/get-study-sets-id-tree): 返回扁平 nodes[]（{noteid,parent,depth,childCount,…}），父子靠 parent 拼，非嵌套 children。subMapId 为归属标签（住在哪张子脑图里）。title 超 64 截断；完整内容走 batch-get。?root= 读单张子脑图。
- [删除学习集](/docs/studysets/post-study-sets-id-delete): 最重写动词。Body {expectedTitle(须与库中完全一致), confirm:true, keepHighlights?=true, keepSnapshotHistory?=true}。默认隐藏卡片+保留划线+自动打快照（preDeleteSnapshotId）。彻底清才传 false（不可恢复）。卡组删除走同一端点（keepHighlights:false 才真删干净）。
- [从学习集移除文档](/docs/studysets/post-study-sets-id-documents-id-delete): 对齐 App「从学习集中移除」。文档留库，但该书有锚卡片会失去回源（startpage 清空）。先不带 confirm 打一次看 details.notesLosingSource，告知用户后再 confirm。服务端自动打快照（preRemoveSnapshotId）。
- [给学习集加文档](/docs/studysets/post-study-sets-id-documents): Body {bookmd5, confirm:true}。文档须已在资料库。首加成主文档（becameMainDocument），再加为 addedToBooklist；重复加幂等 alreadyPresent。
- [按计划导出脑图 PDF](/docs/studysets/post-study-sets-id-mindmap-print-export): 推荐 Body {plan:<preview 保存的计划>, fileName?}。复用 pages[]/visibleDepth/visibleNoteIds。输出到外部导出根 MindMapExports。只建文件不改数据，无需 confirm。与文档导出共享 EXPORT_BUSY（429）。
- [脑图打印预览计划](/docs/studysets/post-study-sets-id-mindmap-print-preview): Body {mode:keepStructure|classic|cardFlow, densityValue?, rootNoteId?}。keepStructure 默认逐级打印；classic/densityValue=1 走旧兼容；cardFlow 密集卡片流。返回 schema mn.mindMapPrintPlan.v0，含 pageCountEstimate/pages[]/exportOptions/planFingerprint。分页以 native 为准，CLI 不自算。
- [打开学习集](/docs/studysets/post-study-sets-id-open): Body {bookmd5?}。不给即主文档；文档须本机有文件（否则 422 DOCUMENT_FILE_MISSING）。可临时打开非本集KERSEY（tempOpen:true）。异步跳转，事后 GET /context 对账。不改数据，无需 confirm。
- [打学习集快照](/docs/studysets/post-study-sets-id-snapshots): Body {description}（不加 Agent: 前缀，服务端加）。无 confirm 门，发即执行。无变化时复用并回 created:false + warnings；旧服务端无 created 字段时须回读列表核对条数。批量写前必打。
- [文档目录](/docs/documents/get-documents-id-outline): 返回 segments（字段名是 segments，不是 entries）+ hasToc + pageCount（pageCount 在离屏打开失败时可能为 0，以 pages 二分探末页为准）。
- [取页手写/留白合成图](/docs/documents/get-documents-id-pages-index-content-id): ?maxEdge=64–4096 &studySet=。先读 parts 再按需取图，不逐页盲渲染。
- [页视觉注释面](/docs/documents/get-documents-id-pages-index-parts): ?studySet= 仅调旧 blank map 解析优先级，仍合并该文档所在全部 topic（topicFilteringApplied:false）。返回 parts[]（可读图像清单）与 blanks[]（逻辑留白，contentIds 指向图像）。mapBacked:false 为恢复项。
- [读文档页文本](/docs/documents/get-documents-id-pages): ?start=&end=（≤60 页/次）。start/end 与 prepare segments 同为 PDF 页序（第一页=1）。&blocks=1 变块探针（返回块清单 {index,text,label}，较慢，探 1-2 页）。读正文用它，不绕 prepare。
- [单文档同步对账](/docs/documents/get-documents-id-sync-status): [?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。
- [AI 目录标题候选](/docs/documents/get-documents-id-toc-candidates): ?start=&end=（≤60 页/次硬上限）。每页渲染+OCR+版面模型，扫描件约 3s/页；服务端 45s 预算，超限返回部分 + truncated:true/nextStart/hint，按 hint 从 nextStart 续扫。并发上限 2（与 pages 共享），超限 429 SCAN_BUSY。返回 {page,text,height,anchor}（anchor 原样回带；height 为字号代理）。
- [导出文档扁平 PDF](/docs/documents/post-documents-id-export): Body {topicid(必填，定标注层), selectedPageNos(真实 PDF 页，省略=全书，空数组拒), includeRelatedBlankPages?=true}。留白页由 native 隐式带上，不计数、不入 selectedPageNos（拒绝 66000+ 虚拟页）。输出到外部导出根 DocumentExports。只建文件不改数据。若已有导出在跑 429 EXPORT_BUSY。
- [按原文找位置](/docs/documents/post-documents-id-locate): Body {text(逐字照抄), page(必填), navigate?}。返回 {found,page,matchedText,algorithm,score}，须核对 matchedText。no_match 多为改写原文；page_unreadable 为页不可读。navigate:true 仅滚动（不高亮），跨文档不跳（navigated:false + different_document_open）。
- [写 AI 目录 / 切回原始目录](/docs/documents/post-documents-id-toc): 写：{entries:[{title,page,level(0-7),anchor?}], confirm:true}，页码须递增，越级静默钳（adjustedLevels）。落 AI 目录位，原目录无损。回退：{useOriginal:true,confirm:true} 切回原始；{useAI:true,confirm:true} 切回 AI。快照救不了目录。真 dry-run（不带 confirm 回 422 + details.wouldWrite）。
- [读卡片二进制项](/docs/notes/get-notes-id-content-id): ?maxEdge=64–4096（默认 2048）&layers=composite|base(0.42 起，base 省旧 mask 位图，按 occlusionBaseContentPath 用)。摘录/插图/手写回合成图；音视频回原始二进制。MCP mn_call 中图片以 image 内容返回。
- [整卡渲染](/docs/notes/get-notes-id-render): ?format=png|pdf &width=320–1200。标题+文字+摘录图+插图+独立脑图手写的合成长图/PDF。超 3600 万像素拒绝。用于看整卡/视觉校对，不代批量文本读取。代价最高，按需用。
- [批量读卡](/docs/notes/post-notes-batch-get): Body {noteIds:[…]} ≤200/次。返回 texts[]（对象数组 {index,text,excerpt,noteid,kind}，index 0=卡正文，1..N=子笔记；稀疏，空留白 kind:blank 也返回）、parts[]（视觉顺序全量，含 contentPath/mimeType/ocrText；0.42 起图片遮挡项带 occlusion 与 occlusionBaseContentPath）、metadata{colorIndex,fillIndex}、hashtags/hashtagPaths。texts 为空先看 parts。
- [复制卡片分支](/docs/notes/post-notes-copy): Body {noteIds,targetParentNoteId,mode:reference|clone,confirm:true} 或批量 copies[]。复制所选根整棵分支（快照，不随源树后续调整同步）；祖先后代同选时后代 covered_by_selected_ancestor 跳过；≤50 根；目标须为已存在普通脑图卡；源不能是隐藏/复习卡。可跨集（源文档按规则加入目标集）。真 dry-run（422 + wouldCopy）。persisted:true 才成功。
- [删除卡片](/docs/notes/post-notes-delete): Body {noteIds(≤50，同集), confirm:true}，整批一撤销组。只删点名卡，子卡接到祖父（grandparent）或升顶层重排（topLevel）。合并子笔记随卡消失；虚拟卡断引用；闪卡复制体级联。回收站默认关，先打快照。逐卡展示标题+子卡去向获同意。outcome deleted/hidden 如实转告。真 dry-run（422 + wouldDelete/cards[]/totalCascadeDeleted/cascadesIntoStudySets）。
- [折叠/展开](/docs/notes/post-notes-fold): Body {noteIds(≤200), folded:true|false, confirm:true}，整批一撤销组。最轻写动词，只改视图。叶子无折叠语义（skipped no_children）。脑图开着时可能需重进才见。
- [写卡片 hashtag](/docs/notes/post-notes-hashtags): Body {noteIds(≤200), operation:add|remove|replace, hashtags(完整叶路径，如 #医学/心血管/心衰), includeDescendants?(仅 remove), confirm:true}。禁止用 text 接口伪造标签（422 HASHTAG_ROUTE_REQUIRED）。replace 空数组=清空（须展示获同意）。整批一撤销组，persisted:true 才成功。
- [删除评论](/docs/notes/post-notes-id-comments-index-delete): Body {expectedPrefix, confirm:true}。index 语义同改写。
- [改写评论](/docs/notes/post-notes-id-comments-index): Body {text, expectedPrefix(前 32 字), confirm:true}。index 取 batch-get texts[].index 的 1..N（0 为卡正文，传 0 422）。须先读最新，409 COMMENT_CHANGED 重读再来。
- [追加评论](/docs/notes/post-notes-id-comments): Body {text, confirm:true}。整条为 marginnote4app://note/… URL 时成真双链（生成式整理回链旧卡用此）。
- [定位到卡](/docs/notes/post-notes-id-focus): Body {topicid?}。多集引用同一卡时用 topicid 指定。走 MN URL scheme，与书架点击同路。会抢屏，仅用户要求时用。异步，事后 /context 对账。无 confirm。
- [折成子脑图 / 展回](/docs/notes/post-notes-id-fold-into-sub-map): Body {confirm:true} 折叠（须有子节点，否则 422 NO_CHILDREN）；{undo:true, confirm:true} 展回。
- [原生图片挖空](/docs/notes/post-notes-id-image-occlusions): 给已存在图片/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 才成功；已有复习卡为快照，不自动改写。
- [合并分支](/docs/notes/post-notes-id-merge-branch): Body {confirm:true, recursive?}。默认只合直接子卡；recursive:true 合整棵子树。dry-run 列 willMerge[]，先念给用户听。合不了的原样留树（notMergedCount）；摘要卡/子脑图根卡自动跳过（skipped）。整组可撤销。注意这是合并（对方消失），不是链接。
- [改正文](/docs/notes/post-notes-id-text): Body 同改标题。对 kind:blank 的 texts[].noteid 用同一端点。改正文前判摘录卡（texts[].excerpt 任一 true，或 sourceAnchor.hasExcerpt；勿用 sourceAnchor.page 判 block 包）。摘录卡改文致文字与原书脱钩（回源不受影响），须告知用户。
- [改标题](/docs/notes/post-notes-id-title): Body {text, expectedPrefix(当前值前 32 字，为空传 ""), confirm:true, markdown?}。改写/删除前展示原文→改后获同意；编辑会话前打快照。exam-general×block 下答案卡标题可能被归一，submit 后对 receipt，须保留的用此接口补回（不受归一限制）。
- [改卡片/摘录样式](/docs/notes/post-notes-metadata): Body {noteIds(≤200), patch:{colorIndex 0..15?, fillIndex -1..2?}, confirm:true}。选色前读 note-palette。整批一撤销组，独立 context 回读一致才 persisted:true。
- [移动卡片](/docs/notes/post-notes-move): Body {noteIds:[…], targetParentNoteId} 或批量 {moves:[{noteIds,targetParentNoteId}], confirm:true}，合计 ≤50/次，整批一撤销组。同集改父子，不调兄弟顺序/坐标（Bridge 无此能力）。调用前展示逐卡方案获同意。
- [列复习卡](/docs/decks/get-decks-id-cards): 返回 {cardNoteId,sourceNoteId,sourceAlive,title}。sourceAlive:false=原卡已删/隐藏，背面空白。
- [列复习卡组](/docs/decks/get-decks): 返回 {deckId,title,cardCount,lastModifiedAt}。不列学习集（集走 library/study-sets），id 不通用。
- [加复习卡](/docs/decks/post-decks-id-cards): Body {cards:[{sourceNoteId(必填), question?, questionContentId?, title?}], confirm:true} ≤50/次，整批一撤销组。question/questionContentId 互斥；都不给走 autoQuestionIndex。{{挖空}} 写 question。同一源卡重复加为更新并重排到期（updatedExisting）。组员 id 归一到宿主（resolvedNoteId）。删单张复习卡用 POST /notes/delete（单向联动：删复习卡不影响源卡，删源卡级联删复习卡）。
- [打开复习卡组](/docs/decks/post-decks-id-open): 与 study-sets open 语义类似，id 不通用（传错 422 NOT_A_DECK/IS_A_DECK）。异步，事后 /context 对账。
- [新建复习卡组](/docs/decks/post-decks): Body {title, confirm:true}。返回 {deckId, isDeck}，须校验 isDeck:true。
- [列包文件 / 取单文件](/docs/bundles/get-bundles-id-files): ?path= 取单个原始内容（curl -o 落盘）。跨设备读包靠它。
- [列任务包/作业](/docs/bundles/get-bundles): ?origin=bridge(只看自建) &since=(磁盘包按目录创建时间，作业按开始时间)。字段 bundleId/jobId/bundlePath/topicid/bookmd5/createdAt/state(preparing|prepared|imported|failed|cancelled)+progress/version/rootNoteId/running。state 缺字段按缺席处理。jobId 非 null 不等于本会话活作业。
- [删除任务包 / 取消作业](/docs/bundles/post-bundles-id-discard): 幂等。已导入卡片不受影响。对 preparing 即取消（cancelledJob 非 null 为真取消）。刚 discard 立刻重 prepare 易 429（等取消检查点）。同步 prepare 被并发 discard 则 409 PREPARE_CANCELLED。500 DISCARD_FAILED 为目录删不掉（残留按 details.bundleId 手工清）。
- [聚焦导入结果](/docs/bundles/post-bundles-id-focus): 无 confirm 门。异步，事后 /context 对账。
- [提交导入（commit）](/docs/bundles/post-bundles-id-submit): Body {targetParentNoteId?, withBlank?, excerptMode?:child|link, resultMarkdown?(仅跨设备)}。无 confirm 门，发即真执行。返回 {rootNoteId, version, preImportSnapshotId(存好，USER_EDITS_PRESENT 时带 force:true 才覆盖), receipt, parsed{headings,importedCards,wikilinks,excerptsTotal,excerptsAnchored,failedExcerpts[]}, warnings, excerptStatsTruncated?, blankInsertion?}。headings≠importedCards 即丢卡；excerptsAnchored 不等即有未定位摘录（no_match 多为改写原文）。并发重复提交 409 SUBMIT_IN_FLIGHT。
- [准备拆书任务包](/docs/bundles/post-bundles-prepare): Body {topicid, bookmd5, segments[{startPage,endPage,title}](PDF 页序，非连续可，实际页数≤60), preset(book-breakdown|source-structure|exam-general|dictionary), anchorMode(page_text|block), title?, cardStyle{defaultFillIndex -1..2}?, async?}。>~10 页必 async:true（202 {jobId,bundleId,bundlePath,state:preparing} + 轮询 GET /bundles；参数错同步 404/422）。单飞（429 PREPARE_BUSY 看 details.runningJob/retryAfterSeconds）。exam-general 必须配 block（含 role 标注），否则静默退化；错配 0.18+ 回 warnings（停下改组合重 prepare）。同步小包阻塞到完工（curl ≥300s）。
- [回退快照](/docs/snapshots/post-snapshots-id-restore): Body {confirm:true(, force:true 若 USER_EDITS_PRESENT 且用户确认覆盖)}。回退整集到过去，自动先打回退前保护点（protectionSnapshotId）。目标集正开着回 409 STUDY_SET_IN_USE（切走再试）。文档目录不在快照覆盖范围。真 dry-run（422 + wouldRestoreToVersion/快照时间/说明/卡数）。
- [全库搜索](/docs/search/get-search): ?q=&scope=all|notes|studysets|documents。返回卡/集/文档三类命中。无列全库文档端点，找书用 scope=documents 拿 bookmd5。响应带 scanned/truncated；truncated:true=窗口没够到，加词重搜。新卡约 10s 索引延迟。
- [旧同步增量事件](/docs/sync/get-sync-legacy-events): ?afterSequence=N&limit=50（1..200）。用 lastSequence 续取；hasMore 续取；historyTruncated=窗口外/缺口（勿称完整）；cursorAdvancedPastGap=已推游标防死循环；cursorAhead=换 channel/设备（重置游标）。
- [旧同步诊断快照](/docs/sync/get-sync-legacy-status): 返回 cloudKit/documents/diagnostic（无正文/文档名/账号/record id）。errorCount 为历史诊断数；suspended 看 suspensionNeedsAttention（false 可为正常增量暂停）；当前周期错误看 suspensionErrorCount。
- [旧同步只读盘点](/docs/sync/post-sync-legacy-inventory): 分页观察 private zone 顶层存在性。Query 最终一致 + 非快照，结果非权威（observed≠完整；possible_mismatch 须按 record ID 核验）。observe-only，不上传/删；独立低优先级非蜂窝队列；关 Bridge 即关。会耗配额。
- [旧同步安全重核](/docs/sync/post-sync-legacy-recheck): Body {database?=true, documents?=true}。复用 checkSync+PopulateShelf，不 reset/删/覆盖；但可能应用待处理远端变更。accepted 仅受理，记 operationId/startSequence 后读 events/status。
- [读界面状态](/docs/uistate/get-ui-state): 工作场景书签读端。键多自解释；{_jsonvalueType} 包装值原样带回。
- [应用界面状态](/docs/uistate/post-ui-state-apply): Body {state:{…}}（差量补丁；缺键保持）。无 confirm 门，发即提交。异步（~1.5s），queued:true 仅提交，~2s 后 GET 对账。accepted/conditional（依赖缺失静默跳过）/rejected（play 与 doclayerid:new 拒收）。缺 topicid 注入当前集；无开集则拒绝。theme/panelratio 写全局偏好；immersive 弄脏同步；researchurl 加载任意 URL。
- 契约
  - [运行时能力（capabilities）](/docs/contract/capabilities): GET /capabilities 机器可读附录提炼
  - [OpenAPI 说明](/docs/contract/openapi): openapi.yaml 的生成、渲染与静态托管说明
  - [版本与来源](/docs/contract/provenance): 版本、来源链、保密与更新流程