WorkBuddy 目前支持 Windows 10 及以上系统，以及 macOS 12 及以上系统。下载安装前最重要的是核对操作系统版本和处理器架构：苹果 M 系列芯片选 Mac ARM64，Intel 芯片选 Mac x64；Windows 普通英特尔或 AMD 电脑选 Windows x64。版本或架构选错，常见表现就是安装包打不开、启动即退出或登录后无法正常运行。
先用表格对照安装包
| 电脑情况 | 应选版本 | 当前注意事项 |
|---|---|---|
| Windows 10/11，Intel 或 AMD | Windows x64 | 不支持 Windows 7、8、8.1 |
| Windows 11，ARM 芯片 | 暂不安装 | 官方常见问题当前标注 ARM64 不支持 |
| Mac，M1/M2/M3/M4 等 | Mac ARM64 | 性能和兼容性更匹配 |
| Mac，Intel 芯片 | Mac x64 | ARM64 版本不能在 Intel Mac 运行 |
M 系列 Mac 也能借助 Rosetta 运行 x64 版本，但没有特殊兼容需求时应优先下载 ARM64。系统版本过低，应先评估升级系统，不建议通过来源不明的旧安装包绕过要求。
安装完成却登录不了怎么查
先把系统默认浏览器设为可正常打开网页的浏览器，再重新发起登录授权。若授权后没有回到 WorkBuddy，检查浏览器是否拦截跳转、客户端是否被安全软件隔离，以及账号目录是否有读写权限。Windows 还要留意杀毒软件或企业安全策略是否阻止客户端启动、网络访问或创建配置文件。
仍然失败时，打开“帮助与反馈”中的诊断工具重新检测，保存诊断报告和发生时间。报告可以帮助区分网络、目录权限、渲染进程与客户端配置问题；分享给支持人员前，应先遮挡用户名、目录和可能的敏感信息。
首次启动这样验证最稳
不要一上来授权整个硬盘。先新建一个测试工作空间，只放一份副本文件，发送“读取文件名并概括三点，不修改原文件”的任务。确认中文显示、模型调用、文件读取和结果保存都正常后，再逐步添加真实项目。若同一安装包在多台电脑表现不同，优先比较系统版本、芯片、默认浏览器和安全软件，而不是反复重装。
