# Mizuchi 匹配反编译流水线

> 面向匹配反编译的插件式流水线，在现有反编译项目中逐个处理函数：m2c 生成 C 初稿，decomp-permuter 对其做变异，Claude 借助编译并比对的工具改写代码，只有编译出的目标文件与目标汇编一致时才由 objdiff 判定通过。本地 Decomp Atlas 网页应用为已匹配和未匹配函数建立索引，附调用图和代码向量，帮助挑选下一个函数并生成提示词；HTML 报告汇总每次运行结果。可选的集成插件会把匹配成功的 C 代码放入 git 工作树，检查构建，并可提交、推送或发起 PR。

- 类型：集成
- 目标：二进制 · 游戏
- 类别：独立智能体工作流
- 关联：独立智能体集成
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/macabeus/mizuchi>
- 一手来源：<https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/mizuchi-matching-decompilation-pipeline/>
- 记录 JSON：<https://awesomerea.org/resources/mizuchi-matching-decompilation-pipeline/record.json>
- 英文版：[English](https://awesomerea.org/resources/mizuchi-matching-decompilation-pipeline/index.md)

## 使用条件与局限

- 所审阅的 main 分支提交日期为 2026-08-17，声明软件包版本 0.1.0；仓库没有发布版或标签，需在 Node.js 22+ 环境下用 npm 从源码安装。m2c 和 decomp-permuter 是可选的 git 子模块，附有安装脚本。代码向量需要 Python 3.10+，并会下载约 2–3 GB 的 torch、transformers 和向量模型，使用 Apple Silicon 的 MPS 或 CPU 运行；加 --skip-embeddings 可跳过。
- Claude 阶段通过 Claude Agent SDK 运行，需要 ANTHROPIC_API_KEY 或已缓存的 Claude Code 登录凭据；响应按提示词哈希缓存在本地。示例配置为每个提示词允许重试 25 次，向模型提供只读的代码库工具和 compile_and_view_assembly，只有指令差异为零时才接受代码。
- Mizuchi 在使用者已有的反编译项目中工作，需要配置映射文件、未匹配汇编目录、编译器脚本和该项目使用的当年编译器。它不提供 ROM、游戏素材或反编译出的游戏代码；原始文件来自该项目和使用者自有的副本。所列目标设置包括 GBA、DS、3DS、N64、GameCube、Wii、PlayStation 1/2、PSP、Switch、Saturn、Dreamcast、Win32、Android x86 和 IRIX。
- Ubuntu 上的 CI 运行类型检查、代码规范检查、格式检查和 Vitest 测试并构建 CLI，测试使用仓库内的 agbcc 与 KMC GCC 编译器样本。README 链接了作者关于基准测试的文章，仓库本身未发布匹配结果。集成插件可用 gh 推送分支并发起 PR，其可选的 AI 构建修复会让 Claude 在工作树中编辑文件并执行 shell 命令，因此结果进入共享项目前应先审查。
- 采用 MIT 许可。m2c、decomp-permuter、objdiff、向量模型和各编译器保留各自条款，反编译出的代码受目标项目的权利和贡献规则约束。

## 一手来源

1. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/README.md>
2. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/mizuchi.example.yaml>
3. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/docs/integrator-plugin.md>
4. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/package.json>
5. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/.gitmodules>
6. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/.github/workflows/ci.yml>
7. <https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/LICENSE>

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

- [ReAgent C/C++ 函数重建智能体](https://awesomerea.org/zh/resources/reagent-cpp-reconstruction-agent/index.md) · 集成
- [lisa.py：LLDB 的 MCP 集成与调试辅助命令](https://awesomerea.org/zh/resources/lisa-lldb-mcp/index.md) · 集成
- [WireMCP 基于 tshark 的流量分析 MCP 服务器](https://awesomerea.org/zh/resources/wiremcp/index.md) · 集成
- [ReverserAI：本地大模型函数命名 Binary Ninja 插件](https://awesomerea.org/zh/resources/reverser-ai/index.md) · 集成
- [WPeGPT IDA AI 分析插件](https://awesomerea.org/zh/resources/wpegpt/index.md) · 集成
- [IDAssist IDA Pro 大模型辅助分析插件](https://awesomerea.org/zh/resources/idassist/index.md) · 集成

## 关于此条目

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