DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-zoteroplugin

d

dsh-zoteroplugin

Manifest valid

Zotero plugin for DeepSeek Harness: browse and search your library, read PDFs with annotations and highlights in a right-sidebar tab, export BibTeX and RIS citations, and drive the same actions throug

UI (client)hasBundlePatch

DSH Zotero plugin icon

DSH Zotero Plugin

English | 简体中文

License: Apache-2.0 npm GitHub DSH Desktop DeepSeek Harness Plugins Zotero

A standalone Zotero plugin for DeepSeek Harness (DSH). It adds a right-sidebar tab in DSH for browsing and working with your local Zotero library — search, item details, a PDF reader with annotations and highlights, citations — and exposes 19 agent tools so the chat assistant can do the same on your behalf.

Features

  • Library browsing — personal and group libraries, collection tree, saved searches, sorting and pagination.
  • Search — metadata (titleCreatorYear) and full-text (everything) modes, tag filters, ranked results.
  • Item details — creators, fields, abstract, tags, child notes (sanitized), attachments, and PDF annotations with page jumps.
  • PDF reader — rendered in the sidebar with page navigation, zoom, page labels, user annotations, and agent highlights overlaid in the same layer; select text to quote it into the chat as a citation.
  • Chat integration — Add to chat inserts a compact reference chip (one chip per selection, e.g. "3 Zotero items") into the current draft without sending it; the full structured text is expanded at send time, so the model still receives titles, creators and PDF keys. Ask submits a question about the selected item. Both use DSH's official session input interface and fall back to plain text when the host lacks it.
  • Bibliography export — BibTeX and RIS via Zotero's own exporter, downloadable in the browser or written to the workspace as .bib.
  • Metadata import — create items from a DOI or arXiv identifier (fetched from doi.org / arXiv after approval), with optional PDF download.
  • Deep links — open items in Zotero or jump to a PDF page via zotero:// links (server-constructed, platform allow-listed commands).
  • UI languages — Simplified Chinese and English, following the DSH host language.

Screenshots

Real captures from DSH Desktop 0.2.2 with the plugin installed — light and dark themes, no mockups.

Searching the Zotero library in the DSH right-sidebar tab Search metadata or full text from the right-sidebar tab; the tab bar shows the Zotero connection status.

PDF reader with an assistant highlight and the chat that produced it Ask the assistant to open a paper and highlight a passage — the quote lands in the PDF reader as a session highlight next to the chat.

PDF reader in the dark theme The same reader with the DSH dark theme; highlights, annotations, and page controls stay in place.

Requirements

  • DSH Desktop >=0.2.1-rc.1 <0.3.0-0
  • Zotero 10 or later, with the local API enabled (see Quick Start)
  • The plugin is designed to be cross-platform; only macOS has been verified on real hardware so far (see Verification Status).

Installation

From npm (recommended):

dsh plugin --profile desktop add @hanxu131/dsh-zotero

From a local checkout (symlink install; the mapping lives in cordis.patch.yml):

dsh plugin --profile desktop add link:/path/to/dsh-zoteroplugin

After installing, fully quit DSH and start it again so the plugin's host half (agent tools and routes) is loaded. Uninstall or disable it from the DSH plugin management page.

Quick Start

  1. In Zotero, open Settings → Advanced and enable "Allow other applications on this computer to communicate with Zotero". Keep Zotero running.
  2. Install the plugin as shown above, then fully quit and restart DSH.
  3. In DSH, open the right-panel guide page and click the Zotero library entry. The tab shows the connection status first; if Zotero is not reachable, it walks you through the steps above.
  4. Browse, search, and read. Reads never modify your library. Agent-initiated writes go through two gates: a DSH approval prompt first, then Zotero's own authorization dialog on first use. Explicit write actions you take in the sidebar (such as saving highlights) skip the approval prompt but still pass through Zotero's authorization.

The UI language (中文 / English) follows the DSH host language.

Configuration

The plugin has a single setting:

SettingDefaultDescription
localApiBaseUrlhttp://127.0.0.1:23119Base URL of the Zotero local API. Loopback addresses only; other hosts are rejected.

The default is set in cordis.patch.yml, which mounts the plugin into a DSH profile. There is nothing else to configure.

Agent Tools

19 tools are registered with the DSH agent. Read tools never change your library; view tools drive the sidebar UI; write tools require a DSH approval prompt and, on first use, Zotero's authorization dialog.

Read-only

ToolDescription
list_collectionsList the collection tree and saved searches of a library.
search_librarySearch items (metadata or full-text mode) with tag filters, sorting, and pagination.
get_itemFetch full metadata of one item: creators, fields, abstract, tags, attachments, notes.
search_annotationsSearch the PDF annotations of an item by text or tag.
citeFormat a citation (APA) or return a BibTeX entry.
read_fulltextRead a PDF's extracted text with page markers and a per-call character budget.
find_in_pdfFind a word or phrase in a PDF and report physical page, page label, and context.
export_bibExport BibTeX/RIS as text; optionally write a workspace-relative .bib file after approval.

View (drive the sidebar UI)

ToolDescription
open_itemOpen an item or its best PDF in the panel, optionally at a page or quote.
show_itemsShow a list of items in the panel.
highlightHighlight a quoted passage in the reader as a session highlight; save: true also writes it to Zotero (write approval).
clear_highlightsRemove session highlights only. Never deletes annotations in Zotero.

Write (DSH approval + Zotero authorization)

ToolDescription
save_highlightsSave session highlights as Zotero annotations.
add_itemCreate an item from structured fields or a DOI/arXiv identifier; optionally download and attach a PDF. Duplicate DOIs are detected.
update_itemUpdate fields of an existing item.
add_noteAdd a child note to an item.
create_collectionCreate a collection.
attach_pdfAttach a PDF to an item from a local path, an SSRF-guarded URL, or inline bytes.
authorize_writesRequest or verify Zotero write authorization.

Security

  • Loopback only. The Zotero base URL is validated to be a loopback address; the client never holds credentials and never talks to Zotero directly — all traffic flows through the plugin's authenticated host routes inside DSH.
  • Two gates on agent writes. Agent-initiated writes require an explicit DSH approval prompt and then Zotero's own authorization dialog (see ADR 0003). Explicit UI actions in the sidebar skip the approval prompt but still pass through the same Zotero authorization.
  • File safety. PDF paths come only from Zotero-resolved attachment keys — the routes never accept arbitrary paths; symlink-swap races are mitigated with double resolution plus realpath comparison, and files are validated (%PDF- magic, size cap) and read in chunks. export_bib can only write workspace-relative .bib files; absolute paths, .. segments, and symlink escapes are rejected.
  • SSRF guard. External downloads (DOI/arXiv metadata, PDF URLs) allow only public http(s) URLs; DNS results are classified per-address and loopback/private/link-local ranges are rejected before connecting, with per-hop re-checks on redirects plus size, timeout, and file-magic limits.

Verification Status

Honest summary; the full development and acceptance log (in Chinese) is in docs/development-status.md.

  • Automated: the repository ships a vitest suite (fake Zotero HTTP server, injected filesystem/spawn/network seams) plus a smoke script; npm run verify runs typecheck, tests, build, and smoke together.
  • Verified on real hardware (read-only): macOS with DSH Desktop 0.2.1-rc.5 — library browsing (803 items), search, item details, PDF rendering, and draft insertion were exercised against a real Zotero library without writing to it.
  • Automated coverage only, not yet exercised on real hardware: real Zotero writes and the authorization dialog, an actual Ask send, live DOI/arXiv imports, zotero:// deep links, real workspace export, and write-upload endpoints.
  • Windows/Linux: not verified on real machines.

Development

Requires Node ^22.19.0 || >=24.

npm install
npm run verify     # typecheck && test && build && smoke
npm run watch      # incremental client-side bundle build

Individual steps: npm run typecheck, npm run test, npm run build, npm run smoke.

Documentation

DocumentContents
docs/implementation-spec.mdFull implementation spec: feature list, DSH/Zotero contracts, test seams, milestone acceptance matrix, non-goals.
docs/adr/Three architecture decisions: local API + Zotero 10 (0001), two-half plugin + webServer + single right tab (0002), differentiated write approval (0003).
docs/development-status.mdDetailed development record: implementation notes, milestone log, real-machine acceptance status, load-contract and troubleshooting notes (Chinese).
THIRD_PARTY_NOTICES.mdApache-2.0 notices and third-party material registry.

Troubleshooting

  • The tab loads but shows "cannot reach the plugin host routes": the host half needs the plugin to be reloaded — fully restart DSH.
  • Connection status says Zotero is unreachable: make sure Zotero 10+ is running and the local API setting (Quick Start step 1) is enabled.
  • node scripts/probe-desktop.mjs [port] is a read-only diagnostic that checks the running Desktop's /dsh-zotero/health, /status, and bundle URLs (loopback GET requests only).

License

Apache-2.0. Parts of the data layer and metadata import were ported and adapted from the official ZCode Zotero plugin (zai-org/zcode-plugins ui-plugins/zotero, Apache-2.0, modifications noted); the rest is original. See THIRD_PARTY_NOTICES.md for details.

Comments

Loading…

Similar plugins

dsh-zotero

by Hongcheng-LI

Zotero tools for DeepSeek Harness: search library, read metadata/fulltext, list attachments, download PDFs, manage notes via the Zotero local API

Tools & CapabilitiesManifest valid

★ 27

↓ 3.1k/wk

MIT

TypeScript

Nov 5, 2026

dsh plugin --profile web add dsh-zotero

by 520limited

DeepSeek Harness plugin: sync conversation documents (Markdown/PDF/Office) into your local Zotero library via its built-in connector. No API key, no Zotero add-on.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 30, 2026

dsh plugin --profile web add dsh-zotero-sync

by 1-CellBio

DeepSeek Harness plugin: turn research PDFs into a citable OKF markdown library, with full-text & semantic search, knowledge graph, and survey writing.

Manifest valid

★ 4

↓ 211/wk

TypeScript

Aug 21, 2026

dsh plugin --profile web add dsh-okf

by Aik358

DSH Literature 文献侧窗插件:在 DeepSeek Harness 侧边栏识别 DOI/arXiv/标题、抓取元数据与全文、写入本地文献库或导出目录,内置 PDF 阅读器。

Tools & CapabilitiesManifest valid

★ 8

↓ 468/wk

MIT

JavaScript

Sep 16, 2026

dsh plugin --profile web add @a9i5k4/dsh-literature

by poco-ai

给 DeepSeek Harness 用的科研文献库插件:搜论文、带出处、审批入库、把笔记线索交给同会话其他插件。Academic research library for DSH — search, cite, approve imports, hand off notes.

Manifest valid

★ 232

↓ 348/wk

TypeScript

Nov 12, 2026

dsh plugin --profile web add @poco-ai/agentero-dsh

by Vncntvx

Zotero toolkit for DeepSeek harness; Turn your Zotero library into an evidence store for agents.

Tools & CapabilitiesManifest valid

★ 80

↓ 2.5k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add dsh-zotero