README

FIRERPA Android ｜ AI-Powered Automation










一个集下一代技术于一体的全能型 Android 自动化框架，融合了强大的端侧服务、AI 就绪型智能体以及可扩展的工具调用能力。

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

FIRERPA 是面向 Android 的一体化设备控制平台。服务端直接在设备上运行，无需额外运行时依赖；适配多代 Android 系统，无论是否 Root 均可使用。PC 端通过 Python 客户端库统一调度，将 UI 自动化、远程运维、流量截获、Hook 逆向、网络代理、分布式组网、AI Agent / MCP 等能力收敛到同一套服务与 API 中。相比把 Appium、mitmproxy、frida-server、adb、uiautomator2 等自研脚本和各类运维工具拼凑使用，FIRERPA 的优势在于：能力同源、配置统一、链路打通、适合多设备长期运行与工程化管理。

 远程桌面与实时投屏

FIRERPA 提供基于浏览器的远程桌面，无需在 PC 安装专用客户端即可实时查看和操作设备屏幕，支持局域网与跨网络访问。投屏链路同时支持 MJPEG 与 H.264 编码，并提供软编/硬编双后端，可按设备算力与网络状况调节帧率（最高 60fps）、分辨率缩放、码率与画质，在弱网环境下显著降低带宽占用、提升流畅度。进一步支持 WebRTC 传输，并可配置 STUN/TURN 服务器，改善 NAT 穿透与端到端延迟，适合公网、跨地域远程调试场景。

远程桌面支持多用户同时接入，便于协作排查、演示与培训。支持双向剪贴板共享与实时音频推送（Android 10+），并在同一 Web 界面集成终端、文件拖拽上传、目录浏览下载等运维能力，单端口即可完成日常操作。内置可视化布局检视：元素高亮、Tab 键遍历、坐标与 RGB 显示、XML 布局树导出，可在远程桌面内直接验证选择器与自动化逻辑，大幅缩短「看界面 → 写脚本」的闭环时间。





远程桌面与 RPC 接口支持 TLS 全链路加密与服务证书访问控制，可自定义 WebUI 登录密码，降低公网暴露风险。远程桌面能力还可通过 WebSocket 嵌入自有 Web 应用（实时视频、触控、终端、按键等），并可通过 allow_origin 配置跨域集成，适合将真机控制能力产品化。

 UI 自动化

FIRERPA 提供完整的选择器自动化体系，支持 text、resourceId、description、scrollable 等常见匹配方式，并支持 child / sibling 链式定位，应对重复元素、层级复杂或无显著特征的控件。元素级支持截图、等待出现/消失、角点/中心坐标获取、exists 判断等细粒度操作，支持 Unicode 输入、step 滑动、fling 快速翻页、滑动至底等交互。可与 Android 8.0+ 上其他无障碍服务共存，并增强 WebView 节点查找能力，提升混合应用自动化成功率。

界面监视器（Watcher） 可实时监听 UI 变化，在满足预设条件时自动执行点击、按键或计数，适用于自动跳过协议弹窗、更新提示、广告页等干扰流程；支持多 Selector 条件组合与事件独立启停，可统计一闪而过界面的出现次数。

虚拟屏幕（Virtual Display） 是 FIRERPA 的差异化能力之一：可在设备上创建独立的后台显示器，在虚拟屏中运行 App 与自动化脚本，不影响主屏幕正常使用——例如虚拟屏后台自动处理消息，主屏仍可刷视频、手动操作。虚拟屏 API 与主设备 API 高度一致，现有 d.xxx 脚本可平滑切换为 vd.xxx；Watcher 也可限定在虚拟屏内生效。WebUI 支持多屏幕展示与切换，可在远程桌面中选择操作或查看不同 Display，适合后台保活、并行任务与「前台人工 + 后台机器」混合场景。

针对无标准 View 树的场景（如游戏、自绘 UI），FIRERPA 提供 OCR 与图像匹配能力。OCR 支持 paddleocr、easyocr 及自定义 HTTP 后端，集群场景可将识别算力集中到服务端，避免每台 PC 重复加载模型；支持 GPU 加速与多种文本匹配模式。图像匹配在设备端执行模板匹配或 SIFT，不占 PC 资源；SIFT 对旋转、缩放、光照变化更鲁棒。此外提供多指触控能力，支持轨迹录制、重放、代码构造与二进制持久化，可表达复杂手势与压力值。

在架构定位上，FIRERPA 采用 C/S 模式，相较 AutoJS 等「设备自跑脚本」方案更利于中心化调度、版本管理与集群管控；相较 Appium 更轻量；相较 uiautomator2 在多设备场景下稳定性更好。文档将其定位为常见安卓自动化方案的功能超集——自动化与抓包、Hook、运维可在同一平台用代码串联，而不必在多套工具间切换。

 抓包与 MITM

FIRERPA 提供一键 MITM 抓包能力：自动安装系统级根证书、配置代理、处理 Android 版本差异，并在退出时自动恢复设备网络状态，无需手工装证、切代理。支持全局抓包、按包名抓包、实时改包、共享 mitmweb 界面，并可通过上游 HTTP 代理实现国际流量经指定链路抓包。内置 QUIC 降级处理，降低 QUIC 对抓包的影响。即使 PC 与设备仅能通过单一 FIRERPA 端口通信（如 ADB connect、frp 转发），仍可实施抓包，适配苛刻网络拓扑。

除一键脚本外，MITM 相关能力均可 API 化：系统级根证书安装/卸载通吃 mitmproxy、Fiddler、Charles 等格式，抓包流程可嵌入自动化流水线，与 UI 操作、Frida Hook 在同一任务中完成。提供 Windows 免 Python 的 startmitm.exe，降低环境门槛。

 网络、代理与组网

FIRERPA 在设备侧提供完整代理能力，支持 HTTP / HTTPS / SOCKS5 / Shadowsocks（多种加密算法），可按 App（含多开 user）粒度代理，支持 DNS 代理、UDP 代理、绕过局域网、与 OpenVPN 共存，并可在服务启动时自动连接预设代理。代理能力支持 IPv6 与 UDP，适配更复杂的网络环境。

设备 HTTP 桥接代理（tunnel2） 提供反向代理能力：将 PC 或浏览器的 HTTP 代理指向手机后，流量经手机网络出口转发，对外 IP 与手机一致，可选 Wi‑Fi 或 4G（rmnet）作为出站接口，适合联调、国际化业务、多设备 IP 池等场景。

内置 OpenVPN 客户端，支持证书、用户名密码及混合认证等多种登录模式，可与系统代理共存；配套提供 OpenVPN Docker 镜像与配置生成脚本，自动生成设备侧连接代码与自启动配置，降低手写 OpenVPN 配置出错概率。内置 frp 客户端，通过 fwd. 配置即可将设备服务转发至公网服务器，支持加密与 TLS。

提供