Repository navigation
Releases
v1.8.3
YukiSU v1.8.3
本次更新重点改进后加载（late-load）、模块生命周期与 YukiZygisk 兼容性，并修复管理器和模拟软重启相关问题。包含 v1.8.2 之后的 30 个提交，管理器版本码为 10723。
后加载与模块管理
- 支持第三方启动器传入管理器包名，加载完成后重新启动指定管理器。
- 改进 KMI 识别及厂商内核 vermagic 兼容性；内嵌 LKM 在内存中解码、校验和加载，减少对可写临时目录的依赖。
- 调整内核初始化与 SELinux enforcing 恢复顺序，检查驱动是否真正就绪，并完善失败诊断。
- 每次后加载均执行模块 service 和 boot-completed 阶段；改进 metamodule 辅助脚本的进程环境和目录处理。
- 修复已标记移除的模块仍加载策略或属性、链接模块路径处理、清理中断及根目录 SELinux 标签恢复等问题。
- 改进模块批处理的错误传播，保留属性值中的字面量
#，避免操作失败后继续处理当前批次。
YukiZygisk、Kasumi 与模拟软重启
- 优化 PLT 查找、注册和批量处理，修复同一 ELF 因多个映射被重复注册的问题，并更新 YukiPLT。
- 修复部分 HyperOS 上 ELF 程序头重定位导致的注入失败，以及 specialize 路径中的
exemptFd()兼容性。 - 更新 YukiLinker，支持带页填充的 GNU RELRO 段，修复 FingerprintPay 6.1.0 的相关加载问题。
- 修复合并模块目录中的 whiteout 处理及循环设备镜像访问权限；挂载控制器空闲时按需退出。
- 更新 resetprop，修复模拟软重启中的属性命名空间别名处理问题。
管理器与内核
- 修复未安装或没有 root 权限时，设置页与主页误显示“模拟软重启已受理”的问题。
- 将保存的 SuperKey 排除在系统备份、云备份和设备迁移之外。
- 修复没有可用应用处理外部链接时管理器意外退出的问题。
- 同步 KernelSU 的 SELinux 上下文解析、ARM64 系统调用参数处理及 preinit ELF 对齐改进。
下载支持 arm64 设备，管理器要求 Android 12（API 31）及以上。LKM 附件提供 8 个 KMI，覆盖 Linux 5.10、5.15、6.1、6.6、6.12 和 6.18。
完整变更：v1.8.2...v1.8.3
v1.8.2
YukiSU v1.8.2
本次更新以 YukiZygisk 更新为主，并包含管理器体验改进和一些小修复。包含 v1.8.1 之后的 13 个提交，管理器版本码为 10693。
YukiZygisk
- 接入 YukiLinker SDK，更新模块加载实现，完善普通 Zygisk 模块和原生 ZN 模块的加载与生命周期管理。
- 完善原生 ZN 模块的依赖查找、加载完成交接及临时加载器回收，修复相关文件描述符生命周期问题。
- 改进模块卸载后的 Bionic 退出回调清理，并修复 ARM32 / ARM64 注入模板的偏移计算。
其他改进与修复
- 管理器就绪后自动检查模块更新，在导航栏显示可更新数量；下拉刷新可重新检查。
- 修复模块大小在后台统计完成后仍显示
0 KB的问题。 - 超级用户页面新增最近一小时安装或更新的应用分区，修复安装时间排序，并移除无效的排序选项。
- 支持更多文件管理器使用的 ZIP MIME 类型，改善打开和分享模块压缩包的兼容性。
- 同步上游 SELinux 原始类型追踪改进，完善策略切换时的上下文转换。
- 更新构建依赖并修复 Gradle lint 构建问题。
下载支持 arm64 设备，管理器要求 Android 12（API 31）及以上。LKM 附件提供 8 个 KMI，覆盖 Linux 5.10、5.15、6.1、6.6、6.12 和 6.18。
完整变更 v1.8.1...v1.8.2
v1.8.1
YukiSU v1.8.1
本次为 YukiZygisk 紧急修复版本，重点修复驻留模块的 linker / TLS 生命周期问题。包含 v1.8.0 之后的 10 个提交，管理器版本码为 10680。
YukiZygisk 紧急修复
- 修复驻留模块的 Bionic linker 状态管理。模块在驻留期间持续保留 linker 注册和 TLS 元数据，避免私有
soinfo清理造成 TLS 状态失效，以及与后台线程调用dl_iterate_phdr发生竞争。 - 本次修复针对 FuseHide 1.202 所暴露的驻留模块场景，调整了应用和 system_server specialization 完成后的清理流程。Bionic 可正常枚举仍处于加载状态的模块。修复提交
其他修复
- 将尚未设置偏好的 ksud 自动更新默认值设为开启，管理器冷启动时同步内置 ksud。已保存的开关值按用户选择执行。
- 改进 Lua 插件对 FolkPatch / FinaSU 清单和公共 API 的兼容，完善参数转换、回调转发、daemon 单实例锁与命令启动错误处理。兼容说明
- 管理器支持旧插件操作入口，修复配置恢复默认、UTF-8 配置键和部分保存失败的反馈。
- 软重启状态按当前启动 ID 读取，解决完整重启后仍显示旧结果的问题。已结束的通知支持手动关闭，失败通知在前台约 10 秒后自动收起，并遵循无障碍超时设置。
- Material 3 更新至
1.5.0-rc01。
下载支持 arm64 设备，管理器要求 Android 12（API 31）及以上。LKM 附件提供 8 个 KMI，覆盖 Linux 5.10、5.15、6.1、6.6、6.12 和 6.18。
完整变更 v1.8.0...v1.8.1
v1.8.0
YukiSU v1.8.0
自 v1.7.0 以来的 273 个提交，重点更新 YukiZygisk 加载与恢复、Kasumi / Kagami 规则管理、模块生命周期和管理器体验。管理器版本码：10670。
兼容性与行为变化
- 继续仅支持 arm64 设备、Android 12（API 31）及以上、GKI 2.0 / LKM 模式；提供 8 个 KMI 的 LKM，覆盖 Linux 5.10、5.15、6.1、6.6、6.12 和 6.18。
- 管理器统一使用 Material 3 Expressive，移除 Classic UI，保留紧凑布局和动效偏好。
- 默认 root 配置迁移到
ksu域，保留自定义域、标志及旧su策略兼容。 - 移除无效的“增强安全”功能和 Kasumi 激进挂载隐藏模式，保留普通挂载隐藏及已有开关状态。
YukiZygisk
- 使用 YukiPLT 替换 LSPlt，加入映射缓存、受控 fork 和事务式 hook 生命周期管理，改进 hook 安装、归属检查与恢复。
- 改进匿名核心加载、自卸载、ART JNI 注册与 ARM32 调用上下文处理，支持 Tango 转译 zygote32。
- native ZN 模块通过 Bionic 加载，完善加载器引用、依赖交接和 native companion 绑定的原子发布。
- 增加独立加载策略与运行时监控，默认启用崩溃保护；记录 zygote / native 进程退出证据，支持模块隔离和 daemon 恢复。
Kasumi、Kagami 与软重启
- 更新 API 18 规则与冲突处理，提供模块和规则级策略绕过控制，修复已保存规则重放、应用结果核对及旧配置兼容。
- 修复虚拟目录、合并目录可见性和 inode 生命周期问题，减少 daemon 与挂载规划开销。
- 恢复 SELinux Guard，接入配置、管理器和 hook 状态展示。
- 模拟软重启按 daemon 能力判断是否可用，恢复 Kasumi 规则并等待控制器完成；管理器区分请求已接受与恢复完成，展示失败原因和待恢复规则。
模块、安装与镜像工具
- 支持从仓库或本地 ZIP 执行一次性脚本，并为模块 action 添加长按创建快捷方式。
- 支持模块主动启用的热安装，保留替换备份到下次启动，并明确区分可立即生效和仍需重启的安装。
- 支持在 SELinux 初始化前运行模块 preinit，加入状态、输出、恢复控制与启动循环保护。
- 安装页新增启动配置控制、强制功能值和可选内核模块黑名单；支持仅修改 ramdisk 配置及启动镜像命令行覆盖。
- 分区工具新增 AVB 控制，ramdisk 编辑器支持十六进制编辑、文件操作与 recovery 镜像。
- 修复镜像路径、kernel 替换和安装失败传播；直接安装及安装到未使用槽位不再向 Download 导出修补镜像。
- 新增模块全局版本兼容配置与动态管理器的逐签名兼容配置。
- 模块归档支持 XZ / LZMA；完整卸载改进启动镜像恢复、模块清理脚本及残留启动配置清理。
管理器与 WebUI
- 统一展开控件和页面动效，提供关闭、柔和与 Q 弹动效选项；改进预测性返回、弹窗返回及窗口尺寸适配。
- 改进多用户应用枚举、图标和操作目标，修复应用配置备份、UID 变化恢复、模板保存与挂载命名空间选择。
- WebUI 新增多用户包信息及文件接口，预加载包信息，并通过管理器 root shell 完成文件操作和写入同步。
- 新增关于页面与开源许可证展示，改进壁纸透明度、主题对比度、模块卡片及状态通知。
内核、命令行与发布
- 同步 SELinux 策略、BTF 布局解析、文件引用、管理器扫描及 Android 17 QPR3 兼容修复，完善 LKM 卸载生命周期。
- 改进启动脚本超时、执行失败诊断和可信 shell 会话控制；
su交互提示显示设备代号与完整当前路径。 - 修复 Release 写入权限和 ksud 附件收集，更新发布证书、依赖与构建工具；五种语言文档同步到当前功能和仓库地址。
完整变更：v1.7.0...v1.8.0
v1.7.0
YukiSU v1.7.0
自 v1.6.0 以来的 250 个提交，带来内置 YukiZygisk、Lua 插件、Kasumi / Kagami 深度集成，以及新的镜像修补和管理器体验。
兼容性变化
- 仅支持 arm64 设备，最低 Android 12（API 31），不再提供 x86_64 管理器。
- 新增 Android 17 / Linux 6.18 KMI，共提供 8 个 KMI 的 LKM，覆盖 5.10、5.15、6.1、6.6、6.12 和 6.18。
- 内核与管理器通过 UAPI 识别版本及内置 LKM 来源，区分管理器更新与内核更新需求，并保留自定义 LKM 的识别。
YukiZygisk
- 内置 YukiZygisk，支持 ARM64 与 ARMv7 应用运行时、Zygisk Next API 4 模块及 native runtime API v4。
- 支持 Android 17 QPR2，改进 WebView zygote 卸载挂载、模块加载策略、运行时清理与初始化交接。
- 管理器展示内核提供的运行状态，支持跨重启保留诊断信息并导出日志。
Kasumi 与挂载
- 将 Kasumi 接入内核基础设施，内置 Kagami 挂载后端，并保留外部 metamodule 的挂载接管逻辑。
- 新增 KSM su 模式与可持久化的自定义 su 路径，管理器提供对应配置入口。
- 隐藏规则支持内核生命周期管理、状态展示与重试；修复规则路径解析、删除失败处理和已授权应用的文件可见性。
- 修复 FUSE 缓存查找、atomic open 与目录分页下的隐藏行为。
- 改进隔离进程的 mountinfo / mounts 一致性，保留原生隔离服务的挂载命名空间语义，并提供可选的挂载视图清理设置。
- 增加冲突模块与内置配置检查，避免多个实现同时接管相同路径。
插件、安装与镜像工具
- 新增 Lua 插件系统，支持配置、日志、守护进程、原生模块和多源插件仓库。
- 新增 ImgPatch 直接镜像修补安装流程，支持内嵌早期启动配置与 LKM 更新；恢复操作绑定对应的原始镜像哈希备份。
- 重做分区管理与 AnyKernel3 刷入流程，加入 YukiFB ramdisk 编辑器、多 fragment 会话以及文本 / ELF 查看支持。
- 新增 UTS View 配置，支持早期启动、运行时全局及 DenyList 范围的内核身份视图。
- 改进模拟软重启、su 参数诊断与交互式 shell，修复模块服务的进程分组和生命周期处理。
管理器
- 新增 Material 3 Expressive 界面、点击触感、可选预测性返回和改进的重启菜单。
- 模块仓库支持多个来源；新增独立功能控制页面，整合 SuperKey 管理与 Kasumi 设置。
- WebUI X 升级至 v438，修复初始化，并补齐 KSU WebUI 的主题颜色、窗口边距、包信息和退出接口。
- CI 更新加入签名校验、Cloudflare Pages 镜像与下载 / 安装可靠性改进。
- 更新全部 43 个语言资源目录的翻译，修复过期 Snackbar 阻塞控件、超级用户列表刷新及背景裁剪等问题。
- 精简 WebUI 反射、依赖与打包内容，压缩内置 LKM，降低安装包开销。
内核与可靠性
- 同步上游 memfd、NO_NEW_PRIVS、execveat、应用配置与 SELinux 相关改进。
- 加固 APK 签名块和 ZIP 边界检查、su 身份及 xperm 输入校验。
- 修复 daemon 原子替换、可执行上下文保留、fd 执行与兼容 ioctl 转发等问题。
完整变更：v1.6.0...v1.7.0
v1.6.0
YukiSU v1.6.0
🚀 重大变更
- Kasumi 取代 HymoFS 作为挂载后端 (#32)
- magisk-compat：基于 magic mount 的可见 su —— 独立成项目，配套元模块（metamodule）安装 / 挂载体系（含 cgroups 修复，避免 service.sh / boot-completed.sh 被误杀）
- SELinux hide + SuperKey 加固 (#35)，SuperKey 改走 prctl / TSR，模块构建加固（check_symbol、DDK 20260313）
✨ 新功能
- 动态管理器（dynamic manager）支持
ksud insmod支持 (#31)- 软重启（soft reboot, #3272）
- 移植上游 adb root 功能链 (#30)，adb 设置持久化
- sulog 栈同步上游 (#29)，feature id 与上游对齐
📱 管理器
- 全语言翻译补全，清理无用字符串
- 超级用户列表新增滑动操作
- shared UID 应用按组配置
- SELinux hide 反馈改用 snackbar
- app profile 列表状态同步、新 allowlist 自动注入 shell
- 一批 UI / 打包 / 可用性修复
🐧 内核
- 源码布局重组 + 同步上游特性与修复
- allowlist 重构 (#3418)
- 移植 KernelSU 的 selinux / initrc 修复
- 修复 optional superkey 与 builtin config
🔧 内部 / CI
- 移除 Crowdin 集成；CI JS actions 迁移 Node 24；ksud 构建后重打包 APK；稳定内核版本后缀；清理过时 userspace su 构建文件；文档更新
Full Changelog: v1.5.0...v1.6.0
v1.5.0
Release Notes / 发布说明
Changes since v1.4.0 (2026-02-23).
自 v1.4.0（2026-02-23）以来的更新。
Highlights / 亮点
-
Late-load mode support / 新增 late-load 模式支持
Added end-to-end late-load support across kernel, ksud and manager, including boot-time bootstrap and policy handling.
在 kernel、ksud 与 manager 间完整加入 late-load 模式支持，并补齐启动引导与策略处理流程。 -
HymoFS expanded / HymoFS 功能增强
Added maps spoofing, cpio embedding, better mirror-path management, improved built-in mount / HymoFS LKM integration, and stricter embedded asset validation.
新增 maps spoofing、cpio 嵌入、镜像路径管理优化，并增强内置挂载 / HymoFS LKM 集成与嵌入资源校验。
Improvements / 改进
-
ksud script compatibility synced upstream / ksud 脚本兼容性继续向上游对齐
Module script execution semantics, environment variables, installer wrappers, and pending-module handling were aligned more closely with upstream behavior.
模块脚本执行语义、环境变量、installer wrapper 以及 pending module 处理进一步与上游行为对齐。 -
Kernel and SELinux refinements / 内核与 SELinux 细节优化
Improved late-load SELinux flow, applied profile sepolicy files during boot, and refined allowlist / app-profile handling with RCU-based updates.
优化 late-load 下的 SELinux 流程，在启动阶段应用 profile sepolicy 文件，并通过 RCU 改进 allowlist / app profile 更新逻辑。 -
LKM-only cleanup and hook updates / LKM-only 清理与 Hook 更新
Removed more legacy GKI / builtin branches and synced newer hook-related changes, including tsrhook-related updates.
继续清理遗留的 GKI / builtin 分支，并同步较新的 hook 相关改动，包括 tsrhook 相关更新。 -
Build and compatibility updates / 构建与兼容性改进
Synced Magica bootstrap, improved Qualcomm compatibility, refreshed resetpropAlone compatibility for older NDKs, and added DDK-based HymoFS LKM CI builds.
同步 Magica bootstrap，改进 Qualcomm 兼容性，更新 resetpropAlone 对旧 NDK 的兼容，并加入基于 DDK 的 HymoFS LKM CI 构建。
Manager / 管理器
- UI and settings fixes / 界面与设置修复
Fixed WebUI task titles not resetting after exit, and hid the uninstall entry when KernelSU is not installed or unavailable.
修复退出 WebUI 后最近任务标题不恢复的问题，并在 KernelSU 未安装或不可用时隐藏卸载入口。
Other / 其他
- Various refactors, upstream syncs, and reliability improvements across kernel, ksud, manager, and workflows.
同时包含若干内核、ksud、manager 与工作流层面的重构、上游同步和稳定性改进。
v1.4.0
Release Notes / 发布说明
Breaking Changes / 重大变更
-
GKI support removed / 移除 GKI 支持
Only LKM mode is supported now.
现仅支持 LKM 模式，不再支持 GKI 内核。 -
ksud with built-in HymoFS / ksud 内置 HymoFS
HymoFS kernel module and hymo mount are built into ksud (equivalent to hymo meta module).
ksud 内置 HymoFS 内核模块与 hymo 挂载（等价于 hymo 元模块）。 -
magiskboot, busybox and utilities rewritten in C++ / magiskboot、busybox 等小工具 C++ 重写并集成
magiskboot, busybox and other utilities have been rewritten in C++ and are now built into ksud.
magiskboot、busybox 等小工具已用 C++ 重写，并编译集成进 ksud。 -
HymoFS protocol v13 / HymoFS 协议 v13
HymoFS protocol updated to v13.
HymoFS 协议已更新至 v13。
Other / 其他
- Various fixes and improvements.
若干修复与改进。
v1.3.0
v1.3.0