前言¶

在構建基於 DeepSeek Harness (DSH) 的智能體時，處理非結構化數據是常見需求。當輸入源包含手寫文本（如手寫筆記、簽名或表單）時，通用 OCR 模型往往難以處理。通過 DSH 插件體系，可以直接將手寫識別能力集成到工作流中，避免重複造輪子。

插件介紹¶

xby-ocr-handwriting 是一個運行在 DSH 環境中的模型推理插件。它由 xby-skill 維護，提供輸入包含手寫文本的圖像，並自動檢測文本行及識別內容的能力。該插件基於 MIT 許可證開源。

功能¶

該插件提供以下核心能力：

• set_xby_apikey：在對話中設置 API 密鑰。密鑰會自動持久化，重啓進程後依然有效。
• ocr_handwriting：識別手寫文本。需要輸入圖片文件的鏈接。
• ocr_handwriting_for_data_base64：識別手寫文本。需要輸入圖片文件的 BASE64 編碼。
• ocr_handwriting_for_data_file：識別手寫文本。需要輸入圖片文件的文件路徑。

安裝與配置¶

安裝¶

通過以下命令將插件添加到 DSH 中：

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

配置 API 密鑰¶

使用該插件前，需要在小笨羊官網註冊並獲取 API 密鑰。獲取後，通過 set_xby_apikey 命令配置即可。

典型用法¶

根據輸入數據的形式，選擇對應的接口：

1. 網絡圖片鏈接：調用 ocr_handwriting，傳入圖片 URL。
2. BASE64 編碼：調用 ocr_handwriting_for_data_base64，傳入編碼後的字符串。
3. 本地文件路徑：調用 ocr_handwriting_for_data_file，傳入本地文件路徑。

注意事項¶

• API 依賴：該插件依賴小笨羊的 API 服務，使用前必須註冊獲取密鑰。
• 權限範圍：插件以當前 DSH 進程的權限運行，調用文件路徑接口時需確保進程有讀取權限。
• 安全檢查：在安裝和使用前，建議檢查 GitHub 倉庫源碼及許可證，確認符合項目需求。

總結¶

xby-ocr-handwriting 爲 DSH 用戶提供了一套標準化的手寫識別方案，支持鏈接、Base64 和文件路徑三種輸入方式。更多技術細節可參考 插件目錄 或 GitHub 倉庫。