Skip to content

Release v0.1.8

Latest

Choose a tag to compare

@github-actions github-actions released this 17 May 04:26
· 7 commits to main since this release

[0.1.8] - 2026-05-17

新增

  • 新增发布前版本一致性检查脚本,校验根版本、README 示例版本、CHANGELOG 版本记录和子模块硬编码版本。
  • 新增前端 Vitest 测试,覆盖 OpenAPI 文档加载竞态、JSON Pointer 引用解析、外部引用降级和 OpenAPI 3.1 类型兼容。

优化

  • 为 OpenAPI 文档加载增加请求取消和序列保护,避免快速切换分组时旧响应覆盖新状态。
  • 增强 Schema $ref 解析,支持完整 JSON Pointer、~0/~1 转义、components 下非 schemas 节点解析和外部引用降级提示。
  • 兼容 OpenAPI 3.1 type 数组和 nullable enum,统一 Schema 展示、示例生成、DOCX 导出和模拟请求中的类型判断。
  • 优化模拟请求面板的请求体字段识别,提升数组、文件字段、枚举字段和 */* 请求体类型的处理一致性。
  • 提升 release workflow 质量闸,发布前执行版本一致性检查、前端测试和 Maven 验证,不再跳过测试。
  • release workflow 中的版本提取、Maven settings 生成和发布说明提取改为 PowerShell,减少 Linux-only 脚本依赖。
  • CI 前端依赖安装改为 frozen lockfile,并在构建前增加前端测试。
  • 同步 springdoc-plus-ui 静态资源,确保概览面板最新改动进入 starter 打包产物。

修复

  • 修复快速切换文档分组时,较慢的旧 OpenAPI 响应可能覆盖当前分组状态的问题。
  • 修复 OpenAPI 3.1 type: ["string", "null"] 等类型数组在 Schema 展示、参数类型和示例生成中显示不准确的问题。
  • 修复仅按 $ref 最后一段名称解析引用时,无法处理转义字符、非 schemas 引用和部分合法 JSON Pointer 的问题。
  • 修复 springdoc-plus-ui 打包产物可能滞后于 springdoc-plus-web 源码的问题,旧的 Shareable 标记不再保留在 UI 资源中。

验证

  • 已执行版本一致性检查、前端单元测试、前端生产构建和 Maven verify。
  • 已确认同步后的 UI 打包产物中不再包含旧的 Shareable 标记。