跳到正文
  • 首页
  • 插件说明
  • dsh-zotero-wiki

Wechsels/dsh-zotero-wiki

30最近提交 2026年8月15日

dsh-zotero-wiki DSH 插件

一个 DeepSeekHarness 插件，将 Zotero 文献库转化为持续更新的 Obsidian 知识库。增量同步元数据，使用 MinerU 解析 PDF，并通过 DeepSeek 生成结构化笔记。编译后的 Wiki 支持 Agent 检索并附带可追溯引用。

developer-toolsskills-workflows

如何安装 dsh-zotero-wiki DSH 插件

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

复制不会执行命令。安装 dsh-zotero-wiki DSH 插件前请核对仓库和版本。

dsh-zotero-wiki DSH 插件数据来源

dsh-zotero-wiki DSH 插件快照日期：2026年8月16日

discovered

dsh-zotero-wiki DSH 插件能做什么

  • 双源同步：支持本地 Zotero SQLite 或 Zotero Web API 的版本游标增量同步。
  • PDF 解析：通过 MinerU 官方平台上传、轮询，提取 Markdown 和图片。
  • DeepSeek 全文阅读：生成中文结构化笔记（摘要、方法、结论等），100K token 上限。
  • Wiki 编译：主题综述、索引、交叉链接、归档标记和 LINT 自检。
  • Agent 查询工具：基于 minisearch 和 bigram 分词，返回片段和 [key, §章节] 引用。
  • 优雅降级：无 PDF 时基于标题和摘要生成简版笔记，后续可升级为全文笔记。

dsh-zotero-wiki DSH 插件适合哪些场景

  • 研究人员自动将 Zotero 文献整理成可搜索的 Obsidian Wiki。
  • AI Agent 在回答问题时引用文献，使用 query_zotero_wiki 工具。
  • 团队通过同步 Zotero 合集并定期编译，共建共享知识库。
  • 学生利用 DeepSeek 生成的摘要快速综述多篇 PDF 文献。

dsh-zotero-wiki DSH 插件适合谁

  • 使用 Zotero 和 Obsidian 的学术研究人员和学生。
  • 希望为 Agent 配备文献检索工具的 AI 开发者。
  • 追求自动化文献管线的 Obsidian 高级用户。

dsh-zotero-wiki DSH 插件的限制

  • 需要 MinerU Token（免费但有每日额度限制）和 DeepSeek API Key 才能进行解析和笔记生成。
  • 仅支持中文笔记生成（DeepSeek 输出为中文）。
  • 单轮同步最多解析 50 篇（MAX_PARSE_PER_SYNC），并发数上限为 3。
  • 仍处于早期 MVP 阶段；向量检索、注释同步、引用页码等功能在路线图中。
  • 无 Web UI 或多用户服务端，仅作为本地插件和 CLI 工具运行。

dsh-zotero-wiki DSH 插件的仓库 README 摘录

以下文字摘自 dsh-zotero-wiki DSH 插件的上游仓库 Wechsels/dsh-zotero-wiki 的 README，版权归原作者，仅作引用。

> **中文** | [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 注释（高亮/批注）同步、引用页码提取。 --- ## 特性 | 能力 | 说明 | |---|---| | **双源同

阅读完整 README仓库许可: MIT

dsh-zotero-wiki DSH 插件常见问题

如何安装 dsh-zotero-wiki？

克隆仓库后用 `npm install && npm run build` 构建，然后执行 `npx -y @deepseek-ai/dsh plugin --profile web add file:/path/to/dsh-zotero-wiki`。需要 Node.js ≥ 22.19 和 Zotero 文献库（本地或 Web API）。

需要配置哪些项？

必须设置 ZOTERO_MODE 和 OBSIDIAN_VAULT_PATH，解析功能需要 MINERU_TOKEN 和 DEEPSEEK_API_KEY。首次运行 `node dist/cli.js sync` 会启动交互式配置向导，也可手动编辑 .env 文件。

如何同步 Zotero 文献库？

运行 `node dist/cli.js sync` 执行增量同步。首次运行会要求选择同步范围（全部、合集或标签），后续自动复用。在 dsh 聊天中也可调用 sync_zotero_wiki 工具手动同步。

解析很慢或部分文献一直处于 pending 状态，怎么办？

MinerU 免费版每日有 2000 页高优先级额度，超出后排队降速。建议调小 `MAX_PARSE_PER_SYNC`（默认 50）分多轮执行。同时检查 MinerU Token 和网络连接。

AI Agent 如何查询 Wiki？

插件注册了三个工具：query_zotero_wiki、sync_zotero_wiki 和 parse_zotero_wiki。在 dsh 聊天中让 Agent 查找文献，它会返回结果并附带 [Zotero key, §章节] 引用。无命中时明确告知。