dsh-paddle-ocr
Author / Maintainer: @Zacklinkk
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）渲染为 “当前排队中（稍后重试）”按钮，而不是错误字符串。
安装
# 在 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（环境变量优先、只读，卡片会显示只读徽章）。
> ⚠️ 安全提醒：请轮换你此前在 skill 仓库里使用过的 token。 > 本插件的前身（paddle-ocr skill）曾在 config.json 中以明文写入过一个 > aistudio token 并进入 git 历史，视为已泄漏。请勿继续使用该 token： > 到星河社区个人中心重新生成一个，并在该 skill 仓库中彻底删除旧文件、改写历史。 > 本插件从不把任何密钥写进代码、配置或日志——token 只存在于 DSH 凭据保险箱。
API 限制与行为
| 模式 | 接口 | 限制 | 超限处理 |
|---|---|---|---|
| async（默认） | POST https://paddleocr.aistudio-app.com/api/v2/ocr/jobs（模型 PaddleOCR-VL-1.5） | 1000 页 / 本地 50MB | 自动拆分后逐份提交，页号全局连续 |
| sync | POST https://b3kd6029kevcafkb.aistudio-app.com/layout-parsing | 100 页 | 同上（100 页/份）；300s 超时 |
- 队列饱和是常态：提交返回
errorCode 10010（任务提交队列已满）时，工具与面板
都会指数退避重试（2s/4s/8s/16s…最多 5 次）；重试耗尽后给出明确“排队中”提示， 面板提供 [稍后重试] 按钮。
- 任务面板上传上限 30MB（回环 RPC 承载）；更大的文件请让 agent 用
paddle_ocr_layout 工具直接处理。
开发
npm install --legacy-peer-deps # 安装依赖（DSH 包走 workspace 软链）
DSH_WORKSPACE_ROOT=/path/to/dsh-source node scripts/setup-dsh-workspace.mjs
npm run typecheck # 宿主 + 客户端类型检查
npm test # vitest 单测（重试/拆分/测试图）
npm run build # lib/index.js（宿主）+ lib/client.js（浏览器）客户端 bundle 由 tsdown.config.ts 构建（CJS + __ModuleLoader__ 工厂）， CSS Modules 内联注入；宿主半是普通 tsc 输出。
License
BSD-3-Clause