概述
Myrm 提供完整的数据迁移系统，支持从多个平台导入 AI 助手数据——包括记忆、技能、API 密钥、MCP 配置和工作区规则——具备完整预览、冲突处理和一键回滚能力。 支持的数据源（14 种，11 种已就绪）：Hermes、OpenClaw、Pi、Claude Code、Cursor、Codex、ChatGPT、gbrain、Mem0、原生 JSON、Myrm Archive、AgentMemory —— Windsurf、Trae、MemWeaver 处于规划开发中迁移向导（3 步 GUI）
第 1 步：发现
前往 设置 → 记忆中心 → 迁移 启动向导。- 本地/桌面端：点击 扫描 自动检测系统中已安装的 AI 助手
- 云端：拖拽上传来自其他助手的
.zip导出文件
第 2 步：预览（Dry-Run）
点击任意检测到的数据源上的 预览，查看将要导入的内容——不会写入任何数据：- 覆盖矩阵：展示哪些数据类别已就绪、需审核或需手动操作
- 迁移车道：人设 → Agent、事实 → 记忆、技能 → 审核队列、密钥 → 显式确认、MCP → 审核
- Token 经济性：对比迁移前后的 token 用量
- MCP 服务预览：查看导入后可用的 MCP 工具
- 冲突检测：高亮标注将覆盖现有数据的条目
第 3 步：确认并导入
选择目标 Agent（或创建新 Agent），然后确认导入：- 密钥仅在用户显式同意后导入（绝不静默导入）
- 技能进入审核队列——由你逐个批准后才激活
- 每次导入生成唯一的事务批次 ID
- ZIP 技能迁移在预览和确认阶段使用一致的错误契约（
message + error_code），前端提示行为确定可预期
导入后 Readiness（首聊引导）
导入成功后，Myrm 会在首条消息前 live-resolve readiness——不会让用户猜「为什么聊不了」。
设计原则：
- 软门禁 — assistant 仍可回复，给引导而非硬阻断
- Issue-aware CTA — 每个 gap 直达对应设置页（
settings_pathSSOT） - Wizard recheck — 迁移结果页可重新检查 readiness 再「开始聊天」
- Queue anchor — handoff 状态跨页面保留至首聊消费
Hermes 定时任务导入（默认暂停）
从 Hermes 迁移时，向导可导入cron/jobs.json 中的定时任务：
诚实边界：
- 不迁移 Hermes model 字段——任务使用目标 Agent 默认模型
- Kanban 看板不自动迁移（覆盖矩阵显示
kanban_not_migrated） - Cron 导入尚无 Chrome MCP E2E 签收——后端由
test_hermes_cron_converter.py7/7 通过（2026-08-03）覆盖
claw migrate、OpenClaw、Pi、deer-flow、LobsterAI、CoPaw、jiuwenclaw）均无 GUI 迁移向导 + cron 预览/暂停导入/回滚。
Pi 迁移（五车道映射）
从 Pi 迁移时，向导自动扫描~/.pi/agent/ 目录并提供五车道映射：
边界保护：
- 未知 session 版本（≠ v3）自动跳过，不报错
- 空消息、非法 JSON、非 dict content 等异常行均安全跳过
- Pi 无 MCP 配置（技术栈差异），不影响迁移完整性
test_pi_migration.py 25/25 PASS（覆盖发现/加载/会话解析/技能/凭证/边界保护共 6 类 25 场景）
Hermes MoA 参考模型导入（向导 Confirm）
Hermesconfig.yaml 含 moa 块时，迁移向导 confirm 可将参考模型写入目标智能体 engine_params.moa_overlay：
诚实边界：
- 仅导入 default preset 的 ref 集（多个 preset 不同 ref 池 → 请建多个智能体 Profile）
- 不迁移 Hermes aggregator 模型 — Myrm 主模型吸收顾问输出（设计如此）
- 须先在 Myrm 配置 provider；不可解析的 ref 会跳过并写日志
test_hermes_moa_migrator.py 19/19 + import confirm 集成 — 属 30/30 MoA server pytest 套件。
回滚
每次导入都可完全撤销：- 前往 设置 → 记忆中心 → 近期导入
- 点击任意导入批次的 回滚
- 预览将要撤销的内容（回滚 dry-run）
- 确认后恢复到之前的状态
备份与远程同步
本地备份
随时创建所有记忆的手动备份：- 设置 → 系统 → 备份 → 创建备份
- 存储内容：所有记忆类型、共享上下文、对话历史
- 支持列表查看、恢复或删除备份
远程备份（S3 / WebDAV）
配置自动同步到云存储：- S3 兼容：任何提供商（AWS S3、Cloudflare R2、MinIO 等）
- WebDAV：NAS 设备、Nextcloud、ownCloud 等
新用户引导
首次启动 Myrm 时，引导向导 会自动检查系统中是否存在其他 AI 助手的数据。如果发现，将提供一键迁移路径——让你的第一次对话就已拥有你的人格、记忆和工具。 聊天窗口中也会在检测到外部数据时显示 发现横幅，提供快速访问迁移向导的入口。导出
全量归档备份与恢复
将整个 Myrm 工作区导出为结构化归档，保留所有数据关系：- 对话：完整消息历史，包含压缩状态（摘要）、会话笔记、工具使用统计和 token 费用汇总
- 记忆：所有记忆类型（情景、语义、程序性、偏好、共享上下文）
- Agent 配置：完整 Agent 配置文件（模型、提示词、技能、MCP 绑定）通过 JSON 导出/导入
- 分区选择性恢复：导入完整归档或选择特定分区（仅对话、仅记忆等）
跨部署迁移（本地 ↔ 云端）
Myrm 在所有部署模式中使用 SQLite 作为单一数据存储。在本地 WebUI、Tauri 桌面端和云托管之间迁移是无缝的：- Volume 复制：直接复制 SQLite 数据库文件——零数据丢失、零格式转换
- 归档路径：从一个部署导出完整归档，在另一个部署通过分区选择恢复
数据集导出
将对话数据导出为训练就绪格式：- ShareGPT：标准微调格式
- PII 脱敏：可选移除个人信息
- 质量过滤：最少轮数、最少内容长度、仅成功对话
- 增量导出：仅导出上次导出后的新数据