Mac版WorkBuddy在卸载后频繁出现重装失败、界面显示异常或启动卡在初始化等问题，其根本原因在于系统卸载不够彻底，残留的配置文件和数据导致了冲突。使用系统默认的“拖进废纸篓”方式删除应用，实际上仅移除了/Applications/WorkBuddy.app这个主程序外壳。然而，涉及账号状态、模型缓存、技能包以及数据库等核心数据的关键文件夹仍保留在原先路径中。当新版本程序安装时，检测到这些旧配置文件便会尝试直接复用，轻则引发UI错乱，重则导致SQLite数据库锁表，造成服务完全无法启动。因此，要彻底解决问题，必须将残留的根目录和文件逐一清理干净。

第一步：强制退出并彻底移除主程序

在进行清理操作之前，请先确保WorkBuddy进程已完全终止。右键点击菜单栏右下角的WorkBuddy图标，选择“退出”，确认程序已彻底关闭。若跳过这一步，后续清理时系统会提示“文件正在使用”，导致部分缓存和偏好设置无法删除。接着，打开访达，在左侧边栏找到“应用程序”，将WorkBuddy.app拖入废纸篓，随后右键点击废纸篓，选择“清倒废纸篓”以完成初步删除。

第二步：手动清理三大核心残留路径

按下 Shift + Command + G 组合键，打开“前往文件夹”窗口，依次输入下方列出的路径，进入后务必彻底删除整个文件夹或文件。请注意，是删除整个条目，而非清空内部内容。以下三个路径缺一不可：

~/Library/Application Support/WorkBuddy/ — 删除该文件夹。其中储存了本地数据库workbuddy.db、用户技能包和任务快照。若不清理，重装后历史记录可能出现错乱，甚至导致服务崩溃。

~/Library/Preferences/com.tencent.workbuddy.plist — 直接删除此文件。它记录了账号绑定状态、暂存盘路径和GPU加速开关等核心偏好设置。残留数据会使新安装版本继承错误的登录状态，即使用户看似已登出，后台仍会保留旧信息。

~/Library/Caches/com.tencent.workbuddy/ — 删除整个缓存文件夹。该文件夹体积常超过2GB，包含Webview资源、模型分片和UI渲染素材。不清理不仅会占用磁盘空间，还会干扰新版本的模型加载过程。

第三步：清除可能存在的后台服务项

打开终端应用程序，复制并粘贴以下两条命令，每条命令需单独按回车执行：

这一指令专门针对WorkBuddy设计。该程序注册的LaunchAgent服务不会随主程序删除而自动注销，残留后可能导致下次开机自启失败，或造成端口占用冲突，使新版本始终无法正常启动。

第四步：验证是否还有零散残留文件

推荐采用以下两种方法进行检查：

方法一：利用Spotlight搜索。按下Command+空格键，输入“workbuddy”，查看搜索结果中是否存在隐藏文件或文件夹——例如~/.workbuddy、~/Library/Saved Application State/com.tencent.workbuddy.savedState。若发现此类内容，请将其全部移入废纸篓。

方法二：通过终端快速扫描。在终端中执行命令：ls -la ~ | grep -i "workbuddy|wb"。如果输出结果显示任何内容，说明存在被忽略的隐藏配置目录。例如，若出现~/.workbuddy，请果断执行rm -rf ~/.workbuddy将其删除。

第五步：借助AppCleaner进行最终兜底扫描

下载并安装AppCleaner（免费开源工具）。启动后，在“系统设置”→“隐私与安全性”→“全盘访问”中，为AppCleaner授予相应权限。接着，将WorkBuddy.app图标拖入AppCleaner窗口——即使已从废纸篓清空，也可从废纸篓中重新拖出。该工具会自动识别并高亮所有关联项目，勾选全部后点击“Remove”即可移除。这一步能有效捕获手动操作遗漏的Saved Application State、Containers沙盒数据以及Bundle ID匹配的插件路径。相比CleanMyMac X，AppCleaner在处理腾讯系应用时识别率更高，结果更可靠。