Mac 装 WorkBuddy 要注意什么？两个 dmg 别下错，加上一条容易漏的目录权限
Mac 上装 WorkBuddy，绝大多数问题集中在两件事：下错了包，和目录权限。前者一分钟能确认，后者官方给了现成的命令。
这篇按 Mac 用户的实际动线走一遍：下载前确认什么 → 装到哪儿了 → 数据在哪 → 登录卡住怎么办 → 日志怎么取。
本文依据腾讯云 CodeBuddy 国内站产品页
codebuddy.cn/work/下载区标注与官方常见问题页From-Beginner-to-Expert-Guide/FAQ，核对日 2026-08-16。我们没有安装客户端，界面文案以你实际看到的版本为准。
一、系统要求与两个包
官方产品页下载区标注：
- 系统要求：macOS 12.0+
- 提供两个包：
.dmg (Intel)和.dmg (Apple 芯片)
先查系统版本：左上角苹果图标 →「关于本机」。低于 12.0（Monterey）的话，先升级系统再说。
再查芯片：还是「关于本机」这个窗口，看「芯片」那一行——
| 显示内容 | 该下哪个包 |
|---|---|
| Apple M1 / M2 / M3 / M4 等 | .dmg (Apple 芯片) |
| Intel Core i5 / i7 / i9 等 | .dmg (Intel) |
下错了会怎样：Apple 芯片包在 Intel 机器上跑不起来；Intel 包在 Apple 芯片机器上一般能通过系统的转译层运行，但既然官方分了包，按自己的芯片选是更稳的做法。
下载入口在产品页导航的「下载」下拉里，条目写的是「下载 WorkBuddy（腾讯龙虾）」——「腾讯龙虾」是官方在国内站标的中文别名，别以为点错了。同一个下拉里的「下载 CodeBuddy IDE」是另一个产品，不是这个。
二、装完之后，三个目录分别是什么
Mac 上有三个路径经常被混为一谈，搞清楚了排查会快很多：
| 目录 | 路径 | 里面是什么 |
|---|---|---|
| 程序本体 | /Applications/WorkBuddy.app | 应用本身。更新或重装时这个目录会被清空重写 |
| WorkBuddy 大文件夹 | /Users/用户名/WorkBuddy | 工作空间与历史记录，按日期或你自定义的名字分文件夹 |
| 账号配置目录 | ~/Library/Application Support/CodeBuddyExtension | 登录凭证等。权限出问题会直接导致登录失败 |
第二个目录的用处：官方 FAQ 里有一条讲「升级或隔天重启后，原工作空间文件夹在界面里消失」，给的做法就是打开 Finder 去 /Users/用户名/WorkBuddy 找，通过 WorkBuddy 打开以日期或自定义名字命名的文件夹，即可找回原有历史记录。官方同时建议：把重要文件同步保存到独立目录。
第三个目录默认是隐藏的。在 Finder 里按 Cmd + Shift + G，粘贴 ~/Library/Application Support/CodeBuddyExtension 就能直接跳过去。
三、登录卡住：官方给的 Mac 侧处理
点登录没反应，或者浏览器验证走完了回到客户端还是未登录——官方把这类归成三类原因。Mac 上按这个顺序：
原因一：没设默认浏览器
登录需要拉起浏览器完成验证。官方给的 Mac 做法：
系统偏好设置 → 通用 → 设置默认浏览器为 Chrome 或 Safari → 重启应用重新登录。
另外一条更省事的路子：登录界面如果提供了「复制链接」，直接复制出来自己在浏览器里粘贴打开，也能完成验证。
原因二：安全软件拦截
官方点名的几款（火绒、360 安全卫士、电脑管家、Windows 安全中心）主要是 Windows 侧的，但官方那句「WorkBuddy 常被误拦截」的原则在 Mac 上同样值得参考——如果你装了第三方安全类软件，临时退出重试一次，成本很低。
原因三：账号文件夹没有操作权限
这一类的典型特征是：浏览器那边验证成功了，回到客户端还是没登上。 官方给了可以直接用的命令。
先检查（不改任何东西，只看）：
ls -la ~/Library/Application\ Support/CodeBuddyExtension/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/
用 whoami 看当前用户名，对比上面输出里各目录的 owner 是不是这个用户。
确认是权限问题再授权：
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension
然后退出 WorkBuddy，重新打开，重新登录。
两点提醒：
- 先跑检查命令，别上来就跑
chown。owner 本来就是你的话，跑了也白跑，还多输一次密码。 - 路径里的
Application\ Support那个反斜杠是转义空格，不能删。整段复制粘贴最稳妥。
四、日志在哪
Mac 侧取日志的路径（官方给的）：
WorkBuddy → 顶部「帮助」→「打开日志文件夹」，找到对应的日志 .zip 包。
反馈入口有两个：右上角「帮助」下拉框，或者右下角头像 → 设置 - 帮助与反馈 - 意见反馈。在反馈页描述问题、上传截图，并**勾选「上传日志」**后提交。
官方专门提示了一句：日志仅用于排查问题，但可能包含对话记录、设备信息等数据，详情见官方隐私保护声明。所以如果你最近处理过敏感内容，提交前心里有个数，必要时在描述里说明。
客户端完全打不开、菜单都点不到的情况下，官方文档给的支持邮箱是 workbuddy@tencent.com。
五、Mac 用户额外要知道的一条
官方在权限模式文档里提到了三层保护机制：沙箱约束、删除保护、文件备份。其中文件备份这一层目前只有 Windows 支持——修改已有文件前先存副本这个能力，Mac 上没有。
这意味着 Mac 用户在做批量改写、批量重命名、整理目录这类任务时，少了一层自动兜底。对应的做法很简单，也是官方反复强调的：
- 每类任务建独立文件夹当工作空间，官方给的命名示例是
weekly-report、invoice-archive、customer-data-cleanup、batch-image-processing这种； - 处理重要文件之前，先把文件复制一份进任务文件夹，而不是直接把原始目录交出去；
- 官方原话：默认权限降低误操作风险，但它不能替代备份。
六、第一次跑任务之前，先把工作空间规划好
Mac 上有个位置特别容易被随手选中当工作空间：桌面。看着方便，但它是最不该选的位置之一。
官方在权限模式文档里，把「工作空间靠近桌面、下载、个人文档根目录，或者源码仓库根目录」明确列为不应开启完全访问的情形之一。官方常见问题页里另有一条更直接的记录：下发整理桌面的指令后会生成一个脚本文件，执行后桌面完成整理，但部分文件疑似丢失；官方给的做法是执行前先备份桌面重要文件，执行后优先检查目标整理目录与回收站。
所以建议装完之后先花两分钟做这件事：在一个跟系统目录无关的位置（比如用户目录下建一个 WorkBuddy工作区），按任务类型分好文件夹。官方给的命名示例是 weekly-report、invoice-archive、customer-data-cleanup、batch-image-processing 这种——一个任务一个文件夹，需要处理的文件复制进去而不是把原目录交出去。
这个习惯在 Mac 上比在 Windows 上更重要，原因就是上一节说的：文件备份那层自动兜底 Mac 没有。
七、几个官方文档没覆盖的
诚实标注，避免你以为这篇能解决所有问题：
- 「已损坏，无法打开」「无法验证开发者」这类系统提示的处理——官方 FAQ 没有对应条目，我们不搬社区做法。
- 最低磁盘空间与内存要求——官方只写了系统版本。
- macOS 系统权限（完全磁盘访问、文件夹访问）需要怎么授予——官方文档未展开。
- 卸载步骤——官方文档未提供卸载指引。
这几种情况都建议直接走反馈路径，把系统版本、芯片类型、具体提示的截图一起提交。
小结
- 系统要求 macOS 12.0+；两个包按芯片选，「关于本机」看「芯片」那一行。
- 下载入口条目写的是「下载 WorkBuddy（腾讯龙虾）」，别点成 CodeBuddy IDE。
- 三个目录别混：
/Applications/WorkBuddy.app（程序，更新会清空）、/Users/用户名/WorkBuddy（工作空间与历史）、~/Library/Application Support/CodeBuddyExtension（账号配置）。 - 登录卡住按 默认浏览器 → 安全软件 → 目录权限 排；权限问题先跑
ls -la检查，确认了再跑sudo chown -R。 - 日志：顶部「帮助」→「打开日志文件夹」；日志可能包含对话记录与设备信息。
- Mac 没有「文件备份」这一层保护（仅 Windows 有），批量操作前自己先复制一份。
功能与命令以官方为准，核对日 2026-08-16。