先验证记录边界

JSON Lines 每行都是独立 JSON 值。应逐行解析并精确报告错误行，静默跳过会破坏后续计数。

JSON Pointer 按 RFC 6901 转义定位嵌套值；找到值并不等于其类型和业务含义正确。

  • 比较转换前后的记录数。
  • 显示错误行而不是跳过。
  • 用预期 Schema 验证结果。

把 OpenAPI 变成可审查清单

把方法、路径、operationId、标签、弃用与安全声明放在同一张表中，可快速发现缺失命名和意外匿名端点。

规范中的 security 字段不能证明运行时授权。清单只用于安排源码检查和授权测试，不请求线上服务器。

区分 SemVer 顺序与兼容性

SemVer 会把 beta.11 排在 beta.2 之后、稳定版 2.0.0 之前，构建元数据不影响优先级；这种排序不能证明行为兼容。

最终决策还应结合变更日志、契约测试和使用者预期。