mcpField
F
frida-agent-builder

frida-agent-builder

github.com/rudra-ravi开发7103 次安装25 周前更新
代码仓库

关于 frida-agent-builder

Frida Agent Builder 是用于构建可复用 Frida Agent 和多脚本项目的技能，面向需要组织 TypeScript Agent 的开发者。它提供项目脚手架及构建约定，涵盖 Hook 模块、日志和 RPC 使用。

主要功能

  1. 01生成 TypeScript Agent 脚手架
  2. 02按 Hook 家族拆分文件
  3. 03为 Hook 家族导出 init()
  4. 04为复杂值使用结构化 JSON 日志
  5. 05按需添加 rpc.exports

适用场景

  1. 01从单个 Hook 扩展为多脚本项目
  2. 02搭建带 Java 支持的 Frida Agent
  3. 03统一 Hook 与日志组织方式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rudra-ravi/frida-skills --skill frida-agent-builder

安装后在 Claude Code 中输入/frida-agent-builder确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
agent-patterns.md
scripts/
scaffold-frida-agent.py

详细介绍

Frida Agent 构建器

将此技能用于可复用的 Frida Agent 和多脚本项目。

项目结构

如果脚本会超出单个 hook 的范围，优先使用小型 TypeScript Agent：

agent/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts
│   ├── log.ts
│   └── hooks/
└── dist/

对于捆绑式 Agent 中的 Frida 17 和 Java API，根据构建／运行时风格，在需要时加入 frida-java-bridge。

构建规则

  • 每个文件只放置一类 hook。
  • 为每类 hook 导出一个 init() 函数，并在 src/index.ts 中调用。
  • 使用带标签的结构化日志，并以 JSON 格式记录复杂值。
  • 仅在需要由主机控制的操作或测试探针时添加 rpc.exports。
  • 除非任务明确要求发现，否则避免使用范围过广的全局 hook。
  • 除非仓库惯例要求，否则不要将生成的产物纳入源代码管理。

脚手架脚本

使用 scripts/scaffold-frida-agent.py 创建最小化的 TypeScript Frida Agent：

python3 /path/to/frida-agent-builder/scripts/scaffold-frida-agent.py ./agent --java

然后安装并构建：

npm install
npm run build

参考资料

阅读 references/agent-patterns.md，了解项目约定、RPC 模式、主机命令示例和打包说明。

评论

支持 Markdown