前言¶

给 DSH 智能体做接口安全测试时，手工验证越权或逻辑漏洞最贵的两步，不是「发一个包」，而是构造对照请求、再判定响应差异。rannyrjjy/dsh-fuzz 把这两步自动化：它在 diffprobe 包引擎之上做差分 fuzz 与逻辑测试，流程固定为抽值 → 计划 → 执行 → 判定，默认只读。下面介绍它的能力、安装方式和用法。

这是什么¶

插件维护者是 rannyrjjy，GitHub 1 stars，社区目录分类为工作流。插件只注册一个 DSH Host 工具 fuzz，负责参数映射与子进程编排；所有请求始终由 engine/diffprobe 执行，没有第二个请求引擎。计划、种子、原始请求与响应都落盘，不进入对话历史。

它坚持三条判定纪律：

1. 基线可比：每条 payload 都带 baseline 与同类型对照，避免把「长度不同」当成洞。
2. 差异不等于漏洞：区分传输层差异、错误分支（errorCode/errorMsg）与真正值得回读的状态或数据变化（ownerId/role/status/amount 等）。
3. 可复核：run 产出 diffs.csv，verify 产出 state.csv，verdict 只做分类，证据留在工作区。

注意事项：该插件仅用于已授权的渗透测试、CTF/靶场和自有系统评估。

环境要求¶

- Node.js 22.19+（或 24+）
- Python 3.9+，python / python3 在 PATH 中
- DeepSeek Harness（支持 bundle 插件 / Host 工具）

插件是纯 JS + Python，无构建步骤。

安装与启用¶

# --profile 是必填项：把 <profile> 换成你的 profile 名（桌面版通常为 desktop）
# 1) 从 GitHub 安装（公开仓库）
dsh plugin --profile <profile> add github:rannyrjjy/dsh-fuzz

# 2) 本地安装（git clone / 解压后，把 <plugin-dir> 换成绝对路径）
dsh plugin --profile <profile> add file:<plugin-dir>

本地路径写法随平台：Windows 用 file:D:\tools\dsh-fuzz，macOS/Linux 用 file:/opt/dsh-fuzz。安装后重启 DeepSeek Harness（或让插件管理器重载 profile），工具列表会出现 fuzz。

更新：

dsh plugin --profile <profile> update dsh-fuzz
# 或 remove 后重新 add
dsh plugin --profile <profile> remove dsh-fuzz
dsh plugin --profile <profile> add github:rannyrjjy/dsh-fuzz

配置¶

默认值在 index.js 里解析，不配置也能用。需要覆盖时，在 DSH patch 层加一段 dsh-fuzz：

- insert:
    - id: dsh-fuzz
      name: dsh-fuzz
      config:
        workspaceDir: /path/to/workspace   # 建议显式配置：证据、@file、diffprobe cwd 的根
        pythonPath: python3                # Windows 上默认 python
        evidenceRoot: evidence             # 证据目录名，默认「漏洞记录」
        timeoutMs: 300000

Windows 路径写 C:/work/pentest 或 C:\\work\\pentest 均可。

引擎也接受环境变量（插件会自动注入前三个）：

fuzz 工具¶

插件只暴露一个工具，六个 action：

plan kind¶

判定口径¶

差分再按「变了什么」分级：state-or-data（ownerId/userId/role/status/amount 等）值得扩大样本；error-channel（只变 errorCode/errorMsg）只是错误分支或防护层，不要当洞。

典型用法¶

Windows 用 python，macOS/Linux 用 python3。在仓库根目录执行三步离线自检（示例 spec 不含真实目标，不联网、不发包）：

# 1) 环境自检
python engine/fuzz/fuzz_ops.py --spec examples/doctor.json

# 2) 从示例回包抽值（不联网）
python engine/fuzz/fuzz_ops.py --spec examples/harvest.json

# 3) 生成 idor 计划并 dry-run（不联网、不发包）
python engine/fuzz/fuzz_ops.py --spec examples/plan-idor.json

引擎另有离线自检服务，只监听 127.0.0.1，用来验证差分判定逻辑本身，不产生外网请求：

python engine/diffprobe/selftest_server.py

目录结构¶

dsh-fuzz/
├─ index.js                  # DSH 插件：注册 fuzz 工具，转发到引擎
├─ cordis.patch.yml          # bundle patch（一行 insert）
├─ engine/
│  ├─ fuzz/                  # fuzz_ops.py（计划/执行/判定）、fuzz_verify.py（状态回读）、bench_verdict.py（判定回归）
│  ├─ diffprobe/             # 请求执行引擎：限速、破坏性载荷闸门、差分与语义比对
│  └─ payloadsets/           # 共享载荷集（sqli/xss/idor/logic_*/fuzz_params 等）
├─ examples/                 # 不含真实目标的示例 spec
└─ locale/                   # 插件标题与描述

适用场景与注意¶

适合需要在已授权环境里对 API 做越权、逻辑漏洞差分验证的 DSH 开发者和安全测试流程。三点要注意：

1. 默认只读：POST/PUT/PATCH/DELETE 必须显式 allowWrite: true。破坏性载荷拒绝、限速、命中防护即停全部由 diffprobe 执行，计划层不能绕过。
2. 证据落盘在 <workspace>/<evidenceRoot>/<target>/evidence/fuzz/ 或 <workspace>/.dsh-fuzz/runs/；靶标鉴权材料（Cookie/Token）只出现在你传入的原始请求里，插件不做持久化。
3. 已知限制：race 并发与 state 状态机生成尚未实现（schema 已留位），当前 run 会跳过 kind=race 计划；verify 是「一批跑完再回读」，对单值计划有效，连续写 payload 是累计状态，需要逐 payload 隔离时请拆计划。

插件以当前 dsh 进程权限运行，安装前应检查插件源码与许可证（MIT）。当前版本为 0.1.2，要求 DSH >=0.2.0-rc.2 || >=0.2.1-rc.2 || >=0.2.2-rc.1。

目录页与源码：

• 社区目录：https://www.skillhub.cn/plugins/rannyrjjy/dsh-fuzz
• GitHub：https://github.com/rannyrjjy/dsh-fuzz