ShizukuX增强版本

ShizukuX是Shizuku是一个独立维护的社区分支，基于广受欢迎的Android实用工具应用Shizuku。.它是作为ShizukuPlus的延续而构建的，并融合了原始RikkaApps代码和各种独立社区分支（例如thedjchi's版本）的功能。

软件介绍

ShizukuX是Shizuku的一个社区增强型分支，基于thedjchi/Shizuku和ShizukuPlus构建。它继承了原项目的所有功能，同时增加了本地化和体验优化，以吸引更广泛的用户群体。

Shizuku允许普通应用通过ADB/Root启动的特权进程直接调用系统级API。ShizukuX在保持100%兼容性的同时，为高级用户和开发者增加了实用功能。

ShizukuX使用说明

1.打开软件，进入主页；

2.当前显示未运行，用户要根据Root情况进行激活；

无Root设备：开启开发者选项与 USB 调试 → 连接电脑 → 使用 ADB 命令激活特权进程

已Root 设备：打开软件授权Root权限 → 开启开机自启 → 保持服务后台常驻

3.完成后援进入【组件管理】，按需启用以下模块：

Dhizuku 模块

Extra 扩展 API

Root 兼容桥增强模块

4.打开需要系统权限的第三方应用，在授权弹窗中调用特权接口；

5.打开应用管理，查看全部应用，随时回收或限制对应权限；

ShizukuX的高级功能有哪些

1、特权UI自动化，不需要无障碍服务也能抓取完整UI层级、模拟点击或滑动，适合Tasker、AI自动化脚本，稳定性强于系统自带uiautomator

2、安全访问系统受限目录 `/data/app`、`/Android/data`；Root 模式下还可以读写 `/data/data`，给高级文件管理器、备份工具使用，方便导出应用私有数据

3、支持运行带GPU加速的隔离 Linux/Microdroid 虚拟机，在安卓手机上跑小型虚拟机环境

4、修改对外上报的设备型号、硬件信息，绕过APP机型限制、区域锁

5、免Root管控私有DNS、防火墙路由，给广告拦截工具提供底层网络控制能力。

6、多台装有 ShizukuX 的安卓设备之间安全同步任务、状态，跨设备联动

7、通过ADB一次性将 ShizukuX设置为设备所有者，不需要Root，获得DPM 设备管理权限；权限在重启后依然保留，并可以把DeviceOwner权限安全共享给授权App。

ShizukuX无线调试一直卡在搜索配对服务

原因：

ShizukuX后台被系统冻结，无法访问局域网；

防火墙、 广告拦截软件拦截本地回环端口；

解决：

ShizukuX 关闭电池优化，允许后台高耗电；

关闭防火墙、本地广告拦截软件；

手机和无线调试必须在同一个WiFi；

✨ 核心功能

• 通用权限提供程序：一个统一的接口，将Root、ADB Shell和Dhizuku（设备所有者）作为权限来源。

• OneUI 8+ 主题修复：使 Hex Installer 和 Substratum 等主题引擎能够在 Android 16/17 和 OneUI 8+ 上运行。

• 雫模式：与任何拥有雫权限的应用共享系统设备所有者绑定器——可通过 ADB 配置，无需 Root 权限。

• 可自定义手势：向左滑动、向右滑动、长按等等，每个应用程序均可配置。

• 应用内更新日志：更新后无需离开应用即可查看版本亮点。

• 批量管理：选择多个应用，一键授予/撤销权限或隐藏权限。

• 活动日志：实时审核 API 调用和su桥接命令，带有应用图标和实时刷新。

• Root 兼容性中心：一个用于旧版 Root 应用的仪表板，具有精细的模块控制（Magisk 欺骗、自动授予、文件拦截等）。

• 通用 SU 自动化：一键“魔法设置”，将所有已安装的 Root 应用指向 ShizukuX SU 桥接器。

• 服务诊断：诊断并修复服务启动问题（包括三星自动阻止程序）。

• 内置功能指南：每个增强功能都附带一个信息图标，用通俗易懂的语言解释其用途。

• 快速设置磁贴：从通知栏查看和切换服务状态。

🚀 此外，API还进行了增强

ShizukuX 提供原版 Shizuku 所不具备的专属系统接口，用于高级自动化和工具开发：

• AICore+ 自动化桥接器：无需 root 权限即可为 AI 工具提供特权 UI 自动化功能（层级结构转储、点击/滑动）。

• AVF（虚拟机）管理器：运行具有 GPU 加速的独立 Linux/Microdroid 虚拟机。

• 特权存储代理：对受限路径（/data/data/，/data/app/）进行身份验证后方可访问，用于备份和文件管理。

• 设备欺骗（在设置中欺骗设备身份）：向系统提供不同的设备信息以绕过特定型号的限制。

• 智能桥接（AI Core Plus）：特权 NPU 调度和屏幕上下文智能。

• Window Manager Plus：强制自由调整窗口大小，管理浮动气泡条和弹性覆盖层。

• 系统主题桥接器（Overlay Manager Plus）：无需 root 权限即可管理主题（例如 Hex Installer）的 Overlay。

• 网络与 DNS 管理：管理私有 DNS 和防火墙路由，以实现无需 Root 权限的广告拦截。

• 深度进程控制（Activity Manager Plus）：允许进程管理器更积极地终止应用程序并设置备用存储桶。

• 连续性桥接：在多个 ShizukuX 设备之间安全地传输状态和任务。

向后移植与性能

ShizukuX 无需编写任何一行代码，即可让普通的 Shizuku 应用运行更快、兼容性更强：

• 透明 shell 拦截器：将常见的pm、am和settings命令路由到更快的原生 API。

• 本地 ADB 代理：在端口 15555 上模拟 ADB 服务器，以便在关闭无线调试后，旧版应用程序仍能与 Shizuku 一起工作。

• SU bridge：一个基于 Shizuku 的su替代方案，适用于支持自定义 Root 路径的免 Root 应用。

• plus命令行工具：可在内部使用的特权 CLI rish。

• 动态应用数据库：实时同步来自 GitHub 的应用描述和建议，以保持用户界面最新。

⚙️ 模块化控制

ShizukuX 中的所有功能都是可选的。在“设置”中的“附加功能”类别下切换功能：

• 透明壳拦截

• 独立增强型 API（AVF、存储、智能等）

• 主屏幕卡片显示

• 活动日志

🔌第三方应用程序兼容性

ShizukuX 使用其自身的包名进行安装xyz.shizuku.extra.api，并且可以与原版 Shizuku 共存。由于大多数 Shizuku 应用仅检查moe.shizuku.privileged.api包名，ShizukuX 附带了一个轻量级的Compat Hub——一个小型配套应用，用于注册该包名并将 Binder/权限请求转发给 ShizukuX。

如果第三方应用程序无法检测到 ShizukuX：

1. 首先启动 ShizukuX 服务（ADB 或 Root 方法）。

2. 在主屏幕上，使用Compat Hub卡安装配套应用程序（它包含在 APK 中；安装依赖于正在运行的服务，因此请先启动该服务）。

3. 重新打开第三方应用程序——现在它应该可以检测到 Shizuku 并接收服务绑定器。

您还可以安装直接安装的变体，它可以直接注册为moe.shizuku.privileged.api（不要将其与原版 Shizuku 一起安装）。

☑️ 系统要求

最低系统要求：Android 7+ · 完全支持至 Android 17 (SDK 37)

• Root模式：需要已root的设备

• 无线调试模式：Android 11+ 及所有 Android 电视

• PC ADB 模式：所有设备

• 启动选项：仅在无线调试模式或Root模式下可用

在Android 16+上，ShizukuX 会请求新的本地网络保护权限，以保持无线调试发现和配对功能正常工作；在Android 17上，它会透明地处理隐藏的 APIdeviceId更改，以便授权应用保持可见，权限授予功能继续有效。

更新日志

v13.7.0.r2002（正式版）

版本亮点：正式版 + 修复 r2001 资源错乱

本版本为ShizukuX最新正式版，基于v13.7.0.k2012稳定代码（含配套闪退修复与崩溃诊断导出）正式版，并修复了v13.7.0.r2001正式版资源错乱问题：甲醛r2001的APK误放为v13.7.0.k2010的构建结构，本版起正式版回归正确版本标识（versionName = ShizukuX） 13.7.0.r2002）。

流行闪退修复（k2012起，r2002沿用）

修复点击“仪表”→“启用”闪退（WRITE_SECURE_SETTINGS权限）

根本原因：enablePairingAssistant()直接写Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES，该操作要求WRITE_SECURE_SETTINGS权限；无root、且未通过adbpm grant授权的设备会抛出SecurityException，主线程未捕获→应用直接闪退

修复：启用前先检查权限，未取消则不再硬写，返回 false 并返回到支持服务引导对话框（内置完整分级引导，不会崩溃）；调用侧包层runCatching兜底，双保险

无线影响面：非root设备宽带流程全部恢复正常（root或已授权设备行为不变，仍可静默启用）

诊断添加添加 [崩溃日志] 崩溃堆栈

导出的诊断信息自动附带最近一次崩溃的完整堆栈（时间 + 线程 + 异常 + 完整调用链）

之后任何“点击XX就闪退”类问题，用户导出诊断即可直接看到崩溃原因，采集adb抓logcat

功能与改进

Shizuku客户端发现修复：按.shizuku提供商权威发现客户端，避免多版本共存时授权/派发错乱

外部中转（黑阈/Brevent）无障碍服务：增加电池优化白名单提示，避免自动网关助手后台被系统清理

场景判断修复：区分"Shizuku shell 不可用"与"Scene APK 未找到"两种状态，提示更准确

品牌统一：剩余加上衍生全部重命名为Extra（排除、设置页、清除服务、外壳等43处），消除残留旧品牌

国际化：dhizuku模块、bug报告剩余中文字符串翻译为中文；补充shell同意通知解除的英文文案

文档双语：README默认是英文并支持中文切换（zh-CN）

验证

标准版 + Drop-In 版 + Compat-Hub 三件套均重新构建（versionCode 2028，versionName = ShizukuX 13.7.0.r2002）

签名与其他版本一致（同证书，可正常覆盖升级）

非 root / Android 17 / HyperOS 实测：点击“体验”不再闪退

说明

本版本为正式版（r 导出），推荐所有用户升级

普通用户完全兼容原版 Shizuku 行为