前言¶
换电脑、重装系统，几百个对话任务和调好的技能全没了；换公司账号，历史和自动化搬不过去；macOS 与 Windows 之间路径全是 /Users/xxx，恢复完一堆报错；一台电脑登两个账号，数据混在一起分不开；备份包传输出错、拷了一半，恢复完才发现文件是坏的；恢复操作做错了，想撤销却没有后悔药。
这些问题，都是 WorkBuddy 用户在迁移或切换环境时经常遇到的痛点。WorkBuddy 自身没有内置的备份与迁移能力，要解决这些问题，需要一套对 WorkBuddy 数据结构有深入理解的命令行工具。workbuddy任务迁移skill 就是为此设计的一套自动化迁移与备份方案。
是什么¶
这是一个为 WorkBuddy 设计的数据迁移与备份工具，由社区用户 user_a4bd4246 维护，目前版本 3.3.2。它支持全量或按模块导出 WorkBuddy 的各类数据（对话、任务、记忆、配置、连接器、专家、定时任务、技能、产物、分享文件、应用、助理），并生成带校验的备份包；恢复时支持覆盖/合并/重命名三种冲突策略，导入前自动快照并可一键回滚；敏感信息（Token、密钥、凭据）默认脱敏；支持 macOS/Windows/Linux 跨系统路径自动映射与同设备多账号切换。
核心功能¶
12 个模块，可按需挑¶
不用每次都全量搬，也可以只迁技能或只迁对话。
| 模块 | 内容 |
|---|---|
| 对话 | 会话、工作区、使用统计、信任决策 |
| 任务 | 任务、计划、待办 |
| 记忆 | 记忆文件与用户级存储 |
| 配置 | settings / models / MCP 审批等 8 个配置文件 |
| 连接器 | MCP 配置与连接器目录 |
| 专家 | 专家实体（含 5.9 的 plugins/cache/experts）与插件注册表 |
| 定时任务 | 自动化定义、运行记录、投递队列 |
| 技能 | 已安装技能全量 |
| 产物 | 文件历史、剪贴板图、媒体索引等 |
| 分享文件 | 已发布分享的部署历史 |
| 应用 | 已部署应用与快照 |
| 助理 | SOUL / IDENTITY / USER / MEMORY 等人格文件 |
备份包可校验，不是「拷个压缩包」¶
备份包采用结构化格式（manifest + checksums.sha256），恢复前先跑 sha256 校验链；包被改动或损坏会被直接拒绝，绝不会写入一半数据。支持断点续传，大包中断后从句点接着打。
三种冲突策略，不赌运气¶
merge（默认）— 只补不覆盖，已有数据不动overwrite— 覆盖但先自动快照rename— 冲突项改名成*.imported-{时间戳}导入，目标原有数据零改动
恢复前可预览，恢复后可回滚¶
--dry-run 影子恢复，零写入先看会改哪些文件；每次恢复自动生成快照，rollback --latest 一条命令退回。回滚本身也能 --dry-run 预览。
敏感信息默认脱敏¶
Token、密钥、凭据在导出时自动打码，备份包可以放心传网盘、发给同事。
跨系统路径自动映射¶
--auto-map 自动处理 /Users/alice → /Users/bob、C:\Users\Alice → /Users/li、Windows 换盘符、projects 目录重命名、账号 user_id 合并、工作区补建 —— 迁完不用手工修路径。
同设备多账号切换¶
accounts 查看本机所有账号与当前活跃账号；switch --to <账号> 按账号物理隔离存储，切走即切片、切回即还原。切前自动备份，失败自动回滚。
自带自检，不靠猜¶
compat 输出环境兼容性报告（OS / Python / 编码 / 文件系统大小写 / 长路径 / WorkBuddy 版本判定）；selftest 在任意平台跑 18 项端到端用例，验证打包、校验、脱敏、三策略、回滚、破损拒绝全链路。
Windows 免手动自动恢复¶
Windows 下运行时数据库被进程锁住，直接恢复会被拒绝。wb_auto.py 注册计划任务作为看门狗，你一退出 WorkBuddy 就自动执行恢复，完成后可选自动重开 —— 不用再记着「先退托盘再双击 bat」。
安装与启用¶
SkillHub 上的包名是 workbuddy任务迁移skill，版本 3.3.2。安装后，核心脚本位于 .workbuddy/skills/wb-migrate/scripts/ 下，三端统一入口为 scripts/wb.py。安装后无需额外配置，直接使用命令行即可。
典型用法¶
安装后，先确认环境兼容性：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py compat
查看本机有哪些数据：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py scan
全量备份（默认脱敏）：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py backup -o ~/Desktop
只备份部分模块（例如技能和记忆）：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py backup -o ~/Desktop --modules skills,memory
校验备份包完整性：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py info <包> --verify
恢复前先预览（零写入）：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py restore <包> --dry-run
跨设备恢复（自动映射路径）：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py restore <包> --auto-map
不满意就回滚：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb.py rollback --latest
在 Windows 上，可以使用 wb_auto.py 注册计划任务，退出 WorkBuddy 后自动执行恢复并可自动重开：
python3 ~/.workbuddy/skills/wb-migrate/scripts/wb_auto.py
兼容性与限制¶
- 国内版 WorkBuddy 5.6 – 5.9（5.9.0 实测）；低于 5.6 仅允许读取式备份
- macOS 12+ / Windows 10 1809+ / Linux
- Python 3.9+，只用标准库，不装任何第三方包
- 备份包格式 v3，同时兼容读取 v1 / v2 旧包
适合谁¶
经常换设备或换账号的重度用户、需要把环境交接给同事的团队、在 macOS 和 Windows 之间来回切的人、一台机器登多个账号的人，以及任何「数据丢了会很痛」的人。
结尾¶
这套工具把 WorkBuddy 的迁移与备份从「手工拷文件、靠运气」变成「一条命令、自动校验、可回滚」的标准化流程。如果你正在为换设备、换账号、跨系统迁移而头疼，可以尝试安装这个 Skill，把你的数据完整带走。
官方地址：https://api.skillhub.cn/user_a4bd4246/workbuddymigrate
