逆向分析工具包 axyatech/rea-harness-plugin

REA for DeepSeek Harness

Reverse Engineer Anything, inside DeepSeek Harness.
一个可安装的插件：REA 的 MCP 服务器、它的工作流技能，以及左侧边栏里一块实时就绪面板。

面板预览：连接状态、工作流版本、引擎审计、工具数量，一眼看全。

REA 给智能体一套工具，用来检查二进制文件、应用程序、软件包和页面，并给出每个结论背后的证据。这个插件让你直接在 Harness 里装上这套体验：

- 不用手写 MCP 配置。 一行 bundle 记录就能启动 REA 的 MCP 服务器。
- 不用单独配置技能。 插件会把 reverse-engineer-anything 加进智能体的技能目录。
- 不用维护启动器路径。 固定版本的 REA 包通过 npx 拉取并缓存。
- 有看得见的控制面板。 侧边栏面板实时显示工具数量、工作流版本、引擎就绪状态，还有可搜索的工具目录。

目录

- 安装
- 快速开始
- 你会得到什么
- 架构
- 工具目录
- 兼容性
- 配置
- 安全与隐私
- 故障排查
- 开发
- 分发与目录
- 路线图
- 参与贡献
- 许可证与致谢

安装

方式 A — npm（推荐）

插件以 @axyatech/dsh-plugin-rea 发布。

Settings → Plugins → Add plugin → 粘贴包名：

@axyatech/dsh-plugin-rea

需要可复现时，锁定具体版本：

@axyatech/dsh-plugin-rea@1.1.0

在智能体里，或通过 plugin_manager 工具：

plugin_manager action=install_bundle target=@axyatech/dsh-plugin-rea

方案 B — 发现

只需做一次：

1. 在 Experimental plugins 旁边点 Plugins → More → 启用 Custom plugin markets。
2. 打开新增的 Discover 标签页 → Add index source。
3. 粘贴以下索引 URL：

https://raw.githubusercontent.com/axyatech/rea-harness-plugin/main/market/index.json

随后 REA for DeepSeek Harness 会作为可搜索的市场条目出现，版本、兼容性和安装目标都从索引中读取。选中它并安装。

DSH 不自带官方第三方市场；Discover 只列出你添加的索引。本仓库发布自己的 format-1 索引，解析后指向 npm 发布版本。

方案 C — Git 仓库

Settings → Plugins → Add plugin → 选择 Git repository 选项 → 粘贴：

https://github.com/axyatech/rea-harness-plugin.git

或者从智能体安装同一个 Git 源：

plugin_manager action=install_bundle target=https://github.com/axyatech/rea-harness-plugin.git

方案 D — 克隆并链接

git clone https://github.com/axyatech/rea-harness-plugin.git
plugin_manager action=install_bundle target=/absolute/path/to/rea-harness-plugin

安装之后

安装包立即生效。刷新一次 Harness 页面；新会话会加载工作流技能。如果 MCP 服务器首次打开时报告零个工具，等 npx 下载完成，然后按 Refresh。

当前 npm 发布版本是 @axyatech/dsh-plugin-rea@1.1.0；发布与来源细节见 Distribution。

快速开始

在新会话中提问：

Explain how search works in this shipped app, and show the evidence.

Compare two builds of this Electron app and list the behavior that changed.

Decompile this .NET method and reconstruct the interface it implements.

REA 技能会教智能体何时以及如何使用这套工具。开始深度调查之前，面板会确认服务器、技能和引擎都已就绪。

你会得到什么

| 组件 | 行为 |
| MCP 服务器 | npx -y rea-agents@6.8.0 mcp；工具以 mcp__rea__ 形式暴露（6.8.0 中共 229 个工具）。 |
| 工作流技能 | reverse-engineer-anything，注册在每个智能体自己的层上，因此优先级高于过期的用户副本，同时项目本地技能仍然优先。 |
| 侧边栏入口 | REA 图标打开面板：连接、包、技能版本、引擎审计、工具搜索、快捷提示词和命令。 |
| 状态端点 | GET /plugins/rea/status 返回实时工具清单，外加缓存的 rea doctor 审计结果。 |
| 跨平台 Host 半部 | 纯 ESM，无运行时依赖；CI 在 macOS、Linux 和 Windows 上测试。 |

架构

flowchart LR
subgraph Harness["DeepSeek Harness"]
A[Agent] -->|mcp__rea__| M[MCP client]
P[REA panel] -->|GET /plugins/rea/status| H[Host half]mermaid
H -->|tool inventory| T[Tool registry]
H -->|rea doctor| C[REA CLI]
H -->|skill provider| S[Skill registry]
A -->|loads skill| S
end

M -->|stdio| R[REA MCP server]
R --> E[Hopper · Ghidra · IDA · JADX · Kuna]
R --> F[Local binaries, apps, packages, pages]
C --> E

H -.->|reads| N[rea-agents package]
P -.->|renders| U[User]

面板从不直接连 REA 服务器，而是读取 Host 路由。Host 这一半基于可选服务，所以在没有 Web 服务器或技能注册表的 Harness 里，它保持静默。不会往磁盘写任何东西。

工具目录

REA 6.8.0 提供 229 个工具。面板让它们可搜索，同一份列表也以 mcp__rea__ 命名空间提供给智能体。

几个常用入口：

| 工具 | 用途 |
| open_binary | 打开可执行文件、归档、JavaScript bundle 或分析数据库。 |
| analyze_function | 生成完整的函数档案，含伪代码、汇编、调用和引用。 |
| analyze_javascript_application | 不执行代码，直接还原 Electron 或 JavaScript 应用。 |
| inspect_managed_members | 不加载程序集，直接解码 .NET 元数据、CIL 锚点和签名。 |
| inspect_artifact | 清点包、APK、IPA、DMG、ASAR 或归档，给出哈希和下一步探测建议。 |
| capture_browser_scenario | 跑一个有边界的浏览器场景，返回证据。 |

兼容性

| 层面 | 支持范围 | 状态 |
| DSH | 0.2.x（engines.dsh: >=0.2.1-rc.3 <0.3.0-0） | 已在 0.2.1-rc.3（macOS）上实测通过 |
| npm | @axyatech/dsh-plugin-rea@1.1.0 | 已发布，MIT，公开访问 |
| Node.js | REA 6.8.0 engines：^22.23.4 \|\| ^24.22.1 \|\| >=26.12.1 | npx 启动 MCP 时需要 |
| macOS | macOS 12+ | 已实测通过（arm64，Web GUI） |
| Linux | Host 逻辑已过 CI 测试 | 完整 DSH + REA 运行时尚未验证；REA 需要 procps |
| Windows | Host 逻辑已过 CI 测试 | 完整 DSH + REA 运行时尚未验证 |
| Web GUI | Harness Web | 已验证 |
| Electron file:// shell | 未验证 | 请用 Web GUI |

CI 在 Ubuntu、macOS 和 Windows 上跑 Host 测试套件，覆盖 Node 22、24 和 26。套件测的是状态路由、回环守卫、home 路径脱敏、doctor 解析和技能服务商，不需要 DSH 或 REA。

REA 的分析引擎都是可选的：

- Hopper 在 macOS 的标准位置自动检测。
- Ghidra 需要 GHIDRA_INSTALL_DIR 和 JDK 21+。
- IDA、JADX、apktool、ADB、WABT、TShark、Kuna，以及 Web 场景用的浏览器，都通过 REA 的 REA_ 变量配置，详见安装指南。
- 静态 JavaScript/Electron、.NET、artifact、SQLite、plist、entitlement、Go/Rust 和 WASM 分析无需原生引擎即可工作。

配置

bundle 中的行可以在你自己的 cordis.patch.yml 里覆盖（配置档补丁，或位于 ~/.dsh/cordis.patch.yml 的 home 补丁）。非插入式补丁会替换整个 config，所以你需要重写每个字段。

固定另一个 REA 版本，或添加引擎路径： yaml
- id: mcp-rea
name: "@deepseek-ai/dsh-mcp-client"
config:
serverName: rea
transport: stdio
command: npx
args: ["-y", "rea-agents@6.8.0", "mcp"]
toolCallTimeoutMs: 600000
failOnStartupError: false
env:
GHIDRA_INSTALL_DIR: /absolute/path/to/ghidra_12.1.4_PUBLIC
JAVA_HOME: /absolute/path/to/jdk-21

把机器相关的引擎路径放在本地补丁里，绝不要放进本仓库。

插件自身读取的环境变量：

| 变量 | 用途 |
| REA_ROOT | rea-agents 包的绝对路径，供审计和技能使用。 |
| REA_LAUNCHER | scripts/rea.mjs 启动器的绝对路径。 |
| REA_NODE | 审计使用的 Node 可执行文件（默认先找常见路径，再回退到 node）。 |
| REA_NPX | 审计回退时使用的 npm 启动器（默认 npx）。 |
| REA_INSTALL_ROOT | REA 安装器的状态目录（默认 ~/.local/share/rea）；其中的 environment.json 为审计提供引擎路径。 |

已经手动配置过 REA？

两行 MCP 的 serverName 相同，无法同时加载。先移除旧的注册：

- rea setup --client dsh 会往 ~/.dsh/cordis.patch.yml 写入一行 rea-mcp —— 删掉这一行。
- 配置档补丁里手写的 mcp-rea 插入 —— 换成上面的覆盖写法，这样既能保留你的引擎路径，又能指向 bundle 中的行。

安全与隐私

- 不存密钥，不写文件。 插件不存储任何内容，只读取本地 REA 文件来获取状态和发现技能。
- 状态接口仅限回环。 /plugins/rea/status 对所有非回环对端返回 403；它只响应 GET/HEAD，且不会把任何请求值用于命令或路径。
- 隐藏 home 路径。 返回的每个路径都会把你的 home 目录替换为 ~，包括 doctor 详情和修复提示文本。
- 无遥测。 唯一的网络访问是 npm 首次下载固定版本的 REA 包，以及你调用的本地 REA 工具本身。
- 无远程控制。 插件不开放自己的端口，不安装服务，也没有命令端点。

完整模型见 SECURITY.md，包括回环代理行为和供应链说明。

故障排查

| 现象 | 处理方式 |
| 面板显示 Offline 或工具数为零 | 确认 node 和 npx 在 Harness 的 PATH 中；在终端运行 npx -y rea-agents@6.8.0 doctor --format json；检查首次下载的网络访问；点击 Refresh。 |
| 更新或重命名这个 bundle 后出现 Failed to load plugins | 重启 DeepSeek Harness。浏览器启动图会在包重命名后缓存客户端模块 id；重启会重建它。 |
| 出现两个 rea MCP 服务器或启动报错 | 从 home 或配置档补丁里删掉旧的 rea-mcp/mcp-rea 注册。 |
| 从另一台机器访问状态路由返回 403 | 这是回环保护。用 SSH 隧道，或同机反向代理。 |
| 面板里出现 Node 引擎警告 | 把 Node 更新到 REA 支持的范围；服务器在范围外仍能跑，但审计会报告不匹配。 |
| 技能仍显示旧版本 | 新智能体会解析对齐后的副本；重启 Harness，让已有会话重新解析。项目本地技能有意优先。 |
| MCP 只在 Windows 上失败 | 确保 PATH 上有带 npx.cmd 的 Node 发行版；Host 那一半有 CI 测试，DSH MCP 启动路径在 Windows 上尚未做运行时验证。 |

开发

没有构建步骤。这个包就是纯 ESM 加一个浏览器模块。
bash
npm test # node --test: route, redaction, loopback, doctor, skill provider
npm run check # node --check for both halves
npm pack --dry-run

CI 在以下环境跑同一套流程：

- Ubuntu、macOS 和 Windows
- Node 22、24 和 26

docs/assets/ 下的预览图由 docs/preview/ 里的自包含页面渲染而来： bash
chrome --headless=new --hide-scrollbars --force-device-scale-factor=2 \
--window-size=1200,810 --screenshot=docs/assets/panel.png \
file://$PWD/docs/preview/panel.html

分发与目录

DSH 的 Discover 标签页没有官方第三方目录：它只显示用户自己添加的 format-1 索引。所以这个仓库自带一份索引： text market/index.json

索引按 DSH 的 dsh-plugin-market-index 格式校验，每个版本都锁定到不可变的 npm 版本。添加一次原始索引 URL，插件就能在 Discover 里被发现和安装。索引条目还带有 engines.dsh 兼容范围，不兼容的 Harness 版本会在安装前被标记出来。

插件以 @axyatech/dsh-plugin-rea 发布到 npm（当前版本：1.1.0，MIT，private: false，公开访问）。验证已发布版本： bash
npm view @axyatech/dsh-plugin-rea version

不带作用域的 dsh-plugin-rea 名字属于另一个发布者，这里有意不用。

发布版本

维护者流程：

1. 更新 package.json 和 CHANGELOG.md；运行 npm test。
2. 认证并发布：

bash
npm login
npm whoami
npm publish --access public

3. 把 market/index.json 更新到新版本和 publishTimestamp，然后提交并推送。

prepublishOnly 会在构建 tarball 前跑测试套件。包名、版本、许可证、仓库和 files 允许列表都已就绪。

标签驱动发布 .github/workflows/release.yml 在 v 标签（或手动触发）时发布，使用 npm provenance 和仓库密钥 NPM_TOKEN： bash
git tag v1.1.0
git push origin v1.1.0

工作流会校验标签与 package.json 的版本是否一致，然后查询 registry。如果该版本已发布，就跳过发布步骤，直接以成功状态结束，所以给已发布的提交打标签是安全的。若是新版本，则需要 NPM_TOKEN（npm automation token，或对 @axyatech 有发布权限的 granular token），并以 --access public --provenance 发布。在 Settings → Secrets and variables → Actions 下添加该密钥。

路线图

- [x] 带作用域、可直接发布的包名
- [x] engines.dsh 0.2.x 兼容性检查
- [x] 跨平台测试套件和 9 格 CI 矩阵
- [x] 自托管 Discover 索引
- [x] 脱敏后的面板和工具目录预览
- [x] 仅限回环地址、隐藏主目录的状态路由
- [x] npm 发布（@axyatech/dsh-plugin-rea@1.1.0）
- [ ] 在 Linux 和 Windows 上用 DSH 做运行时验证
- [ ] 用签名的实时截图替换预览

贡献

欢迎提交 issue 和 pull request。改动请保持聚焦，运行 npm test，切勿提交机器路径、凭据，或含个人数据的验证截图。SECURITY.md 中的安全模型属于评审范围。

许可证与致谢

本插件采用 MIT 许可证（LICENSE）。内置的工作流技能复制自 rea-agents 6.8.0，同样采用 MIT 许可证（LICENSE-REA）；详见 NOTICE。

REA 由 morluto 创建。Hopper、Ghidra、IDA、JADX、Kuna 等分析引擎是独立项目，各有自己的许可证和条款。