cr1437/Shizako
cr1437/Shizako has 122 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours, +15 in 7 days, and +28 in 15 days. Last checked 2026-11-17 02:27 UTC. Last push 2026-11-15.
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- +15
- in 15 days
- +28
- in 1 month
- Recopilando historial
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
Asistente de permisos del sistema para Android con una mascota de chica gato. Permite usar API privilegiadas sin root. Es compatible con el ecosistema Shizuku-API: las aplicaciones creadas con el SDK oficial se conectan directamente sin modificaciones. Apache-2.0
ProductividadREADME.md
Original
🐱 Shizako
让猫耳看板娘替你「借」系统权限 —— 不 Root、不刷机
Your catgirl assistant for privileged Android APIs — no root, no drama.
简体中文 | English
兼容 Shizuku-API 生态 · 作者 初然
「你好呀,我是 Shizako 酱
(ฅ'ω'ฅ)手机里明明躺着那么多『系统限定』的好东西 —— 静默安装、冻结应用、调权限、读系统设置 —— 平时却只有系统自己碰得到,是不是很气?Root 当然能拿到钥匙,但代价嘛……变砖警告、保修飞走、 银行 App 翻脸不认人,懂的都懂。
所以我走了另一条路:先替你跑一个特权小进程(无线调试 / USB / Root 随便哪种姿势唤醒我), 然后把这个特权借给你信得过的应用。注意是『借』不是『送』—— 每个应用都要你亲自点头 才发通行证,想收回随时收。」
🐾 她能做到的事
| 特性 | 说明 |
|---|---|
| 免 Root 特权 | 通过 ADB / 无线调试获得近似 Root 的能力 —— 不拆机、不刷机、不心惊胆战 |
| 通行证制度 | 每个应用第一次连接都要你亲自授权,随时反悔、随时收回 |
| 官方生态直连 | 用官方 Shizuku-API 写的应用一行代码不用改就能连上她 |
| Dhizuku 模式 | 一键把她扶上「设备所有者」,特权常驻、免 Root 免无线调试;Dhizuku-API 应用(Hail、冰箱等)直接借用 |
| 新手引导 | 首次启动逐步向导:语言 / 外观 / 启动方式,引导内直接完成激活;免责声明 10 秒强制阅读 |
| 四种激活方式 | Root / 无线调试 / 电脑 ADB / Dhizuku,一页搞定;已配对可一键启动 |
| 一键注入 | 把权限分给常用工具(黑阈、小黑屋、冰箱、炼妖壶),没装的应用内直接下载 |
| 兼容桥 | 内置 provider 中转,Shizuku-API 客户端零改动直连;只用自己的 authority,不占用上游任何标识 |
| Tasker 支持 | 广播一键启停服务、激活 Dhizuku、查状态、触发下载 |
| API 审计 | 完整记录哪个应用调用了哪个特权 API,设置里随时查 |
| 自动更新 | 每次打开应用自动检查新版本,发现更新就地弹出可下载的对话框;网络拦截 GitHub 时自动切换可用源 |
| 崩溃日志 | 崩溃自动落盘 Download/Shizako-crash-*.txt |
🚀 把她带回家
第一步:领养
去 Releases 下载最新版 APK,安装。
第二步:选一种姿势唤醒她
| 激活方式 | 要求 | 适用人群 |
|---|---|---|
| 无线调试 | Android 11+,开无线调试后扫码 / 配对即可 | 懒得插线的你 |
| 电脑 ADB | 电脑跑一次应用内给出的 adb 命令,无版本限制 |
手边有电脑的你 |
| Root | 已有 Root 环境直接唤醒 | 有 Root 的极致玩家 |
| Dhizuku(设备所有者) | 电脑执行一次 adb shell dpm set-device-owner com.churan.shizako/.dhizuku.DhizukuAdminReceiver(设备上不能有账户),之后免 Root、免无线调试 |
一劳永逸党 |
激活流程与上游 Shizuku 一致,可参考上游配置指南,把 Shizuku 换成 Shizako 即可。
第三步:发通行证
打开想授权的应用,Shizako 会弹出授权框 —— 点同意,权限到手;点拒绝,礼貌再见。每一张「通行证」都记在小本本上,随时可以在设置里收回。
🔌 生态兼容
底层就是 Shizuku 的 API
api/ 目录装着 Shizuku-API 的完整源码(MIT License)。通信协议、接口、调用方式与上游同一套 —— 具体改动见 api/SHIZAKO-CHANGES.md。
官方生态应用直连
改了名字,没改脾气。用官方 dev.rikka.shizuku:api 写的应用(MT 管理器、冰箱、SystemUI Tuner 等)不用改代码、不用重编译,装好就连:
| 什么应用 | 连官方 Shizuku | 连 Shizako |
|---|---|---|
官方 dev.rikka.shizuku:api 写的 |
✅ | ✅ |
用本仓库 api/ 写的 |
✅ | ✅ |
服务端只校验「是否请求了权限」,不校验「请求了哪个权限名」;首次连接照样弹授权框,你点头才算数。
Dhizuku 兼容:她是自己的设备所有者
- 被设为 Device Owner 后,Dhizuku-API 应用把 Shizako 当 Dhizuku 用,不用改代码
- 特权转发全部发生在 Shizako 进程内,系统看到调用者是 Shizako 自己 —— 没给第三方开系统 binder 后门
- 每个 Dhizuku-API 应用首次借用都会弹授权框,同意后记入本地白名单,可在「Dhizuku 授权的应用」页面收回
- 兼容层为独立编写(wire 协议对齐 Dhizuku-API),不依赖 GPL 许可的 Dhizuku-API 库,Shizako 保持 Apache-2.0
🔏 与官方 Shizuku 共存,以及「怎么确认你装的是官方构建」
Shizako 用自己的包名(com.churan.shizako)和权限名,provider 只声明自己的 authority
com.churan.shizako.shizuku,不使用上游的 moe.shizuku.privileged.api 包名、Shizuku 应用名、
moe.shizuku.manager.permission.* 权限、上游 provider authority 或上游图标。
因此它可以与官方 Shizuku 同时安装,两者互不干扰 —— 哪个在跑,就用哪个。
(历史上 GitHub 版曾用一个占用上游包名的「兼容占位包」来讨好把老包名写死的客户端,该方案已彻底移除:
它逐字违反上游 Apache-2.0 §6 的附加条款,且从外部看与一份「重打包改名的仿冒品」无法区分。)
官方构建的签名指纹
所有官方构建都使用同一个发布证书签名:
| 项 | 值 |
|---|---|
| 证书主体 | CN=Shizako, OU=Churan, O=Churan, L=Beijing, ST=Beijing, C=CN |
| 证书 SHA-256 | 515BAF0C727F2AFBABA8A22379A05F8F2CC98682E5BEB24FB166565ACC9F9C8A |
校验方式(二选一):
- 电脑上对该 APK 执行
apksigner verify --print-certs shizako-*.apk,比对上面这一行。 - 手机上的应用内「设置 → 关于」会显示当前这份安装包自己的签名指纹,与上表对照即可。 如果指纹对不上,App 启动时也会弹警告并引导打开官方发布页核对(只警告、不阻断;F-Droid 版不弹)。
指纹对不上 = 这份 APK 被人重新打包并换过签名,不要安装、不要授权。 F-Droid 版由 F-Droid 用自己的密钥重新签名,指纹与上表不同,属正常;请以 F-Droid 页面标注为准。
「第一次配对端口」之类的使用问题见下方 FAQ;本节只讲这份文件本身是不是官方的。
🎨 看板娘一角
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
| 依赖 | 版本 |
|---|---|
| JDK | 21(根 build.gradle 是 VERSION_21、manager 是 jvmTarget = "21";仓库未声明 toolchain,直接用 JAVA_HOME,17 编译不过) |
| Android SDK | compileSdk 36 |
| NDK | 29.0.14206865 |
- 国内网络已配好阿里云 Maven 镜像,无需额外代理
- 产物在
manager/build/outputs/apk/release/ - 未提供
signing.properties时会自动回退到 debug 签名(仅自用够;发布版必须使用项目签名,否则用户无法覆盖升级)
Tasker / MacroDroid 广播指令
| Action | 作用 |
|---|---|
com.churan.shizako.action.START |
按上次启动方式启动服务 |
com.churan.shizako.action.STOP |
停止服务 |
com.churan.shizako.action.START_ROOT |
Root 启动 |
com.churan.shizako.action.START_ADB |
无线调试启动 |
com.churan.shizako.action.ACTIVATE_DHIZUKU |
一键激活设备所有者模式(需 Shizuku 模式运行中) |
com.churan.shizako.action.QUERY_STATUS |
查询状态(有序广播返回 running、dhizuku) |
com.churan.shizako.action.DOWNLOAD_UPDATE |
用内部下载器拉取 url extra 指向的 APK |
com.churan.shizako.action.NOTIFY_INSTALL |
发可点击通知:点一下安装 Download 里最新的 APK |
🗂️ 源码结构
共 10 个 Gradle 模块(以 settings.gradle 为准):
Shizako/
├── manager/ Android 应用本体(Kotlin,约 3.2 万行,占全仓 ~82%)
├── server/ 特权服务进程(Java,跑在 shell / root 里)
├── starter/ 服务启动器(启动 server 进程)
├── shell/ 构建 rish_shizuku.dex(`ShizukuShellLoader`),供 manager 打包进 APK
├── common/ 共享工具(BuildUtils / OsUtils)
├── api/ 内置的 Shizuku-API(MIT)—— 下含 6 个子模块:
│ ├── aidl/ AIDL 接口定义
│ ├── shared/ 客户端与服务端共用的常量
│ ├── api/ 客户端库(rikka.shizuku.Shizuku)
│ ├── provider/ 客户端侧 ShizukuProvider
│ ├── server-shared/ 服务端共用基类
│ └── rish/ rish 命令行工具的 native 部分
├── hidden-api-stub/ hidden API 编译期桩
└── docs/ 文档与物料(官网由 tools/md2html.py 从这里生成)
api/内的 6 个模块在settings.gradle里被改写 projectDir 指向api/<name>, 所以顶层看不到它们的目录名。
❓ FAQ
Q:要 Root 吗? A:不要。无线调试 / USB 就能激活;有 Root 也行,姿势更多,但绝非必需。
Q:跟 Shizuku 什么关系? A:它兼容 Shizuku-API 生态 —— 用官方 SDK 写的应用零改动直连。按上游许可要求,本项目使用自己的包名与权限名、不占用上游任何 authority,因此可以和官方 Shizuku 装在同一台机器上;在此之上还加了 Dhizuku 兼容、一键注入等自家功能。
Q:能不能和官方 Shizuku 一起装? A:可以。Shizako 的 provider 只声明自己的 authority,不会和官方 Shizuku 撞。两个都装、各自授权即可。
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 的你
📬 反馈
| 方式 | 入口 |
|---|---|
| GitHub Issues | Issues |
| QQ 反馈 | 891276089 |
| QQ 吹水群 | 1104445003 |
📄 许可
本项目继承上游 Apache License 2.0,另见 NOTICE。
- 原项目版权归 RikkaApps 所有;Shizako 的修改部分版权归 初然 所有
- 未使用上游
Shizuku名称、moe.shizuku.privileged.api包名、moe.shizuku.manager.permission.*权限、上游 provider authority 及上游图标 api/目录遵循其自身的 MIT License
名称与物料(品牌)
沿用上游在 Apache-2.0 §6 下的附加条款形式,本项目同样声明:
- 禁止以
Shizako(含Shizako+、Shizako Plus、Shizako Pro等任何易混淆变体)作为 第三方应用的名称,或用作其包名 / application id / 权限名的组成部分; - 禁止使用本项目的看板娘立绘、应用图标(
manager/src/main/res/mipmap*/ic_launcher*.png等全部物料)用于展示 Shizako 之外的任何东西; - 禁止以
com.churan.shizako为 application id 分发任何非官方构建。
换句话说:代码可以(也欢迎)fork,名字、图标、包名要换掉。 这样既符合 Apache-2.0,也让用户一眼能分辨官方构建 —— 这正是防仿冒最有效的一环。
⭐ 喜欢 Shizako 酱?点个 Star 再走吧 —— 每一颗星都是她的猫粮
(ฅ'ω'ฅ)