02 · 下载与安装

WorkBuddy 是桌面客户端，从官网 workbuddy.cn 下载。整个过程五分钟，但有两处容易选错：Mac 的芯片版本和Windows 的安装用户。

系统要求

平台	要求	说明
Windows	Windows 10 及以上	不支持 Win 7 / 8 / 8.1；Windows 11 ARM64 暂不支持
macOS	macOS 12 (Monterey) 及以上	Intel 与 Apple Silicon 都支持，但安装包不同
网络	需要联网	模型服务在云端，断网就跑不动
账号	需注册并登录	未登录状态下什么都做不了

不满足系统版本要求的机器装不上也起不来，不是配置问题，是硬门槛。

Windows 安装

1. 打开 workbuddy.cn，点「立即下载」，等安装包下完。
2. 双击安装包启动安装程序。
3. 勾选「我同意此协议」，下一步。
4. 选安装路径（默认路径直接下一步就行）。
5. 确认开始菜单文件夹，下一步。
6. 建议勾上「创建桌面快捷方式」。
7. 确认配置无误，点「安装」。
8. 装完点「完成」退出向导。

选安装用户时选「仅为我安装」

官方安装指引建议选「仅为我安装」。全机安装需要管理员权限，在公司电脑上经常卡在这一步，而且后续更新也更容易出权限问题。

macOS 安装

先确认你的芯片

点屏幕左上角苹果图标 →「关于本机」，看芯片一栏：

• M 系列芯片（M1 / M2 / M3 / M4…）→ 下载 Mac ARM64 版本
• Intel 芯片 → 下载 Mac X64 版本

官网识别不出来时给的是 X64

如果官网没能识别你的设备，默认会给 Mac X64 包。

原因是兼容性：X64 包可以通过 Rosetta 在 M 系列芯片上跑起来（慢一点但能用），而 ARM64 包在 Intel Mac 上完全跑不了。所以拿不准的时候，系统给的是「一定能用」的那个。

但如果你是 M 系列芯片，还是手动选 ARM64——原生运行的性能差别很明显。

安装步骤

1. 在浏览器弹窗中允许下载，等 .dmg 下完。
2. 双击 .dmg 打开安装窗口。
3. 把 WorkBuddy 图标拖进 Applications 文件夹，等拷贝完成。
4. 推出已挂载的磁盘映像；不再需要的话可以删掉下载目录里的 .dmg。

登录

安装完成后：

1. 启动 WorkBuddy，点「登录」。
2. 浏览器自动打开官网登录页。
3. 在登录弹窗里勾选《用户服务协议》与《隐私政策》，用微信扫码完成登录；也支持手机号、邮箱、SSO 等方式。整个登录在当前页面完成，不需要跳转。
4. 登录成功后自动回到客户端。

个人用户选个人登录，买了企业版的选企业登录——两者解锁的能力不一样，见 03 登录、账号与积分。

点了登录没反应？

这是最高频的安装问题，通常是三个原因之一：

1. 没设默认浏览器。 客户端要靠系统默认浏览器打开登录页，没设的话点了就是没反应。

• Windows：系统设置 → 默认应用 → 把 Chrome 或 Edge 设为默认浏览器，然后选「在浏览器中打开」重试；也可以选「复制链接」自己粘到浏览器里完成验证。
• Mac：系统设置 →「通用」→ 设默认浏览器 → 重启应用再登录。

2. 账号目录没有操作权限。 排查和修复命令见 排错与错误码。

3. 安全软件拦截。 火绒、360 安全卫士、电脑管家、Windows 安全中心都误拦过 WorkBuddy。临时退出安全软件重试一次，成功了就把 WorkBuddy 加白名单。

切换界面语言

点左下角**头像 →「语言」**切换界面语言。

本书正文以简体中文界面为准。如果你把界面切成了别的语言，本书里用「」标注的界面词请对照你屏幕上的实际文案。

检查更新

点左下角头像 →「检查更新」，系统自动检测版本：已是最新则无需操作；有新版本会自动下载并完成升级。

更新时提示「检测到应用安装目录下存在用户项目目录」

WorkBuddy 更新或重装时会清空安装目录再写入。如果你曾经把工作空间设在了安装目录下，那些文件会被覆盖掉。

处理办法：

1. 右键 WorkBuddy 图标 →「打开文件所在位置」。常见安装目录：
   • Windows：C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy
   • macOS：/Applications/WorkBuddy.app
2. 目录里正常应该只有 bin、locales、resources、tools 这几个系统文件夹。把对话产生的文件夹和你的个人文件移到别处。
3. 重新打开客户端，头像 →「检查更新」。

顺带一条：不要把工作空间设在安装目录里。 放桌面、放文档目录、放任何一个你自己管得住的地方都行。

升级后工作空间「不见了」

这是 Windows 上的一个已知现象：升级重启后，原有工作空间在界面里消失了。文件通常还在，只是列表没恢复。

先去这两个位置找：

• Windows：C:\Users\<用户名>\workbuddy
• macOS：/Users/<用户名>/WorkBuddy

用 WorkBuddy 打开那些以日期或自定义名字命名的文件夹，历史记录一般就回来了。

长期建议是：重要产出别只留在默认工作空间里，跑完顺手复制或上传一份到你自己管理的目录。

装完了做什么

先别急着输入。下一篇讲登录方式和积分——这两件事决定了你的能力上限和成本，值得花三分钟看明白：03 登录、账号与积分。