LineageOS 系统 OTA 升级并保留 Magisk（Root）的操作指南

在现代 Android 的 A/B 双分区机制下，LineageOS 的系统更新会默认写入当前未使用的闲置分区（Inactive Slot）。如果在系统 OTA 完成后直接重启，设备将从已写入新系统但未配置 Root 的干净分区启动，导致 Magisk 权限丢失。

为实现无缝升级并保留 Root 权限，应采用「未激活槽位注入法」。本指南适用于日常小版本或安全补丁更新。

1. 适用架构：设备必须支持 A/B 分区结构（近年发布的主流设备均支持）。
2. 升级限制：此方法仅适用于同版本内的增量或全量 OTA 更新。若涉及跨 Android 大版本升级（如从 LineageOS 20 升级至 21），必须进入 Recovery 手动卡刷，不可使用此方法。
3. 操作核心：在升级流程结束前，绝对不可触发系统的自动重启。

• 触发系统 OTA 更新（常规下载阶段）

1. 依次进入手机的「设置」→「系统」→「更新」（Updater）。
2. 检查并下载最新的 LineageOS 固件包，点击「安装」。此时系统会在后台将新固件写入未激活的分区槽位。

• 挂起系统重启指令（关键红线阶段）

1. 待固件写入完毕后，系统更新界面会弹出「重启」提示。
2. 此时绝对不要点击重启。 直接返回手机桌面。

• 利用 Magisk 注入未激活分区（权限留存阶段）

1. 打开 Magisk App，点击第一栏 Magisk 选项右侧的「安装」（Install）。
2. 在安装选项列表中，选择「安装到未使用的槽位 (OTA 后)」（Install to Inactive Slot (After OTA)）。

• 执行修补与安全重启（流程完成阶段）

1. 点击「开始」（Let's go），Magisk 将自动抓取并修补另一个分区的 boot.img 镜像。
2. 等待日志输出结束并显示 All done!（全部完成）后，点击 Magisk 的「重启」（Reboot）按钮。

若重启后设备未能进入系统，卡在 LineageOS 启动动画（俗称卡第一屏）：

1. 恢复原生启动分区：长按 电源键 + 音量上键 强制关机，并进入 Lineage Recovery 模式。
2. 覆盖错误补丁：通过电脑执行 adb sideload lineageos_固件名.zip，将干净的官方固件重新刷入该分区。此操作会覆盖掉导致故障的 Magisk 补丁，确保系统优先正常开机。
3. 重新提取修补：顺利开机进入系统后，再通过提取当前固件的 boot.img 发送至手机端 Magisk 进行手动修补，并利用 Fastboot 模式重新刷入。