安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常,本站会改为提示页 + 原始链接,请按页内说明操作。
下载 ZIP (shub-redis-store-v1.0.0.zip)触发指令
/redis
跨平台安装指引
该技能声明兼容以下 1 个平台,将 ZIP 解压到对应目录即可被识别。
unzip shub-redis-store-v1.0.0.zip -d ~/.claude/skills/
mkdir -p 创建;启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
Redis 存储
围绕 Redis 存储:数据结构选型、过期、发布订阅与内存策略;持久化与集群行为以部署版本为准。 无需在每次任务前把零散英文说明手工拼进上下文,也 减少 与客户端默认行为脱节的试错;具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同:何时用、前置、流程、速查与故障。
何时使用
- 数据结构选型、过期、发布订阅与内存策略
- 持久化与集群行为以部署版本为准
- 已获取本技能 ZIP,并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
- 希望用中文专题稿快速判断「该不该启用」,再深入英文 SKILL 查参数与边界。
- 需要与团队对齐同一套触发方式、目录约定或回调格式时。
前置条件
- 通用:可运行 Claude Code 或文档要求的客户端;有可读写的项目工作区(或 SKILL.md 指定的沙箱目录)。
- 权威细节:API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。
典型流程
- 从 ClawHub / 站内分发获取技能 ZIP,校验版本与校验和(若提供)。
- 阅读 SKILL.md 的安装段落:目录落点、客户端类型(Claude Code / OpenClaw / 脚本)。
- 用文档中的最小示例完成第一次调用(单文件修改、单次查询或单次委派)。
- 确认工作目录、权限边界与输出路径后,再处理多文件或长耗时任务。
- 需要回调 / Webhook / 通知时,按 SKILL.md 配置端点并在测试环境先验通。
与 ZIP / SKILL.md 的关系
站内专题稿与 MCP CLI 类 oss 稿同样:概括何时用、怎么接、怎么排错;命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。
命令示例(摘自包内 SKILL.md)
以下为从上游 SKILL.md(或入库正文)自动抽取的终端/脚本片段;路径、环境变量与参数以当前 ZIP 与官方说明为准。
ClawHub slug:redis-store(安装命令以 SKILL.md / claw CLI 为准)。
站内入库时的触发命令(完整语义见 ZIP):
# 使用本技能时可在对话中引用或执行上述指令;完整参数与示例见下载包内 SKILL.md。
/redis
最佳实践
- 先 SKILL.md 再猜参数;站内专题稿不替代 schema 与必填字段说明。
- 委派任务时写清验收标准(命令、文件路径、测试命令),减少来回追问。
- 长任务用文档推荐的回调 / 日志落盘代替高频轮询,省 Token 也省机器负载。
- 多技能同时启用时,注意钩子加载顺序与重复工具调用(以 SKILL.md 冲突说明为准)。
调试与排错
- 打开 stderr 与客户端日志;PTY/tmux 场景同时看面板最后几十行输出。
- 参数错误时对照 SKILL.md 中的 JSON/CLI 示例(引号、转义、工作目录)。
- 网络类失败:查代理、防火墙、MCP 传输方式(stdio / HTTP / SSE)。
速查
| 动作 | 说明 |
|------|------|
| 获取技能包 | ClawHub / 站内 ZIP,核对版本 |
| 权威步骤 | 优先阅读 ZIP 内 SKILL.md |
| 首次试跑 | 使用 SKILL.md 最小示例 |
| 验收 | 对照路径、测试命令或回调负载 |
常见故障
- 无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录;按 SKILL.md 自检清单执行。
- 权限被拒绝 → 检查沙箱路径、
--permission-mode与工具白名单。 - 与简介不符 → 以英文 SKILL 与上游仓库为准,站内稿仅作结构化导读。
## Expiration (Memory Leaks)
- Keys without TTL live forever—set expiry on every cache key: `SET key value EX 3600`
- Can't add TTL after SET without another command—use `SETEX` or `SET ... EX`
- `EXPIRE` resets on key update by default—`SET` removes TTL; use `SET ... KEEPTTL` (Redis 6+)
- Lazy expiration: expired keys removed on access—may consume memory until touched
- `SCAN` with large database: expired keys still show until cleanup cycle runs
## Data Structures I Underuse
- Sorted sets for rate limiting: `ZADD limits:{user} {now} {request_id}` + `ZREMRANGEBYSCORE` for sliding window
- HyperLogLog for unique counts: `PFADD visitors {ip}` uses 12KB for billions of uniques
- Streams for queues: `XADD`, `XREAD`, `XACK`—better than LIST for reliable queues
- Hashes for objects: `HSET user:1 name "Alice" email "a@b.com"`—more memory efficient than JSON string
## Atomicity Traps
- `GET` then `SET` is not atomic—another client can modify between; use `INCR`, `SETNX`, or Lua
- `SETNX` for locks: `SET lock:resource {token} NX EX 30`—NX = only if not exists
- `WATCH`/`MULTI`/`EXEC` for optimistic locking—transaction aborts if watched key changed
- Lua scripts are atomic—use for complex operations: `EVAL "script" keys args`
## Pub/Sub Limitations
- Messages not persisted—subscribers miss messages sent while disconnected
- At-most-once delivery—no acknowledgment, no retry
- Use Streams for reliable messaging—`XREAD BLOCK` + `XACK` pattern
- Pub/Sub across cluster: message goes to all nodes—works but adds overhead
## Persistence Configuration
- RDB (snapshots): fast recovery, but data loss between snapshots—default every 5min
- AOF (append log): less data loss, slower recovery—`appendfsync everysec` is good balance
- Both off = pure cache—acceptable if data can be regenerated
- `BGSAVE` for manual snapshot—doesn't block but forks process, needs memory headroom
## Memory Management (Critical)
- `maxmemory` must be set—without it, Redis uses all RAM, then swap = disaster
- Eviction policies: `allkeys-lru` for cache, `volatile-lru` for mixed, `noeviction` for persistent data
- `INFO memory` shows usage—monitor `used_memory` vs `maxmemory`
- Large keys hurt eviction—one 1GB key evicts poorly; prefer many small keys
## Clustering
- Hash slots: keys distributed by hash—same slot required for multi-key operations
- Hash tags: `{user:1}:profile` and `{user:1}:sessions` go to same slot—use for related keys
- No cross-slot `MGET`/`MSET`—error unless all keys in same slot
- `MOVED` redirect: client must follow—use cluster-aware client library
## Common Patterns
- Cache-aside: check Redis, miss → fetch DB → write Redis—standard caching
- Write-through: write DB + Redis together—keeps cache fresh
- Rate limiter: `INCR requests:{ip}:{minute}` with `EXPIRE`—simple fixed window
- Distributed lock: `SET ... NX EX` + unique token—verify token on release
## Connection Management
- Connection pooling: reuse connections—creating is expensive
- Pipeline commands: send batch without waiting—reduces round trips
- `QUIT` on shutdown—graceful disconnect
- Sentinel or Cluster for HA—single Redis is SPOF
## Common Mistakes
- No TTL on cache keys—memory grows until OOM
- Using as primary database without persistence—data loss on restart
- Blocking operations in single-threaded Redis—`KEYS *` blocks everything; use `SCAN`
- Storing large blobs—Redis is RAM; 100MB values are expensive
- Ignoring `maxmemory`—production Redis without limit will crash host