升级检查单

升级前

• 阅读目标版本的更新说明，下载与系统、架构匹配的完整安装包。
• 停止框架和插件，备份完整安装目录，包括 data 与插件数据。
• 使用 SHA256SUMS.txt 校验下载文件。

更新程序

从 2.x 升级时，使用独立目录重新初始化，并保留旧实例备份。不要把旧数据库或插件直接覆盖到新实例。

已有新版实例更新时，保留完整 data 和插件数据，使用同一发行包中的程序与 public。在线更新以验证端认可的版本为准。两份程序不能同时写入同一数据目录。

插件按API 文档核对接口与 self_id + protocol_id，IPC 插件使用适配当前框架的安装包。

升级后

• 确认程序版本、管理页面和管理员登录正常。
• 检查账号的协议、设备指纹与在线状态。
• 检查插件运行、消息收发和事件订阅。
• 检查日志中是否存在持续的权限、数据库或连接错误。

如果升级失败，先停止新进程，再恢复升级前的程序和完整数据备份。不要通过清空 data 解决启动问题。