QClaw 提供了四种灵活的路径排除方案，分别适用于项目级配置、全局设置、命令行临时排除以及技能界面图形化操作，以下逐一详解。每种方式都能帮助您更精准地控制文件整理与自动化任务的范围。
实际使用 QClaw 进行文件整理或自动化处理时，若出现项目目录、临时文件或快捷方式被错误归类或移动的情况，通常是因为尚未为对应项目配置忽略规则。下面详细介绍如何针对特定项目设置排除路径，避免此类问题。
一、通过项目专属配置文件定制忽略规则（.qclawignore）
QClaw 支持为每个项目独立维护一份忽略列表，特别适合多项目并存且需要差异化管理的场景。一旦配置完成，QClaw 将严格跳过指定路径下的所有内容，不会扫描、读取或移动它们，确保核心文件的安全。
操作步骤简单明了：
1. 在目标项目的根目录下新建一个纯文本文件，命名为.qclawignore。
2. 用记事本或 VS Code 打开此文件，逐行填写需要排除的相对路径，每行一条。支持通配符*（匹配任意单层目录/文件）和**（匹配任意多层目录），灵活应对不同结构。
3. 举个例子，排除构建产物和临时文件可以这样写：
node_modules/
dist/
build/
*.tmp
**/*.log
4. 保存文件后，QClaw 在对该目录及其子目录执行任何操作前，会自动识别并跳过所有匹配项，无需额外干预。
二、在全局配置中添加项目路径白名单式排除
若需要对多个项目目录进行统一管控，可以修改 QClaw 的主配置文件，将特定路径标记为“永久不可触达区域”。这样任何技能或指令都不会意外影响到这些路径，实现全局级别的安全过滤。
具体路径如下：
- Windows 系统：
%APPDATA%QClawconfig - macOS 系统：
~/Library/Application Support/QClaw/config/
打开settings.yaml文件，在根层级下新增excluded_paths:字段（注意缩进对齐）。然后以 YAML 列表格式添加绝对路径，每项前加短横线和空格。例如：
- C:ProjectsLegacyApptemp
- /Users/me/Dev/alpha-test/.git
- /opt/qclaw/workspace/sandbox
保存文件后重启 QClaw 主进程，新规则立即生效，后续所有操作均会避开这些目录。
三、使用命令行参数临时禁用指定路径
此方式适用于单次任务中快速跳过某个目录，例如调试阶段避免误操作。它不会写入任何配置文件，仅本次运行有效，用完即自动失效，非常灵活。
操作步骤：
1. 关闭正在运行的 QClaw 客户端。
2. 打开终端（macOS/Linux）或命令提示符（Windows）。
3. 输入启动命令并附加--exclude参数，后接完整路径。支持多次使用，例如：
qclaw --exclude "/home/user/Downloads/temp" --exclude "/var/log/app"
4. 回车执行后，QClaw 以排除模式加载，所有匹配路径都不会出现在文件扫描结果中，从而避免临时干扰。
四、通过技能配置界面图形化设置排除项
部分内置技能（如“文件整理”“GitHub同步”）提供了可视化的排除设置入口，无需编辑文本文件。特别适合不熟悉路径语法的用户，直接在界面中勾选或拖入目录即可完成配置。
操作步骤：
1. 在 QClaw 主界面点击左侧导航栏的“技能中心”。
2. 找到已启用的对应技能（例如“智能归档”），点击右侧“配置”按钮。
3. 在弹出面板中找到“排除路径”区域，点击“+ 添加路径”按钮。
4. 在文件选择器中定位并选中需要排除的文件夹或文件，确认后该路径即加入当前技能的独有排除列表。
5. 勾选“启用此排除规则”开关，点击“保存配置”完成设置。
以上四种方式覆盖了从项目级到全局、从临时到图形化的所有需求。根据实际使用场景选择最顺手的一种即可，轻松实现 QClaw 路径排除管理。