workbuddy 启动异常通常因系统权限未授予所致：windows需uac、辅助功能及文件夹访问授权；macos需完全磁盘访问、辅助功能和屏幕录制三项白名单；linux需sudo与dialout组权限及/tmp可写验证；通用修复入口支持登录后一键重授。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您启动 WorkBuddy 后发现文件无法读取、自动化操作无响应或界面卡在“正在加载技能市场”，则可能是由于首次运行时未正确授予必要的系统权限。以下是针对不同操作系统的具体授权步骤：
一、Windows 系统权限开启
WorkBuddy 在 Windows 上需获得用户账户控制（UAC）许可与文件系统访问授权，否则无法执行本地文件整理、软件启停等核心操作。
1、首次双击启动 WorkBuddy 时，系统弹出“用户账户控制”窗口，提示“是否允许此应用对你的设备进行更改”，必须点击“是”。
2、随后出现“辅助功能”授权弹窗，标题为“是否允许此应用控制你的设备”，必须点击“允许”，否则 Claw 远程控制模块将被禁用。
3、进入登录后引导页，勾选“桌面”“文档”“下载”“图片”等常用路径，点击“允许”完成文件夹级访问授权。
二、macOS 系统权限开启
macOS 12+ 对沙盒应用实施严格磁盘隔离策略，WorkBuddy 必须显式列入三项隐私权限白名单，缺一不可，否则将报“Operation not permitted”或“无法访问 ~/Documents”。
1、打开「系统设置 → 隐私与安全性」，点击左下角锁形图标解锁。
2、在「完全磁盘访问」列表中，点击“+”号，将 /Applications/WorkBuddy.app 拖入列表并确保左侧复选框已勾选。
3、在同一页面中，分别进入「辅助功能」和「屏幕录制」权限列表，手动添加 WorkBuddy.app 并启用勾选。
4、若系统提示“已阻止打开”，需前往「通用 → 安全性与隐私」，点击“仍要打开”以解除 Gatekeeper 限制。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、Linux 系统权限配置
Linux 版本仅支持 Ubuntu 20.04+/22.04+ 与 CentOS 8+，需通过命令行赋予当前用户系统级操作能力，尤其涉及串口通信与临时目录写入。
1、确保当前用户属于 sudo 组：执行 sudo usermod -aG sudo $USER，然后注销重登。
2、如需使用串口类 Skill（例如连接硬件设备），执行：sudo usermod -aG dialout $USER。
3、验证 /tmp 目录可写：运行 touch /tmp/workbuddy_test && rm /tmp/workbuddy_test，无报错即通过。
4、首次启动前，确认终端未启用强制沙盒或 seccomp 限制，禁用 systemd-run --scope 或 firejail 封装启动。
四、通用权限修复入口
若跳过初始授权流程或权限被系统重置，WorkBuddy 提供内置修复通道，可绕过系统设置界面直接触发权限再申请。
1、启动 WorkBuddy 并完成账号登录。
2、点击右上角头像，进入菜单后选择「系统权限修复」。
3、界面自动检测缺失项，并逐项弹出对应系统授权窗口，每项均需手动点击“允许”或“打开设置”完成配置。
4、全部完成后，重启 WorkBuddy 使新权限生效。
