WorkBuddy安装失败可按五种方法解决：一、标准安装；二、绕过安全拦截；三、静默安装与路径自定义；四、免安装即用模式；五、模型与配置文件预置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您下载了 WorkBuddy 最新版安装包，但无法顺利完成安装或启动失败，则可能是由于系统权限、安装路径异常或安全策略拦截所致。以下是解决此问题的步骤：
一、标准安装流程（Windows/macOS通用）
该方法适用于绝大多数用户，采用官网提供的原生安装包，无需额外配置即可完成部署。安装过程完全离线执行，所有操作均在本地完成，不依赖第三方运行时环境。
1、访问 WorkBuddy 官方网站：https://www.codebuddy.cn/work/。
2、根据操作系统选择对应版本：Windows 用户点击「Windows 版」，macOS 用户点击「macOS 版」。
3、下载完成后，按系统类型执行安装：
• Windows：双击 WorkBuddySetup.exe，全程点击“下一步”，接受许可协议，保持默认安装路径。
• macOS：双击 WorkBuddy.dmg，将图标拖入「应用程序」文件夹。
4、首次启动时，如 macOS 提示“无法验证开发者”，需前往「系统设置 → 隐私与安全性 → 仍要打开」手动放行。
二、绕过安全拦截的强制安装法
当系统因安全策略阻止安装时，该方法通过临时调整权限策略实现安装包可信加载，不修改系统核心配置，操作可逆。
1、Windows 用户：右键点击 WorkBuddySetup.exe，选择“以管理员身份运行”。
2、macOS 用户：在终端中执行以下命令解除隔离属性：
xattr -d com.apple.quarantine /path/to/WorkBuddy.dmg（将 /path/to 替换为实际下载路径）。
3、重新双击安装包或拖拽应用至「应用程序」文件夹。
三、静默安装与路径自定义法
适用于企业批量部署或需指定非默认路径的场景，安装过程无图形界面干扰，全部参数由命令行预置，避免交互中断。
1、Windows 用户在命令提示符（管理员模式）中执行：
WorkBuddySetup.exe /S /D=C:\Program Files\WorkBuddy。
2、macOS 用户使用 Homebrew 安装（需已安装 brew）：
brew install --cask workbuddy（需先添加腾讯官方 tap）。
3、安装完成后，手动创建桌面快捷方式并赋予执行权限。
四、免安装即用模式（便携运行）
该方式跳过传统安装流程，直接解压运行主程序，适合临时使用、U盘携带或受限环境，所有数据保留在指定目录内，不写入注册表或系统库。
1、从官网下载标注为「Portable」的压缩包（如 workbuddy-portable-v1.100.0.zip）。
2、解压至任意本地路径，例如 D:\Tools\WorkBuddy。
3、进入解压目录，双击 WorkBuddy.exe（Windows）或 WorkBuddy.app（macOS）启动。
4、首次运行仍需腾讯账号登录及文件夹授权，授权范围仅限该便携目录下可见路径。
五、模型与配置文件预置法
针对已安装但模型加载失败、界面空白或远程功能不可用的情况，该方法通过预置关键配置文件确保新版兼容性，避免重装。
1、关闭正在运行的 WorkBuddy 进程（任务管理器或活动监视器中彻底结束）。
2、前往配置目录：
• Windows：%APPDATA%\WorkBuddy\config.json；
• macOS：~/Library/Application Support/WorkBuddy/config.json。
3、用文本编辑器打开 config.json，确认 "version" 字段值与当前安装包版本号一致（如 v1.100.0）。
4、若不一致，手动修改并保存；同时检查 "model_source" 是否为合法国内大模型标识（如 "hunyuan" 或 "kimi"）。
