本教程面向完全没接触过文件迁移的新手手把手教你把旧电脑上的 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否则复制时文件被占用会提示“文件正在使用”导致复制失败或数据不完整。点击窗口右上角的 × —— 这只是最小化还没退出找到屏幕右下角任务栏时间旁边的 WorkBuddy 小图标。右键点击该图标 → 选择「退出」。确认图标消失后才算真正退出。常见错误只点 × 不算退出。一定要到右下角托盘图标右键 → 退出。这一步漏了复制会报错。四、核心需要迁移的 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是隐藏文件夹必须先让它们“现形”才能复制。打开「文件资源管理器」快捷键Win E。进入任意一个文件夹比如 C 盘。点击顶部菜单栏的「查看」选项卡。在右侧找到「隐藏的项目」并勾选它。Win11 用户点击「查看」→「显示」→ 勾选「隐藏的项目」。勾选后你在C:\Users\你的用户名\下就能看到.workbuddy、.skillhub这些半透明的文件夹了。5.2 第二步定位 4 个目录在资源管理器地址栏直接粘贴下面路径把“你的用户名”换成实际的逐个确认能打开C:\Users\你的用户名\.workbuddy C:\Users\你的用户名\.skillhub 你的项目路径\.workbuddy 例如E:\claw\.workbuddy小技巧在资源管理器地址栏输入%USERPROFILE%按回车能直接跳到你的用户目录C:\Users\你的用户名\不用手打用户名。5.3 第三步复制到备份介质插上 U 盘 / 移动硬盘或打开网盘客户端。在备份介质里新建一个文件夹命名为WorkBuddy备份_日期如WorkBuddy备份_20260730。把上面 3 个目录整个复制进这个文件夹.workbuddy、.skillhub、项目的.workbuddy。如果你项目本身如E:\claw下的脚本、数据也要带走把整个项目文件夹也复制进去。复制完成后逐个右键 → 属性对比新旧位置的“大小”和“包含文件数”确保一致没漏文件。务必核对复制大文件夹时偶尔会跳过被占用的文件。一定要对比“文件数”是否一致。如果不一致说明 WorkBuddy 没完全退出回到 3.3 步骤重来。六、第二阶段新电脑安装基础环境在还原文件之前新电脑要先把 WorkBuddy 跑起来需要的“地基”打好。6.1 安装 WorkBuddy 客户端浏览器打开官网 https://www.workbuddy.cn/点击「立即下载」选择你的系统版本Windows x64 最常见。下载完成后双击安装包一路「下一步」即可。安装完成后先不要启动或者启动登录一次再退出等会儿还原文件后再正式启动。为什么要先装再还原先安装 WorkBuddy它会在新电脑生成必要的目录结构和注册表项再覆盖还原你的备份就能无缝接管。6.2 安装 Python如果你用到了脚本如果你旧电脑上有让 AI 跑 Python 脚本如定时任务脚本新电脑也要装 Python且版本和路径最好一致否则脚本里的 Python 路径会失效。去 https://www.python.org/downloads/ 下载 Python 3.13或与旧电脑相同版本。安装时务必勾选「Add Python to PATH」。建议安装到默认路径C:\Program Files\Python313\与旧电脑保持一致。安装后打开 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目录可能已存在里面是空的默认数据。处理方法把新电脑上现有的.workbuddy重命名为.workbuddy.bak留个备份以防万一。再把备份里的.workbuddy粘贴进来。确认无误后可删除.workbuddy.bak。八、第四阶段处理路径变化最容易翻车的一步文件搬过来了但里面的路径还是旧电脑的。如果你的用户名或盘符变了必须做这一步否则 AI 会“找不到文件”。8.1 哪些情况需要改路径情况要不要改路径改哪些新旧用户名相同 盘符相同❌ 不用改—用户名不同Administrator→zhangxinbin✅ 必改所有含旧用户名的路径盘符变化E盘→D盘✅ 必改MEMORY.md 等文件里的盘符项目路径变化E:\claw→D:\claw✅ 必改项目相关绝对路径8.2 批量替换 MEMORY.md 里的路径MEMORY.md是硬编码路径最多的文件必须重点处理用记事本或 VS Code打开新项目路径\.workbuddy\memory\MEMORY.md。按Ctrl H打开“替换”功能。“查找内容”填旧路径如E:\claw“替换为”填新路径如D:\claw。点击「全部替换」。再替换一次用户名查找C:\Users\Administrator替换为C:\Users\zhangxinbin。保存文件Ctrl S。推荐用 VS CodeVS Code 的替换支持“区分大小写”“正则”批量改路径最稳。记事本也行但要逐个查找。8.3 检查脚本里的硬编码路径除了 MEMORY.md下面这些脚本里也可能写死了旧路径需要逐个打开检查并替换stock_tracker.py或你的定时任务脚本gen_pptx.pyPPT 生成脚本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双击桌面 WorkBuddy 图标启动。登录你的账号与旧电脑同一个账号。等待初始化完成首次启动可能稍慢它在读取记忆文件。9.2 灵魂三问验证法启动后跟 AI 说下面三句话验证记忆是否恢复你问正常反应迁移成功异常反应迁移失败你还记得我吗能叫出你的名字、说出你在做的事像第一次见面啥都不知道我之前在做什么项目能说出项目细节、进度一片空白帮我用 XX 技能做件事技能可用正常执行提示技能不存在9.3 完整性校验清单projects\目录下的 jsonl 对话记录能正常加载、能翻看历史对话skills\目录下技能数量与旧电脑一致技能可调用sessions.json里的会话数量与实际对话记录相符自动化任务触发条件在新环境仍有效见下一章校验失败怎么办如果任何一项校验失败先回滚删除新目录从备份重新还原再仔细检查路径替换。不要在错误状态上硬改。十、需要重新配置的内容文件搬不走的10.1 重新创建 Windows 定时任务Windows 任务计划程序里的定时任务不会跟着文件走必须在新电脑重新创建。方法在旧电脑打开「任务计划程序」逐个记录每个定时任务的名称、触发时间、执行的脚本路径、参数。在新电脑打开「任务计划程序」WinR 输入taskschd.msc。点「创建基本任务」按记录逐个重建。注意脚本路径要填新电脑的路径如D:\claw\run.bat。更聪明的办法直接对 WorkBuddy 说“导出自动化任务”它会自动列出所有任务、扫描敏感信息、生成 JSON 文件。新电脑上说“导入自动化任务”它会逐条校验、重建任务、并警告路径不匹配的地方。这比手动重建省事得多。10.2 重新授权 MCP 服务如需要如果mcp.json里的 Token如金山文档迁过去后失效重新走一遍授权流程即可。Token 是跟账号绑定的换电脑不影响额度但可能需要重新点一次授权。十一、进阶用符号链接把 WorkBuddy 搬到其他盘可选WorkBuddy 默认把数据放 C 盘用久了 C 盘会满。可以用“目录符号链接mklink /J”把数据实际存到 D 盘C 盘只留一个“快捷方式”C 盘不占空间但程序照常访问。完全退出 WorkBuddy右下角托盘图标右键 → 退出。把C:\Users\你的用户名\.workbuddy剪切到 D 盘如D:\Workbuddy_related\.workbuddy。同样把.workbuddy-key-fallback如果有也剪切过去。以管理员身份打开 cmd开始菜单搜 cmd → 右键 → 以管理员身份运行。执行下面两条命令创建符号链接用户名和路径换成你的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 自带功能无需安装任何软件。十二、常见问题 FAQQ1复制时提示“文件正在使用无法复制”怎么办说明 WorkBuddy 没完全退出。回到旧电脑右下角托盘图标右键 → 退出等图标消失后再复制。也可以在任务管理器CtrlShiftEsc里结束所有 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系统偏好→用户与群组→登录项