在使用 QoderWake 进行全局搜索（快捷键 Ctrl+Shift+F）时，搜索结果中常混入大量无关文件，如 node_modules、.git、__pycache__ 等，这些干扰项会淹没核心代码。实际上，要彻底解决这一问题，关键在于从索引源头入手，让这些路径不被扫描、不建立索引、不返回任何匹配结果。

精准屏蔽文件搜索结果中的无关路径与临时文件

首先，进入 QoderWake 主界面右上角的「设置」，依次选择「文件系统」→「搜索排除规则」，点击「编辑自定义排除列表」按钮。在弹出的文本框中，按行写入需要排除的路径模式，支持使用 glob 通配符。示例如下：

node_modules/**
.git/**
__pycache__/**
.DS_Store
*.log
build/**

需要注意一个易被忽略的细节：在路径末尾添加 /** 表示递归排除整个子树；若不添加，则仅排除同名的文件或目录。此外，有一条硬性规则——所有条目必须顶格书写，行首不能出现空格或制表符，否则规则将失效。

填写完毕后，点击「保存并重建索引」。此操作会自动触发后台扫描清理，且不可中断。待右下角弹出“索引更新完成（12,483项已跳过）”的提示，即表示规则已生效。

按项目级别灵活启用/禁用排他规则

不同项目对“干扰项”的定义差异较大：前端项目需排除 dist/，Python 项目需排除 venv/，而嵌入式固件项目反而要保留 build/ 下的 .hex 文件。若将全局规则写死，灵活性将大打折扣——因此必须支持按工作区进行开关控制。

操作并不复杂：首先确保当前已打开目标项目的根目录（例如资源管理器中显示为 ~/my-web-app/ 而非 ~/）。然后按下快捷键 Ctrl+Alt+E（Windows/Linux）或 Cmd+Option+E（macOS），调出「当前项目排他规则面板」。

在面板中，可勾选预设的「Web开发标准」模板，该模板会自动注入 dist/**、.next/**、out/** 这三条规则。如需额外添加，点击「+ 添加规则」并输入 venv/**，再点击「仅对本项目启用」即可。

关闭面板后，配置会自动写入项目根目录下的 .qoderignore 文件。该文件可被 Git 跟踪，确保团队成员获得一致的搜索体验。

阻止 IDE 自动将系统临时目录纳入工作区索引

QoderWake 有时会擅自将系统临时路径（例如 Windows 下的 Users\John\AppData\Local\Temp 或 Linux/macOS 下的 /tmp）识别为“最近打开的文件夹”。一旦被纳入工作区，搜索结果中将出现大量随机生成的临时文件，且每次重启都会重复加载——这一问题必须妥善处理。

进入「设置」→「高级」→「工作区自动发现」，找到「扫描最近访问的临时目录」开关，直接将其关闭。

接着手动检查工作区列表：点击左侧「文件」图标旁的下拉箭头，选择「管理工作区」，在列表中找到包含 Temp、tmp、cache 等字样的路径条目，鼠标悬停后点击右侧的 × 图标将其移除。

关键步骤来了：移除后务必勾选页面底部的「永久禁止该路径自动重载」复选框。这是 QoderWake 2.8.3 版本起新增的防护机制，若忘记勾选，下次启动时该路径仍会被重新捕获——相当于白操作。

最后，执行命令行强制刷新：输入 qoder wake index --purge-temp-sources，终端返回 Done 即表示系统级临时路径已从索引缓存中彻底清除。