Skip to content

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

最后更新于: