DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-pdf-reader

r

dsh-pdf-reader

Manifest valid

dsh-pdf-reader: DeepSeek Harness plugin adding a read_pdf tool (local PDF text extraction via pdfjs-dist)

hasBundlePatch

dsh-pdf-reader

A DeepSeek Harness plugin that adds a read_pdf tool, extracting text from PDF files page by page. Fully local parsing — no upload, no network access.

为 DeepSeek Harness 增加 read_pdf 工具,逐页提取 PDF 文本。纯本地解析,不上传、不联网。

Install / 安装

dsh plugin --profile web add github:ralfsqual/dsh-pdf-reader

Or install from a local checkout / 或本地安装:

dsh plugin --profile web add /path/to/dsh-pdf-reader

Restart dsh web afterwards. The read_pdf tool becomes available to the agent in new sessions.

重启 dsh web 后生效,新会话中 Agent 即可调用 read_pdf。

Usage / 使用

Tell the agent to read a PDF, or combine it with an @ file mention (e.g. via dsh-at-file):

Read @docs/spec.pdf and summarize the requirements.
读取 @docs/report.pdf 并总结要点。

Tool parameters

ParameterTypeDescription
pathstringPDF path, relative to the current working directory or an absolute path inside the workspace. / 相对当前工作目录或工作区内绝对路径
maxPagesnumberMax pages to extract, default 500; 0 = no limit. / 最多提取页数
maxCharsnumberMax characters to return, default 120000. / 最多返回字符数

How it works / 工作原理

  • Registered as a model tool via defineTool (@deepseek-ai/dsh-tools).
  • Parses the PDF with pdfjs-dist (2.6.347), extracting text per page with --- page N --- separators.
  • Output is a structured object (pages, extractedPages, truncated, empty, text) with a readable render.

Security / 安全

  • Workspace-confined: path must resolve inside the current working directory; escape attempts (e.g. ../) are rejected. / 路径限定工作区内,越界拒绝。
  • Read-only: the tool only reads the file, never writes, never executes commands. / 只读,绝不写入或执行命令。
  • Local only: parsing happens entirely on the host; no network requests are made. / 纯本地解析,无任何网络请求。
  • Password-protected, corrupted, or non-PDF files produce clear error messages.

Prerequisites / 环境要求

  • DeepSeek Harness with a web (or any agent-capable) profile.
  • Node.js >= 22.19.
  • Works on Windows, macOS, and Linux (host process only; no browser/native code).

Limitations / 已知限制

  • Extracts text layers only. Scanned/image-only PDFs contain no extractable text (the tool reports empty; OCR is out of scope). / 仅提取文本层,扫描件需 OCR。
  • Paths must not contain a leading @ when combined with @-mention plugins. / 与 @ 引用插件合用时路径不能以 @ 开头。
  • Very large PDFs are bounded by maxPages/maxChars; output is truncated with a truncated: true marker.

License

MIT — see LICENSE.

Comments

Loading…

Similar plugins

dsh-pdf

by sunshine-lang

PDF toolbox for DeepSeek Harness: extract text, metadata, and page ranges via pdfjs-dist (local, no API key)

Tools & CapabilitiesManifest valid

★ 7

↓ 395/wk

MIT

TypeScript

Sep 21, 2026

dsh plugin --profile web add dsh-pdf

by peanutcd2005

Read text out of local PDF files inside DeepSeek Harness: page-by-page text, page statistics, scanned-PDF detection, no Python, no network.

Manifest valid

★ 0

MIT

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-plugin-pdf-text

by zhtx2024

PDF parsing toolkit for DeepSeek Harness: pdf_info, pdf_extract_text, pdf_render_page with hybrid pdfjs/built-in engines and system-font rendering for non-embedded CJK PDFs.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 6

↓ 734/wk

MIT

JavaScript

Aug 20, 2026

dsh plugin --profile web add @zhtx2026/dsh-pdf

by Chriszzx

A local PDF/EPUB bookshelf plugin for DeepSeek Harness with built-in readers and a native Books right sidebar.

Manifest valid

★ 0

MIT

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-bookshelf

by jetformat

DeepSeek Harness plugin for Jetformat: Office to PDF and PDF tools via the local CLI

Development & InfrastructureManifest valid

★ 2

MIT

TypeScript

Sep 27, 2026

dsh plugin --profile web add @jetformat/dsh-plugin

by jiaoqsh

DeepSeek Harness plugin: read_document tool — Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, and PDF as Markdown for the model

Tools & CapabilitiesManifest valid

★ 6

↓ 490/wk

MIT

TypeScript

Oct 4, 2026

dsh plugin --profile web add @jiaoqsh/dsh-document