WorkBuddy 数据迁移工具 — 备份、恢复、跨账号/跨设备迁移对话任务、Skills、Automations、配置等所有数据。使用于用户要求备份 WorkBuddy 数据、迁移到新账号/新电脑、恢复任务、导出配置、修复跨平台路径错误、运行 wb-migrate 或处理 WorkBuddy 数据迁移时。支持 macOS/Windows/Linux 跨平台路径自动映射、同系统换账号 user_id 合并、恢复后自动创建工作区目录、自动注册 workspaces 表。
wb-migrate v2.0.3 — WorkBuddy 全量数据迁移是一项面向实际任务的技能,主要用于当用户提到以下需求时,使用此 skill;"备份 WorkBuddy 数据";
"wb-migrate"、"数据迁移";跨平台迁移时提示路径错误需要修复;1. 扫描当前数据;2. 创建备份;3. 查看备份内容 (含跨平台检测)。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
当用户提到以下需求时,使用此 skill:
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py scan
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py backup --output ~/Desktop
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py info
自动检测源/目标平台差异并给出建议
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore--dry-run
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore--auto-map
自动:检测源/目标 OS → 映射 sessions.cwd → 合并 user_id → 重命名 projects → 校验
目标账号 user_id 无法自动检测时:
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore--auto-map --target-user-id
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore--force
#windows运行bat @echo off REM wb-migrate — WorkBuddy 数据迁移工具 (Windows) REM 用法: wb-migrate.bat scan|backup|restore|info|migrate [参数...]
setlocal set SCRIPT_DIR=%~dp0 set PYTHON_SCRIPT=%SCRIPT_DIR%scriptswb_migrate.py
REM 查找 Python where python >nul 2>&1 if %ERRORLEVEL% EQU 0 ( set PYTHON=python ) else ( where python3 >nul 2>&1 if %ERRORLEVEL% EQU 0 ( set PYTHON=python3 ) else ( echo 错误: 未找到 Python,请先安装 Python 3.9+ 并添加到 PATH exit /b 1 ) )
"%PYTHON%" "%PYTHON_SCRIPT%" %*
从旧账号/旧设备恢复到新账号/新设备时,自动处理:
sessions.cwd 路径映射 (/Users/alice/ ↔ C:UsersAlice)user_id 合并 (源账号 → 当前账号)workspaces.path 更新projects/ 目录名重命名 (匹配新 cwd 编码).workbuddy/memory/ 结构workspaces 表,避免跨版本字段差异导致恢复失败~/.workbuddy 目录首次恢复时同样执行路径映射user_id 合并;目标账号未产生任何会话时,用 --target-user-id 显式指定每次恢复完成后自动检查:
workbuddy.db.backup-{ts})| 模块 | 路径 | 说明 |
|---|---|---|
| 数据库 | workbuddy.db | Sessions, Automations, Workspaces |
| Skills | skills/ | 用户创建的所有 Skills |
| 项目数据 | projects/ | 对话历史 (jsonl) |
| 连接器 | connectors/ | MCP 连接器配置 |
| 会话状态 | sessions/ | 活跃会话 |
| 本地存储 | local_storage/ | 键值存储 |
| 追踪日志 | traces/ | 执行历史 |
| 任务列表 | tasks/ | 任务管理 |
| 团队配置 | teams/ | 团队结构 |
| 文件历史 | file-history/ | 文件版本 |
| 身份文件 | SOUL.md 等 | 配置与偏好 |
恢复时采用以下策略避免数据覆盖:
在执行迁移任务时,需要了解以下关键知识:
| 平台 | cwd 示例 | project 目录名 |
|---|---|---|
| Windows | C:UsersAliceWorkBuddyxxx |
c-Users-Alice-WorkBuddy-xxx |
| macOS | /Users/alice/WorkBuddy/xxx |
Users-alice-WorkBuddy-xxx |
user_id 字段隔离,不同账号不可见~/.workbuddy/projects/// wb-migrate backup --output ~/Desktop # 切换账号,建议新账号先创建一次任意会话 wb-migrate restore ~/Desktop/wb-backup-*.tar.gz --auto-map
# macOS 上 wb-migrate backup --output ~/Desktop # 传输到 Windows 后 wb-migrate restore D:backup.tar.gz --auto-map
# 如果之前没加 --auto-map 导入,重新导入 wb-migrate restore backup.tar.gz --auto-map
--force 可强制覆盖--auto-map相关专题
热门下载
相关下载
精品课程
共1课时 | 295人学习
共1课时 | 248人学习
共1课时 | 204人学习
最新文章