dsh-rea-dispatcher

DeepSeek Harness 插件。把 REA（逆向 MCP 服务，npm 包 rea-agents，后端 Ghidra、Hopper、IDA）的 207 个工具折叠成 3 条命令，另有 6 个只读域入口。常驻约 5 KB，直挂约 757 KB。

体积

接入方式	工具数	进入上下文	折算 token
直接挂载 REA	207	775,016 B	约 19 万至 22 万
本插件（默认）	9	3,404 字符 / 5,322 B	约 1.3 K
本插件（domainTools: false）	3	1,481 字符 / 2,213 B	可忽略

数字按 {name, description, parameters} 序列化后计算，字符数与 UTF-8 字节数分开给。 离线复算：node test/ab-surface.mjs（用 test/fixtures/ 里的目录快照，不需要装 REA）；B 侧数字是宿主编译产物，装了宿主包才会打印。

工具

工具	作用
rea_tools	列工具名与标题，按域分组，支持 filter
rea_help	单个工具的必填项、已知陷阱、参数 schema
rea_call	调用工具，参数原样透传
rea_native rea_web rea_apk rea_mobile rea_firmware rea_general	只读域清单，只列本域工具

域入口只列名字，不执行。执行一律走 rea_call。

安装

先自备依赖，插件不代装引擎。

依赖	用途
DSH	宿主
Node.js 22 或 24	运行 REA 的 MCP 入口
rea-agents	提供 207 个逆向工具
Ghidra 12.1.x 与 JDK 21	供需要引擎的工具使用

npm i -g rea-agents
dsh plugin --profile <profile> add github:HarunaTyan/dsh-rea-dispatcher

装好后在市场启用，或由 AI 侧调用 plugin_manager set_bundle dsh-rea-dispatcher enabled=true，无需重启。dsh --profile <profile> --dump-config 里出现 - id: rea-dispatcher 即生效。

引擎路径默认读 GHIDRA_INSTALL_DIR 与 JAVA_HOME。没配也能加载并列目录，只有用到引擎的工具会报 REA 自己的错。缺 rea-agents 时返回可直接执行的安装提示。

宿主版本区间 >=0.2.1-rc.1 <0.3.0-0；0.2.2-rc.x 这类后续预发布不在区间内，需要时发版扩区间。

使用

这些工具由会话里的 AI 调用，不需要手敲。

rea_tools filter=image
rea_native filter=procedure
rea_help name=inspect_native_load_image
rea_call name=inspect_native_load_image arguments={"path":"C:/target/app.exe"}

rea_help 开头就是必填项与高代价陷阱：

# procedure_pseudo_code
必填：procedure
⚠️ `0x…` 若不是函数入口会退化成 file offset；先 procedure_info 拿入口再调用

REA 的错误原样返回，只在首行标注来源。REA 会话不跨轮：上一轮 open_binary 成功，下一轮仍可能报 No app is open。插件默认自动重开并重试一次，输出里会标注；autoReopen: false 关掉。

返回超过 maxBytes 时截断，全文落盘并在尾部给出路径与行数，可用 ops_read_files 或 ops_grep 分段读。

配置

默认值都由环境派生，包内不含机器路径。覆盖写在 profile 的 cordis.patch.yml，entry id 是 rea-dispatcher。

- id: rea-dispatcher
  config:
    cwdAllow: ['D:/re-projects']
    ghidraDir: "D:/tools/ghidra_12.1.4_PUBLIC"
    javaHome: "D:/tools/JDK21"
    callTimeoutMs: 600000
    maxBytes: 40000

patch 里的 config 是整体替换，不是深合并；覆盖时要把用到的键一次写全。

键	作用	默认
reaMjs	scripts/rea.mjs 路径	自动探测
ghidraDir	注入 GHIDRA_INSTALL_DIR	同名环境变量
javaHome	注入 JAVA_HOME，并把其 bin 前置到 PATH	同名环境变量
cwdAllow	会话目录白名单	[]，不限制
maxBytes	单次返回上限	20000
autoReopen	掉线自动重开一次	true
spill	超限时落盘全文	true
domainTools	是否注册 6 个域入口	true
domainLimit	域清单条数上限	40
helpMaxChars	rea_help 返回上限	12000
callTimeoutMs	单次调用超时	300000
listTimeoutMs	握手与列目录超时	120000

边界

cwdAllow 只约束会话目录

• 空数组不限制。非空时按路径段比较，/re/proj2 不会被 /re/proj 放行，比较前折叠 . 与 ..，Windows 忽略大小写。
• 取不到会话目录时拒绝。
• 它不约束 rea_call 参数里的路径。要更硬的隔离，把 REA 子进程放进受限账户或沙箱。

适合与不适合

• 适合单点可验证的查询（伪代码、交叉引用、字符串、导入导出表）与逐步缩小范围的探索。
• 不适合长时间维持同一二进制状态的深挖，超时会丢子进程；也不适合全量枚举。

REA 侧限制

• Windows 上只吃 native PE 与 raw 6502。ELF 能 open_binary，深分析会被四个 provider 全拒，报 target_format_unsupported；打开成功不等于可分析。
• 不带符号。同目录 PDB 不会被导入，函数仍显示为 FUN_1400xxxxx，要符号得本地跑 analyzeHeadless。

排错

现象	处理
未找到 rea-agents 的 MCP 入口	npm i -g rea-agents，或配 reaMjs / REA_MJS
当前目录未授权	会话目录不在 cwdAllow 里，调整配置或在允许目录开会话
target_format_unsupported	目标格式不支持，见上面 REA 侧限制
capability_unavailable	缺外部工具，例如 tshark

开发与反馈

测试脚本在仓库里，npm 包不含 test/。

git clone https://github.com/HarunaTyan/dsh-rea-dispatcher && cd dsh-rea-dispatcher
node test/resolver.mjs
node test/smoke.mjs
node test/ab-surface.mjs
node test/start-failure.mjs

问题提到 Issues，附 DSH 版本、rea-agents 版本与报错原文。个人维护，按优先级尽力修复。

许可

MIT。与 REA、Ghidra、DSH 等项目无隶属关系。