Repository navigation
Releases
FinaSU v1.6.4
FinaSU v1.6.4 focuses on Manager refinements, SUSFS controls, and release reliability.
English
Manager
- Refreshed the splash screen and added a navigation icon animation picker with Morph and Fade modes.
- Completed the navigation animation strings across all supported locales.
- Improved the module flashing screen: the completion action switches between Close and Reboot, duplicate actions are blocked while work is in progress, and the module list is reordered after an update.
- Added SUSFS priority UID filter controls, including capability detection, app search and selection, shared-UID guidance, and validated ksud configuration handling.
Kernel and reliability
- Exact kernel symbol lookup now stops at the first match.
- Fixed the remaining ksud Clippy warnings and a Manager lint failure in the priority app picker.
简体中文
管理器
- 刷新启动画面,新增导航图标动画选择器,支持 Morph 与 Fade 两种模式。
- 为全部受支持语言补齐导航动画文案。
- 增强模块刷写界面:完成后的操作会根据状态显示关闭或重启,处理中阻止重复操作,模块更新后重新排序列表。
- 新增 SUSFS 优先级 UID 过滤控制,包含能力检测、应用搜索与选择、共享 UID 提示以及 ksud 配置校验。
内核与可靠性
- 精确内核符号查找现在在首个匹配项处停止。
- 修复 ksud 剩余的 Clippy 警告,以及 Manager 优先级应用选择器的 lint 失败。
FinaSU v1.6.3
FinaSU v1.6.3 extends SELinux hiding to handle inode_setxattr correctly on non-SUSFS kernels.
English
SELinux compatibility
- Added an
inode_setxattrLSM hook for app UIDs that holdCAP_MAC_ADMINwhen settingsecurity.selinux. - Hidden SELinux contexts are resolved from the saved policy while preserving native relabel checks, transition validation, filesystem association checks, and invalid-context audit logging.
- The saved policy is retained after a partial hook setup failure so a later enable or retry does not continue with incomplete state.
- The setxattr hook is not installed on SUSFS builds, keeping the existing SUSFS path unchanged.
Parser consistency
- SELinux context parsing now stops immediately on unknown users or roles, matching native behavior and avoiding extra work proportional to the remaining input.
简体中文
SELinux 兼容性
- 为非 SUSFS 内核增加
inode_setxattrLSM Hook,处理持有CAP_MAC_ADMIN的应用 UID 对security.selinux的写入。 - 隐藏的 SELinux 上下文改由备份策略解析,同时保留原生的重标签权限检查、转换校验、文件系统关联检查和无效上下文审计日志。
- Hook 初始化部分失败后继续保留备份策略,避免后续启用或重试时使用不完整状态。
- SUSFS 构建不安装该 setxattr Hook,保持现有 SUSFS 路径不变。
解析一致性
- SELinux 上下文解析遇到未知用户或角色时立即停止,与原生行为一致,并避免处理剩余输入带来的额外开销。
FinalSU v1.6.2
FinaSU v1.6.2 adds selective theme-package imports and an isolated theme preview, with the remaining ksud lint cleanup.
English
Theme import
- Choose which parts of a theme package to import: main background, page backgrounds, cards and page slots, font, home layout, bottom-bar icons, music, sound effects, colors, dark mode and layout, and app language.
- Import only the selected parts while keeping the package metadata and resource handling intact.
Theme preview
- Preview a prepared theme package before applying it.
- The preview opens an isolated five-page Manager session covering Home, Plugins, Superuser, Modules, and Settings.
- Preview appearance is resolved from the package without writing the current settings, and page interactions cannot mutate state.
Localization and maintenance
- Added the new theme import and preview strings across all supported locales.
- Cleared the remaining ksud Clippy warnings without changing behavior.
简体中文
主题导入
- 可选择主题包需要导入的内容:主背景、页面背景、卡片与页面插槽、字体、首页布局、底栏图标、音乐、音效、颜色、暗色与布局、界面语言。
- 只应用选中的部分,同时保留主题包元数据与资源处理逻辑。
主题预览
- 应用主题包前可先查看预览效果。
- 预览使用独立首页、插件、超级用户、模块、设置五页面 Manager 会话。
- 预览外观直接从主题包解析,不写入当前设置,页面交互也不会修改状态。
本地化与维护
- 为所有支持语言补齐主题导入与预览文案。
- 清理 ksud 剩余的 Clippy 警告,不改变行为。
FinaSU v1.6.1
FinaSU v1.6.1 is a security and compatibility patch release.
English
Security
- Reject profile names containing path separators, NUL, CR/LF,
.or.., preventing path traversal when reading and writing profile files. - Shell-quote KsuCli arguments passed to root-shell commands, preventing variables from escaping into privileged commands.
Compatibility
- On x86_64 kernels without
x64_sys_call, fall back to patchingdo_syscall_64so the syscall hook can initialize on older GKI kernels.
Fixes
- Ensure the module directory exists before switching the mount engine to NoMount mode.
简体中文
安全
- 拒绝包含路径分隔符、NUL、CR/LF、
.或..的 profile 名称,防止读写 profile 文件时发生路径穿越。 - 对 KsuCli 传给 Root shell 的参数统一进行 shell 转义,防止变量逃逸到特权命令。
兼容性
- x86_64 内核缺少
x64_sys_call时回退修补do_syscall_64,使系统调用 Hook 能在较旧 GKI 内核上完成初始化。
修复
- 切换到 NoMount 挂载模式前确保模块目录存在。
FinaSU v1.6.0
FinaSU v1.6.0 focuses on SUSFS 2.4 kernel compatibility, with additional Manager fixes.
English
SUSFS 2.4
Native SELinux registration
- Moved the SUSFS pin to v2.4.0.
- SUSFS 2.4 now answers SELinux
contextandaccessqueries from its own type and access-vector hash tables. FinaSU now registers every injected type and pre-injection allow rule so these entries are hidden instead of remaining visible as a fingerprint. - Registration uses
susfs_add_sus_type()andsusfs_add_sus_avd_allowed_by_type()after resolving each injected type and rule. - The kernel build probes those entry points at compile time. Patch sets with the 2.4 registration APIs use the new path; older patch sets compile against the previous policy-generation behavior without weak runtime symbol checks.
Policy fingerprint consistency
- Adjusted SELinux policy generation and AVC reset behavior for the SUSFS 2.4 path. KernelSU no longer increments
latest_grantingin a way that produces a policy sequence number a stock kernel would not report. - Kept the previous policy-generation and original-type cache path for older SUSFS patch sets.
Priority UID filter
- Added the
KSU_SUSFS_PRIORITY_UID_FILTERkernel option required by the v2.4 patch set. - Added priority UID filter dispatch and refreshed the package-derived UID list when Manager/package state changes.
Integration checks
- Documented the required SUSFS kernel symbols, call sites, and the differences between SUSFS 2.3 and 2.4.
- Extended the SUSFS upstream checker for the new pin and registration requirements.
Manager
- Restored full card artwork coverage without distorting the image.
- Added the working-mode badge on non-GKI devices.
- Expanded hook-type labels to distinguish Tracepoint and SUSFS Inline syscall redirects across supported locales.
简体中文
SUSFS 2.4
原生 SELinux 注册
- 将 SUSFS 版本固定到 v2.4.0。
- SUSFS 2.4 改为通过自己的类型表和访问向量表响应 SELinux
context与access查询。FinaSU 现在会登记所有注入类型和注入前的 allow 规则,避免这些条目继续暴露,形成可检测指纹。 - 在解析每个注入类型和规则后调用
susfs_add_sus_type()与susfs_add_sus_avd_allowed_by_type()完成注册。 - 内核构建阶段会探测这些入口:带 2.4 注册接口的补丁集使用新路径,旧补丁集继续编译为原有的策略代次逻辑,不再依赖运行时弱符号检测。
策略指纹一致性
- 调整 SUSFS 2.4 路径下的 SELinux 策略代次与 AVC 重置行为。KernelSU 不再以会产生原厂内核不存在序列号的方式递增
latest_granting。 - 对旧版 SUSFS 补丁集保留原有策略代次和原始类型缓存逻辑。
优先级 UID 过滤
- 新增 SUSFS v2.4 补丁集链接所需的
KSU_SUSFS_PRIORITY_UID_FILTER内核选项。 - 接入优先级 UID 过滤命令分发,并在 Manager 或应用包状态变化时刷新 UID 列表。
集成检查
- 补充 SUSFS 内核所需的符号、调用点及 2.3/2.4 差异文档。
- 扩展 SUSFS 上游检查脚本,覆盖新的版本固定和注册要求。
Manager
- 恢复卡片图片完整覆盖,同时保持图片比例不失真。
- 非 GKI 设备支持显示工作模式徽章。
- 在支持的语言中明确区分 Tracepoint 与 SUSFS Inline 系统调用重定向类型。
FinaSU v1.5.2
FinaSU v1.5.2 fixes SUSFS compatibility, x86_64 syscall handling, and Manager image/link behavior.
English
SUSFS
- Added audited support for SUSFS v2.4.0 while keeping v2.3.0 compatibility.
- Unaudited SUSFS versions are now annotated instead of being rejected, so compatible providers remain manageable.
- Improved per-write failure classification and diagnostics for payload-layout mismatches.
Kernel
- On x86_64, syscalls skipped by seccomp are no longer executed by the KernelSU hook or reported as
ENOSYS.
Manager
- External URLs that cannot be opened now show a localized error instead of failing silently.
- Picked artwork now preserves its aspect ratio and image detail across cropping, previews, and wallpaper surfaces.
- Added the crop-ratio reset action and its localized label across all supported locales.
简体中文
SUSFS
- 新增对 SUSFS v2.4.0 的审计支持,同时保持 v2.3.0 兼容。
- 未审计的 SUSFS 版本现在只显示提示,不再直接拒绝,因此兼容的提供方仍可正常管理。
- 改进单次写入失败分类,并为 payload 布局不匹配提供更明确的诊断。
内核
- x86_64 上被 seccomp 跳过的系统调用不再被 KernelSU hook 执行,也不会错误返回
ENOSYS。
Manager
- 无法打开外部链接时会显示本地化错误提示,不再静默失败。
- 选择图片时会保持原始宽高比和图像细节,覆盖裁剪、预览与壁纸显示。
- 新增裁剪比例重置操作,并补齐所有支持语言的本地化标签。
FinaSU v1.5.1
FinaSU v1.5.1 is a small kernel compatibility patch.
English
- Fixed ARM64 syscall argument tracking on Linux 7.3 and newer by reading the first syscall parameter from
orig_x0. - Fixed the x64 preinit runner ELF layout for systems using page sizes larger than 4 KiB, preventing PID 1 from failing to load the embedded runner.
- Reworked
selinux_hidecontext handling to parsesetprocattrinput once against the live policy and fall back to the backed-up policy only when required. - Corrected handling of blank and newline-only security contexts.
简体中文
- 修复 Linux 7.3 及更新内核的 ARM64 系统调用参数跟踪,首个系统调用参数改为从
orig_x0读取。 - 修复大于 4 KiB 页大小的 x64 系统中 preinit runner 的 ELF 布局,避免 PID 1 无法加载内置 runner。
- 重构
selinux_hide的上下文处理:优先使用当前策略解析一次setprocattr输入,仅在需要时回退到备份策略。 - 修正空白及仅包含换行符的安全上下文处理。
FinaSU v1.5.0
FinaSU v1.5.0 improves SELinux handling and fixes module management issues in the Manager.
English
Kernel and SELinux
- Fixed SELinux policy generation tracking when KernelSU updates its policy rules, keeping AVC invalidation and policy-load notifications on the correct generation.
- Cached original SELinux type metadata in the updated policy to avoid repeated symbol-table searches during
selinux_hidecontext handling, with fallback lookups when cached metadata is unavailable. - Corrected security-context handling for empty and newline-terminated inputs.
Module management
- Detects LSPosed, Xposed, and Vector modules by both module ID and display name, prioritizing the more specific Xposed-compatible group over the generic Zygisk group.
- Fixed custom module ordering so drag order overrides group, provider, enabled-state, and name priorities while editing without changing the saved order on normal refreshes.
- Made module-list refresh state updates atomic to prevent ordering races during reordering and refresh.
- Accepts
application/x-zip-compressedandapplication/x-zipMIME types when opening module ZIP files from a file manager.
简体中文
内核与 SELinux
- 修复 KernelSU 更新 SELinux 策略规则时的策略代次跟踪,使 AVC 缓存失效和策略加载通知使用正确的代次。
- 在更新后的策略中缓存原始 SELinux 类型元数据,减少
selinux_hide安全上下文处理中的符号表重复查找;缓存不可用时回退到原有查询。 - 修正空上下文和以换行结束的安全上下文处理。
模块管理
- 同时根据模块 ID 和显示名称识别 LSPosed、Xposed 与 Vector,优先归入更具体的 Xposed 兼容分组,而不是通用 Zygisk 分组。
- 修复自定义模块排序:编辑时拖拽顺序优先于分组、提供者、启用状态和名称顺序,普通刷新不会再破坏已保存顺序。
- 将模块列表刷新改为原子状态更新,避免排序与刷新并发时出现顺序竞争。
- 从文件管理器打开模块 ZIP 时,兼容
application/x-zip-compressed和application/x-zipMIME 类型。
FinaSU v1.4.5
FinaSU v1.4.5 is a small patch release.
English
- Fixed feature initialization aborting when
/data/adb/modulesdoes not exist. - A missing module directory is now treated as having no installed modules, so saved features such as
selinux_hidecan still be applied and the feature baseline is captured. - Other module-directory read errors still fail instead of being silently ignored.
- Added tests covering a missing directory, invalid directory reads, and enabled or disabled module declarations.
简体中文
- 修复
/data/adb/modules不存在时功能初始化提前中止的问题。 - 模块目录不存在现在按“没有已安装模块”处理,
selinux_hide等已保存功能仍会正常应用并记录功能基线。 - 其他模块目录读取错误仍会正常失败,不会被静默忽略。
- 新增模块目录缺失、目录读取错误以及启用/停用模块声明的测试。
FinaSU v1.4.4
FinaSU v1.4.4 focuses on module management and Manager responsiveness.
English
Module management
ksudnow honors feature ownership declared in bothmodule.propand module config, deduplicates declarations, and avoids overwriting features owned by another module.- Module sorting now combines group priority, enabled state, name/ID ordering, and optional drag ordering.
- Superuser apps can be sorted explicitly A → Z or Z → A.
- Module and superuser screens no longer reset their scroll position while reordering.
Manager and plugins
- Reduced recomposition and eager work across pager screens, the floating drawer, and the bottom bar.
- Added smoother transitions for bottom-bar icons, the floating selection pill, app rows opening profiles, and changing digit values.
- Plugin names, descriptions, and config labels now follow the system language with fallback to manifest defaults; search also matches localized text.
Documentation
- Documented the localized plugin description fallback.
简体中文
模块管理
ksud现在同时识别module.prop和模块配置中的功能所有权声明,自动去重,并避免覆盖其他模块拥有的功能。- 模块排序现在综合分组优先级、启用状态、名称/ID 顺序和可选拖拽顺序。
- 超级用户应用支持明确按 A → Z 或 Z → A 排序。
- 模块与超级用户界面在重新排序时不再重置滚动位置。
Manager 与插件
- 降低分页页面、浮动抽屉和底栏中的重组与提前计算开销。
- 优化底栏图标、浮动选择胶囊、应用行进入资料页及数字变化时的过渡动画。
- 插件名称、描述和配置标签按系统语言显示,缺少翻译时回退到清单默认值;搜索也会匹配本地化文本。
文档
- 补充插件本地化描述回退规则。