8.22 auto-commit

Author: rev1si0n

CHANGELOG.txt

@@ -1,3 +1,8 @@
+8.22
+* 使用全新 sqlite
+* 远程桌面检视显示当前坐标及RGB
+* 增加插件 setup 逻辑
+
 8.20
 * 新增官方 MCP 插件
 * 优化 frida 兼容性

README.md

@@ -22,15 +22,15 @@
 <img src="image/claude.gif" alt="Claude" width="95%">
 </p>
 
-<p align="center">FIRERPA is a comprehensive solution in the Android domain, designed to reduce trivial issues in security analysis, application testing, or automation work. It has been tested in production environments on over a thousand device clusters and is stably applied in multiple large-scale systems including automated forensics, cloud platforms, data collection, compliance analysis, and other systems, with commercial-grade software quality and stability. It features full architecture and wide compatibility with Android 6.0-15, requires only root privileges to run normally, and supports emulators, physical devices, cloud phones, WSA (Windows Subsystem for Android™️), RK development boards, and Redroid, as well as most devices running the Android system. It provides a stable solution for mobile RPA and data automation.RetryClaude can make mistakes. Please double-check responses.</p>
+<p align="center">It's a stable and commercial-grade Android automation solution supporting Android 6.0–15 across emulators, real devices, and cloud platforms. It simplifies security analysis and testing tasks, requiring only root access, and is widely used in large-scale systems like forensics and compliance analysis.</p>
 
 <h3><p align="center">Widely Applicable Architecture Design</p></h3>
 
-<p align="center">FIRERPA differs from any other similar software, designed from the outset with consideration for various possible application environments. It can run non-intrusively on most current Android devices, is plug-and-play, has no external dependencies, requires no additional settings, and is natively designed for large-scale business scenarios, making it easy to systematically manage and update. Meanwhile, other software with similar functionality still experiences various issues such as disconnections, instability, poor compatibility, lack of maintenance, and management difficulties.</p>
+<p align="center">Unlike similar tools, it was built for diverse environments from day one. It runs non-intrusively on most Android devices, is plug-and-play with no dependencies or extra setup, and is optimized for large-scale business use. In contrast, other tools often suffer from instability, poor compatibility, and maintenance issues.</p>
 
 <h3><p align="center">Rich Programming Interfaces</p></h3>
 
-<p align="center">Provides up to 160 programming interfaces, allowing you to exercise meticulous control over Android devices. It offers more than a dozen categories of interfaces including command execution, system settings, status, application-related, automation control, proxy, and file interfaces. It also provides a complete Python library package so you can quickly get started. Standardized and stable services and interfaces allow you to control every detail through code without worry, and even enable AI integration, allowing large models to automatically write and execute tasks.</p>
+<p align="center">Offers 160+ stable, categorized APIs—covering commands, system settings, automation, apps, and more—plus a full Python SDK for fast development. It enables precise Android control and seamless AI integration for automated task generation and execution.</p>
 
 <h3><p align="center">Simple and Easy-to-Use Remote Desktop</p></h3>
 
@@ -40,4 +40,4 @@
 
 <p align="center">
 Of course, the capabilities provided by FIRERPA go beyond these. It is your powerful device control and management tool. If interested, please go to the documentation.
-</p>
+</p>

examples/README.md

@@ -0,0 +1,3 @@
+We’re not targeting any specific application; we’re just using it as a convenient example for the demo.
+
+API Document: https://device-farm.com/doc/

examples/activity_jump.py

@@ -0,0 +1,19 @@
+# Copyright 2025 rev1si0n ([email protected]). All rights reserved.
+#encoding=utf-8
+from lamda.client import *
+import time
+
+d = Device("localhost")
+
+app = d.application("com.taobao.taobao")
+app.start()
+
+while True:
+    goodsid = input("Please input a taobao goods id (item_id) (eg. 123456): ")
+    if goodsid.isdigit():
+        intent["package"] = "com.taobao.taobao"
+        intent["action"] = "android.intent.action.VIEW"
+        intent["component"] = "com.taobao.taobao/com.taobao.android.detail.alittdetail.TTDetailActivity"
+        intent["data"] = f"http://internal.tt.detail.taobao.com/detail/index.html?id={goodsid}"
+        d.start_activity(**intent)
+        time.sleep(2)

examples/search_in_taobao.py

@@ -0,0 +1,51 @@
+# Copyright 2025 rev1si0n ([email protected]). All rights reserved.
+#encoding=utf-8
+from lamda.client import *
+import time
+
+"""
+This is a simple demo for performing keyword searches on Taobao.
+"""
+
+d = Device("localhost")
+
+app = d.application("com.taobao.taobao")
+
+if not app.is_installed():
+    print ("taobao app is not installed")
+    exit (1)
+
+if app.info().versionName != "10.48.0":
+    print ("please intall taaobao 10.48.0")
+    exit (1)
+
+# ensure the app is stopped
+app.stop()
+time.sleep(1.5)
+
+app.start()
+time.sleep(10) # wait for app fully started
+
+if not d(description="我的淘宝").exists():
+    print ("is taobao home page?")
+    exit (1)
+
+# click to activate input
+d(description="搜索栏").click()
+
+# wait for search input activated
+d(resourceId="com.taobao.taobao:id/searchbtn").wait_for_exists(15*1000)
+
+# input search keyword: 苹果手机
+d(resourceId="com.taobao.taobao:id/searchEdit").set_text("苹果手机")
+
+# click "Search"
+d(resourceId="com.taobao.taobao:id/searchbtn").click()
+
+# wait for goods showsup
+d(description="筛选").wait_for_exists(15*1000)
+
+# do a simple swipe
+d().swipe()
+
+# ...

extensions/README.md

@@ -0,0 +1 @@
+API Document: https://device-farm.com/doc/

extensions/firerpa.py

@@ -8,7 +8,6 @@
 # ===================================================================
 #
 from lamda.mcp import *
-from lamda.mcp import PromptMessage,GetPromptResult
 from lamda.client import *
 from lamda.utils import getprop
 from lamda.extensions import BaseMcpExtension, to_json_string

lamda/__init__.py

@@ -2,4 +2,4 @@
 #
 # Distributed under MIT license.
 # See file LICENSE for detail or copy at https://opensource.org/licenses/MIT
-__version__ = "8.20"
+__version__ = "8.22"

lamda/client.py

@@ -1532,6 +1532,12 @@ def getprop(self, name):
         req = protos.String(value=name)
         r = self.stub.getProp(req)
         return r.value
+    def server_info(self):
+        """
+        获取服务端ID、版本等信息
+        """
+        r = self.stub.serverInfo(protos.Empty())
+        return r
 
 
 class DebugStub(BaseServiceStub):
@@ -2384,6 +2390,8 @@ def remove_watcher(self, name):
         return self.stub("UiAutomator").remove_watcher(name)
     def device_info(self):
         return self.stub("UiAutomator").device_info()
+    def server_info(self):
+        return self.stub("Util").server_info()
     def __call__(self, **kwargs):
         return self.stub("UiAutomator")(**kwargs)
     # OCR 功能扩展

lamda/rpc/services.proto

@@ -216,6 +216,8 @@ service Util {
     rpc recordTouch(google.protobuf.Empty) returns (TouchSequence) {}
     rpc performTouch(PerformTouchRequest) returns (Boolean) {}
 
+    rpc serverInfo(google.protobuf.Empty) returns (ServerInfoResponse) {}
+
     rpc reboot(google.protobuf.Empty) returns (Boolean) {}
     rpc beepBeep(google.protobuf.Empty) returns (Boolean) {}
     rpc isCACertificateInstalled(CertifiRequest) returns (Boolean) {}

lamda/rpc/util.proto

@@ -63,3 +63,11 @@ message ShowToastRequest {
         string           text   = 1;
         ToastDuration duration  = 2;
 }
+
+message ServerInfoResponse {
+        string         uniqueId = 1;
+        string          version = 2;
+        string     architecture = 3;
+        uint64           uptime = 4;
+        bool             secure = 5;
+}

tools/README.md

@@ -1 +1 @@
-使用方法请查看 https://device-farm.com/doc/
+Document: https://device-farm.com/doc/