前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構。在構建智能體應用時，若需要處理視覺數據並識別其中的野生動物，手動集成模型成本較高。xby-wild-animal-detection 插件封裝了這一能力，使開發者可以直接通過命令調用檢測服務。
核心功能¶
該插件提供以下核心能力：
- set_xby_apikey：在聊天中設置 API 密鑰。該密鑰會自動持久化，重啓進程後依然有效。
- wild_animals_detection：輸入一張圖像，輸出圖像中所有識別到的野生動物的檢測框、置信度及標籤。需提供圖片文件的鏈接。
- wild_animals_detection_for_data_base64：輸入一張圖像，輸出圖像中所有識別到的野生動物的檢測框、置信度及標籤。需提供圖片文件的 BASE64 編碼。
- wild_animals_detection_for_data_file：輸入一張圖像，輸出圖像中所有識別到的野生動物的檢測框、置信度及標籤。需提供圖片文件的文件路徑。
安裝與啓用¶
使用 DSH 的 CLI 工具進行安裝。
# 格式：dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-wild-animal-detection
安裝完成後，插件會自動加載，即可在聊天或腳本中使用上述功能。
典型用法¶
使用前，需要先設置 API 密鑰，然後根據圖片數據的形式選擇對應的檢測命令。
- 設置 API 密鑰：
在聊天中輸入命令設置密鑰：
set_xby_apikey <你的API密鑰>
- 識別圖片：
根據圖片存儲方式選擇命令：
* 圖片文件鏈接：
wild_animals_detection <圖片鏈接>
- 圖片文件的 BASE64 編碼：
wild_animals_detection_for_data_base64 <BASE64字符串>
- 圖片文件的文件路徑：
wild_animals_detection_for_data_file /path/to/image.jpg
注意事項¶
- API 密鑰依賴：插件依賴小笨羊官網的服務。使用前必須前往該官網註冊並獲取有效的 API 密鑰。
- 運行權限：該插件以當前 DSH 進程的權限運行。安裝前請檢查源碼，確保符合安全要求。
- 許可證：本插件遵循 MIT 許可證開源。
總結¶
該插件爲 DSH 智能體提供了基礎的野生動物視覺識別能力。通過簡單的命令調用，即可在對話流中實現圖片分析。插件目錄與源碼倉庫如下：
* 插件目錄：https://www.skillhub.cn/plugins/xby-skill/xby-wild-animal-detection
* GitHub：https://github.com/xby-skill/xby-wild-animal-detection
