dsh-paddle-ocr DSH 插件

dsh-paddle-ocr 是一个 DSH 插件，利用百度 PaddleOCR-VL 将 PDF 和图片逐页转换为 Markdown 并保存图片。它提供三个宿主工具供 agent 使用、一个浏览器设置卡和任务面板。插件自动处理超限拆分、队列拥堵时的指数退避重试，token 安全存储在 DSH 凭据保险箱。

vision ui-productivity

如何安装 dsh-paddle-ocr DSH 插件

dsh plugin --profile web add link:/path/to/dsh-paddle-ocr

复制不会执行命令。安装 dsh-paddle-ocr DSH 插件前请核对仓库和版本。

dsh-paddle-ocr DSH 插件数据来源

dsh-paddle-ocr DSH 插件快照日期：2026年8月16日

discovered

dsh-paddle-ocr DSH 插件能做什么

将 PDF/图片逐页解析为 Markdown，图片文件落盘保存
自动拆分超限 PDF（异步模式 1000 页/50MB，同步模式 100 页）
队列满（errorCode 10010）时指数退避重试（最多 5 次）
支持异步模式（默认）和同步模式（300 秒超时）
浏览器 UI：设置卡配置 API token、测试连接、处理默认值
任务面板：拖拽/选择文件、进度条、结果预览页签、落到工作区
Agent 可用工具：`paddle_ocr_layout`、`paddle_ocr_test`、`paddle_split_pdf`

dsh-paddle-ocr DSH 插件适合哪些场景

将扫描版 PDF 转为可编辑的 Markdown，用于后续处理
批量解析图片并进行版面分析，保留结构和嵌入图片
在 DSH agent 中集成 OCR 能力，实现自动化文档工作流
使用内置测试图快速验证 API token 连通性
手动拆分大型 PDF，方便后续处理

dsh-paddle-ocr DSH 插件适合谁

需要从 PDF 或图片中提取文字和版面的 DSH 用户
在 DSH agent 中构建文档处理管道的开发者
偏好可视化界面进行 OCR 操作的 DSH 使用者

dsh-paddle-ocr DSH 插件的限制

需要外部百度 AI Studio 的 API token（PaddleOCR 服务）
队列拥堵常见，提交可能延迟或需要重试
任务面板上传限制 30MB（更大文件需使用 agent 工具）
仅支持 PaddleOCR-VL 模型，无其他 OCR 后端
异步模式每作业限制 1000 页，同步模式限制 100 页

dsh-paddle-ocr DSH 插件的仓库 README 摘录

以下文字摘自 dsh-paddle-ocr DSH 插件的上游仓库 omdsh-dev/dsh-paddle-ocr 的 README，版权归原作者，仅作引用。

DSH 插件：百度 **PaddleOCR-VL** 文档布局解析。把 PDF / 图片逐页解析为 Markdown （文字 + 图片落盘），提供三个宿主工具、一个浏览器配置卡和一个任务面板。 - 宿主工具（agent 可用）： - `paddle_ocr_layout(file, {mode, fileType, orientation, unwarping, chart, visualize, outputDir})` —— 逐页解析落盘（`doc_N.md` + 图片），默认异步模式；超限 PDF 自动拆分；队列满（10010）自动指数退避重试（最多 5 次），最终仍满则给出友好排队提示。 - `paddle_ocr_test()` —— 用内置小测试图验证 token 与接口连通性（✅/❌ + 详情）。 - `paddle_split_pdf(file, {maxPages, outputDir})` —— 手动拆分超限 PDF。 - 浏览器 UI： - 设置 → 插件 → **PaddleOCR** 卡片：API token（只进 DSH 凭据保险箱，永不回传、输入框常空、只显示“已配置”徽章）、[测试连接] 按钮、处理默认值（异步/同步、方向矫正、展平、图表识别、可视化标注图）。 - 右下角**任务面板**：拖入/选择文件 → 进度条（排队中 / 解析第 x 页 / 下载图片）→ 结果页签（Markdown 预览 + 图片缩略图）→ [落到工作区]。队列满（10010）渲染为 “当前排队中（稍后重试）”按钮，而不是错误字符串。 ## 安装 ```bash # 在 DSH 部署机上，把本包加入 web profile（同时打进 host 组合与浏览器 bundle） dsh plugin --profile web add link:/path/to/dsh-paddle-ocr ``` 插件自带 `dsh.bundle.patch`（组合插入行）与 `dsh.client` 声明；`dsh plugin` 会自动把包名加入 `dsh.profile.bundles`。重启 `dsh web` 后生效。 ## 获取 API token 1. 打开星河社区 <https://aistudio.baidu.com/paddleocr/task>； 2. 登录后进入 **个人中心 → 访问令牌（token）**； 3. 复制 token，粘贴到设置 → 插件 → PaddleOCR 卡片，点保存，再点 [测试连接]。也可以设置环境变量 `PADDLE_OCR_TOKEN`（环境变量优先、只读，卡片会显示只读徽章）。 > ⚠️ **安全提醒：请轮换你此前在 sk

阅读完整 README仓库许可: BSD-3-Clause

dsh-paddle-ocr DSH 插件常见问题

如何安装 dsh-paddle-ocr 插件？

在 DSH 部署机上执行命令 `dsh plugin --profile web add link:/path/to/dsh-paddle-ocr`。插件会自动将包名加入 web profile 的 bundles 中。之后重启 DSH web 服务即可生效。

如何获取 PaddleOCR 的 API token？

打开百度 AI Studio 平台（aistudio.baidu.com/paddleocr/task），登录后进入个人中心 → 访问令牌（token），复制 token。然后在 DSH 设置 → 插件 → PaddleOCR 卡片中粘贴并保存。也可以设置环境变量 `PADDLE_OCR_TOKEN`，环境变量优先且只读。

如果 OCR 队列满了怎么办？

当队列满（errorCode 10010）时，插件会自动进行指数退避重试（2s、4s、8s…最多 5 次）。如果重试耗尽，会显示友好的“排队中，请稍后重试”提示。在任务面板中会提供一个[稍后重试]按钮。

能处理超过 30MB 的文件吗？

任务面板受限于回环 RPC 承载，上传上限为 30MB。更大的文件请使用 agent 工具 `paddle_ocr_layout(file, ...)` 直接处理，该工具没有上传限制。插件也会自动拆分超限 PDF（异步模式 1000 页，同步模式 100 页）。

我的 API token 安全吗？

安全。token 仅存储在 DSH 凭据保险箱中，不会写入代码、配置或日志。设置卡输入框始终为空，仅显示“已配置”徽章。环境变量只读且不暴露。建议轮换之前在 skill 仓库中使用过的任何 token。