MariNanari/dsh-vulnsec-bridge1

dsh-vulnsec-bridge

VulnClaw + DeepSec 桥接插件:AI 安全 CLI(授权渗透测试 / Shield 代码审计)→ dsh 工具 + 设置页安全工具台 UI

包名
dsh-vulnsec-bridge
版本
0.2.0
许可证
MIT
最近更新
2026年8月17日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:MariNanari/dsh-vulnsec-bridge

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_scanShield 三层代码审计(L1/L2/L3,支持 SARIF/JSON 输出)
deepsec_shield_agent_audit / deepsec_shield_supply_chainagent 配置审计 / 供应链与幻觉包检查
deepsec_spear_recon / deepsec_spear_runSpear 侦察 / 端到端授权渗透(目标必须在 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 定位

  1. 环境变量 VULNSEC_VULNCLAW / VULNSEC_DEEPSEC(可执行文件绝对路径)
  2. 默认 venv:E:\DSH-PLUGINS\sec-tools-venv(可用 VULNSEC_VENV 覆盖)
  3. 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 环境)

  1. 将插件包放入 profile 的 node_modules(或 profiles/node_modules 回退目录)
  2. 在 profile package.jsondsh.profile.bundles 追加 dsh-vulnsec-bridge
  3. 重启 dsh

CLI 定位

  1. 环境变量 VULNSEC_VULNCLAW / VULNSEC_DEEPSEC(可执行文件绝对路径)
  2. 默认 venv:/../sec-tools-venv(可用 VULNSEC_VENV 覆盖)
  3. PATH 兜底

开发

# host + client 双 bundle 构建(tsdown)
npm install -D tsdown typescript @types/node
npx tsdown

# 热更新(DSH 环境):dev_inject_plugin  或重启 dsh

许可与致谢

  • 本插件:MIT License(见 LICENSE)
  • 集成的 CLI 均为 MIT 许可的开源项目,本插件仅以子进程方式调用、不包含其代码:
    • VulnClaw(MIT,Copyright 2026 UncleC)—— AI 渗透测试框架
    • DeepSec(MIT,Copyright 2026 VibeGuard contributors)—— Shield 代码审计 / Spear 授权渗透
  • 使用前请阅读各自的安全声明(仅限已授权目标)