前言¶
DeepSeek Harness (DSH) 採用插件化架構，通過擴展插件可以豐富智能體的功能。xby-bbot 插件通過 BBOT MCP 服務器，將 BBOT 安全掃描工具的能力集成到 DSH 環境中，允許在聊天會話中直接管理和執行掃描任務。
是什麼¶
xby-bbot 是一個 DSH 插件，它作爲 BBOT 安全掃描服務的客戶端。該插件提供模塊管理、預設配置以及掃描任務的實時監控功能，使開發者能在 DSH 流程中調用 BBOT 進行安全檢測。
核心功能¶
插件提供以下核心能力：
- set_xby_apikey：在聊天中設置 API 密鑰，該密鑰會自動持久化，重啓後依然有效。
- list_bbot_modules：列出 BBOT 可用的所有掃描模塊。
- list_bbot_presets：列出 BBOT 可用的所有預設配置。
- start_bbot_scan：啓動新的 BBOT 掃描任務。
- get_scan_status：查詢特定掃描任務的狀態。
- get_scan_results：從特定掃描任務獲取檢測結果。
- list_active_scans：列出當前所有正在進行的掃描任務。
- wait_for_scan_completion：等待指定掃描任務完成，支持超時控制和進度報告。
- get_dependency_info：獲取 BBOT 掃描中依賴管理的相關信息。
安裝¶
使用官方安裝命令添加插件。請確保在安裝前已配置好對應的 DSH Profile（例如 web）。
dsh plugin --profile web add github:xby_skill/xby-bbot
典型用法¶
1. 配置 API 密鑰¶
在使用掃描功能前，需要先獲取並設置 API 密鑰。前往 小笨羊官網 註冊並獲取密鑰，然後在 DSH 聊天中執行設置命令。
2. 啓動掃描¶
啓動掃描時需要指定目標地址（targets），其他參數如模塊（modules）、預設（presets）或標誌（flags）可選。
start_bbot_scan(targets="example.com", modules="subdomain,http")
參數說明：
* targets：必填，目標列表，用逗號分隔（域名、IP、URL）。
* modules / presets / flags：可選，用逗號分隔的模塊、預設或標誌列表。
* no_deps：是否禁用依賴安裝以防止 sudo 提示，默認爲 True。
3. 等待完成¶
等待掃描完成並獲取進度。
wait_for_scan_completion(scan_id="scan_123", timeout=300, include_progress=True)
參數說明：
* scan_id：掃描任務 ID。
* timeout：最大等待時間（秒），默認 300。
* poll_interval：輪詢檢查間隔（秒），默認 5。
* include_progress：是否包含進度更新，默認 True。
4. 獲取結果¶
獲取掃描結果。
get_scan_results(scan_id="scan_123", limit=100)
參數說明：
* scan_id：掃描任務 ID。
* limit：返回結果的最大數量，默認 100。
適用場景與注意¶
適用場景：
* 需要在 DSH 環境中自動化執行安全掃描任務。
* 需要對掃描過程進行實時監控和狀態查詢。
注意事項：
* 權限運行：該插件以當前 DSH 進程的權限運行，請確保 DSH 進程具有執行掃描所需的系統權限（如依賴安裝需要 sudo）。
* 源碼審查：安裝前請檢查源碼與許可證，確保符合使用規範。
* 官方屬性：該插件由社區開發者維護，與 DeepSeek 或幻方官方無直接從屬關係。
總結¶
xby-bbot 插件通過標準化的 MCP 接口，將 BBOT 的安全掃描能力無縫接入 DSH 生態。通過配置 API 密鑰和調用相關命令，開發者可以在智能體流程中實現自動化檢測、狀態跟蹤及結果獲取。
