# bn：面向智能体的 Binary Ninja 命令行工具

> 面向智能体的命令行工具，用于操作已在 Binary Ninja 图形界面中打开的数据库，通过监听本地 Unix 域套接字的配套插件连接。智能体可读取反编译结果、中间语言、反汇编、交叉引用、调用点、类型和数据，导出多函数打包结果，并在 Binary Ninja 内运行不受限制的 Python；重命名以及函数原型、结构体和类型修改可先预览，应用后会校验结果，失败时回滚。较大的文本输出会转存为附带哈希的产物文件，随包提供的 Codex 技能说明了使用流程。

- 类型：集成
- 目标：二进制
- 类别：独立智能体工作流
- 关联：独立智能体集成
- 来源复核于：2026-10-20
- 收录于：2026-11-02
- 原始资源：<https://github.com/banteg/bn>
- 一手来源：<https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/bn-binary-ninja-agent-cli/>
- 记录 JSON：<https://awesomerea.org/resources/bn-binary-ninja-agent-cli/record.json>
- 英文版：[English](https://awesomerea.org/resources/bn-binary-ninja-agent-cli/index.md)

## 使用条件与局限

- 审阅时最新版本为 v0.15.0，于 2026-09-04 在 GitHub 和 PyPI（包名 bn-cli）发布；所审阅的 master 提交即该标签，也是仓库最近一次推送。需要 Python 3.12+，以 uv 工具方式安装；bn plugin install 将 BN Agent Bridge 插件链接到 Binary Ninja，bn skill install 将技能链接到 Codex 主目录下的 skills 文件夹。命令行工具与已加载的插件须使用相同的桥接协议版本 2，因此升级后需重启 Binary Ninja 或重新加载插件。
- 操作对象是在 Binary Ninja 图形界面中打开的数据库；README 称配套插件可配合个人许可证使用，无需无界面许可证。桥接套接字位于用户缓存目录，README 未列出支持的操作系统或 Binary Ninja 版本。同时打开多个视图时，命令需显式指定 --target 选择器，而不会默认使用当前标签页。
- 二进制文件和数据库由分析者自行提供，仓库中没有目标二进制。bn py 以用户权限在 Binary Ninja 内运行不受限制的 Python，其写入不经过内置修改操作的预览、校验和回滚；所审阅的桥接代码除套接字路径的访问权限外未设其他身份验证。全库文本和常量搜索默认在五秒分析预算后停止，并报告结果不完整。
- CI 在 Python 3.12 和 3.14 上针对模拟的 binaryninja 模块运行 pytest，检查发布元数据，并用构建出的 wheel 冒烟测试插件与技能安装，因此并未在真实的 Binary Ninja 中运行。修改操作返回 verified、noop、unsupported 或 verification_failed；README 提示类型修改后反编译显示可能仍是旧内容，需回读类型或刷新分析。
- 采用 MIT 许可，v0.14.1 起加入仓库；Binary Ninja 保留自身的许可条款。

## 一手来源

1. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/README.md>
2. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/src/bn/assets/skills/bn/SKILL.md>
3. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/src/bn/assets/plugin/bn_agent_bridge/bridge.py>
4. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/src/bn/assets/plugin/bn_agent_bridge/server.py>
5. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/src/bn/paths.py>
6. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/pyproject.toml>
7. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/CHANGELOG.md>
8. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/.github/workflows/ci.yml>
9. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/tests/test_bridge.py>
10. <https://github.com/banteg/bn/blob/bd910329547303c787a68fcd8309e83ab1be6590/LICENSE>
11. <https://github.com/banteg/bn/releases/tag/v0.15.0>
12. <https://pypi.org/project/bn-cli/0.15.0/>

## 同分区更多条目：智能体与 MCP

- [IDA Pro MCP 服务器（fdrechsler）](https://awesomerea.org/zh/resources/mcp-server-idapro-fdrechsler/index.md) · 集成
- [Ghidra Headless MCP](https://awesomerea.org/zh/resources/ghidra-headless-mcp/index.md) · 集成
- [Binary Ninja Headless MCP（无界面）](https://awesomerea.org/zh/resources/binary-ninja-headless-mcp/index.md) · 集成
- [IDA-Skill IDA Pro 恶意样本分析智能体技能](https://awesomerea.org/zh/resources/ida-skill-malware-analysis/index.md) · 集成
- [BinAssist Binary Ninja 大模型辅助分析插件](https://awesomerea.org/zh/resources/binassist/index.md) · 集成
- [Reversecore MCP 逆向与安全分析 MCP 服务器](https://awesomerea.org/zh/resources/reversecore-mcp/index.md) · 集成

## 关于此条目

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