Vncntvx/dsh-zotero

README 摘要

dsh-zotero English · 中文 让 Agents 搜索、阅读并引用你的本地 Zotero 文献库：找文献、查看笔记与批注、按问题取证、打开原文、生成引用。 在会话里用自然语言描述需求，Agent 自动按需调用下面的工具；唯一的手动命令是 /zotero status 。 工具 工具 用途 zotero search 发现：按标题/作者/年份搜索库里的资料， everything 模式连全文索引一起搜；可限定某个分类或已保存搜索 zotero get 检查：读取一条资料的结构化核心元数据，可选检查笔记、注释、附件的清单与预览。 zotero retrieve 取证：按问题返回最相关的有界证据片段（注释、笔记、摘要、全文分块） zotero attachment 原文：解析条目或附件 ref，返回原始附件已验证的磁盘路径或链接 URL zotero export 引用：让 Zotero 按自己的 citation/export 能力生成结果（引用、CSL 参考文献表、 bibtex / biblatex / ris / csljson ）。 使用示例 Agent 按需求逐层深入，一段典型对话： 用户：「帮我找 FlashAttention 相关论文」 Agent → zotero search ，返回候选条目与 ref。 用户：「第一篇是什么？我以前读过吗？」 Agent → zotero get ：元数据、17 条批注、2 条笔记与有限预览。 用户：「我当时对 evaluation 有什么意见？」 Agent → zotero retrieve(query:"evaluation", sources:["annotations","notes"]) ，返回相关笔记与批注证据。 用户：「论文自己怎么解释 memory efficiency？」 Agent → zotero retrieve(query:"memory efficiency", sources:["fulltext","abstract"]) ，返回摘要与全文片段。 用户：「我要看原 PDF」 Agent → zotero attachment(条目 ref) ，返回已验证的文件路径；若当前 Harness 配置了 PDF/file 读取能力，再交给该能力继续分析。 用户：「把这三篇生成 APA 参考文献表」 Agent → zotero export(format:"bibliography", style:"apa") 。 命令 /zotero status 报告连通性、API/schema 版本和数据库身份标识（Server ID，Zotero 10+）。这是唯一的健康检查。普通调用失败时返回带类型的领域错误。 按需工作与连接失败交互 - 插件常驻但完全请求驱动：加载、闲置、…

分类