我们发现了什么
!android-shizuku-skill — 在未 root 的 Android 手机上获得完整设备控制 (shizuku_skill.png) # android-shizuku-skill 面向 AI 智能体的安全测试与设备控制技能：通过 Shizuku 对未 root 的 Android 设备实现完全控制 —— 无需 root，无需 adb 主机。由 Simo 怀着乐趣打造 —— Telegram：syn74x_3rr (https://t.me/syn74x_3r
- 来源：GitHub（发现于 2026-10-12）
- 证据等级：D · 发现产品或需求信号，暂未获得可核验的商业证据。
- 商业模式：待核验
- 主题：独立产品
- 初筛评分：16.3/100 · 收录 1 次
证据，比故事更重要。
规则清洗与初筛，未经人工商业核验。原文语境、实际客户和付费情况仍需自行验证。
引用与数字披露
来源类型（原作者自述／第三方测算／媒体转引）需采集端标注，本版尚未落字段。
- 作者
- 未标注
- 抓取日期
- 来源类型
- 未标注
- 币种
- 未标注
- 口径
- 未标注
- 披露主体
- 未标注
- 披露日期
- 未标注
中文辅助译文（全文）
图注：android-shizuku-skill 项目示意图，主题为通过 Shizuku 在非 root 的 Android 设备上实现完全控制
android-shizuku-skill
一款面向 AI 智能体的安全测试与设备控制技能：通过 Shizuku 完全控制非 root 的 Android 设备 — 无需 root，无需 adb 主机。 一切在 Termux 中以 uid 2000 (shell) 身份在设备本地运行。
由 Simo 怀着乐趣制作 — Telegram：syn74x_3rr
本技能的作用
将 AI 智能体转变为非 root Android 设备的操作员。 它可以：
- 像真正的操作员一样驱动 UI — 读取无障碍树，然后以严格的 读取 → 操作 → 确认 循环进行点击/输入/滚动/切换/启动应用。 每一步都重新读取屏幕并以前台应用为门控，因此点击永远不会落到错误元素上，且切换会经过验证确实生效。
- 读取任何应用的崩溃与日志证据 — 崩溃
logcat缓冲区、附带原因码（ANR / 崩溃 / OOM / 信号 / 强制停止）的应用退出历史、dropbox、ANR 跟踪记录以及原生 tombstones。 - 通过真实的 shell 探测系统 — 进程与
/proc、包、权限与 appops、系统设置、网络状态、各应用内存与帧率统计。 - 修复已知的 Android 15 崩溃 — Shizuku 管理器的"开机启动（无线 ADB）"首选项会在每次调用时触发
ForegroundServiceStartNotAllowedException；一个脚本可通过官方 UI 以可逆方式将其关闭。 - 产出可验证的证据 — 每一步的截图与 UI 树快照，可直接用于报告。
⚡ 主要脚本
| 脚本 | 用途 |
|---|---|
scripts/rish | 通过 Shizuku 以系统 shell（uid 2000）身份运行命令 |
scripts/shizuku-doctor.sh | 只读的设备/Shizuku 健康报告 |
scripts/shizuku-disable-selfstart.sh | 修复 Android 15 管理器崩溃（关 / 开 / 状态） |
scripts/capture-crash.sh | 为任意包收集崩溃证据 |
scripts/screen-probe.sh | 截图 + UI 树证据快照 |
scripts/ui-dump.sh | 读取当前屏幕（XML / 文本 / JSON） |
scripts/ui-act.sh | 原始动作：点击、输入、按键、滑动、滚动、启动 |
scripts/ui-wait.sh | 等待直至文本 / 消失 / 包条件成立 |
scripts/ui-fast.sh | 安全步骤：全新转储 → 应用门控 → 解析 → 操作 → 验证 |
scripts/ui-shell.sh | 用于快速 读取→操作→确认 循环的持久会话 |
scripts/ui_parse.py · ui_resolve.py · ui_toggle.py · ui_wait_check.py | UI 树解析器与目标解析器 |
深度文档（架构、权限、日志与崩溃、UI 操作手册、故障排除）位于 references/。
要求与安装
- 非 root Android 设备，需运行 Shizuku（无线调试、adb 或 root），以及一个带有 Shizuku Shell 页面中
rish加载器的终端应用（加载器已随 Shizuku APK 一起提供 — 本项目无需打包）。 - 将该文件夹复制到智能体的技能目录（例如
~/.claude/skills/、.cursor/skills/、~/.config/<your-agent>/skills/），替换文档中的<SKILL_DIR>占位符，智能体即可使用。
设计上追求可移植：标准 SKILL.md 布局（名称 + 描述 frontmatter），仅使用 bash + Python，无特定智能体 SDK — 可与 Claude Code、VS Code、Cursor、Codex、Gemini CLI 以及任何其他支持 SKILL.md 的智能体一起工作。
安全与范围
- 默认只读；变更性操作（点击、设置、appops）仅在任务需要时执行。
- 切勿更改承载 shell 的应用自身的 appops/权限 — Android 会终止该应用的进程（即你的会话）。
- 切勿并行运行 shizuku 调用（有序广播，每次等待 5 秒）。
- 仅限授权使用 — 仅对你拥有或获得明确审计许可的设备和应用进行测试。
许可协议与作者
MIT — 参见 LICENSE。
译文由上游机器翻译生成，可能有误；判断请以英文原文为准。
英文原文（来源本站未改写）
android-shizuku-skill
A security-testing and device-control skill for AI agents: full control of a
non‑rooted Android device via Shizuku — no root, no adb host. Everything runs
on‑device from Termux as uid 2000 (shell).
Made with fun by Simo — Telegram: syn74x_3rr
What this skill does
Turns an AI agent into an operator for a non‑rooted Android device. It can:
- Drive the UI like a real operator — read the accessibility tree, then tap / type / scroll / toggle / launch apps with a strict read → act → confirm loop.
Every step re‑reads the screen and gates on the foreground app, so taps
never land on the wrong element and toggles are verified to actually flip.
- Read crash & log evidence for any app — crash logcat buffer, app exit
history with reason codes (ANR / crash / OOM / signal / force‑stop), dropbox,
ANR traces, and native tombstones.
- Probe the system from a real shell — processes & /proc, packages,
permissions & appops, system settings, network state, per‑app memory and frame
stats.
- Fix a known Android 15 crash — the Shizuku manager's "start on boot
(wireless ADB)" preference causes ForegroundServiceStartNotAllowedException
on every call;
one script turns it off, reversibly, via the official UI. - Produce verifiable evidence — screenshots + UI‑tree snapshots at each step, ready for reports.
⚡ Main scripts
| Script | Purpose |
|---|---|
scripts/rish | Run commands as the system shell (uid 2000) through Shizuku |
scripts/shizuku-doctor.sh | Read‑only device/Shizuku health report |
scripts/shizuku-disable-selfstart.sh | Fix the Android 15 manager crash (off / on / status) |
scripts/capture-crash.sh | Collect crash evidence for any package |
scripts/screen-probe.sh | Screenshot + UI tree evidence snapshot |
scripts/ui-dump.sh | Read the current screen (XML / text / JSON) |
scripts/ui-act.sh | Raw actions: tap, type, keys, swipe, scroll, launch |
scripts/ui-wait.sh | Wait until a text / gone / pkg condition holds |
scripts/ui-fast.sh | Safe step: fresh dump → app gate → resolve → act → verify |
scripts/ui-shell.sh | Persistent session for fast read→act→confirm loops |
scripts/ui_parse.py · ui_resolve.py · ui_toggle.py · ui_wait_check.py | UI‑tree parsers & target resolvers |
Deep docs (architecture, permissions, logs & crashes, UI playbook,
troubleshooting) live in references/.
Requirements & install
- Non‑rooted Android with Shizuku running (wireless debugging, adb, or root)
and a terminal app with the rish loader from the Shizuku Shell page
(the loader ships inside the Shizuku APK itself — nothing to bundle here).
- Copy the folder into your agent's skills directory (e.g.
~/.claude/skills/, .cursor/skills/, ~/.config/<your-agent>/skills/),
replace the <SKILL_DIR> placeholder in the docs, and the agent can use it.
Portable by design: standard SKILL.md layout (name + description frontmatter),
bash + Python only, no agent‑specific SDK — works with Claude Code, VS Code,
Cursor, Codex, Gemini CLI and any other SKILL.md‑capable agent.
Safety & scope
- Read‑only by default; mutating actions (taps, settings, appops) only when a task requires them. - Never change app‑ops/permissions of the app hosting your shell — Android kills that app's processes (i.e. your session). - Never run shizuku calls in parallel (ordered broadcast, 5 s wait each). - Authorized use only — test only devices and apps you own or are explicitly permitted to audit.
License & author
MIT — see LICENSE.
这条还缺什么证据？
下面每条都由本条已有字段推出（等级、理由、商业模式、来源次数、是否演示）， 本站不生成推测性结论；通用验证方法放在方法论页。
- 可核验的收入或付费证据查官网定价页与付费口径；第三方数据源（如 GetLatka）只作旁证，需标注来源与时点。
- 商业模式未定确认按席位／按用量／授权还是开源托管版收费；开源项目另查 LICENSE 与是否存在付费版。
- 只有单一来源找一手站点或其他渠道是否重复出现同一产品；社区热帖数量不等于商业进展。
通用验证清单（谁有这个问题／谁愿意付费／一个人能交付哪一小步）见我们的筛选方法。