腾讯WorkBuddy部署常见问题及解决方法：一、macOS需手动授权“仍要打开”绕过开发者验证；二、Windows旧系统需安装最新VC++运行库并以管理员身份运行；三、企业微信绑定失败需开启API权限并放行防火墙；四、登录卡顿可切换模型源或刷新重试；五、文件操作失败需授权桌面/文档/下载文件夹及系统级文件访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已下载腾讯WorkBuddy安装包，但在启动、登录或执行任务时遇到异常行为，则可能是由于系统权限、网络策略或客户端配置未按规范完成。以下是规避常见部署坑点的具体操作指南：
一、绕过“无法验证开发者”系统拦截（macOS专属）
macOS默认阻止非App Store来源的应用运行，WorkBuddy首次启动时若弹出红色警告框，说明系统安全策略已拦截其加载，需手动授权放行。
1、双击WorkBuddy.dmg安装包，将应用拖入「应用程序」文件夹。
2、在「启动台」或「应用程序」中右键点击WorkBuddy图标，选择「显示简介」。
3、勾选窗口底部的“仍要打开”复选框。
4、关闭简介窗口，再次双击图标启动，系统将不再阻断。
二、解决Windows平台首次启动闪退问题
部分Windows 10旧版本（如1909及更早）缺少必要运行时组件，导致WorkBuddy主进程无法初始化图形界面，表现为双击后无响应或立即退出。
1、访问微软官方页面下载并安装Visual C++ 2015–2022 运行库 x64版本（必须为最新版，非系统自带旧版）。
2、重启电脑，确保所有后台杀毒软件（如火绒、360、Windows Defender实时防护）临时关闭。
3、以管理员身份右键运行WorkBuddySetup.exe，完成重装。
4、安装完成后，**不要直接双击桌面快捷方式**，改用「开始菜单 → WorkBuddy → 右键 → 以管理员身份运行」启动主程序。
三、修复企业微信远程绑定失败（超时/提示“未授权”）
WorkBuddy通过Claw协议与企业微信建立长连接，若手机端收不到机器人确认消息，通常因办公平台未正确开启API权限或本地防火墙阻断了WebSocket通信端口。
1、在WorkBuddy主界面右上角点击「个人中心」→「Claw设置」→「企业微信」，确认已开启「允许远程控制」开关。
2、使用企业微信管理员账号登录管理后台，进入「应用管理」→「自建应用」→ 找到WorkBuddy对应应用 →「功能设置」→ 开启“接收消息”和“发送消息”权限。
3、在电脑端打开「控制面板 → Windows Defender 防火墙 → 允许应用或功能通过Windows Defender防火墙」，勾选WorkBuddy.exe的专用网络和公用网络两项。
四、应对首次登录卡在“正在加载模型”界面
该现象多见于国内用户首次激活时模型服务节点调度延迟，非本地网络故障，WorkBuddy会持续尝试连接云端推理服务，但界面无进度反馈。
1、保持客户端开启状态，**勿关闭或重启程序**，等待时长上限为180秒。
2、在登录界面左下角点击“切换模型源”按钮，手动从默认Hunyuan切换至DeepSeek或Kimi任一备用模型。
3、若3分钟内仍未跳转，点击登录框右上角刷新图标（两个箭头组成的循环符号），触发重试逻辑。
五、避免本地文件操作权限拒绝（Excel/PPT生成失败）
WorkBuddy需获得明确的文件系统读写权限才能处理Office文档，若任务中途报错“拒绝访问”或“路径不可达”，说明系统级授权未生效。
1、首次启动后出现权限请求弹窗时，**必须勾选全部三项**：「桌面」「文档」「下载」文件夹。
2、若已跳过该弹窗，进入WorkBuddy主界面 → 左侧「设置」图标 → 「隐私与安全」→「文件访问权限」→ 点击“重新请求系统授权”按钮。
3、Windows用户需额外检查「设置 → 隐私 → 文件系统」中，是否已为WorkBuddy开启“此设备上的所有文件”开关。
