系统更新
用途
在受管部署（官方 Release 镜像 + Host Updater 等）下检查新版本、备份并安全更新；必要时在校验通过后人工回退。
入口
管理后台 → 平台配置 → 系统更新（/admin/settings/system-update）
前置条件
- 部署需满足在线更新条件（见开发文档）；源码自建/非受管编排可能无法使用完整更新器能力。
- 更新前确保磁盘空间与备份策略充足。
操作步骤
- 打开页面查看当前构建版本与更新器状态。
- 检查是否有可用更新；阅读版本说明。
- 按向导执行备份 → 更新；勿中断进程。
- 更新后验证登录、创作生成、SSE/任务等关键路径（健康检查不等于业务可用）。
- 若需回退：仅在存在旧版本与已校验备份时使用人工回退；任一步失败可能进入需人工介入状态，勿伪造成功。
升级注意
跨版本更新前阅读版本说明中的「升级注意」并备份数据库。例如：
- v1.7.0 数据库 Schema 从 60 升至 71：新增短剧制作（剧情段流程）、存储套餐与对象存储补传相关表；Schema 67 将短剧从旧逐镜流程迁到剧情段流程，旧未完成集回到剧本阶段，排队中的旧工作取消且不自动重发收费任务。受管生产 Compose 会在 Backend 启动前自动执行迁移，其他部署需按流程运行
migrate-schema up/verify；旧版本不支持直接回退新 Schema。 - v1.7.1 起短剧段视频抽尾帧依赖后端 ffmpeg：官方镜像已内置，宿主机运行需自行安装或通过
CANVAS_FFMPEG_PATH指定。
字段与含义
| 概念 | 含义 |
|---|---|
| 当前版本 | 真实构建版本（与自定义更新公告展示可分离） |
| 备份 | 回退前提 |
| manual_intervention | 需运维手工处理 |
结果如何验证
- 版本号变更；创作与管理关键流程可用。
- 更新公告/外观中的展示版本按你的配置显示。
常见失败
| 现象 | 处理 |
|---|---|
| 无更新按钮/检查失败 | 确认是否受管部署与网络拉镜像权限 |
| 回退不可用 | 缺少旧版本或备份未校验 |
| 只健康检查通过 | 继续做登录与生成验收 |
相关文档
- 专题：在线更新与安全回退
- 部署编排说明见仓库
docs/index.md中的 Docker / 在线更新入口