系统更新

JelinaOS 的更新体系覆盖系统、内核、设备代理与增量更新四类对象，支持云端与本地两种通道。依托 A/B 双系统机制，每一次更新都有退路。

更新对象

更新对象	说明
系统（JelinaOS）	系统版本升级，包含功能演进与安全修复
内核	内核版本更新，性能与硬件支持改进
设备代理	设备管理组件更新
增量更新	系统增量补丁，快速部署

更新方式

云端 OTA（推荐）

接入 JelinaCloud 后，通过舰队或设备页面统一管理更新：

在云端指定目标版本（系统 / 内核 / 代理）；
云端按策略下发更新（支持固定版本、分批执行）；
设备自动下载并应用，更新状态云端实时可见。

云端更新还支持离线更新包：为网络不可达的设备下载更新包，现场离线应用；也可通过 U 盘等可移动介质交付更新包，设备接入介质后自动处理更新。

本地 OTA

无云端环境时，使用设备端更新工具：

# 查看版本与更新状态
jelina-local-ota -g
jelina-local-ota -s
jelina-local-ota --json --status      # 结构化状态输出

# 查看待确认的更新（本地确认模式）
jelina-local-ota --confirmation

# 预检查更新包（不提交，只解析与校验）
jelina-local-ota --check <更新包>

确认无误后提交更新包应用（更新确认机制启用时进入待确认状态，需确认后执行）：

jelina-local-ota <更新包>
jelina-local-ota -c -w    # 确认当前待更新并跟踪进度

单组件更新包（.pkg）

单个组件的更新包（如设备代理、应用组件）可通过安装器应用：

jelina-instpackage --pkg-info <组件包.pkg>   # 查看包信息（不安装）
jelina-instpackage <组件包.pkg>              # 安装组件包

安装前请核对包来源与校验和；部分组件更新后需要重启生效。

更新包类型

JelinaOS 使用两种更新包格式，用途不同、入口不同：

包类型	格式	用途	安装入口
单组件包	`.pkg`	更新单个组件（系统/内核/设备代理/应用组件等）	`jelina-instpackage`
OTA 更新包	`.zip`	完整更新（含目标状态与多个组件，由设备代理统一编排）	`jelina-local-ota`

安装方式

单组件包按目标不同采用不同的安装方式：

方式	说明
完整写入	写入目标分区（常见为备用 A/B 分区）
解压安装	解压到指定分区、文件或目录
增量安装	安装为叠加层（即增量更新，不切换分区）
执行安装	安装并执行一次（高风险，仅特定场景）

安装成功不等于已激活

安装器返回成功不代表新内容已经生效：系统、内核等组件更新后需要重启或重新挂载才会激活。重启后请验证实际运行的版本与分区，再确认更新完成。

两种包不可混用

OTA 更新包（.zip）不要传给单组件安装器，单组件包（.pkg）不要绕过目标状态手工安装——这会破坏组件间的更新顺序；
云端下载的离线 OTA 包请通过 jelina-local-ota 入口应用。

更新确认机制

对于关键现场，更新可以配置为本地确认后执行：

云端发布的新版本到达设备后先保存，不立即安装；
现场人员确认后，更新才开始执行；
确认可通过设备端命令或设备界面完成；
未确认前设备保持当前版本运行，现场拥有最终决定权。

更新流程与安全保障

下载更新包 → 校验完整性 → 写入备用分区 → 重启切换 → 启动校验
                                                            │
                                                ✅ 通过：继续运行
                                                ❌ 失败：自动回退原系统

更新不中断业务：下载与写入在后台完成，设备持续运行；
失败自动回退：切换后校验失败自动回到原系统；
版本可回滚：已应用的新版本出现问题，可回退至上一版本。

更新状态查看

jelina-info          # 查看当前版本与启动分区
jelina-local-ota -s  # 查看更新状态与待处理更新

云端设备面板同样展示版本与更新状态。

更新建议

场景	建议
例行维护	及时应用补丁更新，保持安全基线
版本升级	先在测试设备验证，再批量部署
合规严格的行业	启用本地确认机制，更新前充分验证
带宽受限现场	使用增量更新或离线更新包