QClaw可通过四种方式设置排除路径：一、项目级配置.qclawignore文件；二、全局settings.yaml中excluded_paths字段；三、命令行--exclude参数临时排除；四、技能配置界面图形化添加。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QClaw执行文件整理或自动化任务时，发现某些项目目录、临时文件或快捷方式被错误归类或移动，则可能是由于QClaw未配置项目级忽略规则所致。以下是为特定项目设置排除路径的具体操作方法：
一、通过项目专属配置文件定义忽略规则
QClaw支持为每个项目单独配置忽略列表，该方式适用于多项目并存且需差异化管理的场景，配置生效后将严格阻止QClaw扫描、读取或移动指定路径下的任何内容。
1、在目标项目的根目录下新建名为.qclawignore的纯文本文件。
2、用记事本或VS Code打开该文件，在其中逐行填写需排除的相对路径，每行一条，支持通配符*和**。
3、例如，输入以下内容可排除构建产物与临时文件：
node_modules/
dist/
build/
*.tmp
**/*.log
4、保存文件后，QClaw在对该目录及其子目录执行任何操作前，会自动识别并跳过所有匹配项。
二、在全局配置中添加项目路径白名单式排除
该方式适用于需统一管控多个项目目录的用户，通过修改QClaw主配置文件，将特定路径标记为“永久不可触达区域”，避免被任何技能或指令意外影响。
1、定位到QClaw用户配置目录：Windows系统为%APPDATA%\QClaw\config\，macOS系统为~/Library/Application Support/QClaw/config/。
2、打开settings.yaml文件，在根层级下新增excluded_paths:字段（注意缩进对齐）。
3、在该字段下以YAML列表格式添加绝对路径，每项前加短横线与空格，例如：
- C:\Projects\LegacyApp\temp
- /Users/me/Dev/alpha-test/.git
- /opt/qclaw/workspace/sandbox
4、保存文件并重启QClaw主进程，新规则立即生效。
三、使用命令行参数临时禁用指定路径
当需要在单次任务中快速跳过某目录（如调试阶段避免误操作），可通过启动参数强制排除，该方式不写入配置，仅本次运行有效，适合临时性、一次性操作。
1、关闭正在运行的QClaw客户端。
2、打开终端（macOS/Linux）或命令提示符（Windows）。
3、输入启动命令并附加--exclude参数，后接完整路径，支持多次使用，例如：qclaw --exclude "/home/user/Downloads/temp" --exclude "/var/log/app"
4、回车执行后，QClaw将以排除模式加载，所有匹配路径均不会出现在文件扫描结果中。
四、通过技能配置界面图形化设置排除项
部分QClaw内置技能（如“文件整理”“GitHub同步”）提供可视化排除设置入口，无需编辑文本文件，适合不熟悉路径语法的用户直接勾选或拖入目标目录。
1、在QClaw主界面点击左侧导航栏中的“技能中心”。
2、找到已启用的对应技能（如“智能归档”），点击右侧“配置”按钮。
3、在弹出面板中找到“排除路径”区域，点击“+ 添加路径”按钮。
4、在文件选择器中定位并选中需排除的文件夹或文件，确认后该路径即加入当前技能的独有排除列表。
5、勾选“启用此排除规则”开关，点击“保存配置”完成设置。
