用途：把遗留或 v2 时代的 Flexport 集成安全迁移到当前 v3 REST 端点或 MCP 工具，核心约束是同一时间只允许一个受控写入者，绝不为了比较系统而双写货运或重复创建贸易记录。
主要能力：提供六步流程——1) 盘点现实，追踪每个遗留路径、版本头、响应假设、事件名、展开参数、凭证与变更操作；2) 映射到有文档的目标，按业务结果选择 v3 REST 端点或 MCP 工具，对不支持的字段与操作如实记录而非猜测；3) 构建容错读取器，接受文档化信封与新增字段，保留不透明标识符，并为新旧差异添加脱敏夹具；4) 仅做影子读取，在获批样本上比较当前与目标读取路径，只归一化业务事实并调查差异；5) 单个写入者切换，冻结遗留变更队列、核对在途操作、切换唯一权威写入者，并保留不会产生并发写入的快速回滚；6) 验证并退役，在切换窗口内核对提供方资源、事件与本地操作键后再移除旧凭证与代码。
认证：REST 调用使用缓存 OAuth 2.0 客户端凭证 Bearer 令牌，受众为 https://api.flexport.com，或显式接受宽泛 API 密钥；每个工作负载使用独立凭证，绝不记录凭证或令牌。MCP 调用使用到 https://mcp.flexport.com/mcp 的已认证连接，并受各工具文档化账户权限约束。
适用场景：需要盘点旧 Flexport 集成、做只读对比、制定字段映射和回滚计划、执行一次受控写入切换的迁移项目。
限制与错误处理：无映射字段时升级业务依赖，不得虚构目标；读取对比出现分歧时暂停切换并核对版本、展开、分页与语义；两个写入者同时活跃时冻结双方、核对提供方状态并恢复单一所有者；回滚可能重复货运时，须先核对操作标识再执行。输出为范围明确的决策或实现产物、脱敏的操作与验证回执，以及失败、回滚与后续责任记录。