GKI SukiSU-Ultra + SUSFS 构建系统

这是一个自动构建 GKI 内核的仓库

不支持一加 ColorOS14、15 和非 GKI

第一次使用务必 详细阅读 以下内容，不要因为懒惰而占用他人时间！

使用 Python 辅助构建系统，支持指定 SukiSU-Ultra/SUSFS commit 版本构建

---

快速开始

GitHub Actions

方式一：构建单个版本

1. 进入 Actions 页面
2. 选择 Kernel Build
3. 点击 Run workflow
4. 选择 Android 版本、Kernel 版本和构建选项
5. 可选：指定 SukiSU-Ultra 或 SUSFS 的 commit hash

方式二：构建所有版本

1. 选择 Build Kernels
2. 点击 Run workflow
3. 设置全局选项（KSU 版本、ZRAM、KPM 等）
4. 可选：指定 commit 版本

命令行本地构建

# 进入构建目录
cd .github/workflows/scripts

# 安装依赖
pip install PyYAML

# 构建单个版本
python build.py --android android14 --kernel 6.1 --sub-level 124 --os-patch 2025-02

# 构建整个矩阵
python build.py --matrix android14-6.1

# 构建所有版本
python build.py --all

# 指定 commit 版本
python build.py --all --ksu-commit abc1234 --susfs-commit HEAD~1

# 列出所有支持的配置
python build.py --list-configs

# 列出预定义构建矩阵
python build.py --list-matrix

---

构建矩阵

从 matrix.json 加载：

Android	Kernel	Sub Levels	OS Patch
12	5.10	136, 198, 209, 236, X (LTS)	2022-11 ~ 2025-05
13	5.15	74, 123, 148, 170, 178, 180	2023-01 ~ 2025-05
14	6.1	78, 90, 99, 124, 145	2024-06 ~ 2025-09
15	6.6	50, 66, 102	2024-10 ~ 2025-10

总计 19 个版本组合

---

命令行参数

参数	说明	默认值
--android, -a	Android 版本 (android12/13/14/15)	android14
--kernel, -k	Kernel 版本 (5.10/5.15/6.1/6.6)	6.1
--sub-level, -s	Sub level 版本或 X (LTS)	124
--os-patch	OS Patch Level	2025-02
--revision	Android 12 Revision	-
--ksu-version	SukiSU-Ultra 版本 (Stable/Dev)	Stable(标准)
--ksu-commit	指定 SukiSU-Ultra commit hash	latest
--susfs-commit	指定 SUSFS commit (hash 或 HEAD~N)	latest
--zram	启用 ZRAM (LZ4KD)	False
--no-kpm	禁用 KPM	False
--bbg	启用 Baseband-guard	False
--op8e	启用 OnePlus 8E 支持	False
--bbr	设置 BBR 为默认拥塞算法	False
--no-release	不创建 GitHub Release	False
--custom-version	自定义版本名称	-
--matrix, -m	使用预定义矩阵	-
--all	构建所有配置	-
--list-configs	列出所有支持的配置	-
--list-matrix	列出所有预定义矩阵	-
--dry-run	仅验证配置	-
--workspace, -w	工作目录	/tmp/gki-build

---

下载

1. AnyKernel3.zip - 下载即用！

   • 使用刷入软件，例如 HorizonKernelFlasher 进行刷写内核

2. boot.img - 下载与你内核格式相匹配的（无压缩、gz、lz4）

   • 使用 Fastboot 刷入

---

支持的功能

功能	说明
KernelSU	SukiSU 内核Root方案
SUSFS4	内核层面辅助 KSU 隐藏的功能补丁
BBR	TCP 拥塞控制算法
LZ4KD	来自华为源码的 ZRAM 算法
KPM	内核模块支持
Baseband-guard	基带安全防护

支持的 ZRAM 算法（可在 Scene 切换）

LZ4K、LZ4HC、deflate、842、lz4k_oplus

---

KSU 管理器

在编译完成后，会生成最新的管理器 APK。

---

紧急救援指南

触发条件 当设备因刷入错误/不兼容的内核无法启动时需执行救援

1. 进入 Fastboot 模式

   • 物理键组合：电源+音量-
   • 或 ADB 命令：adb reboot bootloader

2. 执行刷写命令

fastboot flash boot <boot.img文件全称>

---

内核版本兼容性说明

1. 跨子版本刷机规则

当手机 GKI 主版本为 5.10.x 时（如 5.10.168），可刷写同主版本更高子版本的内核（如 5.10.198）。

关于 X-lts 版本，以 android12-5.10.X-lts-AnyKernel3.zip 为例：

• X-lts 表示长期支持版（子版本号最大，当前示例为 5.10.236）
• LTS 随着 GKI 源码更新，编译版本号将持续递增
• ⚠️ 注意：LTS 虽为最新，但最新版 ≠ 最稳定（如 6.6.x 存在自动重启 BUG）

2. 内核版本伪装方法

在 MT 管理器终端执行：

uname -r | sed 's/^[^-]*//'

获取后复制版本号，填入 Action 编译面板即可实现内核版本伪装。

3. 定制构建矩阵

编辑 .github/workflows/config/matrix.json 添加或修改构建版本：

{
  "android14-6.1": [
    {"sub_level": "124", "os_patch_level": "2025-02"},
    {"sub_level": "145", "os_patch_level": "2025-09"}
  ]
}

---

构建系统架构

.github/workflows/
├── config/
│   └── matrix.json          # 构建矩阵配置
├── scripts/
│   ├── build.py             # 主构建脚本（CLI 入口）
│   ├── kernel_builder.py    # 内核构建核心类
│   ├── config.py            # 配置定义和验证
│   ├── matrix_generator.py  # GitHub Actions 矩阵生成
│   ├── release_generator.py # Release 说明生成
│   └── cache_manager.py     # 构建缓存管理
├── kernel-build.yml         # 单版本构建工作流
└── build-kernels.yml        # 全量构建工作流

核心组件

组件	功能
KernelBuilder	内核构建核心类，负责克隆源码、应用补丁、编译、打包
BuildConfig	构建配置数据类，包含所有构建参数
CacheManager	管理 ccache 和构建缓存，支持跨分支复用
matrix_generator.py	为 GitHub Actions 生成构建矩阵
release_generator.py	自动生成 Release 说明

仓库依赖

仓库	用途
SukiSU-Ultra	SukiSU-Ultra 源码和安装脚本
susfs4ksu	SUSFS 内核补丁
SukiSU_patch	SukiSU-Ultra 附加补丁（ZRAM 等）
AnyKernel3	通用刷机包模板
kernel_patches	内核补丁合集
Baseband-guard	基带安全防护

---

更多内容

可以提及您的意见...我会尝试！