OpenAPI-TS 0.63.0版本发布：客户端插件化架构升级

OpenAPI-TS是一个强大的TypeScript代码生成工具，它能够根据OpenAPI规范自动生成类型安全的API客户端代码。这个工具极大地简化了前端开发人员与后端API交互的工作流程，确保类型安全的同时提高了开发效率。

客户端插件化架构

在0.63.0版本中，OpenAPI-TS进行了重大的架构调整，将客户端实现从核心功能中解耦，转变为插件化架构。这一变化带来了几个显著优势：

1. 模块化设计：每个客户端实现现在都是一个独立的插件，使得代码结构更加清晰
2. 灵活性增强：开发者可以根据项目需求选择特定的客户端实现，而不需要引入不必要的代码
3. 更易维护：插件可以独立更新和发布，不影响核心功能

配置变更指南

对于使用配置文件的开发者，需要注意以下配置变更：

// 旧版配置
export default {
  client: '@hey-api/client-fetch',
  input: 'path/to/openapi.json',
  output: 'src/client',
};

// 新版配置
export default {
  input: 'path/to/openapi.json',
  output: 'src/client',
  plugins: ['@hey-api/client-fetch'],
};

错误处理配置迁移

throwOnError配置项从SDK层面迁移到了各个客户端插件中，这一变更更加合理，因为并非所有客户端都支持错误抛出机制。配置方式如下：

export default {
  plugins: [
    {
      name: '@hey-api/client-fetch',
      throwOnError: true, // 仅对支持该功能的客户端有效
    }
  ]
};

客户端生成文件结构调整

新版本对生成的文件结构进行了优化调整：

1. 客户端实例现在定义在client.gen.ts文件中，而不是之前的sdk.gen.ts
2. 如果代码中有直接引用客户端实例，需要更新导入路径

// 旧版导入方式
import { client } from 'client/sdk.gen';

// 新版导入方式
import { client } from 'client/client.gen';

插件推断机制增强

新版本增加了插件推断失败时的错误提示，当配置中指定的插件无法找到时，会明确抛出错误，帮助开发者快速定位问题。

升级建议

对于现有项目升级到0.63.0版本，建议开发者：

1. 检查并更新配置文件中的客户端配置方式
2. 更新所有直接引用客户端实例的导入语句
3. 根据需要调整错误处理配置
4. 测试生成的客户端代码是否正常工作

这次架构调整虽然带来了一些配置上的变化，但从长远来看，插件化的设计将为项目带来更好的可维护性和扩展性，同时也为未来支持更多类型的客户端实现奠定了基础。