DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-zotero-bridge

d

dsh-zotero-bridge

Identified

Read-only Zotero bridge for DeepSeek Harness (Local API + sqlite copy)

dsh-zotero-bridge

Read a local Zotero library — and register the item as evidence. Never write to it.

Local API first, a temporary copy of zotero.sqlite second, and one REP evidence item per selected paper. No sync, no write, no cloud, no PDF download.

License Node DSH plugin

English · 简体中文


Why read-only

Your Zotero library is the only copy of years of work. One bad write can corrupt zotero.sqlite or desynchronize the desktop client. This plugin therefore has no write path at all: it only performs GET against the Local API and SELECT against a temporary copy of the database.

Modes

ModeWhenWhat happens
local-apiZotero is running with Settings → Advanced → “Allow other applications on this computer to communicate with Zotero”Reads http://127.0.0.1:23119/api/users/0/... (loopback only)
sqliteLocal API is down and zotero.sqlite existsCopies the database to a temp directory, opens the copy read-only, extracts items, deletes the copy
unavailableNeitherReturns concrete steps instead of an empty result

Tools

ToolJob
zotero_statusProbe the API, find the database, report the active mode and read-only policy
zotero_searchQuery the library; returns title, creators, year, DOI, abstract, tags, collections, attachment metadata
zotero_itemRead one item by key, including its attachment children
zotero_to_repCapture the item as an immutable JSON snapshot + REP evidence (or <root>/items/<key>.json)

zotero_to_rep does not download PDFs. When you need page-level anchors, run doc_anchor on the attachment path — the bridge keeps the path in the metadata so the two plugins can meet.

Install

dsh plugin --profile <name> add dsh-zotero-bridge
dsh --profile <name> --dump-config | grep dsh-zotero-bridge

Then:

Run zotero_status.

If it reports unavailable, start Zotero and enable the Local API, or set dataDir to the directory that holds zotero.sqlite.

Configuration

KeyDefaultMeaning
enabledtruefalse mounts nothing
root.zotero-bridgeitem-record fallback root
localApiUrlhttp://127.0.0.1:23119loopback only; any other host fails validation
dataDirauto-detectZotero data directory (or the zotero.sqlite file)
timeoutMs10000per-request deadline
maxResults25search cap (1–100)

What it does not do

  • No writes. No create/update/delete, no notes, no tags, no collections, no trash.
  • No sync. It never talks to api.zotero.org.
  • No PDF download or parsing. Attachment metadata only; use dsh-doc-anchor for text.
  • No Web API keys. The Local API needs no account or key.
  • No silent fallback. If both modes fail, the tool reports unavailable with steps.

Compatibility

Zotero7+ (Local API opt-in); sqlite fallback reads Zotero 6/7 schema
Node^22.19.0 || >=24.9.0 (sqlite uses node:sqlite)
DeepSeek Harnesspeer line >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0
Peers@perrylink/dsh-research-core ^0.1.0, @deepseek-ai/cordis, @deepseek-ai/dsh-tools, @deepseek-ai/schemastery
Runtime dependencieszero

Development

pnpm install
pnpm run check:lockfile
pnpm typecheck
pnpm test          # fixture DB + mock Local API; no Zotero required
pnpm build
pnpm verify:package

The lockfile is committed exactly as pnpm install --lockfile-only writes it (two documents: pnpm's own package-manager document, then the project document), so a local install does not rewrite it. pnpm run check:lockfile fails when the lockfile drifts from package.json or loses that form.

The sqlite test creates a minimal Zotero-shaped database in a temp directory; the Local API test uses a scripted fetch. Real-library acceptance is manual: run zotero_status on a machine with Zotero.

License

Apache-2.0. See LICENSE.

Comments

Loading…