ida-agent-bridge

IDA Domain API Reference

启动 ida-bridge

首先执行 ps 确认现有进程：

ps -ef | grep ida-bridge | grep -v grep

根据结果判断：

• 有进程 → 从命令行参数里直接读取文件路径和端口号，跳到步骤 2
• 无进程 → 询问用户：

  没有发现正在运行的 ida-bridge。请告诉我：

  1. 要分析的文件路径（.i64 / .so）
  2. 需要我帮你启动吗？

用户确认启动后：

ida-bridge /path/to/file.i64 <port> --skip-export &

• 端口默认 13120，如有冲突自选其他端口
• 默认加 --skip-export，不做全量导出（速度更快）
• 如果任务明确需要导出（批量分析、读 function_index.tsv 等），先问用户：

  这个任务可能需要导出函数索引，是否启用导出？（首次较慢）

启动后用 !ping 确认就绪。

Agent 只使用短连接模式。 --human-shell 是给人用的交互模式，Agent 不应使用。

---

工作流

优先级：REPL 指令 → Python 脚本 → 原生 ida_ 模块*

REPL 快捷指令（echo '!cmd' | nc localhost PORT）
      ↓ 指令无法满足（批量操作/复杂逻辑）
Python 脚本（cat script.py | nc localhost PORT）
      ↓ ida-domain 没有封装
原生 ida_* 模块（直接在脚本中调用）

---

快捷指令

不需要写 Python，直接发单行命令。这是最快的操作方式。

地址和函数名均可互换（0x... 十六进制地址或符号名）。

探索与查询

echo '!afl' | nc localhost <port>                      # 列出所有函数
echo '!afl jni' | nc localhost <port>                  # 搜含 jni 的函数名
echo '!afi main' | nc localhost <port>                 # 函数详情
echo '!iz ssl' | nc localhost <port>                   # 搜含 ssl 的字符串
echo '!axi malloc' | nc localhost <port>               # 导入符号的所有调用点

输出格式：

# !afl — TAB 分隔: 地址  名称  大小(hex)  callers=N
0x11f0	_ossl_fnv1a_hash	0x38	callers=0
0x1228	_ossl_ctype_check	0x28	callers=2

# !afi — 键值对
name:     _ossl_fnv1a_hash
addr:     0x11f0 - 0x1228
size:     0x38 (56)
callers:  0
callees:  0

# !iz — 地址  内容  refs=N  [引用函数]
0x810ee	ossltest  refs=1  [_alpn_select_cb]

# !axi — 地址  引用类型  [所在函数]
0x12f0    CALL_NEAR  [in: _SSL_read]

交叉引用

echo '!axt 0x1234' | nc localhost <port>               # xrefs to 地址
echo '!axf main' | nc localhost <port>                 # xrefs from 函数名

输出格式：

# !axt / !axf — 地址  引用类型  [所在函数]
0x2f020    CALL_NEAR  [in: _ossl_qlog_set_filter]
0x2f064    CALL_NEAR  [in: _ossl_qlog_set_filter]

反汇编与伪代码

echo '!pd 0x1234' | nc localhost <port>                # 从地址反汇编 16 条（默认）
echo '!pd 0x1234 32' | nc localhost <port>             # 反汇编 32 条
echo '!pdf main' | nc localhost <port>                 # 整函数反汇编（带 CFG block 标注）
echo '!pdc 0x1234' | nc localhost <port>               # 伪代码
echo '!pdc 0x1234 -s' | nc localhost <port>            # 过滤变量声明（大函数用）
echo '!mc main' | nc localhost <port>                  # 微码（默认 generated）
echo '!mc main lvars' | nc localhost <port>            # 微码 maturity: generated/preopt/locopt/calls/glbopt1/glbopt2/glbopt3/lvars
echo '!deps main' | nc localhost <port>                # 递归调用链（默认深度 3）
echo '!deps main 5' | nc localhost <port>              # 调用链深度 5