WorkBuddy 的文件都存在哪？五个官方路径一次说清，重装前先看这篇
「我的文件去哪了」和「更新怎么把东西弄没了」，这两个问题的根子是同一个：WorkBuddy 的东西分散在几个不同的目录里，而其中一个在更新时会被整个清空。
搞清楚这张目录地图，能一次性避开好几类坑。下面把官方文档里出现过的路径全部汇总，标明每个目录装什么、动它安不安全。
本文依据 WorkBuddy 官方常见问题页
From-Beginner-to-Expert-Guide/FAQ中给出的路径说明，核对日 2026-08-16。我们没有安装客户端，路径以官方文档和你实际看到的为准。
一、目录地图
| # | 目录 | Windows | macOS | 更新时 |
|---|---|---|---|---|
| 1 | 程序安装目录 | C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy | /Applications/WorkBuddy.app | 会被清空重写 |
| 2 | WorkBuddy 大文件夹 | C:\Users\<用户名>\workbuddy | /Users/用户名/WorkBuddy | 不动 |
| 3 | 账号配置目录 | %APPDATA%\CodeBuddyExtension | ~/Library/Application Support/CodeBuddyExtension | 不动 |
| 4 | 日志目录 | 「帮助」→「打开日志目录」 | 「帮助」→「打开日志文件夹」 | — |
| 5 | 你自己指定的工作空间 | 你建在哪就在哪 | 同左 | 取决于位置 |
下面逐个说。
二、程序安装目录：唯一一个会被清空的
这个目录是所有麻烦的来源。 官方在讲更新问题时说明了原因：
更新或重装时，安装目录会清空并重新写入文件。
快速定位：在 WorkBuddy 图标上右键 →「打开文件所在位置」。
进去之后，官方说明这个目录下通常有这几个文件夹：
bin
locales
resources
tools
_
如果更新时提示「检测到应用安装目录下存在用户项目目录」，官方给的处理方式是：移除对话产生的文件夹，仅保留 bin、locales、resources、tools；同时检查是否有个人文件并一并移走，防止被覆盖。然后重新打开客户端，点上方 WorkBuddy → 检查更新。
也就是说，除了那四个文件夹之外的东西——以日期命名的文件夹、你自己起名的项目文件夹、生成的文档——都不该待在这里。
一条动手前的建议（官方没写，但成本极低）：整个安装目录先复制一份到别处再动手。第三步要靠你自己判断哪些是「对话产生的」，判断错了有备份就是几分钟的事。
Windows 用户注意 AppData 是隐藏文件夹，要么在资源管理器「查看」里勾「隐藏的项目」，要么直接在地址栏粘贴路径。
三、WorkBuddy 大文件夹：找回历史记录的地方
官方 FAQ 里有一条现象：升级或隔天重启后，原工作空间文件夹在界面里消失。有的用户能在这个目录下找到历史文件夹但文件有缺失，也有用户整个目录都不见。
官方给的做法是：打开文件管理器（Windows）或 Finder（Mac），找到 WorkBuddy 大文件夹——
- Windows：
C:\Users\<用户名>\workbuddy - Mac：
/Users/用户名/WorkBuddy
通过 WorkBuddy 打开以日期或用户自定义名字命名的文件夹，即可找回原有历史记录。
官方在这一条后面还跟了一句建议，值得当成习惯：将重要文件同步保存到独立目录。
意思是别把唯一一份重要文件只留在 WorkBuddy 的工作区里。这个建议跟官方在别处反复说的那句是一脉相承的——默认权限降低误操作风险，但不能替代备份。
四、账号配置目录：登录失败的元凶
这个目录名字跟产品名对不上（叫 CodeBuddyExtension），所以很多人根本不知道它的存在。但登录失败里最难查的那一类，问题就出在它身上。
- Windows：
%APPDATA%\CodeBuddyExtension - Mac：
~/Library/Application Support/CodeBuddyExtension
官方在「无法登录」那一节给的三类原因里，第三类就是「账号文件夹没有操作权限」，检查和授权命令操作的都是这个目录。典型特征是：浏览器那边验证成功了，回到客户端还是未登录状态。
Mac 检查：
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/
Windows 检查（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
从路径结构能看出来它的分层：Data/Public/auth 这一层放的是认证相关的东西。权限不对，登录状态就写不进去。
别随手删这个目录。 它不在「更新会清空」的范围里，删了等于清掉本地账号状态。
五、日志目录：提工单的时候要用
官方给的取法：
- Mac：WorkBuddy → 顶部「帮助」→「打开日志文件夹」，里面是日志
.zip包； - Windows：左上角「帮助」下拉框 →「打开日志目录」，其中的压缩包就是日志。
一条必须知道的提示，官方原文写明：日志仅用于排查问题，但可能包含对话记录、设备信息等数据，详情见官方隐私保护声明。
所以发日志之前，心里对自己最近处理过什么内容有个数。涉及客户资料、财务数据的，在反馈描述里说明一下更稳妥。
六、你自己的工作空间：唯一你能决定的
前面四个是官方定的，这一个由你决定，也最值得花心思。
工作空间就是当前任务主要读写文件的那个文件夹。官方在权限模式文档里建议每类任务建独立文件夹，并给了四个命名示例：
weekly-report
invoice-archive
customer-data-cleanup
batch-image-processing
三条位置红线：
- 别建在安装目录里——更新会清空它，这是本文开头那类事故的直接原因。
- 别建在桌面——官方 FAQ 里有一条讲「整理桌面后出现文件丢失」的高风险场景，把作业范围直接放桌面是给自己找麻烦；官方在权限模式文档里也把「工作空间靠近桌面、下载、个人文档根目录」列为不该开完全访问的情形之一。
- 别直接用原始资料目录——官方建议是在任务文件夹里放副本，不是把原件所在的目录整个交出去。
顺带说一条容易踩的：官方 FAQ 里提到，在电脑端新建任务时不建议把「助理」作为工作空间——助理是给远程控制用的，而且助理工作空间里只有最近产生对话的任务会在「助理」里展示，其他任务只在工作空间列表里能看到。用错了会出现「历史会话找不到」的错觉。
七、重装或换电脑之前，按这个顺序来
- 先把工作成果移出去。第 2 个目录（WorkBuddy 大文件夹）和你自己建的工作空间，复制到一个跟 WorkBuddy 无关的位置。
- 确认安装目录里没有你的东西。第 1 个目录，除了
bin、locales、resources、tools之外的都检查一遍。 - 需要保留登录状态的话，别动第 3 个目录；想彻底清干净重来，才考虑处理它。
- 有待处理的问题就先取日志。重装之后日志就没了。
关于卸载，需要说清楚：官方文档没有提供卸载步骤指引。 上面这张目录地图能帮你判断残留可能在哪，但具体怎么卸载干净，官方没写，我们也不编。有彻底清理需求的话，走官方反馈路径问一下更稳妥。
小结
- 五个位置：程序安装目录、WorkBuddy 大文件夹、账号配置目录（
CodeBuddyExtension）、日志目录、你自己的工作空间。 - 只有程序安装目录会在更新时被清空，且只保留
bin、locales、resources、tools。 - 界面里工作空间不见了 → 去
C:\Users\<用户名>\workbuddy（Mac/Users/用户名/WorkBuddy）找日期或自定义命名的文件夹。 - 浏览器验证过了还登不上 → 查
CodeBuddyExtension的目录权限。 - 日志可能包含对话记录与设备信息，提交前有个数。
- 工作空间三条红线：别在安装目录、别在桌面、别直接用原始资料目录。
- 官方文档未提供卸载指引，本文不编。
功能与路径以官方为准，核对日 2026-08-16。