@dsh-external/dsh-paddle-ocr

Readme

# DSH PaddleOCR 插件

为 DeepSeek Harness Web profile 提供本地 PaddleOCR 3.x 能力。

## 功能

- 模型工具：`paddle_ocr`，由 DSH Agent 在当前工作区内调用。
- 人类命令：`/ocr <文件路径> [ch|en]`。
- 输入仅限当前工作区中的 PDF、PNG、JPG、WEBP、BMP、TIF/TIFF；符号链接解析后也不得离开工作区。
- 每次识别在 `artifacts/paddle-ocr/` 生成唯一的 Markdown 文件，不覆盖原文件。

## 运行要求

- Python 3 与 `paddleocr` 3.x 已安装。
- 默认运行 `python3`；如 PaddleOCR 位于其他环境，启动 DSH 前设置 `PADDLEOCR_PYTHON`。

## 安装

从 GitHub 安装：

```bash
dsh plugin --profile web add github:qiuchunhuimax/dsh-plugin
```

或从本地目录安装：

```bash
dsh plugin --profile web add /path/to/paddle-ocr-plugin
```

重启或刷新 `dsh web` 后，在对话中输入：

```text
/ocr scans/invoice.pdf ch
```

或直接告诉 Agent “识别 `scans/invoice.pdf` 并整理结果”。

## GitHub 调研

未找到一个可直接安装、同时匹配 DeepSeek Harness 插件 API 和 PaddleOCR 的现成插件。本插件使用 DSH 官方 bundle/Tool Registry 接口，并调用 PaddleOCR 官方 Python API；它不使用 DeepSeek-OCR 模型。

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — DSH bundle 与工具注册接口
- [PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) — 本插件调用的本地 OCR 引擎