用途:在认证、SDK、请求或不受支持功能假设发生变化时,安全迁移 OneNote 集成,并在任何实际动作前产出可审计的决策或工件。
主要能力:区分 Graph v1.0 与 SDK 版本、委派认证与过时的仅应用路径、受支持的分层分页与未文档化的搜索或 delta、计划对账与不受支持的 OneNote 变更通知;盘点认证流程、SDK 调用、REST 路由、分页循环、HTML 操作、事件假设与夹具;将行为分类为受支持、矛盾、未文档化或环境观察;定义目标客户端边界与兼容夹具;迁移仅应用、重建分页、搜索、delta、Webhook、固定限制与 Retry-After 假设;对单个委派用户与合成根进行金丝雀验证,支持回滚与双读比较;对账结果、移除过时凭据与死路径、发布兼容性回执。
使用方式:使用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据;仅对已批准的仓库工件使用 Write 与 Edit。调用本身不授权网络访问、委派凭据、租户或笔记本内容、同意、文件传输、部署、写入、支出、共享变更或删除。认证迁移需身份与安全批准,实时读写需内容所有者批准,切换与旧密钥移除需发布批准。
适用场景:替换客户端凭据作业为委派会话所有权;用节范围轮询与对账替换未文档化的 pages-delta 循环。
限制:不得将客户端凭据保留为 OneNote 紧急回退;不得用无界全页扫描替换不受支持的 delta;出现计数、内容、位置或用户绑定漂移时回滚。需当前第一方 Microsoft Graph OneNote 文档与所选集成的已测试契约、命名身份/内容/工作负载/安全/运营负责人、去除密钥与真实笔记本内容的合成或已批准非生产夹具。依赖可变权限、限制、SDK 行为、受支持资源或云可用性前,需重新检查带日期的证据图。观察到的租户行为仅为环境特定证据,非通用 OneNote 保证。