Memory Cache

核心功能

Memory Cache 是一个基于 Redis 的高性能临时存储技能，专为 AI 代理场景设计。它提供三种核心能力：

• 上下文保存：使用 mema:context:* 命名空间存储短期会话状态
• API 结果缓存：通过 mema:cache:* 缓存昂贵的 API 调用结果，支持 TTL 过期策略
• 跨会话状态共享：利用 mema:state:* 实现持久化的代理间数据交换

显著优点

1. 命名空间隔离：强制 mema: 前缀机制，有效防止与其他 Redis 数据库的键冲突
2. 连接可靠性：内置连接重试和超时处理，提升生产环境稳定性
3. 轻量集成：仅需 REDIS_URL 环境变量，自动完成虚拟环境和依赖初始化
4. 安全扫描：使用 SCAN 替代 KEYS 命令，避免阻塞 Redis 生产实例

潜在局限

• 外部依赖：必须部署 Redis 服务，增加基础设施复杂度
• 数据持久性：作为缓存层设计，非持久化存储方案
• 并发控制：未提及分布式锁或事务机制，高并发写入场景需谨慎
• Schema 约束：严格的三级命名规范（mema:<category>:<name>）限制了灵活性

适合人群

• 需要跨多轮对话维护上下文的对话系统开发者
• 希望降低 API 调用成本的 LLM 应用架构师
• 运行多代理协作系统的平台工程师

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据泄露 | Redis 默认无认证，公网暴露风险 | 配置 Redis AUTH 和防火墙规则 |

| 内存溢出 | 无默认 TTL 可能导致 OOM | 强制设置合理的过期时间 |

| 序列化安全 | 存储对象依赖 pickle/json | 避免存储不可信来源的数据 |

| 命名冲突 | 多用户共享 Redis 实例时 | 配合用户 ID 细分 category 层级 |

核心用法

memory-cache 是一个基于 Redis 的高性能临时存储 Skill，专为 Agent 会话设计，提供三种核心数据管理能力：

1. 键值操作：通过 cache.py 脚本执行 set/get/delete 操作，支持 TTL 过期时间设置
2. 安全扫描：使用 SCAN 命令而非 KEYS 避免 Redis 阻塞，支持模式匹配查询
3. 命名空间隔离：强制 mema: 前缀，细分 context:（会话状态）、cache:（API缓存）、state:（跨会话持久化）三类场景

显著优点

• 性能优异：Redis 内存存储，毫秒级响应，适合高频读写
• 架构安全：强制前缀隔离避免键冲突，环境变量管理敏感配置
• 跨会话共享：突破单会话内存限制，实现 Agent 间状态传递
• 成本优化：缓存昂贵 API 结果，减少重复调用费用

潜在局限

• 外部依赖：需独立部署 Redis 实例，增加运维复杂度
• 数据持久性：默认配置下 Redis 重启可能丢失数据（需额外配置 AOF/RDB）
• 无内置加密：需用户自行配置 TLS 和 Redis 认证
• 单点瓶颈：高并发场景需 Redis Cluster 扩展

适合人群

• 需要跨多轮对话保持上下文的复杂 Agent 开发者
• 调用付费 API（如 LLM、搜索服务）需缓存降本的场景
• 多 Agent 协作需要共享状态的中大型项目

常规风险

• 配置泄露：REDIS_URL 若含密码，需确保 .env 不被提交
• 未授权访问：Redis 默认无密码，公网部署必须配置 requirepass 和防火墙
• 内存溢出：未设置 TTL 的缓存可能耗尽内存，建议配合 maxmemory-policy