装不上怎么办：安装与登录排错
WorkBuddy 装不上、登不进去，八成卡在三处：旧版本残留挡住安装、安全软件或浏览器挡住登录、设备本身不在支持范围。这一页把官方 FAQ 与社区实测的常见报错按「原文」逐个给原因和解法——先 60 秒速检定位方向，再对号入座。基于 v5.9.3（2026-10-27），阅读约 10 分钟。
先说清边界：任务执行阶段的报错（错误码 4100、1001、Bot 无响应、积分未到账）与完整错误码表，去 R1 排错速查：错误码与高频问题；网络类错误码 3002 / 3003 / 3007 因为也会卡登录，本页一并给排查思路。
学完你能做什么
- 用官方内置的「诊断工具」在 60 秒内定位：网络、磁盘、安全软件、崩溃日志哪一项出了问题
- 修掉 WorkBuddy 安装失败 的典型：报错 4551、更新提示「安装目录下存在用户项目目录」、Win11 ARM64 装不上
- 修掉 WorkBuddy 登录失败 的三类官方原因：默认浏览器、账号文件夹权限、安全软件拦截
- 网络错误码 3002 / 3003 / 3007 知道怎么排查；Mac 用户会处理「无法验证开发者」与「无法自动更新」
- 找回升级后消失的工作空间文件夹，并知道日志在哪、向谁反馈
你现在的困境
- 安装包下了一百多 MB，安装或卸载时弹个 4551，重试多少遍都一样
- 双击 WorkBuddy 没反应，或者点登录浏览器就是打不开、扫码后客户端毫无变化
- Mac 首次打开弹「无法验证开发者」，不知道这软件到底能不能信
什么时候用这一招
当你需要：
- 修复 1.2 安装主流程 或 1.2b 备用安装方式 里卡住的安装、更新与登录问题
而且不想：
- 报错就卸载重装来回折腾——先定位原因，多数情况覆盖安装就够
- 把「安全软件拦截」误判成「软件坏了」，白折腾一遍系统
🎒 开始前的准备
- 走过 1.2 安装主流程——卡在哪一步都没关系，本页就是解卡的
- 系统在支持范围内：Windows 10 及以上（x64）或 macOS 12 及以上；Win11 ARM64 见下文（官方口径：暂不支持）
- 能打开任务管理器（Windows，
Ctrl + Shift + Esc）或终端（Mac） - 习惯把报错原文和弹窗截图留下——反馈时官方要这些
核心思路
WorkBuddy 装不上，先分清卡在哪一环。 从下载到进入主界面要过四关，每一关的报错长得不一样：
| 环节 | 出什么事 | 快速判断 | 典型表现 | 去哪组 |
|---|---|---|---|---|
| 1. 设备与系统 | 系统不在支持范围 | 对照官方环境要求 | Win11 ARM64 装不上 | 第 1 组 |
| 2. 安装/更新 | 旧版本残留、装错位置 | 看报错编号或提示文字 | 4551、「安装目录下存在用户项目目录」、Mac 打不开 | 第 1、3 组 |
| 3. 登录 | 浏览器、权限、安全软件、网络 | 点登录后客户端无反应 | 点击无反应、登录失败 | 第 2 组 |
| 4. 升级后异常 | 数据丢失、更新失败 | 找文件夹、检查更新 | 工作空间消失、无法自动更新 | 第 3 组 |
一个官方工具最省事：诊断工具。 WorkBuddy 内置「诊断工具」，一键检测网络、系统资源、安全软件、环境信息与崩溃日志，自动生成脱敏的诊断报告。遇到无法登录、连接失败、客户端异常，官方建议先跑它自检（用法见 60 秒速检）。
💡 报错原文是最好的搜索词
弹窗标题、报错编号（如 4551）就是你要的原文——拿它对下面的标题，或直接复制去搜。找不到出处的偏方别乱试。
首次排查：60 秒速检
打不开、登不上时，先跑一遍客户端内置自检，再看系统门槛：
# 1. 打开 WorkBuddy → 顶部「帮助」→「诊断工具」→ 开始检测
# —— 一键检查网络、磁盘（低于 3GB 告警 / 1GB 失败）、安全软件、崩溃日志
# 2. 检测到安全软件拦截时，弹窗会展示需要加入白名单的路径
# 3. 对照系统要求：Windows 10+（x64，不支持 Win7/8/8.1）；macOS 12+
# 4. 临时退出安全软件（火绒 / 360 安全卫士 / 电脑管家 / Windows 安全中心）后重试登录
# 5. 还是模糊？帮助菜单 →「打开日志文件夹」（Mac）/「打开日志目录」（Windows），拿 .zip 日志去反馈你应该看到：诊断工具生成 .txt 报告（保存在日志目录 logs/self-check/ 下，保留最近 10 份），失败项带方向性修复建议。哪一项红了就从哪一项修——个人账号与海外版仅展示「网络」分组，属正常。
常见问题排查
WorkBuddy 安装失败：装不上、卸不掉、打不开
"安装或卸载报错 4551"
原因：更新程序扫描到了旧版本遗留的备份文件或历史项目记录——通常是安装目录下名为 _、backup、old、backup_old 的文件夹。（解法来自腾讯云社区第三方实测，官方文档未收录此错误码）
解决：
- 打开 WorkBuddy 安装目录（如
D:\WorkBuddy） - 查找并删除名为
_的文件夹，同时清理类似backup、old、backup_old名称的文件夹 - 打开任务管理器（
Ctrl + Shift + Esc），结束所有名为WorkBuddy.exe和WorkBuddy Service.exe的进程 - 去 WorkBuddy 官网 重新下载最新版安装包，覆盖安装
你应该看到：安装向导正常走完，不再弹 4551。
"检测到应用安装目录下存在用户项目目录"
原因：官方 FAQ 说明——WorkBuddy 更新或重装时，安装目录会先清空再重新写入文件，目录里如果有自己的本地文件，可能被覆盖丢失。英伟达芯片用户可能会在安装路径下生成 NVIDIA Corporation 文件，导致更新失败。
解决：前往 WorkBuddy 官网，手动下载最新版安装包并覆盖安装。
你应该看到：覆盖安装完成，版本更新到最新。
⚠️ 安装目录里别放自己的文件
安装目录会在更新时被清空重写。工作文件请放在工作空间或独立目录，不要塞进 WorkBuddy 的安装目录。
"Windows 11 ARM 64 架构无法安装"
原因：官方 FAQ 明确写「当前版本暂不支持 ARM 64 架构的 Windows 11」。（安装指南另一处口径是「ARM64 设备的支持情况以当前版本说明为准」——两处对照，按暂不支持处理）
解决：官方建议改用受支持的设备环境（Windows 10 及以上 x64，或 macOS 12 及以上），或等待后续版本支持。
你应该看到：换设备后按 1.2 安装主流程 正常装上。别信来路不明的 ARM 改包。
Mac 首次打开提示"无法验证开发者"
原因：macOS 的应用安全机制拦下了首次启动。（做法来自腾讯云社区第三方实测；官方 Mac 安装指南未单列此条）
解决：前往「系统偏好设置 → 安全性与隐私」，点击仍然打开，放行首次启动。
你应该看到：再次双击 WorkBuddy 能正常启动，进入登录界面。
WorkBuddy 登录失败与网络问题：点不动、扫不出、连不上
"点击 WorkBuddy 无反应，无法登陆或登录失败"
官方 FAQ 给了三类常见原因，按顺序排查：
原因 1：未设置默认浏览器。
解决：
Windows：
- 进入系统设置 → 默认应用，将 Chrome 设为默认浏览器
- 再次点击登录，尝试拉起登录验证窗口
- 拉不起来的话：选择「复制链接」，自己打开浏览器，
Ctrl + V或右键粘贴链接到地址栏，完成登录验证
Mac：
- 打开「系统偏好设置」→「通用」
- 设置默认浏览器为 Chrome 或 Safari
- 重启应用后重新登录
原因 2：账号文件夹无操作权限（目录 owner 不是当前用户）。
解决：三步走——先确认权限，再授权，最后重新登录。
Mac 在终端中执行，确认目录 owner 是否当前用户（whoami 可查用户名）：
ls -la ~/Library/Application\ Support/CodeBuddyExtension/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/owner 不是当前用户则授权：
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtensionWindows 在 PowerShell 中执行，确认 Owner 和 Access 列表包含当前用户：
Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public\auth" | Format-List不包含则以管理员身份打开 PowerShell 授权：
$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /T授权后退出 WorkBuddy 重新打开，重新登录。
原因 3：安全软件拦截。 官方原话「WorkBuddy 常被误拦截，关闭安全软件后重试即可」。
解决：临时退出以下安全软件后重试：火绒、360 安全卫士、电脑管家、Windows 安全中心。
你应该看到：按对应原因处理后，点登录浏览器正常打开官网登录页，微信扫码后客户端进入主界面。
"网络连接失败，请检查网络后重试"（错误码 3002 / 3003 / 3007）
原因：官方错误码文档将 3002（连接失败）、3003（连接超时）、3007 归为网络环境问题。登录要在浏览器里完成（点登录后浏览器打开 workbuddy.cn 登录页），网络不通登录页自然打不开；任务执行中也会出现同款提示。
解决：
- 先确认当前用的是公司网络还是家庭网络
- 公司网络：联系企业 IT 协助排查
- 家庭网络：按官网网络排查流程逐项处理
- 按官方「网络代理」说明处理代理——WorkBuddy 5.3.0 起内置网络代理切换功能，不了解各选项区别就用「跟随系统」
你应该看到：网络恢复后任务继续。官方说明：网络波动时 WorkBuddy 会先自动重连（任务进度处显示「网络故障，尝试重连中…」），已生成的内容和执行记录会保留；网络恢复后自动接在原回复后面继续。
升级与更新问题：更新卡住、工作空间消失
Mac 提示"检查更新失败"或"无法自动更新"
原因：官方 Mac 安装指南警告——如果双击 .dmg 后直接从磁盘映像里运行，WorkBuddy 会运行在只读的磁盘映像上，后续将无法自动更新。
解决（官方给两条路）：
- 一键移动：点击提示中的「移动到应用程序」按钮，WorkBuddy 自动移动到「应用程序」文件夹
- 手动移动：打开文件夹，将 WorkBuddy 拖入「应用程序」文件夹
完成后从「应用程序」重新启动 WorkBuddy，即可正常检查并完成更新。
你应该看到：左下角头像 → 检查更新，显示「已是最新版本」或自动升级完成。
"升级或隔天重启后，原工作空间文件夹消失"
原因：官方 FAQ 记录的 Windows 已知现象——升级重启后原有工作空间在界面中消失；部分用户可在用户目录找到历史文件夹但存在文件缺失，也有用户整个目录不见。
解决：
- 打开文件管理器（Windows）或 Finder（Mac），找到 WorkBuddy 大文件夹：
- Windows：
C:\Users\<用户名>\workbuddy - Mac：
/Users/用户名/WorkBuddy
- Windows：
- 通过 WorkBuddy 打开以日期或用户自定义名字命名的文件夹，找回原有历史记录
- 官方建议：将重要文件同步保存到独立目录，别只依赖工作空间
你应该看到：历史会话与文件重新出现在工作空间列表里。
还是不行？
先收集证据再反馈。 官方 FAQ 的使用建议：优先保留证据——错误码、报错截图、系统版本、网络环境与发生时间。
| 要收集什么 | 怎么拿 |
|---|---|
| 诊断报告 | 帮助 → 诊断工具 → 导出报告（.txt，已脱敏：IP 仅保留前两段、用户名替换为 ***） |
| 日志包 | Mac：帮助 →「打开日志文件夹」；Windows：帮助下拉 →「打开日志目录」（.zip 压缩包） |
| 报错截图 | 弹窗原文 + 错误码（如有） |
| 系统信息 | 系统版本、网络环境、发生时间 |
去哪里问：
| 渠道 | 适合什么 |
|---|---|
| 客户端内反馈：帮助下拉 → helpFeedback，或头像 → 设置 → 帮助与反馈 → 意见反馈（勾选上传日志） | 最快通道，日志一并带上 |
| 邮件 workbuddy@tencent.com | 官方 FAQ 给出的咨询邮箱 |
| 官方 FAQ / 错误码说明 | 本页多数条目的出处 |
检查点 ✅
- 诊断工具跑过一遍，我知道卡在网络、磁盘、安全软件还是权限
- 报错 4551：我删了
_/backup/old文件夹、结束了 WorkBuddy 进程再覆盖安装 - 登录失败：三类官方原因（默认浏览器 / 文件夹权限 / 安全软件）我逐条排过
- Mac：WorkBuddy 在「应用程序」文件夹里，「检查更新」能正常运行
- 还不行的话，我会带着诊断报告 + 日志 + 报错截图去意见反馈或发邮件
本课小结
✅ WorkBuddy 装不上先分环节：系统门槛 → 安装/更新 → 登录 → 启动后异常，每一环有固定的检查项。
✅ 安装失败两大典型都有固定修法：4551 清残留文件夹 + 杀进程 + 覆盖安装；「安装目录下存在用户项目目录」直接官网下最新版覆盖安装。
✅ 登录失败按官方三类原因排查：设默认浏览器 → 查账号文件夹权限（chown / takeown）→ 退安全软件。WorkBuddy 常被误拦截，先关安全软件重试。
✅ 两个官方求助出口记住了：客户端内意见反馈（带日志），或邮件 workbuddy@tencent.com。
关键信号速查：
| 信号 | 环节 | 第一步 |
|---|---|---|
| 报错 4551 | 安装/卸载 | 删 _ / backup 等残留文件夹，杀进程覆盖安装 |
| 「安装目录下存在用户项目目录」 | 更新 | 官网下最新版覆盖安装 |
| Win11 ARM64 装不上 | 系统 | 官方暂不支持，换受支持设备 |
| 点击无反应 / 登录失败 | 登录 | 默认浏览器 → 文件夹权限 → 安全软件 |
| Mac「无法验证开发者」 | Mac 启动 | 安全性与隐私 → 仍然打开 |
| Mac 无法自动更新 | Mac 更新 | 拖回「应用程序」文件夹再启动 |
| 升级后工作空间消失 | 数据 | 去用户目录 workbuddy 文件夹找回 |
运行阶段的错误码（4100 自定义模型、1001 模型异常、6003/6004 频率受限等）见 R1 排错速查：错误码与高频问题。
下一课预告
装好了、登上了，下一课开始真正干活：第一个任务：从一句话到可验收的产物。
你会学到：
- 从下载到登录再到新建任务的五步完整流程
- WorkBuddy 界面四区域：工具栏、侧边栏、对话区、结果区
- 产物在哪看：产物、网页、工作空间文件、变更四个页签