Skip to content

Releases

FinaSU v1.6.4

Choose a tag to compare

@matsuzaka-yuki matsuzaka-yuki released this 17 Nov 13:12

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

Choose a tag to compare

@github-actions github-actions released this 15 Nov 16:13

FinaSU v1.6.3 extends SELinux hiding to handle inode_setxattr correctly on non-SUSFS kernels.

English

SELinux compatibility

  • Added an inode_setxattr LSM hook for app UIDs that hold CAP_MAC_ADMIN when setting security.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_setxattr LSM Hook,处理持有 CAP_MAC_ADMIN 的应用 UID 对 security.selinux 的写入。
  • 隐藏的 SELinux 上下文改由备份策略解析,同时保留原生的重标签权限检查、转换校验、文件系统关联检查和无效上下文审计日志。
  • Hook 初始化部分失败后继续保留备份策略,避免后续启用或重试时使用不完整状态。
  • SUSFS 构建不安装该 setxattr Hook,保持现有 SUSFS 路径不变。

解析一致性

  • SELinux 上下文解析遇到未知用户或角色时立即停止,与原生行为一致,并避免处理剩余输入带来的额外开销。

FinalSU v1.6.2

Choose a tag to compare

@github-actions github-actions released this 14 Nov 12:59

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

Choose a tag to compare

@github-actions github-actions released this 12 Nov 14:29

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 patching do_syscall_64 so 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

Choose a tag to compare

@github-actions github-actions released this 10 Nov 13:16

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 context and access queries 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() and susfs_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_granting in 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_FILTER kernel 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

Choose a tag to compare

@github-actions github-actions released this 10 Nov 06:39

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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 14:18

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_hide context handling to parse setprocattr input 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

Choose a tag to compare

@github-actions github-actions released this 07 Nov 05:40

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_hide context 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-compressed and application/x-zip MIME 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-zip MIME 类型。

FinaSU v1.4.5

Choose a tag to compare

@github-actions github-actions released this 04 Nov 06:21

FinaSU v1.4.5 is a small patch release.

English

  • Fixed feature initialization aborting when /data/adb/modules does not exist.
  • A missing module directory is now treated as having no installed modules, so saved features such as selinux_hide can 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

Choose a tag to compare

@github-actions github-actions released this 03 Nov 18:31

FinaSU v1.4.4 focuses on module management and Manager responsiveness.

English

Module management

  • ksud now honors feature ownership declared in both module.prop and 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 与插件

  • 降低分页页面、浮动抽屉和底栏中的重组与提前计算开销。
  • 优化底栏图标、浮动选择胶囊、应用行进入资料页及数字变化时的过渡动画。
  • 插件名称、描述和配置标签按系统语言显示,缺少翻译时回退到清单默认值;搜索也会匹配本地化文本。

文档

  • 补充插件本地化描述回退规则。