Appearance
账号与工作区迁移
本章目标
把“换设备、换账号、换目录、更新客户端”拆成可回退的迁移任务。迁移的结果不是“应用能打开”，而是目标账号能在正确的工作区找到应保留的产物，并且连接器、Skill 和权限已经重新核对。
什么时候适用
- 更换电脑或系统，需要继续处理原有任务和文件；
- 同一台设备从一个账号切换到另一个账号；
- 工作区从临时目录迁到项目目录；
- 更新客户端前，需要确认本地资料和配置可以恢复。
前置条件
- 记录当前客户端版本、系统、账号、工作区路径和最近一次成功任务。
- 列出必须保留的任务产物、原始文件、Skill 配置和连接器清单；把不确定的内容标为待确认。
- 确认目标账号、目标设备和目标目录都已经获得组织允许，重要资料先做可读的备份。
- 准备一份脱敏小样本，用于迁移后验证；不要直接拿客户资料做第一次试跑。
迁移清单：先分对象，再决定动作
| 对象 | 迁移时检查什么 | 推荐动作 |
|---|---|---|
| 任务与产物 | 文件是否完整、是否有未完成任务 | 先复制或导出，再用样本打开 |
| 工作区 | 路径、读写权限、磁盘空间 | 在目标位置建立独立目录并记录路径 |
| Skill | 来源、版本、配置和依赖 | 逐项重新核对，不把未知脚本一起带入 |
| 连接器 | 授权人、数据范围、读写能力 | 在目标账号重新授权，先只读验证 |
| 密钥与会话 | Token、Cookie、临时登录状态 | 不复制到迁移包，按当前产品和组织流程重新配置 |
分步操作
1. 先做迁移前快照
用一张表记录“旧环境事实”和“迁移后预期”：账号标识、客户端版本、工作区路径、待迁移文件数量、最近任务、连接器名称、Skill 名称和验证方式。只记录必要信息，不把密码、长期令牌或私有链接写进表格。
2. 退出正在运行的任务
停止自动化和外部写入，等待正在生成的产物落盘；确认 WorkBuddy 主窗口、托盘进程和相关编辑器已经关闭。若任务处在未知状态，不要边迁移边重新触发，先保存错误和时间。
3. 复制可迁移资料
优先复制原始文件、已验收产物和必要的任务说明，保留目录结构和文件名。对大批量文件先做数量、大小和抽样校验，避免用“能看到文件夹”代替完整性判断。原目录先保留一段观察期，不要把迁移成功理解成可以立即删除旧资料。
4. 在目标环境恢复工作区
登录目标账号后，建立一个与项目对应的独立工作区，确认 WorkBuddy 对该目录具有当前任务所需的权限。先打开脱敏样本，验证读取、保存、导出和中文路径等基本动作，再处理真实资料。
5. 重新配置 Skill 和连接器
Skill 先按来源、版本和用途逐项安装或启用；连接器先确认账号、组织、资源范围和读写权限，再执行只读查询。不要把旧账号的授权状态、缓存或密钥当作目标账号已经获得的权限。涉及发送、发布、写回或删除时，保留预览并等待人工确认。
6. 用最小任务验收
使用一份已知样本完成“读取一份文件、生成一份草稿、保存到目标目录”的小任务。验收工作区、来源、文件数量、产物内容、权限和日志；通过后再恢复日常任务或定时执行。
验收标准
- 目标账号、目标工作区和实际执行身份可以互相对应；
- 原始资料和已验收产物数量、大小、抽样内容可核对；
- 目标目录没有意外覆盖，迁移前备份仍可读取；
- Skill 与连接器按最小范围重新验证，未继承未知授权；
- 一条低风险样本任务成功，产物路径、来源和人工确认点清楚；
- 迁移失败时可以回到旧环境，不需要删除或覆盖旧资料。
失败处理与停止条件
- 找不到旧资料： 先检查原工作区、备份和路径权限，不用模型补写缺失文件。
- 目标账号看不到任务： 区分账号切换、工作区路径和云端同步边界，不要反复导入同一份迁移包。
- 连接器失效： 重新核对授权人和资源范围；写入或外发失败时保留错误原文并停止。
- 迁移后出现重复产物： 暂停自动化，保留时间线和目录清单，先确认哪一份是主版本。
- 疑似数据丢失、凭证泄露或账号异常： 立即停止迁移，保留备份和诊断摘要，联系当前官方支持或组织管理员。
常见问题
更新客户端等于迁移账号吗？ 不等于。更新关注程序版本，迁移还要处理账号、工作区、产物和重新授权。
能不能把整个旧目录直接压缩后导入？ 只有在当前产品和组织流程明确支持时才这样做。未知缓存、会话和凭证可能带来权限或兼容问题。
迁移后是否应该立即清理旧设备？ 不应立即清理。至少完成样本任务、产物抽查和回退验证，再按组织保留策略处理旧资料。
安全与权限边界
- 迁移包、备份和日志按原资料敏感级别管理；
- 不在聊天、截图、仓库或提示词中粘贴密码、Token、Cookie、App Secret 或私有链接；
- 个人账号可访问的内容不自动等于目标账号、连接器或自动化可以访问；
- 企业资料、客户文件、人事和财务数据迁移前需要资料负责人确认；
- 迁移脚本、安装包和第三方 Skill 的来源与完整性无法确认时，不执行。
相关内容
来源引用
- SRC-UPSTREAM-CH02：安装、登录、更新和迁移前环境核对的基础资料，经重新组织为安全迁移流程。
- SRC-UPSTREAM-CH03：任务、工作区和文件边界，经重新组织为迁移验收清单。
- SRC-UPSTREAM-CH07：连接器授权、只读验证和回收边界。
内容版本与核对日期
- 内容版本：
0.1.0 - 最后核对日期：
2026-09-26 - 适用版本状态：迁移入口、工具和可恢复范围以当前客户端、官方说明和实际账号权限为准。
- 来源提交版本：
6b5e2403f0f2ad5d3f7ab7a67e9c4d4113583ff3