前言¶
在 DSH（DeepSeek Harness）中做智能体时，如果论文和资料存放在本地 Zotero，通常会遇到几个具体动作：按关键词找文献、读条目摘要、打开 PDF 全文、确认附件路径、把阅读结果写进笔记。这些资料在本地应用里，agent 如果没有对应工具，就只能依靠人工整理。
dsh-zotero 是 DeepSeek Harness 的 Zotero 工具插件。它让 agent 通过 Zotero 本地 API 访问本机文献库，无需 API Key，用于检索文献、读取元数据与摘要、查看附件、读全文以及处理笔记。
这是什么¶
dsh-zotero 是 DeepSeek Harness 的 Zotero 工具插件，由 Hongcheng-LI 维护，许可证为 MIT。
它的一行定位是：让 agent 直接检索你的 Zotero 文献库、阅读条目元数据与摘要、列出分类和 PDF 附件、读 PDF 全文、代写读书笔记。
它通过 Zotero 本地 API 访问，默认地址为：
http://127.0.0.1:23119
使用前提是本机已安装并运行 Zotero 7 及以上，并且开启：
Settings → Advanced → 允许本机上的其他应用程序与 Zotero 通信
资料说明该项目在 Zotero 9.0.6 / Windows 上实测通过。
核心功能¶
下面介绍插件提供的工具。
检索与条目¶
1、zotero_collections：列出文献库的所有分类，返回 collectionKey 和条目数，用于限定后续检索范围。
2、zotero_search：按关键词检索文献库，支持条目类型、分类、标签、年份区间、排序、分页；mode 控制返回粒度。
3、zotero_recent：列出最近添加的条目。
4、zotero_item：按 key 读取条目详情，包括作者、期刊、DOI、摘要、标签、附件列表。
全文与附件¶
1、zotero_fulltext：读取条目全文纯文本。优先读 Zotero 全文缓存；无缓存时解析本地 PDF 并写缓存；远程链接附件才下载到工作区。
2、zotero_attachment_path：返回附件在 storage 的原始绝对路径。
3、zotero_download：把条目的 PDF 附件下载到会话工作区。
笔记¶
1、zotero_notes：列出某条目的子笔记，或全库按关键词搜索笔记正文。
2、zotero_note：支持 create / append / update / delete。注意：笔记写操作受 Zotero 本地 API 只读限制，多数版本不可用；工具会返回明确提示并建议手动操作。
安装与启用¶
先确认 Zotero 已按上面要求启动并开启本地通信。然后执行：
dsh plugin --profile web add dsh-zotero
装好后重启 dsh web。
package.json 声明 node >=20，并声明 peerDependencies 包含 @deepseek-ai/cordis ^4.0.1。
注意：插件会以当前 dsh 进程权限运行。安装前应检查源码、依赖和 MIT 许可证，确认它只会访问你本机允许的 Zotero 数据。
可选配置¶
如果需要使用不同的 Zotero 地址、库、下载目录或数据目录，可以在你使用的 profile 的 cordis.patch.yml 中覆盖 tool-zotero 行，然后重启。
可选配置项包括：
baseUrl
library
downloadDir
dataDir
storageDir
maxAttachmentBytes
maxFulltextChars
maxLimit
timeoutMs
示例结构如下。这里 baseUrl 可填本机 Zotero 本地 API 地址；其余配置项可按本机 Zotero 数据目录和下载需求填写：
- id: tool-zotero
config:
baseUrl: http://127.0.0.1:23119
library:
downloadDir:
dataDir:
storageDir:
maxAttachmentBytes:
maxFulltextChars:
maxLimit:
timeoutMs:
修改后重启。
典型用法¶
仓库资料给出的示例对话是：
在我的 Zotero 里搜一下 transformer 相关的论文，挑 2020 年以后的，把第一篇的全文读一遍，给我写个摘要存进笔记。
这句话会涉及 zotero_search、zotero_fulltext 和笔记相关工具。其中“存进笔记”依赖 zotero_note 的写操作；如果本机 Zotero 本地 API 只读，写操作会返回明确提示并建议手动操作。
适用场景与注意¶
适合：
- 本机已有 Zotero 7 及以上文献库；
- 希望 DSH agent 直接读取论文元数据、摘要、PDF 全文和附件路径；
- 需要把本地 Zotero 作为 agent 的资料源。
注意：
- 需要本机 Zotero 正在运行；
- 需要开启本地 API 通信；
- 笔记写操作多数版本不可用；
- 插件以 dsh 进程权限运行，安装前应审查源码和许可证；
- DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应视为官方应用商店。
结尾¶
dsh-zotero 的价值是把本地 Zotero 文献库变成 DSH agent 可直接调用的工具：检索文献、读取元数据、读取全文、获取附件路径、处理笔记读取。它依赖本机 Zotero 本地 API，而不是把文献库迁移到云端。
GitHub：
https://github.com/Hongcheng-LI/dsh-zotero
目录页 URL 未在已核实资料中确认，本文不给出具体地址；可在 DSH 社区目录中按 dsh-zotero 检索。
