KernelSU Modules 开发者文档

KernelSU Modules 是一个静态的 KernelSU 模块目录。模块保存在你自己的 GitHub 仓库中，并以 immutable GitHub release（不可变发布）的形式发布 ZIP；KernelSU Modules 只负责索引，不会托管、镜像或重新构建你的 ZIP。

English: index

工作原理 #

你的仓库                                 KernelSU Modules
───────────────                         ────────────────
module.yaml + README/docs + 图标   ──►  从默认分支读取（展示用元数据）
tag → immutable release + ZIP      ──►  检查 ZIP（module.prop、大小、结构），锁定 sha256
                                        ▼
                                   modules.kernelsu.org + KernelSU Manager

一次性设置：启用 release 不可变性，添加 module.yaml，安装只读的 KernelSU Modules GitHub App，并在KernelSU 开发者门户（KernelSU Developer Portal）提交仓库。首次提交需要维护者审核。
每次发布：在 module.prop 中提升 versionCode，推送 tag，发布只包含一个模块 ZIP 的 immutable release。我们的 release action 可以代劳。KernelSU Modules 会在几分钟内收录，无需审核。
反馈：结果会以名为 "KernelSU Modules" 的 Check Run 显示在打 tag 的 commit 上，也会显示在 Portal 中。不会发送邮件，也不会创建 issue。

信息来源 #

信息	来源
id、version、versionCode	release ZIP 内的 `module.prop`
下载 URL、大小、sha256、tag、commit	immutable release（由 KernelSU Modules 计算）
更新日志	release notes
名称、简介、描述、图标、标签、链接	默认分支上的 `module.yaml` 及其引用的文件

页面导航 #

快速开始：从零到上架
module.yaml 参考
发布：immutable release、versionCode、release action
闭源模块：私有源码仓库 + 公开分发仓库
检查：所有检查结果代码及修复方法
KernelSU 开发者门户：提交、转移、同步、状态
FAQ：保证范围、签名、隐私

完整的可用示例见 KernelSU-Modules/example-module。