阶跃ai知识库迁移需确保结构化数据、附件、权限及操作记录完整导入，严格遵循导出格式、字段校验与映射规则。必须使用.zip导出并勾选“包含操作日志”和“保留原始时间戳”，metadata.json须含7个必填字段且时间符合iso 8601；校验须用官方工具或手动修复json类型；导入时须正确映射字段并启用历史版本继承，失败项需补传附件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
阶跃AI智能办公知识库迁移需确保旧文档系统中的结构化数据、附件、权限关系和历史操作记录完整导入新平台，避免内容断层或检索失效。迁移过程必须保留原始文档的创建时间、修改人、版本链路与标签体系，否则新平台将无法支撑合规审计与知识回溯。
确认源系统导出格式与字段映射
登录旧文档系统后台，进入「系统管理→数据导出」模块，选择「全量知识库导出」；【必须勾选“包含操作日志”和“保留原始时间戳”两项】，否则新平台无法还原编辑链路与责任归属。
导出格式仅支持 .zip 压缩包（内含 JSON 元数据 + /attachments 子目录），不支持 CSV 或 Excel；若导出为其他格式，阶跃AI新平台解析器将跳过全部附件并报错 406。
打开导出包内的 metadata.json，检查是否包含以下7个必填字段：id、title、content、created_at、updated_at、creator_id、tags；缺少任一字段会导致该文档在新平台中显示为空白页。
清洗与校验导出数据
方法一：用阶跃AI官方校验工具（v2.3.1+）自动扫描
下载校验工具后解压，双击 run_check.bat，将导出的 .zip 拖入窗口；工具会逐项检测附件路径有效性、JSON 字段完整性、时间格式是否符合 ISO 8601（如 2025-03-17T09:22:14+08:00）；发现错误时直接高亮行号并暂停，不可跳过修复。
方法二：手动校验关键字段
用 VS Code 打开 metadata.json → 按 Ctrl+Shift+P → 输入「JSON Validate」→ 回车；若提示 schema mismatch，说明 creator_id 类型为字符串但新平台要求为整数，需全局替换 "creator_id": "1024" → "creator_id": 1024；【注意：引号内的数字必须去掉引号，否则导入后所有文档作者显示为“未知”】。
执行导入并验证映射结果
第一步：登录阶跃AI新平台管理员后台 → 进入「知识库→批量导入」→ 点击「上传 ZIP 包」按钮。
第二步：上传成功后，页面自动跳转至字段映射界面；左侧为旧系统字段名，右侧下拉框必须手动匹配到新平台对应字段——例如旧系统的 tags 必须映射到新平台的 keyword_tags，而非 system_tags，否则全文检索无法命中。
第三步：勾选「启用历史版本继承」→ 点击「开始导入」；导入过程中不可关闭浏览器或刷新页面，否则中断任务将丢失已导入文档的版本链路。
第四步：导入完成页显示「100% 成功，共处理 2,841 条文档」后，立即点击「查看导入报告」→ 下载 report.csv → 用 Excel 打开，筛选 status 列为 failed 的行，针对 attachment_missing 错误，需回到旧系统重新导出对应文档的附件子目录并单独补传。
