leniu-dev 2.0.0

package/src/skills/architecture-design/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: architecture-design
+description: |
+  通用架构设计指南。涵盖分层架构、模块划分、依赖管理等架构决策方法论。
+  触发场景：系统设计、模块拆分、架构评审、技术选型。
+  触发词：架构设计、分层架构、模块划分、系统设计、技术选型。
+  注意：如果项目有专属技能（如 `leniu-architecture`），优先使用专属版本。
+---
+
+# 架构设计指南
+
+> 通用模板。如果项目有专属技能（如 `leniu-architecture`），优先使用。
+
+## 核心规范
+
+### 分层架构对比
+
+#### 三层架构（标准 Spring Boot）
+
+```
+Controller  ->  Service  ->  Mapper/Repository
+（接口层）     （业务层）    （数据访问层）
+```
+
+- **适用场景**：中小型项目、业务逻辑相对简单
+- **优点**：结构清晰、上手快、团队共识强
+- **缺点**：Service 层容易膨胀为"上帝类"
+
+#### 四层架构（增加编排层）
+
+```
+Controller  ->  Business/Facade  ->  Service  ->  Mapper/Repository
+（接口层）      （业务编排层）       （领域服务）   （数据访问层）
+```
+
+- **适用场景**：大型项目、复杂业务编排、跨 Service 协调
+- **优点**：职责更细粒度、Service 保持纯净
+- **缺点**：层次多、小项目过度设计
+
+#### 选择建议
+
+| 条件 | 推荐 |
+|------|------|
+| 单表 CRUD 为主 | 三层架构 |
+| 跨模块协调频繁 | 四层架构 |
+| 团队 < 5 人 | 三层架构 |
+| 微服务拆分 | 三层 + DDD |
+
+### 模块划分原则
+
+1. **高内聚低耦合**：模块内部紧密关联，模块间依赖最小化
+2. **按业务域拆分**：而非按技术层拆分
+3. **单一职责**：每个模块只负责一个业务领域
+4. **接口隔离**：模块间通过接口/API 通信，不直接依赖实现
+
+### 推荐模块结构
+
+```
+project-root/
+├── project-common/          # 公共模块（工具类、通用常量）
+├── project-api/             # 对外 API 定义（Feign 接口、DTO）
+├── project-module-order/    # 订单模块
+├── project-module-user/     # 用户模块
+├── project-module-payment/  # 支付模块
+└── project-gateway/         # 网关（微服务场景）
+```
+
+### 每个模块内部结构
+
+```
+[你的包名].[module]/
+├── controller/       # 接口层
+├── service/
+│   └── impl/         # 业务实现
+├── mapper/           # 数据访问
+├── entity/           # 实体
+├── dto/              # 请求参数
+├── vo/               # 响应对象
+├── enums/            # 枚举
+└── config/           # 模块配置
+```
+
+## 代码示例
+
+### 依赖方向（必须单向）
+
+```
+Controller  -->  Service  -->  Mapper
+    |               |
+    v               v
+   DTO/VO        Entity
+```
+
+- 上层可以依赖下层，下层不能依赖上层
+- 同层之间避免循环依赖
+- 公共模块被所有业务模块依赖，但公共模块不依赖任何业务模块
+
+### 模块间通信模式
+
+```java
+// 方式一：直接依赖（单体应用）
+@Service
+@RequiredArgsConstructor
+public class OrderServiceImpl implements IOrderService {
+    private final IUserService userService;  // 直接注入其他模块 Service
+}
+
+// 方式二：事件驱动（解耦）
+@Service
+@RequiredArgsConstructor
+public class OrderServiceImpl implements IOrderService {
+    private final ApplicationEventPublisher eventPublisher;
+
+    public void createOrder(OrderCreateDTO dto) {
+        // ... 创建订单
+        eventPublisher.publishEvent(new OrderCreatedEvent(order));
+    }
+}
+
+// 方式三：Feign 调用（微服务）
+@FeignClient(name = "user-service")
+public interface UserFeignClient {
+    @GetMapping("/api/v1/users/{id}")
+    UserVO getUserById(@PathVariable Long id);
+}
+```
+
+### 配置分层
+
+```yaml
+# application.yml - 通用配置
+spring:
+  profiles:
+    active: ${SPRING_PROFILES_ACTIVE:dev}
+
+# application-dev.yml - 开发环境
+# application-test.yml - 测试环境
+# application-prod.yml - 生产环境
+```
+
+## 常见错误
+
+| 错误 | 正确做法 |
+|------|---------|
+| Controller 直接调 Mapper | 必须经过 Service 层 |
+| Service 之间循环依赖 | 提取公共 Service 或事件驱动 |
+| Entity 直接暴露给前端 | 用 VO 封装响应 |
+| 公共模块依赖业务模块 | 公共模块必须独立，被业务模块依赖 |
+| 按技术层拆分模块（all-controller、all-service） | 按业务域拆分 |
+| 所有逻辑堆在 Service 一个方法里 | 拆分私有方法或引入编排层 |
+| 硬编码配置值 | 使用配置文件 + `@Value` 或 `@ConfigurationProperties` |
+| 跨模块直接操作其他模块的数据库表 | 通过对方 Service 接口调用 |

package/src/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/src/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/src/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