Introduction¶

DeepSeek Harness (DSH) ecosystem emphasizes extending agent capabilities through plugins. When handling automated tasks such as identity verification and travel assistance, extracting structured data from passport images is a common requirement. The xby-ocr-passport plugin provides passport information recognition and MRZ machine-readable code parsing capabilities for DSH.

Plugin Positioning¶

Name: xby-ocr-passport
Core Value: Passport recognition OCR
Category: Model inference
Maintainer: xby-skill
License: MIT
Functions: Recognizes information such as passport number, Chinese name, English name, gender, nationality, date of birth, issue date, expiration date, and place of issue, and supports MRZ machine-readable code parsing.

Core Functions¶

The plugin provides the following capabilities:
1. set_xby_apikey: Sets the API key in the chat. This operation is automatically persisted and remains valid after restart.
2. ocr_passport: Recognizes passport information. Requires an image file link as input.
3. ocr_passport_for_data_base64: Recognizes passport information. Requires the BASE64 encoding of the image file as input.
4. ocr_passport_for_data_file: Recognizes passport information. Requires the file path of the image file as input.

Installation and Enablement¶

Use the official command to install the plugin:

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

Typical Usage¶

1. Before use, visit the Xiaobenyang official website to register and obtain an API key.
2. In the chat interface, invoke the set_xby_apikey command to configure the key.
3. When invoking a recognition command, choose the input method based on the actual environment:
   - When using ocr_passport, provide an image file link.
   - When using ocr_passport_for_data_base64, provide the BASE64 encoding of the image file.
   - When using ocr_passport_for_data_file, provide the file path of the image file.

Notes¶

• You must obtain and configure an API key before use.
• When invoking recognition features, you must provide a valid image file link, BASE64 encoding, or file path.
• This plugin uses the MIT license. It is recommended to review the source code and license terms before installation.

References¶

• GitHub repository
• Community directory