qoder项目缓存清理需分五步：一删项目级.qoder目录；二清全局索引库（保留schema_version.json）；三用qoder cache flush --project --force刷新；四建.qoderignore禁用记忆持久化；五用qoder-clean批量清理陈旧缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 过程中发现项目加载缓慢、磁盘空间异常占用升高或代码补全响应迟滞，则很可能是项目级缓存（如 .qoder 目录、本地向量索引、AST 缓存文件）持续累积所致。以下是针对 Qoder 项目缓存的精准清理与空间释放方法：
一、删除项目根目录下的 .qoder 隐蔽缓存目录
.qoder 是 Qoder 在每个打开项目中自动生成的本地状态目录，包含项目专属的记忆快照、符号索引、上下文向量库及调试元数据。该目录不随项目关闭自动清除，长期驻留将导致磁盘冗余与跨项目干扰。
1、确保 Qoder 已完全退出，包括后台服务进程（可通过任务管理器或 qoder ps --all 确认无残留）。
2、进入当前项目所在文件夹，在文件管理器中启用“显示隐藏文件”功能。
3、定位并彻底删除名为 .qoder 的文件夹（注意开头为英文点号，非 qoder 或 Qoder）。
4、重新用 Qoder 打开该项目，系统将重建轻量级初始缓存，首次索引耗时增加约15–30秒，但后续响应更稳定。
二、清空全局项目索引数据库（适用于多项目环境）
Qoder 会将多个项目的 AST 结构与语义图谱统一写入共享索引库，位于用户级全局存储路径。该库若未定期修剪，易产生重复索引与碎片化内存映射，显著拖慢新项目加载速度。
1、关闭所有 Qoder 实例及关联 IDE（如 VS Code）。
2、根据操作系统，导航至以下路径之一：
Windows：%APPDATA%\Qoder\indexdb\
macOS：~/Library/Application Support/Qoder/indexdb/
Linux：~/.local/share/Qoder/indexdb/
3、删除该目录下除 schema_version.json 外的所有子文件夹与文件（保留 schema_version.json 可避免索引重建失败）。
4、重启 Qoder，首次打开任一项目时将触发增量索引重建，无需全量扫描。
三、执行 CLI 强制项目缓存刷新命令
Qoder CLI 提供原子化缓存操作指令，可绕过图形界面限制，直接清理指定项目的向量化记忆与上下文快照，避免误删配置文件。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
1、打开终端（Windows：PowerShell；macOS/Linux：Terminal），确保已安装 Qoder CLI 并加入 PATH。
2、切换至目标项目根目录：cd /path/to/your/project
3、运行缓存刷新命令：qoder cache flush --project --force
4、确认输出中出现 "Project cache cleared: AST, vector, context snapshots removed" 字样。
5、重新加载项目，观察 Qoder 底部状态栏是否显示“Indexing…”并快速转为就绪状态。
四、禁用项目级记忆持久化（预防性提速）
对于临时调试项目、学习示例或一次性脚本工程，可主动关闭 Qoder 对该项目的记忆写入行为，从源头杜绝缓存生成，实现零缓存运行模式。
1、在项目根目录下新建纯文本文件，命名为 .qoderignore（注意开头为英文点号）。
2、在该文件中写入单行内容：memory_persistence: false
3、保存后重启 Qoder 并重新打开该项目。
4、验证生效：执行 qoder memory list --scope=project，返回结果应为空或仅含基础元数据，无向量条目。
五、使用 qoder-clean 工具批量清理跨项目冗余缓存
qoder-clean 是一个由社区维护的独立 Python 脚本工具，支持按最后访问时间、大小阈值、项目活跃度等维度智能识别并清理陈旧项目缓存，避免手动逐个判断。
1、在终端中执行安装命令：pip install qoder-clean
2、运行扫描命令，列出所有缓存超7天未更新的项目：qoder-clean --scan --stale-days 7
3、确认待清理列表无误后，执行安全删除：qoder-clean --purge --stale-days 7 --dry-run false
4、工具将跳过受 Git 保护的项目，并对每个删除动作记录日志至 ~/.qoder-clean/log/。
