pawsql-doc build-changelog 从 pawsql-server 仓库的 tag 区间提交生成，人工复核后随版本发布更新。
标记区外的内容可自由编辑；标记区内的条目请勿手改（改来源提交后重跑生成）。
条目后括号内是源码提交的短哈希，便于溯源；internal 类改动（内部重构、依赖升级等）不在此展示。
SQL 审核与优化
- 优化报告模板，去掉不必要的占位标题 (1259cd3a)
- 新增工单 SQL 执行会话的跟踪表 (4fed9d5f)
慢查询与巡检
- AI 优化在无执行计划时禁止编造执行计划信息 (37d83230)
- 新增巡检慢查询 AI 优化功能 (39644ae0)
- AI 优化拆分为诊断与优化两阶段，支持自定义系统提示 (8905f205)
- 巡检 AI 优化的 SQL 来源改为以慢查询实体为准 (b54a0521)
工作空间与数据源
- UserConfig 为空时回退到 PawsqlConfig (39c77416)
- DDL 变更表格去掉冗余列 (73d17723)
集成与开放接口
- 替换 Springfox 为 Springdoc OpenAPI 3，并配置接口分组 (02d62e19)
- createWorkspace 与 createAnalysis 支持匿名 key (042f9506)
- 匿名分析接口增加 IP + sessionId 双维度限流 (0a479a28)
- 恢复同步 createAnalysis，并新增 /createAnalysisAsync 接口与 API 文档 (352ef293)
- 公共 API 与集成 API 的 DTO 注解迁移到 OpenAPI 3 (59aba1f8)
- cloud 模块注解迁移到 OpenAPI 3 (67c47d07)
- 匿名用户 key 的配置移到按 profile 的 yml (685e3c39)
- 公共 API 与集成 API 的 Controller 注解迁移到 OpenAPI 3 (73332d46)
- 新增匿名用户 key，支持 MCP/DBeaver 等免登录客户端 (776a1a53)
- base 模块 DTO 注解迁移到 OpenAPI 3 (95b88e71)
- ticket 模块注解迁移到 OpenAPI 3 (a2b7ff74)
- 匿名用户跳过云端额度检查 (bc6c15e1)
- integration 模块剩余的 DTO/Entity 注解迁移到 OpenAPI 3 (becf1a6f)
- base 模块 Entity 注解迁移到 OpenAPI 3 (d93d42f2)
- 新增异步 createAnalysis、system/info 接口与按名称查询 (ed7cca3d)
- base/app 模块 Controller 注解迁移到 OpenAPI 3 (f251fa44)
权限与安全
- 修正 checkLicense 错误信息中引用错的变量 (44eb823d)
- 平台用户管理新增启用/禁用状态控制接口 (7c4bdcb6)
SQL 审核与优化
- 使用格式化后的 SQL 语句进行审核，获取正确的行号 (718ef500)
- 完善工单执行中跳过步骤的状态校验与结果处理 (e64aa5be)
慢查询与巡检
- 达梦慢查询参数校验优化，部分参数获取失败时兜底 (476df780)
工作空间与数据源
- DDL 目录移到 docs/ 下，并新增开发者与 AI 指南 (16a24c00)
- 新增环境变量模板文件并更新配置管理方式 (42e9b968)
- 建立统一的数据库脚本管理：baseline + migrations + archive (5bce9770)
- 移除创建工作空间时 database 字段的非空校验 (603a71af)
- 统一工作空间创建逻辑，移除硬编码的数据库类型常量 (613e7f4f)
- DDL 移到 cloud/src/main/resources/ 下，移除旧脚本目录 (a7f36d89)
- DDL 迁移目录加序号前缀，shared 改为 01-common (ba8dd1a4)
- DDL 目录新增 03-wip，baseline 文件带上日期 (bcaa4eda)
集成与开放接口
- 摘要与 SQL 详情接口返回规则预警级别信息 (ac2d8cdc)
权限与安全
- MySQL 连接启用 SSL/TLS，以支持 require_secure_transport=ON (0e48f8e1)
- 简化工作空间创建 DTO 的密码过滤逻辑 (ec5790b5)
SQL 审核与优化
- 修复校验逻辑的空指针问题 (04bca2a0)
- 硬编码错误信息改为国际化常量键 (26eef2ee)
- 新增工单 SQL 执行所需的三张跟踪表 (2cc90137)
- 执行会话支持跳过当前 SQL 与超时自动回滚 (325f8a22)
- 工单 M2 级 SQL 执行会话支持执行、提交与回滚 (41ef8705)
- 新增执行会话的连接丢失检测与处理 (56b52e0a)
- 工单执行会话支持超时自动回滚与合法性校验 (5897ac42)
- 实现工单 SQL 执行会话预览（M1） (59943641)
- 修复处理索引数量前未先保存索引的问题 (7609a9e7)
- 新增按工单 ID 获取执行会话历史列表的接口 (86d5001e)
- 新增执行会话终止功能 (92c6264c)
- 性能验证前处理变量与不支持的 SQL 类型 (95f9fa17)
- 提取错误消息常量，并拦截离线工作空间的执行 (b90c768d)
- 新增无索引阶段的索引推荐保存逻辑 (bfec7ca0)
- 同步审核逻辑 (ca206cdd)
- 执行会话支持批量执行全部 SQL 与参数化执行 (cdffaf20)
- 完善非事务执行模式的会话处理 (ee1674bd)
- 提取并统一解析异常的持久化逻辑 (feb5b082)
工作空间与数据源
- 新增多数据库方言执行支持框架 (6100a1ec)
SQL 审核与优化
- 重构索引清理服务的数据源解析逻辑 (1b40af07)
- 新增派生表转 Lateral Join 优化规则并更新规则配置 (b7cb6e33)
- 审核结果增加严重与警告规则数目统计字段 (be673d04)
- 调整审计分数的计算参数 (d5b62a7c)
- 新增分析级结构化解析异常的存储与展示 (e34f1203)
- 调整持久化分析解析异常的执行时机 (f3eb7e2a)
工作空间与数据源
- 更多数据库类型改用脚本解析器 (7de06848)
- indexAdvisor 改用已有的 sqlparser (837d76e9)
- MySQL 与 PostgreSQL 改用脚本解析器 (fdb21ce3)
SQL 审核与优化
- 新增 SQL 内容为空的错误码，优化任务失败处理 (00555ff7)
- 新增审核规则脚本 (07f4f005)
- 索引清理增加错误历史记录与手动标记解决 (17b649c2)
- 移除解析结果缓存，修复并发修改异常 (1ecf5d50, a065cf35)
- 修复 SQL 解析器初始化缺少 useExclusiveParser 参数的问题 (22c7e6df)
- 移除索引清理问题表的自增属性 (3c54b5ea)
- 实现索引清理中心功能 (4d8503dd)
- 删除审核模块冗余的规则初始化 (50680bfd)
- 修复索引清理返回结果的处理逻辑 (5c76828a)
- 修复解析异常类型不匹配的问题 (63bf373e)
- SQL 语句长度上限由 100KB 提升至 10MB (63f1c05a)
- 修正规则代码中的拼写错误 (68958ecf)
- 修正生产环境脚本中的 rule_code 拼写错误 (7a0cb415)
- 新增 SQL 解析异常的存储与展示 (7ac36262)
- 改进索引清理的错误解析逻辑 (a217d29a)
- 修正 SQL 文件中的表名引用错误 (a48745f2)
- 支持通过系统属性控制 ANTLR 解析器线程缓存 (c838152a)
- 删除审核模块冗余的 sqlparser (d6cb5600)
- 工单详情增加审核任务的错误信息 (e0d43f96)
- 新增独占解析器选项，避免多线程并发问题 (e55ab28f)
- 修正审计表字段的注释信息 (ff367629)
慢查询与巡检
- 慢查询表字段类型改为 BIGINT，避免数据溢出 (1e73a083)
- 重构锁等待迁移脚本，分离配置与数据初始化 (33a4dc9a)
- 暂停创建锁等待收集作业 (46124a3f)
- 分片列表支持按实例 ID 筛选，流式查询改为分页 (46678da8)
- 新增锁等待分析的表结构与历史任务迁移脚本 (69bffb60)
- 新增锁等待分析能力与状态管理 (75571801)
- 新增 MySQL 锁等待检测功能与配置步骤 (87731113)
- 代理慢查询列表支持分页与搜索 (88a80813)
- 优化 AI 模型服务，增加重试与错误处理 (912d2d52)
- 新增 MySQL 锁等待分析功能 (afee60c7)
- 手动采集支持协作式取消定时任务 (b53d0ade)
- 优化 TDSQL 代理慢查询的处理性能与异常处理 (bd05ba76)
- 慢查询模板新增调优时间字段与平均查询时间筛选 (fdf34e31)
工作空间与数据源
- 新增数据库克隆工具并完善工具链 (028a6e09)
- 推荐规则模板 ID 拆分为巡检模板与审核模板 (28641176)
- 部署包解析支持文本文件自动识别编码 (345a9235)
- 为查询负载引入专用线程池，优化创建过程 (350e80c5)
- 为 MySQL 查询增加超时设置与重试机制 (488686fd)
- 新增 MySQL 数据库结构导出脚本 (516f8337)
- 支持通过 ZIP 包上传 SQL 与 XML 文件 (ba022907)
- 支持从压缩包归档创建查询负载 (e04e6c85)
集成与开放接口
- 支持多监控路径配置，优化 GitHub Webhook 处理 (0724d015)
- 新增工单审核失败异常，绑定 task 与 ticket 的关系 (72c915bf)
- 支持 webhook 评论回写状态追踪与空 SQL 工单清理 (79c7afbf)
- 接口审核任务增加索引推荐开关 (add5fb60)
- 支持监控目录过滤 (fbf0ffa0)
权限与安全
- 新增平台角色与权限字典管理接口 (0a3e0997)
- 平台角色管理支持更新系统角色的权限 (81a57a40)
- 同步角色权限变更时更新用户关联的组织范围 (928a1d18)
- 实现平台自定义角色的增删改 (d43fb211)
- 新增用户系统角色分配的保存功能 (d55b0350)
- 实现平台权限字典的更新功能 (f4dca8e4)
缺陷修复
- 修复空指针异常并增强错误处理 (ecb8d04f)
SQL 审核与优化
- 审核与集成任务的超时时间由 30 分钟调整为 1440 分钟 (28404b11)
- 分析结果查询增加验证标志字段 (9142db5d)
- 规则模板查询增加启用规则数量字段 (b118f343)
- 修正不同规则类型验证字段的映射错误 (d0c3fcd9)
- 修正工作负载原始文本的查询列引用 (d7bab435)
- 更新生产规则数据，删除无效规则 TableR066 (fa77bae9)
工作空间与数据源
- 修复更新时空字符串被误认为有效值的问题 (f857e00c)
集成与开放接口
- 新增 GitLab 集成的需求分析与设计文档 (2ebb7053)
- 修正 GitHub token 验证的错误码 (392eab55)
- 新增 GitLab 平台集成支持 (5047dfc9)
- 增加 GitLab Webhook 端到端测试支持 (ab257a73)
- GitLab Webhook 报告增强，并修复 secret 存储问题 (dff2c18d)
权限与安全
- 将 GitLab Webhook 路径加入安全配置白名单 (aaa5478e)
SQL 审核与优化
- 工单详情关联审核任务 ID (7100d9ab)
慢查询与巡检
- 增强慢查询模板导出：Excel 格式与性能 (9b7ac56e)
工作空间与数据源
- 工作空间查询结果增加推荐规则模板 ID (1cb2e041)
集成与开放接口
- 监控配置读取增加工作空间定义 ID (41e1dab9)
权限与安全
- 在 WebSecurityConfiguration 中添加 analyses/getStatementList 免认证路径 (02d005ef)
- 更新默认规则修改的权限检查逻辑 (2754cfb9)
- 修复更新默认规则时的权限检查逻辑 (52af8e74)
- 将 workloads/get 接口加入免认证白名单 (89fd2d9f)
缺陷修复
- 处理 SQL 生成结果为空的情况，避免空指针异常 (83484c06)
SQL 审核与优化
- 移除 RuleTemplateRequestDto 的 @Builder 注解并更新调用 (0c652763)
- 修复构建规则树路径时从错误节点开始的问题 (1372bb34)
- 支持前端传递自定义规则进行 SQL 分析 (13f16d7d)
- 修复默认规则模板加载与工单模板选择逻辑 (17ad1d37)
- 审计详情返回规则模板名称 (1dc233b1)
- 新增对象命名规范规则 NCR011 (2706b8af)
- 查询顺序保持改用 LinkedHashMap (3ad1330d)
- 新增索引兜底清理与持久化逻辑 (7916b4f1)
- 过滤非独立类的语法类审核规则；任务中只用 queryadvisor 做规则审核与重写优化；删除 SQLAuditor 的引用 (9dc677d5)
- 修复自定义规则分析时缺失规则名称的问题 (a906ffcc)
- 分析记录增加规则模板信息，并改进工作负载处理 (acbd6c11)
- 统一使用审计规则常量替换分析规则常量 (c15137d0)
- 分页查询最大限制设为 10000 (c75d2447)
慢查询与巡检
- 慢查询模板支持按数据库实例筛选 (57ff85e2)
工作空间与数据源
- openGauss 与 DWS 改用脚本解析器 (1329db77)
- 为脚本型数据库构建文件信息元数据 (9ad57b0d)
- 为查询负载文件添加文件头注释，优先从工作空间解析 orgId (b34b6fec)
集成与开放接口
- 按部署模式调整平台列表查询逻辑 (319a409a)
- 修正集成异常日志中的不准确描述 (3e0f8a86)
- 集成 SQL 审核接口重构为 workspace + template 模式 (621c2826)
- 平台集成支持混合文件模式审核，并优化更新时间传递 (757fad1c)
- 修复 SCM 监控配置中机构 ID 的获取逻辑 (8f447b24)
- SQL 审核任务增加操作人邮箱字段 (bf39eb58)
权限与安全
- 移除审计详情接口的权限校验 (9ed61bba)
- auth 模块合并进 base 模块并重构权限相关代码 (bdf9d885)
SQL 审核与优化
- 修正验证模式下的性能提升计算逻辑 (000aca41)
- 修复性能提升计算中的除零错误 (0e77e069)
- 并发模型重构为纯 CPU 约束，移除 DB 连接池环境变量 (100f80d5)
- 引入双约束模型与批量写入优化以提升并发 (139529e0)
- 增强工单 SQL 执行的稳定性与多数据库支持 (1bd56c24)
- 修复空 SQL 列表导致的空指针异常 (25c6a367)
- 新增并发优化的部署验证指南与运行时监控 (2aab33f3)
- 工单新增机构子树筛选支持，并重构权限检查逻辑 (2ed2c4ea)
- 延迟构建新数据库对象的规则直到批量插入完成 (41b947c7)
- 改进并发限制不足时的日志提示 (42ab6381)
- 新增审核任务来源 DTO 与 JSON 类型处理器 (51e22d63)
- 工单按规则等级信息计算风险等级 (616b0caa)
- 优化 SQL 审核报告生成与行号计算 (6bcd9f82)
- 降低 CPU 乘数以预留更多系统资源 (a2ea8631)
- 工单改用模板版本 ID 直接获取模板配置 (c5b35cd8)
- 修正工作负载原始文本字段的 SQL 逻辑错误 (e7697261)
- 工单支持按机构路径前缀筛选，以包含子机构 (edd97432)
- 新增规则管理功能，支持规则的批量导入与导出 (f28ed784)
- 实现动态并发许可再分配与系统资源监控 (f6312bfc)
- 修复工单创建时 orgId 字段的设置逻辑 (f63cecb8)
- 修复工单查询中当前处理人字段返回多个值的问题 (fa8e0d90)
慢查询与巡检
- 降低慢查询导出行数限制，并优化排名查询 (119e1beb)
- 为多张表添加索引以优化查询性能 (19c86153)
- 慢查询模板列表接口增加处置阶段筛选 (2463fb58)
- 慢查询采集支持可配置的 SQL 与指纹黑名单 (2b8a1167)
- 修复慢查询模板列表按组织筛选的 SQL 错误 (2d816e61)
- 全局慢查询列表增加时间范围校验 (503fe81b)
- 慢查询列表接口增加时间范围过滤 (51645e72)
- 处理全局慢查询列表查询时 dbinstanceId 为空的情况 (7fbf9fba)
- 新增批量更新慢查询模板处置阶段 (98613e83)
- 合并现有慢查询配置，避免字段被覆盖 (a4431444)
- 慢查询按表数量阈值决定是否做 DDL 解析 (b32ce424)
- 慢查询模板新增处置阶段字段与导出 (bd21fc57)
- 新增全局慢查询入口 (e26dd9ba)
- 优化慢查询模板性能并清理废弃代码 (e5b75182)
- 慢查询支持从配置排除特定用户并过滤工具查询 (fd462804)
- 为慢查询相关表添加索引 (ff969091)
工作空间与数据源
- 提高数据库连接池容量上限 (1e24d135)
- 移除解析结果更新工作空间的逻辑，改为记录分析计数 (4440f942)
- 数据库连接池上限由 50 提升至 300 (5a26afe6)
- 实现 SQL 文件位置追踪与混合文件模式支持 (5be1f5a7)
- 修复创建工作空间时 orgId 可能为 null 的问题 (662e4f94)
- 合并工作空间状态更新，减少数据库操作 (6832bebe)
- 全局视图列表接口增加按组织筛选 (688cce76)
- 新增更新工作空间字段的接口，并增加组织名称字段 (7d7e75e5)
- 修复按机构查询工作空间列表时的参数传递逻辑 (935905c4)
- 脚本型数据库支持扩展到 Oracle (c070e790)
- 多个查询结果中显示环境与业务线信息 (efe8b250)
- 批量插入、更新、删除分块处理，避免连接泄漏 (fd1b1ad2)
- 移除 maxWorkloadMembers 配置及相关验证逻辑 (fe9a9aa8)
集成与开放接口
- 为历史审批模板补上缺失的提交复核节点 (077bfb47)
- 修复 Coding Webhook 的事件路由、DTO 映射与配置更新逻辑 (4422ce84)
- 新增 Coding 平台 Webhook 集成支持 (6cef5222)
- 集成平台的权限与表结构支持多机构 (759aa73b)
- 优化 Coding 平台集成与工单信息展示 (83b35d52)
- SQL 审核结果增加结构化摘要数据 (8ad73d7e)
- 重构集成模块以支持机构隔离与自定义审批模板 (8d5d5305)
- 新增 Coding 开放平台 API 根路径端点 (9b30f722)
- 移除平台验证时自动更新 updateTime 的逻辑 (c07937fc)
- 新增 Coding 仓库路径反查 API (d35fcbbf)
权限与安全
- 修复组织路径空字符串检查的 XML 转义问题 (0283fb98)
- 新增权限点，并完善批量导入与机构树功能 (1a214f6c)
- 修复机构树管理权限的默认可见性设置 (1efee0f8)
- 临时禁用分析结果查看的权限校验 (20015bd7)
- 修复角色权限初始化时的重复数据问题 (238c7568)
- 角色检查迁移为权限检查 (245c7a24)
- 修复创建工作空间与实例时的权限验证逻辑 (2f659bb1)
- 创建实例时提前检查权限，避免重复验证 (2ff760fa)
- 修正许可证检查中的变量名错误 (33951ec8)
- 新增获取用户角色范围信息的接口 (3eb9957e)
- 简化权限校验，支持按环境与业务线过滤 (41ae7b64)
- 移除 permission_resource 表中冗余的 is_assignable 字段与索引 (41b7d4da)
- 移除工作空间控制器中多余的权限检查调用 (50945545)
- 移除自定义角色代码生成中的冗余前缀 (55176456)
- 角色管理支持数据范围，新增机构树成员管理接口 (574fa54f)
- 修正权限码命名风格并确保 scope_org_id 默认值 (59496ad6)
- 修复机构树查询接口的权限校验逻辑 (6e7d570c)
- 修正权限资源的描述与分类字段 (6ed91b97)
- 实现机构树管理的基础功能与权限范围元数据 (9e5d17c9)
- 修复创建带本地文件工作空间时的权限检查逻辑 (a23270f7)
- 修正集成平台与监控项管理权限的可见性标识 (a28c2ad3)
- 安全检查中的 IOException 替换为 SqlAuditException (a4c0ce7c)
- 移除权限描述中的 (Gate) 标记并调整默认状态 (a84ce2d3)
- 新增机构编码字段并强化权限校验 (b4190c5e)
- 修正权限资源的默认状态并更新角色权限分配 (bdfb4121)
- 新增基于权限编码的机构可见范围解析 (c1fcd856)
- 新增机构编码字段并完善相关逻辑 (d0d3e18b)
- 修复批量导入用户时机构绑定失败仍尝试角色绑定的问题 (d724e8e4)
- 实现机构树的资源可见性控制 (da514ccb)
- 修复权限查询中的机构范围计算逻辑 (da5e3fba)
- 新增解析顶级机构 ID 的接口用于筛选 (e0555fe3)
- 增加机构编码字段并支持按环境与业务线筛选 (e26dd9ba)
- 修复按组织 ID 查询资源时的权限校验逻辑 (e3468ca3)
- 移除全局规则管理权限并清理权限数据 (e59d9009)
- 组织树成员接口增加创建者与管理员标识 (e704e3e3)
- 为分析、审计与巡检模块增加机构树可见性支持 (f19f973a)
- 移除用户创建时的团队角色逻辑 (f612918c)
- 跳过 dbinstanceId 为 0 的可见性检查 (f77f71e4)
缺陷修复
- 更新操作的返回值检查由等于 1 改为大于 0 (773bcb58)
- 修复数据库查询结果集读取，并优化组织名称关联 (a0b4ad00)