更新应用

在线更新

在“管理后台 → 系统设置 → 运营配置”的在线更新卡片中查看当前运行版本、偏好对应的目标版本和已保存的更新偏好。

旧部署没有安装记录时，仍正常展示当前版本，不需要额外确认。只有检测到服务与上次安装记录不一致时，才会说明具体服务及原因，例如网页服务版本不同或模型转换服务未运行；可检查更新，或联系管理员核对服务器部署。当前版本号相同不代表所有服务均已完成安装，安装前仍会执行原有安全检查。

• 点击卡片中的“更新偏好”一行，或右上角的编辑图标（版本管理），选择稳定版（默认）、最新版或指定版本。最新版需要管理员主动选择并确认。
• 点击“保存偏好”只保存后续检查使用的目标，不会立即安装，也不会改变自动更新开关。
• 点击“检查更新”；存在可安装目标时，主按钮会显示“更新到”或“切换到”的具体版本。查看目标版本、升级说明和注意事项，确认后开始安装。
• 点击“版本历史”可查看更新说明，并将一个可用历史版本设为指定偏好。指定版本固定目标，不跟随后续新版发布。

已经达到偏好对应版本时，只显示检查结果，不重复安装。未保存的选择不会改变实际更新策略。

自动更新

卡片中的“自动更新”一行显示开关和当前状态，说明图标中可查看执行时间与记录。开启前需要确认，开启后每天北京时间 02:30 按已保存偏好检查并安装允许自动安装的版本。选择指定版本后会以该版本为目标；当前版本更高时不会自动降级。

更新进度与异常处理

更新期间服务可能短暂中断。更新任务会显示准备、安装和服务检查进度；关闭进度窗口不会取消已经开始的任务，刷新后可继续查看原任务，不要重复提交。

更新请求提交成功不等于安装完成。应以任务最终结果、当前运行版本及服务健康检查为准。只有支持自动恢复且符合条件的版本，才会在健康检查失败后恢复原应用；应用恢复不等于数据库恢复。

“版本管理 → 更多操作 → 重新检查并更新”保留维护入口，可用于处理更新未完成的情况。它不会绕过版本校验、降级安全限制或数据兼容性检查。

老部署保留原稳定版更新入口。如果页面提示更新服务尚不支持选版，Linux 管理员只需在原部署目录拉取新版 EasyAI 部署仓库并执行默认完整 ./update.sh，脚本会自动补齐配置并安装 updater；无需另跑迁移命令或手工新增容器。更新服务接入后，在支持新版版本管理的后台中刷新即可设置三种偏好；仅发布 updater 不会更换业务镜像或增加旧页面没有的选版界面。明确的仅镜像/定向更新以及 Windows 原脚本仍保留原兼容行为。读取失败时可重新检查，自动更新设置保存失败会恢复原开关状态。

服务器端更新与配置迁移

公开版本历史、稳定版、最新版及部署脚本统一来自 EasyAI 部署仓库。在服务器上拉取已经发布的部署项目，再从该检出执行标准更新脚本；涉及配置迁移时使用仓库提供的模板和迁移逻辑，保留既有密钥、数据挂载及用户配置。

更新前备份必要数据，较大更新安排维护时间。不要用直接覆盖服务器 Compose、代理配置、容器源码或构建产物的方式替代标准更新流程。

完整选版规则见 版本选择与更新，部署方式见 部署配置，备份方式见 备份数据。

后台新版本提示

进入后台时的“检测到新版本”弹窗顶部提供“更新偏好设置”入口，点击后直接打开运营配置中的更新偏好面板。

在版本管理中调整“后台新版本提示”，点击“保存偏好”后生效。该设置保存在服务端，刷新页面或重新登录后继续有效，也适用于后续发布的新版本。

• 使用指定版本时，后台不再自动提示新版本，提示开关显示关闭且不可开启。
• 使用稳定版或最新版时，可以手动关闭新版本提示。切换策略不会重置已保存的提示选择。
• 关闭提示不影响手动检查、手动更新或已保存的自动更新设置；“稍后再说”仍只暂缓当前版本提示。

旧部署需要先升级更新服务，才能保存这个提示开关；原有更新入口仍可使用。