前言¶
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 进程的权限运行，安装前建议检查源码与许可证。
