Qoder AI补全异常时应清理缓存：一、运行qoder-reset --force重置；二、手动删除~/.qoder/或AppData/Local/.qoder/及IDE插件缓存；三、刷新DNS、重置Lingma配置、验证API连通性；四、关闭节电模式并禁用冲突插件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 进行代码编写时发现 AI 补全建议不再出现、响应延迟或推荐内容明显偏离上下文，则很可能是本地缓存污染或配置残留干扰了模型推理路径。以下是通过清理缓存恢复 AI 预测精度的多种可行操作路径：
一、执行 qoder-reset 一键重置脚本
该脚本专为彻底清除 Qoder 所有运行态残留设计，覆盖模型缓存、会话历史、本地配置及临时文件目录，确保回归初始安装状态。其执行过程自动识别并删除散落在用户空间的关键路径，避免手动遗漏。
1、打开终端（macOS/Linux）或 PowerShell（Windows），确保已配置 qoder-reset 命令全局可用。
2、执行命令：qoder-reset --force，该参数将跳过确认提示并强制执行全部清理动作。
3、等待脚本输出“Reset completed. Please restart your IDE.”后，关闭并重新启动当前 IDE。
二、手动清除 Qoder 相关缓存目录
当 qoder-reset 不可用或需针对性清理时，可直接定位并删除 Qoder 使用的缓存主目录。这些目录存储了模型加载中间产物、向量索引快照及上下文感知缓存，损坏后会导致预测逻辑失准。
1、根据操作系统定位对应路径：~/.qoder/（Linux/macOS）或 C:\Users\{用户名}\AppData\Local\.qoder\（Windows）。
2、确认该目录下存在 cache/、models/、sessions/ 子目录后，执行递归删除操作。
3、同步删除 IDE 插件级缓存：在 PyCharm 中依次点击 File → Invalidate Caches and Restart → Invalidate and Restart；在 VS Code 中执行 Developer: Reload Window 并清空 ~/.vscode/extensions/qoder-* 下的 state.json 与 cache.db 文件。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、重置 Lingma 配置与 DNS 缓存
Qoder CN 依赖 lingma-api.tongyi.aliyun.com 等域名完成云端模型调用，若 DNS 解析结果被污染或本地代理配置异常，将导致上下文感知链路中断，进而使 AI 预测退化为静态补全。
1、刷新系统 DNS 缓存：Windows 执行 ipconfig /flushdns；macOS 执行 sudo killall -hup mDNSResponder。
2、检查并重置 Lingma 配置文件：~/.lingma/config.json（Linux/macOS）或 C:\Users\{用户名}\AppData\Local\.lingma\config.json（Windows），将 http_proxy 字段设为空字符串或完全删除该字段。
3、验证基础连通性：在终端中运行 curl -s https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping，预期返回 pong；若超时或返回 403，说明网络策略仍阻断关键端点。
四、禁用节电模式与冲突插件
IDE 节电模式会主动暂停后台语言服务，而第三方插件（如其他 AI 补全工具、代码格式化器）可能劫持编辑器事件流，导致 Qoder 的 AST 感知与 ActionRL 推理链被截断，从而丧失多点位预测能力。
1、在 PyCharm 中检查右下角状态栏是否显示“Battery Saver Mode”图标，若存在，点击关闭该模式。
2、进入 IDE 插件管理界面，临时禁用所有非 Qoder 官方插件，特别是名称含 “Copilot”、“Tabnine”、“CodeWhisperer” 的同类工具。
3、重启 IDE 后，在空白项目中新建 .py 或 .java 文件，输入简单函数头（如 def process_data(），观察是否触发跨变量名联想与 import 自动补全。
