用途:根据脱敏后的响应证据,对 Microsoft Graph OneNote 调用失败进行分类,并在执行任何实际操作前给出可审计的决策或产物,选择有界的恢复路径。
主要能力:将 HTTP 状态、Graph 错误码、内部错误、请求标识、目标位置、认证上下文与操作视为彼此独立的证据;把故障归类为传输、认证、授权、预配、身份、校验、限流、冲突或服务状态;分别检查用户、组或站点根与笔记本、分区、页面或资源身份;只应用最小化的类别专属修正,默认不扩大权限;仅对可重试类别在严格的尝试次数与耗时预算内重试;用最小权限读取或合成夹具验证恢复。
使用方式:先捕获一份脱敏响应信封和确切的读或写操作;记录委托令牌别名、租户别名、登录用户别名、已授予的 Notes 范围与目标归属,切勿粘贴或解码 bearer 令牌;使用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据,Write 与 Edit 仅用于已批准的仓库产物。输出证据信封、故障类别、已排除原因、最小动作、重试预算、验证结果与升级包,并明确假设、负责人、过期时间与证据缺口。
适用场景:处理 OneNote 认证、权限、预配、校验、限流与 5xx 恢复等问题,区分未预配的 OneNote 存储与过期的委托会话,区分格式错误的输入 HTML 与不可访问的目标分区。
限制:调用本身不授权网络访问、委托凭据、租户或笔记本内容、同意、文件传输、部署、写入、支出、共享变更或删除;新的内容读取需登录用户或内容所有者批准,同意或凭据变更需安全批准,重放写入需内容所有者批准;429 响应不保证带 Retry-After,缺失时应使用带抖动的有界指数退避;未知 Graph 码应隔离并保留请求标识;不得把每个 403 都转为更宽的 Notes 范围请求;需以当前第一方文档与已测试契约为前提,观察到的租户行为仅属环境特定证据。