需完成本地配置与权限启用才能实现workbuddy自动整理桌面文件：一、安装并启用桌面监控模块；二、配置rules.yaml分类规则；三、设定实时响应与定时整理双模式；四、授权桌面及目标文件夹访问权限；五、设置异常隔离区与调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望借助 WorkBuddy 自动识别并归类桌面上散乱的文档、图片、压缩包等文件，则需完成对应脚本的本地配置与权限启用。以下是实现自动整理功能的具体设置步骤：
一、安装 WorkBuddy 并启用桌面监控模块
WorkBuddy 默认不激活桌面文件监听功能，需手动开启该模块以触发实时扫描逻辑。此模块依赖系统级文件变更事件通知机制，启用后可捕获新建、移动或重命名操作。
1、从官方 GitHub 仓库下载最新版 WorkBuddy CLI 工具包，解压至本地非中文路径目录（如 C: oolsworkbuddy）。
2、以管理员身份运行 PowerShell，执行命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，允许本地脚本执行。
3、进入解压目录，运行：.wb-cli.exe module enable desktop-watcher。
二、配置文件分类规则 YAML 文件
WorkBuddy 依据用户定义的规则文件（rules.yaml）判断文件归属类别，每条规则包含匹配条件与目标文件夹路径。规则按顺序逐条匹配，首条命中即终止判断。
1、在 WorkBuddy 安装目录下新建文件：rules.yaml。
2、写入以下内容（可按需修改扩展名和目标路径）：
- name: "PDF文档"
extensions: [".pdf", ".epub"]
target: "D:\Desktop\Documents"
- name: "截图图片"
extensions: [".png", ".jpg", ".jpeg"]
filename_contains: ["screenshot", "截屏", "Screen Shot"]
target: "D:DesktopScreenshots"
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、设定定时整理与即时响应双模式
WorkBuddy 支持两种触发方式：基于 inotify/fsevents 的即时响应（推荐用于 macOS/Linux），以及 Windows 下的计划任务轮询（兼容性更强）。两者可同时启用，互不冲突。
1、启用即时响应模式：执行命令 .wb-cli.exe watcher start --mode=realtime。
2、配置每日凌晨2点强制整理残留文件：在 Windows 任务计划程序中创建基本任务，触发器设为“每天”，操作设为启动程序，路径指向 .wb-cli.exe，参数填写 desktop clean --force。
3、验证双模式是否生效：在桌面新建一个名为 test.pdf 的文件，观察是否自动移入 Documents 文件夹；再于非整点时刻手动运行 .wb-cli.exe desktop clean，确认残留文件被处理。
四、授权 WorkBuddy 访问桌面及目标文件夹
Windows 系统默认限制后台进程对用户桌面的写入权限，未授权时脚本仅能读取文件列表，无法执行移动或重命名操作。
1、右键点击 WorkBuddy 安装目录 → “属性” → “安全”选项卡 → “编辑” → 选中当前用户 → 勾选“完全控制” → 应用。
2、对每个 rules.yaml 中定义的 target 路径（如 D:DesktopDocuments）重复步骤1。
3、在 PowerShell 中运行：icacls "D:Desktop" /grant "%USERNAME%:(OI)(CI)F" /T，赋予继承式完全控制权限。
五、调试日志与异常文件隔离区设置
当文件匹配失败或移动被系统拒绝时，WorkBuddy 将跳过该文件并记录原因。启用隔离区可防止误分类文件丢失，并便于人工复核。
1、在 rules.yaml 同级目录创建空文件夹：D:Desktop_unsorted_fallback。
2、编辑 rules.yaml，在文件末尾添加兜底规则：
- name: "未匹配项"
extensions: ["*"]
target: "D:\Desktop\_unsorted_fallback"
3、启用详细日志：运行 .wb-cli.exe log set --level debug --output "logswatcher.log"，日志中将包含每一步匹配决策与系统调用返回码。
