概述
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 套件。
跨平台会话与上下文高保真零摩擦迁移（Claude Code / Codex / Cursor）
从 Claude Code、OpenAI Codex CLI 或 Cursor 迁入 Myrm 时，迁移向导不仅迁移静态规则与配置，还提供高保真历史会话与上下文无损接管：
诚实边界：
- 历史会话以结构化转录形式导入，归属指定 Agent Profile 并进入持久化数据库；
- 超长单行输出触发字符级保护性截断，确保模型在极端巨型日志下永不爆窗；
- 导入历史不重新执行已完成的外部工具副作用（如真实向远程发请求），确保历史安全只读。
- Harness 框架单测覆盖率：99%（
tests/runtime/context/test_transcripts_parser.py8/8 通过，覆盖率 99%）； - Server 迁移测试：
tests/services/migration/全套 232/232 PASS（覆盖 session_lane、payload_split、loader 与 e2e）； - 真实浏览器 Chrome MCP E2E：
tests/e2e/test_competitor_session_migration_chrome_e2e.py1/1 PASS（17.14s，无 Mock，全链路通过真实 WebUI 上传与 Review 弹窗渲染校验）。
回滚
每次导入都可完全撤销：- 前往 设置 → 记忆中心 → 近期导入
- 点击任意导入批次的 回滚
- 预览将要撤销的内容（回滚 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 脱敏：可选移除个人信息
- 质量过滤：最少轮数、最少内容长度、仅成功对话
- 增量导出：仅导出上次导出后的新数据
数据存储根路径安全迁移向导（DataRootPathMigrationWizard）与存储治理
随着项目积累与长周期运行，AI 产生的工作记忆、向量数据、快照与工件会逐渐膨胀。Myrm 提供企业级数据存储根路径安全迁移向导与多维存储治理系统：核心安全机制与防线
- 三道硬核预检防线：
- 防自嵌套校验：严禁将存储根路径迁移到当前数据目录或其子目录中，彻底杜绝目录移动导致的无限递归死循环。
- 1.2x 剩余空间硬指标预检（Headroom Preflight）：迁移前精确测算目标分区可用空间，必须满足源数据体积的 120% 以上，防止跨盘写入中途爆盘导致 SQLite WAL 撕裂。
- 目标路径冲突隔离：目标路径已存在有效数据时阻断并安全隔离，杜绝覆盖危险。
- 两阶段敏感操作票据（Sensitive Action Ticket）：
- 采用短效、单次消费的数字签名票据，必须先完成 Dry-Run 预检并由用户显式确认方可执行迁移，杜绝 CSRF 劫持与前端误触。
- 后台活跃任务感知与排他写锁互斥：
- 自动感知后台在途长任务（如持久化后台 Shell 脚本、评测任务），若有活跃任务正在运行，立即拦截并返回动态任务数提示（409 冲突），避免任务中途写撕裂；
- 迁移期间全局获取排他写锁，执行 WAL TRUNCATE 刷盘同步，迁移完成后平滑切换。
- 故障秒级原子回滚：
- 迁移全过程具备细粒度事务补偿能力，如遇跨文件系统（EXDEV）复制中断或意外断电，系统在秒级内自动回滚源目录状态并物理清除目标临时碎屑，保持 0 损坏、0 残留。
- 多维存储画像因果分解与在线零停机瘦身：
- 精细化呈现 SQLite 数据库、Qdrant 向量索引、会话快照与媒体资源的存储分布；在系统空闲时支持一键无锁
VACUUM整理碎片，通常可释放 40%~60% 的冗余磁盘空间。
- 精细化呈现 SQLite 数据库、Qdrant 向量索引、会话快照与媒体资源的存储分布；在系统空闲时支持一键无锁
竞品对比
对比目标：Hermes、OpenClaw、Codex、DeepSeek-Harness、Pi、OpenCode。从 WorkBuddy / 腾讯 WeKnora 过来？
目前还没有一键导入器（WorkBuddy 闭源无导出格式；WeKnora 数据在其自有 Go/Postgres 栈内）——但每条工作流都能 1:1 对应，且跑在更强的引擎上：
诚实说明（在补齐中，不隐藏）：一键提示词增强、输出风格预设（表格直出/无开场白）、只读问答模式、Agent 自动生成 Wiki＋版本回滚、扩展连接器矩阵（飞书 Drive 保结构同步、Notion、GitLab、钉钉文档、RSS）。明确不做：多租户 Workspace RBAC（与单用户单沙箱架构冲突）、CLI 产品（GUI 优先）。