Redis Cache Inspector

Redis缓存查看器

Use this skill to inspect Redis cache state for debugging purposes.

使用该技能可查看Redis缓存状态，以满足调试需求。

Running Commands

运行命令

bash

node .claude/skills/redis-inspect/query.mjs <command> [options]

bash

node .claude/skills/redis-inspect/query.mjs <command> [options]

Commands

命令

Command	Description
`get <key>`	Get a string value
`keys <pattern>`	Find keys matching pattern (use * as wildcard)
`ttl <key>`	Get TTL (-1 = no expiry, -2 = not found)
`type <key>`	Get the type of a key
`exists <key>`	Check if key exists
`hgetall <key>`	Get all fields from a hash
`hget <key> <field>`	Get a specific hash field
`scard <key>`	Get set cardinality (count)
`smembers <key>`	Get all set members
`llen <key>`	Get list length
`lrange <key>`	Get list elements
`del <key>`	Delete a key (requires --writable)
`info`	Get Redis server info

命令	描述
`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服务器信息

Options

选项

Flag	Description
`--sys`	Use system cache instead of main cache
`--writable`	Allow write operations (required for del)
`--json`	Output raw JSON
`--limit <n>`	Limit results (default: 100)

标识	描述
`--sys`	使用系统缓存而非主缓存
`--writable`	允许写入操作（执行del命令时必填）
`--json`	输出原始JSON格式
`--limit <n>`	限制结果数量（默认值：100）

Cache Types

缓存类型

The project has two Redis instances:

Cache	Flag	Env Variable	Purpose
Main Cache	(default)	`REDIS_URL`	Regular cache, cluster mode, can be lost
System Cache	`--sys`	`REDIS_SYS_URL`	Persistent system values, single node

项目包含两个Redis实例：

缓存	标识	环境变量	用途
主缓存	（默认）	`REDIS_URL`	常规缓存，集群模式，数据可丢失
系统缓存	`--sys`	`REDIS_SYS_URL`	持久化系统值，单节点

Main Cache (default)

主缓存（默认）

Regular application cache. Data here can be regenerated if lost.

User sessions
Cached queries
Temporary data
Rate limiting counters

常规应用缓存，数据丢失后可重新生成。

用户会话
缓存查询结果
临时数据
限流计数器

System Cache (--sys)

系统缓存（--sys）

Persistent system configuration and state. More critical data.

Feature flags
Generation limits/status
System permissions
Job state
Event configurations

持久化系统配置与状态，存储更关键的数据。

功能开关
生成限制/状态
系统权限
任务状态
事件配置

Examples

示例

bash

undefined

bash

undefined

Find keys matching a pattern

查找匹配指定模式的键

node .claude/skills/redis-inspect/query.mjs keys "user:" --limit 20 node .claude/skills/redis-inspect/query.mjs keys "packed:caches:"

Get a value

获取值

node .claude/skills/redis-inspect/query.mjs get "session:data2:123456"

Check system cache values

检查系统缓存值

node .claude/skills/redis-inspect/query.mjs --sys get "system:features" node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:entity-moderation"

Check TTL

检查TTL

node .claude/skills/redis-inspect/query.mjs ttl "generation:count:123"

Inspect a hash

查看哈希表

node .claude/skills/redis-inspect/query.mjs hgetall "packed:caches:cosmetics" node .claude/skills/redis-inspect/query.mjs hget "system:entity-moderation" "entities"

Check set size

检查集合大小

node .claude/skills/redis-inspect/query.mjs scard "queues:seen-images"

Get server info

获取服务器信息

node .claude/skills/redis-inspect/query.mjs info node .claude/skills/redis-inspect/query.mjs --sys info

undefined

node .claude/skills/redis-inspect/query.mjs info node .claude/skills/redis-inspect/query.mjs --sys info

undefined

Common Key Patterns

常见键模式

Main Cache

主缓存

Pattern	Description
`user:*`	User data
`session:*`	Session data
`packed:caches:*`	Packed/compressed cached data
`packed:user:*`	Packed user cache
`generation:*`	Generation-related cache
`tag:*`	Tag cache

模式	描述
`user:*`	用户数据
`session:*`	会话数据
`packed:caches:*`	打包/压缩的缓存数据
`packed:user:*`	打包的用户缓存
`generation:*`	生成相关缓存
`tag:*`	标签缓存

System Cache

系统缓存

Pattern	Description
`system:*`	System configuration
`generation:*`	Generation limits/status
`download:limits`	Download limits
`job:*`	Job state
`event:*`	Event configurations
`new-order:*`	New Order game state
`daily-challenge:*`	Daily challenge config

模式	描述
`system:*`	系统配置
`generation:*`	生成限制/状态
`download:limits`	下载限制
`job:*`	任务状态
`event:*`	事件配置
`new-order:*`	New Order游戏状态
`daily-challenge:*`	每日挑战配置

Debugging Tips

调试技巧

bash

undefined

bash

undefined

Check if a user's session exists

检查用户会话是否存在

node .claude/skills/redis-inspect/query.mjs keys "session:data2:*" --limit 10

Check generation status

检查生成状态

node .claude/skills/redis-inspect/query.mjs --sys get "generation:status"

Check feature flags

检查功能开关

node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:features"

Check cache memory usage

检查缓存内存使用情况

node .claude/skills/redis-inspect/query.mjs info

undefined

node .claude/skills/redis-inspect/query.mjs info

undefined

Write Operations

写入操作

Write operations require

--writable

flag and user approval:

bash

undefined

写入操作需要

--writable

标识以及用户授权：

bash

undefined

Delete a specific key (requires approval)

删除指定键（需授权）

node .claude/skills/redis-inspect/query.mjs del "some:key" --writable


**IMPORTANT**: Always ask the user for permission before using `--writable`.

node .claude/skills/redis-inspect/query.mjs del "some:key" --writable


**重要提示**：在使用`--writable`前，务必获得用户许可。

redis-inspect

Original

Translation

Redis Cache Inspector

Redis缓存查看器

Running Commands

运行命令

Commands

命令

Options

选项

Cache Types

缓存类型

Main Cache (default)

主缓存（默认）

System Cache (--sys)

系统缓存（--sys）

Examples

示例

Find keys matching a pattern

查找匹配指定模式的键

Get a value

获取值

Check system cache values

检查系统缓存值

Check TTL

检查TTL

Inspect a hash

查看哈希表

Check set size

检查集合大小

Get server info

获取服务器信息

Common Key Patterns

常见键模式

Main Cache

主缓存

System Cache

系统缓存

Debugging Tips

调试技巧

Check if a user's session exists

检查用户会话是否存在

Check generation status

检查生成状态

Check feature flags

检查功能开关

Check cache memory usage

检查缓存内存使用情况

Write Operations

写入操作

Delete a specific key (requires approval)

删除指定键（需授权）