前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”，通过配置文件和插件扩展智能体能力。在渗透测试场景中，构建一个具备严格授权意识、包含完整扫描流程和特定工具集的代理较为复杂。dsh-pentest-bugtrace 插件解决了这一痛点，它将 BugTraceAI 的渗透测试工作流和 MCP 工具桥接能力封装为一个标准的 DSH 插件，只需一个命令即可激活。
这是什么¶
dsh-pentest-bugtrace 是一个针对 deepseek-harness (dsh) 的渗透测试模式插件。
* 维护者: elliseang0000-lang
* 许可: MIT
* 核心价值: 一条命令将任意 DSH 配置文件转换为 BugTraceAI 渗透测试代理。
核心功能¶
该插件提供以下能力：
1. 渗透测试角色: 内置“渗透测试员”人设，遵循“先授权后扫描”的操作规则，拒绝未授权扫描，并在报告前逐项验证发现。
2. 预置运行手册: 集成 bugtrace-pentest 技能，涵盖扫描流程、专注模式、认证配置（TOTP）、WAF 绕过、模型切换及报告格式。
3. BugTraceAI MCP 桥接: 桥接 7 个原生工具 (mcp__bugtrace__*)，直接驱动 BugTraceAI 引擎。
4. 无头运行器: 包含单次任务执行器，无需额外配置即可启动完整代理。
安装与启用¶
安装前需准备环境：
* 已安装 dsh CLI。
* 已安装 BugTraceAI-CLI，并创建 Python 虚拟环境。
执行以下命令安装插件（会自动创建 pentest 配置文件）：
dsh plugin --profile pentest add git+https://github.com/elliseang0000-lang/dsh-pentest-bugtrace.git
典型用法¶
使用前需配置环境变量：
export DEEPSEEK_API_KEY=sk-...
export BUGTRACE_PYTHON=~/projects/BugTraceAI-CLI/.venv/bin/python
export BUGTRACEAI_HOME=~/projects/BugTraceAI-CLI
启动渗透测试任务：
dsh --profile pentest "authorize and scan https://bugstore.bugtraceai.com, verify findings before reporting"
插件内置的 MCP 工具包括：
* mcp__bugtrace__start_scan: 启动扫描（支持目标/全量/专注模式/认证配置）
* mcp__bugtrace__get_scan_status: 查询扫描进度
* mcp__bugtrace__query_findings: 列出发现（按严重程度/状态）
* mcp__bugtrace__stop_scan: 中止扫描
* mcp__bugtrace__export_report: 导出报告（JSON/MD/HTML）
* mcp__bugtrace__explain_vulnerability: 技术漏洞分解
* mcp__bugtrace__suggest_remediation: 修复建议
适用场景与注意¶
- 授权要求: 仅限对明确授权的目标进行测试。人设会拒绝未授权扫描，并在报告前验证每项发现。
- 环境依赖: 依赖 dsh CLI 和 BugTraceAI-CLI（需 Python venv）。
- 故障处理: 若后端服务不可用，插件会采用“开放失败”策略，降级使用 REST API 或 Shell 命令。
总结¶
dsh-pentest-bugtrace 通过标准化的 DSH 插件方式，将 BugTraceAI 的渗透测试能力（包括授权规则、MCP 工具和运行手册）引入 DSH 生态，降低了构建安全测试代理的门槛。
