WorkBuddy 客户端卸载与清理方法

卸载 macOS 版 WorkBuddy 远不止简单拖入废纸篓——若未彻底清除 ~/Library/Application Support/WorkBuddy/、~/Library/Preferences/com.tencent.workbuddy.plist 和 ~/Library/Caches/com.tencent.workbuddy 这三处关键残留，重装后极易遭遇启动失败、界面错乱、数据库锁表甚至功能完全瘫痪；本文提供精准的终端清理命令、易被忽视的 launchd 后台服务与符号链接陷阱，以及针对受系统保护的本地数据库目录的实操解决方案，帮你一次性干净卸载、顺利重装，告别反复踩坑。

macOS 上卸载 WorkBuddy 必须手动删文件夹和 plist，系统“拖入废纸篓”或 App Store 卸载都不够——残留会导致重装失败、配置错乱、甚至下次启动卡在初始化。

为什么不能只拖进废纸篓？

WorkBuddy macOS 版不走标准 bundle 卸载流程，直接拖走只会删掉 /Applications/WorkBuddy.app，但以下三类关键路径完全不动：

• ~/Library/Application Support/WorkBuddy/：存本地数据库 workbuddy.db、技能包、用户任务快照
• ~/Library/Preferences/com.tencent.workbuddy.plist：保存账号绑定状态、暂存盘路径、GPU 加速开关等核心偏好
• ~/Library/Caches/com.tencent.workbuddy/：缓存 Webview、模型分片、UI 渲染资源，体积常超 2GB

这些残留一旦存在，重装后会强制复用旧配置，轻则界面显示异常，重则 SQLite 数据库锁表导致服务无法启动。

必须执行的三步清理命令（终端一行搞定）

打开终端，复制粘贴执行以下三条命令。注意：每条都带 sudo 或 rm -rf，请确认你已退出 WorkBuddy（右键托盘图标 → 退出），且没在运行任何相关进程。

• 删主应用与支持目录：sudo rm -rf /Applications/WorkBuddy.app && rm -rf ~/Library/Application\ Support/WorkBuddy
• 删偏好与缓存：rm -rf ~/Library/Preferences/com.tencent.workbuddy.plist && rm -rf ~/Library/Caches/com.tencent.workbuddy
• 删日志与临时模型（可选但推荐）：rm -rf ~/Library/Logs/WorkBuddy && rm -rf ~/Library/Application\ Support/WorkBuddy/Models

执行完后，用 ls ~/Library/Application\ Support/ | grep -i workbuddy 检查是否还有残留输出——无返回即清干净。

重装前要检查的两个隐藏坑

即使上述路径全空，仍可能因以下原因导致安装失败或功能异常：

• launchd 启动项残留：断电或中断安装可能注册过后台服务，执行 launchctl list | grep -i workbuddy，若返回 PID 则需 launchctl remove com.tencent.workbuddy.daemon
• 全局符号链接未清除：某些版本会在 /usr/local/bin/ 下建 workbuddy-cli 链接，执行 which workbuddy-cli，若有输出就 sudo rm /usr/local/bin/workbuddy-cli

这两处不处理，重装后可能报 “Permission denied” 或 “command not found”，但错误日志里不会明说。

最易被忽略的是 ~/Library/Application Support/WorkBuddy/ 下的 database/ 子目录——哪怕你删了整个 WorkBuddy 文件夹，如果之前启用了“自动备份任务到本地”，这个目录可能被系统保护或挂载为只读，得先 ls -lO ~/Library/Application\ Support/WorkBuddy/database 看是否有 restricted 标记，有就需 chmod -R 755 再删。

今天带大家了解了的相关知识，希望对你有所帮助；关于科技周边的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~