ai-engineering-init 1.7.0 → 1.10.0

package/.codex/skills/next/SKILL.md

@@ -1,22 +1,8 @@
----
-name: next
-description: |
-  当需要获取项目开发的下一步建议、规划开发方向时自动使用此 Skill。
-
-  触发场景：
-  - 不知道下一步应该做什么
-  - 需要获取开发优先级建议
-  - 需要分析当前项目状态并给出建议
-  - 需要规划开发工作方向
-
-  触发词：下一步、next、建议、做什么、开发方向、优先级、工作建议、开发建议
----
-
 # /next - 下一步建议
 
 作为项目开发顾问，根据当前项目状态，为您建议下一步应该做什么。
 
-## 🎯 执行流程
+## 执行流程
 
 ### 第一步：快速扫描项目状态
 
@@ -25,39 +11,55 @@ description: |
 git log -5 --oneline
 
 # 扫描所有业务模块中的 TODO/FIXME
-Grep pattern: "TODO:|FIXME:" path: ruoyi-modules/ glob: "*.java" output_mode: content -B 2
+Grep pattern: "TODO:|FIXME:" path: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 2
+
+# 检查代码规范问题
+Grep pattern: "package org\.dromara\.|package com\.ruoyi\." path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "MapstructUtils|ServiceException" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
 
-# 检查代码规范和问题
-Grep pattern: "package com\.ruoyi\.|BeanUtil\.copy" path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
+# 扫描 OpenSpec 活跃变更（如果存在 openspec 目录）
+Glob pattern: "openspec/changes/*/tasks.md"
+# 对每个找到的 tasks.md，读取内容检查任务完成状态（[ ] 未完成 / [x] 已完成）
 ```
 
 ### 第二步：分析开发阶段
 
+根据代码完整性和功能数量判断：
+
 | 阶段 | 特征 | 功能完成率 |
 |------|------|----------|
 | 🟢 初期 | 基础框架搭建，功能模块较少 | < 30% |
 | 🟡 中期 | 核心功能开发中，模块逐步完善 | 30-70% |
 | 🔴 后期 | 功能基本完成，处于优化阶段 | > 70% |
 
-### 第三步：分类问题和建议
+### 第三步：分析 OpenSpec 变更状态（如有）
+
+如果发现 `openspec/changes/` 下有活跃变更：
+
+1. 读取每个变更的 `tasks.md`，统计未完成任务
+2. 读取 `proposal.md` 获取变更概述
+3. 将未完成的 OpenSpec 任务纳入建议优先级
+
+### 第四步：分类问题和建议
 
 - **紧急问题**：安全漏洞、严重 Bug、编译错误
+- **OpenSpec 待实现**：已拆解但未完成的变更任务
 - **重要问题**：功能缺陷、设计问题、规范问题
 - **优化建议**：性能优化、代码重构、文档完善
 
 ---
 
-## 📊 输出格式
+## 输出格式
 
 ```markdown
-# 🎯 下一步建议
+# 下一步建议
 
 **分析时间**：YYYY-MM-DD HH:mm
 **分析范围**：全量后端代码
 
 ---
 
-## 📌 当前状态
+## 当前状态
 
 ### Git 提交分析
 - **最近一次提交**：[commit message] ([commit hash])
@@ -66,64 +68,197 @@ Grep pattern: "package com\.ruoyi\.|BeanUtil\.copy" path: ruoyi-modules/ glob: "
 
 ### 代码状态
 - **开发阶段**：🟡 中期（核心功能开发中）
-- **代码质量**：良好（无 com.ruoyi 包名问题）
-- **规范问题**：3 个接口缺少 @SaCheckPermission 注解
+- **代码质量**：良好（包名符合 net.xnzn.core.*）
+- **规范问题**：3 个接口缺少 @RequiresAuthentication 注解
 
 ### 代码待办统计
 - **TODO 项**：X 个
 - **FIXME 项**：X 个
 - **编译/运行错误**：无
 
+### OpenSpec 变更状态（如有活跃变更）
+- **活跃变更**：X 个
+- **待实现任务**：X 个
+- **变更列表**：
+  - `[变更名]`：X/Y 任务完成（[proposal 概述]）
+
 ---
 
-## 🚀 建议优先级
+## 建议优先级
 
 ### 🔴 高优先级（必须立即处理）
 
 1. **修复 FIXME 问题**
-   - 位置：ruoyi-demo/PaymentService.java:156
-   - 问题：退款金额计算错误
+   - 位置：sys-canteen/.../service/impl/XxxService.java:156
+   - 问题：业务逻辑存在已知错误
+   - 原因：影响核心业务正确性
+   - 影响：可能导致数据异常
    - **快速修复**：`/check` 找出所有 FIXME 并逐一解决
 
 2. **补充缺失的权限注解**
-   - 位置：ruoyi-demo 模块 3 个接口
-   - **快速修复**：`/check demo` 查出所有问题接口
+   - 位置：sys-canteen 模块 3 个接口
+   - 问题：缺少 @RequiresAuthentication 或 @RequiresGuest 注解
+   - 原因：权限控制不完整
+   - 影响：系统存在未授权访问风险
+   - **快速修复**：`/check canteen` 查出所有问题接口
+
+3. **完善代码规范**
+   - 问题：部分接口 POST 请求未使用 LeRequest<T> 封装
+   - 原因：请求封装规范不一致
+   - 影响：后续维护成本高
+   - **快速修复**：`/check` 全量检查
 
 ### 🟡 中优先级（近期应该做）
 
 1. **补充缺失功能模块**
-   - **快速开发**：`/crud Payment` 快速生成 CRUD 代码
+   - 建议模块：[根据扫描结果列出未完成的业务模块]
+   - 完成率：目前 X%，建议提升到 80%
+   - **快速开发**：`/crud [表名]` 快速生成 CRUD 代码
 
 2. **优化 Service 查询层**
-   - **参考代码**：ruoyi-system/SysNoticeServiceImpl.java
+   - 建议模块：[根据扫描结果列出查询不完善的模块]
+   - 问题：buildWrapper 查询条件需要完善
+   - 价值：提升查询效率，支持更复杂的搜索
+   - **参考代码**：`sys-canteen/.../order/common/service/impl/OrderInfoService.java`
+
+3. **补充接口文档注释**
+   - 建议范围：所有 Controller 接口
+   - 目标：添加 @Api、@ApiOperation Swagger 文档注解、JavaDoc 方法注释
+   - 价值：便于接口文档自动生成
 
 ### 🟢 低优先级（可以考虑）
 
 1. **性能优化**
+   - 建议项：添加查询缓存、分页优化
+   - 触发条件：数据量大时
+
 2. **代码重构**
+   - 建议项：提取通用工具类、统一错误处理
+
 3. **单元测试**
+   - 建议项：为核心 Service 添加单元测试
+   - 触发条件：功能稳定后
 
 ---
 
-## 💡 具体行动建议
+## 具体行动建议
+
+### 如果有未完成的 OpenSpec 变更：
+
+**推荐：继续实现已拆解的任务**
+- 变更名称：`[change-name]`
+- 未完成任务：[列出 tasks.md 中 [ ] 的任务]
+- **快速开始**：
+  ```bash
+  /opsx:apply [change-name]   # 自动实现下一个任务
+  /dev [任务描述]              # 手动实现特定任务
+  ```
 
 ### 如果您想继续开发新功能：
 
-```bash
-/crud Payment        # 快速生成 Payment 模块
-/check business      # 检查并修复规范问题
-```
+**推荐 1：完善业务模块**
+- 建议实现：[根据扫描结果列出未完成的功能]
+- 所属模块：[sys-canteen / sys-kitchen / sys-drp / sys-common]
+- **快速开始**：
+  ```bash
+  /crud [表名]          # 快速生成 CRUD 代码
+  /check [模块名]       # 检查并修复规范问题
+  ```
+
+**推荐 2：开发新的业务功能**
+- 建议实现：[根据项目进展推荐下一个业务功能]
+- **快速开始**：
+  ```bash
+  /dev 功能名称   # 使用向导开发新功能（含表设计）
+  ```
 
 ### 如果您想优化代码质量：
 
-```bash
-/check               # 全量检查
-/check business      # 按模块检查
-```
+**推荐 1：规范检查和修复**
+- 建议优化：修复所有代码规范问题
+- **快速检查**：
+  ```bash
+  /check               # 全量检查
+  /check canteen       # 按模块检查
+  ```
+
+**推荐 2：Service 层优化**
+- 建议优化：完善 buildWrapper 实现，支持更复杂的查询
+- **参考代码**：`sys-canteen/.../order/common/service/impl/OrderInfoService.java`
+
+**推荐 3：注释和文档**
+- 建议优化：添加 JavaDoc 注释
+- 位置：所有 Controller 接口和关键 Service 方法
+
+### 如果您想修复现存问题：
+
+**按严重程度排序的问题列表**：
+
+#### 🔴 严重问题（立即修复）
+- **FIXME 问题**：[根据扫描结果列出 FIXME 位置和内容]
+- **权限注解缺失**：[根据扫描结果列出缺少 @RequiresAuthentication 的接口]
+- **命令**：`/check [模块名]`
+
+#### 🟡 重要问题（本周修复）
+- **LeRequest 封装缺失**：[根据扫描结果列出未使用 LeRequest<T> 的 POST 接口]
+- **del_flag 值错误**：[扫描是否有 delFlag=0 的设置]
+- **命令**：`/check [模块名]`
+
+#### 🟢 建议问题（择机修复）
+- **缺少接口文档**：所有 Controller
+- **缺少业务注释**：部分 Service 方法
+- **命令**：逐一完善
+
+---
+
+## 开发建议
+
+### 开发流程建议
+
+1. **明确需求**：使用 `/start` 快速了解项目结构
+2. **检查规范**：使用 `/check` 检查代码质量
+3. **分析进度**：使用 `/progress` 了解完成情况
+4. **开始开发**：使用 `/dev` 或 `/crud` 快速生成代码
+5. **添加待办**：使用 `/add-todo` 跟踪任务
+6. **获取建议**：使用 `/next` 确定下一步方向
+
+### 最佳实践
+
+| 实践 | 说明 |
+|------|------|
+| 四层职责清晰 | Controller 路由 → Business 编排 → Service 单表 → Mapper ORM |
+| 查询构建 | 在 Service 层用 LambdaQueryWrapper 构建，禁止在 Controller 层 |
+| 对象转换 | 使用 BeanUtil.copyProperties()，禁止 MapstructUtils |
+| 权限管理 | 所有接口必须有 @RequiresAuthentication 或 @RequiresGuest |
+| 请求封装 | POST 请求体统一使用 LeRequest<T>，通过 request.getContent() 获取参数 |
+| 注释完整 | 关键方法必须有 JavaDoc 注释 |
+| 定期检查 | 每周至少一次运行 `/check` 和 `/progress` |
+
+### 技术选型建议
+
+| 场景 | 推荐方案 | 理由 |
+|------|--------|------|
+| 快速生成 CRUD | `/crud` 命令 | 已有表结构时最快 |
+| 从零开发功能 | `/dev` 命令 | 包含数据库设计和代码生成 |
+| 代码规范检查 | `/check` 命令 | 及时发现问题 |
+| 项目进度追踪 | `/progress` 命令 | 定期了解完成情况 |
 
 ---
 
-## 🔗 相关命令
+## 需要确认的问题
+
+### 如果不确定下一步方向，请回答：
+
+- [ ] **您更希望继续开发功能，还是优化现有代码？**
+  - 选项 A：继续开发新功能（推荐 `/crud` 或 `/dev` 命令）
+  - 选项 B：优化现有代码（推荐 `/check` 和 `/progress` 命令）
+
+- [ ] **是否需要为新开发的功能添加到待办列表中？**
+  - 可使用 `/add-todo` 快速添加
+
+---
+
+## 相关命令
 
 | 命令 | 用途 | 何时使用 |
 |------|------|---------|
@@ -134,4 +269,13 @@ Grep pattern: "package com\.ruoyi\.|BeanUtil\.copy" path: ruoyi-modules/ glob: "
 | `/dev` | 开发新功能 | 从零开始开发 |
 | `/crud` | 快速生成代码 | 表已存在时 |
 | `/add-todo` | 添加待办任务 | 跟踪任务 |
-```
+
+---
+
+## 说明
+
+- 本建议基于对当前项目代码的分析生成
+- 建议具体且可执行，不空泛
+- 会考虑开发的连贯性和代码质量
+- 如发现紧急问题会明确标注
+- 如不确定用户意图会主动询问

package/.codex/skills/performance-doctor/SKILL.md

@@ -10,9 +10,8 @@ description: |
   - 分页查询优化
   - N+1 查询问题
   - 批量操作超时
-  - 多租户查询优化
 
-  触发词:性能优化、慢查询、SQL优化、索引优化、缓存、Redis缓存、N+1、分页优化、EXPLAIN、响应慢、批量操作、多租户优化
+  触发词:性能优化、慢查询、SQL优化、索引优化、缓存、Redis缓存、N+1、分页优化、EXPLAIN、响应慢、批量操作
 
   注意:如果是排查功能性 Bug(代码报错、逻辑错误),请使用 bug-detective。
 ---
@@ -23,7 +22,7 @@ description: |
 
 ```
 1. 定位 -> 接口层面(响应时间) / SQL层面(慢查询) / 缓存层面(命中率)
-2. 分析 -> p6spy SQL 日志 / Arthas JVM 诊断 / 日志分析
+2. 分析 -> SQL 日志 / Arthas JVM 诊断 / 日志分析
 3. 优化 -> 索引 / 缓存 / 批量处理
 4. 验证 -> 对比优化前后指标
 ```
@@ -33,51 +32,46 @@ description: |
 | 指标 | 良好 | 需优化 | 工具 |
 |------|------|--------|------|
 | 接口响应 | < 200ms | > 500ms | p6spy/SkyWalking |
-| 数据库查询 | < 50ms | > 200ms | p6spy SQL 日志 |
+| 数据库查询 | < 50ms | > 200ms | SQL 日志 |
 | 内存使用 | < 70% | > 85% | Arthas/JVM 监控 |
 
 ---
 
 ## 1. MyBatis-Plus 查询优化
 
-> 源码：`ruoyi-modules/ruoyi-demo/.../TestDemoServiceImpl.java:62-73`
-
 ### 查询构建规范
 
 ```java
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.toolkit.Wrappers;
 
-private LambdaQueryWrapper<TestDemo> buildQueryWrapper(TestDemoBo bo) {
-    Map<String, Object> params = bo.getParams();
-    LambdaQueryWrapper<TestDemo> lqw = Wrappers.lambdaQuery();
-    lqw.eq(bo.getDeptId() != null, TestDemo::getDeptId, bo.getDeptId());
-    lqw.like(StringUtils.isNotBlank(bo.getTestKey()), TestDemo::getTestKey, bo.getTestKey());
-    lqw.between(params.get("beginCreateTime") != null && params.get("endCreateTime") != null,
-        TestDemo::getCreateTime, params.get("beginCreateTime"), params.get("endCreateTime"));
+private LambdaQueryWrapper<XxxEntity> buildQueryWrapper(XxxQueryDTO query) {
+    LambdaQueryWrapper<XxxEntity> lqw = Wrappers.lambdaQuery();
+    lqw.eq(query.getDeptId() != null, XxxEntity::getDeptId, query.getDeptId());
+    lqw.like(StrUtil.isNotBlank(query.getKeyword()), XxxEntity::getName, query.getKeyword());
+    lqw.between(query.getStartTime() != null && query.getEndTime() != null,
+        XxxEntity::getCreateTime, query.getStartTime(), query.getEndTime());
     return lqw;
 }
 ```
 
 ### 更新构建规范
 
-> 源码：`ruoyi-modules/ruoyi-system/.../SysUserServiceImpl.java:383-404`
-
 ```java
 import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
 
 // 精确更新
 baseMapper.update(null,
-    new LambdaUpdateWrapper<SysUser>()
-        .set(SysUser::getStatus, status)
-        .eq(SysUser::getUserId, userId));
+    new LambdaUpdateWrapper<XxxEntity>()
+        .set(XxxEntity::getStatus, status)
+        .eq(XxxEntity::getId, id));
 
 // 条件更新（非null才设置）
 baseMapper.update(null,
-    new LambdaUpdateWrapper<SysUser>()
-        .set(ObjectUtil.isNotNull(user.getNickName()), SysUser::getNickName, user.getNickName())
-        .set(SysUser::getPhonenumber, user.getPhonenumber())
-        .eq(SysUser::getUserId, user.getUserId()));
+    new LambdaUpdateWrapper<XxxEntity>()
+        .set(ObjectUtil.isNotNull(entity.getName()), XxxEntity::getName, entity.getName())
+        .set(XxxEntity::getPhone, entity.getPhone())
+        .eq(XxxEntity::getId, entity.getId()));
 ```
 
 ### 批量更新
@@ -94,15 +88,15 @@ Db.updateBatchById(entityList);
 ### N+1 查询修复
 
 ```java
-// 错误：循环查询
+// ❌ 错误：循环查询
 for (Order order : orders) {
     User user = userMapper.selectById(order.getUserId());
 }
 
-// 正确：批量查询 + Map 映射
+// ✅ 正确：批量查询 + Map 映射
 List<Long> userIds = orders.stream().map(Order::getUserId).distinct().toList();
 Map<Long, User> userMap = userMapper.selectBatchIds(userIds).stream()
-    .collect(Collectors.toMap(User::getUserId, Function.identity()));
+    .collect(Collectors.toMap(User::getId, Function.identity()));
 for (Order order : orders) {
     User user = userMap.get(order.getUserId());
 }
@@ -112,17 +106,21 @@ for (Order order : orders) {
 
 ## 2. 缓存优化
 
-> 源码：`ruoyi-common/ruoyi-common-redis/.../RedisUtils.java`
-
-### RedisUtils 操作
+### Redisson 缓存操作
 
 ```java
-import org.dromara.common.redis.utils.RedisUtils;
+import org.redisson.api.RedissonClient;
+import org.redisson.api.RBucket;
+
+// 设置缓存
+RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
+bucket.set(userVo, Duration.ofMinutes(30));
 
-RedisUtils.setCacheObject("user:" + id, userVo, Duration.ofMinutes(30));
-UserVo cached = RedisUtils.getCacheObject("user:" + id);
-RedisUtils.deleteObject("user:" + id);
-boolean exists = RedisUtils.isExistsObject("user:" + id);
+// 获取缓存
+UserVo cached = redissonClient.<UserVo>getBucket("user:" + id).get();
+
+// 删除缓存
+redissonClient.getBucket("user:" + id).delete();
 ```
 
 ### Spring Cache 注解
@@ -137,40 +135,42 @@ public int update(UserBo bo) { ... }
 
 > **@Cacheable 禁止返回不可变集合**（`List.of()`、`Set.of()`），Redis 反序列化会失败。必须用 `new ArrayList<>(List.of(...))`。
 
-### 分布式锁（Lock4j）
-
-> 源码：`ruoyi-modules/ruoyi-demo/.../RedisLockController.java:47-67`
+### 分布式锁
 
 ```java
-import com.baomidou.lock.annotation.Lock4j;
-import com.baomidou.lock.LockTemplate;
-import com.baomidou.lock.LockInfo;
-import com.baomidou.lock.executor.RedissonLockExecutor;
-
-// 注解方式（推荐）
-@Lock4j(keys = {"#key"}, expire = 60000, acquireTimeout = 3000)
-public void doSomething(String key) { ... }
-
-// 编程方式
-LockInfo lockInfo = lockTemplate.lock(key, 30000L, 5000L, RedissonLockExecutor.class);
-if (null == lockInfo) {
-    throw new ServiceException("业务处理中，请稍后再试");
-}
+import org.redisson.api.RLock;
+
+// 注入 RedissonClient
+RLock lock = redissonClient.getLock("lock:order:" + orderId);
 try {
-    // 业务逻辑
-} finally {
-    lockTemplate.releaseLock(lockInfo);
+    if (lock.tryLock(3, 10, TimeUnit.SECONDS)) {
+        try {
+            // 业务逻辑
+        } finally {
+            if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                lock.unlock();
+            }
+        }
+    } else {
+        throw new [你的异常类]("业务处理中，请稍后再试");
+    }
+} catch (InterruptedException e) {
+    Thread.currentThread().interrupt();
+    throw new [你的异常类]("操作被中断");
 }
 ```
 
 ### 限流
 
 ```java
+import org.redisson.api.RRateLimiter;
 import org.redisson.api.RateType;
+import org.redisson.api.RateIntervalUnit;
 
-long remaining = RedisUtils.rateLimiter("api:rate:" + userId, RateType.OVERALL, 100, 60);
-if (remaining < 0) {
-    throw new ServiceException("请求过于频繁");
+RRateLimiter limiter = redissonClient.getRateLimiter("api:rate:" + userId);
+limiter.trySetRate(RateType.OVERALL, 100, 60, RateIntervalUnit.SECONDS);
+if (!limiter.tryAcquire()) {
+    throw new [你的异常类]("请求过于频繁");
 }
 ```
 
@@ -187,23 +187,26 @@ private final Cache<Long, UserVo> localCache = Caffeine.newBuilder()
 
 public UserVo getUser(Long id) {
     return localCache.get(id, key -> {
-        UserVo cached = RedisUtils.getCacheObject("user:" + id);
-        return cached != null ? cached : baseMapper.selectVoById(id);
+        RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
+        UserVo cached = bucket.get();
+        return cached != null ? cached : baseMapper.selectById(id);
     });
 }
 ```
 
 ---
 
-## 3. 多租户优化
+## 3. 索引优化
 
 ```sql
--- tenant_id 必须建索引
-CREATE INDEX idx_tenant_id ON xxx_table(tenant_id);
+-- 为高频查询字段添加索引
+CREATE INDEX idx_status ON xxx_table(status);
+
+-- 复合索引：遵循最左前缀原则
+CREATE INDEX idx_status_create_time ON xxx_table(status, create_time);
 
--- 复合索引第一列放 tenant_id（多租户自动添加 tenant_id 条件）
-CREATE INDEX idx_tenant_status ON xxx_table(tenant_id, status);
-CREATE INDEX idx_tenant_create_time ON xxx_table(tenant_id, create_time);
+-- 使用 EXPLAIN 分析查询
+EXPLAIN SELECT * FROM xxx_table WHERE status = 1 AND create_time > '2026-01-01';
 ```
 
 ---
@@ -212,7 +215,7 @@ CREATE INDEX idx_tenant_create_time ON xxx_table(tenant_id, create_time);
 
 ```java
 // 推荐：分批处理（每批500条）
-public void batchInsert(List<Xxx> list) {
+public void batchInsert(List<XxxEntity> list) {
     int batchSize = 500;
     for (int i = 0; i < list.size(); i += batchSize) {
         int end = Math.min(i + batchSize, list.size());
@@ -222,12 +225,13 @@ public void batchInsert(List<Xxx> list) {
 
 // 批量更新同理
 @Transactional(rollbackFor = Exception.class)
-public void batchUpdate(List<XxxBo> list) {
+public void batchUpdate(List<XxxDTO> list) {
     int batchSize = 500;
     for (int i = 0; i < list.size(); i += batchSize) {
         int end = Math.min(i + batchSize, list.size());
-        List<Xxx> batch = list.subList(i, end).stream()
-            .map(bo -> MapstructUtils.convert(bo, Xxx.class)).toList();
+        List<XxxEntity> batch = list.subList(i, end).stream()
+            .map(dto -> BeanUtil.copyProperties(dto, XxxEntity.class))
+            .toList();
         Db.updateBatchById(batch);
     }
 }
@@ -237,15 +241,6 @@ public void batchUpdate(List<XxxBo> list) {
 
 ## 5. 性能日志分析
 
-> 日志配置：`ruoyi-admin/src/main/resources/logback-plus.xml:52-72`
-
-### 日志文件
-
-| 环境 | 文件 | 说明 |
-|------|------|------|
-| **开发** | `./logs/console.log` | 每次启动清空，含 SQL 日志 |
-| 生产 | `./logs/sys-*.log` | 按天滚动，保留60天 |
-
 ### SQL 监控
 
 开发环境 p6spy 默认开启：`spring.datasource.dynamic.p6spy: true`
@@ -253,18 +248,9 @@ public void batchUpdate(List<XxxBo> list) {
 日志格式：
 ```
 2026-01-08 22:12:10 [req-123] [...] INFO p6spy - Consume Time:245 ms
-Execute SQL:SELECT * FROM sys_user WHERE tenant_id = '000000' AND del_flag = '0'
+Execute SQL:SELECT * FROM user WHERE status = 1
 ```
 
-### AI 主动读日志的触发条件
-
-| 场景 | 关键词 | 分析重点 |
-|------|--------|---------|
-| 接口慢 | "接口慢"、"超时" | SQL 执行时间、N+1 查询 |
-| SQL 慢 | "SQL慢"、"查询慢" | p6spy Consume Time |
-| 内存/CPU | "内存高"、"卡顿" | OOM、GC、线程池满 |
-| 频繁报错 | "一直报错" | ERROR 日志、异常频率 |
-
 ### 分析命令
 
 ```bash
@@ -278,6 +264,15 @@ grep "Execute SQL" ./logs/console.log | sed 's/WHERE.*/WHERE .../' | sort | uniq
 grep "ERROR" ./logs/console.log | tail -50
 ```
 
+### AI 主动读日志的触发条件
+
+| 场景 | 关键词 | 分析重点 |
+|------|--------|---------|
+| 接口慢 | "接口慢"、"超时" | SQL 执行时间、N+1 查询 |
+| SQL 慢 | "SQL慢"、"查询慢" | p6spy Consume Time |
+| 内存/CPU | "内存高"、"卡顿" | OOM、GC、线程池满 |
+| 频繁报错 | "一直报错" | ERROR 日志、异常频率 |
+
 ---
 
 ## 常见问题速查
@@ -286,10 +281,9 @@ grep "ERROR" ./logs/console.log | tail -50
 |------|------|------|
 | 接口响应慢 | SQL 无索引 | 添加索引，EXPLAIN 分析 |
 | 接口响应慢 | N+1 查询 | 批量查询 + Map 映射 |
-| 接口响应慢 | 未缓存 | RedisUtils 或 @Cacheable |
+| 接口响应慢 | 未缓存 | Redisson 或 @Cacheable |
 | 分页查询慢 | 深分页 | 游标分页或限制页码 |
 | 批量操作超时 | 数据量太大 | 分批500条处理 |
-| 多租户查询慢 | tenant_id 无索引 | 添加 tenant_id 复合索引 |
 | 内存溢出 | 大数据量一次加载 | 分批/流式处理 |
 
 ---