前言¶
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 生態，降低了構建安全測試代理的門檻。
