dsh-api-contract

OpenAPI 规范是团队里最常被引用、也最容易悄悄腐坏的那份文档：一个路径被改、一个参数从可选变必填、一个响应字段悄然消失，下游客户端还在按旧契约发请求，直到深夜某个 500 才暴露问题。dsh-api-contract 把这件事变成一条本地命令：解析你的 OpenAPI 3.x 规范（JSON 或 YAML），直接生成 TypeScript（基于 fetch）或 Python（基于 requests）的完整类型化客户端，省掉手写接口定义和类型注释放逐字对齐的重复劳动。

它还提供了 diff_spec 工具，对比两个版本的规范并逐项分类：破坏性变更（删除路径或方法、移除必填参数、参数类型变化、移除 2xx 响应、响应结构变化）与非破坏性变更，让你在一次代码审查中就能识别出真正影响下游的回归。整个流程纯 Node 实现，无网络请求、无外部服务，规范文件始终留在本地。

适合维护多语言客户端的团队，或者正打算把 OpenAPI 作为唯一真源来驱动开发工作流的人。它缩短从规范到可运行代码的距离，也在每次发布前加了一道低成本的回归检查。