@llryiop/avatar-boot-cli 1.0.0 → 1.0.2

package/templates/.claude/skills/avatar-boot-starter-redis/references//346/225/260/346/215/256/346/223/215/344/275/234.md

@@ -0,0 +1,111 @@
+# Redis 数据操作
+
+## String 操作
+
+```java
+@Resource
+private RedisStringClient redisStringClient;
+
+// 设置值（带过期时间）
+redisStringClient.set("key", "value", Duration.ofMinutes(5));
+
+// 获取值
+String value = redisStringClient.get("key");
+
+// 递增
+Long count = redisStringClient.increment("counter");
+
+// 批量操作
+Map<String, String> batch = Map.of("k1", "v1", "k2", "v2");
+redisStringClient.multiSet(batch);
+Map<String, String> result = redisStringClient.multiGet(batch.keySet());
+```
+
+## Hash 操作
+
+```java
+@Resource
+private RedisHashClient redisHashClient;
+
+// 存储字段
+redisHashClient.put("user:1", "name", "张三");
+redisHashClient.put("user:1", "age", "25");
+
+// 获取字段
+String name = redisHashClient.get("user:1", "name");
+
+// 获取所有字段
+Map<Object, Object> user = redisHashClient.getAll("user:1");
+
+// 递增字段
+redisHashClient.increment("user:1", "age", 1);
+```
+
+## Set 操作
+
+```java
+@Resource
+private RedisSetClient redisSetClient;
+
+// 添加成员
+redisSetClient.add("tags", "java", "spring", "redis");
+
+// 获取所有成员
+Set<Object> tags = redisSetClient.members("tags");
+
+// 判断是否存在
+boolean exists = redisSetClient.isMember("tags", "java");
+
+// 移除成员
+redisSetClient.remove("tags", "redis");
+```
+
+## ZSet 操作
+
+```java
+@Resource
+private RedisZSetClient redisZSetClient;
+
+// 添加成员（带分数）
+redisZSetClient.add("ranking", "user1", 100.0);
+redisZSetClient.add("ranking", "user2", 200.0);
+
+// 获取排名（从高到低，取前10）
+Set<Object> top = redisZSetClient.reverseRange("ranking", 0, 9);
+
+// 获取分数
+Double score = redisZSetClient.score("ranking", "user1");
+
+// 递增分数
+redisZSetClient.incrementScore("ranking", "user1", 10.0);
+```
+
+## 缓存操作
+
+```java
+@Resource
+private RedisCacheClient redisCacheClient;
+
+// 设置缓存（自动 JSON 序列化）
+redisCacheClient.set("cache:user:1", user, Duration.ofHours(1));
+
+// 获取缓存（自动反序列化）
+User user = redisCacheClient.get("cache:user:1", User.class);
+
+// 删除缓存
+redisCacheClient.delete("cache:user:1");
+
+// 批量删除（按 pattern）
+redisCacheClient.deletePattern("cache:user:*");
+```
+
+## Key 命名规范
+
+使用冒号分隔，格式：`业务:类型:ID`
+
+```
+cache:user:123
+lock:order:456
+rate:api:sms
+bloom:user:exists
+```

package/templates/.claude/skills/avatar-boot-starter-redis/references//351/253/230/347/272/247/345/212/237/350/203/275.md

@@ -0,0 +1,90 @@
+# Redis 高级功能
+
+## 分布式锁
+
+```java
+@Resource
+private RedissonLockClient lockClient;
+
+// 方式一：回调方式（推荐，自动释放锁）
+lockClient.lock("order:lock:123", 30, TimeUnit.SECONDS, () -> {
+    processOrder(orderId);
+});
+
+// 方式二：手动加锁/解锁
+boolean locked = lockClient.tryLock("order:lock:123", 3, 30, TimeUnit.SECONDS);
+if (locked) {
+    try {
+        processOrder(orderId);
+    } finally {
+        lockClient.unlock("order:lock:123"); // 必须释放
+    }
+}
+```
+
+**注意**：
+- 锁超时时间要大于业务执行时间，避免锁提前释放
+- 必须使用 try-finally 或回调方式，防止异常导致死锁
+- 锁 Key 命名规范：`lock:{业务}:{唯一标识}`
+
+## 限流
+
+```java
+@Resource
+private RedisRateLimiterClient rateLimiterClient;
+
+// 令牌桶限流（每秒最多 10 个请求）
+boolean allowed = rateLimiterClient.tryAcquire("api:limit", 10, 1, TimeUnit.SECONDS);
+if (allowed) {
+    // 处理请求
+} else {
+    throw new BusinessException(ResultCode.TOO_MANY_REQUESTS, "请求过于频繁");
+}
+
+// 滑动窗口限流（60 秒内最多 10 次）
+boolean allowed = rateLimiterClient.slidingWindowLimit("api:sms", 10, 60);
+```
+
+**选择建议**：
+- **令牌桶**：适合平滑限流，允许短时突发
+- **滑动窗口**：适合精确控制时间窗口内的请求次数（如短信验证码）
+
+## 布隆过滤器
+
+适用于大数据量下的快速存在性判断（如防止缓存穿透）：
+
+```java
+@Resource
+private RedisBloomFilterClient bloomFilterClient;
+
+// 初始化（预期元素数量 100 万，误判率 0.01）
+bloomFilterClient.init("user:bloom", 1000000, 0.01);
+
+// 添加元素
+bloomFilterClient.add("user:bloom", "user123");
+
+// 判断是否存在（返回 false 一定不存在，返回 true 可能存在）
+boolean exists = bloomFilterClient.contains("user:bloom", "user123");
+```
+
+**防缓存穿透示例**：
+```java
+public User getUser(Long userId) {
+    String key = String.valueOf(userId);
+    // 布隆过滤器快速判断
+    if (!bloomFilterClient.contains("user:bloom", key)) {
+        return null; // 一定不存在，直接返回
+    }
+    // 查缓存
+    User user = redisCacheClient.get("cache:user:" + userId, User.class);
+    if (user != null) return user;
+    // 查数据库
+    user = userMapper.selectById(userId);
+    if (user != null) {
+        redisCacheClient.set("cache:user:" + userId, user, Duration.ofHours(1));
+    }
+    return user;
+}
+```
+
+**注意**：布隆过滤器不支持删除元素，适合只增不删的场景。