需启用底层文件监听机制并绑定绝对路径，否则无法感知文件变更；操作步骤包括进入设置→开发者选项→文件监听管理→添加路径并勾选递归监听与内容变更监控→编辑规则匹配文件类型→绑定定时任务或Shell命令→通过新建文件及状态看板验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让WorkBuddy自动监控指定文件夹，需启用底层文件监听机制并绑定具体路径，否则系统无法感知新建、修改或删除动作，所有热重载、自动整理、变更触发类功能都将失效。
启用桌面与项目目录级文件变更监听
1、打开WorkBuddy主界面，点击左下角齿轮图标进入【设置】。
2、在左侧导航栏选择【开发者选项】→【文件监听管理】。
3、点击【添加监听路径】，输入目标文件夹的【绝对路径】（如：C:\Users\Alice\Desktop\合同待审或/Users/bob/Projects/api-docs）。
4、必须勾选「启用子目录递归监听」与「监控文件内容变更(非仅时间戳)」——若只勾选前者，重命名或移动文件能捕获；若不勾选后者，文本文件内容改了但保存后不会触发响应。
5、点击【保存并激活监听】，系统托盘图标右键菜单中将显示“监听中:1路径”类似提示。
配置监听后的自动响应动作
方法一：绑定定时任务触发逻辑
在【文件监听管理】页面，点击已添加路径右侧的【编辑规则】按钮→在「匹配模式」栏输入.*\.(docx|pdf|xlsx)$→在「触发动作」区域选择「执行定时任务」→从下拉菜单中选取已存在的任务名（如“每日合同归档”），该任务将在任意匹配文件被创建或修改后立即启动，无需等待预设时间点。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
方法二：调用Shell命令实时处理
同一规则编辑页中，选择「执行Shell命令」→填入：python D:\scripts\auto_tag.py --path "$CHANGED_FILE"→勾选「仅当进程处于运行状态时触发」→点击【测试规则】，手动保存一个PDF到监听目录，确认命令窗口弹出且脚本成功读取文件路径变量。
验证监听是否生效
第一步：在监听目录内新建一个空白txt文件，命名为test_trigger.txt。
第二步：观察WorkBuddy主界面右下角状态栏——若出现闪烁的绿色脉冲图标并伴随“捕获变更：test_trigger.txt（新建）”提示，则监听模块已就绪。
第三步：打开【状态看板】→查看「最近监听事件」列表，确认该文件出现在30秒内的时间戳条目下。
第四步：若无任何反应，检查Windows防火墙是否拦截了WorkBuddy的文件系统事件权限，或macOS是否授予了“完全磁盘访问”——【未授予权限将导致监听静默失败，且无错误提示】。
