at-adb 命令与标准 adb 完全兼容，以 adb shell 为例：

# 指定序列号连接
$ at-adb -s xxx shell

# 使用上次连接的设备
$ at-adb -l shell

# 连接远程 TCP 设备
$ at-adb -c 127.0.0.1:5555 shell

# 未指定时交互选择设备
$ at-adb shell
More than one device/emulator
>> 1: 18201FDF6003BE (Pixel 6)
   2: 10.10.10.58:5555 (Pixel 6)
Choose device [1~2] (1): 1

# 查看指定包名的日志
$ at-pidcat -p me.ele

# 查看当前前台应用的日志
$ at-pidcat --top

# 查看指定 tag 的日志
$ at-pidcat -t XcdnEngine

# 展示当前顶层应用的包名、Activity、APK 路径等信息
$ at-top

# 导出当前顶层应用的 APK
$ at-top --apk

# 截屏并导出
$ at-top --screen

# 显示当前前台应用的基本信息
$ at-app

# 显示应用的详细信息
$ at-app --detail

# 高亮显示危险权限等风险项
$ at-app --detail --dangerous

# 显示所有非系统应用信息
$ at-app --non-system

输出效果：

# 跳转到系统设置页
$ at-intent setting

# 跳转到开发者选项页
$ at-intent setting-dev

# 跳转到指定应用的设置页
$ at-intent setting-app

# 安装证书
$ at-intent setting-cert ~/test.crt

# 安装 APK（支持 URL）
$ at-intent install https://example.com/test.apk

# 在浏览器中打开链接（也可用于测试 URL Scheme）
$ at-intent browser https://example.com

1. 根据设备架构和 Python 中 frida 版本，全自动下载、推送、运行 frida-server
2. 监听 spawn 进程变化，可同时 hook 主进程和各子进程
3. 监听 JS 文件变化，实时热重载
4. 内置脚本封装常用功能（如绕过 SSL Pinning）
5. 支持加载远程脚本（Codeshare）
6. 支持将设备流量重定向到本地端口

# 以 spawn 模式加载本地脚本注入到指定进程
$ at-frida -l ~/test/frida.js -p me.ele --spawn

# 加载远程脚本，并将流量重定向到本地 8080 端口
$ at-frida -c https://raw.githubusercontent.com/.../android.js -p me.ele --redirect-port 8080

# 只启动 frida-server，不注入脚本
$ at-frida --serve --remote-port 27042 --local-port 27042 -p fake_package

# 使用设备上已运行的 frida-server
$ at-frida --no-serve --remote-port 27042 -p me.ele

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from linktools.cli import BaseCommand
from linktools.mobile.frida import FridaApplication, FridaEvalCode, FridaAndroidServer


class Command(BaseCommand):

    def init_arguments(self, parser):
        pass

    def run(self, args):
        code = """
            Java.perform(function () {
                JavaHelper.hookMethods(
                    "java.util.HashMap",
                    "put",
                    {stack: false, args: true}
                );
            });
            """

        with FridaAndroidServer() as server:
            app = FridaApplication(
                server,
                user_scripts=(FridaEvalCode(code),),
                enable_spawn_gating=True,
                target_identifiers=rf"^com.topjohnwu.magisk($|:)"
            )
            app.inject_all()
            app.run()


command = Command()
if __name__ == "__main__":
    command.main()

参考 agents/frida/lib/java.ts

Java.perform(function () {

    // hook 指定类的指定重载方法
    JavaHelper.hookMethod(
        "me.ele.privacycheck.f",
        "a",
        ['android.app.Application', 'boolean'],
        function (obj, args) {
            args[1] = true;
            return this(obj, args);
        }
    );

    // hook 指定类的所有同名方法
    JavaHelper.hookMethods(
        "anet.channel.entity.ConnType",
        "isHttpType",
        () => true
    );

    // hook 指定类的全部方法
    JavaHelper.hookAllMethods(
        "p.r.o.x.y.PrivacyApi",
        JavaHelper.getEventImpl({
            stack: true,   // 打印调用栈
            args: true,    // 打印参数和返回值
            thread: false,
            extras: { customKey: "自定义参数" }
        })
    );

    // 等待动态加载的 class（持续监听 ClassLoader）
    JavaHelper.use("p.r.o.x.y.PrivacyApi", function(clazz) {
        JavaHelper.hookAllMethods(clazz, JavaHelper.getEventImpl({ stack: true, args: true }));
    });

    // 绕过 SSL Pinning
    JavaHelper.bypassSslPinning();

    // 开启 WebView 远程调试
    JavaHelper.setWebviewDebuggingEnabled();
});

# 设置剪贴板内容
$ at-agent common --set-clipboard "剪切板内容"

# 获取剪贴板内容
$ at-agent common --get-clipboard

# 以 root 权限 dump 系统服务信息（需要 root 设备并挂载 DebugFS）
$ at-agent -u root --debug service --detail

# 加载插件 APK 并调用插件方法
$ at-agent --plugin app-release.apk

# 列出所有已连接设备
$ it-ios list

# 指定 UDID 执行命令
$ it-ios -s xxx info

# 使用上次连接的设备
$ it-ios -l info

# 未指定时交互选择设备
$ it-ios info
More than one device/emulator
>> 1: 00008030-001174D10CC1802E (iPhone)
   2: 00008030-001174D10CC1803E (iPhone)
Choose device [1~2] (1): 1

# 连接设备
$ it-ssh

# 连接设备并执行命令
$ it-ssh sh -c "id"

远程路径需加 : 前缀与本地路径区分：

# 从设备下载文件到本地
$ it-scp :/var/mobile/Documents/data.db ./data.db

# 上传本地文件到设备
$ it-scp ./payload.dylib :/usr/lib/payload.dylib

# 指定用户名和端口（默认 root:22）
$ it-scp -u mobile -p 2222 :/var/mobile/test.txt ./test.txt

# 解析并展示 IPA 信息
$ it-ipa app.ipa

# 以 spawn 模式加载脚本注入到指定 Bundle ID
$ it-frida -l ~/test/frida.js -b com.example.app --spawn

# 加载 Codeshare 脚本
$ it-frida -c https://codeshare.frida.re/@xxx/yyy -b com.example.app

# 执行内联代码
$ it-frida -e "console.log('hello')" -b com.example.app

# 注入到当前前台应用
$ it-objection

# 注入到指定 Bundle ID
$ it-objection -b com.example.app

# 注入时执行启动命令（可多次指定 -s）
$ it-objection -b com.example.app -s "ios sslpinning disable"

# 注入时执行启动脚本
$ it-objection -b com.example.app -S ./startup.js