升级与迁移

文档	内容
Agent 滚动升级	Node Agent 升级：控制面驱动的自更新（默认路径）与 pip wheel 手工滚动（引导与回退路径）
控制面升级	控制面整栈重建
数据库迁移	Alembic 迁移操作与已知的坑
锁步契约	控制面与 agent 之间的锁步契约：什么变更需要按序发布，以及自更新链路何时不可用

脚本参数见 CLI 与脚本，迁移链见 数据库迁移清单。

一次典型的全量升级

日常升级（无协议变更）只需第 5 步之后的部分：控制面重建走 控制面升级，agent 走 Agent 滚动升级 的自更新路径。