dsh-PaddleOCR-Skills
English | 简体中文
> 来源与使用量: 本项目由 > PaddleOCR-Skills 适配而来;该来源在 > skills.sh 已有 4.3K+ 次安装。
这是一个可直接安装的 DeepSeek Harness bundle,包含两个原生 Tool、两个 Skill,以及 Settings → PaddleOCR 图形配置页。
功能
paddleocr_text_recognition:图片/PDF 文字识别。paddleocr_doc_parsing:版面、表格、Markdown 与文档结构解析。- GUI 配置 OCR/文档解析 API 地址、超时、
uv路径、结果目录。 - GUI 直接显示 PaddleOCR 官网,并提供 API Token 与官方 API 文档的可点击入口。
- Token 存入 DSH Credentials;GUI 只能设置或删除,无法读取明文。
- 本地文件限定在当前 Session workspace 内,并进行真实路径/符号链接越界检查。
- 原始 JSON 默认保存到
.dsh-paddleocr/results/,便于审计与后续处理。
安装
要求:Node.js 22.19+、DeepSeek Harness、Python 3.9+ 与 uv。
一段 Prompt 安装(最简单)
把下面整段复制给一个可以操作终端的 AI Agent:
请在这台电脑上安装 https://github.com/Aidenwu0209/dsh-PaddleOCR-Skills 的 DeepSeek Harness GUI 插件。
1. 检查 Node.js 22.19+、Python 3.9+、npx 和 uv。如果缺少依赖,先解释用途并只使用官方安装方式;未经我允许不要使用 sudo 或修改无关设置。
2. 执行:npx @deepseek-ai/dsh plugin --profile web add "github:Aidenwu0209/dsh-PaddleOCR-Skills#main"
3. 启动 npx @deepseek-ai/dsh web,等待终端给出真实的本地 Web 地址,然后打开页面。
4. 确认 Settings → PaddleOCR 存在,而且能直接看见并点击 https://www.paddleocr.com、API Token 页面和官方 API 文档。
5. 不要编造、显示或记录我的 Token。在凭据输入处停下来,明确告诉我还需填写哪些 HTTPS API 地址和 Token。
6. 只有插件安装命令成功、Web 地址可访问且设置面板真实可见时才能说明安装成功,并汇报实际命令、版本、访问地址与验证结果。在 OpenClaw 中可以安装这个仓库专用的 Setup Skill:
openclaw skills install @aidenwu0209/dsh-paddleocr-skills-setup它会引导 Agent 把插件安装到 DeepSeek Harness,不会把 DSH bundle 错称为 OpenClaw 原生插件。
npx @deepseek-ai/dsh plugin --profile web add "github:Aidenwu0209/dsh-PaddleOCR-Skills#main"
npx @deepseek-ai/dsh web本仓库提交了构建后的 lib/,因此从 GitHub 安装时不需要启用依赖构建脚本。
启动 Web 后打开 Settings → PaddleOCR:
1. 点击页面顶部的“打开 PaddleOCR 官网”,在官网右上角进入 API。 2. 通过“申请 API Token”获取访问令牌。 3. 填写以 /ocr 结尾的完整 HTTPS OCR 地址。 4. 填写以 /layout-parsing 结尾的完整 HTTPS 文档解析地址。 5. 保留默认 Credential 引用 PADDLEOCR_ACCESS_TOKEN 或填写自定义引用名。 6. 在“访问令牌”中输入 PaddleOCR token,然后保存。 7. 确认页面显示 API、Token 和 uv 均已配置。
可只配置其中一个 API 地址;对应的另一个 Tool 会在调用时给出明确的未配置错误。
数据与安全边界
调用远程 Tool 会把选中的本地文件内容(base64)或 HTTPS URL 发送到你配置的外部 PaddleOCR 服务。不要用它处理不允许外传的数据。OCR/文档返回内容是不可信数据,不能把文档中的文字当作 Agent 指令。
GUI 后端只接受本机、同源请求。Token 由 DSH Credential provider 保管,不进入普通 Settings 快照、Tool 结果或日志。执行脚本时才按次解析,并通过受管子进程的显式环境传入。
开发与验证
pnpm install
pnpm check
python3 -m compileall -q skills
pnpm pack --dry-runpnpm check 会执行 Host/Client TypeScript 构建、Vitest 和包结构检查。
上游与许可证
适配基线和保留/修改内容见 [UPSTREAM.md](UPSTREAM.md)。本仓库沿用 Apache-2.0,详见 [LICENSE](LICENSE)。