Skip to content
This repository was archived by the owner on May 12, 2026. It is now read-only.

Commit 5741671

Browse files
committed
docs: update README badges and refine OTA/Wild Boost wording
Replace static environment badges with live GitHub stars/forks badges in both Chinese and English READMEs. Also keep both documents aligned on the revised OTA upgrade path wording and the Redmi-to-Xiaomi Wild Boost adaptation description.
1 parent ca8218d commit 5741671

2 files changed

Lines changed: 23 additions & 25 deletions

File tree

README.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,25 @@
11
# 🚀 HyperOS 移植工具 (Python 版)
22

3-
[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)
4-
[![License](https://img.shields.io/badge/License-Unlicense-green.svg)](LICENSE)
5-
[![Platform](https://img.shields.io/badge/Platform-Linux-lightgrey.svg)](https://www.ubuntu.com/)
3+
[![GitHub stars](https://img.shields.io/github/stars/toraidl/HyperOS-Port-Python?style=flat)](https://github.com/toraidl/HyperOS-Port-Python/stargazers)
4+
[![GitHub forks](https://img.shields.io/github/forks/toraidl/HyperOS-Port-Python?style=flat)](https://github.com/toraidl/HyperOS-Port-Python/network/members)
65

76
**中文 (Chinese)** | [English](README_EN.md)
87

9-
一个功能强大、自动化的 Python 移植工具,专为小米/红米设备的 HyperOS ROM 移植而设计。该工具涵盖了整个生命周期:解包、智能修补、功能恢复、重新打包和签名
8+
一个面向小米/红米设备的 HyperOS ROM 移植工具。覆盖常见移植流程:解包、补丁处理、功能适配、重新打包与 OTA 升级包产出
109

1110
---
1211

1312
## 🌟 核心特性
1413

15-
- 🛠️ **全自动化**: 从底包/移植包 ZIP 到最终可刷入 ZIP 的端到端移植流程
16-
- 💉 **智能修补**: 自动修改固件、系统、框架和 ROM 属性。
17-
- 🧬 **GKI 支持**: 针对 GKI 2.0 (5.10+) 及标准 GKI 设备,提供智能 KernelSU 注入
14+
- 🛠️ **流程自动化**: 从底包/移植包 ZIP 到可刷入产物的完整流程
15+
- 💉 **系统补丁**: 按规则修改固件、系统、框架和 ROM 属性。
16+
- 🧬 **GKI 支持**: 针对 GKI 2.0 (5.10+) 及标准 GKI 设备提供 KernelSU 注入能力
1817
- 🔓 **Android 16 支持**: 针对 KMI 6.12 提供专用的 `vendor_boot` fstab 修补,跳过标准 VBMETA 以防止 Fastboot 卡死。
19-
- 🚀 **Wild Boost**: 自动安装性能增强模块,支持内核版本检测
18+
- 🚀 **Wild Boost(狂暴引擎)**: 将红米机型的狂暴引擎适配并移植到小米机型;要求内核版本一致,当前已验证小米 12S 与小米 13
2019
- 🧩 **模块化配置**: 通过简单的 JSON 文件开启/关闭功能(AOD、AI 引擎等)。
2120
- 🌏 **EU 本地化**: 为 Global/EU 底包恢复国内特有功能(NFC、小米钱包、小爱同学)。
2221
- 📦 **多格式支持**: 支持生成 `payload.bin` (Recovery/OTA) 或 `super.img` (Hybrid/Fastboot) 格式。
23-
- 🔒 **自动签名**: 自动为最终生成的 ZIP 文件签名,确保无缝安装
22+
- 🔒 **官方 OTA 升级链路**: 产出兼容官方 OTA 格式的包,可通过官方升级 App 执行 AB 升级;出现问题时可回滚
2423

2524
---
2625

@@ -48,7 +47,7 @@
4847

4948
## ⚙️ 前置条件
5049

51-
- **Python 3.8+**
50+
- **Python 3.10+**
5251
- **Linux 环境** (推荐使用 Ubuntu 20.04+)
5352
- **Sudo 权限** (用于挂载/卸载镜像)
5453
- **OTA 工具**: 已内置在 `otatools/` 目录中。
@@ -185,14 +184,14 @@ sudo python3 main.py --stock <底包路径> --port <移植包路径> --pack-type
185184
sudo python3 main.py --stock stock.zip --port port.zip --pack-type super --fs-type ext4
186185
```
187186

188-
### 2. Wild Boost 支持
187+
### 2. 狂暴引擎支持
189188
根据内核版本自动安装性能增强模块。
190189

191190
**功能特性:**
192-
- 📌 **自动检测**: 检测内核版本 (5.10 / 5.15+)
191+
- 📌 **自动检测**: 检测内核版本 (5.10 / 5.15)
193192
- 📌 **智能安装**:
194193
- 内核 5.10: 安装到 `vendor_boot` ramdisk
195-
- 内核 5.15+: 安装到 `vendor_dlkm`
194+
- 内核 5.15: 安装到 `vendor_dlkm`
196195
- 📌 **AVB 自动禁用**: 防止修改后无法启动
197196
- 📌 **设备伪装**: HexPatch `libmigui.so`
198197
- 📌 **备用方案**: `persist.sys.feas.enable=true` 用于新系统
@@ -234,7 +233,7 @@ sudo python3 main.py --stock stock.zip --port port.zip --pack-type super --fs-ty
234233

235234
## 🏮 EU 本地化 (恢复国内功能)
236235

237-
EU/Global ROM 恢复 **中国国内特有的功能** (NFC, 小米钱包, 小爱同学),同时保持 "国际版" 伪装。
236+
xiaomi.eu ROM 恢复 **中国国内特有的功能** (NFC, 小米钱包, 小爱同学),同时保持 "国际版" 伪装。
238237

239238
1. **启用**: 在 `features.json` 中设置 `"enable_eu_localization": true`
240239
2. **生成资源包**:

README_EN.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,25 @@
11
# 🚀 HyperOS Porting Tool (Python)
22

3-
[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
4-
[![License](https://img.shields.io/badge/License-Unlicense-green.svg)](LICENSE)
5-
[![Platform](https://img.shields.io/badge/Platform-Linux-lightgrey.svg)](https://www.ubuntu.com/)
3+
[![GitHub stars](https://img.shields.io/github/stars/toraidl/HyperOS-Port-Python?style=flat)](https://github.com/toraidl/HyperOS-Port-Python/stargazers)
4+
[![GitHub forks](https://img.shields.io/github/forks/toraidl/HyperOS-Port-Python?style=flat)](https://github.com/toraidl/HyperOS-Port-Python/network/members)
65

76
[中文 (Chinese)](README.md) | **English**
87

9-
A powerful, automated Python-based tool for porting HyperOS ROMs across Xiaomi/Redmi devices. This tool handles the entire lifecycle: unpacking, smart patching, feature restoration, repacking, and signing.
8+
A HyperOS ROM porting tool for Xiaomi/Redmi devices. It covers the common workflow: unpacking, patch processing, feature adaptation, repacking, and OTA package output.
109

1110
---
1211

1312
## 🌟 Key Features
1413

15-
- 🛠️ **Fully Automated**: End-to-end porting process from stock/port ZIPs to flashable output.
16-
- 💉 **Smart Patching**: Automated modification of firmware, system, framework, and ROM properties.
17-
- 🧬 **GKI Support**: Intelligent KernelSU injection for GKI 2.0 (5.10+) and standard GKI devices.
14+
- 🛠️ **Workflow Automation**: From stock/port ZIPs to flashable output in one pipeline.
15+
- 💉 **System Patching**: Rule-based modifications for firmware, system, framework, and ROM properties.
16+
- 🧬 **GKI Support**: KernelSU injection support for GKI 2.0 (5.10+) and standard GKI devices.
1817
- 🔓 **Android 16 Ready**: Specialized `vendor_boot` fstab patching for KMI 6.12 to prevent fastboot bootloops.
19-
- 🚀 **Wild Boost**: Auto-installation of performance modules with kernel version detection.
18+
- 🚀 **Wild Boost (Rage Engine)**: Ports the Redmi-specific rage engine to Xiaomi targets; requires matching kernel versions. Currently validated on Xiaomi 12S and Xiaomi 13.
2019
- 🧩 **Modular Configuration**: Toggle features (AOD, AI Engine, etc.) via simple JSON files.
2120
- 🌏 **EU Localization**: Restore China-exclusive features (NFC, XiaoAi) to Global/EU bases.
2221
- 📦 **Multi-Format Support**: Generate `payload.bin` (Recovery/OTA) or `super.img` (Hybrid/Fastboot) formats.
23-
- 🔒 **Auto-Signing**: Automatically signs the final flashable ZIP for seamless installation.
22+
- 🔒 **Official OTA Upgrade Path**: Produces packages compatible with the official OTA format, enabling AB upgrades via the official Updater app; rollback is available if issues occur.
2423

2524
---
2625

@@ -191,10 +190,10 @@ sudo python3 main.py --stock stock.zip --port port.zip --pack-type super --fs-ty
191190
Automatically installs performance boost modules based on kernel version.
192191

193192
**Features:**
194-
- 📌 **Auto-detection**: Detects kernel version (5.10 / 5.15+)
193+
- 📌 **Auto-detection**: Detects kernel version (5.10 / 5.15)
195194
- 📌 **Smart Installation**:
196195
- Kernel 5.10: Installs to `vendor_boot` ramdisk
197-
- Kernel 5.15+: Installs to `vendor_dlkm`
196+
- Kernel 5.15: Installs to `vendor_dlkm`
198197
- 📌 **AVB Auto-disable**: Prevents bootloop after modification
199198
- 📌 **Device Spoofing**: HexPatch for `libmigui.so`
200199
- 📌 **Fallback**: `persist.sys.feas.enable=true` for newer systems

0 commit comments

Comments
 (0)