# Binary Refinery 二进制数据转换工具集

> 由大量可组合的 Python 命令行单元组成的二进制数据转换工具集，涵盖编码、压缩、加密、归档与可执行文件格式提取、数据切割（carving）和模式搜索。各单元从标准输入读取、向标准输出写入，因此可串联成 shell 管道；分帧（framing）、multibin 参数和元变量使一条管道能处理多个数据块，binref 命令可检索各单元的帮助文本。作者称其为面向恶意软件初步分析、在命令行上实现类似 CyberChef 功能的工具；README 还指向独立的 binref/agent 仓库，其中提供供语言模型智能体使用 refinery 的说明。

- 类型：工具
- 目标：二进制
- 类别：原生分析工具
- 关联：基础工具
- 来源复核于：2026-10-20
- 收录于：2026-11-02
- 原始资源：<https://github.com/binref/refinery>
- 一手来源：<https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/binary-refinery/>
- 记录 JSON：<https://awesomerea.org/resources/binary-refinery/record.json>
- 英文版：[English](https://awesomerea.org/resources/binary-refinery/index.md)

## 使用条件与局限

- 审阅时最新版本为 0.11.2，于 2026-07-14 上传到 PyPI，要求 Python 3.10+。所审阅的 master 分支提交日期为 2026-10-11，比该标签多 1,138 个提交，版本号仍为 0.11.2，但其更新日志已列出 0.11.3 的不兼容变更，包括要求 Python 3.11+ 以及元变量改名。README 称 refinery 仍处于 alpha 阶段，单元和参数可能被改名或移除。
- 通过 pip 安装 binary-refinery，建议装在独立的虚拟环境中。default、extended 和 all 三组附加选项依次加入更多可选依赖，运行单元时会提示缺少哪个依赖。安装时会为每个单元创建一条 shell 命令，可加前缀以避免命名冲突。README 将 Bash 和 CMD 的支持评为良好，PowerShell 7.4+ 为尚可，Zsh 和 Fish 存在小问题。若干解压缩和加密例程同时提供 Cython 扩展和纯 Python 版本。
- 输入为分析者自有的文件或经标准输入管道传入的数据。CI 在 Windows、macOS 和 Ubuntu 上以 Python 3.11 和 3.13 运行 pytest。需要真实样本输入的测试会从独立的 binref/refinery-test-data 仓库获取加密文件。单元输出取决于所选参数，需要分析者核实。
- LICENSE.md 为三条款 BSD 许可证，GitHub 未能识别。refinery/lib/thirdparty 中的第三方模块保留各自的许可证，refinery/lib/seven 移植了 7-Zip 的压缩代码。

## 一手来源

1. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/README.md>
2. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/README.md#L124-L126>
3. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/CHANGELOG.md>
4. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/setup.py>
5. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/pyproject.toml>
6. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/refinery/__init__.py>
7. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/.github/workflows/test.yml>
8. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/samples/__init__.py>
9. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/refinery/lib/thirdparty/__init__.py>
10. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/refinery/lib/seven/__init__.py>
11. <https://github.com/binref/refinery/blob/13d8c68863c3d11d4e6cd36007fdd6c53459eda6/LICENSE.md>
12. <https://pypi.org/project/binary-refinery/0.11.2/>
13. <https://github.com/binref/agent/blob/be019a500f1827c9359c51e9879d6144cb7453de/README.md>

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

- [AngryGhidra Ghidra 符号执行插件](https://awesomerea.org/zh/resources/angryghidra/index.md) · 工具
- [fpicker Frida 插桩与覆盖率采集套件](https://awesomerea.org/zh/resources/fpicker/index.md) · 工具
- [RetroWrite 静态二进制改写框架](https://awesomerea.org/zh/resources/retrowrite/index.md) · 工具
- [Interruptor 系统调用跟踪库](https://awesomerea.org/zh/resources/interruptor/index.md) · 工具
- [dyld_cache_extract dyld 共享缓存提取工具](https://awesomerea.org/zh/resources/dyld-cache-extract/index.md) · 工具
- [FLARE IDA Pro 实用脚本合集](https://awesomerea.org/zh/resources/flare-ida/index.md) · 工具

## 关于此条目

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