前言¶
换电脑时，WorkBuddy 的搬家比想象中麻烦：工作区里的 skills、memory、conversations、automations、sessions 散落在多处目录，MCP 与 connectors 配置、IDENTITY/SOUL/USER、personalization 自定义指令、专家偏好 storage、artifact-index 会话产物索引、buddy_snapshots 行业 Buddy 应用配置快照、MCP OAuth 凭证还要逐项核对路径。手工复制往往漏项，跨平台时旧机器的绝对路径在新机器上还要重写。
下面介绍 workbuddy-migration-assistant，它把这些步骤收敛成一条导出/导入命令，并把错误收敛成稳定错误码。
这是什么¶
workbuddy-migration-assistant 是一个面向 WorkBuddy 国内版的跨机器资产迁移 Skill，适配客户端 5.5.1。坐标 @user_814dbe54/workbuddy-migration-assistant，来源 community，发布者 user_814dbe54，版本 1.9.0，分类 it-ops-security，标签 requires_api_key=false（不需要 API Key）。
它解决的问题是：旧机器上的全部个人资产整体搬到新机器，且导入后能知道搬全了没有。
SkillHub 页面上的评分 100000，下载 13930 次。
核心功能¶
资产范围¶
覆盖的目录与配置包括：
- skills、memory、conversations、automations、sessions
- MCP/connectors 配置、MCP OAuth 凭证
- IDENTITY/SOUL/USER
- 自定义指令 personalization
- 助手显示配置、专家偏好 storage
- 会话产物索引 artifact-index
- 行业 Buddy 应用配置快照 buddy_snapshots
两包分离的导出¶
导出拆成主包与产物包两个包。主包承载配置类资产，产物包承载 artifact-index、buddy_snapshots 这类产物类数据，两者分开传输，避免单个大包在拷贝中断时全部作废。
预设档位¶
用 --profile 指定预设，免拼长参数：
lite：快速迁移，只搬必要项full：完整搬家backup：本机备份，不做跨机搬运
导入策略¶
导入默认合并、不覆盖，冲突项单独检测并报告，不会静默覆盖新机器已有配置。跨平台场景用 --auto-map（或 --profile auto）零配置处理路径映射，其中包括 artifact-index 中 URL 编码路径的重写。
导入后校验¶
导入结束自动跑资产校验，verify 报告格式为「X/X 项就位」，可以直接据此判断是否漏项。
错误码与沙箱前置检测¶
全部错误带稳定错误码，例如 E-LOCK、E-SANDBOX，对照 references/faq.md 速查表可以一步定位。导入前会检测沙箱是否拦截了写操作（strip_write）；被拦截时明确报错并提示关闭沙箱后重跑，而不是继续写一半。
安装与启用¶
官方抓取到的资料里只有坐标与来源信息，没有给出公开的包管理器安装命令，所以下面不臆造命令。
已知的启用要素：
- 坐标：
@user_814dbe54/workbuddy-migration-assistant - 来源：community，发布者
user_814dbe54 - 版本：1.9.0
- 分类：it-ops-security
- API Key：不需要
- 官方地址：https://api.skillhub.cn/user_814dbe54/workbuddy-migration-assistant
- SkillHub 页面：https://www.skillhub.cn/skills/user_814dbe54/workbuddy-migration-assistant
实际安装命令请以官方页面为准。如果本地已通过其他方式装入该 Skill，先确认 SKILL.md 与 references/faq.md 都已就位，再调用导出/导入命令。
触发词为：WorkBuddy 迁移、资产迁移、换电脑搬家、迁移助手、搬家工具、数据迁移。
典型用法¶
以下为官方简介中给出的参数形态，具体命令以本地 SKILL.md 为准。
导出主包与产物包：
workbuddy-migration-assistant export --profile full
这句做的事是：把旧机器的资产按主包 + 产物包两包输出，full 档位覆盖全部资产范围。
跨平台迁移到新机器：
workbuddy-migration-assistant import --profile auto
这句做的事是：导入时零配置自动处理路径映射，包括 artifact-index 的 URL 编码路径重写，冲突项只报告不覆盖。
导入后校验：
workbuddy-migration-assistant verify
这句做的事是：核对资产是否就位，输出「X/X 项就位」。
只做本机备份时把档位换成 backup：
workbuddy-migration-assistant export --profile backup
遇到写入被沙箱拦截时，先关沙箱再重跑，不要绕过检测手动复制。
适用场景与注意¶
适合的场景：WorkBuddy 国内版 5.5.1 用户换新电脑，需要把 skills、memory、conversations、automations、sessions、MCP/connectors 配置、IDENTITY/SOUL/USER、personalization、storage、artifact-index、buddy_snapshots、MCP OAuth 凭证等一并搬走；也适合先在本机做一份可回滚的完整备份。
注意点：
- 客户端版本需为国内版 5.5.1，其他版本不在适配范围内。
- 沙箱若开启 strip_write 类的写拦截，导入会被前置检测拦下，需要关闭沙箱后重跑。
- 导入默认合并不覆盖，如果希望用旧机器资产完全替换新机器内容，需自行确认冲突项的处理结果。
- 跨平台路径差异交给
--auto-map/--profile auto，手工指定映射容易漏掉 artifact-index 的 URL 编码路径。 - 报错先看
references/faq.md速查表，按错误码定位，不要靠猜测改配置。 - 迁移涉及 OAuth 凭证，导出的包不要随意分发，也建议在传输完成后清理中间产物。
结尾¶
workbuddy-migration-assistant 把换机搬家从「逐个目录手工复制」变成「导出两包 → 导入合并 → verify 校验」三步，并靠错误码和沙箱前置检测把失败原因明确暴露出来。官方地址：https://api.skillhub.cn/user_814dbe54/workbuddy-migration-assistant
