iLab CONJURE 配置备份与恢复教程:如何跨设备迁移 Chip、公用图库与模板(增量 / 替换模式)

原创2026-11-01 14:43:141,188 阅读

iLab CONJURE 配置备份与恢复教程:如何跨设备迁移 Chip、公用图库与模板(增量 / 替换模式)

iLab CONJURE 是本地优先的 AI 图片生成 WebUI 工作台,内置「配置备份与恢复」功能,可以把你积累 Chip 快捷引用、公用图库、提示词模板和系统设置 打包成一个 ZIP 备份,迁移到另一台设备,并支持 增量恢复 与 替换恢复 两种模式。无论你是换电脑、重装系统,还是想定期给创作资产"上保险",本文都能帮你在几分钟内完成整条迁移流程 🚀

iLab CONJURE WebUI 工作台界面,包含配置备份与恢复、Chip 快捷引用、公用图库与提示词模板

能备份哪些数据?先看懂 4 大类

备份入口位于 系统设置 → 存储与通知 → 配置备份与恢复。每次备份都是所选类别的完整快照,可选内容共四类:

类别 包含内容 备注
Chip 颜色 Chip、提示词片段(Prompt Snippets) 迁移后 @ 引用照常可用
公用图(Gallery) 全部公用图、分类与元数据 图片原文件随包迁移
模板 提示词模板及本地缩略图 外部 HTTP(S) 缩略图保留为 URL
系统设置 供应商配置、网络出口、存储路径、主题与通知偏好等 可选是否包含 API Key

⚠️ 不会进入备份的内容:生成任务与历史图片(请用历史库中独立的「任务备份」流程)、Codex / ChatGPT 的 OAuth 登录态(永不备份)。

一键创建备份:从选类别到下载 ZIP

  1. 在备份面板勾选要打包的类别,每项后面会实时显示 数量与占用空间(数据来自 codex_image/webui/routes/user_config_backup.py 的 summary 接口);
  2. 勾选系统设置时,会出现「包含 API Key(敏感)」选项——默认关闭,勾选后需二次确认;
  3. 点击「创建备份」,状态会经历 queued → planning → packing → ready,完成后点击「下载备份」。

💡 备份文件在创建后 24 小时内可重复下载;主动放弃或到期后,服务端会清理临时副本。备份包内部带有清单(manifest),每个文件都记录大小与 SHA256,保证传输与校验的完整性,格式定义见 codex_image/webui/user_config_backup_format.py。

🔒 安全提醒:备份包 不做加密。只要勾选了 API Key,就请把 ZIP 当作密码本一样妥善保管。

在新设备恢复:上传、校验、预览三步走

在目标设备打开同样的入口,切到「恢复」页签:

  1. 上传备份 ZIP——文件先分片上传并逐块校验哈希,进度条实时显示;
  2. 自动校验——服务端检查格式版本、包体大小、压缩比与条目数量,防止恶意或损坏的包;
  3. 查看恢复预览——列出每个类别的「备份 X 项 / 当前 Y 项」,预览阶段不会修改任何现有数据,可以反复确认。

校验与导入的核心逻辑在 codex_image/webui/user_config_backup_import.py 中实现,前端交互见 codex_image/webui/frontend/src/user-config-backup.ts。

增量恢复 vs 替换恢复:一张表看懂

增量恢复(默认) 替换恢复
现有数据 ✅ 全部保留 ❌ 所选类别被清空后导入
重复项 自动跳过 —
命名冲突 自动创建"恢复副本" 直接以备份内容为准
确认强度 一次点击 需勾选「我已了解现有数据将被替换」
额外保护 — 若备份中某子类别为空而当前有数据,拒绝替换;运行中任务可能阻止公用图/设置替换
  • 换设备、补数据 → 用增量,安全无脑选;
  • 以旧环境为唯一权威、彻底对齐 → 用替换,但先确认当前设备没有还在用的新数据。

替换确认页会明确展示每项影响,例如「公用图:清除当前 N 项,再导入备份 M 项」,以及会失去引用关联的历史任务数量,确认后才可执行。

常见坑与注意事项

  • 恢复后路径变了? 若存储路径被恢复覆盖,需重启 WebUI 才生效,页面会明确提示;
  • 模板缩略图警告? 缺失素材或无效路径的缩略图会被跳过并显示警告,不影响模板正文迁移;
  • 带凭据的供应商在替换时有专门的安全保留规则,预览页会提示保留数量;
  • 别混淆两套备份:用户配置备份(本文)≠ 历史库任务备份,图片结果请用历史库导出 ZIP。

相关源码与文档

掌握「备份 → 迁移 → 预览 → 选模式」这条主线后,跨设备同步你的 Chip、公用图与模板就只需要几分钟——放心换机,创作资产一条都不少 ✨

登录后查看全文
ilab-conjure