leniu-dev 2.0.0

package/.cursor/skills/banana-image/scripts/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "banana-image-scripts",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "generate": "npx tsx banana_image_exec.ts"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "undici": "^7.16.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}

package/.cursor/skills/banana-image/scripts/requirements.txt

@@ -0,0 +1,10 @@
+# banana-image skill Python dependencies
+# Python 3.9+ required
+# Used for template processing and batch preparation scripts
+
+# No external dependencies - uses standard library only
+# - json
+# - csv
+# - argparse
+# - pathlib
+# - re

package/.cursor/skills/banana-image/templates/poster.json

@@ -0,0 +1,22 @@
+{
+  "name": "电影海报",
+  "description": "电影级海报设计",
+  "prompt_template": "Design a cinematic movie poster for '{{title}}' about {{theme}}. Dramatic lighting, central hero composition, atmospheric fog or effects. Hollywood blockbuster aesthetic, detailed, vertical composition. No text, focus on visual art.",
+  "defaults": {
+    "model_tier": "pro",
+    "resolution": "4k",
+    "aspect_ratio": "2:3",
+    "enable_grounding": true,
+    "thinking_level": "high"
+  },
+  "placeholders": {
+    "title": {
+      "description": "电影标题",
+      "example": "The Last Guardian"
+    },
+    "theme": {
+      "description": "电影主题/故事",
+      "example": "a lone warrior protecting an ancient temple"
+    }
+  }
+}

package/.cursor/skills/banana-image/templates/product.json

@@ -0,0 +1,17 @@
+{
+  "name": "产品图",
+  "description": "专业产品摄影风格",
+  "prompt_template": "Create a professional, high-end product photography shot of {{product}}. Studio lighting with softbox, rim lighting to highlight edges. Minimalist background, neutral color. Ultra-detailed, commercial advertisement standard, focus on texture and material quality.",
+  "defaults": {
+    "model_tier": "pro",
+    "resolution": "4k",
+    "aspect_ratio": "4:5",
+    "enable_grounding": true
+  },
+  "placeholders": {
+    "product": {
+      "description": "产品名称和描述",
+      "example": "a sleek black coffee maker with chrome accents"
+    }
+  }
+}

package/.cursor/skills/banana-image/templates/social.json

@@ -0,0 +1,22 @@
+{
+  "name": "社交媒体图",
+  "description": "Instagram/微博等社交平台方图",
+  "prompt_template": "Create a visually appealing social media post image about {{subject}}. Modern, clean aesthetic with good composition. Suitable for Instagram feed. {{style}}",
+  "defaults": {
+    "model_tier": "flash",
+    "resolution": "2k",
+    "aspect_ratio": "1:1",
+    "enable_grounding": false
+  },
+  "placeholders": {
+    "subject": {
+      "description": "图片主题",
+      "example": "morning coffee with a cozy atmosphere"
+    },
+    "style": {
+      "description": "风格说明（可选）",
+      "example": "Minimalist, warm tones, lifestyle photography style.",
+      "optional": true
+    }
+  }
+}

package/.cursor/skills/banana-image/templates/thumbnail.json

@@ -0,0 +1,17 @@
+{
+  "name": "YouTube缩略图",
+  "description": "吸引眼球的视频封面",
+  "prompt_template": "Design a click-worthy YouTube thumbnail for a video about {{topic}}. High contrast, vibrant colors, expressive focal point. Leave negative space for text overlay. Digital art style, dynamic composition, rule of thirds.",
+  "defaults": {
+    "model_tier": "flash",
+    "resolution": "2k",
+    "aspect_ratio": "16:9",
+    "enable_grounding": false
+  },
+  "placeholders": {
+    "topic": {
+      "description": "视频主题",
+      "example": "cooking Italian pasta from scratch"
+    }
+  }
+}

package/.cursor/skills/brainstorm/SKILL.md

@@ -0,0 +1,216 @@
+---
+name: brainstorm
+description: |
+  当需要探索方案、头脑风暴、创意思维时自动使用此 Skill。
+
+  触发场景：
+  - 不知道怎么设计
+  - 需要多种方案对比
+  - 架构讨论与功能规划
+  - 业务扩展方向探索
+  - 模块划分决策
+
+  触发词：头脑风暴、方案、怎么设计、有什么办法、创意、讨论、探索、想法、建议、怎么做、如何实现、有哪些方式、能不能做、可以实现吗
+---
+
+# 头脑风暴框架
+
+## 本项目技术约束（方案边界）
+
+### 已集成技术
+
+| 层面 | 技术 | 说明 |
+|------|------|------|
+| **框架** | Spring Boot 3.5.9 | 核心框架 |
+| **ORM** | MyBatis-Plus 3.5.16 | 数据持久层 |
+| **缓存** | Redis + Redisson（Caffeine 本地缓存）| 分布式+本地缓存 |
+| **消息** | Redis Streams | 轻量消息队列 |
+| **定时** | SnailJob + @Scheduled | 分布式定时任务 |
+| **认证** | Sa-Token 1.44.0 | 权限与认证 |
+| **实时** | WebSocket + SSE | 实时推送 |
+| **存储** | AWS S3 SDK | MinIO 兼容 |
+| **加密** | AES/RSA | 字段级加密 |
+| **短信** | SMS4j | 多平台短信 |
+| **邮件** | Spring Mail | 邮件发送 |
+| **登录** | JustAuth | OAuth2（30+ 平台） |
+| **Excel** | FastExcel | 导入导出 |
+
+### 需自行扩展的技术
+
+| 技术 | 场景 |
+|------|------|
+| **RocketMQ** | 高吞吐消息队列、分布式事务 |
+| **MQTT** | IoT 设备通信（mica-mqtt） |
+| **LangChain4j** | AI 大模型集成 |
+| **支付模块** | 微信/支付宝（IJPay 等） |
+
+### 可复用 Common 模块（24个）
+
+```
+核心: core, web, security, log, doc, bom
+数据: mybatis, redis, json, encrypt, sensitive, oss, excel
+认证: satoken, tenant, social
+通信: mail, sms, websocket, sse
+业务: job(SnailJob), idempotent, ratelimiter, translation
+```
+
+---
+
+## 决策维度（必须考虑）
+
+| 维度 | 关键问题 | 实现要点 |
+|------|---------|---------|
+| **三层架构** | 如何分层？ | Controller -> Service -> Mapper（无 DAO 层） |
+| **模块归属** | 属于哪个模块？ | sys/demo/wf（标准）或 b/m/iot/crm（业务） |
+| **多租户** | 需要隔离？ | Entity 继承 TenantEntity，自动 SQL 过滤 |
+| **多端** | 哪些端需要？ | 同一套 API，按需扩展前端 |
+| **多数据库** | 要兼容多库？ | SQL 脚本同步 MySQL/Oracle/PG/SQLServer |
+
+### 方案评估矩阵
+
+```markdown
+| 方案 | 复用度(25%) | 多端(20%) | 多租户(20%) | 多数据库(15%) | 开发量(20%) | 总分 |
+|------|-------------|-----------|-------------|---------------|-------------|------|
+| 方案A | ? | ? | ? | ? | ? | ? |
+| 方案B | ? | ? | ? | ? | ? | ? |
+
+评分说明：1-10分，分数越高越好
+- 开发量：分数越高=工作量越少
+```
+
+---
+
+## 方案探索模板
+
+### 问题定义
+
+```markdown
+- **是什么**: [功能描述]
+- **模块归属**: base / mall / crm / iot / 新模块
+- **端支持**: PC端 / 移动端 / 两者
+- **租户**: 需要隔离 / 系统级
+- **数据库**: MySQL only / 多库兼容
+```
+
+### 可复用资源盘点
+
+```markdown
+| 资源 | 类型 | 复用程度 |
+|------|------|---------|
+| ruoyi-common-xxx | 模块 | 完全/部分/参考 |
+| 现有 Xxx 功能 | 代码 | 参考模式 |
+```
+
+### 方案对比（至少2个）
+
+```markdown
+### 方案 A: 最大复用（优先考虑）
+- **复用**: [列出模块/代码]
+- **新开发**: [列出新写部分]
+- **优缺点**: [简述]
+
+### 方案 B: 适度扩展
+- **复用**: [列出模块/代码]
+- **新开发**: [列出新写部分]
+- **优缺点**: [简述]
+```
+
+### 推荐方案
+
+```markdown
+**推荐**: 方案 [X]
+**理由**: [1-3条]
+**实施步骤**:
+1. [ ] 数据库设计 -> database-ops
+2. [ ] 后端开发 -> crud-development
+3. [ ] 测试验证
+**风险点**: [风险] -> [应对策略]
+```
+
+---
+
+## 典型场景速查
+
+### 新增业务管理模块
+
+```
+需求示例：优惠券管理
+
+模块归属 -> mall（商城相关）
+功能拆解 -> 模板管理 / 发放 / 使用 / 统计
+可复用 -> Ad模块(CRUD模板) + redis(分布式锁) + SnailJob(过期作废) + 字典(类型/状态)
+表设计 -> m_coupon_template, m_coupon_record
+```
+
+### 接入第三方服务
+
+```
+可复用 -> encrypt(密钥存储) + redis(结果缓存) + Platform(配置存储)
+实现 -> 接口+实现类（策略模式支持扩展）
+注意 -> 密钥加密 + @RateLimiter频率限制 + 失败降级
+```
+
+### 实时通信
+
+```
+WebSocket(双向,已集成) ✅ 首选 | SSE(单向推送,已集成) | 轮询(不推荐)
+消息类型 -> 广播(全连接) / 点对点(特定用户) / 组播(群组) / 主题订阅
+可复用 -> websocket模块 + redis(在线状态/多实例同步)
+```
+
+### 数据统计报表
+
+```
+方案选择 -> 小数据(<100万):实时查询 | 中数据:预计算+缓存(推荐) | 大数据:分析引擎
+可复用 -> FastExcel(导出) + SnailJob(预计算) + redis(结果缓存)
+```
+
+### AI 功能集成
+
+```
+需自行引入 LangChain4j Maven 依赖
+可复用 -> SSE(流式响应) + redis(会话上下文)
+模型推荐 -> DeepSeek(国产便宜) / ChatGPT / Claude
+需开发 -> ChatSession表 + ChatMessage表 + AiService + 模型配置
+```
+
+---
+
+## 常见问题快速决策
+
+| 问题 | 推荐 | 原因 |
+|------|------|------|
+| 新功能放哪个模块？ | 看业务相关性 | base=基础、mall=商城、crm=客户、iot=设备 |
+| WebSocket vs SSE？ | WebSocket | 双向通信、已有封装 |
+| RocketMQ vs Redis？ | Redis 优先 | Streams 简单场景够用 |
+| 要支持多数据库？ | 是 | 项目标准，SQL 脚本同步 4 库 |
+| 要支持多租户？ | 业务数据要 | TenantEntity 自动隔离 |
+| 定时任务用什么？ | 简单->@Scheduled，复杂->SnailJob | 按复杂度选 |
+| 文件上传？ | AWS S3 SDK | 已集成、MinIO 兼容 |
+| 敏感数据？ | @EncryptField | ruoyi-common-encrypt |
+| 防重复提交？ | @RepeatSubmit | ruoyi-common-idempotent |
+| 接口限流？ | @RateLimiter | ruoyi-common-ratelimiter |
+| 分布式锁？ | Redisson | 已集成 |
+
+---
+
+## Skill 联动路径
+
+```
+brainstorm（本 Skill）
+    |-- 需要建表 -> database-ops
+    |-- 需要后端开发 -> crud-development
+    |-- 需要定时任务 -> scheduled-jobs
+    |-- 需要安全认证 -> security-guard
+    |-- 需要数据权限 -> data-permission
+    |-- 需要异常处理 -> error-handler
+    |-- 需要技术对比 -> tech-decision
+    |-- 需要代码规范 -> code-patterns
+```
+
+| 头脑风暴结论 | 下一步 Skill | 触发方式 |
+|-------------|-------------|---------|
+| 需要新建业务模块 | crud-development | "帮我开发 xxx 模块" |
+| 需要数据库设计 | database-ops | "帮我设计 xxx 表" |
+| 需要安全认证 | security-guard | "怎么控制权限访问" |
+| 需要技术对比 | tech-decision | "Redis 还是本地缓存好" |

package/.cursor/skills/bug-detective/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: bug-detective
+description: |
+  通用 Bug 排查指南。提供分层定位方法论、日志分析技巧、HTTP 错误码诊断决策树。
+  触发场景：Bug 排查、错误分析、日志诊断、线上问题定位。
+  触发词：Bug、排查、报错、异常、日志分析、线上问题。
+  注意：如果项目有专属技能（如 `leniu-bug-detective`），优先使用专属版本。
+---
+
+# Bug 排查指南
+
+> 通用模板。如果项目有专属技能（如 `leniu-bug-detective`），优先使用。
+
+## 核心规范
+
+### 排查方法论：分层定位
+
+```
+[问题现象]
+    │
+    ▼
+[1. 复现] ── 能否稳定复现？记录复现步骤
+    │
+    ▼
+[2. 定位层] ── 问题出在哪一层？
+    │
+    ├── 前端层 ── 浏览器控制台、网络请求、渲染问题
+    ├── 网关层 ── 路由、限流、认证
+    ├── 接口层 ── 参数校验、序列化
+    ├── 业务层 ── 业务逻辑、数据状态
+    ├── 数据层 ── SQL、数据一致性
+    └── 基础设施 ── 网络、配置、资源
+    │
+    ▼
+[3. 缩小范围] ── 二分法排除
+    │
+    ▼
+[4. 根因分析] ── 找到根本原因，而非表象
+    │
+    ▼
+[5. 修复验证] ── 修复 + 回归测试
+```
+
+### 信息收集清单
+
+排查前先收集：
+
+- [ ] 错误信息 / 错误码 / 堆栈
+- [ ] 发生时间、频率
+- [ ] 影响范围（所有用户 / 特定用户 / 特定数据）
+- [ ] 最近的代码变更（最近一次部署了什么）
+- [ ] 环境信息（开发 / 测试 / 生产）
+- [ ] 能否复现，复现步骤
+
+### 前后端分离定位
+
+```
+步骤 1：Postman/curl 直接调接口
+├── 返回正确 → 问题在前端（请求参数、渲染、状态管理）
+└── 返回错误 → 问题在后端（继续向下排查）
+
+步骤 2（后端）：读应用日志
+├── 有 ERROR 堆栈 → 定位异常类和行号
+└── 无 ERROR → 打断点或加诊断日志逐层排查
+
+步骤 3：按调用链向下
+Controller → Service → Mapper → 数据库
+```
+
+## HTTP 错误码诊断决策树
+
+### 4xx 客户端错误
+
+```
+400 Bad Request
+├── 请求参数格式错误？ → 检查 JSON 格式、字段类型
+├── 参数校验失败？ → 检查 @Valid 注解和 DTO 约束
+└── Content-Type 不匹配？ → 检查请求头
+
+401 Unauthorized
+├── Token 缺失？ → 检查请求头是否携带认证信息
+├── Token 过期？ → 检查 Token 有效期
+└── Token 无效？ → 检查签发逻辑和密钥
+
+403 Forbidden
+├── 角色/权限不足？ → 检查权限配置
+├── IP 白名单？ → 检查网关或防火墙配置
+└── CORS 跨域？ → 检查跨域配置
+
+404 Not Found
+├── URL 拼写错误？ → 对照 API 文档
+├── 路由未注册？ → 检查 Controller 注解和包扫描路径
+├── 资源确实不存在？ → 检查数据库数据
+└── 网关路由未配置？ → 检查网关转发规则
+
+405 Method Not Allowed
+└── HTTP 方法不匹配？ → GET vs POST，检查 Controller 映射
+
+409 Conflict
+└── 数据冲突？ → 唯一约束、并发修改、乐观锁失败
+```
+
+### 5xx 服务端错误
+
+```
+500 Internal Server Error
+├── NullPointerException → 检查空值处理
+├── SQL 异常 → 检查 SQL 语法、字段类型
+├── 类型转换异常 → 检查数据格式
+├── 序列化异常 → 检查对象中的循环引用、日期格式
+└── 第三方调用失败 → 检查外部服务状态
+
+502 Bad Gateway
+├── 后端服务未启动？ → 检查进程状态
+├── 端口未监听？ → 检查端口占用
+└── 反向代理配置错误？ → 检查 Nginx/网关配置
+
+503 Service Unavailable
+├── 服务过载？ → 检查 CPU/内存/线程池
+├── 熔断触发？ → 检查熔断器状态
+└── 正在部署？ → 检查发布状态
+
+504 Gateway Timeout
+├── 慢查询？ → 检查 SQL 执行计划
+├── 外部调用超时？ → 检查第三方服务响应时间
+└── 超时配置过短？ → 调整网关/代理超时设置
+```
+
+## 日志分析技巧
+
+### 关键信息提取
+
+```bash
+# 按关键字搜索错误
+grep -n "ERROR\|Exception\|WARN" app.log | tail -50
+
+# 按时间范围过滤
+sed -n '/2024-01-01 10:00/,/2024-01-01 10:30/p' app.log
+
+# 按请求 ID 追踪（如果有链路追踪）
+grep "traceId=abc123" app.log
+
+# 统计错误类型分布
+grep "Exception" app.log | awk -F: '{print $NF}' | sort | uniq -c | sort -rn
+
+# 查看某个时间点前后的上下文
+grep -n "OutOfMemoryError" app.log  # 先找到行号
+sed -n '95,115p' app.log             # 查看前后各 10 行
+```
+
+### 日志级别含义
+
+| 级别 | 用途 | 排查价值 |
+|------|------|---------|
+| ERROR | 系统错误，需要立即关注 | 最高，直接定位问题 |
+| WARN | 潜在问题，可能导致错误 | 高，可能是问题前兆 |
+| INFO | 业务关键节点 | 中，了解业务流程 |
+| DEBUG | 详细调试信息 | 开发环境排查用 |
+| TRACE | 最详细的跟踪信息 | 极少使用 |
+
+### 常见日志模式识别
+
+```
+# 连接池耗尽
+"Cannot get a connection, pool error Timeout waiting for idle object"
+→ 检查连接池配置、是否有连接泄漏
+
+# 内存溢出
+"java.lang.OutOfMemoryError: Java heap space"
+→ 检查堆内存配置、是否有内存泄漏
+
+# 死锁
+"Deadlock found when trying to get lock"
+→ 检查事务范围、锁顺序
+
+# 慢 SQL
+"SlowQuery: execution time exceeds"
+→ 分析 SQL 执行计划，添加索引
+```
+
+## 代码示例
+
+### 排查辅助：添加诊断日志
+
+```java
+@Slf4j
+@Service
+public class OrderServiceImpl {
+
+    public OrderVO getOrderDetail(Long id) {
+        log.info("查询订单详情, id={}", id);
+
+        Order order = orderMapper.selectById(id);
+        if (order == null) {
+            log.warn("订单不存在, id={}", id);
+            throw new [你的业务异常类]("订单不存在");
+        }
+
+        log.debug("订单数据: status={}, amount={}", order.getStatus(), order.getAmount());
+        // ... 业务逻辑
+        return orderVO;
+    }
+}
+```
+
+### 排查辅助：请求链路追踪
+
+```java
+// 使用 MDC 添加请求上下文
+@Component
+public class TraceInterceptor implements HandlerInterceptor {
+
+    @Override
+    public boolean preHandle(HttpServletRequest request,
+                             HttpServletResponse response,
+                             Object handler) {
+        String traceId = request.getHeader("X-Trace-Id");
+        if (traceId == null) {
+            traceId = UUID.randomUUID().toString().replace("-", "");
+        }
+        MDC.put("traceId", traceId);
+        return true;
+    }
+
+    @Override
+    public void afterCompletion(HttpServletRequest request,
+                                HttpServletResponse response,
+                                Object handler, Exception ex) {
+        MDC.clear();
+    }
+}
+```
+
+```xml
+<!-- logback 配置中包含 traceId -->
+<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId}] %-5level %logger{36} - %msg%n</pattern>
+```
+
+### 常见 Bug 排查模板
+
+```markdown
+## Bug 报告
+
+**现象**：[描述用户看到的问题]
+
+**复现步骤**：
+1. ...
+2. ...
+3. ...
+
+**预期行为**：[应该发生什么]
+
+**实际行为**：[实际发生了什么]
+
+**环境**：[开发/测试/生产]
+
+**日志/截图**：[关键日志片段]
+
+---
+
+## 排查过程
+
+**定位层**：[前端/网关/接口/业务/数据/基础设施]
+
+**根因**：[根本原因分析]
+
+**修复方案**：[如何修复]
+
+**回归验证**：[如何确认修复有效]
+```
+
+### 常见问题速查
+
+| 问题 | 可能原因 | 排查方向 |
+|------|---------|---------|
+| 接口 404 | URL 错误/服务未启动 | 检查路由映射、服务状态 |
+| 接口 500 | 后端异常 | 读应用日志 ERROR 堆栈 |
+| 数据查不到 | 条件错误/逻辑删除/权限 | 检查 SQL、deleted 字段、数据权限 |
+| 事务不回滚 | 异常被吞/非 public/this 调用 | 检查 @Transactional、代理调用 |
+| Bean 注入失败 | 包扫描/注解缺失 | 检查包路径、@Service/@Component |
+| 对象转换字段丢失 | 字段名不匹配 | 检查源和目标对象字段名 |
+| 雪花 ID 精度丢失 | JS Number 精度限制 | Long 序列化为 String |
+
+## 常见错误
+
+| 错误 | 正确做法 |
+|------|---------|
+| 看到错误就改代码 | 先理解根因再修复 |
+| 只看最后一行异常信息 | 从 `Caused by` 往上找根因 |
+| 生产环境开 DEBUG 日志 | 临时开启，问题解决后立即关闭 |
+| 修复后不验证 | 修复后必须复现场景验证 |
+| 只修表象不修根因 | 加 null 判断不如搞清楚为什么是 null |
+| 修复时引入新 Bug | 修复范围最小化，充分回归 |
+| 依赖"重启解决" | 重启只是临时手段，必须找到根因 |
+| 忽略 WARN 日志 | WARN 往往是问题的前兆 |