Lamda

FIRERPA Android ｜ AI 驱动的自动化

一体化 Android 自动化框架，集成设备端服务、面向 AI 的 Agent 和可扩展的工具调用。

文档 | 使用文档 | TELEGRAM | QQ 群 | SKILLS | llms-full.txt | 中文版本

FIRERPA 是一个一体化 Android 设备控制平台。服务直接运行在设备上，无需额外的运行时依赖；它支持多个世代的 Android，并且支持 Root 和非 Root 模式。在 PC 端，Python 客户端库通过单一服务和 API 协调 UI 自动化、远程操作、流量捕获、基于 Hook 的逆向工程、网络代理、分布式网络、AI Agent 和 MCP。与拼凑 Appium、mitmproxy、frida-server、adb、uiautomator2 以及零散脚本和运维工具相比，FIRERPA 提供统一的能力来源、统一配置、互联工作流，以及专为多设备、长期运行和生产环境打造的技术栈。

远程桌面与实时串流

FIRERPA 提供基于浏览器的远程桌面：无需安装专用 PC 客户端，即可通过局域网或跨网络实时查看和控制设备。串流支持 MJPEG 和 H.264，并提供软件和硬件编码后端。帧率（最高 60fps）、分辨率缩放、比特率和画质均可根据设备性能和网络状况调整，从而减少带宽占用，并提升弱网环境下的流畅度。平台还支持 WebRTC，可配置 STUN/TURN 服务，以改善 NAT 穿透效果，并降低公网或跨区域部署中的端到端延迟。

远程桌面支持多用户并发访问，适用于协作调试、演示和培训。它还支持双向剪贴板共享和实时音频（Android 10+），并集成终端、拖放上传，以及基于浏览器的文件浏览和下载——所有功能均通过单个端口提供。内置的可视化布局检查可突出显示元素、支持 Tab 遍历、显示坐标和 RGB 值，并导出 XML 布局树，让你在同一 UI 中验证选择器和自动化逻辑，缩短从屏幕到脚本的迭代周期。

远程桌面和 RPC 支持端到端 TLS 和服务证书访问控制，并可选用自定义 WebUI 登录密码，降低在公网中的暴露风险。远程桌面功能还可通过 WebSocket 嵌入你自己的 Web 应用（实时视频、触控、终端、按键等），并支持使用 allow_origin 进行跨域集成，适合打造真实设备控制产品。

UI 自动化

FIRERPA 提供完整的基于选择器的自动化系统：文本、resourceId、description、可滚动状态及其他常见匹配器，还支持 子级 / 同级 链式选择，可用于重复元素、深层级结构或缺少显著属性的控件。在元素层面，支持截图、等待元素出现 / 消失、获取角点 / 中心坐标、检查元素是否存在、输入 Unicode、分步滑动、快速滚动、滚动到底部等功能。在 Android 8.0+ 上，它可以 与其他无障碍服务共存，并改进混合应用的 WebView 节点发现。

UI Watcher 可实时监听 UI 变化，并在条件匹配时执行点击、按键事件或计数操作，适用于自动关闭协议、更新提示、广告及其他干扰。支持多个选择器条件，以及按事件启用 / 禁用；还可以统计瞬时屏幕出现的次数。

Virtual Display 是一项差异化功能：在设备上创建隔离的后台显示屏，并在其中运行应用和自动化，不会影响主屏幕——例如，你正常使用手机时，可在虚拟显示屏上自动回复。虚拟显示屏 API 与主设备 API 保持一致（d.xxx → vd.xxx）；Watcher 可指定作用于某个虚拟显示屏。WebUI 支持远程桌面中的 多显示屏查看与切换，非常适合后台任务、并行工作，以及人工参与和机器自动化相结合的场景。

对于没有标准视图树的场景（游戏、自绘 UI），FIRERPA 提供 OCR 和 图像匹配。OCR 支持 paddleocr、easyocr 和自定义 HTTP 后端；在集群中，识别可集中运行，无需在每台 PC 上加载模型，并支持 GPU 加速和灵活的文本匹配。图像匹配在 设备上运行（模板或 SIFT），不占用 PC 资源；SIFT 能适应旋转、缩放和光照变化。Multi-touch 支持录制、回放、程序化构建和二进制持久化，可处理复杂手势和压力。

在架构上，FIRERPA 采用客户端 / 服务端模型；相比 AutoJS 等设备端脚本运行器，它更适合 集中式调度、版本管理和设备集群控制；比 Appium 更轻量；在多设备场景下 比 uiautomator2 更稳定。文档将其定位为常见 Android 自动化技术栈的 功能超集——无需切换工具，即可在一个平台上通过代码串联自动化、采集、Hook 和运维。

数据包捕获与 MITM

FIRERPA 提供 一键 MITM 捕获：自动安装系统根 CA、配置代理、处理 Android 版本差异，并在退出时自动恢复网络——无需手动切换证书或代理。支持全局捕获、按包捕获、实时编辑请求 / 响应、共享 mitmweb，以及用于 国际流量 的上游 HTTP 代理。内置的 QUIC 降级可减少 QUIC 干扰。即使 PC 和设备之间只共享一个 FIRERPA 端口（例如 ADB connect 或 frp 转发），仍可进行捕获。

除了单击运行脚本，MITM 还完全支持 API 驱动：安装 / 卸载与 mitmproxy、Fiddler、Charles 等兼容的系统 CA；将捕获功能嵌入自动化流水线，与 UI 步骤和 Frida Hook 一同运行。提供 Windows 版 startmitm.exe，无需安装 Python。

网络、代理与连接

在设备端，FIRERPA 提供全面的代理支持：HTTP / HTTPS / SOCKS5 / Shadowsocks（多种加密算法）、按应用设置代理（包括多用户克隆）、DNS 代理、UDP 代理、绕过局域网代理、与 OpenVPN 共存，以及在启动时自动连接到已配置的代理。代理支持 IPv6 和 UDP，适用于复杂网络。

**设备 HTTP 桥接代理（tunnel2）**提供反向代理能力：将 PC 或浏览器的 HTTP 代理指向手机，流量即可通过手机的网络出口转发；出口 IP 与手机相同。可选择 Wi‑Fi 或蜂窝网络（rmnet）作为出口接口，适用于联合调试、国际应用和多设备 IP 池。

内置的 OpenVPN 客户端支持证书、用户名/密码和混合身份验证，并可与系统代理并用；OpenVPN Docker 镜像和配置生成器可生成设备端代码及自动启动设置。内置的 frp 客户端通过 fwd.* 将设备服务转发到公共服务端，并支持加密和 TLS。

mDNS 发现支持通过 {device_id}.local 访问远程桌面和其他服务，还可选用 TXT 元数据（型号、ABI、设备 ID）来发现局域网设备群。

Frida 与逆向工程

FIRERPA 捆绑最新版本的 Frida，无需单独运行 frida-server。可直接在远程桌面终端中使用 Frida 工具，无需 -U、-H 等参数。内置隐藏补丁（开源及自研）会持续更新，以应对检测；连接通过 FIRERPA 端口进行令牌身份验证。objection 补丁和 Frida 17.x java-bridge 辅助工具可简化迁移。

持久化 Frida 脚本会在应用崩溃或退出后重新注入；支持通过目录监视和热重载实现 YAML 离线持久化。Frida RPC 可映射为 Python 方法，并支持通过 HTTP + JSON-RPC 2.0 在 JVM、UI 主线程或纯 JS 线程上进行远程调用。脚本 emit 数据可发送到 HTTP / Redis / RabbitMQ (MQTT)，并支持设备/应用元数据、zlib 压缩、HTTP 重试和 MQTT TLS。

ADB、SSH 与内置终端

FIRERPA 内置独立的 ADB——无需启用系统开发者选项即可使用无线高权限 ADB，适用于应用会检测开发者模式的场景。Magisk 模块可预装 adb_keys，以便默认授权。内置 SSH，并提供 ssh.sh / scp.sh，用于远程 Shell 和文件传输。

内置终端包含 strace、ltrace、tcpdump、scapy、fsmon、frida-tools、MemDumper，以及 Crypto、cv2、unicorn、capstone、keystone、redis 和 grpc 等 Python 库。sqlite3 支持 wxsqlite / sqlcipher / sqlcrypto，可读取微信、企业微信和阿里系客户端等应用中的加密数据库。在远程桌面、SSH 和 ADB 中使用同一环境，减少往返 PC 的操作，即可分析和控制设备。

分布式与多设备管理

**FIRERPA StarLink Platform（Hub + hub-bridge）**为本地和远程设备提供集中式多设备访问，支持统一管理和 P2P 访问，非常适合“设备在家，操作人员在别处”的场景及多设备协作。hub v3 使用 SAPI 统一向本地和远程设备发送请求。除了 Hub，还支持 frp 转发和 OpenVPN 网状网络等可自托管方案，并提供完整文档和 Docker 支持。

自 9.0 起，支持 P2P Bridge 对等连接和内置分布式任务系统；自 7.50 起，提供网络订阅服务，因此无需自托管 frp/OpenVPN。专为云手机池、设备农场和模拟器集群设计，支持批量设备、持续在线、无人值守运行。

AI / MCP / Agent

FIRERPA 内置一个基于 streamable-http 的 MCP 服务（/mcp/），支持工具调用、资源读取、提示词、进度通知和日志，兼容 Claude、Cursor 及其他 MCP 客户端。官方 MCP 扩展位于 ~/modules/extension 下。

内置的 agent 命令可通过任意兼容 OpenAI 且支持工具调用的 API，以自然语言操控设备，还支持视觉模式和 OpenAI 语义任务执行器。与 crontab 结合，即可在真实设备上执行定时 AI 任务。

系统控制与扩展

160 多个 Python API 覆盖应用操作、文件 I/O、命令执行、设备状态、WiFi、代理、OpenVPN、关机和重启、服务日志等。setprop 可写入 ro.* 只读属性；Settings API 可调整亮度、开发者模式等；支持创建 SELinux 域、设置宽容模式，以及精细控制允许或禁止的操作。提供完整的多实例应用 API、静默授予或撤销权限、启动未导出的 Activity，以及禁用应用以节省资源。

支持二进制补丁（十六进制通配符、glob 路径、试运行），并提供磁盘、电池、CPU、内存和网络 I/O 的运行时指标。支持 WAV 播放和内部存储 API。设备端 tflite-runtime 支持硬件加速计算，可用于边缘推理。

虚拟 Debian 环境可运行完整的 Debian 和 apt，可用于编译 BPF、部署 OpenSSH，以及安装超出内置终端能力范围的任意 Python 依赖。

部署、安全与治理

支持通过一键式 APP（root 或 Shizuku）、Magisk 模块自启动、手动解压或 ROM 集成部署，专为 24/7 运行设计。APP 可自动生成服务证书；Magisk zip 可包含属性、lamda.pem 和 adb_keys。INI 服务配置集中管理端口、WebUI、证书、OpenVPN、gproxy、frp、tunnel2、cron、sshd、adb、mdns 等；WebUI 提供可视化编辑、原始文本编辑和 Reload Service，并支持远程加载配置文件。

支持 root 和 shell 身份；arm64、armeabi-v7a、x86、x86_64；真实设备、模拟器（LDPlayer、Nox 等）、Redroid、WSA、AVD 和云手机。提供干净的卸载方式。API 独占锁可避免客户端争用。隐私政策：不收集联系人、SMS、位置等信息；支持离线授权。

工具与演进

持续开发六年多，不断修复 Android 14–16 兼容性问题，并持续开发多用户远程桌面、标准化触控 API、MCP、Frida 版本与隐身能力、代理 IPv6/UDP、P2P Bridge 和分布式任务。

FIRERPA 的优势并非某一项功能，而是在一台 Android 设备、一个服务和一个 Python 客户端上，集成远程桌面（WebRTC/H.264/多用户）、UI 自动化（虚拟显示、Watcher、OCR、图像匹配、多点触控）、一键抓取、内置 Frida、全栈代理与 VPN/frp/P2P、ADB/SSH/内置终端、AI MCP/Agent、系统级控制、虚拟 Debian、持久化 KV 和脚本加密，让安全测试、合规分析、协议恢复、设备群管理和自动化在一个工作流中运行，而不必将多个工具拼凑在一起。