用途:自动化完成 Magisk 从零开始的系统级安装,把设备状态从「Installed: N/A」(App 已装但 boot 未修补刷入)变为「Installed: Yes」(Magisk 与系统集成)。适用于全新配置、版本升级(如 27.0 → 30.6)以及 boot 镜像需要修补刷入的场景。
主要能力:从 GitHub 下载最新或指定版本 Magisk APK 及对应 boot 镜像;用 adb install 安装 Magisk Manager;从活动分区提取 boot.img;通过 Magisk App 修补生成 patched_boot.img 并拉回本地;进入 fastboot 后用 fastboot 刷入补丁镜像并重启验证。提供 5 个脚本:adb-magisk-download.py、adb-magisk-install-app.py、adb-magisk-extract-boot.py、adb-magisk-patch-boot.py、adb-magisk-flash-boot.py,均以 uv run 加参数调用,支持 --json、--verify、--force、--partition boot_a/boot_b 等选项。另有 magisk-complete-install.toon 完整工作流,分 9 个阶段(下载、装 App、提取 boot、推送 boot、修补、拉取补丁、重启 fastboot、刷入、验证),含重试与截图恢复策略。
使用方式:需设备开启 ADB 调试,命令示例:uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py --output-dir /tmp/magisk;修补阶段通过 UI 交互(tap、wait-for 文本「Patching complete」)完成,依赖 adb-screen-detection、adb-navigation-base、adb-uiautomator、adb-workflow-orchestrator。
状态含义:Yes 表示已集成;N/A 表示 App 已装但 boot 未修补刷入;No 表示未安装 Magisk App。
限制:资料未提供收费、价格与平台支持信息。刷入失败时需尝试备用分区,部分设备需 vendor_boot 修补(Magisk 30+);fastboot 连接依赖驱动与 USB;刷入后可能出现 bootloop,需回刷原始 boot.img、进入 recovery(如 TWRP)或恢复官方 ROM。该技能涉及系统级修改,存在设备变砖风险,操作前应确认 bootloader 版本兼容性并备份原镜像。