據如何遷移)
本教程面向完全沒接觸過文件遷移的新手手把手教你把舊電腦上的 WorkBuddy含全部記憶、人格、技能、項目數(shù)據完整搬到新電腦做到“換電腦不換魂”。請按順序從頭讀到尾再動手操作。一句話總覽遷移 復制 3 個隱藏文件夾 1 個項目目錄 → 粘貼到新電腦對應位置 → 改路徑 → 驗證。核心是.workbuddy目錄那是 WorkBuddy 的全部記憶和人格所在。一、教程導讀先認識 WorkBuddy 與“為什么要遷移”1.1 WorkBuddy 是什么WorkBuddy 是騰訊出品的全場景 AI 智能體桌面工作臺由騰訊云 CodeBuddy 團隊開發(fā)。它住在你的電腦里能“聽懂人話、帶腦子思考、真正操作本地文件”——自動批量處理文件、生成文檔/表格/PPT、數(shù)據分析、遠程辦公等。它最大的特點是它的記憶、人格、技能都存在你的本地電腦上而不是云端。1.2 為什么換電腦后必須手動遷移這是最關鍵的認知點90% 的人在這里踩坑賬號登錄 ≠ 數(shù)據遷移。WorkBuddy 的數(shù)據分兩層第一層是“賬號配置”你登錄的賬號、綁定的平臺這個會跟著賬號走換電腦登錄就有了第二層是“記憶與任務”你的工作日志、人格定義、技能包、自動化任務配置這些全部存在本地磁盤賬號登錄不會把它們帶走。最容易踩的坑很多人以為“新電腦裝好 WorkBuddy、登錄同一賬號”就萬事大吉了結果發(fā)現(xiàn)AI 失憶了、技能沒了、定時任務空了。原因就是本地數(shù)據沒搬過來。1.3 本教程適合誰換新電腦、想保留 WorkBuddy 全部記憶與技能的個人用戶Windows 系統(tǒng)升級換機Win10→Win11或換臺新機器之前從沒用過命令行、沒動過隱藏文件夾的純新手想把 WorkBuddy 數(shù)據從 C 盤搬到其他盤的用戶見第九章進階如果你是 Mac 用戶原理相同但路徑改為/Users/你的用戶名/.workbuddy命令行用終端即可。本教程以 Windows 為主進行圖文講解。二、遷移原理搞清楚要帶走什么、留下什么概念示意圖2.1 WorkBuddy 的三層數(shù)據模型在動手前花 2 分鐘理解 WorkBuddy 數(shù)據的“三層結構”你就明白為什么要搬這些東西了層數(shù)內容存放位置能否遷移第一層對話記錄jsonl 文件%USERPROFILE%\.workbuddy\projects\? 核心必遷第二層會話索引/元數(shù)據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驗證“你還記得我嗎”↓重新創(chuàng)建定時任務 / 重新授權 MCP如需要三、遷移前的準備工作很重要別跳過3.1 工具準備備份介質U 盤、移動硬盤或網盤百度網盤/夸克/OneDrive 任選其一。建議總容量 ≥ 2GB。新電腦已聯(lián)網能正常上網下載軟件。一張紙/記事本用來記錄舊電腦和新電腦的“用戶名”“項目路徑”后面要用。3.2 關鍵信息確認請先記錄下來請打開記事本把下面 4 個信息查清楚并記下來后面步驟會反復用到信息項怎么查示例舊電腦 Windows 用戶名打開C:\Users\看到的文件夾名Administrator新電腦 Windows 用戶名同上zhangxinbin舊電腦項目路徑你平時讓 AI 干活的工作目錄E:\claw新電腦項目路徑計劃新電腦打算放項目的目錄D:\claw為什么要記這個WorkBuddy 內部很多文件里寫死了絕對路徑如E:\claw\stock_tracker.py。如果新電腦用戶名或盤符變了這些路徑會失效必須批量替換。提前記錄能省掉后面大量排查時間。3.3 完全退出 WorkBuddy必做在舊電腦上必須完全退出 WorkBuddy否則復制時文件被占用會提示“文件正在使用”導致復制失敗或數(shù)據不完整。點擊窗口右上角的 × —— 這只是最小化還沒退出找到屏幕右下角任務欄時間旁邊的 WorkBuddy 小圖標。右鍵點擊該圖標 → 選擇「退出」。確認圖標消失后才算真正退出。常見錯誤只點 × 不算退出。一定要到右下角托盤圖標右鍵 → 退出。這一步漏了復制會報錯。四、核心需要遷移的 4 個位置最重要的一章概念示意圖WorkBuddy 的“靈魂”分散在 4 個位置遷移時全部都要帶走缺一不可。下面逐一講解每個位置里裝了什么。位置 1用戶級身份目錄 .workbuddy最重要路徑C:\Users\你的用戶名\.workbuddy\這是 WorkBuddy 的“大腦”決定了“我是誰”和“你是誰”。換電腦后必須恢復否則 AI 會失憶。里面關鍵文件文件作用遷移注意SOUL.mdAI 的性格定義通用可直接遷IDENTITY.mdAI 是誰的身份卡可直接遷USER.md關于你的信息可直接遷BOOTSTRAP.md首次啟動引導遷過去后可刪除觸發(fā)重新初始化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\這是你所有項目的積累——標準查詢經驗、股票系統(tǒng)、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是隱藏文件夾必須先讓它們“現(xiàn)形”才能復制。打開「文件資源管理器」快捷鍵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下的腳本、數(shù)據也要帶走把整個項目文件夾也復制進去。復制完成后逐個右鍵 → 屬性對比新舊位置的“大小”和“包含文件數(shù)”確保一致沒漏文件。務必核對復制大文件夾時偶爾會跳過被占用的文件。一定要對比“文件數(shù)”是否一致。如果不一致說明 WorkBuddy 沒完全退出回到 3.3 步驟重來。六、第二階段新電腦安裝基礎環(huán)境在還原文件之前新電腦要先把 WorkBuddy 跑起來需要的“地基”打好。6.1 安裝 WorkBuddy 客戶端瀏覽器打開官網 https://www.workbuddy.cn/點擊「立即下載」選擇你的系統(tǒng)版本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目錄可能已存在里面是空的默認數(shù)據。處理方法把新電腦上現(xiàn)有的.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打開“替換”功能?！安檎覂热荨碧钆f路徑如E:\claw“替換為”填新路徑如D:\claw。點擊「全部替換」。再替換一次用戶名查找C:\Users\Administrator替換為C:\Users\zhangxinbin。保存文件Ctrl S。推薦用 VS CodeVS Code 的替換支持“區(qū)分大小寫”“正則”批量改路徑最穩(wěn)。記事本也行但要逐個查找。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 說下面三句話驗證記憶是否恢復你問正常反應遷移成功異常反應遷移失敗你還記得我嗎能叫出你的名字、說出你在做的事像第一次見面啥都不知道我之前在做什么項目能說出項目細節(jié)、進度一片空白幫我用 XX 技能做件事技能可用正常執(zhí)行提示技能不存在9.3 完整性校驗清單projects\目錄下的 jsonl 對話記錄能正常加載、能翻看歷史對話skills\目錄下技能數(shù)量與舊電腦一致技能可調用sessions.json里的會話數(shù)量與實際對話記錄相符自動化任務觸發(fā)條件在新環(huán)境仍有效見下一章校驗失敗怎么辦如果任何一項校驗失敗先回滾刪除新目錄從備份重新還原再仔細檢查路徑替換。不要在錯誤狀態(tài)上硬改。十、需要重新配置的內容文件搬不走的10.1 重新創(chuàng)建 Windows 定時任務Windows 任務計劃程序里的定時任務不會跟著文件走必須在新電腦重新創(chuàng)建。方法在舊電腦打開「任務計劃程序」逐個記錄每個定時任務的名稱、觸發(fā)時間、執(zhí)行的腳本路徑、參數(shù)。在新電腦打開「任務計劃程序」WinR 輸入taskschd.msc。點「創(chuàng)建基本任務」按記錄逐個重建。注意腳本路徑要填新電腦的路徑如D:\claw\run.bat。更聰明的辦法直接對 WorkBuddy 說“導出自動化任務”它會自動列出所有任務、掃描敏感信息、生成 JSON 文件。新電腦上說“導入自動化任務”它會逐條校驗、重建任務、并警告路徑不匹配的地方。這比手動重建省事得多。10.2 重新授權 MCP 服務如需要如果mcp.json里的 Token如金山文檔遷過去后失效重新走一遍授權流程即可。Token 是跟賬號綁定的換電腦不影響額度但可能需要重新點一次授權。十一、進階用符號鏈接把 WorkBuddy 搬到其他盤可選WorkBuddy 默認把數(shù)據放 C 盤用久了 C 盤會滿。可以用“目錄符號鏈接mklink /J”把數(shù)據實際存到 D 盤C 盤只留一個“快捷方式”C 盤不占空間但程序照常訪問。完全退出 WorkBuddy右下角托盤圖標右鍵 → 退出。把C:\Users\你的用戶名\.workbuddy剪切到 D 盤如D:\Workbuddy_related\.workbuddy。同樣把.workbuddy-key-fallback如果有也剪切過去。以管理員身份打開 cmd開始菜單搜 cmd → 右鍵 → 以管理員身份運行。執(zhí)行下面兩條命令創(chuàng)建符號鏈接用戶名和路徑換成你的mklink /J C:\Users\你的用戶名\.workbuddy D:\Workbuddy_related\.workbuddy mklink /J C:\Users\你的用戶名\.workbuddy-key-fallback D:\Workbuddy_related\.workbuddy-key-fallback執(zhí)行成功后C:\Users\你的用戶名\下會出現(xiàn)兩個帶“快捷方式”小箭頭的文件夾雙擊能正常打開C 盤不占真實空間。原理mklink /J創(chuàng)建的是“目錄聯(lián)接”對程序完全透明——程序以為文件還在 C 盤實際數(shù)據在 D 盤。這是 Windows 自帶功能無需安裝任何軟件。十二、常見問題 FAQQ1復制時提示“文件正在使用無法復制”怎么辦說明 WorkBuddy 沒完全退出。回到舊電腦右下角托盤圖標右鍵 → 退出等圖標消失后再復制。也可以在任務管理器CtrlShiftEsc里結束所有 WorkBuddy 進程。Q2新電腦啟動后 AI 完全失憶像第一次用99% 是文件沒放對位置。檢查①.workbuddy是否在C:\Users\新用戶名\下不是其他位置② 目錄名是否正確是.workbuddy不是workbuddy前面有點③ 隱藏文件夾是否顯示出來了別粘錯地方。Q3用戶名不同直接復制過去行不行可以復制但路徑要換。.workbuddy要放到新用戶名目錄下且 MEMORY.md 等文件里的舊用戶名路徑要批量替換見第八章。Q4直接拷 workbuddy.db 數(shù)據庫到新電腦行嗎不行。數(shù)據庫綁定的是舊電腦的硬件指紋和軟件環(huán)境換臺電腦直接讀不了還可能報錯把兩邊都搞崩。自動化任務要用“導出/導入”方式重建見第十章。Q5跨平臺Windows→Mac怎么遷純文件拷貝在跨平臺場景下不適用路徑映射失效。需用 WorkBuddy 的「設置 → 數(shù)據管理 → 導出全部數(shù)據」生成結構化備份包需 v2.4.0 及以上版本在新電腦導入。Q6遷過去后技能用不了怎么辦檢查.workbuddy\skills\目錄是否完整復制技能文件夾數(shù)量是否與舊電腦一致。部分技能依賴 Python 包需在新電腦pip install對應依賴。Q7備份文件能長期保留嗎可以建議每次大版本升級或重大調整前都備份一份。備份就是普通文件夾放哪都行但注意里面有 Token 等敏感信息不要傳到公開網盤分享鏈接。十三、遷移清單 Checklist打印對照執(zhí)行把下面這張表打印出來或抄在紙上每做完一步打勾確保不遺漏階段步驟完成準備記錄新舊電腦用戶名、項目路徑?準備舊電腦完全退出 WorkBuddy托盤右鍵退出?準備新電腦顯示隱藏文件夾?打包復制 .workbuddy 到備份介質?打包復制 .skillhub 到備份介質?打包復制項目 .workbuddy 到備份介質?打包復制項目文件如需到備份介質?打包對比文件數(shù)確認無遺漏?安裝新電腦安裝 WorkBuddy 客戶端?安裝新電腦安裝 Python如需?安裝新電腦安裝微信如需?還原粘貼 .workbuddy 到新用戶名目錄?還原粘貼 .skillhub 到新用戶名目錄?還原粘貼項目 .workbuddy 到新項目路徑?改路徑批量替換 MEMORY.md 里的舊路徑?改路徑檢查并替換腳本里的硬編碼路徑?改路徑檢查 mcp.json 里的路徑?驗證啟動 WorkBuddy登錄賬號?驗證靈魂三問驗證記憶恢復?驗證完整性校驗對話/技能/會話數(shù)?重配重建 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系統(tǒng)偏好→用戶與群組→登錄項 AI工具WorkBuddy篇：8_換電腦后，數(shù)據如何遷移
本教程面向完全沒接觸過文件遷移的新手手把手教你把舊電腦上的 WorkBuddy含全部記憶、人格、技能、項目數(shù)據完整搬到新電腦做到“換電腦不換魂”。請按順序從頭讀到尾再動手操作。一句話總覽遷移 復制 3 個隱藏文件夾 1 個項目目錄 → 粘貼到新電腦對應位置 → 改路徑 → 驗證。核心是.workbuddy目錄那是 WorkBuddy 的全部記憶和人格所在。一、教程導讀先認識 WorkBuddy 與“為什么要遷移”1.1 WorkBuddy 是什么WorkBuddy 是騰訊出品的全場景 AI 智能體桌面工作臺由騰訊云 CodeBuddy 團隊開發(fā)。它住在你的電腦里能“聽懂人話、帶腦子思考、真正操作本地文件”——自動批量處理文件、生成文檔/表格/PPT、數(shù)據分析、遠程辦公等。它最大的特點是它的記憶、人格、技能都存在你的本地電腦上而不是云端。1.2 為什么換電腦后必須手動遷移這是最關鍵的認知點90% 的人在這里踩坑賬號登錄 ≠ 數(shù)據遷移。WorkBuddy 的數(shù)據分兩層第一層是“賬號配置”你登錄的賬號、綁定的平臺這個會跟著賬號走換電腦登錄就有了第二層是“記憶與任務”你的工作日志、人格定義、技能包、自動化任務配置這些全部存在本地磁盤賬號登錄不會把它們帶走。最容易踩的坑很多人以為“新電腦裝好 WorkBuddy、登錄同一賬號”就萬事大吉了結果發(fā)現(xiàn)AI 失憶了、技能沒了、定時任務空了。原因就是本地數(shù)據沒搬過來。1.3 本教程適合誰換新電腦、想保留 WorkBuddy 全部記憶與技能的個人用戶Windows 系統(tǒng)升級換機Win10→Win11或換臺新機器之前從沒用過命令行、沒動過隱藏文件夾的純新手想把 WorkBuddy 數(shù)據從 C 盤搬到其他盤的用戶見第九章進階如果你是 Mac 用戶原理相同但路徑改為/Users/你的用戶名/.workbuddy命令行用終端即可。本教程以 Windows 為主進行圖文講解。二、遷移原理搞清楚要帶走什么、留下什么概念示意圖2.1 WorkBuddy 的三層數(shù)據模型在動手前花 2 分鐘理解 WorkBuddy 數(shù)據的“三層結構”你就明白為什么要搬這些東西了層數(shù)內容存放位置能否遷移第一層對話記錄jsonl 文件%USERPROFILE%\.workbuddy\projects\? 核心必遷第二層會話索引/元數(shù)據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驗證“你還記得我嗎”↓重新創(chuàng)建定時任務 / 重新授權 MCP如需要三、遷移前的準備工作很重要別跳過3.1 工具準備備份介質U 盤、移動硬盤或網盤百度網盤/夸克/OneDrive 任選其一。建議總容量 ≥ 2GB。新電腦已聯(lián)網能正常上網下載軟件。一張紙/記事本用來記錄舊電腦和新電腦的“用戶名”“項目路徑”后面要用。3.2 關鍵信息確認請先記錄下來請打開記事本把下面 4 個信息查清楚并記下來后面步驟會反復用到信息項怎么查示例舊電腦 Windows 用戶名打開C:\Users\看到的文件夾名Administrator新電腦 Windows 用戶名同上zhangxinbin舊電腦項目路徑你平時讓 AI 干活的工作目錄E:\claw新電腦項目路徑計劃新電腦打算放項目的目錄D:\claw為什么要記這個WorkBuddy 內部很多文件里寫死了絕對路徑如E:\claw\stock_tracker.py。如果新電腦用戶名或盤符變了這些路徑會失效必須批量替換。提前記錄能省掉后面大量排查時間。3.3 完全退出 WorkBuddy必做在舊電腦上必須完全退出 WorkBuddy否則復制時文件被占用會提示“文件正在使用”導致復制失敗或數(shù)據不完整。點擊窗口右上角的 × —— 這只是最小化還沒退出找到屏幕右下角任務欄時間旁邊的 WorkBuddy 小圖標。右鍵點擊該圖標 → 選擇「退出」。確認圖標消失后才算真正退出。常見錯誤只點 × 不算退出。一定要到右下角托盤圖標右鍵 → 退出。這一步漏了復制會報錯。四、核心需要遷移的 4 個位置最重要的一章概念示意圖WorkBuddy 的“靈魂”分散在 4 個位置遷移時全部都要帶走缺一不可。下面逐一講解每個位置里裝了什么。位置 1用戶級身份目錄 .workbuddy最重要路徑C:\Users\你的用戶名\.workbuddy\這是 WorkBuddy 的“大腦”決定了“我是誰”和“你是誰”。換電腦后必須恢復否則 AI 會失憶。里面關鍵文件文件作用遷移注意SOUL.mdAI 的性格定義通用可直接遷IDENTITY.mdAI 是誰的身份卡可直接遷USER.md關于你的信息可直接遷BOOTSTRAP.md首次啟動引導遷過去后可刪除觸發(fā)重新初始化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\這是你所有項目的積累——標準查詢經驗、股票系統(tǒng)、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是隱藏文件夾必須先讓它們“現(xiàn)形”才能復制。打開「文件資源管理器」快捷鍵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下的腳本、數(shù)據也要帶走把整個項目文件夾也復制進去。復制完成后逐個右鍵 → 屬性對比新舊位置的“大小”和“包含文件數(shù)”確保一致沒漏文件。務必核對復制大文件夾時偶爾會跳過被占用的文件。一定要對比“文件數(shù)”是否一致。如果不一致說明 WorkBuddy 沒完全退出回到 3.3 步驟重來。六、第二階段新電腦安裝基礎環(huán)境在還原文件之前新電腦要先把 WorkBuddy 跑起來需要的“地基”打好。6.1 安裝 WorkBuddy 客戶端瀏覽器打開官網 https://www.workbuddy.cn/點擊「立即下載」選擇你的系統(tǒng)版本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目錄可能已存在里面是空的默認數(shù)據。處理方法把新電腦上現(xiàn)有的.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打開“替換”功能?！安檎覂热荨碧钆f路徑如E:\claw“替換為”填新路徑如D:\claw。點擊「全部替換」。再替換一次用戶名查找C:\Users\Administrator替換為C:\Users\zhangxinbin。保存文件Ctrl S。推薦用 VS CodeVS Code 的替換支持“區(qū)分大小寫”“正則”批量改路徑最穩(wěn)。記事本也行但要逐個查找。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 說下面三句話驗證記憶是否恢復你問正常反應遷移成功異常反應遷移失敗你還記得我嗎能叫出你的名字、說出你在做的事像第一次見面啥都不知道我之前在做什么項目能說出項目細節(jié)、進度一片空白幫我用 XX 技能做件事技能可用正常執(zhí)行提示技能不存在9.3 完整性校驗清單projects\目錄下的 jsonl 對話記錄能正常加載、能翻看歷史對話skills\目錄下技能數(shù)量與舊電腦一致技能可調用sessions.json里的會話數(shù)量與實際對話記錄相符自動化任務觸發(fā)條件在新環(huán)境仍有效見下一章校驗失敗怎么辦如果任何一項校驗失敗先回滾刪除新目錄從備份重新還原再仔細檢查路徑替換。不要在錯誤狀態(tài)上硬改。十、需要重新配置的內容文件搬不走的10.1 重新創(chuàng)建 Windows 定時任務Windows 任務計劃程序里的定時任務不會跟著文件走必須在新電腦重新創(chuàng)建。方法在舊電腦打開「任務計劃程序」逐個記錄每個定時任務的名稱、觸發(fā)時間、執(zhí)行的腳本路徑、參數(shù)。在新電腦打開「任務計劃程序」WinR 輸入taskschd.msc。點「創(chuàng)建基本任務」按記錄逐個重建。注意腳本路徑要填新電腦的路徑如D:\claw\run.bat。更聰明的辦法直接對 WorkBuddy 說“導出自動化任務”它會自動列出所有任務、掃描敏感信息、生成 JSON 文件。新電腦上說“導入自動化任務”它會逐條校驗、重建任務、并警告路徑不匹配的地方。這比手動重建省事得多。10.2 重新授權 MCP 服務如需要如果mcp.json里的 Token如金山文檔遷過去后失效重新走一遍授權流程即可。Token 是跟賬號綁定的換電腦不影響額度但可能需要重新點一次授權。十一、進階用符號鏈接把 WorkBuddy 搬到其他盤可選WorkBuddy 默認把數(shù)據放 C 盤用久了 C 盤會滿。可以用“目錄符號鏈接mklink /J”把數(shù)據實際存到 D 盤C 盤只留一個“快捷方式”C 盤不占空間但程序照常訪問。完全退出 WorkBuddy右下角托盤圖標右鍵 → 退出。把C:\Users\你的用戶名\.workbuddy剪切到 D 盤如D:\Workbuddy_related\.workbuddy。同樣把.workbuddy-key-fallback如果有也剪切過去。以管理員身份打開 cmd開始菜單搜 cmd → 右鍵 → 以管理員身份運行。執(zhí)行下面兩條命令創(chuàng)建符號鏈接用戶名和路徑換成你的mklink /J C:\Users\你的用戶名\.workbuddy D:\Workbuddy_related\.workbuddy mklink /J C:\Users\你的用戶名\.workbuddy-key-fallback D:\Workbuddy_related\.workbuddy-key-fallback執(zhí)行成功后C:\Users\你的用戶名\下會出現(xiàn)兩個帶“快捷方式”小箭頭的文件夾雙擊能正常打開C 盤不占真實空間。原理mklink /J創(chuàng)建的是“目錄聯(lián)接”對程序完全透明——程序以為文件還在 C 盤實際數(shù)據在 D 盤。這是 Windows 自帶功能無需安裝任何軟件。十二、常見問題 FAQQ1復制時提示“文件正在使用無法復制”怎么辦說明 WorkBuddy 沒完全退出。回到舊電腦右下角托盤圖標右鍵 → 退出等圖標消失后再復制。也可以在任務管理器CtrlShiftEsc里結束所有 WorkBuddy 進程。Q2新電腦啟動后 AI 完全失憶像第一次用99% 是文件沒放對位置。檢查①.workbuddy是否在C:\Users\新用戶名\下不是其他位置② 目錄名是否正確是.workbuddy不是workbuddy前面有點③ 隱藏文件夾是否顯示出來了別粘錯地方。Q3用戶名不同直接復制過去行不行可以復制但路徑要換。.workbuddy要放到新用戶名目錄下且 MEMORY.md 等文件里的舊用戶名路徑要批量替換見第八章。Q4直接拷 workbuddy.db 數(shù)據庫到新電腦行嗎不行。數(shù)據庫綁定的是舊電腦的硬件指紋和軟件環(huán)境換臺電腦直接讀不了還可能報錯把兩邊都搞崩。自動化任務要用“導出/導入”方式重建見第十章。Q5跨平臺Windows→Mac怎么遷純文件拷貝在跨平臺場景下不適用路徑映射失效。需用 WorkBuddy 的「設置 → 數(shù)據管理 → 導出全部數(shù)據」生成結構化備份包需 v2.4.0 及以上版本在新電腦導入。Q6遷過去后技能用不了怎么辦檢查.workbuddy\skills\目錄是否完整復制技能文件夾數(shù)量是否與舊電腦一致。部分技能依賴 Python 包需在新電腦pip install對應依賴。Q7備份文件能長期保留嗎可以建議每次大版本升級或重大調整前都備份一份。備份就是普通文件夾放哪都行但注意里面有 Token 等敏感信息不要傳到公開網盤分享鏈接。十三、遷移清單 Checklist打印對照執(zhí)行把下面這張表打印出來或抄在紙上每做完一步打勾確保不遺漏階段步驟完成準備記錄新舊電腦用戶名、項目路徑?準備舊電腦完全退出 WorkBuddy托盤右鍵退出?準備新電腦顯示隱藏文件夾?打包復制 .workbuddy 到備份介質?打包復制 .skillhub 到備份介質?打包復制項目 .workbuddy 到備份介質?打包復制項目文件如需到備份介質?打包對比文件數(shù)確認無遺漏?安裝新電腦安裝 WorkBuddy 客戶端?安裝新電腦安裝 Python如需?安裝新電腦安裝微信如需?還原粘貼 .workbuddy 到新用戶名目錄?還原粘貼 .skillhub 到新用戶名目錄?還原粘貼項目 .workbuddy 到新項目路徑?改路徑批量替換 MEMORY.md 里的舊路徑?改路徑檢查并替換腳本里的硬編碼路徑?改路徑檢查 mcp.json 里的路徑?驗證啟動 WorkBuddy登錄賬號?驗證靈魂三問驗證記憶恢復?驗證完整性校驗對話/技能/會話數(shù)?重配重建 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系統(tǒng)偏好→用戶與群組→登錄項