Manus 3.8升级至4.x需通过内置migrate-from-38命令迁移数据，因存储结构从SQLite原生表变为加密+版本化blob，直接复制会导致schema mismatch；须验证旧库完整性、补全role/status字段、检查replays目录，并启动后验证任务数、日志及权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Manus 3.8老版本数据导入新版时若直接复制数据库或跳过格式校验，极大概率触发 schema mismatch 错误导致服务启动失败、用户配置消失、任务历史清空——因为3.8使用 SQLite 原生表结构存储回放元数据与任务快照，而4.x起已强制切换为加密+版本化 blob 存储，并引入 runtime_schema_version 字段校验。
确认旧数据位置与完整性
进入 Manus 3.8 安装目录，检查是否存在 【data/】 子目录；该目录下必须包含 manus.db（主数据库）和 replays/ 文件夹（任务回放文件）。若 replays/ 为空或缺失，说明历史执行过程已不可恢复，仅能保留配置类数据。
用 sqlite3 命令行快速验证数据库可读性：sqlite3 data/manus.db "PRAGMA integrity_check;"。返回 ok 才可继续，否则需先用 sqlite3 data/manus.db ".recover" | sqlite3 data/manus.db-recovered 尝试修复。
使用内置迁移命令一键导入
新版 Manus（≥4.0）自带向下兼容迁移器，不依赖外部脚本或手动 SQL 改写。
停止旧版服务后，在新版本安装根目录下执行：./manus migrate-from-38 --db-path ../old-manus-38/data/manus.db --replay-dir ../old-manus-38/data/replays。
该命令会自动完成三件事：解析 3.8 的 raw task JSON 结构 → 映射到新版加密 schema → 重签名 replay 文件哈希并注入时间戳锚点。过程中若遇到某条任务含非法 Unicode 字符（如 U+FFFD），迁移器会跳过该条并记录 warn 日志，但不影响其余数据。
手动补全缺失字段（仅当迁移命令报错退出时启用）
方法一：修正用户权限字段
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
旧版 manus.db 中 users 表的 role 列值为字符串（如 "admin"），新版要求为整型枚举。需在迁移前用 DB Browser for SQLite 打开旧库，执行 SQL：UPDATE users SET role = CASE role WHEN 'admin' THEN 1 WHEN 'user' THEN 2 ELSE 2 END;
方法二：补全任务状态默认值
3.8 的 tasks 表中 status 列允许 NULL，而新版强制非空。执行：UPDATE tasks SET status = 'completed' WHERE status IS NULL AND result IS NOT NULL; → UPDATE tasks SET status = 'failed' WHERE status IS NULL AND result IS NULL;
【注意：这两条 UPDATE 必须按顺序执行，否则 failed 任务会被错误标记为 completed】
启动新版并验证关键数据
运行 ./manus start 启动服务。
打开浏览器访问 http://localhost:3000 → 登录后立即检查三项：左侧导航栏是否显示「历史任务」数量与旧版一致；点击任意一条任务详情页，确认「执行日志」和「输出文件列表」可展开且内容可读；在设置 → 用户管理中，核对所有账号角色与权限开关状态是否还原。
若「历史任务」计数正确但某几条详情页报 500 错误，说明对应 replay 文件损坏，需从旧环境单独拷贝该 replay ID 对应的 .zip 文件到新版 data/replays/ 目录并重启服务。
