Codex接入Redis缓存是为了避免重复执行耗时的代码分析、索引查询或语义匹配操作，提升响应速度并降低系统负载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Codex项目中接入Redis缓存查询结果，是为了避免重复执行耗时的代码分析、索引查询或语义匹配操作——比如用户连续三次请求同一函数的调用链路，若每次都要重新解析AST并遍历依赖图，响应延迟会直接翻三倍。必须让高频查询走缓存，且缓存内容要可验证、可刷新、不污染原始索引状态。
确认Codex已启用Redis客户端支持
打开Codex服务的配置文件（通常是application.yml或codex-config.json），检查是否已声明Redis连接参数。关键字段包括redis.host、redis.port、redis.database，若使用密码还需存在redis.password。缺少任一字段将导致缓存初始化失败，后续所有缓存操作静默降级为直查。
运行curl -X GET http://localhost:8080/health/cache验证缓存模块是否就绪。返回{"cache":"ready","backend":"redis"}表示连接成功；若返回{"cache":"unavailable"}，请先修正配置并重启服务。
为查询接口注入缓存逻辑
以代码符号搜索接口为例（路径/api/v1/symbol/search），需在对应Service方法中嵌入缓存读写分支：
第一步：构造唯一缓存键，格式为codex:sym:search:+【MD5(queryText + language + scope)】。不能直接用原始queryText作key，否则含空格、斜杠、中文的请求会导致Redis命令解析错误或键名冲突。
第二步：调用stringRedisTemplate.opsForValue().get(key)尝试获取缓存值。若返回非null字符串，直接反序列化为SearchResult对象并返回，跳过全部代码解析流程。
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
第三步：缓存未命中时，执行原始查询逻辑（如加载索引、构建AST、执行语义匹配），得到结果后立即写入缓存：stringRedisTemplate.opsForValue().set(key, jsonResult, Duration.ofMinutes(15))。这里设15分钟过期是硬性要求——CodeX索引可能被后台任务增量更新，过长的缓存窗口会导致返回陈旧符号位置。
手动刷新特定查询缓存
方法一：通过Codex管理端HTTP接口强制失效
发送POST请求到/api/v1/cache/evict/symbol，Body为JSON：{"queryText":"handleClick","language":"ts","scope":"web-ui"}。接口内部会重建相同key并执行DEL命令，下次请求即触发新计算。
方法二：使用redis-cli直连清除
redis-cli -h 127.0.0.1 -p 6379 -a yourpass DEL codex:sym:search:8a3f9c2e4b1d7...。注意：必须输入完整key，Codex不提供模糊匹配批量删除能力，误删其他key可能导致功能异常。
【警告：不要在生产环境执行KEYS codex:sym:*】该命令会阻塞Redis主线程，在百万级键的实例上可能引发超时熔断。
验证缓存是否生效
① 启动Codex时添加JVM参数-Dcodex.log.cache=debug，使缓存命中/未命中日志输出到console；
② 发起两次完全相同的符号搜索请求，观察日志中是否出现[CACHE HIT] key=codex:sym:search:...；
③ 登录Redis终端，执行TTL codex:sym:search:8a3f9c2e4b1d7...，确认返回值为正整数（如892），而非-1。
