Docusaurus-OpenAPI-Docs 4.4.0版本发布：支持SSE与模板自定义

Docusaurus-OpenAPI-Docs是一个基于Docusaurus框架的OpenAPI文档生成工具，它能够将OpenAPI规范文件自动转换为美观、易用的API文档网站。该项目特别适合需要为开发者提供API文档的技术团队使用，它提供了丰富的自定义选项和现代化的文档展示方式。

核心功能更新

Server-Sent Events (SSE)支持

4.4.0版本最重要的新增功能是对Server-Sent Events(SSE)协议的支持。SSE是一种基于HTTP的服务器推送技术，允许服务器单向向客户端发送事件流。在API文档中，这意味着：

1. API Explorer现在可以展示SSE端点
2. 配置文件中新增了SSE相关的选项
3. 文档生成时会自动识别并正确渲染SSE类型的API

这项改进使得文档能够更准确地反映现代Web应用中常见的实时数据推送场景。

模板自定义增强

新版本扩展了模板自定义功能，开发者现在可以：

1. 为info部分创建自定义模板
2. 为tag部分创建自定义模板
3. 为schema部分创建自定义模板

这些模板支持条件渲染，使得文档可以根据不同场景展示不同的内容结构。例如，可以根据API的版本或类型动态调整文档布局。

技术改进与问题修复

类型系统增强

1. 修复了枚举类型没有明确类型定义时的处理逻辑
2. 改进了anyOf/oneOf复合类型的渲染方式
3. 优化了discriminator字段的处理，特别是对于仅通过allOf继承而没有自身属性的子模式

这些改进使得文档生成器能够更准确地反映API的类型系统，特别是对于复杂的类型组合场景。

示例与测试增强

1. 新增了httpbin.org的OpenAPI规范作为示例
2. 更新了GitHub Actions的依赖版本
3. 改进了测试覆盖率

升级建议

对于正在使用Docusaurus-OpenAPI-Docs的项目，4.4.0版本提供了多项有价值的改进。特别是：

1. 需要展示实时API的项目应该升级以获取SSE支持
2. 需要高度自定义文档外观的项目可以利用新的模板功能
3. 处理复杂类型系统的项目会受益于类型渲染的改进

升级过程通常只需要更新package.json中的版本号并重新生成文档即可。对于使用自定义模板的项目，可能需要根据新功能调整现有模板。