若Workbuddy出现功能异常、启动失败或界面卡顿，需彻底卸载后重装以清除残留配置与冲突文件；操作分Windows、macOS、Linux三系统卸载步骤，含程序移除、注册表/偏好设置清理、缓存删除及服务停用，并强调重装前验证环境依赖与使用官方最新版安装。
如果您在使用workbuddy过程中遇到功能异常、启动失败或界面卡顿等问题，可能需要彻底卸载后重新安装以清除残留配置与冲突文件。以下是针对不同操作系统执行卸载与重装的完整操作步骤：
一、Windows系统完全卸载Workbuddy
Windows平台下，Workbuddy可能通过安装程序、MSI包或便携版方式部署，残留注册表项与用户数据易导致重装后复现旧问题。需同步清理程序本体、注册表记录及本地缓存目录。
1、点击左下角“开始”按钮，在搜索栏输入控制面板并打开，选择“程序和功能”。
2、在程序列表中找到Workbuddy或类似名称条目（如含“Workbuddy Desktop”“Workbuddy Agent”），右键选择“卸载”并按向导完成移除。
3、按下Win + R键，输入regedit回车，定位至以下路径：
HKEY_CURRENT_USER\Software\Workbuddy
HKEY_LOCAL_MACHINE\SOFTWARE\Workbuddy
右键对应项选择“删除”，确认全部清除。
4、打开文件资源管理器，在地址栏依次输入并删除以下路径（若存在）：
%APPDATA%\Workbuddy
%LOCALAPPDATA%\Workbuddy
%PROGRAMFILES%\Workbuddy
二、macOS系统彻底清除Workbuddy
macOS中Workbuddy通常以.app形式安装，但其后台服务、偏好设置文件及日志可能分散于多个隐藏目录。仅拖拽应用至废纸篓无法清除全部组件，需手动定位并删除关键路径。
1、前往应用程序文件夹，将Workbuddy.app拖入废纸篓并清空。
2、打开访达，按下Shift + Command + G，输入以下路径逐一访问并删除其内容：
~/Library/Application Support/Workbuddy
~/Library/Preferences/com.workbuddy.*.plist
~/Library/Caches/com.workbuddy
3、打开终端，执行以下命令卸载可能存在的后台服务：
launchctl unload ~/Library/LaunchAgents/com.workbuddy.agent.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.workbuddy.agent.plist
三、Linux系统（Debian/Ubuntu系）卸载Workbuddy
Linux环境下Workbuddy可能以.deb包、AppImage或systemd服务形式运行。卸载需覆盖软件包管理记录、可执行文件、服务单元及用户配置，避免权限残留或端口占用。
1、若通过apt安装，执行：
sudo apt remove --purge workbuddy* && sudo apt autoremove
2、若为手动安装的AppImage，查找其存放路径（通常在~/Downloads或~/Applications），直接删除该文件；同时检查~/.local/bin/中是否存在workbuddy软链接并移除。
3、停止并禁用相关systemd用户服务：
systemctl --user stop workbuddy.service
systemctl --user disable workbuddy.service
rm -f ~/.config/systemd/user/workbuddy.service
4、删除用户级配置目录：
rm -rf ~/.config/Workbuddy
rm -rf ~/.cache/Workbuddy
四、重装前验证环境依赖
重装前需确认系统满足最低运行要求，避免因缺失底层组件导致安装失败或功能受限。尤其注意Electron版本兼容性、系统证书库更新状态及网络代理配置是否干扰下载流程。
1、Windows用户请确保已安装Microsoft Visual C++ 2015–2022 Redistributable，可从微软官网获取最新离线安装包。
2、macOS用户需检查系统版本是否≥macOS 12 Monterey，并在“系统设置→隐私与安全性”中允许来自“未知开发者”的应用运行。
3、Linux用户执行：
ldd --version确认glibc版本≥2.28；
curl -V确认支持HTTPS；
如使用企业网络，临时关闭HTTP代理或配置NO_PROXY=localhost,127.0.0.1环境变量。
五、标准重装流程（全平台通用）
重装应优先采用官方渠道发布的最新稳定版安装包，跳过第三方镜像或修改版，防止签名失效或证书链异常引发启动拦截。安装过程须以管理员/root权限运行安装程序以写入系统级资源。
1、访问Workbuddy官网下载页面，核对页面顶部显示的最新正式版版本号（如v3.8.2），避免下载Beta或RC测试版。
2、Windows用户双击下载的Workbuddy-Setup-x64.exe，勾选“为所有用户安装”并点击“安装”；macOS用户将.dmg中的Workbuddy.app拖入“应用程序”文件夹；Linux用户根据发行版选择.deb或.AppImage并赋予执行权限。
3、首次启动时，应用会提示初始化工作空间。此时不要跳过登录步骤，使用原账户凭据完成身份校验，确保同步配置与团队数据准确加载。
4、启动完成后，进入设置页检查“自动更新”选项是否启用，并手动点击立即检查更新，确认当前版本与官网发布版本一致。
