本页目录
升级与回滚
升级涉及服务端、数字员工运行时、插件和数据迁移。运维人员先验证版本组合与恢复路径，再安排维护。
运维人员不能仅凭镜像回退确认数据结构已恢复；运维人员按目标发行包的回退方案处理数据库恢复。
升级前
运维人员记录现有与目标发行包、镜像摘要、配置、数据库迁移、插件发布版本和运行器版本，完成一致性备份，并保留当前与历史审计密钥。
运维人员在隔离环境验证升级、旧数据读取、普通用户任务及恢复后，再通知维护范围。
定时任务迁移
当前源码的迁移脚本将数字员工切换到 PostgreSQL 调度存储，不导入旧版本地任务。运维人员在升级前保留旧任务清单与运行记录；升级后逐项核对任务、频率、启用状态和投递目标。
【待确认】目标发行包中的迁移步骤与旧任务承接方式尚未核验。运维人员先与交付负责人确认恢复方法，再切换调度；新旧调度不能同时执行。已经开始但结果不明的任务由维护人员核对，不自动重跑。
执行与验证
- 运维人员取得目标版本全量包，按同版本官方说明进入部署目录执行
sudo ./setup.sh upgrade。运维人员先在隔离环境核对配置保留、数据库迁移与数字员工运行时变更，再处理正式环境。 - 运维人员应用插件变更，核对 Node/Python 运行器、宿主 API 兼容性和插件数据库。
- 运维人员验证登录、权限、数字员工连接、文件、知识、插件、浏览器扩展和任务投递。
运维人员不手工改写或重复执行历史迁移。浏览器连接使用 Chrome/Edge 扩展配对验证，旧 CDP 端口的连通结果不能替代这项检查。
回退边界
| 变化 | 回退前必须确认 |
|---|---|
| 应用或界面 | 旧镜像是否兼容当前接口、配置和迁移 |
| 主库与插件库 | 是否可前滚修复，或必须按一致时间点恢复 |
| 数字员工与调度 | 旧版本是否理解当前权威状态、用户归属和工作区格式 |
| 审计和身份 | 历史密钥、签名与来源映射是否仍可用 |
| 外部动作 | 已发送的消息、Webhook 或业务操作是否不可撤回 |
出现连续错误、数据不一致或权限异常时，运维人员停止扩大变更，并按预案决定修复或恢复。产品数据恢复与文档站镜像回退分别管理。维护人员完成操作后记录业务验证结果，脚本退出码仅作为执行记录。