Memory Cache

核心用法

memory-cache 技能提供基于Redis的高性能键值存储能力，通过封装脚本简化常见操作。核心工作流包括：

• 键值操作：使用 cache.sh set/get 命令存取数据，支持可选TTL（生存时间）控制缓存有效期
• 安全扫描：基于Redis SCAN命令实现非阻塞式键值检索，避免生产环境性能风险
• 标准化命名：强制采用 mema:<category>:<name> 格式，分为 context（短期会话）、cache（易失数据）、state（跨会话持久化）三类命名空间

显著优点

1. 性能优异：Redis内存存储提供亚毫秒级读写延迟，适合高频缓存场景
2. 会话解耦：mema:state:* 命名空间支持跨Agent会话的状态共享，突破单次对话上下文限制
3. 防御性设计：强制前缀隔离避免与其他Redis数据库冲突，连接层实现自动重试与超时保护
4. 运维友好：venv自动初始化与依赖管理降低部署门槛

潜在局限

• 外部依赖：必须独立部署Redis服务，增加架构复杂度
• 数据易失性：默认无持久化配置，服务重启可能导致mema:cache:*数据丢失
• TTL管理盲区：技能文档未说明默认TTL策略，需用户显式配置避免内存膨胀
• 并发控制缺失：未提及分布式锁或原子操作，高并发场景可能存在竞态条件

适合人群

• 需要跨会话记忆能力的AI Agent开发者
• 有API调用成本优化需求的技术团队（缓存重复请求结果）
• 已具备Redis运维经验、追求低延迟缓存方案的后端工程师

常规风险

| 风险类型 | 说明 |

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

| 连接泄露 | 脚本未展示连接池管理，长期运行可能耗尽Redis连接数 |

| 密钥暴露 | `REDIS_URL`含认证信息时，.env文件权限管理至关重要 |

| 内存溢出 | 无上限的`mema:context:*`写入可能导致Redis OOM |

| 命名空间绕过 | 前缀校验若在脚本层而非Redis ACL层，存在被绕过的可能 |

核心用法

memory-cache 是一款基于 Redis 的高性能临时存储 Skill，专为 Agent 场景设计。用户通过 cache.sh 脚本执行核心操作：

• 数据存取：set 命令支持可选 TTL，get 命令读取值，所有键必须遵循 mema:<category>:<name> 前缀规范
• 键空间扫描：使用 Redis SCAN 命令安全迭代键，避免 KEYS 命令的性能风险
• 命名空间隔离：强制 mema: 前缀，内置 context:（短期会话）、cache:（易失数据）、state:（跨会话持久化）三类语义分类

显著优点

1. 安全设计完善：键名通过正则表达式严格验证（^mema:[a-z]+:[a-zA-Z0-9_:.-]+$），限制键长 512 字符、值大小 512MB，有效防御注入攻击
2. 连接可靠性：实现指数退避重试与超时机制，避免单点故障导致服务中断
3. 性能优化：使用 SCAN 替代 KEYS，支持大规模键空间操作而不阻塞 Redis
4. 配置灵活：通过环境变量管理连接信息，无硬编码凭证，符合云原生部署规范

潜在局限

• T3 来源级别：由个人开发者维护（1999azzar），非知名组织或顶级开源基金会背书
• 依赖版本未锁定：使用 >= 版本范围，存在主版本兼容性风险
• 无连接池：每次操作新建连接，高并发场景性能受限
• 无内建敏感数据检测：用户可能误将密码、密钥存入缓存

适合人群

• 需要跨会话状态共享的 Agent 开发者
• 追求快速部署、轻量级缓存方案的技术团队
• 对 Redis 有基础运维能力的个人开发者

常规风险

• 环境变量泄露：若 REDIS_URL 或 REDIS_PASSWORD 配置不当（如暴露在进程列表），可能导致凭证泄露
• 数据持久化误解：默认 TTL 未强制设置，长期运行的 mema:state:* 键可能意外累积
• Redis 单点依赖：未内建集群或 Sentinel 支持，生产环境需自行保障高可用