mulit-agent/mulit_agent/docs/steps/07-兼容迁移与故障恢复.md

07：兼容迁移与故障恢复

1. 盘点现有 FastAPI Agent 的配置、Provider、任务、技能、插件、cron 和日志，标注可直接复用、需适配和暂不迁移的部分。
2. 先将现有业务逻辑封装为不依赖 FastAPI 路由的服务，再由新的 Qt 传输层调用；避免复制代码。
3. 创建旧配置和本地数据导入器，导入前备份、导入后校验；新数据目录默认与旧 Agent 隔离。
4. 为旧控制端/旧 Agent 提供版本协商或协议适配器，制订灰度启用和回退步骤。
5. 演练断网、控制端重启、进程崩溃、磁盘空间不足、Provider 故障和不兼容策略下的恢复行为。

验收：代表性旧实例可在不覆盖原数据的情况下迁移；恢复演练后不丢失最终任务结果或重复执行任务。