前言¶

DeepSeek Harness (DSH) 的核心理念之一是「一切皆插件」，允许开发者通过插件扩展智能体的推理能力。xby-helmet-head 是一款专注于工业安全领域的检测插件，能够从输入的图像中识别人体、头部和安全帽，并输出检测框、置信度和标签。它适合需要自动化巡检或安全合规检查的场景。

插件简介¶

• 名称：xby-helmet-head
• 维护者：xby-skill
• 类别：模型推理
• 许可证：MIT
• 核心价值：输入一张图像，对其中的人体、头部和安全帽进行检测，输出图片中所有目标的检测框、置信度和标签。

核心功能¶

该插件提供以下核心能力：

1. API 密钥管理：在聊天中调用 set_xby_apikey 设置 API 密钥。密钥会自动持久化，重启后依然有效。
2. 图像检测接口：支持三种输入方式对人体、头部和安全帽进行检测：
   • 图片文件链接：通过 helmet_head_person_detection 接口，直接传入图片 URL。
   • 图片 BASE64 编码：通过 helmet_head_person_detection_for_data_base64 接口，传入图片的 Base64 字符串。
   • 图片文件路径：通过 helmet_head_person_detection_for_data_file 接口，传入本地图片的文件路径。

安装与配置¶

安装前，请确保已注册并获取了相应的 API 密钥。密钥提供方为小笨羊官网。

安装命令¶

通过 DSH 的命令行工具安装插件：

dsh plugin --profile web add github:xby_skill/xby-helmet-head

获取 API 密钥¶

需前往 小笨羊官网 注册并获取 API 密钥。

典型用法¶

使用该插件通常分为两步：先配置密钥，再执行检测。

1. 设置密钥
   在对话中调用以下命令设置 API 密钥：

    set_xby_apikey <your_api_key>

2. 执行检测
   根据你手头图片的存储形式，选择对应的检测接口：

   • 使用图片链接：

        helmet_head_person_detection <image_url>

    *示例：helmet_head_person_detection https://example.com/workplace.jpg*

*   **使用 BASE64 编码**：

        helmet_head_person_detection_for_data_base64 <base64_string>

*   **使用本地文件路径**：

        helmet_head_person_detection_for_data_file /path/to/image.jpg

注意事项¶

1. 依赖外部服务：该插件依赖小笨羊官网提供的检测服务，使用前必须完成注册并配置有效的 API 密钥。
2. 输入格式要求：执行检测功能时，必须确保输入的是有效的图片链接、BASE64 编码或文件路径，否则接口无法返回结果。

总结¶

xby-helmet-head 为 DSH 用户提供了标准化的安全帽检测能力。通过统一的接口封装，它屏蔽了底层模型推理的复杂性，适合集成到需要自动化安全合规检查的智能体工作流中。

• 插件目录页
• GitHub 仓库