Zotero 文献检索 H-xie/zotero4DSH

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