Skip to content

BUG反馈 BUG report

Jump to bottom
zzh20188 edited this page Dec 25, 2025 · 1 revision

BUG反馈 / BUG Report

中文

在提交反馈之前，请先了解本仓库的定位：

  1. 仓库性质： 本仓库仅提供 GKI 内核的自动化编译服务。我们的核心工作是将 KernelSU (及其变体驱动，如 SUSFS) 的代码合并到内核镜像中，并不直接开发内核功能。

  2. 更新机制： 工作流程是自动化的（通常每两天更新一次）。一旦上游的 KSU 或 SUSFS 仓库更新了代码，本仓库就会尝试编译包含最新功能的内核供用户下载。

  3. 风险提示 (Bootloop)： 由于是自动构建，Release 推送的内核可能会导致无法开机 (Bootloop)。

    • 内核是否可用，完全取决于上游源代码 (KernelSU/SUSFS) 是否稳定且无错误代码。
    • 如果上游代码存在严重错误，可能会导致构建直接失败（Release 列表没有任何更新），或者生成损坏的内核。

  4. 反馈建议： 提交 Bug 之前请三思：是构建流程的问题，还是内核功能的问题？

    • 如果是功能性错误或代码逻辑问题，请直接向专业的上游团队 (KernelSU/SUSFS Team) 反馈。
    • 作为构建者，我无法解决代码层面的 Bug，上游开发者比我更专业。

English

Before reporting a bug, please understand the scope of this repository:

  1. Scope of Work: This repository strictly provides automated GKI kernel compilation workflows. Our main function is to merge KernelSU (and variant drivers like SUSFS) into kernel binaries. We do not develop the kernel features ourselves.

  2. Update Mechanism: The process is automated (updates run approximately every two days). When the upstream KSU or SUSFS repositories update their code, this repo automatically builds the latest kernel for users to download.

  3. Risk Warning (Bootloops): Because releases are automated, kernels pushed to Releases may cause bootloops.

    • The usability of the kernel depends entirely on whether the upstream source code (KernelSU/SUSFS) is stable and error-free.
    • Critical errors in upstream code may cause the build process to fail entirely (resulting in no new updates in Releases) or produce a broken kernel.

  4. Reporting Advice: Please evaluate the nature of your issue before reporting: Is it a build failure or a code defect?

    • If you encounter functional bugs or code-level issues, please report them directly to the upstream experts (KernelSU/SUSFS Teams).
    • As a maintainer of this build script, I cannot fix source code errors. The upstream developers are the professionals in this regard.

end

GKI_KernelSU_SUSFS Project

欢迎来到 GKI_KernelSU_SUSFS 项目的官方文档。 Welcome to the official documentation for the GKI_KernelSU_SUSFS Project.

🇨🇳 中文文档

1. 下载前必读

  • 👉 进入页面：如何选择版本

    重要提醒： 很多新手因为看错了版本导致无法开机。不要看手机设置里的安卓版本，请点击这里查看如何正确匹配内核文件名。

2. 功能列表

  • 👉 进入页面：支持的功能 / Features

    包含组件： 查看本仓库构建的内核集成了哪些功能（如 KernelSU, SUSFS, ZRAM 算法等）以及相关的开发者致谢。

3. 故障排查

  • 👉 进入页面：无限重启 (Bootloop)

    救砖指南： 如果刷入内核后遇到无法开机、卡 Logo 或无限重启的情况，请阅读此页面的解决方案。

4. 问题反馈

  • 👉 进入页面：BUG 反馈须知

    提交 Issue 前必读： 本仓库仅负责自动构建。在反馈问题前，请务必阅读此页面，了解哪些是构建问题，哪些是上游代码问题。

5. 自定义编译

  • 👉 进入页面：Fork 与自定义编译指南

    动手实践： 学习如何 Fork 本仓库并使用 GitHub Actions 自动构建属于自己的内核，支持自定义配置和补丁。

6. 其他

救砖 和 技巧

🇺🇸 English Documentation

1. Must Read: Before You Download

  • 👉 Go to Page: How to Choose

    Critical Step: Many users encounter bootloops because they check the wrong android version. Do not rely on your phone settings. Read this to match the correct kernel filename.

2. Features List

  • 👉 Go to Page: Features

    What's Inside: Check which components (KernelSU, SUSFS, ZRAM algorithms, etc.) are included in these builds and view the credits.

3. Troubleshooting

  • 👉 Go to Page: Bootloop / Stuck on Logo

    Rescue Guide: If your device is stuck in a bootloop or hangs at the logo after flashing, check this page for solutions.

4. Bug Report

  • 👉 Go to Page: Bug Report Policy

    Read Before Posting: This repository is for automated builds only. Please read this to understand the scope of support (Build issues vs. Upstream code issues).

5. Others

Unbrick and Tips

Clone this wiki locally