Hongcheng-LI/dsh-scientific--plugins-zotero0

dsh-zotero

用于 DeepSeek Harness 的 Zotero 工具插件:支持通过 Zotero 本地 API 搜索文献库、读取条目元数据、列出集合与附件、下载 PDF 并附加笔记。

AI 分析

核心用途是连接本地 Zotero 文献库进行学术文献检索与管理。适合需要频繁阅读、整理 PDF 论文及元数据的科研人员。必要条件是本地需运行 Zotero 客户端并开启本地 API。

包名
dsh-zotero
版本
0.1.0
许可证
MIT
最近更新
2026年8月14日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Hongcheng-LI/dsh-scientific#f0b39d7055539ba8e07baa75a0c1b57263e1b1dc&path:plugins/zotero

配置(可选)

默认配置即可用(本地库、端口 23119)。如需自定义,在你的 profile($DSH_HOME/profiles//)的 cordis.patch.yml 里覆盖 tool-zotero 行,然后重启:

- id: tool-zotero
  config:
    baseUrl: http://127.0.0.1:23119   # Zotero 本地 API 地址
    library: user                      # user(我的文献库)或 group:
    downloadDir: D:/papers             # 附件下载目录,缺省存到会话工作区
    dataDir: D:/ZoteroData             # Zotero 数据目录(含 profiles.ini),默认自动探测
    storageDir: .../zotero/storage     # 直接指定 storage 目录(zotero_fulltext / attachment_path 用)
    maxAttachmentBytes: 67108864       # 单附件下载上限,默认 64MB
    maxFulltextChars: 80000            # zotero_fulltext 返回的最大字符数,默认 80000
    maxLimit: 50                       # 检索结果条数上限,默认 50
    timeoutMs: 15000                   # 本地 API 超时(毫秒)

全文与附件路径:插件通过本地 API /file 端点的 302 重定向拿到附件的真实磁盘路径(自定义数据目录也能自动识别,无需配置),全文优先读 Zotero 自己维护的 .zotero-ft-cache 缓存(与附件同目录)。dataDir/storageDir 配置仅在重定向不可用时作为兜底。