mcpField
A
android-fastboot

android-fastboot

github.com/hyperb1iss开发49128 次安装39 周前更新
代码仓库

关于 android-fastboot

面向开发者和设备操作者的 Android Fastboot 操作参考技能，整理设备检查、引导加载程序管理、刷写、恢复和 Root 流程，并提示数据丢失与设备变砖风险。

主要功能

  1. 01设备与引导加载程序检查
  2. 02解锁及分区刷写命令
  3. 03A/B 槽位与动态分区操作
  4. 04恢复和侧载流程
  5. 05Root、擦除及软砖恢复指引

适用场景

  1. 01刷写前检查已连接设备
  2. 02临时启动恢复镜像进行测试
  3. 03管理槽位或动态分区
  4. 04恢复软砖设备

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hyperb1iss/hyperdroid-skill --skill android-fastboot

安装后在 Claude Code 中输入/android-fastboot确认已加载。

附带文件references/partitions.md

详细介绍

Android Fastboot 操作

⚠️ 危险操作区 - Fastboot 操作会直接写入设备分区。镜像错误或操作中断可能导致设备变砖。务必确认：

  1. 设备正确（检查 fastboot getvar product）
  2. 镜像适用于确切的设备型号
  3. Bootloader 已解锁（刷写前）
  4. 电量 > 50%

进入 Fastboot 模式

# From ADB (device running)
adb reboot bootloader

# Hardware buttons (most devices)
# Power + Volume Down (hold until fastboot screen)

基本命令

fastboot devices                    # List connected devices
fastboot getvar all                 # All device variables
fastboot reboot                     # Reboot to system
fastboot reboot bootloader          # Stay in bootloader
fastboot reboot recovery            # Boot to recovery
fastboot reboot fastboot            # Boot to fastbootd (Android 10+)

刷写前检查

# ALWAYS run these first
fastboot devices                    # Verify connection
fastboot getvar product             # Verify device model
fastboot getvar unlocked            # Must be "yes" for flashing
fastboot getvar current-slot        # Know current A/B slot
fastboot getvar battery-level       # Should be > 50

解锁 Bootloader

Google Pixel
# 1. Enable OEM unlocking in Developer Options
# 2. Boot to fastboot
adb reboot bootloader

# 3. Unlock
fastboot flashing unlock

# 4. Confirm on device with volume keys + power
# WARNING: This wipes all data!
其他制造商
品牌流程
OnePlusfastboot oem unlock
XiaomiMi Unlock Tool（等待期）
Samsung使用 Odin，而非 fastboot
Motorola从网站申请代码，fastboot oem unlock <code>
Sony从网站申请代码
检查解锁状态
fastboot getvar unlocked            # yes/no
fastboot getvar device-state        # locked/unlocked
fastboot getvar unlock_ability      # Can be unlocked?

刷写分区

单个分区
fastboot flash boot boot.img
fastboot flash recovery recovery.img      # Non-A/B only
fastboot flash dtbo dtbo.img
fastboot flash vbmeta vbmeta.img

# Disable verification (for custom ROMs)
fastboot flash --disable-verity --disable-verification vbmeta vbmeta.img
Bootloader 和 Radio（格外小心！）
# These can hard-brick if wrong!
fastboot flash bootloader bootloader.img
fastboot reboot bootloader    # REQUIRED after bootloader flash

fastboot flash radio radio.img
fastboot reboot bootloader    # Recommended after radio flash
临时启动（不刷写）
# Test before committing - reboots to normal after restart
fastboot boot recovery.img
fastboot boot patched_boot.img

A/B 槽位设备

现代设备的每个分区都有两份副本（A 和 B）。

# Check current slot
fastboot getvar current-slot        # Returns: a or b

# Set active slot
fastboot set_active a
fastboot set_active b

# Flash to specific slot
fastboot flash boot_a boot.img
fastboot flash boot_b boot.img

# Flash to both slots
fastboot --slot=all flash boot boot.img

动态分区（Android 10+）

较大的分区（system、vendor、product）位于一个名为“super”的分区中。

Fastbootd 模式
# Enter userspace fastboot
fastboot reboot fastboot

# Check if in fastbootd
fastboot getvar is-userspace        # Should return: yes
刷写动态分区
# Must be in fastbootd mode!
fastboot reboot fastboot

fastboot flash system system.img
fastboot flash vendor vendor.img
fastboot flash product product.img
虚拟 A/B 快照
# Check snapshot status
fastboot getvar snapshot-update-status

# Cancel stuck update (CAREFUL!)
fastboot snapshot-update cancel

恢复操作

进入 Recovery
adb reboot recovery
# Or: Power + Volume Up (varies by device)
ADB 侧载
# 1. In recovery, select "Apply update from ADB"
# 2. Run:
adb sideload update.zip
刷写自定义 Recovery（TWRP）
# Test first (temporary boot)
fastboot boot twrp.img

# If it works, flash permanently
# Non-A/B devices:
fastboot flash recovery twrp.img

# A/B devices (recovery in boot):
fastboot flash boot twrp.img

Magisk（Root）

安装
# 1. Extract boot.img from your firmware
# 2. Transfer to device, patch with Magisk app
# 3. Pull patched image
adb pull /sdcard/Download/magisk_patched_*.img

# 4. Flash patched boot
fastboot flash boot magisk_patched_*.img

# 5. Reboot
fastboot reboot
实用的 Magisk 命令（获取 Root 后）
adb shell su -c "magisk --version"
adb shell su -c "resetprop ro.debuggable 1"

恢复出厂设置 / 擦除

fastboot erase userdata             # Wipe user data
fastboot erase cache                # Wipe cache (if exists)
fastboot -w                         # Format data + cache

# Full flash with wipe
fastboot -w flashall
fastboot -w update image.zip

危险等级

等级操作
✅ 安全devices、getvar、reboot、boot（临时启动）
⚠️ 中等flash boot/recovery/dtbo、set_active
🔴 高flash system/vendor、erase、-w
☠️ 极高安装自定义 OS 时执行 flash bootloader、flash radio、flashing lock

防止设备变砖

切勿：

  • 刷写其他设备型号的镜像
  • 中断刷写操作
  • 安装自定义 ROM 后锁定 Bootloader
  • 刷写版本不匹配的 Bootloader / Radio

务必：

  • 使用 fastboot getvar product 验证设备
  • 保留原厂镜像以便恢复
  • 先使用 fastboot boot 测试，再使用 fastboot flash
  • 保持电量 > 50%

从软砖状态恢复

# 1. Enter fastboot (Power + Vol Down)
fastboot devices

# 2. Flash stock boot
fastboot flash boot boot.img

# 3. For dynamic partitions
fastboot reboot fastboot
fastboot flash system system.img
fastboot flash vendor vendor.img

# 4. Wipe if needed
fastboot -w

# 5. Reboot
fastboot reboot

对于硬砖（无法访问 fastboot），需要使用 EDL 模式（Qualcomm）或制造商的服务工具。

快速参考

任务命令
检查连接fastboot devices
设备信息fastboot getvar all
解锁 Bootloaderfastboot flashing unlock
刷写 bootfastboot flash boot boot.img
测试 Recoveryfastboot boot twrp.img
当前槽位fastboot getvar current-slot
切换槽位fastboot set_active a
擦除数据fastboot -w
重启fastboot reboot

评论

支持 Markdown