若QoderWake智能补全异常，需重新索引本地代码库：一、强制全量重建索引；二、校准语言服务绑定；三、清理index-cache缓存目录；四、配置contextPaths显式注入跨文件上下文；五、验证符号可达性与索引统计。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QoderWake 进行智能补全时发现建议缺失、变量名识别错误、跨文件函数无法引用或补全内容与项目实际结构严重脱节，则很可能是本地代码库索引未完成、损坏或未触发增量更新所致。以下是重新索引本地代码库以提升识别率的具体操作路径：
一、强制触发全量索引重建
QoderWake 依赖后台索引服务扫描项目目录结构、解析 import 关系与类型声明，首次打开大型项目或修改 tsconfig.json/jsconfig.json 后需手动触发完整重建，否则仅维护增量缓存，易导致上下文感知失效。
1、确保当前工作区已正确打开，且根目录下存在有效的配置文件（如 tsconfig.json、jsconfig.json 或 pyproject.toml）。
2、按下 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux），打开命令面板。
3、输入并选择 Qoder: Rebuild Local Index，确认执行。
4、状态栏右下角将显示 Indexing… (XX% complete)，等待进度条结束且图标变为常亮绿色。
二、校准项目语言服务绑定
索引失效常源于语言服务未正确挂载至当前文件类型，例如 .ts 文件被错误识别为 plain text，导致 QoderWake 无法提取 AST 节点与符号表。
1、右键点击编辑器中任意代码文件标签页，选择 Change Language Mode。
2、在弹出列表中确认所选语言与文件扩展名严格匹配（如 TypeScript、Python、Java），避免选择 TypeScript React 等子类模式干扰主索引。
3、打开命令面板，执行 Developer: Show Running Extensions，检查 Qoder CN Language Service 进程是否处于 Active 状态。
4、若显示 Inactive，执行 Developer: Restart Extension Host 并重新加载窗口。
三、清理本地索引缓存目录
QoderWake 在用户目录下维护独立的索引缓存，路径为 ~/.qoder/index-cache/（macOS/Linux）或 %LOCALAPPDATA%\Qoder\index-cache\（Windows）。该目录内文件损坏将阻断新索引写入，必须彻底清除后重建。
1、完全退出 QoderWake 客户端及所有关联 IDE 实例。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、定位并删除整个 index-cache 文件夹（注意：不删除 .qoder/config.json 配置文件）。
3、重启 IDE，打开同一工作区，等待状态栏出现 Qoder: Indexing started 提示。
4、此时系统将自动从空状态开始扫描，耗时取决于项目规模，典型中型项目（5万行）约需 90–150 秒。
四、启用显式跨文件上下文注入
默认索引仅覆盖直接 import 的模块，对动态 require、条件加载或 monorepo 中的 workspace 包引用识别率偏低。需通过配置显式声明关键上下文路径，强制纳入索引范围。
1、在项目根目录创建或编辑 .qoder/config.json 文件。
2、添加 "contextPaths" 字段，填入绝对路径或相对于根目录的 glob 模式：
3、示例配置：
{"contextPaths": ["packages/**/src", "libs/core/src", "types/**/*.d.ts"]}
4、保存文件后，在命令面板中执行 Qoder: Reload Configuration，随后触发一次全量索引重建。
五、验证索引完整性与符号可达性
索引完成后需验证关键符号是否真实进入语义图谱，避免“假成功”——界面无报错但实际未解析核心模块。
1、在任意 .ts 文件中输入 import {，观察补全列表是否包含本项目内定义的命名空间或导出类。
2、将光标置于已导入的自定义类名上，按下 Cmd + Click（macOS）或 Ctrl + Click（Windows/Linux），确认可跳转至源码定义位置。
3、在 QoderWake 会话面板中输入指令 /debug show-index-stats，查看返回的 totalSymbols 与 indexedFiles 数值是否与项目实际规模匹配（如 10k+ symbols / 800+ files）。
