前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在降低智能体开发的门槛。在构建涉及文档处理的智能体时，开发者往往需要集成特定的识别能力。xby-ocr-vehicle-license 是一个现成的模型推理插件，封装了行驶证识别逻辑，解决了在 DSH 环境中直接调用 OCR 服务的接口问题。
插件介绍¶
该插件由 xby-skill 维护，属于模型推理类别。它主要用于识别机动车行驶证的关键信息，包括号牌号码、车辆类型、所有人、住址、品牌型号、发动机号码、车辆识别代号等。插件内置了自动方向检测和主副页过滤功能，能够适应不同摆放角度的图片，并处理行驶证的主页或副页。
核心功能¶
插件提供了以下标准化接口：
set_xby_apikey: 在对话中设置 API 密钥，配置后自动持久化，重启 DSH 后依然有效。ocr_vehicle_license: 识别行驶证信息，输入参数为图片文件链接。ocr_vehicle_license_for_data_base64: 识别行驶证信息，输入参数为图片文件的 BASE64 编码。ocr_vehicle_license_for_data_file: 识别行驶证信息，输入参数为图片文件的文件路径。
安装与启用¶
通过命令行安装该插件，执行以下指令：
dsh plugin --profile web add github:xby_skill/xby-ocr-vehicle-license
安装完成后，插件将随 DSH 进程启动，可通过上述接口在对话或代码中调用。
使用配置¶
使用前必须获取 API 密钥。请前往 小笨羊官网 注册并获取密钥，然后通过 set_xby_apikey 接口将其注入当前会话。
插件会以当前 DSH 进程的权限运行。如果使用 ocr_vehicle_license_for_data_file 接口，请确保当前环境具备读取对应文件路径的权限。
注意事项¶
该插件遵循 MIT 许可证。在安装和使用前，建议开发者检查源码与许可证条款。插件依赖外部 API 服务，请确保网络环境能够正常访问。
