dsh-zotero · Zotero 文献全文检索插件

一个用于 DeepSeek Harness（DSH）的插件：连接本机 Zotero，对整个文库中所有文献的 PDF 全文建立索引。之后既可在「Zotero 文献」面板中检索，也可在对话中让 AI 检索并阅读文献全文。检索时可按分类（collection）名称限定范围（含子分类），不填则检索整个文库。

面向非计算机专业用户的上手指南见 docs/快速指南.md。

功能

• 全文索引：优先使用 Zotero 自带的全文索引；若无，则直接读取 PDF 并解析文本层。扫描件（纯图片）无法解析，会如实报告，不影响其余文献。
• 面板检索：侧边栏新增「Zotero 文献」面板，可配置连接、建立索引、检索（可限定分类）并逐块阅读全文。
• 对话检索：在对话中直接提问，AI 会自动调用检索工具查询文献并阅读相关段落。

安装

前置条件

• 运行 Zotero 7（或更高版本）；
• 开启本地 API：编辑 → 设置 → 高级 → 勾选「允许其他应用与 Zotero 通信」。

从 GitHub 下载安装

git clone https://github.com/<你的用户名>/dsh-zotero.git
cd dsh-zotero
npm install          # 安装 PDF 解析依赖（必做）

然后打开 DSH → 「插件」页面 → 「安装插件 / Install bundle」→ 选择 dsh-zotero 文件夹 → 安装并启用 → 刷新页面，左侧栏出现「Zotero 文献」图标。

注意：DSH 以目录链接方式安装，不会自动安装插件的 npm 依赖，因此必须先运行一次 npm install（或 pnpm install）。

打包成 zip 安装

将整个文件夹（已运行过 npm install）压缩为 zip，在 DSH 插件管理界面中选择该 zip 安装。

更新

代码更新后，在 DSH 插件管理里重新安装该文件夹即可。文献索引与设置保存在 ~/.dsh-zotero/，不会丢失。

使用

1. 打开左侧栏「Zotero 文献」面板；
2. 在「1. 连接设置」中填写本地服务地址（默认 http://localhost:23119/api），点「测试连接」确认成功后「保存设置」；
3. 在「2. 全文索引」中点「建立 / 更新索引」，等待完成（首次可能需要几分钟）；
4. 之后即可：
   • 在「3. 全文检索」中输入关键词检索（可选填「限定分类」），点「阅读全文」逐块阅读；
   • 或直接在对话中说「检索我的 Zotero 文献中关于 XXX 的文章」，AI 会自动检索；提及分类名时自动限定至该分类。

常见问题

问题	解决办法
测试连接失败 / 无法连接	确认 Zotero 正在运行、已勾选通信开关、地址为 http://localhost:23119/api
限定分类时报「索引中没有这个分类」	该分类可能为新建，点「建立 / 更新索引」后再试
某些文献没有全文	该文献无 PDF 附件或为扫描件，在 Zotero 中执行「识别文本 / OCR」后更新索引
文献库有新增	点「建立 / 更新索引」，或在对话中让 AI 更新索引
换电脑 / 换端口	重新填写地址并保存，插件会清除旧索引

许可

MIT