前言¶

在使用 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 倉庫