飞书迁移助手

飞书迁移中的两个常见坑

飞书迁移需要用户在每一步确认写入，若由对话侧代跑迁移，确认门会失效，出问题也难归因。同时迁移涉及双端数据，对话侧不应读取或回显敏感信息，如 App Secret、token、Cookie 或完整身份标识。

它只做「引导」，不碰迁移执行

• 只读环境检查：读取 Node.js（≥20.12）、Python（≥3.10）和 feishu-move-cli 的运行时版本，固定为 0.5.0-beta.12。注意 --version 输出两行，只看第二行运行时版本，第一行只是包内常量。缺环境时指向官方说明，不替用户安装或改 PATH。
• 引导双 profile 授权：让用户创建或确认 source-a（A端只读）和 target-b（B端按需写入），授权在飞书官方页面或本机 CLI 完成，对话侧只检查状态，不接收 code、secret 或 token。
• 启动控制台并交还控制权：给出启动命令后，说明页面内的操作方式，说完就停下，不轮询进度、不代替用户点按钮、不接管运行中的迁移状态。

适用边界与注意点

• 不代跑迁移：不执行盘点、试迁、全量迁移、冲突裁决、增量追平或验收，所有写入由用户在控制台内确认。
• 数据安全：不上传迁移报告、SQLite 账本、日志、profile 配置或业务正文；A端 profile 只读，B端写入仅用户明确确认后由控制台执行。
• 高风险动作（如B端写入、覆盖合并、删除清理、重置账本、上传推送）仅用户在控制台操作，对话侧不预选、不催促、不代劳。
• 邮件域只允许归档，工具在策略层禁止发送、回复、转发和删除邮件。