WorkBuddy 数据迁移工具 — 备份、恢复、跨账号/跨设备迁移对话任务、Skills、Automations、配置等所有数据。使用于用户要求备份 WorkBuddy 数据、迁移到新账号/新电脑、恢复任务、导出配置、修复跨平台路径错误、运行 wb-migrate 或处理 WorkBuddy 数据迁移时。支持 macOS/Windows/Linux 跨平台路径自动映射、同系统换账号 user_id 合并、恢复后自动创建工作区目录、自动注册 workspaces 表。
wb-migrate v2.0.3 — WorkBuddy 全量数据迁移
功能概述
wb-migrate v2.0.3 — WorkBuddy 全量数据迁移是一项面向实际任务的技能,主要用于当用户提到以下需求时,使用此 skill;"备份 WorkBuddy 数据";
核心要点
- "迁移到新账号/新电脑";
- "换账号后恢复任务";
- "导出 WorkBuddy 配置";
使用与执行
"wb-migrate"、"数据迁移";跨平台迁移时提示路径错误需要修复;1. 扫描当前数据;2. 创建备份;3. 查看备份内容 (含跨平台检测)。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
wb-migrate v2.0.3 — WorkBuddy 全量数据迁移
触发场景
当用户提到以下需求时,使用此 skill:
- "备份 WorkBuddy 数据"
- "迁移到新账号/新电脑"
- "换账号后恢复任务"
- "导出 WorkBuddy 配置"
- "wb-migrate"、"数据迁移"
- 跨平台迁移时提示路径错误需要修复
使用方法
1. 扫描当前数据
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py scan
2. 创建备份
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py backup --output ~/Desktop
3. 查看备份内容 (含跨平台检测)
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py info
自动检测源/目标平台差异并给出建议
4. 恢复备份 (智能合并,不覆盖已有数据)
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore
5. 预览恢复操作
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_migrate.py restore--dry-run
6. 跨平台自动映射恢复
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
7. 强制覆盖恢复
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%" %*
核心能力
跨平台路径与账号自动映射 (--auto-map)
从旧账号/旧设备恢复到新账号/新设备时,自动处理:
sessions.cwd路径映射 (/Users/alice/↔C:UsersAlice)user_id合并 (源账号 → 当前账号)workspaces.path更新projects/目录名重命名 (匹配新 cwd 编码)- 缺失工作区目录创建,并恢复基础
.workbuddy/memory/结构 - 按可用 schema 注册
workspaces表,避免跨版本字段差异导致恢复失败 - 空
~/.workbuddy目录首次恢复时同样执行路径映射 - 同系统换账号时也会执行
user_id合并;目标账号未产生任何会话时,用--target-user-id显式指定
恢复后自动校验
每次恢复完成后自动检查:
- sessions-cwd 有效性
- workspace 目录存在性
- projects 目录匹配
- tasks-sessions 关联
- user_id 一致性
安全增强
- 恢复前自动备份目标数据库 (
workbuddy.db.backup-{ts}) - SQLite 一致性快照备份,避免遗漏 WAL 中未 checkpoint 的数据
- 备份包完整性校验与安全解包,兼容 Python 3.9+
- 问题报告有明确的修复指引
备份包含的数据
| 模块 | 路径 | 说明 |
|---|---|---|
| 数据库 | workbuddy.db | Sessions, Automations, Workspaces |
| Skills | skills/ | 用户创建的所有 Skills |
| 项目数据 | projects/ | 对话历史 (jsonl) |
| 连接器 | connectors/ | MCP 连接器配置 |
| 会话状态 | sessions/ | 活跃会话 |
| 本地存储 | local_storage/ | 键值存储 |
| 追踪日志 | traces/ | 执行历史 |
| 任务列表 | tasks/ | 任务管理 |
| 团队配置 | teams/ | 团队结构 |
| 文件历史 | file-history/ | 文件版本 |
| 身份文件 | SOUL.md 等 | 配置与偏好 |
智能合并策略
恢复时采用以下策略避免数据覆盖:
- 数据库: INSERT OR IGNORE — 仅导入目标数据库中不存在的记录
- Skills: 按名合并 — 新文件直接添加,已有文件跳过
- 项目数据: 按目录合并 — 新项目直接添加
- 配置文件: 仅在目标不存在时创建
WorkBuddy 数据架构要点
在执行迁移任务时,需要了解以下关键知识:
路径编码规则
| 平台 | cwd 示例 | project 目录名 |
|---|---|---|
| Windows | C:UsersAliceWorkBuddyxxx |
c-Users-Alice-WorkBuddy-xxx |
| macOS | /Users/alice/WorkBuddy/xxx |
Users-alice-WorkBuddy-xxx |
数据隔离
- Sessions: 通过
user_id字段隔离,不同账号不可见 - Tasks: 挂在 session ID 下
- 对话数据:
~/.workbuddy/projects// / - Skills/Projects/Connectors: 不区分账号,所有用户共享
典型工作流
同机换账号
wb-migrate backup --output ~/Desktop # 切换账号,建议新账号先创建一次任意会话 wb-migrate restore ~/Desktop/wb-backup-*.tar.gz --auto-map
跨设备迁移 (macOS → Windows)
# 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
限制与注意
- 沙箱权限: 在 WorkBuddy Desktop 的「安全沙箱」模式下执行时,会弹出命令确认框,点击「允许」即可正常完成备份/恢复(整条命令执行期间不会再拦截)。也可切换为「完全放开」模式省去确认步骤。
- 二进制 (binaries/)、应用 (app/)、插件 (plugins/) 默认不备份
- 备份前建议关闭 WorkBuddy,避免数据库写入冲突
- 恢复时不覆盖已有数据,使用
--force可强制覆盖 - 跨平台迁移时务必使用
--auto-map
热门AI工具
相关专题
本专题围绕 WorkBuddy 协作工具展开,讲解任务分配、项目进度管理、团队协作优化、日程安排及报告生成技巧。通过实战案例,帮助企业提升团队工作效率与沟通协作水平。
297
2026.06.08
本专题聚焦 WorkBuddy 协作工具在企业项目管理中的应用,讲解任务分配、进度跟踪、团队协作、日程管理及报告生成技巧。通过实践案例,帮助团队提升工作效率、优化沟通流程,实现高效协作与项目执行。
233
2026.05.06
透明化WorkBuddy的计费模式与安全保障体系。清晰列出不同版本(免费版、专业版、企业版)的费用结构、功能差异与订阅方式;同时深入解读数据加密、访问控制、合规认证(如GDPR、ISO)等企业级安全特性,让您用得放心。
184
2026.04.09
揭秘WorkBuddy背后的智能引擎。本专题介绍所支持的大语言模型(LLM)类型、如何根据需求切换或配置模型,以及如何通过自定义指令、技能插件(Plugins)扩展WorkBuddy的能力边界,打造专属的智能办公伙伴。
372
2026.04.09
指导管理员如何将WorkBuddy无缝接入现有办公生态。内容涉及企业微信、钉钉、飞书等主流平台的集成步骤,以及Webhook、API密钥配置、单点登录(SSO)设置等高级接入选项,实现统一入口,提升协作体验。
615
2026.04.09
深入探索WorkBuddy的强大功能。本专题包含智能问答、文档处理、会议纪要生成、日程管理、任务协作等核心模块的操作指南与最佳实践。通过图文并茂的教程,助您快速上手,最大化发挥WorkBuddy的办公效能。
442
2026.04.09
提供详尽的WorkBuddy安装与部署指南。无论您是在Windows、Mac、Linux桌面端,还是在服务器或云端环境进行私有化部署,本专题都将一步步指导您完成环境准备、软件下载、安装配置及首次启动,确保系统平稳上线。
616
2026.04.09
本专题将带您快速了解WorkBuddy智能办公助手。内容涵盖产品定义、核心功能概览、适用场景分析以及它如何提升团队效率。无论您是初次接触还是希望深入了解,这里都有您需要的入门知识。
363
2026.04.09
热门下载
相关下载
精品课程
共1课时 | 295人学习
共1课时 | 248人学习
共1课时 | 204人学习
