点了没反应、登录失败怎么办：安装登录问题排查

安装与登录阶段的故障最打击信心，好在多数有现成解法。以下整理自官方 FAQ，按问题类型归组。

升级或重启后，原工作空间文件夹消失了

适用系统：Windows。

现象：升级重启后原有工作空间在界面中消失；部分用户可在 C:\Users\<用户名>\workbuddy 目录中找到历史文件夹，但存在文件缺失；也有整个目录不见的情况。

处理：

1. 打开文件管理器，找到 WorkBuddy 大文件夹（Windows 在用户目录的 workbuddy，Mac 在 /Users/用户名/WorkBuddy）；
2. 通过 WorkBuddy 打开以日期或自定义名字命名的文件夹，即可找回历史记录；
3. 建议将重要文件同步保存到独立目录。

点击无反应，无法登录或登录失败

原因一：未设置默认浏览器

• Windows：系统设置 > 默认应用，将 Chrome 设为默认浏览器后选择「在浏览器中打开」重试；或选「复制链接」手动粘贴到浏览器完成验证；
• Mac：「系统偏好设置 > 通用」中设默认浏览器为 Chrome 或 Safari，重启应用重新登录。

原因二：账号文件夹权限不足

• Windows：以管理员身份打开 PowerShell，用 takeown 与 icacls 命令修复 %APPDATA%\CodeBuddyExtension 目录属主与权限；
• Mac：终端执行 sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension；
• 修复后退出客户端重新打开并登录。

原因三：安全软件拦截

WorkBuddy 常被误拦截。临时退出火绒、360 安全卫士、电脑管家、Windows 安全中心后重试即可。

Windows 11 ARM64 无法安装

当前版本暂不支持 ARM64 架构的 Windows 11。建议改用受支持的设备环境（x64），或等待后续版本支持，以官方版本说明为准。

更新时提示"检测到应用安装目录下存在用户项目目录"

更新或重装时安装目录会清空并重新写入文件：

1. 在客户端图标上右键 > 打开文件所在位置（Windows 常见路径：C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy）；
2. 移除对话产生的自建文件夹，仅保留 bin、locales、resources、tools 等系统文件夹；有个人文件也一并移走，防止被安装程序覆盖；
3. 重新打开客户端，点击检查更新，等待安装包下载完成。

预防做法：永远不要把工作文件、对话产物放进安装目录。

助理工作空间的历史会话找不到了

助理工作空间中，最近产生对话的任务在助理板块展示，其他任务仅在工作空间列表展示。另外，电脑端新建任务时不建议将助理作为工作空间——助理适用于远程任务，且不支持修改默认文件夹。

服务器 / 云端部署问题

在 Windows Server 安装后出现连接失败、SSH 连接云端失败属已知情况；服务器端能力仍在完善中，正式支持以官方后续版本为准。

排查仍无解时，用内置诊断工具生成报告再反馈，流程见诊断工具与日志。