Mac 系统下载安装与首次启动
Mac 端安装比 Windows 更简单，重点在于选对芯片对应的安装包。
选择安装包
- Apple 芯片（M1 / M2 / M3 / M4 系列）：下载 Apple 芯片版 .dmg（约 340 MB）；
- Intel 芯片：下载 Intel 版 .dmg（约 368 MB）；
- 系统需 macOS 12.0 及以上。
不确定芯片型号：点击屏幕左上角苹果菜单 >「关于本机」，「芯片」一栏显示 Apple M 系列即为 Apple 芯片，显示 Intel 即为 Intel 芯片。
安装步骤
- 打开下载好的 .dmg 文件；
- 按安装窗口提示，将应用拖入「应用程序」文件夹；
- 首次打开若提示来自未知开发者或验证开发者，按 macOS 提示在「系统设置 > 隐私与安全性」中允许运行。
首次启动设置
登录
启动后点击登录，浏览器会自动打开登录页面（workbuddy.cn），支持微信扫码、手机号、邮箱、SSO 等方式，登录成功后返回客户端即可。详细流程与常见登录故障见微信扫码登录。
界面语言
如需切换界面语言：点击左下角头像 > 设置 > 通用 > 语言 进行切换。
Mac 端实用路径速记
| 事项 | 路径 |
|---|---|
| 日志文件夹 | 顶部帮助 > 打开日志文件夹 |
| 数据目录 | ~/Library/Application Support/CodeBuddyExtension/ |
| 常开主机建议 | 合盖使用建议外接显示器防止休眠，或在设置中开启锁屏远程 |
| 目录权限修复 | 终端执行 sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension |
后两项主要在配置助理远程控制或排查登录问题时用到。
与 Windows 端的差异
- 安装方式是拖拽而非安装向导；
- 快捷键文档中的
Cmd对应 Windows 的Ctrl（如Cmd+K全局搜索）； - 部分安全排查命令不同，见诊断工具与日志。
以上说明整理自官方 Mac 安装指南，可能随版本变化，以官方最新版为准。