用途:为 OneNote 集成开发建立可重复的本地开发循环,使用合成夹具、Mock 与经明确批准的委派沙箱,在任何真实操作前产出可审计的决策或产物。
主要能力:离线夹具可模拟 v1.0 根、不透明 next 链接、受限输入 HTML、规范化输出 HTML、生成的更新 ID、Graph 错误信封,以及不带 Retry-After 的 OneNote 429 响应;支持离线单元测试与契约测试、生产目标防护、秘密金丝雀、分页与 HTML 规范化验证、沙箱清理。
使用方式:固定运行时与 Graph SDK 依赖,将 OneNote 调用置于窄客户端边界后;先创建合成层级、分页、HTML、更新目标、错误与限流夹具;在联网前完成离线测试;基于环境、租户别名、用户别名与夹具 ID 添加生产目标防护;在委派沙箱中执行一次批准的读取,可选一次可逆写入;随后重置夹具、扫描生产标识并保留测试与清理回执。工具上可用 Read、Glob、Grep 检查文档、配置、代码与夹具,Write、Edit 仅用于已批准的仓库产物。
适用场景:实现或验证 OneNote 集成、需要离线可重复测试与审计留痕的开发流程。
限制:需当前第一方 Microsoft Graph OneNote 文档与所选集成的已测试契约;需指定身份、内容、工作负载、安全与运维负责人;需去除秘密与真实笔记本内容的合成或已批准非生产夹具。使用专用沙箱用户与加密委派缓存,生产令牌、租户 ID、笔记本 ID、标题、正文与二进制资源不得成为夹具。环境或用户绑定缺失时应失败关闭;不得将实时页面正文快照进源码控制;测试不得依赖未文档化的搜索、delta 或 webhook 行为。写入、上传、复制、共享或删除需内容负责人明确批准。输出应包含依赖契约、夹具清单、测试命令、沙箱绑定、实时回执、清理与残余风险,并明确假设、负责人、到期时间与证据缺口。具体命令与安装步骤暂未提供。