QoderWake运行变慢等问题通常由缓存堆积引起，可通过五种方式清理：一、启用轻量级模式禁用非核心缓存；二、执行CLI命令强制刷新；三、手动删除本地缓存目录文件；四、使用i管家风格深度扫描清理；五、禁用高开销Connector缓存并切换轮询模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake数字员工过程中发现运行变慢、界面卡顿、任务响应延迟或频繁触发内存告警，则很可能是由于缓存模块未及时清理导致的资源堆积。QoderWake在运行中会持续生成工作流中间状态、Connector临时凭证、记忆压缩快照及UI渲染缓存，若长期未清理，将显著挤占内存与磁盘IO资源。以下是针对QoderWake缓存清理的多种实操路径：
一、启用轻量级运行模式并禁用非核心缓存组件
轻量级模式通过停用非必需的缓存服务（如实时工作流图谱渲染缓存、长期记忆索引缓存）来降低常驻内存占用，适用于日常运维、日志分析等中低复杂度任务场景，可即时缓解界面卡顿。
1、登录QoderWake Web控制台或启动桌面端应用。
2、点击右上角用户头像，选择设置 > 运行模式 > 轻量级。
3、在弹出的确认框中勾选“停用记忆压缩外的长期记忆索引”与“禁用实时工作流图谱渲染”两项。
4、点击保存后，系统将自动重启Agent服务进程。
二、执行内置缓存管理命令强制刷新
QoderWake CLI提供直接操作缓存层的指令，可绕过UI等待，立即清空运行时缓存队列、临时凭证池及UI组件状态快照，适用于界面已卡死无法触达设置页的紧急情况。
1、打开终端，确保已完成身份登录：执行qoderwake status验证登录状态。
2、执行缓存强制刷新命令：qoderwake cache flush --scope=all --force。
3、若仅需清理UI层缓存以恢复界面响应，添加参数--scope=ui-render： qoderwake cache flush --scope=ui-render --force。
4、命令执行完成后，界面将在10秒内自动重载，无需手动重启客户端。
三、手动清理本地缓存目录（Linux/macOS/WSL2环境）
当CLI命令失效或需深度清除残留时，可直接访问QoderWake本地缓存根目录，删除已失效的临时文件与过期快照，该操作不影响配置文件与持久化记忆数据。
1、在终端中执行命令定位缓存路径：qoderwake config --show-cache-dir。
2、进入该目录，典型路径为~/.qoderwake/cache/或/var/lib/qoderwake/cache/。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、执行清理命令：find . -name "*.tmp" -o -name "snapshot_*.bin" -o -name "render_cache_*" -delete。
4、删除完成后，运行qoderwake memory prune --dry-run验证缓存引用完整性，确认无 dangling 引用。
四、通过i管家风格空间清理模块扫描深层缓存
该路径复用iQOO手机i管家的空间清理逻辑，适配QoderWake桌面端（Electron构建版），可调用系统级权限扫描并识别隐藏于AppData/Local/QoderWake/Cache下的广告SDK缓存、WebView临时数据库及崩溃日志缓存。
1、在QoderWake桌面端左下角点击“工具箱”图标，选择「高级清理」。
2、点击「启动深度缓存扫描」，系统将挂载缓存目录并启用只读分析模式。
3、扫描结束后，在结果页勾选“WebView缓存”“崩溃日志缓存”“广告SDK私有缓存池”三项。
4、取消勾选“长期记忆快照”与“技能配置备份”，防止误删关键状态。
5、点击「安全清理」按钮，系统将执行特权级擦除并刷新UI渲染引擎。
五、禁用并轮询式重置高开销Connector缓存
部分Connector（如GitHub、Slack、Notion）会在本地维护大量元数据缓存以加速响应，但其缓存更新策略易引发一致性问题与内存泄漏；切换为轮询模式可切断持续缓存写入链路，实现被动式清理。
1、进入QoderWake控制台「集成中心 > 已启用连接器」。
2、对目标Connector（如显示“缓存命中率>95%且last_update>72h”的条目），点击右侧「编辑」。
3、在高级设置中关闭“启用本地元数据缓存”，并将“同步策略”设为“轮询（5分钟）”。
4、保存后，系统将自动断开当前连接，5分钟内以最小粒度拉取增量变更，原缓存目录将被标记为待回收。
