安装 WorkBuddy 本身并不复杂，真正值得注意的是三个细节：安装包来源、当前版本，以及首次启动时的权限选择。把这三件事做对，后面的教程才有稳定基线。
本教程以本地已验证的 5.2.5 版本为参照。界面更新后，按钮位置可能变化，请以官方更新日志为准。
安装前准备
- 确认电脑系统和剩余空间满足官方当前要求。
- 关闭来源不明的代理下载器或第三方安装助手。
- 准备一个不含敏感数据的练习文件夹。
- 不需要提前打开“完全访问”或授权整个磁盘。
练习文件夹可以命名为 workbuddy-lab，里面放一份公开文档和一个空白输出目录。后续所有入门任务都先在这里完成。
Windows 安装路径
- 从 WorkBuddy 官方入口下载 Windows 安装包。
- 检查文件名和数字签名，不运行来自聊天群或网盘的同名程序。
- 双击安装，按系统提示完成应用写入。
- 如果 Windows 弹出安全提示，先核对发布者信息，不要习惯性点击“仍要运行”。
- 安装完成后从开始菜单打开 WorkBuddy。
预期现象： 应用进入登录或新建任务界面，而不是打开浏览器中的陌生授权页。
macOS 安装路径
- 从官方入口下载 macOS 版本。
- 打开安装文件，将 WorkBuddy 放入“应用程序”。
- 从“应用程序”第一次启动。
- 如果系统阻止打开，先在“隐私与安全性”里核对应用来源，再决定是否允许。
- 不要为了绕过提示关闭 macOS 的整体安全机制。
预期现象： WorkBuddy 能出现在应用程序目录，启动后显示正常品牌和登录流程。
完成登录
按应用当前提供的账号方式完成登录。登录过程中注意：
- 只在 WorkBuddy 官方应用或官方域名中输入账号信息。
- 不把验证码发给任何“客服”或第三方教程作者。
- 如果需要企业账号或组织授权，先确认当前任务是否真的需要组织数据。
登录成功后，先不要连接邮箱、文档或即时通信平台。第三方连接器会扩大数据范围，应在理解连接器用途后单独授权。
核对版本
在应用菜单或关于页面查看当前版本。本地验证基线为 5.2.5。
| 检查 | 通过标准 |
|---|---|
| 应用版本 | 5.2.5 或官方更新版本 |
| 新建任务 | 能看到任务输入区域 |
| 场景入口 | 能看到日常办公、代码开发、设计创意或其更新名称 |
| 工作区 | 输入区可以选择或确认工作区 |
| 模式/权限 | 可以看到任务模式、模型或权限相关入口 |
如果版本明显更旧，优先使用应用内更新。更新前结束正在运行的任务，并保存重要产物。
第一次启动不要做什么
- 不要一次连接所有第三方账号。
- 不要把工作区指向整个用户目录或公司共享盘。
- 不要打开默认完全访问权限。
- 不要先安装几十个 Skills，再尝试第一个任务。
- 不要用真实合同、客户数据或生产代码测试。
这些动作会让排错变量迅速增加。第一次启动只需要证明“应用可用、账号正常、工作区可控”。
常见问题
应用无法启动
先确认安装包来自官方入口、系统版本受支持，并重新启动应用。Windows 检查安全软件是否误拦截；macOS 检查“隐私与安全性”中的来源提示。仍无法解决时，记录系统版本、WorkBuddy 版本和错误原文，再查官方帮助。
登录后页面空白
检查网络与系统时间，退出后重新登录。不要反复安装不同来源的安装包，也不要在不清楚原因时删除应用数据目录。
找不到教程里的按钮
先核对版本和官方更新日志。产品快速迭代时，入口可能从独立导航移动到“更多”或任务设置中。以功能名称和任务目的定位，不只依赖截图坐标。
完成检查
- WorkBuddy 从官方来源安装。
- 账号登录正常。
- 已记录当前版本。
- 可以新建任务并看到工作区与模式入口。
- 练习文件夹已准备好，且没有敏感数据。
- 尚未授予与首次任务无关的高权限。
下一课先认识任务、工作区和产物位置。界面理解清楚后，再开始第一个办公任务。