dsh-red-team

一句话：8 个 red_* 工具把 PTES 流程的侦察/枚举/指纹/攻击面评估段做成结构化工具面——子域枚举、目录枚举、链接爬取、技术栈指纹、banner 抓取、安全响应头检测、敏感路径探测、CVE 匹配。

为什么值得用：单次 fetch 拿到的东西和「一次可复盘的侦察」差在过滤依据。手动跑一遍目录枚举，你只看到命中列表——看不到「扫了多少条、丢了多少、按什么丢的」；目标站是 SPA 时更会全 200 误报。本插件每次调用落一行轨迹，把 raw / kept / dropped / reasons 全部写下来，并用响应体特征（而不是状态码）判真泄露，把误报与假阴性压到可解释的程度。

能力

快速开始

1) 装依赖（自研插件家园 self-plugins/，在目标 profile 的 package.json 加 link 依赖）：

"dsh-red-team": "link:<工作区>/self-plugins/dsh-red-team"

2) 挂组合（agent 预设行）：

- insert:
    - id: agent-red-team
      name: dsh-red-team
      config:
        enabled: true

3) 30 秒验证：对一个自己搭建的靶场或本机服务调用一次

red_tech_fingerprint url="http://127.0.0.1:8080/"

期望：返回 {ok:true, ...} 且技术栈字段为数组/字符串；同时 tail -3 "$DSH_HOME/redteam-trace.jsonl" 应看到新增一行 scan/start 与一行 scan/end（含 tool / target / stats / durationMs）。不要拿公网第三方站点做首次验证——先用本机目标确认接线。

配置

本插件无 Config 之外的任何外部状态：不读缓存、不持凭据、不写插件目录。

落盘与自证（出问题时先看这里）

唯一持久产物：<DSH_HOME>/redteam-trace.jsonl（append-only，一行一阶段，无轮转；DSH_HOME 缺省 ~/.dsh）。

一条命令答五问：

tail -3 "$DSH_HOME/redteam-trace.jsonl"
# ① 线上跑的是哪个构建 → build = "<版本>@<模块 mtime ms>"（boot 行还带 cfg.enabled / cfg.tools，可判「挂的是哪几个工具」）
# ② 谁发起 / 打向谁     → tool + target（已脱敏）+ pid
# ③ 断在哪一段         → phase 枚举；scan/error 行的 failure 直接给出失败类别（dns/timeout/refused/http-4xx…）
# ④ 结果质量           → raw（扫描条数）vs hits（保留条数）vs stats.dropped + stats.reasons（按什么丢的）
# ⑤ 耗时与预算         → durationMs（每次调用实耗，配合工具自身 timeout 判网络超时占比）

隐私红线：target 先脱敏（URL userinfo、键名像凭据的 query 参数、用户主目录前缀折叠为 <home>），只记目标与计数、绝不记响应正文（页面/banner 正文可能含他人数据与凭据）。观测绝不反噬：全部 IO 失败吞错返回 false，扫描行为不受影响（有接线级尸体测试）。

生效判据与回退

生效判据（三选一）：

1. 行为级：8 个 red_* 工具在工具面可调用，非法入参被拒（domain 非法 → domain 格式无效；url 非 http(s) → url 必须是 http(s):// 开头；port 越界 → port 无效）；
2. 轨迹级：tail -1 "$DSH_HOME/redteam-trace.jsonl" 的 build 里 mtime 等于 lib/index.js（或 lib/trace.js）的 mtime ⇒ 进程在跑当前构建；
3. 生态级：plugin_boot_status（dsh-plugin-bootreport）的 live 含 dsh-red-team ⇒ 同上（机器化版本）。

注意：重新构建 ≠ 生效——产物 mtime 新只证明「构建过」，进程启动时间必须晚于产物 mtime 才算「在跑它」。缺这一条时不得宣称「已生效」。

回退：

• 源码级：git -C self-plugins/dsh-red-team revert <commit> → 重新构建 → 预检 → 重启；
• 组合级：预设里给 agent-red-team 行加 disabled: true（或移除该行）→ 哨兵重启；
• 运行期：无需回退（无持久业务状态；设置 DSH_REDTEAM_TRACE=0 可即时停掉轨迹写入，<DSH_HOME>/redteam-trace.jsonl 可随时删除）。

测试

npm test        # = node --test "tests/*.test.mjs"（跑 lib/ 产物，与运行时同源）

43 例离线测试（Windows 侧 43/43 通过）：

• tests/pure.test.mjs（20 例）——纯函数层：框架特征 19 条且正则大小写不敏感、安全头 7 项 present+missing 恒等、目录字典含高价值路径、404/0 不算存在、CVE 按 CVSS 降序、同源判定按 URL.origin 精确比较（不同端口 / a.com.evil.com 这类前缀形似域必须被排除）、crt.sh 名单清洗（apex 不算子域）、脏数据保守返回；
• tests/trace.test.mjs（23 例）——轨迹层：路径解析与构建自报、目标脱敏、失败分类、序列化键序稳定、坏行跳过，以及三条尸体测试（父路径是普通文件 → 返回 false 且不抛；DSH_HOME 不可写 → 工具照常返回；含凭据的目标 → 落盘行里搜不到凭据串）。

无需网络、无需真实目标、无需 WSL：用例全程桩化，不发起任何真实扫描。离线单测不需要出网，也不需要对任何目标有授权——这是刻意的：测试不得把 CI 变成扫描器。

平台注记（诚实披露）：在 WSL/POSIX 下跑会出现 42 pass / 1 fail——失败例是 tests/trace.test.mjs 的 selfBuild（用例把 import.meta.url 的 pathname 做 .replace(/^\//,'') 以剥掉 Windows 盘符前的斜杠，在 /mnt/... 这类 POSIX 路径下会把根斜杠也剥掉，读不到 package.json，于是期望 '' 而实际 '0.1.1'）。这是测试代码的路径假设问题，不是插件行为问题；部署目标为 Windows，故按 43/43 记。修复属源码/测试改动，不在本次文档任务范围内。

设计要点

• 存在判据不用状态码单值：目录探测把 404 与连接失败（status 0）都不算「存在」；敏感路径则进一步看响应体特征（.git/HEAD 体以 ref: 开头、.env 体含 KEY|SECRET|PASS|TOKEN）才判真泄露——这是对抗 SPA 全 200 误报的关键，改动探测逻辑时不得退回纯状态码判定。
• 同源过滤是安全语义：链接爬取曾用 href.startsWith(base.origin) 前缀比较，会把 https://a.com:8443/x 与 https://a.com.evil.com/x 误当同源；现在按 URL.origin 精确比较。这类缺陷在结果里看不出来，所以过滤依据必须落进 stats.reasons。
• 失败分类可 grep：网络层失败被归一到 dns / refused / timeout / network 等固定枚举——排障时 grep '"failure":"dns"' 比读长错误串快。
• 能力 ≠ 沙箱：本插件无法校验目标是否获授权。选择不加技术门禁（可被绕过，属伪安全），改为文档 + 调用者硬约束；如需显式开关，方向是 config.allowHosts 白名单（默认关闭，见 docs/semantic.md §10 U5）。
• 失败态与「不存在」合并是已知假阴性风险：目录枚举对超时/网络错误静默跳过，输出与「探测过且不存在」同形（§10 U2/U8）——结论里不要把这二者当同一件事。
• 零 npm 运行时依赖：全部走 Node 原生 fetch/net，无外部进程（banner 抓取走 node:net TCP，不调 nmap/nc）。

合规红线（硬性）

• 仅用于自有 / 明确授权的系统与开源靶场；
• 不触碰未经授权的第三方系统；
• 本插件为侦察/攻击面评估性质，不含破坏性利用载荷（利用与武器化不在本插件职责内）；
• 首次验证请对 127.0.0.1 或自建靶场进行。

相关文档

License

MIT © jonah791

本插件属于我的数字生命爱丽丝（alice-digital-life）的 DSH 自研插件生态——50 个插件按生命/认知/感知/行动/通信/治理/呈现七层组织。