前言¶

DeepSeek Harness (DSH) 的插件化機制允許開發者快速集成第三方模型能力。在圖像識別領域，目標檢測是常見需求。直接調用模型 API 通常涉及繁瑣的鑑權和參數處理。下面介紹一個現成的檢測插件，用於在聊天或工作流中識別圖片中的香菸。

是什麼¶

xby-smoking-detection 是一個由 xby-skill 維護的模型推理插件。它基於小笨羊的檢測接口，輸入一張圖像，輸出圖片中所有香菸目標的檢測框、置信度和標籤。

核心功能¶

插件提供了三個檢測接口和密鑰設置功能：

1. set_xby_apikey：設置 API 密鑰，配置會自動持久化，重啓後依然有效。
2. smoking_detection：輸入圖片文件鏈接，返回檢測結果。
3. smoking_detection_for_data_base64：輸入圖片文件的 BASE64 編碼，返回檢測結果。
4. smoking_detection_for_data_file：輸入圖片文件的文件路徑，返回檢測結果。

安裝與啓用¶

使用官方命令安裝。注意命令中的 --profile web 參數，確保在正確的環境中加載插件。

dsh plugin --profile web add github:xby_skill/xby-smoking-detection

安裝完成後，需要重啓 DSH 進程以使配置生效。

典型用法¶

使用前，必須先調用 set_xby_apikey 設置 API 密鑰。之後根據輸入數據的類型選擇對應的檢測函數。

• 若圖片存儲爲 URL，使用 smoking_detection。
• 若圖片爲 BASE64 字符串，使用 smoking_detection_for_data_base64。
• 若圖片爲本地文件路徑，使用 smoking_detection_for_data_file。

適用場景與注意¶

該插件適合需要在聊天界面或工作流中對圖片進行香菸識別的場景。

注意事項：
1. 使用前需前往小笨羊官網註冊並獲取 API 密鑰。
2. 插件以當前進程權限運行，安裝前請檢查源碼與許可證（MIT）。

更多信息¶

插件源碼與文檔位於 GitHub：xby-skill/xby-smoking-detection。