Skip to content
  • Home
  • Plugin manual
  • dsh-zotero-wiki

Wechsels/dsh-zotero-wiki

30Last commit Aug 15, 2026

dsh-zotero-wiki DSH plugin

A DeepSeekHarness plugin that turns your Zotero library into a continuously updated Obsidian knowledge base. It incrementally syncs metadata, uses MinerU to parse PDFs, and applies DeepSeek to generate structured notes. The compiled wiki supports agent retrieval with traceable citations.

developer-toolsskills-workflows

How to install the dsh-zotero-wiki DSH plugin

dsh plugin --profile web add file:/path/to/dsh-zotero-wiki

Copying does not run this command. Review the repository and version before installing the dsh-zotero-wiki DSH plugin.

dsh-zotero-wiki DSH plugin data source

dsh-zotero-wiki DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-zotero-wiki DSH plugin can do

  • Dual-source sync: local Zotero SQLite or Zotero Web API with version-cursor incremental updates.
  • PDF parsing via MinerU official platform: upload, poll, and extract Markdown + images.
  • DeepSeek full-text reading: generates structured Chinese notes (abstract, methods, conclusions, etc.) with 100K token cap.
  • Wiki compilation: topic reviews, indexes, cross-links, archive marks, and LINT checks.
  • Agent query tools: minisearch with bigram segmentation, returns snippets with [key, §section] citations.
  • Graceful degradation: fallback to title+abstract notes when PDF unavailable, upgradeable later.

Where the dsh-zotero-wiki DSH plugin fits

  • Researchers automatically organize their Zotero literature into a searchable Obsidian wiki.
  • AI agents answer questions with cited literature, using the query_zotero_wiki tool.
  • Teams collaborate on a shared knowledge base by syncing Zotero collections and running periodic compiles.
  • Students compile literature reviews from multiple PDFs using DeepSeek-generated summaries.

Who the dsh-zotero-wiki DSH plugin is for

  • Academic researchers and students who use Zotero and Obsidian.
  • AI agent developers who want to equip agents with a literature retrieval tool.
  • Obsidian power users looking for an automated literature pipeline.

dsh-zotero-wiki DSH plugin limitations

  • Requires MinerU token (free but limited daily quota) and DeepSeek API key for parsing and note generation.
  • Only supports Chinese note generation (DeepSeek output is in Chinese).
  • Single sync limited to 50 PDFs per run (MAX_PARSE_PER_SYNC), concurrency capped at 3.
  • Still in early MVP stage; vector search, annotation sync, and page-number citations are on the roadmap.
  • No Web UI or multi-user server; operates as a local plugin and CLI tool.

dsh-zotero-wiki DSH plugin: from the repository README

Quoted from the Wechsels/dsh-zotero-wiki README, the upstream source of the dsh-zotero-wiki DSH plugin. Copyright remains with the original authors.

> **中文** | [English](#english) DeepSeekHarness（dsh）× Zotero 插件：自动同步 Zotero 文献库，用 MinerU 解析 PDF、用 DeepSeek 阅读全文，把文献编译成可检索的 Obsidian Wiki，并让 Agent 在回答时附带可追溯的文献引用。 [![][node-badge]][node-link] [![][license-badge]][license-link] [![][repo-badge]][repo-link] [node-badge]: https://img.shields.io/badge/Node.js-%3E%3D22.19-339933?logo=node.js&logoColor=white [node-link]: https://nodejs.org [license-badge]: https://img.shields.io/badge/license-MIT-blue.svg [license-link]: ./LICENSE [repo-badge]: https://img.shields.io/badge/GitHub-Wechsels%2Fdsh--zotero--wiki-181717?logo=github [repo-link]: https://github.com/Wechsels/dsh-zotero-wiki --- ## 项目定位（范围） **是什么**：一个 Node/Cordis 风格的 dsh 插件 + 独立 CLI。它把你的 Zotero 文献库变成一座持续更新的 Obsidian 知识库，并暴露原生工具供 Agent 检索。 **完整链路**： ```text Zotero（本地库 / Web API） └─ sync：增量同步元数据 → .zotero-sync/sync.db（SQLite 状态库） └─ parse：MinerU 官方平台解析 PDF → raw/<topic>/<bundle>/ 原文 + DeepSeek 笔记（<key>-note.md 同束存放） └─ compile：主题综述（_index.md）、索引、交叉链接、归档标记 └─ query：Agent 通过 query_zotero_wiki 检索 raw 笔记，回答附 [Zotero key, §章节] 引用 ``` **明确不做**（保持轻量）：向量数据库、自动聚类、多用户服务端、定时后台服务、Web UI、Zotero 注释（高亮/批注）同步、引用页码提取。 --- ## 特性 | 能力 | 说明 | |---|---| | **双源同

Read the full READMERepository license: MIT

dsh-zotero-wiki DSH plugin questions

How do I install dsh-zotero-wiki?

Clone the repository, run `npm install && npm run build`, then use `npx -y @deepseek-ai/dsh plugin --profile web add file:/path/to/dsh-zotero-wiki`. Ensure you have Node.js ≥ 22.19 and a Zotero library (local or Web API).

What configurations are required?

You need to set at least ZOTERO_MODE, OBSIDIAN_VAULT_PATH, and optionally MINERU_TOKEN and DEEPSEEK_API_KEY for parsing. Run `node dist/cli.js sync` to trigger the interactive setup wizard the first time, or manually edit the .env file.

How do I sync my Zotero library?

Run `node dist/cli.js sync` to perform an incremental sync. The first run will ask you to select the sync scope (all, collections, or tags). Subsequent runs reuse the persisted scope silently. You can also use the sync_zotero_wiki tool from within dsh chat.

The parse step is slow or some items stay pending. What should I do?

MinerU free tier has a daily quota of 2000 pages at high priority, after which requests are queued. Lower `MAX_PARSE_PER_SYNC` (default 50) to spread parsing over multiple runs. Also check your MinerU token and network connectivity.

Can I query the wiki from an AI agent?

Yes, the plugin registers three tools: query_zotero_wiki, sync_zotero_wiki, and parse_zotero_wiki. In dsh chat, you can ask the agent to find literature, and it will return results with citations like [Zotero key, §section]. If no results are found, it will clearly state that.