Back to directory

dsh-plugin-zotero

In a curated listMaintenance: Active

peijiping/dsh-plugin-zotero

Browses, reads, cites, and optionally edits a local Zotero library from DSH, including PDF annotations, notes, and MCP-assisted organization.

View on GitHub
$ dsh plugin --profile <profile> add dsh-plugin-zotero

19

stars

1

forks

TypeScript

Language

MIT

License

2026-10-08

Created

2026-11-20

Last push

MIT-licensed TypeScript DSH plugin that turns a local Zotero library into a reading and citation workspace inside DeepSeek Harness — PDF reading tabs, citation capsules, MCP-backed model tools and opt-in write access.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-16

License

MIT

01What can it help you accomplish?

  • Read a paper with the model in the same window: the right sidebar lists the library, a double-click opens the item as its own reading tab, and an excerpt taken from the text lands in the session draft as a citation

    A reading tab with the PDF rendered full-page and highlights overlaid in place, a citation capsule written into the draft (not sent), and the model continuing from the quoted passage

    Researchers, students and writers who read literature while talking to a model and are tired of switching between the Zotero window and the chat window

  • Hand the library chores to the model: search the library, read PDFs, sum up highlights and notes, open a collection per topic and file items into it, or import a paper you already downloaded

    Collections created, renamed or filled, items moved in and out, local PDFs imported, and translated copies hung back onto their item as an attachment

    People whose Zotero library has drifted into a pile, and anyone who wants the raw material for a literature review gathered without clicking through Zotero

  • Keep writing switched off until you decide otherwise — read and cite only, or turn write access on and highlight and annotate from the DSH reading page while the model edits the library

    A strictly read-only pane by default; after the switch and the Zotero authorization, highlights, underlines and notes that land in your real local Zotero library with no plugin-side copy

    Anyone who does not want an AI-adjacent tool mutating their reference library, and users who do want in-page annotation without leaving DSH

02How to install into DeepSeek Harness

Prerequisites

  • A local Zotero desktop install that is running — the plugin reads the library on your machine, not the Zotero cloud
  • DSH desktop ≥ 0.2.1-rc.3 — `engines.dsh` is `>=0.2.1-rc.3 <0.3.0-0`
  • Zotero's local API allowed: 「允许此计算机上的其他应用程序与 Zotero 通信」 ticked under Zotero → Settings → Advanced
  • For the model side: the Zotero MCP Plugin (`zotero-integrated-mcp`) installed in Zotero, listening on `http://127.0.0.1:23120/mcp`, with 「允许写操作」 ticked

Installation steps

  1. 01

    In DSH open 「设置」 → 「插件市场」; if it says there is no plugin index yet, click 「添加索引源」 and add `https://awesome-dsh-plugin.com/index.json` (once only)

  2. 02

    Under 「发现」 search `zotero`, open dsh-plugin-zotero (author peijiping), click 「安装」 and confirm the dialog

  3. 03

    Restart DSH when asked

  4. 04

    Shell equivalent: `dsh plugin --profile <profile> add dsh-plugin-zotero` — the package ships prebuilt `lib/` + `client/client.js`, so no build script runs and no `allowBuilds` grant is needed

    $ dsh plugin --profile <profile> add dsh-plugin-zotero

  5. 05

    In Zotero add the Zotero MCP Plugin from 「工具 → 插件」 (marketplace search `mcp`, first row, package `zotero-integrated-mcp`) and tick 「允许写操作」 in its settings

  6. 06

    In Zotero turn on 「允许此计算机上的其他应用程序与 Zotero 通信」 under Settings → Advanced

Verify the integration

  • After the restart the right sidebar shows a 「Zotero 文献库」 entry and the Settings list gains a 「Zotero文献库」 page
  • Open Settings → Zotero文献库: the four blocks (write permission, API settings, MCP settings with the tool list, selection translation) are correct on their defaults, and edits auto-save and apply without a restart
  • Sanity-check the local API in a browser: `http://127.0.0.1:23119/api/` answering `Zotero is running` means the channel is open
  • Open the sidebar panel: the status bar reports the connection state and the collection tree lists your Zotero collections

03DSH integration and capability boundaries

DSH integrationNative runtime

DSH plugin — registers a 「Zotero 文献库」 panel in the right sidebar and its own 「Zotero文献库」 settings page, serves the pane through self-registered `/dsh-zotero/api/*` host routes, and registers the integrated MCP's tools to the model as `mcp__zotero__*`; installed with `dsh plugin --profile <profile> add dsh-plugin-zotero`

  • Sidebar Zotero library pane

    Adds a 「Zotero 文献库」 pane to the right sidebar, next to every sessionBrowsing only: the pane offers no button to create, rename or delete a collection — that is left to the modelRemembers the selected collection, expanded state and splitter width on this machine
  • In-place reading page with a single outline

    Opens an item in a tab on top of the right sidebar; double-clicking the same item only returns to the tab that already existsEvery open detail tab keeps its own expansion and scroll state while you switch between tabsBuilds the outline itself, since neither the local API nor the integrated MCP carries outline data
  • Citations written into the session draft

    Writes into the session draft only — nothing is sent automatically and focus is not stolenDraft capsules only expand while this plugin is enabled; disabling or uninstalling it makes the send fail with a missing-source error
  • Model-side Zotero tools over the integrated MCP

    Registers the integrated MCP's tools to the model as `mcp__zotero__*`, filtered by the per-tool switches in the settings pageThe plugin's own annotation and note write tools are only registered once write permission is on
  • Selection translation overlay

    Sends the selected text to the chosen service: Bing's translation endpoint, or your own account's model for DeepSeek 精翻
  • Screenshot into the conversation

    Sends one image attachment plus a `截图:` capsule as a single messageBurns a 「Zotero 截图」 watermark with the title and page range into the bottom of the image, so a forwarded picture keeps its source

04Who is it for? When not to use it?

Good for

  • Researchers, students and writers who read literature while talking to a model and are tired of switching between the Zotero window and the chat window
  • People whose Zotero library has drifted into a pile, and anyone who wants the raw material for a literature review gathered without clicking through Zotero
  • Anyone who does not want an AI-adjacent tool mutating their reference library, and users who do want in-page annotation without leaving DSH

Not for

  • It reads the Zotero library on your own machine, never the Zotero cloud, and DSH desktop must be at least 0.2.1-rc.3 — `engines.dsh` pins the range to `>=0.2.1-rc.3 <0.3.0-0`.
  • Zotero does not let other programs read its library by default: until 「允许此计算机上的其他应用程序与 Zotero 通信」 is ticked under Settings → Advanced, the pane reports 「Zotero 未连接」 and nothing reaches the model either.
  • Write access needs two separate things — the 「允许写入 Zotero」 switch and a Zotero authorization in which you must pick 「始终允许」 — and even then deletions are hard deletes that never reach the trash and cannot be undone; a one-shot 「允许」 key dies after the first write.
  • The model has no Zotero tools unless the Zotero MCP Plugin is installed and running on 23120, and with 允许写操作 switched off inside it the model can still read but gets 「写操作已禁用」 the moment it tries to create a collection.

05Compatibility, maintenance and safety notes

  • It reads the Zotero library on your own machine, never the Zotero cloud, and DSH desktop must be at least 0.2.1-rc.3 — `engines.dsh` pins the range to `>=0.2.1-rc.3 <0.3.0-0`.
  • Zotero does not let other programs read its library by default: until 「允许此计算机上的其他应用程序与 Zotero 通信」 is ticked under Settings → Advanced, the pane reports 「Zotero 未连接」 and nothing reaches the model either.
  • Write access needs two separate things — the 「允许写入 Zotero」 switch and a Zotero authorization in which you must pick 「始终允许」 — and even then deletions are hard deletes that never reach the trash and cannot be undone; a one-shot 「允许」 key dies after the first write.
  • The model has no Zotero tools unless the Zotero MCP Plugin is installed and running on 23120, and with 允许写操作 switched off inside it the model can still read but gets 「写操作已禁用」 the moment it tries to create a collection.
2026-10-082026-11-13v0.7.0

MIT · latest release v0.7.0 (2026-11-12) · TypeScript DSH plugin, last push 2026-11-13

06Frequently asked questions

How do I install dsh-plugin-zotero into DeepSeek Harness?

Open DSH → 「设置」 → 「插件市场」, add `https://awesome-dsh-plugin.com/index.json` as an index source once, search `zotero` under 「发现」 and install dsh-plugin-zotero, then restart DSH. The CLI route is `dsh plugin --profile <profile> add dsh-plugin-zotero`: the package ships prebuilt `lib/` + `client/client.js`, so nothing is built at install time and no `allowBuilds` grant is needed. DSH ≥ 0.2.1-rc.3 is required.

What does it actually add inside a DSH session?

A 「Zotero 文献库」 pane in the right sidebar plus a 「Zotero文献库」 page in Settings, a reading tab per item with the PDF rendered full-page and highlights overlaid, and citation capsules written into the current session draft — capsules are never sent automatically and expand into the full citation text only when you send. Draft capsules belong to the plugin: disable or uninstall it while one is in the draft and the send fails with a missing-source error until you delete the capsule.

How do I control what the model is allowed to change?

Two layers, both required. The 「Zotero 写权限」 switch decides whether write entries exist at all and whether the plugin registers its own annotation/note write tools to the model; the Zotero authorization decides whether Zotero accepts the write, so pick 「始终允许」 — a one-shot 「允许」 key is deleted after the first write. The integrated MCP's 25 tools include 10 write tools (`write_item`, `create_collection`, `delete_collection`, …) that can be switched off one by one under Settings → Zotero文献库 → MCP 工具. Writes go straight into your local Zotero library with no plugin-side copy, and deletions are hard deletes that never reach the Zotero trash.

Where does the write authorization live?

In `~/.dsh/storages/dsh-plugin-zotero/local-api-key.json` with mode `0600`, read and written only by the host process — it never shows up in a form or in the config store. Revoke the local API authorization inside Zotero and the next refused write drops that local copy and returns the pane to 未授权; switching 「允许写入 Zotero」 off puts everything back to strict read-only.

What are the practical limits?

The pane needs local Zotero running with 「允许此计算机上的其他应用程序与 Zotero 通信」 ticked — `http://127.0.0.1:23119/api/` should answer `Zotero is running` — and the model side additionally needs the Zotero MCP Plugin on `http://127.0.0.1:23120/mcp` with 允许写操作 ticked. Fulltext handed to the model is capped at 204800 bytes by default, one selection translation at 4000 characters, screenshots at 20 PNGs of up to 50 MB each per session — and screenshots need a vision-capable model (`deepseek-flash` works, `deepseek-v4-pro` is rejected at send time).

08Data and sources

  • Author-claimedgithub.com5ac3ffe07ffc…

    dsh plugin --profile <profile> add dsh-plugin-zotero

  • Author-claimedgithub.com5ac3ffe07ffc…

    插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在「设置 → Zotero文献库 → MCP 工具」里逐项启用 / 禁用。

  • Author-claimedgithub.com5ac3ffe07ffc…

    Host 路由为 `GET /dsh-zotero/api/<action>`,action 有 `health` / `tree` / `items` / `tags` / `item` / `collection-bib` / `mcp…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-16. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.