oapi

Apifox 类型同步工具

更新日志

1.1.2 (2026-09-01)

1. 环境变量加载优先读取项目根目录下的 .env.oapi 文件，其次才是 .env：避免 Apifox 相关环境变量（如 APIFOX_PROJECT_ID）与通用 .env 配置冲突，便于单独管理 oapi 配置。

1.1.1 (2026-08-18)

1. sync 命令的 --filter 选项支持英文逗号分隔的多关键字过滤：匹配任意一个关键字即可通过（OR 关系），空关键字将被忽略。

1.1.0 (2026-08-18)

1. sync 命令新增 --filter <keyword> 选项：可按相对路径（含目录和文件名）或文件名关键字过滤同步范围，仅同步匹配到的 API 文件，并在统计阶段输出过滤结果与匹配到的文件列表。

1.0.7 (2026-07-16)

1. sync 命令：当字段存在枚举类型且包含 x-apifox-enum 数据时，在生成 DTO 字段注释时将枚举值及描述拼接到字段描述后方。

1.0.6 (2026-06-08)

1. sync 命令新增重复函数名检测：若本次同步的接口中存在相同的导出函数名，统计阶段将输出警告，列出所有重名函数及其所在文件和对应接口。

1.0.5 (2026-05-08)

1. 支持处理响应类型为内联基础类型（number、string、boolean）的接口。
2. 生成的函数返回类型泛型参数增加 | null，如 <ResponseDto | null>。

1.0.4 (2026-04-29)

1. 修复 array 嵌套 array（如 T[][]）结构的 schema 依赖未被收集，导致 DTO 文件缺少相关类型定义的问题。

1.0.2/1.0.3 (2026-04-29)

1. link 和 sync 命令增加对 apiDir 参数输入单个 .ts 文件的支持。
2. 支持通过环境变量 APIFOX_PROJECT_ID 指定项目 ID。

1.0.1 (2026-04-24)

1. 增加字段注释生成
2. 修复无法处理 requestBody 类型为数组的情况

1.0.0 (2026-04-23)

1. 初始版本