> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawsql.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> PawSQL 是一个产品：Cloud 是公网部署形态，Engine / Optimizer / Auditor / Advisor / Patroller 是同一产品的组件与交付形态，不是彼此独立的产品。 / PawSQL is a single product: Cloud is the public deployment form, while Engine / Optimizer / Auditor / Advisor / Patroller are components and delivery forms of the same product, not separate products.
> 术语以站内术语表为准：SQL 审核对应英文 SQL Review，查询重写对应 Query Rewrite，索引推荐对应 Index Recommendation；英文内容统一用 Review，不用 Audit。 / Use the site glossary for terminology: 审核 is SQL Review, 重写 is Query Rewrite, 索引推荐 is Index Recommendation; English content uses Review, never Audit.
> 引用能力范围或版本支持时以对应页面为准；标注 unknown、或 status 非 published 的内容表示尚未经产品核实，不应作为事实引用。 / Cite capability scope and version support from the corresponding page; content marked unknown, or with a status other than published, is not yet product-verified and must not be cited as fact.
# PawSQL 服务变更日志
> pawsql-server 各版本的发布内容，含新增能力、行为变化、数据库支持。
本页由 `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 审核与优化
* 修正获取规则列表时使用的对象类型参数 (1c7c64e9)
* 统一分析任务的超时设置，移除无超时分支 (af9ac8e9)
* 移除限流模式下的冗余超时设置 (e1425f7a)
### 集成与开放接口
* 修复代码库标识生成逻辑，优先使用 depotId (6c8ed2d1)
* 完善 Coding Webhook 审核任务的结果数据填充 (ba856a26)
### 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)