DeepSeek Harness (DSH) 通過插件化架構擴展核心功能。針對圖像分類場景，xby-animal-recognition 插件提供了對動物圖像的標籤識別能力。它不依賴額外的預處理步驟，直接輸出動物的類別標籤。
這是什麼¶
xby-animal-recognition 是由 xby-skill 維護的模型推理插件。它專注於對含有動物的圖像進行分類，輸出動物的類別標籤。該插件遵循 MIT 許可證。
安裝¶
在安裝前，請確認已安裝 DeepSeek Harness (DSH) 並處於可用狀態。通過以下命令將插件添加到 web 配置文件中：
dsh plugin --profile web add github:xby_skill/xby-animal-recognition
安裝完成後，插件即會生效，可在聊天或命令行中調用其功能。
配置¶
使用該插件前，需要先獲取並配置 API 密鑰。
- 獲取密鑰：前往小笨羊官網註冊並獲取 API 密鑰。
- 設置密鑰：在聊天中執行以下命令設置密鑰。密鑰設置後自動持久化，重啓進程後依然有效。
set_xby_apikey <你的API密鑰>
核心功能¶
該插件提供以下四個核心能力，分別對應不同的輸入方式：
- set_xby_apikey：在聊天中設置 API 密鑰（自動持久化，重啓有效）。
- animal_recognition：對含有動物的圖像進行標籤識別，無需任何額外輸入，輸出動物的類別標籤。需要輸入圖片文件鏈接。
- animal_recognition_for_data_base64：對含有動物的圖像進行標籤識別，無需任何額外輸入，輸出動物的類別標籤。需要輸入圖片文件的 BASE64 編碼。
- animal_recognition_for_data_file：對含有動物的圖像進行標籤識別，無需任何額外輸入，輸出動物的類別標籤。需要輸入圖片文件的文件路徑。
典型用法¶
根據不同的輸入需求，選擇對應的功能調用：
-
識別圖片鏈接：
輸入命令並附帶圖片鏈接，插件會返回識別出的動物類別。 -
識別 BASE64 編碼：
輸入命令並附帶圖片的 BASE64 編碼，插件會進行識別並返回類別。 -
識別本地文件路徑：
輸入命令並附帶圖片文件的絕對路徑，插件會讀取文件內容並進行識別。
注意事項¶
- 權限要求：插件以當前 DSH 進程的權限運行，請確保對圖片文件路徑有讀取權限。
- 前置條件：必須先完成 API 密鑰的設置（
set_xby_apikey）才能調用識別功能。 - 許可證：安裝和使用前，請檢查源碼與 MIT 許可證的內容，確保符合使用規範。
