WorkBuddy启动失败可按五步排查：一查系统版本与硬件是否达标；二授管理员或全盘访问权限；三清配置缓存目录重置；四用--no-claw参数禁用Claw验证冲突；五校验并重装安装包修复运行时库。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试启动 WorkBuddy 桌面应用，但程序无响应、闪退或界面空白，则可能是由于系统兼容性、权限缺失、配置文件损坏或远程控制模块（Claw）冲突所致。以下是解决此问题的步骤：
一、检查系统兼容性与最低运行要求
WorkBuddy 对操作系统版本和硬件资源有明确要求，不满足条件将导致启动失败。Windows 用户需使用 Windows 10 22H2 或更高版本，macOS 用户需 macOS 12.6 及以上；最低配置为 2 核 CPU、4GB 内存、1GB 可用磁盘空间。
1、在 Windows 中按 Win + R 输入 winver 查看当前系统版本。
2、右键“此电脑” → “属性”，确认处理器型号与内存容量是否达标。
3、macOS 用户点击左上角苹果图标 → “关于本机”，核对系统版本与芯片架构（仅支持 Intel 与 Apple Silicon）。
二、以管理员/全盘访问权限重新启动
WorkBuddy 首次启动需获取文件系统访问授权，若权限被系统拦截或拒绝，将无法加载主界面。Windows 需管理员身份运行，macOS 需授予“完全磁盘访问”权限。
1、Windows 用户右键桌面 WorkBuddy 图标 → “以管理员身份运行”。
2、若仍失败，进入安装目录（默认为 C:\Program Files\WorkBuddy），右键 WorkBuddy.exe → “属性” → “兼容性” → 勾选“以管理员身份运行此程序”。
3、macOS 用户前往“系统设置” → “隐私与安全性” → “完全磁盘访问”，点击右下角锁形图标解锁后，拖入 WorkBuddy 应用并启用。
三、重置用户配置与缓存数据
损坏的配置文件（如 config.json、claw-state.db）会导致初始化失败，表现为启动后立即退出或卡在加载页。清除用户数据可强制重建初始状态，不影响已授权文件夹路径记录。
1、关闭所有 WorkBuddy 进程（可通过任务管理器或活动监视器确认）。
2、Windows 用户打开地址栏输入：%APPDATA%\CodeBuddy\WorkBuddy，删除整个文件夹。
3、macOS 用户打开访达，按 Cmd + Shift + G，输入：~/Library/Application Support/CodeBuddy/WorkBuddy，删除该目录。
4、重新启动 WorkBuddy，等待首次初始化完成（约 10–20 秒）。
四、禁用 Claw 远程控制模块临时启动
Claw 模块若因端口占用（如 18789 端口被其他服务占用）或配置异常，会阻塞主进程启动流程。临时绕过 Claw 初始化可验证是否为此类故障。
1、Windows 用户在开始菜单搜索“命令提示符”，右键选择“以管理员身份运行”。
2、执行命令：cd /d "%PROGRAMFILES%\WorkBuddy" & WorkBuddy.exe --no-claw。
3、macOS 用户打开终端，输入：open -n /Applications/WorkBuddy.app --args --no-claw。
4、若此时主界面正常打开，说明 Claw 模块存在配置冲突，需进一步检查防火墙或端口占用情况。
五、替换核心运行时库并验证签名完整性
部分杀毒软件或系统更新可能误删或隔离 WorkBuddy 的关键动态链接库（如 libnode.dylib 或 v8.dll），导致启动时 DLL 加载失败。通过校验安装包哈希值并手动恢复可修复。
1、访问官网 https://www.codebuddy.cn/work/ 下载最新版安装包，记录页面提供的 SHA256 值。
2、Windows 用户使用 PowerShell 执行：Get-FileHash .\WorkBuddy-Setup.exe -Algorithm SHA256，比对输出值。
3、macOS 用户在终端中执行：shasum -a 256 WorkBuddy-Setup.dmg，确认一致后重新安装。
4、安装完成后，勿勾选“开机自启”与“自动启动 Claw”，先验证基础功能是否可用。
