Windows 装 WorkBuddy 卡住？先处理安全软件，再看这三个目录

Windows 上装这类桌面 AI 客户端，最常见的拦路虎不是系统不兼容，是安全软件。官方常见问题页里有一句原话说得很直接：

WorkBuddy 常被误拦截。

官方点名的有火绒、360 安全卫士、电脑管家、Windows 安全中心。麻烦的地方在于，这类拦截经常不弹提示——你只看到「双击了没反应」或者「装完打不开」，根本不知道是被拦了。

这篇按 Windows 用户的实际动线走：装之前确认什么 → 装到哪儿了 → 登录卡住怎么办 → 日志在哪。

本文依据腾讯云 CodeBuddy 国内站产品页 codebuddy.cn/work/ 下载区标注与官方常见问题页 From-Beginner-to-Expert-Guide/FAQ，核对日 2026-08-16。我们没有安装客户端，本文不含实测数据。

一、装之前确认两件事

第一，系统版本。 官方标注 Windows 10+。查法：Win + R → 输入 winver → 回车。

第二，设备架构。 官方只提供一个包：Windows x64（兼容 ARM64）。

查法：Win + R → cmd → 输入

echo %PROCESSOR_ARCHITECTURE%

返回 AMD64 是常规 x64，绝大多数人是这种，直接往下走。返回 ARM64 的话（骁龙平台的笔记本），需要注意两处官方口径不一致：产品页标注 x64 包「兼容 ARM64」，但官方 FAQ 另有一条写「当前版本暂不支持 ARM 64 架构的 Windows 11」。我们并列陈述、不做判断；建议先用限时免费的体验版试装，别先买订阅。

下载入口在产品页导航「下载」下拉里，条目是「下载 WorkBuddy（腾讯龙虾）」。同一个下拉里还有「下载 CodeBuddy IDE」，那是另一个产品。

二、安全软件：优先处理，别放到最后

按官方那句「常被误拦截」，把这一步放在前面能省很多时间。

装之前：临时退出火绒 / 360 安全卫士 / 电脑管家；Windows 安全中心可以先不动，装的过程中如果弹了拦截提示，选择允许。

被拦的典型表现（三种都可能，最后一种最迷惑）：

1. 安装进度条走到一半停住不动；
2. 装完了但启动时提示找不到文件——程序文件被隔离了；
3. 完全静默：双击安装包什么都没发生，没有任何提示。

装完之后记得把安全软件开回来。 如果开回来之后又出问题，去安全软件的信任区/白名单里把 WorkBuddy 的安装目录加进去，比反复退出安全软件靠谱。

三、三个目录，分别是什么

Windows 上这三个路径经常被搞混，理清楚了排查会快很多：

目录	路径	里面是什么
安装目录	C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy	程序本体。更新或重装会清空并重写
WorkBuddy 大文件夹	C:\Users\<用户名>\workbuddy	工作空间与历史记录
账号配置目录	%APPDATA%\CodeBuddyExtension	登录凭证等，权限出问题直接导致登录失败

几个实用提醒：

• AppData 是隐藏文件夹。要么在文件资源管理器的「查看」里勾上「隐藏的项目」，要么直接在地址栏粘贴完整路径回车。
• 想快速定位安装目录：在 WorkBuddy 图标上右键 →「打开文件所在位置」。这是官方在讲更新问题时给的做法。
• 安装目录在 C 盘的用户目录下。C 盘空间紧张会影响安装和后续更新——更新的机制是清空目录重新写入，中途空间不够就失败。

关于第二个目录：官方 FAQ 有一条讲「升级或隔天重启后原工作空间在界面里消失」，给的做法就是去 C:\Users\<用户名>\workbuddy 找，通过 WorkBuddy 打开以日期或自定义名字命名的文件夹即可找回历史记录。官方同时建议把重要文件同步保存到独立目录。

一条使用习惯上的建议：工作空间别建在安装目录里（更新会清空），也别建在桌面（桌面是特殊目录，官方 FAQ 里另有一条讲整理桌面导致文件丢失的高风险场景）。单独找个位置，按任务分文件夹。

四、登录卡住：官方给的三类原因

界面正常但点登录没反应，或者浏览器验证走完回来还是未登录状态。官方按排查成本从低到高给了三类：

原因一：没设默认浏览器（一分钟）

登录要拉起浏览器完成验证，系统没有默认浏览器这一步就断了。官方给的 Windows 做法：

系统设置 → 默认应用 → 把 Chrome 设为默认浏览器 → 然后选择「在浏览器中打开」再次拉起登录验证窗口。

或者更省事：选择「复制链接」，自己打开浏览器粘贴完成登录验证。这条路能绕过默认浏览器的设置问题，值得优先试。

原因二：安全软件拦截（两分钟）

同前面。典型特征是时好时坏，或者装完第一次就打不开。

原因三：账号文件夹没有操作权限（五到十分钟）

典型特征：浏览器那边验证成功了，回到客户端还是没登上。

官方给了 PowerShell 命令，先检查：

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

看输出里的 Owner 和 Access 列表是否包含当前用户。

确认是权限问题之后再授权。这一步要用管理员身份打开 PowerShell（开始菜单搜 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 重新打开、重新登录。

两个必须提醒的点：

1. 先跑检查命令，确认确实是权限问题再跑授权命令。 takeown 和 icacls 会改目录的所有权和访问控制，不该在没确认的情况下随便跑。
2. 公司统一管理的电脑、域账号环境下，用户目录权限可能受组策略限制，这两条命令可能跑不动或者跑完又被策略改回去。这种情况找 IT，别自己硬来。

五、日志与反馈

日志位置（官方给的 Windows 路径）：左上角「帮助」下拉框 → 「打开日志目录」，其中的压缩包就是日志文件。

反馈入口：右上角「帮助」下拉框，或者右下角头像 → 设置 - 帮助与反馈 - 意见反馈。在反馈页描述问题、上传截图，并**勾选「上传日志」**后提交。

官方提示：日志仅用于排查问题，但可能包含对话记录、设备信息等数据，详情见官方隐私保护声明。

客户端完全打不开的情况下，官方文档给的支持邮箱是 workbuddy@tencent.com。

六、Windows 用户的一个额外优势

官方权限模式文档里列了三层保护：沙箱约束、删除保护、文件备份。其中文件备份这一层——修改已有文件前先存一份副本、新建文件不重复备份——目前只有 Windows 支持。

这是 Windows 侧独有的一层兜底。但要清楚它的边界：

• 它只在修改已有文件时生效，新建的文件不备份；
• 官方原话说得很清楚：默认权限不能替代备份。

所以该复制一份的还是要复制。有这层兜底，不等于可以直接把原始目录交出去。

七、官方文档没覆盖的

• 白屏（窗口起来了但一片空白）——FAQ 没有对应条目。装完之后启动就崩溃闪退同样不在这份安装 FAQ 里，那属于运行期问题，线索得从日志目录和更新日志里找。
• 安装错误码的含义——官方未列错误码表。
• 最低磁盘空间、内存要求——官方只写了系统版本。
• 静默安装、批量部署参数——官方未提供。
• 卸载步骤——官方未提供卸载指引。

这几类都走反馈路径，把系统版本、架构、现象截图一起提交。

小结

• 官方原话：WorkBuddy 常被误拦截——安全软件这一步优先处理，装完加白名单比反复退出实在。
• 系统要求 Windows 10+，一个 x64 包；ARM 设备有两处官方口径不一致，先用免费档试装。
• 三个目录：安装目录 AppData\Local\Programs\WorkBuddy（更新会清空）、工作空间 C:\Users\<用户名>\workbuddy、账号配置 %APPDATA%\CodeBuddyExtension。
• 登录卡住按 默认浏览器 →安全软件 → 目录权限 排；权限用 Get-Acl 先查，确认了再用管理员 PowerShell 跑 takeown / icacls。
• 日志：左上角「帮助」→「打开日志目录」。日志可能包含对话记录与设备信息。
• 文件备份这层保护只有 Windows 有，但它不能替代备份。

功能与命令以官方为准，核对日 2026-08-16。