@dylanl1/dsh-plugin-pdf
适用于 DeepSeek Harness 的 PDF 阅读、注释、导航和选择翻译
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dingyiliao/dsh-bundle-pdf#a733467e6a902086882d8778abd8852abb66c704
Plugin Pdf 以 @dylanl1/dsh-plugin-pdf 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Read PDFs alongside your DeepSeek Harness conversation. Let the model find relevant passages, annotate them, navigate to the source, and return to your previous reading position.
I read papers and books in PDF form. The readers I tried lacked multi-step back navigation, while AI explanation and translation often required another subscription. I built this plugin for my own DSH workspace.
Agent highlights a passage and adds a comment
Multi-step navigation and back history
Validated with DSH 0.2.1-rc.5; other supported versions are declared in package.json.
GUI: open Plugins → Add plugin, enter @dylanl1/dsh-plugin-pdf, install, then click Enable now.
CLI: replace <profile> with your profile:
dsh plugin --profile <profile> add @dylanl1/dsh-plugin-pdf
For Desktop, install its bundled CLI through Manage dsh Command… in the app menu. Launch Desktop once, fully quit it, install with --profile desktop, then reopen it. A separately npm-installed CLI cannot manage Desktop's plugins.
Native components install automatically; no local compilation is needed. Supported platforms: macOS (Apple Silicon/Intel), Windows x64, and glibc Linux (x64/arm64).
Open a local PDF from DSH's file sidebar. AI features use your configured models or extension engines. Semantic retrieval requires a separately configured embedding service and is off by default. PDFs with an enabled active policy prepare their index in the background on open; OCR and image descriptions can be enabled independently and may call remote services and incur charges. See SPEC for limits.
Settings save automatically. Select engines in PDF settings; each PDF independently enables OCR and image-description indexing under Search → Current PDF index. Update indexes when needed to reuse cached results; disabling semantic search takes effect immediately.
pdf_current, pdf_open, pdf_close, pdf_info, pdf_status.pdf_page_read, pdf_page_render.pdf_keyword_search, pdf_semantic_search, pdf_evidence_read.pdf_annotation_list, pdf_annotation_create, pdf_annotation_update, pdf_annotation_delete.pdf_bookmark_list, pdf_bookmark_edit.pdf_form_inspect, pdf_form_fill.pdf_page_jump, pdf_save.ocr_recognize, image_understand.pdf_open opens documents in the background; navigation requires a visible Reader. Agent edits go straight into the draft; overwriting the source still requires user approval. See the tool documentation for parameters and examples.
OCR, image understanding, translation and embedding support third-party implementations. Build an independent DSH Host plugin, declare this package as a peer dependency, register your backend with the corresponding service through the public SDK, and install it in the same Host profile. It then appears in PDF settings.
Start with http-engines in examples/, an independent plugin providing HTTP OCR and image-understanding backends. See engine extensions for API and lifecycle contracts.
flowchart TB
Reader["Client · PDF Reader"] <--> RPC
Model["DSH conversation model"] -- "Tool calls" --> Features
subgraph Host
RPC["Authenticated RPC"] --> Features["PDF domain capabilities"]
Features --> Copy["Shared working copy · Drafts and undo"]
Features --> Search["Retrieval and evidence"]
Features --> Engines["Extensible AI engines"]
Search --> Copy
Search --> Engines
Search --> Index[("Disk index and checkpoints")]
Copy --> PDF["PDFium · pdf-lib"]
Copy --> Storage["Files and draft storage"]
end
The Reader and agent tools share Host business logic and a working copy within the same resource session; edits synchronize both ways. A native PDFium worker handles rendering and text extraction. See the architecture.
npm ci
npm run native:build
npm run build
Checks and tests: npm run check, npm run test:web, npm run test:coverage:project. See also retrieval configuration and benchmarks and packaging and releases.
MIT. Published packages include the third-party licenses for their native components and dependencies.