workbuddy任务迁移skill

Polar Sponsor
爱发电 赞助
.NET 9.0

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

相关专题

更多
WorkBuddy团队协作与任务流程管理实战
WorkBuddy团队协作与任务流程管理实战

本专题围绕 WorkBuddy 协作工具展开,讲解任务分配、项目进度管理、团队协作优化、日程安排及报告生成技巧。通过实战案例,帮助企业提升团队工作效率与沟通协作水平。

2026.06.08

297

16

WorkBuddy协作工具使用与项目管理优化实践
WorkBuddy协作工具使用与项目管理优化实践

本专题聚焦 WorkBuddy 协作工具在企业项目管理中的应用,讲解任务分配、进度跟踪、团队协作、日程管理及报告生成技巧。通过实践案例,帮助团队提升工作效率、优化沟通流程,实现高效协作与项目执行。

2026.05.06

233

21

WorkBuddy安全架构与计费体系
WorkBuddy安全架构与计费体系

透明化WorkBuddy的计费模式与安全保障体系。清晰列出不同版本(免费版、专业版、企业版)的费用结构、功能差异与订阅方式;同时深入解读数据加密、访问控制、合规认证(如GDPR、ISO)等企业级安全特性,让您用得放心。

2026.04.09

184

12

WorkBuddy模型矩阵与技能扩展
WorkBuddy模型矩阵与技能扩展

揭秘WorkBuddy背后的智能引擎。本专题介绍所支持的大语言模型(LLM)类型、如何根据需求切换或配置模型,以及如何通过自定义指令、技能插件(Plugins)扩展WorkBuddy的能力边界,打造专属的智能办公伙伴。

2026.04.09

372

19

WorkBuddy生态集成与API配置
WorkBuddy生态集成与API配置

指导管理员如何将WorkBuddy无缝接入现有办公生态。内容涉及企业微信、钉钉、飞书等主流平台的集成步骤,以及Webhook、API密钥配置、单点登录(SSO)设置等高级接入选项,实现统一入口,提升协作体验。

2026.04.09

615

18

WorkBuddy核心功能与实操模式
WorkBuddy核心功能与实操模式

深入探索WorkBuddy的强大功能。本专题包含智能问答、文档处理、会议纪要生成、日程管理、任务协作等核心模块的操作指南与最佳实践。通过图文并茂的教程,助您快速上手,最大化发挥WorkBuddy的办公效能。

2026.04.09

442

19

WorkBuddy环境搭建与部署指南
WorkBuddy环境搭建与部署指南

提供详尽的WorkBuddy安装与部署指南。无论您是在Windows、Mac、Linux桌面端,还是在服务器或云端环境进行私有化部署,本专题都将一步步指导您完成环境准备、软件下载、安装配置及首次启动,确保系统平稳上线。

2026.04.09

616

26

WorkBuddy产品概览与核心价值
WorkBuddy产品概览与核心价值

本专题将带您快速了解WorkBuddy智能办公助手。内容涵盖产品定义、核心功能概览、适用场景分析以及它如何提升团队效率。无论您是初次接触还是希望深入了解,这里都有您需要的入门知识。

2026.04.09

363

19

WorkBuddy AI教程合集
WorkBuddy AI教程合集

本专题整合了WorkBuddy AI入门到精通合集,阅读专题下面的文章了解更多详细内容。

2026.04.03

907

38

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程