🐱 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 会弹出授权框 —— 点同意，权限到手；点拒绝，礼貌再见。每一张「通行证」都记在小本本上，随时可以在设置里收回。

🔌 生态兼容

底层就是 Shizuku 的 API

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

官方生态应用直连

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

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

Dhizuku 兼容：她是自己的设备所有者

• 被设为 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 签名（仅自用够；发布版必须使用项目签名，否则用户无法覆盖升级）

Tasker / MacroDroid 广播指令

🗂️ 源码结构

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

❓ FAQ

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：因为作者把她当女儿养（确信）。

💗 感谢

• 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

激活可靠性大修 + 全面性能优化，强烈建议所有用户升级。

✨ 新功能

• 每次打开 App 自动检查更新，发现新版本就地弹出可下载的对话框（不再只依赖通知栏）
• 更新检查自动挑选可用源：GitHub API 被网络拦截时自动切换镜像，国内网络同样能收到更新

🔧 修复与优化

• 激活：
  • 修复「电脑 ADB」激活必失败（启动命令缺少 APK 路径参数）
  • 修复 Dhizuku 一键激活必失败（命令带了电脑端前缀，却在设备上执行）
  • 修复看门狗 / 开机自启 / 快捷磁贴重启服务时用错启动方式
  • 修复无线调试配对可能永久卡在「配对中」（补连接与读取超时）
  • 修复服务端一处空指针：同一进程二次连接时应用会永久收不到服务，且界面看不出异常
  • 修复共享 uid 下只有第一个包能收到服务的漏推问题
• 首次引导：修复 Android 7.x 闪退、Android 11/12 点激活无反应、倒计时被转屏重置等 17 处问题
• 更新检查：改为按版本号逐段比较，只认「确实更新」，避免把旧版本当作新版本推送
• 问题反馈：修复 #5（Dhizuku 缺少开关）、#6（深色模式黑字）、#7（模块搜索不到）
• 性能与耗电：
  • 启用 Baseline Profile：冷启动实测提升约 15% ~ 20%
  • 后台保活轮询 12 秒 → 45 秒，去掉无用的周期性唤醒，明显降低耗电与闪存写入
  • 应用列表图标改为真正命中缓存（此前每次新建项都走主线程加载）
  • 界面噪点纹理全应用共用，窗口底图内存减半

🌍 English

Activation reliability overhaul + broad performance work — strongly recommended for all users.

• New: check for updates on every app launch, with an in-app download dialog; automatic mirror fallback when the GitHub API is blocked by your network
• Fixed: "Computer ADB" and one-tap Dhizuku activation never worked; watchdog / boot / quick-tile restarting the service with the wrong launch method; wireless pairing could hang forever; a server-side NPE that left an app permanently without the service; shared-UID binder push skipping all but the first package
• Fixed 17 issues in the first-run setup wizard (Android 7.x crash, no-op activation on Android 11/12, countdown reset on rotation)
• Update check now compares version numbers instead of string inequality (no more downgrade prompts)
• Fixed issues #5 / #6 / #7
• Performance: Baseline Profile enabled (~15–20% faster cold start), background keep-alive polling 12s → 45s, real icon-cache hits, shared noise texture, half the background bitmap memory

安装说明：下载下方 shizako-vzako3.12-release.apk 直接覆盖安装即可（与旧版签名一致，可直接升级，不需要卸载）。 如果你之前用的是 zako3.02 或更早版本，本次更新包含大量激活链路修复，升级后无需重新激活。