cr1437/Shizako

🐱 Shizako

让猫耳看板娘替你「借」系统权限 —— 不 Root、不刷机

Your catgirl assistant for privileged Android APIs — no root, no drama.

简体中文 | English

兼容 Shizuku-API 生态 · 作者 初然

🌐 官网 · 📦 下载最新版 · 🐛 反馈问题 · ⭐ Star 支持她

「你好呀，我是 Shizako 酱 (ฅ'ω'ฅ)

手机里明明躺着那么多『系统限定』的好东西 —— 静默安装、冻结应用、调权限、读系统设置 —— 平时却只有系统自己碰得到，是不是很气？Root 当然能拿到钥匙，但代价嘛……变砖警告、保修飞走、 银行 App 翻脸不认人，懂的都懂。

所以我走了另一条路：先替你跑一个特权小进程（无线调试 / USB / Root 随便哪种姿势唤醒我）， 然后把这个特权借给你信得过的应用。注意是『借』不是『送』—— 每个应用都要你亲自点头 才发通行证，想收回随时收。」

去 Releases 下载最新版 APK，安装。

激活流程与上游 Shizuku 一致，可参考上游配置指南，把 Shizuku 换成 Shizako 即可。

打开想授权的应用，Shizako 会弹出授权框 —— 点同意，权限到手；点拒绝，礼貌再见。每一张「通行证」都记在小本本上，随时可以在设置里收回。

api/ 目录装着 Shizuku-API 的完整源码（MIT License）。通信协议、接口、调用方式与上游同一套 —— 具体改动见 api/SHIZAKO-CHANGES.md。

改了名字，没改脾气。用官方 dev.rikka.shizuku:api 写的应用（MT 管理器、冰箱、SystemUI Tuner 等）不用改代码、不用重编译，装好就连：

服务端只校验「是否请求了权限」，不校验「请求了哪个权限名」；首次连接照样弹授权框，你点头才算数。

• 被设为 Device Owner 后，Dhizuku-API 应用把 Shizako 当 Dhizuku 用，不用改代码
• 特权转发全部发生在 Shizako 进程内，系统看到调用者是 Shizako 自己 —— 没给第三方开系统 binder 后门
• 每个 Dhizuku-API 应用首次借用都会弹授权框，同意后记入本地白名单，可在「Dhizuku 授权的应用」页面收回
• 兼容层为独立编写（wire 协议对齐 Dhizuku-API），不依赖 GPL 许可的 Dhizuku-API 库，Shizako 保持 Apache-2.0

Shizako 内置兼容桥占用了官方 provider authority moe.shizuku.privileged.api.shizuku，因此不能与官方 Shizuku 同时安装（Android 会报 provider 冲突）。二选一即可。

Shizako 酱：白发猫耳、月牙发饰，人设是「抱着终端机的猫娘系统助手」。项目图标、应用内文案、宣传物料都围绕她展开。

官方认证：欢迎拿她当表情包用 (ˊᗜˋ*)，只要别拿去干坏事。

官方 dev.rikka.shizuku:api 已能直连两个管理器，啥都不用改。完整用法见 docs/API.md：依赖配置、权限申请、binder 生命周期、AIDL 用户服务全流程示例。

把 api/ 目录搬进项目：

// settings.gradle
include ':aidl', ':shared', ':api', ':provider'
project(':aidl').projectDir = file('api/aidl')
project(':shared').projectDir = file('api/shared')
project(':api').projectDir = file('api/api')
project(':provider').projectDir = file('api/provider')

// app/build.gradle
implementation project(':api')
implementation project(':provider')

代码写法与官方 API 完全一致：Shizuku.bindUserService(...)、Shizuku.requestPermission(...) 照旧。

git clone https://github.com/cr1437/Shizako.git
cd Shizako
./gradlew :manager:assembleRelease

• 国内网络已配好阿里云 Maven 镜像，无需额外代理
• 产物在 manager/build/outputs/apk/release/
• 未提供 signing.properties 时会自动回退到 debug 签名（仅自用够；发布版必须使用项目签名，否则用户无法覆盖升级）

Shizako/
├── manager/    Android 应用本体（Kotlin）
├── server/     特权服务进程（Java，跑在 shell / root 里）
├── starter/    服务启动器
├── shell/      预编译的 shell 工具
├── stub/       兼容占位包（moe.shizuku.privileged.api）
├── common/     共享模块
├── api/        Shizuku-API 客户端库源码（MIT）
└── docs/       文档与物料

Q：要 Root 吗？ A：不要。无线调试 / USB 就能激活；有 Root 也行，姿势更多，但绝非必需。

Q：跟 Shizuku 什么关系？ A：它兼容 Shizuku-API 生态 —— 用官方 SDK 写的应用零改动直连。按上游许可要求，本项目使用自己的包名与权限名，因此不能与官方 Shizuku 共存；在此之上还加了 Dhizuku 兼容、一键注入等自家功能。

Q：能不能和官方 Shizuku 一起装？ A：不能，兼容桥会撞 provider。二选一。

Q：授权给应用安全吗？ A：每个应用都要你亲自点头才拿得到通行证，白名单本地记录、随时可收回；Dhizuku 特权转发也只在 Shizako 进程内完成。

Q：支持哪些 Android 版本？ A：Android 7.0+ 都能跑；无线调试激活需要 Android 11+。

Q：配对时一直停在「正在搜索配对服务」，端口填不了？ A：自动发现配对端口靠 mDNS 组播。GrapheneOS 开启 VPN 时组播不会送进应用，华为 / 鸿蒙部分机型同样会拦截 —— 这类设备上自动发现必然失败。zako3.14 起配对对话框的端口框始终可见可手输：从设备「开发者选项 → 无线调试 → 使用配对码配对设备」页面上读出配对端口填进去，配对码一起输入即可。如果设备上 adbd 已经监听在固定端口（比如 5555），也可以直接用激活页的「手动连接端口」，跳过配对。

Q：为什么这么可爱？ A：因为作者把她当女儿养（确信）。

• RikkaApps/Shizuku 及其贡献者 —— Shizako 的核心能力来自这里
• RikkaApps/Shizuku-API —— 客户端通信库
• 每一个给 Shizako 酱点 Star 的你

本项目继承上游 Apache License 2.0，另见 NOTICE。

• 原项目版权归 RikkaApps 所有；Shizako 的修改部分版权归 初然 所有
• 未使用上游 Shizuku 名称、moe.shizuku.privileged.api 包名、moe.shizuku.manager.permission.* 权限及上游图标
• api/ 目录遵循其自身的 MIT License