系統更新

JelinaOS 的更新體系覆蓋系統、核心、裝置代理程式與增量更新四類物件，支援雲端與本機兩種通道。依託 A/B 雙系統機制，每一次更新都有退路。

更新物件

更新物件	說明
系統（JelinaOS）	系統版本升級，包含功能演進與安全修復
核心	核心版本更新，效能與硬體支援改進
裝置代理程式	裝置管理元件更新
增量更新	系統增量修補程式，快速部署

更新方式

雲端 OTA（推薦）

接入 JelinaCloud 後，透過艦隊或裝置頁面統一管理更新：

1. 在雲端指定目標版本（系統 / 核心 / 代理）；
2. 雲端按策略下發更新（支援固定版本、分批執行）；
3. 裝置自動下載並應用，更新狀態雲端即時可見。

雲端更新還支援離線更新套件：為網路不可達的裝置下載更新套件，現場離線應用；也可透過 USB 隨身碟等可攜式媒體交付更新套件，裝置接入介質後自動處理更新。

本機 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  # 檢視更新狀態與待處理更新

雲端裝置面板同樣展示版本與更新狀態。

更建立議

場景	建議
例行維護	及時應用修補程式更新，保持安全基線
版本升級	先在測試裝置驗證，再批次部署
合規嚴格的行業	啟用本機確認機制，更新前充分驗證
頻寬受限現場	使用增量更新或離線更新套件

相關文件

• 更新與災難復原機制 — 更新原理與安全保障
• 雲端應用程式部署與 OTA — 雲端更新操作
• A/B 雙系統與切換 — 分割區切換與回退