前言¶

DeepSeek Harness (DSH) 生态强调通过插件扩展智能体的能力。在处理身份验证、旅行助手等自动化任务时，从护照图像中提取结构化数据是常见需求。xby-ocr-passport 插件为 DSH 提供了护照信息识别与 MRZ 机读码解析能力。

插件定位¶

名称：xby-ocr-passport
核心价值：护照识别 OCR
分类：模型推理
维护者：xby-skill
许可证：MIT
功能：识别护照号码、中文姓名、英文姓名、性别、国籍、出生日期、签发日期、有效期至、签发地点等信息，支持 MRZ 机读码解析。

核心功能¶

插件提供以下能力：
1. set_xby_apikey：在聊天中设置 API 密钥，该操作会自动持久化，重启后依然有效。
2. ocr_passport：识别护照信息。需要输入图片文件链接。
3. ocr_passport_for_data_base64：识别护照信息。需要输入图片文件的 BASE64 编码。
4. ocr_passport_for_data_file：识别护照信息。需要输入图片文件的文件路径。

安装与启用¶

使用官方命令安装插件：

dsh plugin --profile web add github:xby_skill/xby-ocr-passport

典型用法¶

1. 使用前需前往 小笨羊官网 注册并获取 API 密钥。
2. 在聊天界面调用 set_xby_apikey 命令配置密钥。
3. 调用识别命令时，根据实际环境选择输入方式：
   - 使用 ocr_passport 时提供图片文件链接。
   - 使用 ocr_passport_for_data_base64 时提供图片文件的 BASE64 编码。
   - 使用 ocr_passport_for_data_file 时提供图片文件的文件路径。

注意事项¶

• 使用前必须获取并配置 API 密钥。
• 调用识别功能时，必须提供有效的图片文件链接、BASE64 编码或文件路径。
• 该插件使用 MIT 许可证，建议在安装前检查源码与许可证条款。

参考资料¶

• GitHub 仓库
• 社区目录