{
  "added_at": "2026-10-19",
  "additional_evidence_urls": [
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/mizuchi.example.yaml",
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/docs/integrator-plugin.md",
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/package.json",
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/.gitmodules",
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/.github/workflows/ci.yml",
    "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/LICENSE"
  ],
  "category": "agent-workflows",
  "description_en": "Plugin pipeline for matching decompilation that loops over functions in an existing decomp project: m2c drafts C, decomp-permuter mutates it, Claude rewrites it through a compile-and-diff tool, and objdiff accepts a result only when the compiled object matches the target assembly. A local Decomp Atlas web app indexes matched and unmatched functions with call graphs and code embeddings, helps pick the next function and builds prompts, while HTML reports summarise each run. An optional integrator places matched C into a git worktree, checks the build and can commit, push or open a PR.",
  "description_zh": "面向匹配反编译的插件式流水线，在现有反编译项目中逐个处理函数：m2c 生成 C 初稿，decomp-permuter 对其做变异，Claude 借助编译并比对的工具改写代码，只有编译出的目标文件与目标汇编一致时才由 objdiff 判定通过。本地 Decomp Atlas 网页应用为已匹配和未匹配函数建立索引，附调用图和代码向量，帮助挑选下一个函数并生成提示词；HTML 报告汇总每次运行结果。可选的集成插件会把匹配成功的 C 代码放入 git 工作树，检查构建，并可提交、推送或发起 PR。",
  "entry_url": "https://awesomerea.org/resources/mizuchi-matching-decompilation-pipeline/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/mizuchi-matching-decompilation-pipeline/",
  "evidence_url": "https://github.com/macabeus/mizuchi/blob/25eaef4214574cc20f376878dbc1b8099e97164e/README.md",
  "group": "agents",
  "id": "mizuchi-matching-decompilation-pipeline",
  "json_url": "https://awesomerea.org/resources/mizuchi-matching-decompilation-pipeline/record.json",
  "kind": "integration",
  "markdown_url": "https://awesomerea.org/resources/mizuchi-matching-decompilation-pipeline/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/mizuchi-matching-decompilation-pipeline/index.md",
  "name": "Mizuchi",
  "name_zh": "Mizuchi 匹配反编译流水线",
  "record_type": "resource",
  "relationship": "independent-agent-integration",
  "requirements": [
    "The reviewed main commit of 2026-08-17 declares package version 0.1.0; the repository has no releases or tags and is installed from source with npm on Node.js 22+. m2c and decomp-permuter are optional git submodules with setup scripts. Code embeddings need Python 3.10+ and download torch, transformers and an embedding model of about 2–3 GB, using Apple-Silicon MPS or the CPU; --skip-embeddings avoids them.",
    "The Claude phase runs through the Claude Agent SDK and needs ANTHROPIC_API_KEY or cached Claude Code credentials; responses are cached locally by prompt hash. The example configuration allows 25 retries per prompt, gives the model read-only codebase tools plus compile_and_view_assembly, and accepts code only at zero instruction differences.",
    "Mizuchi works inside a decompilation project the user already has, configured with a map file, non-matching assembly folders, a compiler shell script and the project’s period compiler. It supplies no ROMs, game assets or decompiled game code; the original files come from that project and the user’s own copies. Listed target settings include GBA, DS, 3DS, N64, GameCube, Wii, PlayStation 1/2, PSP, Switch, Saturn, Dreamcast, Win32, Android x86 and IRIX.",
    "CI on Ubuntu runs type checks, lint, formatting and the Vitest suite and builds the CLI, using bundled agbcc and KMC GCC compiler fixtures. The README links an author post on benchmarks, and the repository publishes no match results. The integrator can push branches and open PRs with gh, and its optional AI build fix lets Claude edit files and run shell commands in the worktree, so review its output before it reaches a shared project.",
    "MIT-licensed. m2c, decomp-permuter, objdiff, the embedding model and the compilers keep their own terms, and decompiled code inherits the target project’s rights and contribution rules."
  ],
  "requirements_zh": [
    "所审阅的 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、向量模型和各编译器保留各自条款，反编译出的代码受目标项目的权利和贡献规则约束。"
  ],
  "targets": [
    "binary",
    "game"
  ],
  "url": "https://github.com/macabeus/mizuchi",
  "verification": "source-reviewed",
  "verified_at": "2026-10-19"
}