前言¶
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 / 幻方无官方从属关系。
