文件排他性配置指南：高效屏蔽搜索结果干扰项

在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版本控制，便于团队成员共享一致的搜索排除策略。

精准防控：彻底阻止系统临时目录进入索引

QoderWake有时会错误地将系统临时路径（例如Windows下的Users\John\AppData\Local\Temp或Linux/macOS下的/tmp）识别为“最近打开的文件夹”。一旦这些路径纳入工作区索引，搜索结果中将会大量混入随机生成的临时文件，且每次重启IDE都会重复加载。该问题需要从根源上解决。

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

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

关键操作：移除后务必勾选页面底部的「永久禁止该路径自动重载」复选框。这是QoderWake 2.8.3版本新增的防护功能，若遗漏此步，下次程序启动时该路径仍会被自动捕获——操作等于无效。

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