dsh-zotero

English | 中文

DeepSeek Harness 的 Zotero 工具插件：让 agent 直接检索你的 Zotero 文献库、阅读条目元数据与摘要、列出分类和 PDF 附件、把 PDF 下载到工作区阅读、代写读书笔记。通过 Zotero 本地 API（7 代及以上可用，实测 9.x；http://127.0.0.1:23119）访问，无需 API Key，纯 Node 实现，零核心改动。

前置条件

1. 本机安装并运行 Zotero 7 及以上（本地 API 自 7 代引入；本项目在 Zotero 9.0.6 / Windows 上实测通过）；
2. 打开 Zotero：设置 → 高级 → 通用 → 勾选「允许本机上的其他应用程序与 Zotero 通信」。

兼容性说明：读取类工具（检索/条目/全文/附件路径/笔记读取）在 Zotero 9 上全部实测通过。笔记写入（create/append/update/delete）受本地 API 只读限制不可用（见工具表说明）。

工具一览

工具	作用
zotero_collections	列出文献库的所有分类（collectionKey + 条目数），用于限定检索范围
zotero_search	按关键词检索文献库（标题/作者/年份），支持条目类型、分类、标签、年份区间（sinceYear/beforeYear）、排序、分页；mode 控制返回粒度省 token
zotero_recent	列出最近添加的条目（"我刚导入的文献"场景）
zotero_item	按 key 读取条目详情：作者、期刊、DOI、摘要、标签、附件列表
zotero_fulltext	读条目全文纯文本：优先读 Zotero 全文缓存（.zotero-ft-cache，零下载），无缓存时自动下载 PDF 到工作区
zotero_attachment_path	返回附件在 storage 的原始绝对路径，让 read 工具零拷贝直读
zotero_download	把条目的 PDF 附件下载到会话工作区（默认），供模型用 read 工具阅读
zotero_notes	列出某条目的子笔记，或全库按关键词搜笔记正文
zotero_note	笔记写入：create 新增 / append 追加 / update 更新 / delete 删除。⚠️ 实测多数版本的本地 API 为只读（POST/PATCH/DELETE 未开放），写操作会返回明确提示并建议手动操作

示例对话：

在我的 Zotero 里搜一下 transformer 相关的论文，挑 2020 年以后的，把第一篇的全文读一遍，给我写个摘要存进笔记。

安装

dsh plugin --profile web add dsh-zotero

或从 GitHub 安装：

dsh plugin --profile web add github:/dsh-zotero#