API 版本与破坏性变更检测(免费版)
输入
| 字段 | 必填 | 说明 |
|---|---|---|
| 旧版字段定义 | 是 | 字段:类型 或 {type,required} |
| 新版字段定义 | 是 | 同上 |
输出
破坏性变更清单 + 是否 breaking + 版本升级建议
工作流
- 逐字段比对:旧有新无=删除字段;同名类型变=类型改变;选填变必填=收紧;新增且必填=新必填。
- 任一破坏性变更→breaking,主版本号+1(major)。
- 仅新增可选字段(向后兼容)→次版本minor;仅修复→修订patch。
硬性规则
- 破坏性四类固定:删字段/改类型/选填变必填/新增必填。
- 有 breaking 必须 major,不得发 minor/patch 掩盖。
- 完全相同判无变更,不强行升版本。
示例
删字段 id → breaking → major
新增可选字段 remark → 非breaking → minor
name:string→integer → 类型改变 → major