OpenAPI diff
比较同一API两个版本规格文件之间结构差异的技术方法，用于识别兼容性风险和生成变更日志，通常基于规则引擎实现，结果可复现可审计
时间轴 (近 90 天)
OpenAPI diff 比较同一 API 的两个版本之间的结构差异，以识别兼容性风险。
在 OpenAPI diff 中，规格文件被解析为抽象语法树（AST），工具递归遍历路径、操作、参数、模式等节点，逐层比较新旧树的对应节点。
剩余约 10% 的场景是重命名同时改变了字段类型，此时应报告为“重命名 + 破坏性变更”，而非静默移动。
如果旧路径在同一版本中也被删除，基于字符串哈希的 diff 逻辑有时会错误配对，报告一个从未发生的重命名。
工程上可进一步用置信度评分、并列候选、或要求显式标志位（如自定义的 x-renamed-from 扩展）来让规范作者主动表达意图，工具只负责按确定规则解释这些输入。
判断某个变更对消费者是否构成破坏需要业务上下文（如是否存在活跃调用方、版本策略允许的破坏性变更、迁移窗口长度），这些信息不在规范里，differ 无从得知。
据作者描述，仅靠 schema 哈希相等就能覆盖约 90% 的重命名检测场景。
全部知识事实 (7)
OpenAPI diff 比较同一 API 的两个版本之间的结构差异，以识别兼容性风险。
50%待验证在 OpenAPI diff 中，规格文件被解析为抽象语法树（AST），工具递归遍历路径、操作、参数、模式等节点，逐层比较新旧树的对应节点。
50%待验证剩余约 10% 的场景是重命名同时改变了字段类型，此时应报告为“重命名 + 破坏性变更”，而非静默移动。
50%待验证如果旧路径在同一版本中也被删除，基于字符串哈希的 diff 逻辑有时会错误配对，报告一个从未发生的重命名。
50%待验证工程上可进一步用置信度评分、并列候选、或要求显式标志位（如自定义的 x-renamed-from 扩展）来让规范作者主动表达意图，工具只负责按确定规则解释这些输入。
50%待验证判断某个变更对消费者是否构成破坏需要业务上下文（如是否存在活跃调用方、版本策略允许的破坏性变更、迁移窗口长度），这些信息不在规范里，differ 无从得知。
50%待验证据作者描述，仅靠 schema 哈希相等就能覆盖约 90% 的重命名检测场景。
50%