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
- 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)
- 02
Under 「发现」 search `zotero`, open dsh-plugin-zotero (author peijiping), click 「安装」 and confirm the dialog
- 03
Restart DSH when asked
- 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
- 05
In Zotero add the Zotero MCP Plugin from 「工具 → 插件」 (marketplace search `mcp`, first row, package `zotero-integrated-mcp`) and tick 「允许写操作」 in its settings
- 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 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 machineIn-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 dataCitations 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 errorModel-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 onSelection 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.
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).
07Related DSH workflows
dsh-univer-office
by dream-num
Give DeepSeek Harness a real office environment. Univer Office Plugin brings spreadsheets, docs, slides, canvases, relational tables, and more into one runtime — with connected data, validation, versioned changes, and isolated worktrees for multi-agent collaboration.
clearai-dsh
by clearailhc
Brings an evidence-checked epistemic loop to DSH: research sessions settle into a browsable domain ontology with evidence chains and support levels; contradictory readings are surfaced for human adjudication.
dsh-fish-memory
by yuuyuko-uu
Stores time-stamped, decaying per-session memories, recalls relevant items, and optionally distills imported local archives through the configured DSH model.
dsh-trading
by zhu1090093659
Agent-native trading terminal built on DeepSeek Harness. Crypto, US, CN and HK in one three-column GUI, 19+ hot-swappable connectors, dry-run by default with human approval on every live order. BYOK, no data redistribution.
08Data and sources
dsh plugin --profile <profile> add dsh-plugin-zotero
插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在「设置 → Zotero文献库 → MCP 工具」里逐项启用 / 禁用。
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.
