前言¶
WorkBuddy 國內版把技能、記憶、對話、連接器與身份設定都落在本機 ~/.workbuddy/。換電腦時若只拷貝其中一兩個目錄，往往會出現對話能打開但產物路徑失效、MCP 要重新授權、或 SQLite 被客戶端佔用導致寫入失敗。
手工打包又容易漏掉 DB 表、artifact-index、自動化備份等分散資產。下面介紹社區 Skill「WorkBuddy遷移助手」：用導出/導入腳本和兩包分離結構，把搬家流程收成可復現的主線六步。
這是什麼¶
WorkBuddy遷移助手是 SkillHub 上的社區 Skill，座標 @user_73de2035/workbuddy-migration-assistant，當前版本 2.0.0，分類 it-ops-security，發佈者爲 user_73de2035，requires_api_key=false。
它面向 WorkBuddy 國內版（官方說明適配客戶端 5.7.6）的跨機器場景：在舊機導出全部個人資產，傳到新機後合併導入，並做路徑映射與導入後校驗。SkillHub 頁面簡介概括爲：一鍵導出/導入技能、記憶、對話、配置、連接器憑證、會話產物索引等，兩包分離傳輸、路徑自動映射、導入後自動校驗，按主線六步完成搬家。
官方入口：
- API：
https://api.skillhub.cn/user_73de2035/workbuddy-migration-assistant - 展示頁：
https://www.skillhub.cn/skills/user_73de2035/workbuddy-migration-assistant
核心功能¶
以下能力均來自 Skill 的 SKILL.md 與 SkillHub 檢索摘要，可按需由 Agent 加載 references/ 下的命令與排障文檔。
資產覆蓋範圍¶
遷移目標爲 ~/.workbuddy/ 下的個人數據，包括但不限於：
- 技能與記憶：
skills/、memory/、MEMORY.md - 對話與自動化：
projects/（歷史對話）、DB 中的 sessions/automations 等；automation-backups/ - 連接器與 MCP：
settings.json、mcp.json、connectors/、.credentials.json（OAuth 憑證，可用--no-credentials排除） - 身份與個性化：
IDENTITY.md、SOUL.md、USER.md，以及app/app-config.json中personalization.*子樹 - 其它：專家與插件、artifact-index、行業 Buddy 快照、工作區信任決策等
平臺相關二進制、日誌、設備綁定標識、認證 token 等明確不遷移（見 Skill 內「絕對不遷移的」清單）。
兩包分離¶
| 包 | 典型文件名 | 內容 | 是否必傳 |
|---|---|---|---|
| 主包 | wb-migration-{timestamp}.zip |
DB、技能、配置、身份、記憶、連接器、對話元數據等 | 必須 |
| 產物包 | wb-migration-{timestamp}-workspaces.zip |
對話工作目錄下的文件（代碼、報告、下載等）；對應 ~/WorkBuddy/，需 --with-workspaces 或 full 類配置 |
可選 |
主包體積小，便於網盤或即時通訊傳輸；產物包可後補，丟失不影響主包導入（對話可能可回顧但無本地文件）。
導入策略與跨平臺¶
- 默認合併不覆蓋：目標機已有內容保留，僅補充缺失；需覆蓋時使用
--overwrite。 - 路徑映射：跨平臺推薦
--auto-map，或使用--profile auto做零配置映射（含 artifact-index 的 URL 編碼路徑重寫）；本機從 backup 包恢復時文檔建議用--auto-map以免憑證路徑問題。 - 衝突與校驗：導入前可用
--dry-run預覽合併計劃；正式導入後輸出 verify 報告（如「N/N 項全部就位」）。 - 預設：
--profile lite（快速換機）、full（含對話工作目錄文件）、backup（本機備份）；新機導入常用--profile auto。
Agent 分派方式¶
Skill 不自行追問用戶，由宿主 Agent 根據意圖進入導出（流程 A）、導入（流程 B）或檢視包（流程 C）。常見觸發詞包括：WorkBuddy 遷移、資產遷移、換電腦搬家、遷移助手、搬家工具、數據遷移。
安裝與啓用¶
安裝 SkillHub CLI¶
若尚未安裝 CLI，可先檢查版本：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
文檔地址：https://skillhub.cn/install/skillhub.md（亦可通過 https://www.skillhub.cn/install/skillhub.md 訪問）。
安裝本 Skill¶
SkillHub 頁面提示：根據上述安裝文檔，安裝 @user_73de2035/workbuddy-migration-assistant。
在 WorkBuddy 環境中，技能應裝入 WorkBuddy 的 skills 目錄（安裝文檔列出 workbuddy: ~/.workbuddy/skills/）。示例：
skillhub install workbuddy-migration-assistant --namespace user_73de2035 --dir ~/.workbuddy/skills/
若在 Cursor 等其它 Agent 中僅希望把 Skill 裝進該 Agent 的目錄，需將 --dir 改爲對應當前環境的 skills 路徑（如 Cursor 爲 ~/.cursor/skills/），並重啓或刷新 Agent 以便識別新 Skill。本 Skill 的業務腳本針對 ~/.workbuddy/ 數據目錄，實際搬家仍建議在已安裝 WorkBuddy 客戶端的機器上由 Agent 調用 Skill 內的 scripts/export.py / scripts/import.py。
安裝完成後，對 Agent 說明需求即可（例如「WorkBuddy 換電腦，幫我按遷移助手導出」），無需額外 API Key。
典型用法：主線六步¶
下列命令在 Skill 安裝目錄下執行（路徑以你本機 --dir 安裝結果爲準），python 優先使用 WorkBuddy 自帶的 managed Python；系統 Python 3.8+ 亦可。
第 1 步 · 選場景：換機常用 --profile lite；需要對話工作目錄文件時用 full；僅本機備份用 backup。
第 2 步 · 舊機導出：
python scripts/export.py --source auto --output ~/Desktop/wb.zip --profile lite
預期看到 Profile 與各資產 copied，以及主包路徑；錯誤行以 [E-xxx] 穩定錯誤碼開頭，可對照 references/faq.md。
第 3 步 · 傳包：將 wb.zip 拷到新機。若使用 full，另傳 wb-workspaces.zip；產物包丟失不影響主包導入。
第 4 步 · 新機預檢：
python scripts/import.py --package ~/Desktop/wb.zip --profile auto --dry-run
查看 would-merge 計劃與衝突預覽，確認後再寫入。
第 5 步 · 新機正式導入：
python scripts/import.py --package ~/Desktop/wb.zip --profile auto
導入前須退出 WorkBuddy 客戶端；若沙箱 strip_write 攔截寫入，需按 Skill 說明關閉沙箱後重跑（冪等可續傳）。成功後應看到合併結果與資產校驗，並提示重啓 WorkBuddy。
第 6 步 · 重啓驗證：完全退出並重新打開 WorkBuddy，確認 verify 爲全部就位，舊對話與技能可用。
更細的輸出樣例與 JSON 字段說明見 Skill 內 references/walkthrough.md。
適用場景與注意¶
適合：WorkBuddy 國內版換電腦（Windows / macOS / Linux 互遷）、本機備份與恢復、在可控前提下做多機同步。
不適合：同機國內版與海外版互遷（Skill 明確應使用「WorkBuddy 資產遷移」類其它技能）。
操作注意（來自 Skill 關鍵約束）：
- 導入前退出客戶端，避免 SQLite 寫鎖失敗。
- 導入前確認沙箱不會剝寫核心配置；被攔截時關閉沙箱後重跑。
- 默認不覆蓋目標機已有資產；跨機 OAuth 憑證常失效，推薦
--no-credentials並在新機連接器面板重新授權。 - 導入後必須重啓客戶端，settings、models 等纔會生效。
- 同機國內版↔海外版、設備 ID、日誌緩存等不在遷移範圍，勿指望靠本 Skill 帶上。
SkillHub 統計（以腳本抓取爲準）：評分 100000，下載 29756 次。
結尾¶
WorkBuddy遷移助手把換機時的分散目錄收成「導出兩包 → 傳輸 → dry-run → 合併導入 → 校驗 → 重啓」的固定流程，並處理路徑映射與衝突預覽。若你正在更換運行 WorkBuddy 的機器，可在 SkillHub 安裝該 Skill 後，讓 Agent 按主線六步驅動腳本完成搬家。
官方地址：https://api.skillhub.cn/user_73de2035/workbuddy-migration-assistant
SkillHub 頁面：https://www.skillhub.cn/skills/user_73de2035/workbuddy-migration-assistant
