前言¶
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 密钥和调用相关命令，开发者可以在智能体流程中实现自动化检测、状态跟踪及结果获取。
