Releases: Linuxoid-cn/Mi8G3-Unlocker
Mi8G3-Unlocker Auto v6.0.0
目前测试已无问题，偷懒一下，更新md一会儿写
Mi8G3-Unlocker Auto v5.0.0
🚀 Mi8G3-Unlocker Auto v5.0.0 : 支持高版本！！！
新版脚本在原有逻辑的基础上进行了大幅度的重构与优化。本次更新主要聚焦于规范文件组织结构、增强连接检测的健壮性以及完善错误阻断机制，从而降低了用户的刷机风险，提升了自动化执行的稳定性。
📂 1. 目录与文件结构重构
为了让项目资源分类更清晰，脚本对外部依赖的文件路径进行了统一规范：
- 机型依赖分离：原版的
Xiaobao\目录被重命名并拆分为更具可读性的unlockFolder\factoryImages\。 - 分区文件归类：原版散落在
items\目录下的gpt分区文件，在新版中统一整合至unlockFolder\unlockGPT\路径下，并明确区分了用于解锁的unlockgpt_both4.bin与官方恢复用的gpt_both4.bin。 - 引导镜像变更：加载的临时引导镜像由原版的
8gen3-Ennea.img更名为8650-Ennea.img。
🛡️ 2. 增强 ADB 与 Fastboot 连接检测的健壮性
旧版脚本在某些连接检测环节存在死循环或缺乏计数尝试的问题，新版对此进行了全面补强：
- 引入重试计数机制：在首次检查 ADB、二次检查 ADB 以及各阶段的 Fastboot 检测中（如
loop_check_1/2/3），统一引入了10次循环超时重试机制（每次等待 2 秒），避免因设备暂未加载完成而直接报错。 - 优化首阶段 ADB 拦截：原版的
:check_device失败后会无条件循环，新版check_adb模块配合计数器，提供了更友好的用户提示与回车重试等待逻辑。
⚠️ 3. 完善异常处理与命令执行安全
为了防止刷机过程中因单步命令失败而导致后续流程“硬着陆”，新版增强了逻辑判断：
- ABL 推送状态校验：在新版
:flash_abl阶段，通过&&与||运算符对adb push的执行状态进行了严格拦截。若工程 ABL 推送失败，脚本会及时拦截并提示用户检查通信，支持回车重新推送，而非像旧版一样盲目向下执行dd写入。 - 灵活的流程跳转分支：引入了
ifFlash变量标签，以便未来能够更弹性地控制是否跳过:run_flashall阶段，直接进入 GPT 刷写流程。
💻 4. 规范脚本退出机制
规范了 Windows 批处理在不同环境下的退出表现：
- 防止污染父 shell：将大部分原版的
exit替换为exit /B 1，确保脚本在被其他终端嵌套调用时，只退出当前脚本进程而不会强行关闭用户的整个命令行窗口。 - 环境感知末尾保留：在脚本末尾的
cmd /k触发前加入了if not defined IN_LOG_MODE环境变量判断，为后续自动化日志留存或上层调用预留了接口。
Mi8G3-Unlocker Auto v4.0.0
🚀 更新内容 (Changelog)
本次更新重点优化了 Fastboot 交互逻辑及日志反馈系统，进一步提升了脚本在自动化执行环境下的稳定性。
🛠 重点优化
-
优化
fastboot reboot bootloader指令调用- 冲突防止：通过重构调用上下文，解决了该指令与内置脚本指令之间的执行冲突，确保指令下发更加独立、可靠。
- 逻辑解耦：避免了在复杂脚本流中因指令竞争导致的引导程序重启失败或设备无响应问题。
-
优化日志报错机制
- 精准排障：对报错反馈进行了深度优化，现在日志将输出更具参考价值的上下文信息。
- 语义改进：细化了错误提示分类，方便在遇到异常情况时快速准确定位故障点，降低了维护和排查的时间成本。
📦 变更概要
- 指令层：提升了引导程序重启指令的执行成功率与独立性。
- 日志层：更清晰、更专业的报错输出体验。
Mi8G3-Unlocker Auto v3.0.0
Mi8G3-Unlocker Auto v3.0.0
🌟 新特性与改进
- 流程优化：针对引导临时镜像后设备连接中断的问题，新增了手动确认环节。脚本现在会暂停并提示用户手动返回 Fastboot，避免自动化检测失败。
- 稳定性提升：重构了
:check_fastboot_3及后续的逻辑判定，确保 GPT 分区恢复操作在正确的环境下执行。 - 交互改进：增加了更清晰的中文提示信息和色彩标注，降低新手操作门槛。
🛠 修复与变更
- 修复了在执行
fastboot boot后脚本可能出现的死循环问题。 - 增强了对部分 8 Gen 3 设备在特定修补日期下 SELinux 状态的校验逻辑。
- 完善了机型选择菜单与本地路径映射。
⚠️ 注意事项
- 本工具旨在实现解锁，无需提前具备解锁权限。
- 解锁 BL 仍会清空所有数据并失去保修，请务必提前备份！
- 建议配合刷机匣或官方线刷工具进行后续系统恢复。
Author: @kernix (Coolapk) / Linuxoid-cn (GitHub)
Feedback: jehsianbenites@gmail.com
Contributors
Assets 3
Mi8G3-Unlocker Auto v1.0.0
Mi8G3-Unlocker v1.0.0 更新日志
版本摘要：
本版本为 Mi8G3-Unlocker 的首个正式版本。该工具通过 Batch 脚本实现了小米及红米特定机型 BL（Bootloader）解锁流程的自动化，核心功能涵盖了设备状态实时监测、SELinux 权限突破、底层
1. 机型适配与环境架构
本版本精准适配以下 5 款 采用高通平台的机型，确保了分区偏移量与镜像文件的兼容性：
- 适配清单：Redmi K70 Pro、Redmi K80、Xiaomi 14、Xiaomi 14 Pro、Xiaomi 14 Ultra。
- 目录结构：构建了严谨的资源调度体系，脚本动态调用
%~dp0路径下的Xiaobao（核心补丁）与items（分区表资源）文件夹，实现“一机一策”的精准刷写。
2. 核心技术原理
脚本集成了多项底层交互技术，以实现对系统权限的绕过与修改：
-
权限注入：利用
fastboot oem指令强制修改androidboot.selinux=permissive参数，在特定状态下获得底层写入权限。 -
服务劫持：通过
service call远程调用miui.mqsas.IMQSNative服务，劫持系统dd指令，实现对$abl_a$ 与$abl_b$ 分区的实时热补丁注入。 -
分区表控制：支持
blgpt_both4.bin（解锁引导）与gpt_both4.bin（官方恢复）的自动化替换，确保分区结构在解锁流程中的一致性。
3. 流程安全与异常处理
针对刷机过程中的高风险环节，脚本内置了多重保护机制：
- 风险预警：设置了双重人工确认逻辑（启动确认与最终风险确认），明确告知用户关于数据清空与保修失效的风险。
- 循环监测：开发了针对 ADB 与 Fastboot 模式的
loop_check机制，能够自动处理设备重启过程中的驱动挂载延迟，并提供 10 次重试机会。 - 强制阻断：在执行核心刷写前，脚本会严格校验 SELinux 状态，若环境不符合补丁刷入要求，将立即执行安全退出。
4. 视觉交互与用户体验
- ANSI 色彩反馈：引入了完整的色彩分级提示系统。红色 用于风险警告，青色 指引流程进度，黄色 提示物理操作（如插拔线材），显著提升了命令行环境下的信息可读性。
- 手动衔接模式：在自动化任务执行完毕后，脚本自动进入
cmd /k命令行模式，方便用户直接调用官方flash_all.bat或进行后续调试。
[声明] 解锁过程将强制清除所有用户数据，执行前请务必确认已完成数据备份。
Mi8G3-Unlocker Auto v2.0.0
Mi8E-Unlocker 更新日志
本次更新解决了脚本在复杂系统环境下的运行稳定性，并修复了关键的逻辑判定漏洞。
🚀 核心修复
- [重大修复] 管理员模式路径定位
- 引入
%~dp0绝对路径锚定机制，彻底解决“以管理员身份运行”时脚本自动跳转至C:\Windows\System32导致找不到镜像文件的问题。 - 效果：现在脚本支持在任意目录下以任何权限等级精准运行。
- 引入
- [流程重构] 解锁判定闭环
- 优化了旧版本在 Fastboot 检查成功后检测解锁状态的代码逻辑。
- 强制执行
check_bl(BL状态) ->check_abl(FRP状态) 检测流，确保结果判定真实有效。
🛠️ 功能改进
- 三级状态预警系统：
- 绿色 (成功)：自动引导至线刷包执行界面。
- 黄色 (警告)：检测到工程补丁生效但 BL 未开，支持回车一键返回重试。
- 红色 (危险)：针对 BL 未解锁且工程分区被覆盖的“危险态”增加高亮警告，拦截后续操作。
- 智能连接探测：优化 ADB/Fastboot 的 10 次循环探测算法，提升对慢速驱动加载的兼容性。
- 内置命令行环境：任务结束后通过
cmd /k挂起窗口并保持路径变量，支持用户直接在此窗口拖入flash_all.bat执行。
📱 机型适配更新
- 完善以下机型路径匹配：
- Redmi K70 Pro / K80
- Xiaomi 14 / 14 Pro / 14 Ultra
- Xiaomi MIX Flip / Fold 4
作者： 酷安 Kernix
Github： Linuxoid-cn
Telegram: @C_Valmont