workbuddy启动后无响应、黑屏或退出，主因是jvm内存不足、系统权限缺失、驱动不兼容或第三方程序干扰；需依次调整jvm参数、修复系统权限、更新显卡驱动与bios、禁用冲突安全软件、清理缓存并重置环境变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您启动WorkBuddy AI后频繁出现无响应、黑屏或直接退出的现象，则可能是由于JVM内存不足、系统权限缺失、驱动不兼容或第三方程序干扰所致。以下是解决此问题的步骤：
一、调整JVM内存分配参数
WorkBuddy基于Java开发，其运行依赖JVM；默认堆内存设置过低时，在加载大模型或执行多任务时极易触发OOM（内存溢出）导致强制终止。修改vmoptions文件可提升内存上限，缓解崩溃压力。
1、定位WorkBuddy安装目录下的workbuddy64.vmoptions文件（Windows路径通常为C:\Program Files\WorkBuddy\bin\；macOS路径为/Applications/WorkBuddy.app/Contents/bin/）。
2、用记事本或VS Code以管理员权限打开该文件。
3、查找包含-Xmx和-Xms的行，将其替换为：-Xms4g -Xmx12g
4、保存文件，关闭所有WorkBuddy进程，重新启动应用。
二、修复系统级文件与权限配置
损坏的系统组件或未授予的磁盘访问权限会中断WorkBuddy对本地文件、日志、缓存目录的读写操作，引发静默崩溃。需同步校验系统完整性并启用必要权限。
1、Windows用户在管理员权限命令提示符中执行：sfc /scannow
2、等待扫描完成并自动修复后，再执行：dism /online /cleanup-image /restorehealth
3、前往「设置」→「隐私和安全性」→「文件系统」，确保WorkBuddy条目已开启“允许应用访问文件系统”开关。
4、macOS用户进入「系统设置」→「隐私与安全性」→「完全磁盘访问」，点击左下锁图标解锁，拖入WorkBuddy应用图标并勾选。
三、更新显卡驱动与BIOS固件
WorkBuddy在启用GPU加速推理（如调用CUDA或Metal后端）时，若驱动版本陈旧或BIOS存在芯片组兼容性缺陷，将导致图形上下文初始化失败，触发进程异常退出。
1、NVIDIA用户访问www.nvidia.com/Download/index.aspx，下载并安装Studio驱动最新稳定版（非Game Ready分支）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、AMD用户前往www.amd.com/support，选择对应显卡型号，下载Adrenalin Edition 24.5.1或更高版本。
3、Intel Arc用户须确认已安装Intel Graphics Driver 31.0.101.5890或更新版本。
4、Dell、Lenovo等品牌笔记本用户登录官网支持页面，输入服务编号，检查是否存在针对WorkBuddy兼容性优化的BIOS更新（例如Dell G15系列2025年11月起发布的1.12.0以上版本）。
四、禁用冲突性安全软件与插件
部分杀毒引擎（如火绒、360、Malwarebytes）或企业级EDR工具会将WorkBuddy的沙箱进程、动态代码加载行为误判为可疑活动，主动终止其线程。此外，浏览器扩展或注入式脚本管理器也可能干扰Webview内核。
1、临时退出所有第三方安全软件主程序，包括实时防护模块与网络防火墙。
2、在WorkBuddy设置中进入「高级」→「开发者模式」，关闭「启用远程调试端口」与「自动加载浏览器扩展」选项。
3、若通过企业微信/飞书机器人启动WorkBuddy，检查该平台后台是否启用了“代码沙箱隔离”策略，如有请暂时关闭。
4、重启WorkBuddy，观察是否仍闪退；若恢复正常，逐个重新启用安全软件并添加WorkBuddy至白名单。
五、清理缓存并重置环境变量
长期运行积累的损坏缓存、残留临时模型权重、错误PATH路径引用，会导致WorkBuddy启动时加载失败或解析异常。彻底清除并重建运行环境可消除隐性故障点。
1、完全退出WorkBuddy，包括系统托盘进程（右键任务栏图标选择「退出」）。
2、删除以下目录：
Windows：%APPDATA%\WorkBuddy\Cache 与 %LOCALAPPDATA%\WorkBuddy\Temp
macOS：~/Library/Caches/com.workbuddy.app 与 ~/Library/Application Support/WorkBuddy/Models
3、打开终端或命令提示符，执行：set PATH=%PATH:;C:\bad\path=%（Windows）或export PATH=$(echo $PATH | sed 's|:/wrong/path||g')（macOS/Linux），移除可疑路径段。
4、重新启动WorkBuddy，首次启动时将自动重建缓存与配置目录。
