众测渗透流水线 Vme18000yuan/dsh-plugin-cyber

dsh-plugin-cyber
本项目由CodeWork赞助 CodeWork 稳定靠谱AI中转站，deepseek,glm,qwen,kimi,minimax等国产模型，官方官方半价，gpt 0.08倍率，https://coding101.site

img

img

面向授权 SRC 测试 / 漏洞众测场景的 DeepSeek Harness (dsh) 插件包。它将两类能力挂载进 dsh 配置档（profile):

1. 817 个网络安全技能手册 —— 以隔离的包内技能提供者形式挂载，覆盖 Web 安全、API 安全、漏洞管理、渗透测试、数字取证、威胁狩猎等 40+ 个子域。
2. 一条渗透测试流水线 —— 信息收集 → 漏洞探测 → 人工/工具复现 → SRC 报告 四阶段编排：带授权范围门禁的信息收集与探测工具、带证据门禁的漏洞发现存储、中文 SRC 格式报告生成器、阶段状态机与 prompt 引导、哈希链式操作审计日志。

授权在这里是技术控制，不是免责声明。 所有联网工具在配置授权范围(scope.domains / scope.cidrs)之前拒绝执行任何操作——空范围 = 全部拒绝。请仅对你获得授权的资产使用本插件，并遵守所在 SRC/众测项目的操作规则与适用法律。

目录

- 工作原理
- 安装
- 配置授权范围(必填)
- 开始使用
- 工具清单
- 报告格式
- 审计与溯源
- 安全边界设计
- 配置项参考
- 常见问题
- 开发与测试
- 数据来源与许可证

工作原理

┌─────────────────────────────────────────────────────────────┐
│ dsh agent(由系统提示中的阶段指引驱动) │ │ │ │ recon ──────► detect ──────► triage ──────► report │ │ 资产清单 扫描命中=候选 复现验证 仅 confirmed │ │ │ │ │ 证据门禁:无 raw POC │ │ 不得标记 confirmed │ ├─────────────────────────────────────────────────────────────┤ │ 范围门禁:结构化工具硬校验(不可关闭) │ │ bash 命令绊线(deny / ask / off 三档) │ │ 审计链:每次工具调用、门禁决策、阶段流转 → SHA-256 哈希链 │ └─────────────────────────────────────────────────────────────┘

- 阶段状态机(flow.js）通过系统提示告诉 agent 当前阶段目标、推荐工具和应参考的技能子域；阶段流转需写明理由并记入审计链。技能手册本身保持原子文档形态，编排逻辑全部在插件侧。
- 证据门禁(findings.js）是本管线防误报的核心：扫描器命中只能登记为 candidate；只有附带原始 HTTP 请求(poc.rawRequest）和证明性响应(poc.observedResponse）的发现才能标记为 confirmed 并进入报告。
- 范围门禁(scope.js + gate.js)：结构化工具对每个目标做硬校验（域名后缀匹配、IPv4 CIDR、私网地址策略）;bash 工具经 tools/pre-execute 钩子做尽力而为的出域命令拦截。

安装

前置要求：Node.js ≥ 22.19、pnpm、本仓库旁的 deepseek-harness-master 源码检出。

cd deepseek-harness-master
pnpm dsh plugin --profile cyber add ../deepseek-harness-cyber
pnpm dsh --profile cyber --dump-config # 确认插件行已在配置树中

如需将当前本地检出安装到内置的 web profile，请在 deepseek-harness-master 目录执行，并将插件目录作为 add 后的最后一个参数：

cd deepseek-harness-master
pnpm dsh plugin --profile web add ../dsh-plugin-cyber-main
pnpm dsh --profile web --dump-config # 确认 dsh-plugin-cyber 已挂载

web profile 不存在时会自动初始化。如果插件检出目录名称不同，请将 ../dsh-plugin-cyber-main 替换为实际的相对路径或绝对路径。使用 web profile 时，后文配置文件路径中的 cyber 也应替换为 web。

扫描工具依赖外部二进制（缺失时工具会返回带安装提示的 FATAL / BINARY_MISSING 结构化错误，不影响其余功能）:

go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest
go install -v github.com/projectdiscovery/naabu/v2/cmd/naabu@latest
go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
端口扫描的备选引擎 nmap:https://nmap.org/download.html(Windows 需要 Npcap)

配置授权范围(必填)

编辑 ~/.dsh/profiles/cyber/cordis.patch.yml(Windows 下为 %USERPROFILE%\.dsh\profiles\cyber\cordis.patch.yml)。补丁按行 id 定位并整体替换该行的 config:

- id: dsh-plugin-cyber
config:
engagement: acme-src-2026q3 # 项目代号,隔离数据目录 scope:
domains: ['example.com'] # 精确域名 + 全部子域名
cidrs: ['203.0.113.0/24'] # IPv4 网段(IPv6 仅支持精确地址)
allowPrivate: false # 靶场/CTF 环境才设为 true gateBash: deny # deny | ask | off,见下 maxScanRate: 50 # 扫描器速率上限

gateBash 三档语义:

| 取值 | 行为 |
| deny（默认） | bash 命令引用了范围外主机且涉及网络工具时直接拒绝 |
| ask | 升级为人类操作员审批（交互式 profile 弹出确认框，列出越权主机）；无头模式下没有审批通道，自动按拒绝处理——agent 无法自我批准 |
| off | 关闭 bash 绊线 |

结构化工具(recon_、vuln_scan、finding_record）内部的范围硬校验不可配置。调整授权范围的唯一方式是修改上述配置——一次深思熟虑、可审计的变更，而不是流程中的一次点击绕过。

开始使用

pnpm dsh --profile cyber "对授权范围执行完整的信息收集,随后进入漏洞探测阶段"

agent 会在系统提示中看到当前阶段、授权范围和全程规则，并按流水线驱动。典型会话:

你:开始信息收集
agent:[flow_status] 当前阶段 recon → [recon_subdomains example.com]
→ [recon_probe ...] → [recon_portscan ...] → 资产清单
你:进入漏洞探测
agent:[flow_advance detect,理由写入审计] → [vuln_scan 存活资产]
→ 命中登记为 candidate 你:逐条复现验证 agent:按技能手册重放请求 → 复现成功 → [finding_record status=confirmed
+ rawRequest + observedResponse];误报标记 rejected 你:生成报告
agent:[flow_advance report] → [report_render] → SRC-REPORT-2026-08-16.md
→ [audit_verify] 校验操作链完整性

随时可以用 scope_check 干跑"这个目标在不在授权范围内、不在的原因是什么"。

工具清单

| 工具 | 阶段 | 包装/依赖 | 用途 |
| recon_subdomains | recon | subfinder | 被动子域名枚举，结果自动过滤出域资产 |
| recon_probe | recon | httpx | 存活探测、状态码、标题、技术栈指纹 |
| recon_portscan | recon | naabu(nmap 回退） | top-1000 端口扫描，速率受限 |
| vuln_scan | detect | nuclei | 模板化漏洞检测，产出候选发现 |
| finding_record | triage | — | 登记/更新发现；confirmed 需通过证据门禁 |
| finding_list | 任意 | — | 按状态查看发现列表 |
| scope_check | 任意 | — | 干跑范围校验并给出拒绝原因 |
| report_render | report | — | 生成中文 SRC 格式 Markdown 报告 |
| flow_status / flow_advance | 任意 | — | 查询/推进阶段（流转理由入审计链） |
| audit_verify | 任意 | — | 校验审计哈希链完整性 |

所有工具故障返回统一结构:{ ok:false, error:{ level: FATAL|RETRYABLE|WARNING, error_code, message, retry_after_ms?, fallback_action? } },agent 可据此编程化处理（缺二进制 → 按提示安装；超时 → 缩小目标集重试；越域 → 更换范围内目标）。

报告格式

report_render 只收录 confirmed 发现，按严重度（严重→信息）排序，写入项目数据目录下的 SRC-REPORT-.md。每条漏洞依次包含:

漏洞名称漏洞链接漏洞描述及危害
漏洞复现过程 (编号步骤 + HTTP raw POC + 服务器关键响应)
修复建议

报告头部带有元信息表：授权测试范围、生成时间、漏洞分级统计、审计链记录数与链头哈希。示例片段:

漏洞 1:登录接口 username 参数 SQL 注入

漏洞编号:F-0001
危害等级:高危 (High)
置信度:95%

漏洞复现过程 ...
POC(HTTP Raw)http
POST /api/login HTTP/1.1
Host: example.com
Content-Type: application/json

{"username":"admin' AND '1'='1","password":"x"}

提交前请人工通读报告。多数 SRC 平台对误报率有惩罚机制——这正是证据门禁存在的原因。

审计与溯源

每次工具调用、范围门禁决策（含 ask 的选择结果）、阶段流转、报告生成都会追加到 audit.jsonl，每条记录携带 prevHash 与前序内容共同计算的 SHA-256 哈希，形成链式结构。任何对历史记录的修改都会断链，可用 audit_verify 工具或离线调用 AuditLog.verify() 定位篡改点。

注意：哈希链是防篡改可检测而非防改写——能整体重写文件的人可以重建链条。用于举证场景时，请定期将审计文件（或链头哈希）导出到测试环境之外的只读存储。

安全边界设计

- 范围门禁：空范围拒绝一切；仅 CIDR 范围下的域名目标因无法离线验证而拒绝；私网/回环/保留地址默认拒绝(allowPrivate 仅供靶场）。bash 绊线内置 GitHub/npm/PyPI 等良性基础设施豁免（可用 gateAllow 扩展），因为"下载工具"不等于"测试目标"。
- 止步于探测:工具集覆盖信息收集、漏洞检测、非破坏性验证，不包含利用（exploitation）模块；注入系统提示的全程规则禁止数据导出、写入篡改、拒绝服务等破坏性动作。
- 证据门禁：见工作原理。
- 诚实声明的局限:bash 门禁是绊线而非沙箱（混淆命令、变量间接引用可绕过）;IPv6 CIDR 仅支持精确匹配。需要硬隔离时请将 profile 运行在虚拟机中或叠加 harness 的沙箱包。完整设计权衡见 docs/ARCHITECTURE.md。

配置项参考

| 键 | 类型 | 默认 | 说明 |
| engagement | string | default | 项目代号，决定数据目录名 |
| dataDir | string | ~/.dsh/dsh-plugin-cyber/ | 数据目录覆盖 |
| scope.domains | string[] | [] | 授权根域（含子域）；留空则拒绝全部 |
| scope.cidrs | string[] | [] | 授权 IPv4 CIDR;IPv6 仅精确地址 |
| scope.allowPrivate | boolean | false | 允许私网/回环/保留地址（靶场用） |
| gateBash | deny\|ask\|off | deny | bash 绊线模式 |
| gateAllow | string[] | [] | 额外良性主机豁免（工具下载等） |
| maxScanRate | number | 50 | 扫描器速率上限 |
| maxFindings | number | 500 | 单个项目的发现数量上限 |

数据目录内容:findings.jsonl（发现）、audit.jsonl（审计链）、flow.json（阶段状态）、SRC-REPORT-.md（报告）。

常见问题

Q：调用 recon_subdomains 返回 FATAL / BINARY_MISSING?
A：对应的扫描器没装。错误对象的 fallback_action 字段里有安装命令；装好后重试即可，不影响其他工具。

Q：返回 SCOPE_DENIED 但我确信目标在范围内？
A：先用 scope_check 看拒绝原因。常见情况：目标域名不在 scope.domains（注意 example.com.evil.net 这类仿冒后缀永远不会通过）；只配了 CIDR 却给了域名（无法离线验证，补一条域名配置）；目标是私网地址（靶场请设 allowPrivate: true)。确认授权后，编辑 profile 补丁配置把目标加入范围。

Q:bash 里的合法命令被绊线拦了？
A：绊线只在命令含网络工具且能提取出主机 token 时触发。若是工具下载等良性用途，把对应镜像域名加入 gateAllow；交互式环境可改 gateBash: ask 让人工裁决；也可以整体 off（不推荐）。

Q：扫描命中为什么没有出现在报告里？
A：报告只收录 confirmed。扫描命中是 candidate，需要按复现步骤实际重放、拿到原始请求与响应证据后，用 finding_record 更新为 confirmed。

开发与测试

npm test # node --test:纯逻辑模块单测(范围/门禁/发现/报告/审计/错误)

另有两个集成冒烟测试，在真实 Cordis 上下文上挂载插件并端到端驱动工具处理器，需先安装进 profile（从 profile 的 node_modules 解析依赖）:

cp tests/smoke.cordis.mjs tests/smoke.tools.mjs ~/.dsh/profiles/cyber/
cd ~/.dsh/profiles/cyber
node --preserve-symlinks smoke.cordis.mjs # 挂载 → 检查注册项 → 卸载 → 校验审计链
node --preserve-symlinks smoke.tools.mjs # 范围拒绝、证据门禁、阶段流转、报告渲染

数据来源与许可证

- skills/ 复制自 Anthropic-Cybersecurity-Skills-main/skills,index.json 为上游生成的目录清单；均为 Apache-2.0，各技能目录内保留原始许可证文件。
- 上游库是独立社区项目，与 Anthropic 无关。其中的攻击性与双用内容仅供授权渗透测试、安全研究、防御与教育用途，请遵守上游行为准则与适用法律。