## Why follow Mira
Mira 把真实运行时案例整理成可复用的工作流、工具和检测笔记。
## Research Updates
- [260520] 文章：[Audit logcat 侧信道检测 root、模拟器、scrcpy 类投屏](./knowledge/articles/zh/audit-logcat-sidechannel-detect-root-emulator-projection.md)
- [260520] 案例：[Android 高 PID shell proc audit 侧信道提示 scrcpy 投屏](./knowledge/cases/zh/2026/2026-05-20-android-high-pid-shell-audit-sidechannel-scrcpy.md)
- [260520] 案例：[Android 模拟器 proc audit 侧信道暴露 qemu SELinux 上下文](./knowledge/cases/zh/2026/2026-05-20-android-emulator-proc-audit-sidechannel.md)
- [260519] 案例：[Android proc audit 侧信道检测 Magisk SELinux 上下文](./knowledge/cases/zh/2026/2026-05-19-android-proc-audit-magisk-sidechannel.md)
## Features
- **App 沙箱工具**：在 Android 和 iOS 的 Mira 宿主 App 沙箱中使用 shell、PTY、截图和文件工具。
- **Frida 任务**：通过 RPC 运行 Java 与 native hook，完成一次性运行时分析。
- **Relay 与 MCP**：设备通过 Relay 接入，AI 再通过 MCP 操作同一会话。
## Getting Started
- **Relay**：`PYTHONPATH=. python3 -m mira.relay.server --host 0.0.0.0 --port 8765 --advertise-url http://<你的局域网IP>:8765`
- **浏览器**：在电脑打开 `http://127.0.0.1:8765`
- **Android**：[下载最新 APK](https://github.com/vwww-droid/Mira/releases/latest/download/mira-app-debug.apk)，安装后在 App 中填写 `http://<你的局域网IP>:8765`
- **iOS**：当前验证的是 iOS 16.7.10 真机。详见 [`docs/GETTING-STARTED.zh-CN.md`](./docs/GETTING-STARTED.zh-CN.md)
- **AI 接入**：`PYTHONPATH=. python3 -m mira.mcp.server --relay http://127.0.0.1:8765`。MCP 配置见 [`docs/MCP.zh-CN.md`](./docs/MCP.zh-CN.md)
APK 的离线 Python/Frida 运行时需要 arm64-v8a，支持 Android 10 到 15。Android 16 暂不支持 Java hook，相关问题尚无已确认的 Frida 官方修复。详见[兼容性记录](./docs/notes/android-frida-gadget-compatibility-2026-09-05.md)。
## Contributing
Mira 欢迎移动安全研究员，逆向工程师，Frida 用户，MCP 用户和真机测试者提交 issue 与 pull request。
- 提交聚焦的 pull request 前，请先阅读 [`CONTRIBUTING.md`](./CONTRIBUTING.md)。
- 提 bug、安全加固、检测思路或设备兼容性反馈时，优先使用 issue templates。
- 提交安全报告前，请先阅读 [`SECURITY.md`](./SECURITY.md)。
- scanner 自动生成的安全加固 PR 也欢迎，但需要说明在 Mira 仓库中的真实可达路径和验证结果。
适合作为起点的方向包括 native 内存安全审查，Android 与 iOS 真机测试，Frida 工作流示例，MCP 客户端接入说明，以及新的可复用检测案例。
## Live Discovery Examples
# Mira
面向 Android 与 iOS 的移动端运行时检测工作台。
