☰
AI工具WorkBuddy篇:8_换电脑后,数据如何迁移
2026/10/8 23:36:21 网站建设 项目流程

本教程面向完全没接触过文件迁移的新手,手把手教你把旧电脑上的 WorkBuddy(含全部记忆、人格、技能、项目数据)完整搬到新电脑,做到“换电脑不换魂”。请按顺序从头读到尾,再动手操作。

一句话总览

迁移 = 复制 3 个隐藏文件夹 + 1 个项目目录 → 粘贴到新电脑对应位置 → 改路径 → 验证。核心是.workbuddy目录,那是 WorkBuddy 的全部记忆和人格所在。

一、教程导读:先认识 WorkBuddy 与“为什么要迁移”

1.1 WorkBuddy 是什么?

WorkBuddy 是腾讯出品的全场景 AI 智能体桌面工作台(由腾讯云 CodeBuddy 团队开发)。它住在你的电脑里,能“听懂人话、带脑子思考、真正操作本地文件”——自动批量处理文件、生成文档/表格/PPT、数据分析、远程办公等。它最大的特点是:它的记忆、人格、技能都存在你的本地电脑上,而不是云端。

1.2 为什么换电脑后必须手动迁移?

这是最关键的认知点,90% 的人在这里踩坑:账号登录 ≠ 数据迁移。

WorkBuddy 的数据分两层:第一层是“账号配置”(你登录的账号、绑定的平台),这个会跟着账号走,换电脑登录就有了;第二层是“记忆与任务”(你的工作日志、人格定义、技能包、自动化任务配置),这些全部存在本地磁盘,账号登录不会把它们带走。

最容易踩的坑

很多人以为“新电脑装好 WorkBuddy、登录同一账号”就万事大吉了,结果发现:AI 失忆了、技能没了、定时任务空了。原因就是本地数据没搬过来。

1.3 本教程适合谁?

  • 换新电脑、想保留 WorkBuddy 全部记忆与技能的个人用户
  • Windows 系统升级换机(Win10→Win11,或换台新机器)
  • 之前从没用过命令行、没动过隐藏文件夹的纯新手
  • 想把 WorkBuddy 数据从 C 盘搬到其他盘的用户(见第九章进阶)

如果你是 Mac 用户,原理相同,但路径改为/Users/你的用户名/.workbuddy,命令行用终端即可。本教程以 Windows 为主进行图文讲解。

二、迁移原理:搞清楚要带走什么、留下什么

概念示意图

2.1 WorkBuddy 的三层数据模型

在动手前,花 2 分钟理解 WorkBuddy 数据的“三层结构”,你就明白为什么要搬这些东西了:

层数内容存放位置能否迁移
第一层对话记录(jsonl 文件)%USERPROFILE%\.workbuddy\projects\✅ 核心必迁
第二层会话索引/元数据(sessions.json、workbuddy.db).workbuddy\目录内✅ 必迁
第三层记忆/人格文件(MEMORY.md、IDENTITY.md、SOUL.md).workbuddy\与项目.workbuddy\✅ 必迁

简单说:你跟 AI 聊过的每一句话、AI 记住你的每件事、AI 学会的每个技能,都在本地磁盘上。搬走这些文件,AI 就“还是那个 AI”。

2.2 会带走 vs 不会带走(对照表)

项目会不会自动跟到新电脑需要怎么处理
登录账号 / 绑定的平台✅ 会(云端同步)新电脑登录同一账号即可
AI 记忆 / 人格(SOUL/IDENTITY/USER)❌ 不会复制.workbuddy目录
已安装技能(skills)❌ 不会复制.workbuddy\skills
技能商店 SkillHub❌ 不会复制.skillhub目录
项目工作记忆❌ 不会复制项目下.workbuddy
自动化定时任务❌ 不会用“导出/导入”重建(见第八章)
MCP 服务 Token(如金山文档)⚠️ 随文件走,但属个人凭证迁过去即有效,或重新授权
ima 笔记等云端内容✅ 会(云端)登录同账号自动同步

记住这句话

迁移的本质:把本地的 4 个位置整包带走,放到新电脑相同结构的位置,再修正路径。文件它认,路径它不认。

2.3 整体迁移流程图

旧电脑:完全退出 WorkBuddy

↓

旧电脑:显示隐藏文件夹,定位 4 个目录

↓

旧电脑:复制 4 个目录到 U盘/移动硬盘/网盘

↓

新电脑:安装 WorkBuddy + Python + 微信(如需)

↓

新电脑:把 4 个目录粘贴回对应位置

↓

新电脑:修正用户名/盘符变化的路径

↓

新电脑:启动 WorkBuddy,验证“你还记得我吗”

↓

重新创建定时任务 / 重新授权 MCP(如需要)

三、迁移前的准备工作(很重要,别跳过)

3.1 工具准备

  • 备份介质:U 盘、移动硬盘,或网盘(百度网盘/夸克/OneDrive 任选其一)。建议总容量 ≥ 2GB。
  • 新电脑:已联网,能正常上网下载软件。
  • 一张纸/记事本:用来记录旧电脑和新电脑的“用户名”“项目路径”,后面要用。

3.2 关键信息确认(请先记录下来)

请打开记事本,把下面 4 个信息查清楚并记下来,后面步骤会反复用到:

信息项怎么查示例
旧电脑 Windows 用户名打开C:\Users\看到的文件夹名Administrator
新电脑 Windows 用户名同上zhangxinbin
旧电脑项目路径你平时让 AI 干活的工作目录E:\claw
新电脑项目路径(计划)新电脑打算放项目的目录D:\claw

为什么要记这个

WorkBuddy 内部很多文件里写死了绝对路径(如E:\claw\stock_tracker.py)。如果新电脑用户名或盘符变了,这些路径会失效,必须批量替换。提前记录能省掉后面大量排查时间。

3.3 完全退出 WorkBuddy(必做)

在旧电脑上,必须完全退出 WorkBuddy,否则复制时文件被占用,会提示“文件正在使用”导致复制失败或数据不完整。

  1. 点击窗口右上角的 × —— 这只是最小化,还没退出!
  2. 找到屏幕右下角任务栏(时间旁边)的 WorkBuddy 小图标。
  3. 右键点击该图标 → 选择「退出」。
  4. 确认图标消失后,才算真正退出。

常见错误

只点 × 不算退出。一定要到右下角托盘图标右键 → 退出。这一步漏了,复制会报错。

四、核心:需要迁移的 4 个位置(最重要的一章)

概念示意图

WorkBuddy 的“灵魂”分散在 4 个位置,迁移时全部都要带走,缺一不可。下面逐一讲解每个位置里装了什么。

位置 1:用户级身份目录 .workbuddy(最重要)

路径:C:\Users\你的用户名\.workbuddy\

这是 WorkBuddy 的“大脑”,决定了“我是谁”和“你是谁”。换电脑后必须恢复,否则 AI 会失忆。里面关键文件:

文件作用迁移注意
SOUL.mdAI 的性格定义(通用)可直接迁
IDENTITY.mdAI 是谁的身份卡可直接迁
USER.md关于你的信息可直接迁
BOOTSTRAP.md首次启动引导迁过去后可删除,触发重新初始化
mcp.jsonMCP 服务配置(金山文档等)含 Token,迁过去即生效
settings.json全局设置可直接迁
projects\所有对话记录(jsonl)核心!必迁

小知识

.workbuddy前面有个点,表示它是隐藏文件夹,默认在资源管理器里看不到。下一章教你怎么显示它。

位置 2:已安装技能 .workbuddy\skills

路径:C:\Users\你的用户名\.workbuddy\skills\

你手动安装的所有技能都在这里(如 kdocs、ddg-web-search 等)。这是 WorkBuddy 的“核心价值”——技能直接复制就能用,不用重新安装。

位置 3:技能商店 SkillHub .skillhub

路径:C:\Users\你的用户名\.skillhub\

技能商店客户端,包含:

  • config.json—— 商店配置
  • skills_store_cli.py—— 商店命令行客户端
  • skills_upgrade.py—— 技能升级脚本
  • version.json—— 版本信息

位置 4:项目工作记忆(项目级 .workbuddy)

路径:你的项目路径\.workbuddy\(例如E:\claw\.workbuddy\)

这是你所有项目的积累——标准查询经验、股票系统、PPT 生成流程等都在这里。里面包含:

  • memory\—— 多个日记文件 +MEMORY.md长期记忆(硬编码路径最多的文件)
  • settings.local.json—— 项目本地设置
  • plans\—— 历史计划
  • expert-history.json—— 专家历史

4 个位置总览表(迁移时对照勾选)

序号位置旧电脑路径示例重要性
1用户身份目录C:\Users\Administrator\.workbuddy\★★★★★
2已安装技能C:\Users\Administrator\.workbuddy\skills\★★★★★(含在 1 内)
3技能商店C:\Users\Administrator\.skillhub\★★★★☆
4项目工作记忆E:\claw\.workbuddy\★★★★★

总结

实际上你要复制的是 3 个隐藏文件夹(.workbuddy、.skillhub、项目下的.workbuddy)+ 1 个项目目录(如果项目文件也在本地)。

五、第一阶段:旧电脑打包备份

5.1 第一步:显示隐藏文件夹(图文步骤)

因为.workbuddy、.skillhub是隐藏文件夹,必须先让它们“现形”才能复制。

  1. 打开「文件资源管理器」(快捷键Win + E)。
  2. 进入任意一个文件夹(比如 C 盘)。
  3. 点击顶部菜单栏的「查看」选项卡。
  4. 在右侧找到「隐藏的项目」并勾选它。
  5. Win11 用户:点击「查看」→「显示」→ 勾选「隐藏的项目」。

勾选后,你在C:\Users\你的用户名\下就能看到.workbuddy、.skillhub这些半透明的文件夹了。

5.2 第二步:定位 4 个目录

在资源管理器地址栏直接粘贴下面路径(把“你的用户名”换成实际的),逐个确认能打开:

C:\Users\你的用户名\.workbuddy C:\Users\你的用户名\.skillhub 你的项目路径\.workbuddy 例如:E:\claw\.workbuddy

小技巧

在资源管理器地址栏输入%USERPROFILE%按回车,能直接跳到你的用户目录C:\Users\你的用户名\,不用手打用户名。

5.3 第三步:复制到备份介质

  1. 插上 U 盘 / 移动硬盘(或打开网盘客户端)。
  2. 在备份介质里新建一个文件夹,命名为WorkBuddy备份_日期(如WorkBuddy备份_20260730)。
  3. 把上面 3 个目录整个复制进这个文件夹:.workbuddy、.skillhub、项目的.workbuddy。
  4. 如果你项目本身(如E:\claw下的脚本、数据)也要带走,把整个项目文件夹也复制进去。
  5. 复制完成后,逐个右键 → 属性,对比新旧位置的“大小”和“包含文件数”,确保一致,没漏文件。

务必核对

复制大文件夹时偶尔会跳过被占用的文件。一定要对比“文件数”是否一致。如果不一致,说明 WorkBuddy 没完全退出,回到 3.3 步骤重来。

六、第二阶段:新电脑安装基础环境

在还原文件之前,新电脑要先把 WorkBuddy 跑起来需要的“地基”打好。

6.1 安装 WorkBuddy 客户端

  1. 浏览器打开官网 https://www.workbuddy.cn/
  2. 点击「立即下载」,选择你的系统版本(Windows x64 最常见)。
  3. 下载完成后双击安装包,一路「下一步」即可。
  4. 安装完成后先不要启动(或者启动登录一次再退出),等会儿还原文件后再正式启动。

为什么要先装再还原

先安装 WorkBuddy,它会在新电脑生成必要的目录结构和注册表项;再覆盖还原你的备份,就能无缝接管。

6.2 安装 Python(如果你用到了脚本)

如果你旧电脑上有让 AI 跑 Python 脚本(如定时任务脚本),新电脑也要装 Python,且版本和路径最好一致,否则脚本里的 Python 路径会失效。

  1. 去 https://www.python.org/downloads/ 下载 Python 3.13(或与旧电脑相同版本)。
  2. 安装时务必勾选「Add Python to PATH」。
  3. 建议安装到默认路径C:\Program Files\Python313\,与旧电脑保持一致。
  4. 安装后打开 cmd,输入python --version确认可用。

6.3 安装微信(如果你用 IM 远程控制)

如果你之前用微信远程操控 WorkBuddy,新电脑也要装微信,并装到和旧电脑相同路径:

推荐路径:C:\Program Files\Tencent\Weixin\Weixin.exe

路径不一致的话,相关自动化脚本里的微信路径要改(见第七章)。

七、第三阶段:新电脑还原文件

7.1 显示隐藏文件夹

在新电脑上重复 5.1 步骤,勾选「隐藏的项目」,让.workbuddy等文件夹可见。

7.2 粘贴回对应位置

把备份介质里的 3 个目录,按原结构粘贴回新电脑:

备份里的目录粘贴到新电脑的位置
.workbuddyC:\Users\新用户名\.workbuddy\
.skillhubC:\Users\新用户名\.skillhub\
项目的 .workbuddy新项目路径\.workbuddy\ 例如 D:\claw\.workbuddy\

用户名不同的关键处理

如果新旧电脑用户名不同(如旧是 Administrator,新是 zhangxinbin),粘贴时路径里的用户名要换成新的。例如旧的C:\Users\Administrator\.workbuddy要粘贴到新的C:\Users\zhangxinbin\.workbuddy。目录名 `.workbuddy` 本身不能改,只改外层用户名。

7.3 如果新电脑已有同名目录

如果你之前在新电脑启动过 WorkBuddy,.workbuddy目录可能已存在(里面是空的默认数据)。处理方法:

  1. 把新电脑上现有的.workbuddy重命名为.workbuddy.bak(留个备份,以防万一)。
  2. 再把备份里的.workbuddy粘贴进来。
  3. 确认无误后,可删除.workbuddy.bak。

八、第四阶段:处理路径变化(最容易翻车的一步)

文件搬过来了,但里面的路径还是旧电脑的。如果你的用户名或盘符变了,必须做这一步,否则 AI 会“找不到文件”。

8.1 哪些情况需要改路径?

情况要不要改路径改哪些
新旧用户名相同 + 盘符相同❌ 不用改—
用户名不同(Administrator→zhangxinbin)✅ 必改所有含旧用户名的路径
盘符变化(E盘→D盘)✅ 必改MEMORY.md 等文件里的盘符
项目路径变化(E:\claw→D:\claw)✅ 必改项目相关绝对路径

8.2 批量替换 MEMORY.md 里的路径

MEMORY.md是硬编码路径最多的文件,必须重点处理:

  1. 用记事本(或 VS Code)打开新项目路径\.workbuddy\memory\MEMORY.md。
  2. 按Ctrl + H打开“替换”功能。
  3. “查找内容”填旧路径,如E:\claw;“替换为”填新路径,如D:\claw。
  4. 点击「全部替换」。
  5. 再替换一次用户名:查找C:\Users\Administrator,替换为C:\Users\zhangxinbin。
  6. 保存文件(Ctrl + S)。

推荐用 VS Code

VS Code 的替换支持“区分大小写”“正则”,批量改路径最稳。记事本也行,但要逐个查找。

8.3 检查脚本里的硬编码路径

除了 MEMORY.md,下面这些脚本里也可能写死了旧路径,需要逐个打开检查并替换:

  • stock_tracker.py(或你的定时任务脚本)
  • gen_pptx.py(PPT 生成脚本)
  • run.bat(启动批处理)
  • MEMORY.md 中记录的所有绝对路径

方法:用 VS Code 打开整个项目文件夹 →Ctrl + Shift + F全局搜索旧路径(如E:\claw)→ 在搜索结果里逐个替换为新路径。

8.4 检查 mcp.json 里的路径

打开C:\Users\新用户名\.workbuddy\mcp.json,检查里面是否有写死的旧路径(如微信路径、Python 路径),如有则替换为新电脑的实际路径。

路径替换的黄金法则

只替换“路径前缀”,不要动文件内容逻辑。比如把E:\claw换成D:\claw,把Administrator换成zhangxinbin。替换后最好用搜索功能再扫一遍,确认没有遗漏的旧路径。

九、第五阶段:验证迁移是否成功

概念示意图

9.1 启动 WorkBuddy

  1. 双击桌面 WorkBuddy 图标启动。
  2. 登录你的账号(与旧电脑同一个账号)。
  3. 等待初始化完成(首次启动可能稍慢,它在读取记忆文件)。

9.2 灵魂三问验证法

启动后,跟 AI 说下面三句话,验证记忆是否恢复:

你问正常反应(迁移成功)异常反应(迁移失败)
你还记得我吗?能叫出你的名字、说出你在做的事像第一次见面,啥都不知道
我之前在做什么项目?能说出项目细节、进度一片空白
帮我用 XX 技能做件事技能可用,正常执行提示技能不存在

9.3 完整性校验清单

  • projects\目录下的 jsonl 对话记录能正常加载、能翻看历史对话
  • skills\目录下技能数量与旧电脑一致,技能可调用
  • sessions.json里的会话数量与实际对话记录相符
  • 自动化任务触发条件在新环境仍有效(见下一章)

校验失败怎么办

如果任何一项校验失败,先回滚:删除新目录,从备份重新还原,再仔细检查路径替换。不要在错误状态上硬改。

十、需要重新配置的内容(文件搬不走的)

10.1 重新创建 Windows 定时任务

Windows 任务计划程序里的定时任务不会跟着文件走,必须在新电脑重新创建。方法:

  1. 在旧电脑打开「任务计划程序」,逐个记录每个定时任务的:名称、触发时间、执行的脚本路径、参数。
  2. 在新电脑打开「任务计划程序」(Win+R 输入taskschd.msc)。
  3. 点「创建基本任务」,按记录逐个重建。
  4. 注意:脚本路径要填新电脑的路径(如D:\claw\run.bat)。

更聪明的办法

直接对 WorkBuddy 说“导出自动化任务”,它会自动列出所有任务、扫描敏感信息、生成 JSON 文件。新电脑上说“导入自动化任务”,它会逐条校验、重建任务、并警告路径不匹配的地方。这比手动重建省事得多。

10.2 重新授权 MCP 服务(如需要)

如果mcp.json里的 Token(如金山文档)迁过去后失效,重新走一遍授权流程即可。Token 是跟账号绑定的,换电脑不影响额度,但可能需要重新点一次授权。

十一、进阶:用符号链接把 WorkBuddy 搬到其他盘(可选)

WorkBuddy 默认把数据放 C 盘,用久了 C 盘会满。可以用“目录符号链接(mklink /J)”把数据实际存到 D 盘,C 盘只留一个“快捷方式”,C 盘不占空间但程序照常访问。

  1. 完全退出 WorkBuddy(右下角托盘图标右键 → 退出)。
  2. 把C:\Users\你的用户名\.workbuddy剪切到 D 盘,如D:\Workbuddy_related\.workbuddy。
  3. 同样把.workbuddy-key-fallback(如果有)也剪切过去。
  4. 以管理员身份打开 cmd(开始菜单搜 cmd → 右键 → 以管理员身份运行)。
  5. 执行下面两条命令创建符号链接(用户名和路径换成你的):
mklink /J "C:\Users\你的用户名\.workbuddy" "D:\Workbuddy_related\.workbuddy" mklink /J "C:\Users\你的用户名\.workbuddy-key-fallback" "D:\Workbuddy_related\.workbuddy-key-fallback"

执行成功后,C:\Users\你的用户名\下会出现两个带“快捷方式”小箭头的文件夹,双击能正常打开,C 盘不占真实空间。

原理

mklink /J创建的是“目录联接”,对程序完全透明——程序以为文件还在 C 盘,实际数据在 D 盘。这是 Windows 自带功能,无需安装任何软件。

十二、常见问题 FAQ

Q1:复制时提示“文件正在使用,无法复制”怎么办?

说明 WorkBuddy 没完全退出。回到旧电脑,右下角托盘图标右键 → 退出,等图标消失后再复制。也可以在任务管理器(Ctrl+Shift+Esc)里结束所有 WorkBuddy 进程。

Q2:新电脑启动后 AI 完全失忆,像第一次用?

99% 是文件没放对位置。检查:①.workbuddy是否在C:\Users\新用户名\下(不是其他位置);② 目录名是否正确(是.workbuddy不是workbuddy,前面有点);③ 隐藏文件夹是否显示出来了,别粘错地方。

Q3:用户名不同,直接复制过去行不行?

可以复制,但路径要换。.workbuddy要放到新用户名目录下,且 MEMORY.md 等文件里的旧用户名路径要批量替换(见第八章)。

Q4:直接拷 workbuddy.db 数据库到新电脑行吗?

不行。数据库绑定的是旧电脑的硬件指纹和软件环境,换台电脑直接读不了,还可能报错把两边都搞崩。自动化任务要用“导出/导入”方式重建(见第十章)。

Q5:跨平台(Windows→Mac)怎么迁?

纯文件拷贝在跨平台场景下不适用(路径映射失效)。需用 WorkBuddy 的「设置 → 数据管理 → 导出全部数据」生成结构化备份包(需 v2.4.0 及以上版本),在新电脑导入。

Q6:迁过去后技能用不了怎么办?

检查.workbuddy\skills\目录是否完整复制,技能文件夹数量是否与旧电脑一致。部分技能依赖 Python 包,需在新电脑pip install对应依赖。

Q7:备份文件能长期保留吗?

可以,建议每次大版本升级或重大调整前都备份一份。备份就是普通文件夹,放哪都行,但注意里面有 Token 等敏感信息,不要传到公开网盘分享链接。

十三、迁移清单 Checklist(打印对照执行)

把下面这张表打印出来或抄在纸上,每做完一步打勾,确保不遗漏:

阶段步骤完成
准备记录新旧电脑用户名、项目路径☐
准备旧电脑完全退出 WorkBuddy(托盘右键退出)☐
准备新电脑显示隐藏文件夹☐
打包复制 .workbuddy 到备份介质☐
打包复制 .skillhub 到备份介质☐
打包复制项目 .workbuddy 到备份介质☐
打包复制项目文件(如需)到备份介质☐
打包对比文件数,确认无遗漏☐
安装新电脑安装 WorkBuddy 客户端☐
安装新电脑安装 Python(如需)☐
安装新电脑安装微信(如需)☐
还原粘贴 .workbuddy 到新用户名目录☐
还原粘贴 .skillhub 到新用户名目录☐
还原粘贴项目 .workbuddy 到新项目路径☐
改路径批量替换 MEMORY.md 里的旧路径☐
改路径检查并替换脚本里的硬编码路径☐
改路径检查 mcp.json 里的路径☐
验证启动 WorkBuddy,登录账号☐
验证灵魂三问验证记忆恢复☐
验证完整性校验(对话/技能/会话数)☐
重配重建 Windows 定时任务☐
重配重新授权 MCP(如需)☐

附录:路径速查表

内容Windows 路径Mac 路径
用户身份目录C:\Users\用户名\.workbuddy\/Users/用户名/.workbuddy/
对话记录C:\Users\用户名\.workbuddy\projects\/Users/用户名/.workbuddy/projects/
技能目录C:\Users\用户名\.workbuddy\skills\/Users/用户名/.workbuddy/skills/
技能商店C:\Users\用户名\.skillhub\/Users/用户名/.skillhub/
项目记忆项目路径\.workbuddy\项目路径/.workbuddy/
长期记忆项目路径\.workbuddy\memory\MEMORY.md项目路径/.workbuddy/memory/MEMORY.md
任务计划程序taskschd.msc系统偏好→用户与群组→登录项

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询