AwesomeREA.org

工具

hermes-decomp Hermes 字节码反编译器

面向 Hermes 字节码（.hbc）的 Rust 反编译与分析工具包；.hbc 是 React Native 应用为 Hermes 引擎打包的编译格式，README 列出支持 HBC 40 至 99 版本。其 hermes-decomp 命令行可显示文件信息、反汇编，并将整个包或单个函数反编译为 JavaScript，较慢的深度模式还能恢复更多名称；此外提供终端界面、交叉引用、调用图、控制流图、Metro 模块与闭包视图以及字节码差异比较。独立的 hermes-mcp 服务器将读取和分析功能作为 MCP 工具提供，hbc-decomp crate 则以 Rust 库的形式提供这些功能。

使用条件与局限

  • 审阅时的最新版本为 v0.2.4，于 2026-10-01 发布，即所审阅的 main 分支提交。其压缩包包含 hermes-decomp 和 hermes-mcp，覆盖 Linux x86_64 与 ARM64、macOS ARM64 和 Windows x86_64，并附 SHA256SUMS；README 还列出 macOS x86_64 构建，但该版本并未提供。从源码构建需要 Rust 1.70+，update 命令可检查或安装新版本。
  • 输入为取自用户自己 React Native 应用的 Hermes 字节码文件，而非纯 JavaScript 包。反编译整个包时会在输入文件旁写入 .hdcache 缓存文件，传入 --no-cache 则不使用缓存。hermes-mcp 默认使用 stdio；其 HTTP 传输方式默认监听 127.0.0.1:8744，除非另行指定主机。docs/MCP.md 只列出读取和分析类工具。
  • 命令行另有写入命令，可汇编或修补字节码和 HASM，但不会把反编译出的 JavaScript 重新编译。USAGE.md 称 HBC 96 及以下版本的写入功能完整，并已在 Hermes 虚拟机上验证；HBC 97 及以上的文件只支持等长字符串修补，且只能借助 macOS 上的辅助程序进行验证。
  • CI 检查代码格式和 Clippy，在各平台上构建，并在跳过依赖语料库的测试后运行测试套件；仓库保存了少量 jsx_cycle .hbc 测试夹具。本地检查会用脚本下载或构建的 hermesc 工具链编译示例代码片段，在 Node 下分别运行原始代码和反编译代码并比较输出（列出了五个已知失败项），还为每个包设定无法解析模块数的上限，唯一记录的包上限为 211 个，可见反编译输出并不总是合法的 JavaScript。
  • 采用 MIT 许可。本次未反编译或修补任何字节码，也未运行 MCP 服务器。

关于此条目

类型
工具
类别
Android 工具
关联
基础工具
目标
应用

来源复核于

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

一手来源

  1. README.md GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  2. docs/USAGE.md GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  3. docs/USAGE.md#L99-L152 GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  4. docs/MCP.md GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  5. docs/LIBRARY.md GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  6. Cargo.toml GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  7. .github/workflows/build.yml GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  8. scripts/build/roundtrip.sh GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  9. scripts/build/roundtrip_known_failures.tsv GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  10. scripts/build/gates.sh GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  11. scripts/build/syntax_baseline.tsv GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  12. LICENSE GitHub · SymbioticSec/hermes-decomp · 修订 ad4c924
  13. https://github.com/SymbioticSec/hermes-decomp/releases/tag/v0.2.4