更新日志

v1.1.2 (2025-12-08)

✨ 功能增强

• 后端（枚举插件）
  • 实现枚举插件自动配置，基于 SpringDoc 与配置属性自动启用
  • 新增 EnumsPluginProperties，支持通过配置控制插件启用、描述颜色及枚举展示行为
  • BaseEnumParameterHandler 调整为从配置读取描述颜色与展示开关
  • 优化枚举描述与枚举值展示逻辑，支持可控的显示策略
  • 新增插件相关常量，统一命名空间与插件标识管理
  • 升级 Spring Boot 至 3.5.7，确保框架兼容性与稳定性
  • 补充自动配置元数据，增强 Spring Boot 自动加载支持
• 后端（枚举处理能力）
  • 增强 BaseEnumParameterHandler，支持参数与模型中的枚举类型完整自定义处理
  • 统一设置枚举类型的 enum 列表、type、format
  • 新增枚举值与描述映射信息追加展示
  • 增强 EnumsUtils，支持枚举值类型解析与格式推断
  • 优化枚举描述 Map 的生成顺序与安全性，确保展示稳定
• 前端
  • 新增 JSON 复制能力
  • 新增 JSON 字段说明展示
  • 支持渲染 HTML 格式的 API 描述（兼容后端能力增强）

🐛 问题修复

• 后端
  • 从 nextdoc4j-core 与 nextdoc4j-dependencies 移除 jackson-databind 冗余依赖
  • 为 NextDoc4jExtensionOpenApiCustomizer 添加 @SuppressWarnings 处理无效警告
  • 清理多余依赖声明，规整 pom.xml 配置
  • 优化枚举参数处理与自动装配逻辑，移除无效注解，并统一注入 ObjectMapper

v1.1.1 (2025-11-13)

✨ 功能优化

• 后端：移除 NextDoc4jPathMatcherUtils 中不必要的双重检查锁定，精简逻辑结构，提升执行效率
• 前端：支持渲染 HTML 格式的 API 描述，丰富接口文档展示能力，提升阅读体验

🐛 问题修复

• 前端：
  • 修复深色模式下全局认证样式异常问题，统一视觉表现
  • 修复 header / query 参数名与 securitySchemes 定义不一致的问题，保证认证参数解析正确
  • 修复测试按钮未禁用导致的重复点击问题，避免多次请求触发

v1.1.0 (2025-11-05)

✨ 功能 & UI 优化

• 详情页样式重构：重构 API 详情页样式，将请求参数示例与 JSON 示例调整为左右结构分布，优化界面布局与信息可读性（优化前为单栏展示，优化后左右分栏更清晰）
• 全局认证 UI 重构：全新设计全局认证配置 UI，界面布局更简洁直观，支持多种认证方式的便捷配置与管理

🐛 问题修复

• 后端路径过滤问题修复：修复后端路径过滤无法匹配前缀的问题，确保 /xxx/v3/api-docs 等带前缀的路径也能被正确拦截

📦 依赖更新

• Jackson 升级：2.18.2 -> 2.20.0
• Spring Boot3 升级：3.5.5 -> 3.5.6
• SpringDoc 升级：2.8.13 -> 2.8.14
• Hutool 升级：5.8.37 -> 5.8.41
• Swagger 升级：2.2.36 -> 2.2.39

v1.0.1 (2025-10-17)

🛠 优化改进

• 主页配色优化：统一主页配色方案，与全局风格保持一致，提升视觉一致性
• Spring Boot 适配：自动适配 servlet.context-path，保证在自定义上下文路径下，文档可通过对应路径（如 /app/doc.html）访问
• 列表解析优化：改进 list 数组类型字段解析逻辑，提升文档展示准确性和可读性
• 入参字段范围展示：增加入参字段范围信息，更直观体现参数约束
• 文件上传接口优化：
  • 接口在有无 multipart/form-data 声明的情况下，均可展示文件类型信息
  • 优化文件 + 额外参数上传（表单混合提交）的解析和展示

🐛 问题修复

• 标题统一性修复：修复主页与左侧菜单栏标题不一致的问题，保证界面风格统一
• Body 双 JSON 折叠问题修复：修复同一接口返回或请求体包含两个 JSON 时，折叠/展开显示异常的问题

📦 依赖更新

• Springdoc 升级：2.8.11 -> 2.8.13

v1.0.0 (2025-09-10)

✨ 新特性

• 核心适配：深度适配 SpringDoc 与 OpenAPI 3 规范，提供全新现代化文档 UI，替代传统 Swagger UI，优化 API 文档展示与交互体验
• 配置管理：支持开关配置（可灵活控制文档 UI 功能启用 / 禁用）与生产模式配置（适配生产环境下的文档访问权限与安全管控）
• 认证功能：新增认证登录模块，保障 API 文档访问安全性，防止未授权用户查看敏感接口信息
• 品牌定制：支持品牌 logo 与标题自定义配置，可根据团队或项目需求替换默认标识，强化品牌辨识度
• 登录界面美化：实现动态标题与动态 logo 效果，支持配置化展示，提升登录页面视觉体验
• 主页优化：同步增加主页动态标题与动态 logo 配置，与登录界面风格保持一致，实现整体视觉统一性