WorkBuddy 4.22.4 更新后闪退/白屏/黑屏问题解决记录

完整记录从闪退到黑屏的排查过程，以及最终解决方案

📋 系统环境

操作系统: Windows 10 (AMD64)
WorkBuddy 版本: 4.22.4
Electron 版本: 41.1.1
Node 版本: 24.14.0
Chrome 版本: 146.0.7680.166
架构: x64
更新日期: 2026-05-06

🐛 问题描述

现象 1：点击图标后闪退

点击桌面图标无法打开
底部任务栏短暂出现 Logo
鼠标移至 Logo 上，Logo 立即消失
进程管理器中能看到 WorkBuddy 进程，但瞬间消失

现象 2：进程存在但无窗口

进程管理器中 WorkBuddy 进程持续存在
但没有任何窗口弹出
任务栏无图标显示

现象 3：白屏

添加 --disable-gpu-sandbox 后能打开窗口
但界面完全白屏，无法显示任何内容

现象 4：黑屏

清理缓存后能打开窗口
但界面完全黑屏
🔍 错误日志分析
通过命令行启动查看详细日志，发现关键错误：

[ERROR:content\browser\gpu\gpu_process_host.cc:990] GPU process launch failed: error_code=18
[WARNING:content\browser\gpu\gpu_process_host.cc:1438] The GPU process has crashed 1 time(s)
...
[FATAL:content\browser\gpu\gpu_data_manager_impl_private.cc:417] GPU process isn't usable. Goodbye.
错误代码 18 = GPU_PROCESS_START_FAILURE，表示 GPU 进程启动失败。

同时发现扩展加载错误：

[Error] [SkillExtensionLoader] [TypeError [ERR_INVALID_ARG_TYPE]: 
The "path" argument must be of type string. Received an instance of Object]
Failed to load skills from extension: agent-browser@codebuddy-plugins-official

🛠️ 解决方案

步骤 1：结束所有 WorkBuddy 进程

taskkill /F /IM WorkBuddy.exe

步骤 2：清理 GPU 缓存和窗口状态

删除以下文件/目录：

GPU 缓存

rd /S /Q “%USERPROFILE%.workbuddy\app\session\GPUCache”

浏览器缓存

rd /S /Q “%USERPROFILE%.workbuddy\app\session\Cache”
rd /S /Q “%USERPROFILE%.workbuddy\app\session\Code Cache”

窗口状态（关键）

del /F /Q “%USERPROFILE%.workbuddy\app\window-state.json”

本地存储

del /F /Q “%USERPROFILE%.workbuddy\local_storage*.info”

步骤 3：禁用扩展（可选，解决扩展加载错误）

编辑 %USERPROFILE%.workbuddy\settings.json，清空 enabledPlugins：

{
“enabledPlugins”: {},
“claw”: { … }
}

步骤 4：修改快捷方式（核心解决方案）

右键桌面 WorkBuddy 快捷方式 → 属性 → 目标

在原有路径后添加启动参数：

“C:\Users\Administrator\AppData\Local\Programs\WorkBuddy\WorkBuddy.exe” --disable-gpu-sandbox --disable-gpu --no-sandbox
参数说明：

--disable-gpu-sandbox：禁用 GPU 沙盒（解决 error_code=18）
--disable-gpu：完全禁用 GPU 加速
--no-sandbox：禁用 Chromium 沙盒（解决黑屏问题）

步骤 5：启动 WorkBuddy

双击修改后的快捷方式，应该能正常显示界面。

⚠️ 注意事项

禁用沙盒的安全性：–no-sandbox 会降低安全性，建议仅在本地使用，不要用于处理敏感数据。

官方修复：这是 WorkBuddy 4.22.4（Electron 41.1.1）的已知兼容性问题，建议关注官方更新，修复后移除这些参数。

备份数据：在清理前建议备份：

%USERPROFILE%.workbuddy\workbuddy.db（聊天记录）
%USERPROFILE%.workbuddy\memery（记忆数据）

📝 总结

根本原因：Electron 41.1.1 升级后，Chromium 对 GPU 沙盒的要求更严格，与部分 Windows 系统环境存在兼容性问题。

最终解决：通过添加 --disable-gpu-sandbox --disable-gpu --no-sandbox 启动参数，绕过 GPU 和沙盒机制，成功恢复使用。
我严重怀疑只添加–disable-gpu-sandbox --disable-gpu --no-sandbox 也能解决问题