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¶
- Before use, visit the Xiaobenyang official website to register and obtain an API key.
- In the chat interface, invoke the
set_xby_apikeycommand to configure the key. - When invoking a recognition command, choose the input method based on the actual environment:
- When usingocr_passport, provide an image file link.
- When usingocr_passport_for_data_base64, provide the BASE64 encoding of the image file.
- When usingocr_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.