💾WorkBuddy 数据备份与迁移新电脑 数据不丢的完整指南

🧭 一句话结论： WorkBuddy 的”灵魂”都装在 C:\Users\你的用户名\.workbuddy\ 这个隐藏文件夹里。换电脑时，只要把这个文件夹整体打包带走，再补上每个项目的 .workbuddy\ 子目录，最后在新电脑重装同版本客户端并覆盖回去，你的技能、记忆、自动化、MCP 配置和会话历史就全回来了。下面拆开讲。

---

一、数据都存在哪？

WorkBuddy 的数据分 两个层级，理解这一点是迁移成功的关键：

🗂️ 1.1 用户级数据目录（核心！）

路径：C:\Users\<你的用户名>\.workbuddy\（Mac/Linux 为 ~/.workbuddy/）。这是一台电脑上所有 WorkBuddy 数据的总仓库，包含：

• 🗄️ workbuddy.db —— 主数据库（自动化任务、运行时状态、会话索引等）
• 🧩 skills/ —— 你安装/自建的用户级技能
• 🧠 memory/ —— 跨项目记忆文件
• 🔌 mcp.json / .mcp.json —— MCP 服务器配置
• 🤖 experts/ —— 专家与专家团
• 🧱 plugins/ —— 已启用的插件
• 💬 sessions/ —— 历史对话会话
• ⚙️ settings.json —— 全局设置（可能含连接器明文凭据）
• 🪪 SOUL.md / USER.md / IDENTITY.md / MEMORY.md —— 身份与角色文件
• 📡 projects/ —— 各项目元数据

📁 1.2 项目级数据目录

路径：<你的项目根目录>\.workbuddy\。每个被 WorkBuddy 打开过的项目，都会在项目内生成一个 .workbuddy 文件夹，里面通常存放该项目的 memory/（项目记忆）和 automations/（项目级自动化）。只搬代码、漏掉这个文件夹，项目记忆和定时任务就丢了。

💿 1.3 应用本体（需重新安装）

客户端本身在 C:\Program Files\WorkBuddy（由自动更新器管理），不属于数据，换机时在新电脑重新安装同版本即可。binaries/ 里是托管的 Node/Python 运行时，首次运行会自动下载，备份时可跳过。

数据类型	位置	是否必备份	说明
🗄️ 主数据库	~/.workbuddy/workbuddy.db	必备份	自动化、会话索引等结构化数据
🧩 技能	~/.workbuddy/skills/	必备份	自定义/安装的技能
🧠 记忆	~/.workbuddy/memory/	必备份	跨项目长期记忆
🔌 MCP 配置	~/.workbuddy/mcp.json	必备份	外部服务连接
🤖 专家	~/.workbuddy/experts/	必备份	专家包
⚙️ 全局设置	~/.workbuddy/settings.json	必备份	⚠️ 含敏感凭据
💬 会话历史	~/.workbuddy/sessions/	建议	历史对话，体积可能较大
📁 项目数据	<项目>/.workbuddy/	按需	项目记忆与自动化
💿 运行时	~/.workbuddy/binaries/	可跳过	自动重新下载
📜 日志/追踪	logs/ traces/ usage-log.json	可跳过	排查用，非必要

---

二、备份清单与风险评估

✅ 必做： 整体复制 ~/.workbuddy 整个目录（除 binaries/、logs/、traces/ 可剔除以减小体积）。

✅ 按需： 复制每个重要项目的 .workbuddy 子目录。

🔒 敏感提醒： settings.json 与 mcp.json 可能含连接器 appSecret、appId 等明文凭据。备份包请加密压缩且仅通过可信渠道传输，切勿公开分享或上传公开仓库。

---

三、旧电脑：Step-by-Step 备份

① 🔚 彻底退出 WorkBuddy
右键托盘图标退出，或任务管理器结束进程，确保 workbuddy.db-wal 等临时文件已写入主库，避免复制到”半截”数据。

② 📂 复制用户级目录
图形化：在资源管理器地址栏输入 %USERPROFILE%\.workbuddy 回车，整文件夹复制到 U 盘或私有云盘。
命令行（PowerShell，剔除非必要项、打包加密）：

# 打包用户级数据（排除 binaries / logs / traces）
$src = "$env:USERPROFILE\.workbuddy"
$dest = "D:\Backup\workbuddy-user.zip"
Compress-Archive -Path $src -DestinationPath $dest `
  -CompressionLevel Optimal
# 建议再用 7z/WinRAR 加一层密码保护

③ 📁 复制项目级目录
对每个需要保留的项目，把项目根目录下的 .workbuddy 文件夹一并复制。

# 示例：批量收集某目录下所有项目的 .workbuddy
Get-ChildItem "G:\自媒体" -Recurse -Directory -Hidden -Filter ".workbuddy" |
  ForEach-Object { Copy-Item $_.FullName -Destination "D:\Backup\projects\$($_.Parent.Name)-workbuddy" -Recurse }

④ 📝 （可选）单独导出关键配置
为防万一，把 settings.json、mcp.json、SOUL.md、USER.md 单独另存一份明文副本，方便新机手动比对或重建。

⑤ 🔐 压缩并安全传输
用带密码的压缩包（7-Zip / WinRAR AES）封装，通过 U 盘、私有云盘或内网传输到新电脑。不要把含凭据的包丢进公开网盘或代码仓库。

---

四、新电脑：Step-by-Step 恢复

① 💿 安装同版本 WorkBuddy
从官网下载并安装与旧电脑相同或更高版本的客户端，安装到默认位置（C:\Program Files\WorkBuddy）。

② 🚪 首次启动后关闭
首次打开 WorkBuddy 让它生成初始 ~/.workbuddy 结构，然后完全退出，再进行覆盖，避免文件占用冲突。

③ 📥 覆盖粘贴用户级目录
把备份的 .workbuddy 解压，覆盖新电脑的 C:\Users\<新用户名>\.workbuddy\。若新用户名不同，路径照样是 %USERPROFILE%\.workbuddy，无需改内部路径。

# 覆盖恢复（先退出 WorkBuddy！）
Expand-Archive -Path "D:\Backup\workbuddy-user.zip" `
  -DestinationPath "$env:USERPROFILE\" -Force

④ 📁 还原项目级目录
把各项目的 .workbuddy 放回对应项目根目录，保持原有的项目文件夹结构。

⑤ 🔑 处理身份与重新登录
保留 settings.json/mcp.json 多数连接可免登录；首次打开仍建议逐个检查连接器状态，必要时重新授权一次。若旧机仍在使用，迁移完成后停用旧机，避免同一 device-id 双端冲突。

⑥ ✅ 验证
打开 WorkBuddy，确认：技能列表完整 🧩、记忆正常 🧠、自动化任务在列 ⏰、MCP 连接可用 🔌、历史会话可查 💬。一切正常即大功告成 🎉。

---

五、常见坑与注意事项

• 🔒 凭据明文： settings.json、mcp.json 可能含 appSecret 等，备份包务必加密，传输只用可信渠道。
• 💿 binaries 可省： Node/Python 运行时首次运行会自动下载，跳过它备份包能小很多。
• 🪪 device-id 冲突： 两台机器共用同一 device-id 与同步映射可能引发数据混乱，迁移属一次性操作，旧机建议停用。
• 📛 隐藏文件夹： .workbuddy 以点开头是隐藏目录，复制前在资源管理器开启”显示隐藏项目”。
• 🚫 别只拷 db： 只复制 workbuddy.db 会丢失技能、记忆、MCP 等，必须整体复制目录。
• 🔁 版本一致： 尽量同版本恢复，跨大版本若结构变更，先在新机空跑一次再覆盖更稳妥。

---

六、官方备份能力边界：哪些自动、哪些必须手动

先泼盆冷水：⚠️ WorkBuddy 目前没有「整机 / 全量云同步」。账号登录主要用于 Credits 共享、云端沙箱与 IM 远程派活，并不会把你的技能、记忆、MCP、会话等自动同步到云端。能”自动”的只有下面两类，且都不等于换机迁移：

🤖 6.1 官方自动备份：仅「自动化任务」（本地，非云）

WorkBuddy 会在 ~/.workbuddy\automation-backups\ 下自动生成每个自动化任务的 JSON 快照（本机实测 14 个，时间戳最新到当天）。作用是防止任务被误删 / 误改后丢失，属于本地安全网，不是跨设备云同步。

🗂️ 6.2 应用内「数据管理」面板：仅「已分享文件 + 已归档任务」

路径：头像 → 设置 → 数据管理。这里管理的是你分享出去的文件链接和归档的任务记录，数据跟随账号存在于云端，但与”把本机技能 / 记忆搬到新电脑”不是一回事。

📊 6.3 官方能备份 vs 必须手动备份（一图看清）

数据类型	官方自动 / 云？	换机怎么处理
⏰ 自动化任务	✅ 本地自动快照（automation-backups/）	随 ~/.workbuddy 一起拷贝即可，快照自动带上
🗂️ 已分享文件 / 已归档任务	☁️ 账号云端（数据管理面板）	登录同账号自动可见，无需手动搬
🧩 技能 skills/	❌ 不自动	🔧 必须手动复制
🧠 记忆 memory/	❌ 不自动	🔧 必须手动复制
🔌 MCP 配置 mcp.json	❌ 不自动	🔧 必须手动复制
🤖 专家 experts/	❌ 不自动	🔧 必须手动复制
🧱 插件 plugins/	❌ 不自动	🔧 必须手动复制
💬 会话历史 sessions/	❌ 不自动	🔧 必须手动复制
⚙️ 设置 settings.json（含凭据）	❌ 不自动	🔧 必须手动复制
📁 项目级 .workbuddy/	❌ 不自动	🔧 必须手动复制

⏰ 6.4 自己动手做「自动备份」

既然官方不兜底，用系统任务计划程序每天把 ~/.workbuddy 打包到私有云盘最稳妥：

robocopy "%USERPROFILE%\.workbuddy" "D:\Backup\workbuddy" /MIR /XD binaries logs traces

💡 把命令放进 .bat，用任务计划程序设为每天凌晨运行，即可无痛自动备份。注意备份包含 settings.json 等凭据，压缩包务必加密。

---

七、FAQ 问答对

🤔 WorkBuddy 的数据存在哪个文件夹？
分两处：用户级在 C:\Users\<用户名>\.workbuddy\（含 workbuddy.db、skills、memory、mcp.json、sessions、settings.json 等）；项目级在每个项目根目录的 .workbuddy\。应用本体在 C:\Program Files\WorkBuddy，需重装。

🤔 只复制 workbuddy.db 够吗？
不够。数据库只存结构化数据，技能、记忆、MCP 配置、专家、插件和身份文件都在同级子目录与独立文件里，必须整体复制 ~/.workbuddy 才完整。

🤔 迁移时需要重新登录吗？
若连同 settings.json 与 mcp.json 一起复制，多数连接器凭据会被保留，通常免登录；但建议首次恢复后逐个检查连接器，必要时重新授权。

🤔 binaries 文件夹要备份吗？
可跳过。它是托管的 Node/Python 运行时，体积大且首次运行新机会自动下载，不影响数据迁移。

🤔 两台电脑同时用同一份数据会冲突吗？
迁移是一次性操作，建议在旧机停用 WorkBuddy，避免共用 device-id 与同步映射造成混乱。官方目前没有整机云同步，若需多端持续使用，应自行用私有云盘 + robocopy 方案，并注意同一 device-id 不要双开。

🤔 settings.json 里有明文密码吗？
可能含连接器 appSecret、appId 等明文凭据。备份包请加密且仅经可信渠道传输，切勿公开分享。

🤔 项目里的 .workbuddy 也要搬吗？
想保留该项目的历史记忆与自动化任务，就需要连项目根目录下的 .workbuddy 一起复制，否则这些会丢失。

🤔 WorkBuddy 有官方云同步能一键迁移吗？
没有整机 / 全量云同步。 官方仅做两类：① 自动化任务的本地自动快照（~/.workbuddy\automation-backups\，不是云）；② 应用内「数据管理」面板只管已分享文件与已归档任务（跟随账号云端）。除此之外，技能、记忆、MCP 配置、专家、插件、会话历史、设置、项目数据全部需要手动复制 ~/.workbuddy 与项目 .workbuddy 才能迁移。

---

🙋‍♂️ 疯狂的豇豆是谁？
我是 疯狂的豇豆，一位专注 AI 转型 的教练 🚀
📌 深耕 AI 在商业、营销、内容创作领域的应用
📌 帮助传统企业和个人实现 AI 赋能的数字化转型
📌 定期分享 AI 实战经验、工具评测、行业洞察

疯狂的豇豆工作QQ：22078369
如果你也在思考 “AI 能给我的工作/业务带来什么改变”，欢迎关注我，一起探索 AI 的无限可能！