ai-engineering-init 1.4.3 → 1.6.0

package/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/skills/bug-detective/SKILL.md

@@ -0,0 +1,256 @@
+---
+name: bug-detective
+description: |
+  leniu 后端 Bug 排查指南。包含错误诊断决策树、日志分析、分层定位、本项目特有错误模式库。
+
+  触发场景：
+  - 接口返回 4xx/5xx 错误需要排查
+  - NullPointerException、SQLException 等异常定位
+  - 数据查不到、对象转换失败、租户隔离问题
+  - 日志文件分析（./logs/sys-console.log）
+  - 前端页面不显示、API 调用异常
+
+  联动技能：数据问题自动联动 mysql-debug 查库验证
+
+  触发词：Bug、报错、异常、不工作、500错误、NullPointerException、SQLException、数据查不到、日志分析、排查、调试、debug、错误排查、精度丢失
+---
+
+# Bug 排查指南（leniu 四层架构）
+
+> 本项目四层架构：Controller -> Business -> Service -> Mapper，包名 `net.xnzn.core.*`
+> 详细错误案例库见 `references/error-patterns.md`
+
+## 错误关键词索引
+
+| 关键词 | 原因 | 解决 |
+|--------|------|------|
+| `NullPointerException` | 对象为空 | selectById 判空，用 Optional |
+| `SQLException` | SQL 语法/字段名 | 检查表名、字段、类型 |
+| `401/403` | Token/权限 | 检查 `@RequiresAuthentication`、角色配置 |
+| `404` | URL 路径错误 | 检查 `@RequestMapping` |
+| `500` | 后端异常 | 读日志 `./logs/sys-console.log` |
+| `data 为 null, msg 有值` | **LeResponse 返回陷阱** | 见下方特有问题 #1 |
+| `精度丢失/ID 不对` | 雪花 ID 大数 | Long -> String 或 `@JsonSerialize(using = ToStringSerializer.class)` |
+| `like 报错` | 非 String 类型 | Long/Date 用 eq/in/between |
+| `查询无结果` | 租户/del_flag/条件 | 检查双库切换、del_flag=2 |
+| `BeanUtil 转换 null` | 源对象为空 | 转换前判空 |
+
+---
+
+## 诊断决策树
+
+```
+接口返回错误
++-- 4xx
+|   +-- 400 -> 参数格式/类型错误（@RequestBody、LeRequest<T>）
+|   +-- 401 -> Token 过期（检查 Admin-Token）
+|   +-- 403 -> 无权限（检查 @RequiresAuthentication）
+|   +-- 404 -> 路径错误（检查 /api/v2/web|mobile|android/{module}）
+|
++-- 500
+|   +-- 有堆栈 -> 按异常类型定位
+|   |   +-- NullPointerException -> 查询返回 null 未判空
+|   |   +-- SQLException -> SQL 语法/字段错误
+|   |   +-- LeException -> 业务逻辑主动抛出
+|   +-- 无堆栈 -> 全局异常处理器吞掉了异常
+|
++-- 200 但数据不对
+    +-- data=null, msg有值 -> LeResponse 返回陷阱（见特有问题 #1）
+    +-- data=null, msg=null -> 查询条件错误/del_flag/双库切换
+    +-- 字段缺失 -> BeanUtil.copyProperties 字段名不匹配
+    +-- ID 精度丢失 -> 雪花 ID 大数问题
+```
+
+---
+
+## 分层定位
+
+```
+步骤 1：Postman/curl 直接调接口
++-- 返回正确 -> 问题在前端
++-- 返回错误 -> 问题在后端
+
+步骤 2（后端）：读日志 ./logs/sys-console.log
++-- 有 ERROR -> 定位异常类和行号
++-- 无 ERROR -> 打断点逐层排查
+
+步骤 3：按调用链向下
+Controller -> Business -> Service -> Mapper -> 数据库
+```
+
+| 层级 | 常见问题 | 排查重点 |
+|------|---------|---------|
+| Controller | 参数绑定、路径 404 | `@RequestMapping`、`LeRequest<T>`、`@Validated` |
+| Business | 业务编排错误、跨 Service 协调 | 方法调用顺序、数据组装 |
+| Service | 查询条件、事务回滚 | `buildWrapper`、`@Transactional`、判空 |
+| Mapper | SQL 语法、字段映射 | `@TableName`、`@TableField`、XML SQL |
+
+---
+
+## 日志分析
+
+### 日志文件位置
+
+| 环境 | 文件 | 说明 |
+|------|------|------|
+| 开发 | `./logs/sys-console.log` | 本次启动完整日志（INFO/WARN/ERROR + SQL） |
+| 生产 | `./logs/sys-info.log` | INFO 日志（60 天） |
+| 生产 | `./logs/sys-error.log` | ERROR 日志（60 天） |
+| 生产 | `./logs/sys-sql.log` | SQL 日志（7 天） |
+
+### AI 自动读取流程
+
+**触发条件**（任一）：用户报告问题无堆栈、需分析 SQL、需查看流程、用户说"看日志"
+
+```
+1. Read ./logs/sys-console.log
+2. 搜索 ERROR/WARN -> 定位异常堆栈
+3. 搜索 p6spy -> 分析 SQL 执行和耗时
+4. 结合代码给出诊断和修复方案
+```
+
+### 日志格式
+
+```
+2026-01-08 22:12:10 [xxx] [http-nio-8080-exec-1] INFO  p6spy - Execute SQL: SELECT ... | Cost: 5 ms
+2026-01-08 22:12:10 [xxx] [http-nio-8080-exec-1] ERROR net.xnzn.core.xxx - 错误信息
+```
+
+**SQL 耗时阈值**：<50ms 正常 | 50-200ms 关注 | >200ms 需优化
+
+---
+
+## 本项目特有问题库
+
+### 1. LeResponse 返回 String 的陷阱
+
+```java
+// ---- 错误：R.ok(String) 匹配到 ok(String msg) ----
+return R.ok(code);  // { code: 200, msg: "ABC123", data: null }
+
+// ---- 正确 ----
+return R.ok(null, code);  // { code: 200, msg: null, data: "ABC123" }
+return R.ok("成功", code); // { code: 200, msg: "成功", data: "ABC123" }
+```
+
+**原因**：当 T 是 String 时，Java 优先匹配 `ok(String msg)` 而非泛型 `ok(T data)`。
+
+### 2. 双库架构数据查不到
+
+```java
+// leniu 是物理双库（系统库 + 商户库），无 tenant_id 字段
+// 默认操作商户库，切换系统库需要：
+Executors.doInSystem(() -> { /* 系统库操作 */ });
+Executors.doInTenant(tenantId, () -> { /* 指定商户库 */ });
+
+// 排查：数据在哪个库？请求头 MERCHANT-ID 是否正确？
+```
+
+### 3. del_flag 值反直觉
+
+```java
+// leniu: 1=删除, 2=正常（非通用的 0=正常, 1=删除）
+wrapper.eq(XxxEntity::getDelFlag, 2); // 查正常数据
+entity.setDelFlag(1); // 逻辑删除
+```
+
+### 4. 查询条件不生效
+
+```java
+// ---- 错误：无条件判断 ----
+wrapper.eq(Xxx::getStatus, bo.getStatus());  // null 时报错
+wrapper.like(Xxx::getName, bo.getName());    // 空串时 LIKE '%%'
+
+// ---- 正确 ----
+wrapper.eq(ObjectUtil.isNotNull(bo.getStatus()), Xxx::getStatus, bo.getStatus());
+wrapper.like(StrUtil.isNotBlank(bo.getName()), Xxx::getName, bo.getName());
+```
+
+### 5. like 仅限 String 类型
+
+| 字段类型 | 用法 |
+|---------|------|
+| String | `like()` |
+| Long/Integer | `eq()` / `in()` |
+| Date/LocalDateTime | `between()` / `ge()` / `le()` |
+
+### 6. 雪花 ID 精度丢失
+
+```java
+// JS Number 最大安全整数 2^53-1，雪花 ID 超出
+// 方案 1：VO 中 String 类型
+// 方案 2：@JsonSerialize(using = ToStringSerializer.class)
+// 方案 3：全局 JacksonConfig（本项目已配置，检查是否生效）
+```
+
+### 7. Self 自注入事务失效
+
+```java
+// 同类方法互调，被调用方有 @Transactional 时，必须用 self 调用
+@Autowired @Lazy
+private XxxBusiness self;
+
+public void doSave(OrderDTO dto) {
+    self.save(dto); // 通过代理调用，事务生效
+    // this.save(dto); // 直接调用，事务不生效
+}
+```
+
+### 8. BeanUtil 转换注意
+
+```java
+// leniu 用 Hutool BeanUtil，不是 MapstructUtils
+XxxVO vo = BeanUtil.copyProperties(entity, XxxVO.class); // 源对象为 null 时返回 null
+// 转换前务必判空
+```
+
+---
+
+## 数据库排查（委托 mysql-debug）
+
+当诊断结果指向数据问题时，**必须联动 `mysql-debug` 技能**进行数据库查询验证：
+
+```
+诊断决策树判定"数据相关问题"
+  ↓
+自动激活 mysql-debug 技能
+  ↓
+mysql-debug 执行：配置检查 → 日志提取数据库名 → 执行只读 SQL → 返回结果
+  ↓
+bug-detective 结合查询结果给出修复方案
+```
+
+**触发 mysql-debug 的信号**：
+- 查询返回空/数据不存在
+- 数据数量、金额、状态不对
+- SQL 异常（DataIntegrityViolation、DuplicateKey）
+- 关联数据不一致
+- 特定租户才出现的问题
+
+> 如果 mysql-debug 配置未就绪（密码未设置/mysql CLI 未安装），仍可继续纯代码分析路径。
+
+---
+
+## 常见问题速查
+
+| 问题 | 原因 | 解决 |
+|------|------|------|
+| 接口 404 | URL/未启动 | 检查路由前缀 `/api/v2/web/{module}` |
+| 接口 500 | 后端异常 | 读日志 |
+| data 为 null | LeResponse 陷阱 | `R.ok(null, value)` |
+| 转换失败 | BeanUtil 源为 null | 转换前判空 |
+| 数据查不到 | 双库/del_flag | 检查 Executors 切换、del_flag=2 |
+| 事务不回滚 | 异常被吞/非 public/this 调用 | 检查 @Transactional、用 self |
+| Bean 注入失败 | 包名/注解 | 必须 `net.xnzn.core.*` + `@Service` |
+
+---
+
+## Skill 联动
+
+| 排查发现 | 推荐 Skill |
+|---------|-----------|
+| 数据问题（查不到/不一致/状态异常） | `mysql-debug`（自动联动） |
+| SQL 性能慢 | `performance-doctor` |
+| 权限配置问题 | `security-guard` |
+| BO/VO 映射错误 | `leniu-crud-development` |
+| 前端组件用法 | `ui-pc` |