Browse / Software development / rea-workspace-template
rea-workspace-template
dobest1024
Evidence-first reverse engineering workspace template for REA, Claude Code, and Codex.基于 REA 的逆向分析工作区模板,支持 Claude Code 和 Codex,涵盖 APK、二进制、源码与 API 分析。
Open dobest1024/rea-workspace-template → Checked against the four rules.
Works with any agent
ships AGENTS.md, the cross-tool instruction file.
In its own words
一个目标一个工作区:保留原件,在副本上分析,用证据支撑结论。适用于源码、APK、原生二进制、JavaScript/Electron、HAR 和未知文件格式。
参考 zodchiii 的帖子,按 REA 官方文档 和本机 REA 6.4.0 的实际命令整理。模型沿用你自己的设置;帖子中的模型规格、成本与耗时没有作为本模板的承诺。
快速开始
1. 克隆仓库
先安装 Git、Python 3.11+、Node.js 及 npm,以及你要使用的 Claude Code 或 Codex。脚手架脚本只依赖 Python 标准库,不需要 pip install 或在本仓库运行 npm install。以下命令以 macOS / Linux 终端为例。
2. 安装 REA 并检查连接
已有可用 REA 的机器只需运行最后两个检查命令。MCP 自检应返回 healthy: true。REA 是独立工具,本仓库提供工作区与客户端配置,不包含 REA 程序和反编译引擎。
3. 确认客户端配置
仓库已经包含 REA 的项目配置,克隆后无需手动新建配置文件:
选择一个客户端即可。在工作区根目录启动它,按客户端提示信任项目/启用项目 MCP,再通过 /mcp 确认 rea 连接。已打开的客户端需要重启或开启新会话加载配置。详细配置和 PATH 排查见下方「REA 接入」。
4. 导入目标
可以直接把克隆目录作为第一个目标的工作区。也可以保留它作为干净模板,先创建独立工作区(目标路径必须不存在):
new 不复制 .git、旧样本或分析结果;创建出来的目录没有指向本模板仓库的 Git remote。
填写 notes/SCOPE.md 中的目标、分析授权和本轮问题,导入一份已整理好的样本:
也可以导入一个源码目录。脚本只复制样本,不运行它;生成 SHA-256 基线并将导入文件设为 0444。stage 生成可写的 work/input/,不会覆盖已有分析。一次导入一个目标;多个相关样本先放入工作区外的同一个目录再导入。不要把原始 HAR、凭据文件或无关数据一并导入。
5. 开始分析
源码用 01-map-repo.md,其他类型见下表。每轮结束运行 python3 scripts/workspace.py verify,按 07-handoff.md 收尾。安装了 Make 时也可以用 make verify、make stage、make doctor 这些快捷命令。
目录
target/、work/、原始工具输出及摘要基线已被 Git 忽略。笔记可能包含业务信息,提交或分享前自行检查。新工作区只复制干净笔记模板,不复制旧目标及分析结果。
REA 接入
需要 Python 3.11+、Node.js 和 REA。当前验证环境为 Node 24.18.0、REA 6.4.0、Python 3.12.7。按 REA 官方要求,Node 支持 22.19+ 的 22.x、24.11+ 的 24.x 或 26+。
配置中没有 API Key,不会覆盖你的模型或登录方式。安装 REA 后,仓库内的配置即提供项目级 MCP 接入。
Codex 的 .codex/config.toml:
Quoting 47% of the README. Read the rest on GitHub ↗
Read from the repository's git tree on 2026-08-17.