请解释 openapi-typescript-codegen 工具的作用，并描述它根据 OpenAPI 规范生成接口调用代码的具体流程。

回答思路

1. 【回答框架 1】openapi-typescript-codegen 是一个基于 OpenAPI 规范的代码生成器，它读取 OpenAPI 文档（通常为 JSON 或 YAML 格式），输出 TypeScript 类型定义和可调用的 API 客户端代码，常用于前端或 Node.js 项目中减少手写接口代码。
2. 【回答框架 2】核心流程：首先解析 OpenAPI 文档，提取其中的 paths、operations、schemas 等信息；然后根据配置和模板，为每个接口生成对应的请求函数、参数类型、响应类型和错误类型；最后输出到指定目录，通常会生成 client、core、models 和 services 等模块。
3. 【回答框架 3】生成代码的典型结构包括：models 目录存放数据模型类型，services 目录存放按模块组织的接口调用函数，core 目录包含请求配置和基础工具函数，使得生成的代码可直接集成到项目中。
4. 【回答框架 4】该工具还支持自定义配置，比如指定请求库（axios、fetch 或自定义）、生成风格（命名、导入方式）等，并且通过 Hooks 或 middlewares 提供扩展点。相比手写代码，它能保证类型与后端契约同步，但需注意文档与实际实现不一致时可能导致类型错误。
5. 【关键点 1】openapi-typescript-codegen 基于 OpenAPI 文档自动生成 TypeScript 类型和 API 调用代码，提高开发效率并保证类型安全。
6. 【关键点 2】生成流程包括解析文档、提取操作与模型、按模板生成代码，并输出客户端、模型和服务文件。
7. 【关键点 3】支持自定义请求库、插件扩展，以及多样的配置项，如生成风格和文件组织。
8. 【关键点 4】一般不会直接生成业务逻辑，只负责接口层和类型层，需与后端文档保持同步。
9. 【易错点 1】如果 OpenAPI 文档与实际接口不一致，生成的代码可能无法正确调用，需要确保文档同步。
10. 【易错点 2】过度依赖自动生成可能导致对接口细节的理解不足，且生成代码体积可能较大，需要合理配置按需生成。
11. 【易错点 3】不支持所有复杂 OpenAPI 特性（如部分回调、复杂组合），需注意生成结果的覆盖度。