前言¶

在使用 DeepSeek Harness (DSH) 构建智能体时，处理身份验证或数据录入场景时，通常需要从图片中提取结构化信息。手动解析身份证图片效率低且容易出错。该插件提供了针对身份证的专用 OCR 能力，能够直接调用后端服务进行识别和校验。

插件介绍¶

xby-ocr-id-card 是一个 DSH 模型推理类插件，由 xby-skill 维护。它通过调用小笨羊的 OCR 服务，识别身份证正面和背面信息，并自动判断正反面，同时校验身份证号的有效性。

核心功能¶

插件提供以下核心能力：

1. set_xby_apikey
   用于设置 API 密钥。设置的密钥会自动持久化，重启 DSH 后依然有效。

2. ocr_id_card
   识别身份证信息。需要输入图片文件链接（URL）。

3. ocr_id_card_for_data_base64
   识别身份证信息。需要输入图片文件的 BASE64 编码字符串。

4. ocr_id_card_for_data_file
   识别身份证信息。需要输入图片文件的本地文件路径。

上述识别功能均支持提取姓名、性别、民族、出生日期、住址、身份证号、签发机关及有效期限，并自动判断正反面与校验身份证号有效性。

安装¶

使用 DSH CLI 安装该插件：

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

使用说明¶

使用前需前往 小笨羊官网 注册并获取 API 密钥。

1. 在对话或配置中调用 set_xby_apikey 设置密钥。
2. 根据输入数据的类型选择对应的识别函数：
   - 如果是图片链接，使用 ocr_id_card。
   - 如果是 BASE64 编码，使用 ocr_id_card_for_data_base64。
   - 如果是本地文件路径，使用 ocr_id_card_for_data_file。

注意事项¶

• 插件以当前 DSH 进程的权限运行。
• 安装前建议检查源码与许可证（MIT）。
• 不支持离线识别，需联网调用小笨羊服务。

总结¶

该插件为 DSH 开发者提供了一套标准化的身份证处理流程，减少了手动编写解析逻辑的工作量。

GitHub 仓库