前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在將特定能力封裝進工作流。在本地處理文檔識別（OCR）時，直接調用官方雲端模型或搭建獨立環境往往不夠高效。本插件爲 DSH Web profile 提供了本地 PaddleOCR 3.x 能力，通過 DSH 官方接口調用，無需額外配置。
插件介紹¶
名稱：qiuchunhuimax/dsh-plugin（項目標識爲 @dsh-external/dsh-paddle-ocr）
維護者：qiuchunhuimax
類別：模型推理
定位：Workspace-confined PaddleOCR tool and /ocr command for DeepSeek Harness。
核心功能¶
該插件提供了兩種調用方式：
1. 模型工具：paddle_ocr。DSH Agent 可以在當前工作區內直接調用此工具。
2. 人類命令：/ocr <文件路徑> [ch|en]。支持直接在對話中輸入命令。
支持的輸入文件格式包括：PDF、PNG、JPG、WEBP、BMP、TIF/TIFF。
輸出方面，插件會在當前工作區的 artifacts/paddle-ocr/ 目錄下生成唯一的 Markdown 文件，且不會覆蓋原文件。
運行要求¶
- Python 環境：系統需安裝 Python 3。
- PaddleOCR 庫：需安裝
paddleocr3.x 版本。 - 環境變量：默認運行
python3。如果 PaddleOCR 位於其他 Python 環境，需在啓動 DSH 前設置PADDLEOCR_PYTHON環境變量。
安裝與啓用¶
使用官方插件安裝命令添加該插件：
dsh plugin --profile web add github:qiuchunhuimax/dsh-plugin
安裝完成後，重啓或刷新 dsh web 服務即可在對話中使用。
典型用法¶
在對話中輸入以下命令進行識別：
/ocr scans/invoice.pdf ch
或者直接向 Agent 發起指令，例如：“識別 scans/invoice.pdf 並整理結果”。
適用場景與注意¶
該插件適合需要在 DSH 工作流中進行本地文檔識別的開發者。
注意事項：
* 插件使用 DSH 官方 bundle/Tool Registry 接口，調用 PaddleOCR 官方 Python API，不使用 DeepSeek-OCR 模型。
* 插件會解析符號鏈接，但解析後的路徑不離開當前工作區。
* 安裝前建議檢查源碼與許可證（MIT）。
生態背景：DSH 理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
