交流群
安装、登录与更新
WorkBuddy下载
下载WorkBuddy，点击官方地址（https://www.codebuddy.cn/work/），选择WorkBuddy，点击“下载WorkBuddy”即可下载。
网站会自动检查你当前设备，判断你是什么版本，Mac ARM64、Mac x64或者Windows x64。
切记：从官方入口进入下载，不从网盘或不明镜像获取安装包。
Windows 安装
- 下载完成后双击安装文件。
- 如系统弹出安全提示，先核对发布者与下载来源，再决定是否继续。
- 按安装向导完成安装并启动 WorkBuddy。
- 进入准备运行环境
macOS 安装
- 打开安装文件，将 WorkBuddy 拖入“应用程序”；
- 从“应用程序”启动；
登录
点击登录按钮
自动跳转网页登录
选择微信扫码登录，也可以手机号登录
完成后，即可使用WorkBuddy进行工作
PS：若公司电脑禁止安装软件，不要绕过终端安全策略，应联系 IT 管理员确认白名单或企业部署方式。
更新
点击左下角个人中心，选择“检查更新”，检查是否有新版本，若有新版本，可更新
常见问题
安装包打不开或提示损坏
先删除安装包并从官网重新下载，核对系统和芯片版本。仍失败时记录系统版本、安装包名和报错截图，通过官方反馈渠道处理，不要随意关闭系统安全功能。
登录后没有反应
检查默认浏览器是否拦截登录回跳、网络代理是否影响认证、系统时间是否准确。退出应用后重试，并保留日志与截图。
无法读取或写入文件
确认任务选择的工作目录是否正确、系统是否授予对应目录权限、文件是否被其他程序锁定。先用一个空白文本文件测试，不要直接拿重要文件反复试错。
更新前要不要备份
应用更新一般不应修改工作文件，但长期项目仍应把输入、产物、配置和自定义 Skill 纳入版本管理或定期备份。
进阶：别让缓存把系统盘吃满
装完能用只是第一步。真正容易出问题的是缓存和日志越攒越大，几个月后把 C 盘撑满，客户端开始卡、任务开始失败，而你不会想到是磁盘的锅。
迁移数据目录的正确顺序：
- 完全退出客户端，包括托盘里的后台进程——文件被占用时迁移会不完整。
- 找到设置里的「数据 / 缓存目录」，记下它当前指向的真实路径。
- 把整个目录剪切到数据盘，例如
D:\WorkBuddyData\。 - 回到设置里把目录指向新位置。有「迁移」按钮就用按钮，别手动改配置文件。
- 重启客户端，跑一个小任务，确认日志能写进新目录。
- 回旧路径看一眼，确认没有新增文件。
两个最常见的错：
- 只挪目录、不改设置：客户端下次启动还会在旧位置重建一个空目录，等于白迁。
- 把数据目录同步到公共网盘：里面会有历史任务记录和会话内容，别随手同步。
更新本身一般不动你的工作文件，但长期项目仍建议把输入、产物、配置和自建 Skill 纳入版本管理或定期备份。要不要在更新前备份，取决于这个项目失败一次的成本。
来源说明：本章改编自开源项目 AlephAITech/WorkBuddyGuide（MIT License，Copyright © 2026 WorkBuddy Guide Contributors），按 MIT 协议保留原作者署名；本站做了标题改写、排版与链接适配。