iLab CONJURE 配置备份与恢复教程:如何跨设备迁移 Chip、公用图库与模板(增量 / 替换模式)
iLab CONJURE 配置备份与恢复教程:如何跨设备迁移 Chip、公用图库与模板(增量 / 替换模式)
iLab CONJURE 是本地优先的 AI 图片生成 WebUI 工作台,内置「配置备份与恢复」功能,可以把你积累 Chip 快捷引用、公用图库、提示词模板和系统设置 打包成一个 ZIP 备份,迁移到另一台设备,并支持 增量恢复 与 替换恢复 两种模式。无论你是换电脑、重装系统,还是想定期给创作资产"上保险",本文都能帮你在几分钟内完成整条迁移流程 🚀
能备份哪些数据?先看懂 4 大类
备份入口位于 系统设置 → 存储与通知 → 配置备份与恢复。每次备份都是所选类别的完整快照,可选内容共四类:
| 类别 | 包含内容 | 备注 |
|---|---|---|
| Chip | 颜色 Chip、提示词片段(Prompt Snippets) | 迁移后 @ 引用照常可用 |
| 公用图(Gallery) | 全部公用图、分类与元数据 | 图片原文件随包迁移 |
| 模板 | 提示词模板及本地缩略图 | 外部 HTTP(S) 缩略图保留为 URL |
| 系统设置 | 供应商配置、网络出口、存储路径、主题与通知偏好等 | 可选是否包含 API Key |
⚠️ 不会进入备份的内容:生成任务与历史图片(请用历史库中独立的「任务备份」流程)、Codex / ChatGPT 的 OAuth 登录态(永不备份)。
一键创建备份:从选类别到下载 ZIP
- 在备份面板勾选要打包的类别,每项后面会实时显示 数量与占用空间(数据来自 codex_image/webui/routes/user_config_backup.py 的 summary 接口);
- 勾选系统设置时,会出现「包含 API Key(敏感)」选项——默认关闭,勾选后需二次确认;
- 点击「创建备份」,状态会经历
queued → planning → packing → ready,完成后点击「下载备份」。
💡 备份文件在创建后 24 小时内可重复下载;主动放弃或到期后,服务端会清理临时副本。备份包内部带有清单(manifest),每个文件都记录大小与 SHA256,保证传输与校验的完整性,格式定义见 codex_image/webui/user_config_backup_format.py。
🔒 安全提醒:备份包 不做加密。只要勾选了 API Key,就请把 ZIP 当作密码本一样妥善保管。
在新设备恢复:上传、校验、预览三步走
在目标设备打开同样的入口,切到「恢复」页签:
- 上传备份 ZIP——文件先分片上传并逐块校验哈希,进度条实时显示;
- 自动校验——服务端检查格式版本、包体大小、压缩比与条目数量,防止恶意或损坏的包;
- 查看恢复预览——列出每个类别的「备份 X 项 / 当前 Y 项」,预览阶段不会修改任何现有数据,可以反复确认。
校验与导入的核心逻辑在 codex_image/webui/user_config_backup_import.py 中实现,前端交互见 codex_image/webui/frontend/src/user-config-backup.ts。
增量恢复 vs 替换恢复:一张表看懂
| 增量恢复(默认) | 替换恢复 | |
|---|---|---|
| 现有数据 | ✅ 全部保留 | ❌ 所选类别被清空后导入 |
| 重复项 | 自动跳过 | — |
| 命名冲突 | 自动创建"恢复副本" | 直接以备份内容为准 |
| 确认强度 | 一次点击 | 需勾选「我已了解现有数据将被替换」 |
| 额外保护 | — | 若备份中某子类别为空而当前有数据,拒绝替换;运行中任务可能阻止公用图/设置替换 |
- 换设备、补数据 → 用增量,安全无脑选;
- 以旧环境为唯一权威、彻底对齐 → 用替换,但先确认当前设备没有还在用的新数据。
替换确认页会明确展示每项影响,例如「公用图:清除当前 N 项,再导入备份 M 项」,以及会失去引用关联的历史任务数量,确认后才可执行。
常见坑与注意事项
- 恢复后路径变了? 若存储路径被恢复覆盖,需重启 WebUI 才生效,页面会明确提示;
- 模板缩略图警告? 缺失素材或无效路径的缩略图会被跳过并显示警告,不影响模板正文迁移;
- 带凭据的供应商在替换时有专门的安全保留规则,预览页会提示保留数量;
- 别混淆两套备份:用户配置备份(本文)≠ 历史库任务备份,图片结果请用历史库导出 ZIP。
相关源码与文档
- 备份/恢复 API 路由:codex_image/webui/routes/user_config_backup.py
- 备份规划器(快照各存储):codex_image/webui/user_config_backup_components.py
- 备份包格式与清单校验:codex_image/webui/user_config_backup_format.py
- 导出任务(排队/打包/24 小时下载):codex_image/webui/user_config_backup_export.py
- 导入服务(分片上传/校验/恢复):codex_image/webui/user_config_backup_import.py
- 界面结构:codex_image/webui/static/index.html
- 官方说明:README.md「用户配置备份与恢复」
掌握「备份 → 迁移 → 预览 → 选模式」这条主线后,跨设备同步你的 Chip、公用图与模板就只需要几分钟——放心换机,创作资产一条都不少 ✨
