Introduction

One of the core ideas of DeepSeek Harness (DSH) is “everything is a plugin,” allowing developers to extend an agent’s reasoning capabilities through plugins. xby-helmet-head is a detection plugin focused on industrial safety. It can identify persons, heads, and safety helmets in input images and output detection boxes, confidence scores, and labels. It is suitable for scenarios that require automated inspection or safety compliance checks.

Plugin Overview

  • Name: xby-helmet-head
  • Maintainer: xby-skill
  • Category: Model Inference
  • License: MIT
  • Core Value: Input an image, detect persons, heads, and safety helmets within it, and output the detection boxes, confidence scores, and labels for all detected targets.

Core Features

This plugin provides the following core capabilities:

  1. API key management: Call set_xby_apikey in a chat to set the API key. The key is persisted automatically and remains valid after a restart.
  2. Image detection interface: Supports three input methods for detecting persons, heads, and safety helmets:
    • Image file link: Pass an image URL directly through the helmet_head_person_detection interface.
    • Image Base64 encoding: Pass the image’s Base64 string through the helmet_head_person_detection_for_data_base64 interface.
    • Image file path: Pass the local image file path through the helmet_head_person_detection_for_data_file interface.

Installation and Configuration

Before installation, make sure you have registered and obtained the corresponding API key. The key is provided by the Xiaobenyang Official Website.

Installation Command

Install the plugin using DSH’s command-line tool:

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

Obtaining the API Key

You need to register and obtain an API key on the Xiaobenyang Official Website.

Typical Usage

Using this plugin usually involves two steps: configure the key first, then run the detection.

  1. Set the key
    Call the following command in a conversation to set the API key:
    set_xby_apikey <your_api_key>

  1. Run the detection
    Choose the corresponding detection interface based on how your image is stored:

    • Using an image link:
        helmet_head_person_detection <image_url>

    *Example: helmet_head_person_detection https://example.com/workplace.jpg*

*   **Using Base64 encoding**:

        helmet_head_person_detection_for_data_base64 <base64_string>

*   **Using a local file path**:

        helmet_head_person_detection_for_data_file /path/to/image.jpg

Notes

  1. Depends on an external service: This plugin relies on the detection service provided by the Xiaobenyang Official Website. Before use, you must complete registration and configure a valid API key.
  2. Input format requirements: When running detection, make sure the input is a valid image link, Base64 encoding, or file path; otherwise, the interface cannot return a result.

Summary

xby-helmet-head provides DSH users with standardized safety helmet detection capabilities. Through a unified interface layer, it hides the complexity of underlying model inference, making it suitable for integration into agent workflows that require automated safety compliance checks.