在 DSH 插件生态中，处理驾驶证这类结构化证件信息通常需要编写额外的解析逻辑。xby-ocr-driver-license 是一个专注于驾驶证识别的插件，由 xby-skill 维护，归类于模型推理。它能够直接从驾驶证的主页和副页中提取关键信息。
功能说明¶
该插件提供以下核心能力：
- set_xby_apikey：在聊天中设置 API 密钥。该操作会自动持久化密钥，重启进程后依然有效。
- ocr_driver_license：识别驾驶证主页和副页。需要输入图片文件链接。
- ocr_driver_license_for_data_base64：识别驾驶证主页和副页。需要输入图片文件的 BASE64 编码。
- ocr_driver_license_for_data_file：识别驾驶证主页和副页。需要输入图片文件的文件路径。
识别字段包括驾驶证主页的证号、姓名、性别、国籍、住址、出生日期、准驾车型、初次领证日期、有效期限，以及副页的档案编号。
安装与配置¶
使用该插件前，需先获取 API 密钥。
- 获取密钥：前往小笨羊官网注册并获取 API 密钥。
- 安装插件：执行以下命令进行安装。
dsh plugin --profile web add github:xby_skill/xby-ocr-driver-license
安装完成后，插件即可在当前 DSH 进程中使用。
使用示例¶
安装成功后，可通过以下指令调用功能。
- 设置 API 密钥（首次使用必须执行）。
set_xby_apikey <your_api_key>
- 识别图片文件链接。
ocr_driver_license https://example.com/driver_license.jpg
- 识别图片文件的 BASE64 编码。
ocr_driver_license_for_data_base64 <base64_string>
- 识别图片文件的文件路径。
ocr_driver_license_for_data_file /absolute/path/to/image.jpg
注意事项¶
- 许可证：本插件采用 MIT 许可证开源。
- 运行权限：插件以当前 dsh 进程的权限运行，安装前请检查源码与许可证是否符合需求。
- 数据来源：识别服务依赖于小笨羊的 API 接口，请确保已按官网指引获取有效密钥。
