WorkBuddy 小白下载安装全流程:我重装了一遍,卡点全在这 4 个地方

QUOTE

真正卡住安装的，从来不是安装包本身。

—— 小鹅

这两天帮朋友装 WorkBuddy，顺手把网上两篇传得比较广的保姆级教程都翻了一遍。步骤写得很细，但有几个下载入口、界面叫法和模型名明显是旧版本的。我对着官网和官方文档重装了一遍，把现在实际会卡住的地方记下来。

先把结论放前面：Windows 10 及以上、macOS 12 及以上才能装；点「登录」没反应，十有八九是浏览器，不是账号；真正会埋雷的是安装目录和工作空间混在一起。

本文看点

官方入口是 https://www.workbuddy.cn/，点「立即下载」，页面会自动识别系统。文档站同时挂在 www.codebuddy.cn/docs 下，是同一套文档的另一个域名。别在搜索结果里点带「官方」字样的推广链接，更别用网盘里的安装包。

— 官网下载页：Windows 版入口

下载页按设备给版本，这几处最容易选错：

— Mac 下载页：按芯片选 ARM64 / X64

Windows 没什么可说的，双击安装包，向导一路走完。只提一句：可以不装在 C 盘，单独建个目录，后面排查权限时好找。

— 安装向导：选择目标位置，可以不装在 C 盘

Mac 这步官方文档专门写了「注意」：双击 .dmg 之后，必须把 WorkBuddy 图标拖进 Applications（应用程序）文件夹再启动。如果直接在磁盘映像里双击运行，程序会跑在只读的磁盘映像上，之后无法自动更新。

— 把 WorkBuddy 拖进 Applications 文件夹

这个坑的反应是延迟的——装完当下一切正常，等哪天点「头像 → 检查更新」才冒出来。官方文档给了两个补救办法：在提示里点「移动到应用程序」一键搬，或者手动拖进去，然后从「应用程序」重启。

第一次打开还会遇到系统拦一下：macOS 提示「无法打开／无法验证开发者」，去「系统设置 → 隐私与安全性」点「仍要打开」；Windows 被组策略或安全软件拦，火绒、360、电脑管家、Windows 安全中心都在官方列出的误拦名单里，临时退出重试即可，企业机器找 IT 把安装目录和 %LOCALAPPDATA%\WorkBuddy加白名单。

点「登录」后，软件不会在自己窗口里让你输账号——它会唤起默认浏览器打开 workbuddy.cn 的登录页，勾选协议，微信扫码（也支持手机号、邮箱、SSO），页面显示成功后回客户端就能用。第一次用最容易懵的就是「我点登录，怎么跳浏览器去了」，这是设计如此。

— 登录在浏览器里完成：微信扫码

所以点登录没反应时，按这个顺序查：

别一上来就重装，重装解决不了默认浏览器的问题。

这一步两篇教程都提了，但没说清为什么。我翻到官方权限文档和 FAQ 才对上。

工作空间是新建任务时选的那个目录，是 WorkBuddy 读文件、生成文件、放产物的地方；权限判断也以它为边界——超出工作空间的操作会停下来问你一次。而安装目录放的是程序本体，更新或重装时会被清空重写。

官方 FAQ 里有一条报错就叫「更新时提示检测到应用安装目录下存在用户项目目录」，另一条是「升级或隔天重启后，原工作空间文件夹消失」。两条都指向同一个原因：把用户数据放进了会被程序覆盖的地方。

所以第一次打开，别急着提问，先把两个目录分开，平级、互不嵌套：

— 概览里的「工作空间文件」，产物都落在这里

官方文档还建议：处理重要资料前，为任务新建一个独立文件夹，只放需要处理的副本。默认权限能减少误操作，但替代不了备份。

装完别急着研究模型列表。先发一个五分钟能验证结果的小任务，比如「把这段文本整理成三列表格」，确认三件事：能回话、能写文件、右侧结果区能看到产物。

— 新建任务：从这里开始第一个任务

界面按官方文档是四块：顶部工具栏、侧边栏（任务列表）、中间对话区、右侧结果区（概览／产物可切换）。不同版本叫法和布局会有差异，以自己客户端为准。

— 右侧结果区：查看任务结果与产物

工作模式有三种，在输入框附近切：Agent 直接干、Plan 先出方案再干、Ask 只聊不动手。日常用默认的 Agent 就行。

模型这块我只写不会过时的部分：输入框附近有模型选择面板，上面是快速／均衡／极致三档，下面是具体模型（混元 Hy 系列、GLM、Kimi、MiniMax、DeepSeek 等）。倍率、限免标签、具体型号调整得很快，写死数字没意义，一律以客户端当天显示为准。积分余额在「左下角头像 → 套餐与积分」看。

日志在「帮助 → 打开日志文件夹」，是个 .zip 包。提交问题时走「左下角头像 → 帮助与反馈」，勾选上传日志。安装失败按四步排查：系统版本、安装权限、网络、日志报错，把这四项连同截图一起交，比一句「装不上」有用得多。