Redis Cache Inspector 是一个用于调试目的、检查 Redis 缓存状态的技能。
用途
该技能用于检查 Redis 缓存状态以进行调试，支持主缓存和系统缓存两种缓存类型。可用于调试缓存问题、检查缓存值等场景。
运行方式
通过命令行运行脚本：
node .claude/skills/redis-inspect/query.mjs <command> [options]
支持的命令
- get <key>：获取字符串值
- keys <pattern>：查找匹配模式的键（使用 * 作为通配符）
- ttl <key>：获取 TTL（-1 表示无过期，-2 表示未找到）
- type <key>：获取键的类型
- exists <key>：检查键是否存在
- hgetall <key>：获取哈希中的所有字段
- hget <key> <field>：获取指定的哈希字段
- scard <key>：获取集合基数（数量）
- smembers <key>：获取集合的所有成员
- llen <key>：获取列表长度
- lrange <key>：获取列表元素
- del <key>：删除键（需要 --writable）
- info：获取 Redis 服务器信息
选项
- --sys：使用系统缓存而非主缓存
- --writable：允许写操作（del 命令必需）
- --json：输出原始 JSON
- --limit <n>：限制结果数量（默认：100）
缓存类型
项目有两个 Redis 实例：
- 主缓存（默认）：环境变量 REDIS_URL，常规缓存，集群模式，数据丢失后可重新生成。用于用户会话、缓存查询、临时数据、限流计数器。
- 系统缓存（--sys）：环境变量 REDIS_SYS_URL，持久化系统值，单节点。用于功能开关、生成限制/状态、系统权限、任务状态、事件配置。
使用示例
查找匹配模式的键： node .claude/skills/redis-inspect/query.mjs keys "user:" --limit 20 node .claude/skills/redis-inspect/query.mjs keys "packed:caches:"
获取值： node .claude/skills/redis-inspect/query.mjs get "session:data2:123456"
检查系统缓存值： node .claude/skills/redis-inspect/query.mjs --sys get "system:features" node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:entity-moderation"
检查 TTL： node .claude/skills/redis-inspect/query.mjs ttl "generation:count:123"
检查哈希： node .claude/skills/redis-inspect/query.mjs hgetall "packed:caches:cosmetics" node .claude/skills/redis-inspect/query.mjs hget "system:entity-moderation" "entities"
检查集合大小： node .claude/skills/redis-inspect/query.mjs scard "queues:seen-images"
获取服务器信息： node .claude/skills/redis-inspect/query.mjs info node .claude/skills/redis-inspect/query.mjs --sys info
常见键模式
主缓存：
- user:*：用户数据
- session:*：会话数据
- packed:caches:*：打包/压缩的缓存数据
- packed:user:*：打包的用户缓存
- generation:*：生成相关缓存
- tag:*：标签缓存
系统缓存：
- system:*：系统配置
- generation:*：生成限制/状态
- download:limits：下载限制
- job:*：任务状态
- event:*：事件配置
- new-order:*：New Order 游戏状态
- daily-challenge:*：每日挑战配置
调试提示
检查用户会话是否存在： node .claude/skills/redis-inspect/query.mjs keys "session:data2:*" --limit 10
检查生成状态： node .claude/skills/redis-inspect/query.mjs --sys get "generation:status"
检查功能开关： node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:features"
检查缓存内存使用： node .claude/skills/redis-inspect/query.mjs info
写操作
写操作需要 --writable 标志和用户批准：
node .claude/skills/redis-inspect/query.mjs del "some:key" --writable
重要：使用 --writable 前务必先征得用户许可。
限制
资料未提供关于收费、价格、平台支持范围、性能效果等方面的信息。