前言¶
DeepSeek Harness (DSH) 的核心理念之一是「一切皆插件」，允許開發者通過插件擴展智能體的推理能力。xby-helmet-head 是一款專注於工業安全領域的檢測插件，能夠從輸入的圖像中識別人體、頭部和安全帽，並輸出檢測框、置信度和標籤。它適合需要自動化巡檢或安全合規檢查的場景。
插件簡介¶
- 名稱：xby-helmet-head
- 維護者：xby-skill
- 類別：模型推理
- 許可證：MIT
- 核心價值：輸入一張圖像，對其中的人體、頭部和安全帽進行檢測，輸出圖片中所有目標的檢測框、置信度和標籤。
核心功能¶
該插件提供以下核心能力：
- API 密鑰管理：在聊天中調用
set_xby_apikey設置 API 密鑰。密鑰會自動持久化，重啓後依然有效。 - 圖像檢測接口：支持三種輸入方式對人體、頭部和安全帽進行檢測：
- 圖片文件鏈接：通過
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 密鑰。
典型用法¶
使用該插件通常分爲兩步：先配置密鑰，再執行檢測。
- 設置密鑰
在對話中調用以下命令設置 API 密鑰：
set_xby_apikey <your_api_key>
-
執行檢測
根據你手頭圖片的存儲形式，選擇對應的檢測接口：- 使用圖片鏈接：
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
注意事項¶
- 依賴外部服務：該插件依賴小笨羊官網提供的檢測服務，使用前必須完成註冊並配置有效的 API 密鑰。
- 輸入格式要求：執行檢測功能時，必須確保輸入的是有效的圖片鏈接、BASE64 編碼或文件路徑，否則接口無法返回結果。
總結¶
xby-helmet-head 爲 DSH 用戶提供了標準化的安全帽檢測能力。通過統一的接口封裝，它屏蔽了底層模型推理的複雜性，適合集成到需要自動化安全合規檢查的智能體工作流中。
