前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的設計理念。在開發具備視覺感知能力的智能體時，人體姿態估計是常見需求。xby-pose 插件提供了這一能力，允許開發者直接在對話或腳本中調用姿態檢測服務，無需自行搭建推理服務。
插件概況¶
該插件由 xby-skill 維護，歸類於模型推理類別，當前版本爲 1.0.0，許可證爲 MIT。
插件的核心功能是在圖像中檢測人物，並輸出邊界框以及 17 個關鍵點座標。這 17 個關鍵點依次代表：鼻子、左眼、右眼、左耳、右耳、左肩、右肩、左肘、右肘、左腕、右腕、左髖、右髖、左膝、右膝、左腳踝、右腳踝。
核心能力¶
插件提供了以下接口：
-
set_xby_apikey
在聊天中設置 API 密鑰。該設置會自動持久化，重啓 DSH 進程後依然有效。 -
yolo26_pose_estimate
檢測圖像中的人物，輸出邊界框和關鍵點座標。- 輸入要求：圖片文件的鏈接。
-
yolo26_pose_estimate_for_data_base64
檢測圖像中的人物，輸出邊界框和關鍵點座標。- 輸入要求：圖片文件的 BASE64 編碼。
-
yolo26_pose_estimate_for_data_file
檢測圖像中的人物，輸出邊界框和關鍵點座標。- 輸入要求：圖片文件的文件路徑。
安裝與配置¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:xby_skill/xby-pose
安裝完成後，使用 set_xby_apikey 設置密鑰前，需先前往小笨羊官網註冊並獲取 API 密鑰。
使用示例¶
- 在對話中輸入命令設置密鑰：
set_xby_apikey 你的密鑰 - 使用
yolo26_pose_estimate檢測圖片：
yolo26_pose_estimate 圖片鏈接 - 或使用
yolo26_pose_estimate_for_data_base64檢測 Base64 數據：
yolo26_pose_estimate_for_data_base64 Base64字符串 - 或使用
yolo26_pose_estimate_for_data_file檢測本地文件：
yolo26_pose_estimate_for_data_file /path/to/image.jpg
注意事項¶
- 插件運行依賴於小笨羊提供的 API 服務。
- 使用前請確保網絡環境允許訪問目標圖片資源（對於 URL 輸入模式）。
- 插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
