更新日志

v1.1.6 (2026-01-12)

新增功能

• 后端（版本号提供器）

  • 新增版本号提供器，支持从属性文件、Manifest 等多种来源读取版本信息
  • 在 OpenAPI 扩展字段中新增版本号字段，统一版本号注入机制

• 后端（网关聚合插件）

  • 新增网关聚合文档插件，实现 Spring Cloud Gateway 文档聚合功能
  • 支持路由包含及排除策略，灵活控制聚合范围
  • 支持多种策略解析文档路径与显示名称
  • 支持自动发现和手动配置两种方式提供 Swagger URL
  • 提供丰富的配置选项，包括路由过滤、名称解析、文档路径策略等

功能优化

• 后端

  • 优化扩展配置加载逻辑，分离基础信息与扩展配置
  • 统一网关插件接口命名规范，提升扩展一致性
  • 精简配置属性结构，优化代码逻辑
  • 优化模块间依赖关系，移除冗余依赖声明

• 前端

  • 首页版本号改为从后端读取，移除对前端构建版本的依赖

BUG 修复

• 前端
  • 修复枚举值为 0 时被过滤的问题 (#13)

v1.1.5 (2025-12-22)

新增功能

• 前端
  • 新增响应数据加载中状态反馈，提升用户等待体验

BUG 修复

• 后端（认证过滤）
  • 修复注销请求判断的逻辑错误，移除错误的 HttpUtil 导入，改用 Spring Framework 的 HttpMethod 进行请求方法比较

v1.1.4 (2025-12-19)

新增功能

• 前端
  • 新增应用版本号显示功能，提升用户体验
  • 新增请求发送按钮加载状态，防止重复点击
  • 新增 JSON 视图复制功能，支持将编辑器内容复制到剪贴板

功能优化

• 前端

  • 优化测试请求参数编辑器高度自适应逻辑，设置默认高度 500 像素，避免内容少时高度过低

• 后端（Sa-Token 插件）

  • 优化路径排除器实现，通过 SpringUtil.getBean() 延迟获取替代构造函数注入
  • 解决用户自定义多个 RequestMappingHandlerMapping Bean 时的注入冲突问题
  • 降低 AutoConfiguration 与实现类的耦合度

BUG 修复

• 前端
  • 修复 format-left 图标填充颜色显示问题，确保图标颜色正确继承父元素颜色

v1.1.3 (2025-12-18)

新增功能

• 后端（认证展示插件）

  • 新增接口认证信息展示插件，支持 OpenAPI Security 元数据统一解析和展示
  • 新增 Sa-Token 适配模块，实现权限、角色及忽略规则注解的解析与展示
  • 支持全局和接口级别的鉴权配置，自动注入 OpenAPI 鉴权信息
  • 引入路径排除机制，基于注解动态排除特定接口的鉴权

• 后端（枚举解析）

  • 新增枚举展示解析，支持自定义枚举接口类型及方法名
  • 支持基于反射调用自定义的枚举值和描述方法
  • 统一解析流程，增强了扩展性和灵活性

• 前端

  • 新增认证展示组件，支持 API 访问权限及权限要求明细展示
  • 增强枚举展示功能，支持枚举描述展示，格式( 1 - 启用 , 0 - 未启用 )
  • JSON 查看器、参数视图、模式视图组件均支持扩展枚举信息展示

BUG 修复

• 前端
  • 修复 JSON 节点复制功能异常问题

v1.1.2 (2025-12-08)

新增功能

• 后端（枚举插件）

  • 实现枚举插件自动配置，基于 SpringDoc 与配置属性自动启用
  • 支持通过配置控制插件启用、描述颜色及枚举展示行为
  • 新增插件相关常量，统一命名空间与插件标识管理
  • 补充自动配置元数据，增强 Spring Boot 自动加载支持

• 后端（枚举处理能力）

  • 增强枚举参数与模型处理能力，支持参数与模型中的枚举类型完整自定义处理
  • 统一设置枚举类型的 enum 列表、type、format
  • 新增枚举值与描述映射信息追加展示
  • 优化枚举描述 Map 的生成顺序与安全性，确保展示稳定

• 前端

  • 新增 JSON 复制能力
  • 新增 JSON 字段说明展示
  • 支持渲染 HTML 格式的 API 描述（兼容后端能力增强）

功能优化

• 后端（枚举插件）
  • 调整为从配置读取描述颜色与展示开关
  • 优化枚举描述与枚举值展示逻辑，支持可控的显示策略

BUG 修复

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

依赖更新

• Spring Boot 升级：3.5.5 -> 3.5.7

v1.1.1 (2025-11-13)

功能优化

• 后端

  • 移除 NextDoc4jPathMatcherUtils 中不必要的双重检查锁定，精简逻辑结构，提升执行效率

• 前端

  • 支持渲染 HTML 格式的 API 描述，丰富接口文档展示能力，提升阅读体验

BUG 修复

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

v1.1.0 (2025-11-05)

功能优化

• 详情页样式重构

  • 重构 API 详情页样式，将请求参数示例与 JSON 示例调整为左右结构分布，优化界面布局与信息可读性（优化前为单栏展示，优化后左右分栏更清晰）

• 全局认证 UI 重构

  • 全新设计全局认证配置 UI，界面布局更简洁直观，支持多种认证方式的便捷配置与管理

BUG 修复

• 后端路径过滤问题修复
  • 修复后端路径过滤无法匹配前缀的问题，确保 /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 声明的情况下，均可展示文件类型信息
  • 优化文件 + 额外参数上传（表单混合提交）的解析和展示

BUG 修复

• 标题统一性修复

  • 修复主页与左侧菜单栏标题不一致的问题，保证界面风格统一

• 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 配置，与登录界面风格保持一致，实现整体视觉统一性