uckkk/dsh-api-contract

uckkk★ 0JavaScript最后同步: 2026-08-16

在 GitHub 打开

接口契约助手:解析 OpenAPI 3.x,生成 TypeScript/Python 类型化客户端并检测破坏性变更

README 摘要

dsh-api-contract · 接口契约助手 解析 OpenAPI 3.x(JSON 或 YAML),生成 TypeScript / Python 类型化客户端 ,并检测两个规范版本之间的 破坏性变更 。纯 Node 实现,无网络、无外部服务。 提供的工具 工具 作用 gen client 解析规范,生成类型化客户端(TS 基于 fetch / Python 基于 requests) diff spec 对比旧版/新版规范,列出破坏性变更与非破坏性变更 安装 安装后在 profile 的 package.json 的 dsh.profile.bundles 中加入 "dsh-api-contract" 。 用法示例 破坏性变更检测项 - 删除接口路径、删除方法 - 删除必填参数、参数类型变化 - 移除 2xx 响应、响应结构变化 说明 - 支持 JSON 与常见块结构 YAML(嵌套映射、序列、 $ref 、内联 [] / {} 、字面量块 )。 - Python 客户端依赖 requests ( pip install requests )。

在 GitHub 查看完整 README →
Agent/智能体deepseek-harnessdsh-plugin

分类