# frida-trace（NowSecure 声明式跟踪库）

> 供 Frida 代理脚本使用的 JavaScript 库，按声明式描述跟踪原生函数：每个函数都列出返回类型及输入、输出参数，参数类型包括指针、UTF-8 与 UTF-16 字符串，以及长度绑定到其他参数或返回值的字节数组，还可设置条件，例如仅在调用成功时读取输出指针。它从模块导出表或虚函数表解析函数，挂接 Frida 的 Interceptor，并为每次调用向回调传递一个事件。同一仓库中的辅助脚本可借助 libclang 从 C 头文件生成跟踪样板代码。

- 类型：工具
- 目标：应用 · 二进制
- 类别：调试与动态分析
- 关联：基础工具
- 来源复核于：2026-10-27
- 收录于：2026-11-03
- 原始资源：<https://github.com/nowsecure/frida-trace>
- 一手来源：<https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/nowsecure-frida-trace/>
- 记录 JSON：<https://awesomerea.org/resources/nowsecure-frida-trace/record.json>
- 英文版：[English](https://awesomerea.org/resources/nowsecure-frida-trace/index.md)

## 使用条件与局限

- 它不是 Frida 自带的同名命令行工具 frida-trace。npm 上最新版本为 4.0.1，发布于 2025-06-16，与所审阅的 main 分支提交 9b92c17 一致，将该库移植到 Frida 17；2024 年 1 月发布的 4.0.0 改为 ES 模块。
- 它运行在用户自行编写、编译（例如使用 frida-compile）并加载到 Frida 可附加进程中的代理脚本里，本身没有命令行界面。支持的类型包括 bool、byte、short、int、指针、字节数组、UTF-8、UTF-16 和 C 字符串；捕获到的值是否准确，取决于用户声明的函数签名是否正确。
- 头文件工具位于 frida-trace-tools，仓库中的版本为 3.3.0，未发布到 npm；需要 Node.js 和 frida-libclang，而 README 仍按旧的 ./bin 路径调用它们。仓库附带的示例宿主程序与代理仍依赖 frida 16 和 frida-trace ^3.0.0。仓库没有测试或持续集成。
- 采用 MIT 许可。插桩所需的目标进程须是用户有权检查的进程。

## 一手来源

1. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/README.md>
2. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/index.js>
3. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/package.json>
4. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/frida-trace-tools/package.json>
5. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/example/package.json>
6. <https://github.com/nowsecure/frida-trace/blob/9b92c1762373dcfc7458c34fa8f5826606bbcc8b/LICENSE.md>
7. <https://github.com/nowsecure/frida-trace/pull/40>
8. <https://www.npmjs.com/package/frida-trace/v/4.0.1>

## 同分区更多条目：原生二进制

- [BTD（Bin To DNN）DNN 可执行文件反编译器](https://awesomerea.org/zh/resources/btd-dnn-decompiler/index.md) · 工具
- [Boomerang 机器码反编译器](https://awesomerea.org/zh/resources/boomerang-decompiler/index.md) · 工具
- [ktool Mach-O 与 Objective-C 分析工具包](https://awesomerea.org/zh/resources/ktool/index.md) · 工具
- [Brida Burp Suite 与 Frida 桥接扩展](https://awesomerea.org/zh/resources/brida/index.md) · 工具
- [Qu1cksc0pe 恶意软件分析工具](https://awesomerea.org/zh/resources/qu1cksc0pe/index.md) · 工具
- [AppMon 基于 Frida 的应用 API 监控框架](https://awesomerea.org/zh/resources/appmon/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。