dsh-fuzz
DeepSeek Harness 插件：在 diffprobe 之上做差分 fuzz 与逻辑测试的「抽值 → 计划 → 执行 → 判定」。
插件只提供 DSH Host 工具 fuzz 和一层参数映射；发包始终由 diffprobe 执行，没有第二个请求引擎。
计划、种子、原始请求/响应都落在磁盘，不进对话。
仅用于已授权的渗透测试、CTF/靶场和自有系统评估。默认只读，写方法需要显式 allowWrite。
它解决什么
手工测越权/逻辑漏洞时，最贵的是「构造对照请求 + 判定响应差异」这两步，而不是发一个包。
这个插件把这两步自动化，并且坚持三条纪律：
- 基线可比：每条 payload 都带 baseline 与同类型对照，避免「长度不同就是洞」。
- 差异不等于漏洞：判定区分传输层差异、错误分支（
errorCode/errorMsg）和真正值得回读的状态/数据变化（ownerId/role/status/amount/...）。
- 可复核：
run 产出 diffs.csv，verify 产出 state.csv，verdict 只做分类，证据留在工作区。
安装
插件本身是纯 JS + Python，无构建步骤。任选一种：
# 1) 从 GitHub 安装（把 <you> 换成你的账号）
dsh plugin --profile desktop add github:<you>/dsh-fuzz
# 2) 从本地目录安装（绝对路径；解压 zip 后用这个）
dsh plugin --profile desktop add file:C:/path/to/dsh-fuzz
安装后重启 DeepSeek Harness（或让插件管理器重载 profile），工具列表会出现 fuzz。
环境要求：Node.js 22.19+ / 24+，Python 3.9+（python 或 python3 在 PATH 中）。
配置
默认值都在 index.js 里解析；如需覆盖，在自己的 patch 层里给 dsh-fuzz 行加 config：
- insert:
- id: dsh-fuzz
name: dsh-fuzz
config:
workspaceDir: 'D:\work\pentest' # 证据与 @相对路径的根
pythonPath: python3
enginePath: 'C:/tools/dsh-fuzz/engine/fuzz/fuzz_ops.py'
evidenceRoot: 漏洞记录
timeoutMs: 300000
| 键 | 默认 | 说明 |
|---|
workspaceDir | Host 当前目录（或 DSH_FUZZ_WORKSPACE） | 工作区根；@file 相对路径、diffprobe 的 cwd、证据目录都基于它。建议显式配置 |
pythonPath | python（Windows）/ python3 | Python 解释器 |
enginePath | <插件目录>/engine/fuzz/fuzz_ops.py | 引擎入口，可指向工作区里的另一份引擎 |
evidenceRoot | 漏洞记录 | 证据目录名，位于 workspaceDir 下 |
timeoutMs | 300000 | 单次子进程超时 |
引擎也接受环境变量（插件会自动注入前三个）：
| 变量 | 作用 |
|---|
DSH_FUZZ_WORKSPACE | 同 workspaceDir |
DSH_FUZZ_EVIDENCE_DIR | 同 evidenceRoot |
DSH_FUZZ_STATE | plans/seeds/runs 的落盘位置，默认 <workspace>/.dsh-fuzz |
DSH_FUZZ_ENGINE | 含 diffprobe/ 与 payloadsets/ 的引擎根 |
fuzz 工具
| action | 做什么 | 是否发包 |
|---|
harvest | 从回包抽带类型的值（id/uuid/phone/token/email/金额…）与字段名，生成 seeds.json | 否 |
plan | 生成 diffprobe 计划（见下表 kind），带 baseline + 同类型对照，可选 verify | 否（dryRun 仅校验） |
run | 调 diffprobe 执行计划，限速、命中 403/429/503 即停；写方法需 allowWrite | 是 |
verdict | 读 diffs.csv/state.csv 分类：DIFFERENTIAL / BLOCKED / INVALID / STATE_CHANGED / NO_SIGNAL | 否 |
doctor | 检查 Python、引擎、payloadsets 是否齐备 | 否 |
bizmap | 读写 <evidence>/<target>/fuzz-bizmap.json 目标业务地图 | 否 |
plan kind
| kind | 用途 |
|---|
chain | 把别的接口返回值移植到目标参数位（BOLA/引用链） |
idor | 邻号/对照/他人 ID，配 verify 回读 owner 字段 |
massassign | JSON body 追加 role/isAdmin/tenantId/...，回读是否持久化 |
role / tenant / amount | 角色、租户、金额字段候选 |
param | 追加隐藏参数名 |
bypass | 路径段归一化绕过（%61dmin、admin/、admin/..;/、..%2f…） |
sqli xss ssrf lfi ssti cmdi xxe | 复用 engine/payloadsets/ 的经典类载荷 |
判定口径
| 类别 | 含义 |
|---|
DIFFERENTIAL | 引擎判差分，或语义层判 DIFF |
INVALID | 基线自身不可达——结论是无效，不是「无差分」 |
BLOCKED | 命中防护（403/429/503 等） |
STATE_CHANGED | verify 回读的 JSON path 真的变了 |
NO_SIGNAL | 其余 |
差分再按「变了什么」分级：state-or-data（ownerId/userId/role/status/amount/...）值得扩大样本；
error-channel（只变 errorCode/errorMsg）只是错误分支或防护层，不要当洞。
快速开始（离线）
# 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/ # 插件标题与描述
安全边界
- 默认只读：
POST/PUT/PATCH/DELETE 必须 allowWrite: true。
- 破坏性载荷拒绝、限速、命中防护即停，全部由 diffprobe 执行，计划层不能绕过。
- 原始请求/响应只落
<workspace>/<evidenceRoot>/<target>/evidence/fuzz/ 或 <workspace>/.dsh-fuzz/runs/。
race 并发与 state 状态机生成尚未实现（schema 已留位），当前 run 会跳过 kind=race 计划。verify 是「一批跑完再回读」，对单值计划有效；连续写 payload 是累计状态，需要逐 payload 隔离时请拆计划。- 靶标鉴权材料（Cookie/Token）只出现在你传入的原始请求里，插件不做持久化；示例文件使用
REDACTED。
License
MIT，见 LICENSE。
