06 FAQ Import

6.5 数据导入报错

---

症状

• 导入 ZIP 时提示 "格式不支持"
• 导入后数据不完整
• 导入后扩展无法加载
• 导入后酒馆界面异常

---

排查步骤

1. 检查 ZIP 结构

确保 ZIP 包内包含正确的目录结构：

backup.zip
├── config/
├── data/
│   └── default-user/
├── plugins/
└── extensions/
    └── third-party/

如果 ZIP 多了一层包裹目录（如 backup.zip → backup/ → config/），导入会失败。

2. 检查文件完整性

• 确认 ZIP 文件没有损坏（尝试在电脑上解压验证）
• 确认 data/default-user/ 目录存在

3. 类型识别错误

SillyDroid 自动识别三种类型：

• SillyDroid 导出包
• Tavern 官方用户备份
• 四目录数据快照

如果自动识别错误，检查 ZIP 结构是否匹配以上任一类型。

---

导入后数据不完整

聊天记录丢失

• 确认 data/default-user/chats/ 中有 .jsonl 文件
• 导入后可能需要重启服务

扩展未加载

• 确认 extensions/third-party/ 中有扩展代码
• 检查扩展 manifest.json 是否完整
• 查看日志确认扩展加载状态

配置文件未生效

• 导入后重启服务使配置生效
• 检查 config.yaml 语法是否正确

---

导入前建议

1. 先 导出当前数据 作为备份
2. 在电脑上解压 ZIP 验证内容
3. 确保 ZIP 不大於 500MB（太大的文件可能导入超时）
4. 导入完成后重启服务