leniu-dev 2.0.0

package/.cursor/skills/backend-annotations/SKILL.md

@@ -0,0 +1,248 @@
+---
+name: backend-annotations
+description: |
+  通用后端高级注解指南。包含限流、防重复提交、数据脱敏、字段加密、接口加密等横切关注点的 AOP 实现模式。
+  触发场景：
+  - 配置接口限流
+  - 配置防重复提交
+  - 配置数据脱敏
+  - 配置字段加密 / 接口加密
+  触发词：注解、限流、防重复提交、脱敏、加密、RateLimiter、Idempotent、Sensitive、Encrypt、AOP
+  注意：如果项目有专属技能（如 `leniu-backend-annotations`），优先使用专属版本。
+---
+
+# 后端高级注解开发指南
+
+> 通用模板。如果项目有专属技能（如 `leniu-backend-annotations`），优先使用。
+
+## 设计原则
+
+1. **横切关注点用 AOP**：限流、防重复、脱敏、加密属于非功能性需求，应通过注解 + AOP/拦截器实现，不侵入业务代码。
+2. **分层职责清晰**：限流/防重复作用于 Controller 层；脱敏作用于 VO 序列化层；加密作用于持久化层。
+3. **声明式优于编程式**：用注解声明意图，框架自动执行，减少样板代码。
+4. **配置外置**：密钥、阈值等参数放在配置文件或配置中心，不硬编码。
+
+---
+
+## 实现模式
+
+### 1. 接口限流
+
+**概念**：通过 AOP 拦截请求，基于 Redis/内存计数器控制单位时间内的请求次数。
+
+```java
+// 自定义注解
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface RateLimiter {
+    String key() default "";          // 限流key，支持 SpEL
+    int time() default 60;            // 时间窗口（秒）
+    int count() default 100;          // 最大请求次数
+    LimitType limitType() default LimitType.DEFAULT; // DEFAULT / IP / CLUSTER
+    String message() default "请求过于频繁";
+}
+
+// AOP 切面
+@Aspect
+@Component
+public class RateLimiterAspect {
+
+    @Autowired
+    private StringRedisTemplate redisTemplate;
+
+    @Around("@annotation([你的包名].annotation.RateLimiter)")
+    public Object around(ProceedingJoinPoint point) throws Throwable {
+        RateLimiter limiter = /* 获取注解 */;
+        String key = buildKey(limiter, point);
+        // 使用 Redis Lua 脚本做原子计数
+        Long count = redisTemplate.execute(rateLimiterScript, List.of(key),
+            String.valueOf(limiter.count()), String.valueOf(limiter.time()));
+        if (count != null && count > limiter.count()) {
+            throw new [你的异常类](limiter.message());
+        }
+        return point.proceed();
+    }
+}
+```
+
+**推荐阈值参考**：
+
+| 场景 | 时间窗口 | 次数 | 限流类型 |
+|------|---------|------|---------|
+| 登录接口 | 60s | 5-10 | IP |
+| 验证码 | 60s | 3 | IP |
+| 查询接口 | 60s | 100-1000 | DEFAULT |
+| 写入接口 | 60s | 10-50 | DEFAULT |
+| 敏感操作 | 60s | 1-5 | IP |
+
+---
+
+### 2. 防重复提交
+
+**概念**：在指定时间窗口内，相同用户的相同请求（基于 Token + 参数哈希）只允许提交一次。
+
+```java
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface RepeatSubmit {
+    int interval() default 5000;       // 间隔时间（毫秒）
+    TimeUnit timeUnit() default TimeUnit.MILLISECONDS;
+    String message() default "请勿重复提交";
+}
+
+// AOP 切面核心逻辑
+// 1. 从请求中提取 Token + 请求参数
+// 2. 计算 MD5(token + ":" + serialize(params))
+// 3. Redis SETNX，设置过期时间 = interval
+// 4. 设置成功 -> 允许请求；设置失败 -> 拒绝
+// 5. 请求异常时删除 key，允许重试
+```
+
+| 场景 | 推荐间隔 |
+|------|---------|
+| 普通表单 | 3-5 秒 |
+| 订单创建 | 10 秒 |
+| 支付操作 | 30 秒 |
+| 文件上传 | 10 秒 |
+
+---
+
+### 3. 数据脱敏
+
+**概念**：在 JSON 序列化阶段，对 VO 中的敏感字段进行掩码处理。通过自定义 Jackson 序列化器实现。
+
+```java
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+@JacksonAnnotationsInside
+@JsonSerialize(using = SensitiveSerializer.class)
+public @interface Sensitive {
+    SensitiveStrategy strategy();
+    String[] roleKey() default {};    // 拥有这些角色可查看原文
+    String[] perms() default {};       // 拥有这些权限可查看原文
+}
+
+public enum SensitiveStrategy {
+    ID_CARD(s -> s.substring(0, 3) + "***" + s.substring(s.length() - 4)),
+    PHONE(s -> s.substring(0, 3) + "****" + s.substring(s.length() - 4)),
+    EMAIL(s -> s.charAt(0) + "**@" + s.substring(s.indexOf('@') + 1)),
+    CHINESE_NAME(s -> s.charAt(0) + "*".repeat(s.length() - 1)),
+    BANK_CARD(s -> s.substring(0, 4) + "****" + s.substring(s.length() - 4)),
+    PASSWORD(s -> "******");
+
+    private final Function<String, String> desensitizer;
+    // constructor, getter...
+}
+
+// 使用
+public class UserVo {
+    @Sensitive(strategy = SensitiveStrategy.PHONE)
+    private String phone;
+
+    @Sensitive(strategy = SensitiveStrategy.ID_CARD, roleKey = {"admin"})
+    private String idCard;
+}
+```
+
+**权限逻辑**：roleKey 和 perms 都为空 = 全部脱敏；满足任一条件 = 可查看原文（OR 关系）。
+
+---
+
+### 4. 字段加密（持久层）
+
+**概念**：通过 MyBatis 拦截器/TypeHandler，在数据写入数据库时自动加密，读取时自动解密。对业务代码透明。
+
+```java
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface EncryptField {
+    AlgorithmType algorithm() default AlgorithmType.DEFAULT; // 使用全局配置
+    String password() default "";    // AES/SM4 密钥
+    String publicKey() default "";   // RSA/SM2 公钥
+    String privateKey() default "";  // RSA/SM2 私钥
+}
+
+public enum AlgorithmType {
+    DEFAULT, BASE64, AES, RSA, SM2, SM4
+}
+```
+
+**配置示例**：
+
+```yaml
+# [你的加密配置前缀]:
+encrypt:
+  enable: true
+  algorithm: AES
+  password: your-secret-key-16ch   # AES/SM4 密钥（16字符）
+  public-key: MFkwEw...            # RSA/SM2 公钥
+  private-key: MIIBVAIBADANBg...   # RSA/SM2 私钥
+```
+
+---
+
+### 5. 接口加密（传输层）
+
+**概念**：通过 Filter/Interceptor，对 HTTP 请求体自动解密、响应体自动加密。适用于前后端通信加密。
+
+```java
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ApiEncrypt {
+    boolean response() default false; // 是否加密响应
+}
+
+// 在 RequestBodyAdvice / ResponseBodyAdvice 中拦截处理
+// 或通过 Filter + HttpServletRequestWrapper 实现
+```
+
+---
+
+## 选型建议
+
+| 关注点 | 实现方式 | 作用层 | 依赖 |
+|--------|---------|--------|------|
+| 限流 | AOP + Redis Lua 脚本 | Controller | Redis |
+| 防重复 | AOP + Redis SETNX | Controller | Redis + Token |
+| 脱敏 | Jackson 自定义序列化器 | VO 字段 | 无 |
+| 字段加密 | MyBatis 拦截器 / TypeHandler | Entity 字段 | 加密库 |
+| 接口加密 | Filter / RequestBodyAdvice | Controller 方法 | 加密库 |
+
+| 加密算法 | 类型 | 密钥要求 | 适用场景 |
+|---------|------|---------|---------|
+| BASE64 | 编码（非加密） | 无 | 简单混淆 |
+| AES | 对称加密 | 16/24/32 字节 | 通用加密（推荐） |
+| RSA | 非对称加密 | 公钥/私钥对 | 高安全场景 |
+| SM4 | 国密对称 | 16 字节 | 国密合规 |
+| SM2 | 国密非对称 | 公钥/私钥对 | 国密合规 |
+
+---
+
+## 常见错误
+
+```java
+// 1. 限流/防重复注解放在 Service 方法上（无效，应在 Controller）
+@Service
+public class XxxService {
+    @RateLimiter(...)  // 无效！AOP 通常只拦截 Controller
+    public void doSomething() { }
+}
+
+// 2. @Sensitive 用在 Entity 上（应在 VO 上，序列化时生效）
+// 3. @EncryptField 用在 VO 上（应在 Entity 上，持久化时生效）
+
+// 4. 加密密钥硬编码在注解中
+@EncryptField(password = "my-secret-key")  // 不安全
+// 应使用全局配置或环境变量
+
+// 5. 限流 key 设计不合理
+@RateLimiter(key = "")  // 所有用户共享限流
+// 应根据场景选择：用户维度 key="#userId"，IP 维度 limitType=IP
+
+// 6. 组合注解顺序不当
+// 推荐顺序：限流 -> 防重复 -> 权限 -> 日志
+@RateLimiter(time = 60, count = 10)
+@RepeatSubmit(interval = 5000)
+@PostMapping()
+public Result<?> add(@RequestBody XxxDTO dto) { }
+```

package/.cursor/skills/banana-image/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-12-22
+
+### Added
+
+- Initial release of Banana Image skill
+- **Dual model support**: Flash (fast) and Pro (4K high-quality)
+- **Image generation** with customizable parameters:
+  - Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4, 2:3, 3:2, 21:9
+  - Resolutions: 1K, 2K, 4K (Pro model only for 4K)
+  - Negative prompts for content exclusion
+  - Batch generation (1-4 images)
+- **Image editing mode** - modify existing images with text prompts
+- **Proxy support** via undici for corporate network environments
+- **Google Search grounding** for Pro model
+- **Template system** with predefined configurations:
+  - Product photography
+  - Social media posts
+  - Posters
+  - Thumbnails
+- CLI interface with comprehensive options
+- JSON output format for easy integration
+- Claude Code skill integration
+
+### Technical Details
+
+- Models:
+  - Flash: `gemini-2.5-flash-image`
+  - Pro: `gemini-3-pro-image-preview`
+- Default output: `./images` directory
+- Supported input formats: PNG, JPG, JPEG, GIF, WebP

package/.cursor/skills/banana-image/README.md

@@ -0,0 +1,146 @@
+<p align="center">
+  <img src="assets/logo.png" alt="Banana Image Logo" width="280">
+</p>
+
+<h1 align="center">Banana Image</h1>
+
+<p align="center">
+  <strong>AI-Powered Image Generation Tool for Claude Code</strong>
+</p>
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#models">Models</a> •
+  <a href="#examples">Examples</a>
+</p>
+
+---
+
+## Features
+
+- **Dual Model Support** - Flash (fast) and Pro (high-quality 4K)
+- **Flexible Aspect Ratios** - 1:1, 16:9, 9:16, 4:3, 2:3, 21:9, and more
+- **Image Editing** - Modify existing images with text prompts
+- **Batch Generation** - Generate up to 4 variants at once
+- **Proxy Support** - Works behind corporate firewalls
+- **Claude Code Integration** - Seamless skill integration
+
+## Installation
+
+### 1. Set API Key
+
+```bash
+export GEMINI_API_KEY="your-api-key"
+```
+
+### 2. Install Dependencies
+
+```bash
+cd ~/.claude/skills/banana-image/scripts
+npm install
+```
+
+## Usage
+
+### Quick Start
+
+```bash
+# Fast generation (Flash model)
+npx tsx ~/.claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "A cute shiba inu in the park" -m flash
+
+# 4K high-quality (Pro model)
+npx tsx ~/.claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "Professional product photo: iPhone case" -m pro -r 4K -a 4:5
+```
+
+### CLI Options
+
+| Option               | Description                     | Default          |
+| -------------------- | ------------------------------- | ---------------- |
+| `-p, --prompt`       | Image description (required)    | -                |
+| `-m, --model`        | Model: `flash` or `pro`         | `pro`            |
+| `-a, --aspect-ratio` | Ratio: 1:1, 16:9, 9:16, etc.    | `1:1`            |
+| `-r, --resolution`   | Resolution: 1K, 2K, 4K          | Pro=4K, Flash=1K |
+| `-o, --output`       | Output directory                | `./images`       |
+| `-n, --negative`     | Negative prompt                 | -                |
+| `-i, --input`        | Input image (edit mode)         | -                |
+| `-c, --count`        | Number of images (1-4)          | `1`              |
+| `-g, --grounding`    | Enable Google Search (Pro only) | `false`          |
+
+## Models
+
+| Model     | Speed  | Max Resolution | Best For                                |
+| --------- | ------ | -------------- | --------------------------------------- |
+| **Flash** | 2-5s   | 1024px         | Drafts, iterations, prototypes          |
+| **Pro**   | 10-40s | 4K             | Final delivery, marketing, professional |
+
+## Examples
+
+### Image Generation
+
+```bash
+# 16:9 landscape poster
+npx tsx banana_image_exec.ts -p "Sunset over mountains" -m pro -r 4K -a 16:9
+
+# Portrait for social media
+npx tsx banana_image_exec.ts -p "Product showcase" -m pro -a 9:16
+```
+
+### Image Editing
+
+```bash
+# Edit existing image
+npx tsx banana_image_exec.ts -p "Change background to beach sunset" -i ./photo.png
+```
+
+### Batch Generation
+
+```bash
+# Generate 4 variants
+npx tsx banana_image_exec.ts -p "Logo design concept" -m pro -c 4
+```
+
+## Output
+
+```json
+{
+  "success": true,
+  "images": [
+    {
+      "path": "./images/banana_pro_2025-01-01T12-00-00_abc123.png",
+      "model": "gemini-3-pro-image-preview",
+      "prompt": "Your prompt"
+    }
+  ],
+  "metadata": {
+    "model": "gemini-3-pro-image-preview",
+    "aspectRatio": "16:9",
+    "resolution": "4K",
+    "duration": 15234
+  }
+}
+```
+
+## Aspect Ratio Guide
+
+| Use Case            | Ratio | Keywords                   |
+| ------------------- | ----- | -------------------------- |
+| Social media square | 1:1   | Instagram, profile         |
+| Landscape banner    | 16:9  | YouTube, desktop wallpaper |
+| Portrait story      | 9:16  | Stories, mobile wallpaper  |
+| Product photo       | 4:5   | E-commerce, catalog        |
+| Movie poster        | 2:3   | Poster, print              |
+| Ultra-wide          | 21:9  | Banner, header             |
+
+## Requirements
+
+- Node.js 18+
+- Gemini API Key
+- Network access (proxy supported)
+
+## License
+
+MIT

package/.cursor/skills/banana-image/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: banana-image
+description: |
+  AI 图片生成技能。使用 Gemini API 生成高质量产品图、海报、缩略图等（最高 4K 分辨率）。
+
+  触发场景：
+  - 需要生成产品宣传图片、电商展示图
+  - 需要创建海报、Banner、社交媒体配图
+  - 需要 AI 生成或编辑高清图片
+  - 需要批量生成图片变体
+
+  触发词：生成图片、AI图片、产品图、海报、缩略图、4K、高清、制作图片、/image、图片编辑
+
+  【不触发】纯文本任务、代码生成、不涉及图片的设计讨论。
+  【先问什么】若缺少：图片描述、分辨率偏好、宽高比，先提问补齐。
+---
+
+# Banana Image - AI 图片生成
+
+基于 Gemini API 的独立图片生成技能，支持 4K 输出、双模型选择、图片编辑。
+
+## 环境要求
+
+```bash
+# 设置 API Key（必需）
+export GEMINI_API_KEY="your-api-key"
+
+# 安装依赖（首次使用）
+cd .claude/skills/banana-image/scripts && npm install
+```
+
+## 快速命令
+
+```bash
+# 快速生成（Flash 模型）
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "可爱的柴犬在公园玩耍" -m flash
+
+# 4K 高质量生成（Pro 模型）
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "专业产品照片：iPhone 手机壳" -m pro -r 4K -a 4:5
+```
+
+## 模型选择
+
+| 模型      | 速度 | 分辨率  | 适用场景                     |
+| --------- | ---- | ------- | ---------------------------- |
+| **Flash** | 2-3s | ≤1024px | 快速草图、迭代、原型         |
+| **Pro**   | 5-8s | ≤4K     | 最终交付、营销素材、专业作品 |
+
+**自动选择规则**：
+
+- 包含 "快速"、"草图"、"draft" → Flash
+- 包含 "4K"、"专业"、"高质量" → Pro（默认）
+
+## 参数说明
+
+```bash
+npx tsx banana_image_exec.ts --help
+
+Options:
+  --prompt, -p <text>      图片描述（必需）
+  --model, -m <type>       模型选择: flash | pro (默认: pro)
+  --aspect-ratio, -a <r>   宽高比: 1:1, 16:9, 9:16, 4:3, 3:2, 21:9 等
+  --resolution, -r <res>   分辨率: 1K, 2K, 4K (默认: Pro=4K, Flash=1K)
+  --negative, -n <text>    排除内容描述
+  --output, -o <dir>       输出目录 (默认: ./images)
+  --grounding, -g          启用 Google Search 锚定 (仅 Pro)
+  --input, -i <path>       输入图片路径（编辑模式）
+  --system, -s <text>      系统指令
+  --count, -c <num>        生成数量 (1-4)
+```
+
+## 工作流
+
+### 1. 简单生成
+
+```bash
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "A cute shiba inu playing in the park" \
+  -m pro
+```
+
+### 2. 带参数生成
+
+```bash
+# 16:9 横版海报，启用 Google 搜索锚定
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "2024年科技大会宣传海报" \
+  -m pro -r 4K -a 16:9 -g
+```
+
+### 3. 图片编辑
+
+```bash
+# 修改现有图片
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "将背景改为黄昏海滩" \
+  -i /path/to/original.png
+```
+
+### 4. 批量生成
+
+```bash
+# 生成多张变体
+npx tsx .claude/skills/banana-image/scripts/banana_image_exec.ts \
+  -p "产品照片：无线耳机" \
+  -m pro -c 4
+```
+
+## 输出格式
+
+脚本输出 JSON 格式结果：
+
+```json
+{
+  "success": true,
+  "images": [
+    {
+      "path": "./images/banana_pro_2024-01-01T12-00-00_abc123.png",
+      "model": "gemini-3-pro-image-preview",
+      "prompt": "可爱的柴犬"
+    }
+  ],
+  "metadata": {
+    "model": "gemini-3-pro-image-preview",
+    "aspectRatio": "1:1",
+    "resolution": "4K",
+    "duration": 5234
+  }
+}
+```
+
+## 宽高比映射
+
+| 用途         | 宽高比 | 关键词                        |
+| ------------ | ------ | ----------------------------- |
+| 社交媒体方图 | 1:1    | "方形"、"Instagram"           |
+| 横版海报     | 16:9   | "横版"、"YouTube"、"桌面壁纸" |
+| 竖版海报     | 9:16   | "竖版"、"手机壁纸"、"Story"   |
+| 产品图       | 4:5    | "产品"、"电商"                |
+| 电影海报     | 2:3    | "海报"、"电影"                |
+| 超宽屏       | 21:9   | "超宽"、"Banner"              |
+
+## 模板系统
+
+读取预定义模板生成图片：
+
+```bash
+# 列出可用模板
+python .claude/skills/banana-image/scripts/apply_template.py list
+
+# 应用产品图模板
+python .claude/skills/banana-image/scripts/apply_template.py apply product \
+  -v '{"product": "wireless earbuds"}'
+```
+
+模板输出可直接传递给 `banana_image_exec.ts`。
+
+## 错误处理
+
+| 错误                    | 原因           | 解决方案                      |
+| ----------------------- | -------------- | ----------------------------- |
+| GEMINI_API_KEY not set  | 未设置 API Key | `export GEMINI_API_KEY="..."` |
+| Content filtered        | 内容安全过滤   | 调整描述，避免敏感词          |
+| Invalid aspect ratio    | 不支持的宽高比 | 使用支持的宽高比              |
+| Image generation failed | API 调用失败   | 检查网络和 API 配额           |
+
+## 参考文档
+
+- [高级用法](references/advanced-usage.md) - 批量生成、图片编辑、参数优化