KernelSUExt

简体中文 | English


简介

KernelSUExt 是为 KernelSU 管理器编写的 LSPosed/Xposed 模块,用来备份:

  • 超级用户配置:导出/导入 KernelSU Root列表。
  • 模块文件:按模块单独打包 ZIP 备份,可选择需要备份的模块。

浮动按钮常驻于 KernelSU 管理器界面左上角,点击即可调出功能弹窗。

功能

  • 导出超级用户列表 → Download/kernelsu_backup/ 下生成 superusers-YYYY-MM-DD HH-mm-ss.json
  • 从文件导入超级用户列表(选择 JSON)
  • 备份模块:多选模块,逐个生成 <moduleId>_YYYY-MM-DD HH-mm-ss.zip
  • 任务进度:备份/恢复时显示 Loading,完成后自动关闭并提示
  • 备份目录展示:功能弹窗中会显示当前备份目录路径

安装与要求

  • Android 10+,已 Root
  • 安装 KernelSU(目标包:me.weishu.kernelsu
  • 安装 LSPosed/EdXposed,并在作用域中勾选 KernelSU
  • 安装并启用本模块后重启 KernelSU 应用(或设备)

使用步骤

  1. 打开 KernelSU 管理器,左上角会出现拼图样式的浮动按钮(随明暗主题切换黑/白图标)。
  2. 点击按钮,选择所需功能:导出/导入超级用户、备份模块。
  3. 备份与导入文件默认路径:/storage/emulated/0/Download/kernelsu_backup/;若外置下载目录不可写,则退回应用私有目录。

备份文件说明

  • 超级用户:superusers-YYYY-MM-DD HH-mm-ss.json
  • 模块:<moduleId>_YYYY-MM-DD HH-mm-ss.zip(每个模块独立文件)
  • 时间戳使用文件系统安全格式(不含冒号)

注意事项

  • 需要 su 权限;若设备无 zip/unzip 命令,应用会使用内置打包/解压。
  • 导入后会触发刷新,若未生效,可重启 KernelSU 管理器。
  • 若浮动按钮缺失,请确认模块在 LSPosed 里已启用且作用域正确。
  • 免责声明:仅供学习/测试/个人备份使用,风险自负。

English

KernelSUExt is an LSPosed/Xposed module for KernelSU Manager that backs up:

  • Superuser config: export/import allowlist & profiles (JSON).
  • Modules: per-module ZIP backup with multi-selection.

A floating puzzle icon appears at the top-left of KernelSU Manager; tap it to open the actions dialog.

Features

  • Export superuser list → Download/kernelsu_backup/superusers-YYYY-MM-DD HH-mm-ss.json
  • Import superuser list from JSON
  • Backup modules: multi-select, create <moduleId>_YYYY-MM-DD HH-mm-ss.zip per module
  • Restore modules from ZIP; falls back to in-app unzip + su copy if no system unzip
  • Loading indicators during backup, auto-dismiss with toasts
  • Backup directory path shown in the dialog

Requirements & Install

  • Android 10+, rooted
  • KernelSU (me.weishu.kernelsu) installed
  • LSPosed/EdXposed enabled with KernelSU in scope
  • Install & enable this module, then restart KernelSU (or reboot)

Usage

  1. Open KernelSU Manager; the floating puzzle icon appears top-left (auto theme-aware).
  2. Tap it and choose: export/import superuser or backup modules.
  3. Default path: /storage/emulated/0/Download/kernelsu_backup/; falls back to app private dir if public downloads not writable.

Backup Files

  • Superuser JSON: superusers-YYYY-MM-DD HH-mm-ss.json
  • Module ZIP: <moduleId>_YYYY-MM-DD HH-mm-ss.zip
  • Timestamps are file-system safe (no colons).

Notes

  • su required; if zip/unzip binaries are missing, in-app zip/unzip is used.
  • If changes don’t apply after import, restart KernelSU Manager.
  • If the floating icon is missing, ensure the module is enabled and scoped in LSPosed.
  • Disclaimer: For learning/testing/personal backup only. Use at your own risk.

Releases

12/2/2025, 2:02:57 PM

  • 模块备份修复与完善:复制后自动 chown/chmod 修正权限,避免 backup.prop EACCES;打包 ZIP 以模块目录为根,兼容官方 KernelSU 安装;备份完成改用弹窗显示完整信息(含备份目录、核心文
    件可能无效的提醒),标题“备份成功”。
  • 备份/还原文案更新:菜单项改为“备份 root 列表 / 还原 root 列表 / 备份模块”,相关提示统一使用“备份/还原”表述;错误 Toast 直接展示具体原因。
  • 安装唤起支持:MainActivity 增加 VIEW/BROWSABLE 过滤器与 FileProvider 缓存路径,支持处理微信等追加“.apk.1”后缀的 APK 链接,复制到缓存后以正确 MIME 调起系统安装;修正 onNewIntent
    签名。

Assets

2

12/2/2025, 10:12:56 AM

  • KernelSU 管理器内置入口:在左上角注入拼图浮动按钮,随明暗主题切换黑/白图标,弹窗展示当前备份目录。
  • 超级用户配置备份/导出:支持多策略收集(UI 列表/Natives/安装包扫描),输出 superusers-YYYY-MM-DD HH-mm-ss.json,含版本与时间戳。
  • 配置导入/恢复:文件选择器导入 JSON,自动适配不同 Profile 构造函数与 Kotlin getter,导入后自动刷新列表并重建界面。
  • 模块备份:列出 /data/adb/modules 模块,可多选逐个生成 _时间戳.zip,支持多条 su 拷贝回退(cp/toybox/busybox),完成后提示备份路径。
  • 备份路径与文件共享:默认写入公共 Download/kernelsu_backup/,不可写时回退到应用私有目录;内置 FileProvider 便于文件访问。
  • 激活状态可视化:应用首页展示模块激活状态与最近检测时间,基于模块发送的 MODULE_ACTIVE 广播与本地存储。

注意

  • 需求:Android 10+,已 Root;需安装 KernelSU(me.weishu.kernelsu)并通过 LSPosed/EdXposed 作用域启用本模块。

Assets

2