文件夹授权失败时需先确保首次授权弹窗成功触发：macOS检查“完整磁盘访问”是否勾选并重启应用，Windows须以管理员身份运行；再确认路径为本地真实可写目录，排除同步盘、SIP保护区及符号链接；接着删除token目录下access_token.json与scope_cache.json；最后在Claw Settings → Integration Status中点击对应工具的Refresh Permissions完成同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy文件夹授权失败时，AI无法读取你指定的文档、表格或PPT，常见表现为点击“添加文件夹”后无响应、路径选中但未出现在已授权列表、或授权后仍提示“无访问权限”。这通常不是软件崩溃，而是系统拦截、路径不可达或Token缓存未刷新导致的权限链断裂。
确认首次启动弹窗是否被系统拦截
WorkBuddy强制在首次登录后弹出授权窗口，但macOS和Windows都可能静默阻止该弹窗显示。
macOS用户：打开「系统设置 → 隐私与安全性 → 完整磁盘访问」，检查WorkBuddy.app是否已勾选；若未出现，说明应用尚未触发权限请求→此时需完全退出WorkBuddy（右键菜单栏图标→退出），再双击重开，等待弹窗自动浮现。
Windows用户：右键WorkBuddy快捷方式→选择“以管理员身份运行”，再登录。普通权限下首次弹窗常被UAC或杀毒软件吞掉，提权后才能唤起系统级文件夹选择器。
这一步不完成，后续所有授权操作都无效——【授权弹窗是唯一合法入口，设置面板里的“添加文件夹”按钮仅用于追加，不能替代首次授权】。
检查路径是否被系统保护或指向无效位置
WorkBuddy只接受真实、可写、非符号链接、非网络挂载的本地路径。以下路径一律拒绝授权：
• 桌面快捷方式（.alias 或 .lnk）
• OneDrive/Google Drive/腾讯微云同步文件夹根目录（如C:\Users\Name\OneDrive\）
• /usr/local/bin、/Library/Preferences 等SIP保护区（macOS）
• 映射网络驱动器（Z:\、Y:\等）
正确做法：把目标文件夹复制到本地非同步路径，例如D:\Projects\或~/Documents\WorkBuddy-Data，再通过弹窗选取该物理路径。
若选中后弹窗直接关闭且无报错，大概率是路径含中文全角字符、空格过多或存在隐藏控制符——改用英文命名并删减空格后重试。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
清除Token缓存强制重拉权限
授权操作实际由Claw服务下发，但客户端本地Token文件若残留旧scope，会导致新授权不生效。
第一步：完全退出WorkBuddy（托盘图标右键→退出，任务管理器/活动监视器确认无残留进程）
第二步：删除Token文件
• Windows：打开%APPDATA%\Tencent\WorkBuddy\token\，删掉access_token.json和scope_cache.json
• macOS：前往~/Library/Application Support/WorkBuddy/token/，执行相同删除
第三步：重启WorkBuddy，扫码登录后立即触发Token重协商，此时首次弹窗会再次出现，必须重新完成授权流程。
手动修复Claw权限同步状态
步骤一：登录WorkBuddy主界面→点击右上角头像→进入Claw Settings
步骤二：左侧导航栏选择Integration Status页签
步骤三：找到你正在使用的通讯工具（如企业微信、微信、钉钉）→点击右侧“Refresh Permissions”按钮
步骤四：等待状态变为“Synced”，再尝试导入文件
注意：该操作不会重置你的历史记录或模型偏好，仅刷新当前设备的权限映射表。
