MariNanari/dsh-vulnsec-bridge ↗★ 1
dsh-vulnsec-bridge
VulnClaw + DeepSec 桥接插件:AI 安全 CLI(授权渗透测试 / Shield 代码审计)→ dsh 工具 + 设置页安全工具台 UI
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:MariNanari/dsh-vulnsec-bridge说明文档
阅读完整 README ↗dsh-vulnsec-bridge
把 VulnClaw(AI 渗透测试 CLI)与 DeepSec(Shield 代码审计 + Spear 授权渗透)包装成 dsh 工具,并提供图形操作界面(设置 → 安全工具台)。零第三方运行时依赖(桥接层只调用 DSH 官方 subprocess 服务)。
图形界面(设置 → 安全工具台)
- 状态条:vulnclaw / deepsec CLI 可用性徽章(自动探测)
- VulnClaw 操作区:目标输入 + recon / scan / exploit / run / solve 一键执行
- DeepSec Shield:目录 + 检测层(l1/l2/l3)+ 输出格式(text/json/sarif/markdown)
- DeepSec Spear:目标 + 授权 scope 文件 + 模式(quick/standard/deep)
- Scope 白名单:列出 / 加入授权目标
- LLM 配置:VulnClaw provider 一键切换
- 结果日志区:实时展示命令输出(脱敏 + 截断),运行中按钮自动禁用
工具清单
| 工具 | 说明 |
|---|---|
sec_tools_status | 检查两个 CLI 是否可用 |
vulnclaw_recon / vulnclaw_scan / vulnclaw_exploit | 信息收集 / 漏洞扫描 / 漏洞利用(⚠️ 仅限授权目标) |
vulnclaw_run / vulnclaw_solve | 一键全流程 / 目标驱动求解(⚠️ 仅限授权目标) |
vulnclaw_report / vulnclaw_config | 会话报告 / 配置(LLM 提供商等) |
deepsec_shield_scan | Shield 三层代码审计(L1/L2/L3,支持 SARIF/JSON 输出) |
deepsec_shield_agent_audit / deepsec_shield_supply_chain | agent 配置审计 / 供应链与幻觉包检查 |
deepsec_spear_recon / deepsec_spear_run | Spear 侦察 / 端到端授权渗透(目标必须在 scope 白名单内) |
deepsec_scope / deepsec_config / deepsec_report | 授权范围 / 配置 / 报告 |
Web API(供 UI 调用)
GET /vulnsec/api/status— CLI 状态POST /vulnsec/api/run— 执行任意工具({tool, target, ...})POST /vulnsec/api/scope— scope 白名单操作({action: list|add|verify, target?})POST /vulnsec/api/config— LLM 配置({which: vulnclaw|deepsec, action, provider?})
CLI 定位
- 环境变量
VULNSEC_VULNCLAW/VULNSEC_DEEPSEC(可执行文件绝对路径) - 默认 venv:
E:\DSH-PLUGINS\sec-tools-venv(可用VULNSEC_VENV覆盖) - PATH 兜底
安全
- 所有渗透类工具描述中声明"仅限已授权目标";DeepSec Spear 自带 scope 白名单闸门
- 工具输出自动脱敏(
sk-…API Key、secret 值、私钥块) - 输出截断至 120KB,防大响应污染上下文
安装
依赖:本机已有 VulnClaw / DeepSec CLI(Python 3.10+,任一安装到 PATH 或 venv 即可)。
方式一:dsh 插件管理(推荐)
dsh plugin --profile web add dsh-vulnsec-bridge
方式二:手动装配(无 pnpm 环境)
- 将插件包放入 profile 的
node_modules(或profiles/node_modules回退目录) - 在 profile
package.json的dsh.profile.bundles追加dsh-vulnsec-bridge - 重启 dsh
CLI 定位
- 环境变量
VULNSEC_VULNCLAW/VULNSEC_DEEPSEC(可执行文件绝对路径) - 默认 venv:
/../sec-tools-venv(可用VULNSEC_VENV覆盖) - PATH 兜底
开发
# host + client 双 bundle 构建(tsdown)
npm install -D tsdown typescript @types/node
npx tsdown
# 热更新(DSH 环境):dev_inject_plugin 或重启 dsh