前言¶

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。