前言¶

在 DSH 里做写作、调研或 agent 工作流时，文献往往散落在本机 Zotero、PDF 文件夹和对话上下文之间。通用对话可以总结一段文字，却难以直接改你正在用的 zotero.sqlite，也难以在 Word 里生成与 Zotero 兼容的引文域。社区插件 dsh-zot-library（维护者 GenePad，SkillHub 分类：记忆）把 Zotero 兼容的文库、阅读、导出和 Word 引文集成收进 DSH web 侧栏。下面按「是什么 → 能做什么 → 安装 → 界面与用法 → Word 引文 → 注意」说明。

这是什么¶

dsh-zot-library 是面向 DeepSeek Harness (dsh) 的第三方文献管理插件。它可以在 DSH 里浏览和编辑真实的 Zotero 数据库（zotero.sqlite），支持 PDF 导入与联网元数据检索、批注与内置阅读、WebDAV 附件同步、悬浮「文献助手」对话 dock，以及移植自 Zotero 的 Microsoft Word 参考文献插件。当前 npm 包版本为 0.5.1，许可证 MIT。

与「只在对话里贴 PDF 摘要」的做法相比，该插件把条目、附件、笔记和引文写回文库本身，并暴露约 20 个 library_* agent 工具，供任意 dsh 会话检索与修改文库。

核心功能¶

文库管理¶

• 分类树、标签、回收站；文献列表可排序、可自定义列。
• 条目字段、标签、分类、批注、笔记、附件直接写入 Zotero 数据库（写入时 synced=0，Zotero 客户端自身的同步仍可照常上传）。

导入与元数据¶

• PDF 拖入列表即导入；也可通过 DOI、arXiv、ISBN、PMID、题名联网检索（Crossref，摘要可回退 OpenAlex / PubMed）。
• 元数据不全时可一键交给 AI 补全；仅有 DOI 或题名、没有文件也能建条目并联网补全。

阅读与批注¶

• 双击打开 PDF：内置 pdf.js（高亮、下划线、批注、全文查找、旋转、分屏、划词 AI 翻译），或使用系统默认阅读器；外部阅读器新增批注可回写 Zotero。
• 无 PDF 的条目可在浏览器打开网页链接或 DOI。

文献助手与 Agent¶

• 文献列表底部 dock 自动跟随当前浏览/阅读的文献，可检索、整理、总结文库、写笔记，并派发「AI 补全元数据」等任务。
• 全部 library_* 工具在任意 dsh 会话中可用（不限于文献助手界面）。

导出与 Word¶

• 全库一键导出 CSL JSON / BibTeX。
• Word 功能区「文库引用」选项卡：Zotero 兼容域代码、citeproc 排版、CSL 样式在线安装；支持「自动检索引文」「AI 修改」写回真实引文域并重算参考文献表。不开 Word 时也可由 AI 生成带真实引文与参考文献表的 .docx 报告。

定时维护（配合 dsh）¶

dsh 内置定时任务可配合本插件 agent 工具，让文献助手定期维护文库（例如导入后自动联网补元数据、条目交给 AI 补全或重新获取）。

安装与启用¶

终端执行官方安装命令，安装后重启 dsh 生效：

dsh plugin --profile web add dsh-zot-library

也可以在 dsh 插件安装入口三选一：让 harness 从 https://github.com/GenePad/dsh-zot-library 安装、填写 npm 包名 dsh-zot-library，或填写上述 GitHub 地址。

旧包名 dsh-zlibrary 已弃用：已装旧版请先在插件管理器卸载，再用新包名重装。

插件面向 web profile；package.json 要求 Node >=24.9。安装前建议在 GitHub 查看源码与 MIT 许可证；插件以当前 dsh 进程权限运行，关联本机 Zotero 前请确认数据目录路径可信。

进入主界面¶

点击左侧栏底部的「文库」按钮（与设置同排），主栏切换为整页图书馆：左栏分类/标签/回收站，中栏文献列表，右栏条目详情。再次点击「文库」或切换面板即回到对话模式。

首次打开会询问：关联本机 Zotero（自动定位 zotero.sqlite）或使用独立文库（存放在 dsh 数据目录；可在设置中切换或导出迁移到 Zotero）。

典型用法¶

导入与编辑¶

1. 将 PDF（可多选）拖入中栏列表；或点工具栏魔棒，按 DOI / ISBN / arXiv / PMID / 题名逐条入库。
2. 元数据不全时，在导入卡上点「用 AI 补全元数据」。
3. 左栏选分类或标签；中栏多选条目（Ctrl / Shift）；右栏点击字段编辑；底部分区管理附件、批注、笔记、分类、标签。
4. 条目右键可打开附件、复制 BibTeX / CSL JSON、合并条目、检索元数据等。

阅读¶

双击条目打开 PDF。内置查看器中选中文本可高亮、下划线、批注或使用「译」做 AI 翻译；工具栏支持缩放、跳页、查找、旋转、横纵向分屏。

文献助手¶

中栏底部一行点开对话面板；「新对话」开新会话，↗ 可跳到 dsh 原生对话界面。提问时会自动带上当前文献上下文。

设置（齿轮）¶

可配置数据来源、PDF 打开方式（内置 / 系统）、Word 写作插件、AI 翻译模型、插件更新源（默认 GitHub 官方源，填 off 关闭自动更新）。

Word 参考文献¶

方式一：Microsoft Word 插件

1. 在 dsh 打开 设置 → 文库 → 写作插件，点「一键安装」（将预构建的 DshLibrary.dotm 复制到 Word 启动目录，不调用 Word、无需管理员）。
2. 完全退出并重启 Word，出现「文库引用」选项卡。
3. 「引文格式设置」选择 CSL 样式（APA、IEEE、GB-T 7714 等，未安装的可在线检索安装）；在正文插入/编辑引文与参考文献表，引注与文末表会自动重算。
4. 在 Word 中选中文本后，功能区 自动检索引文 会唤起文献助手从本地文库配引文并写回；AI 修改 在 dsh 中写下修改要求后，AI 改写（可带引文）并替换回 Word 选中段落。

适用场景与注意¶

适合：已在用 Zotero 或希望文库与 Word 引文格式兼容的研究者；需要在 agent 对话中直接 library_* 检索、改条目、导出 BibTeX/CSL 的 DSH 用户；希望 PDF 阅读批注回写文库、并用文献助手跟读单篇文献的场景。

注意：

• 写库行为与 Zotero 客户端并发使用时，需理解 synced=0 与自有同步策略。
• WebDAV 文件同步、Word 加载项安装路径均在本机环境生效，升级 dsh 或插件后若异常，可先查设置中的更新源与写作插件状态。
• 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库为准。

结尾¶

dsh-zot-library 把「真实 Zotero 文库 + 阅读批注 + Agent 工具 + Word 兼容引文」装进 DSH 左侧「文库」入口，适合要把文献知识沉淀进 harness 记忆类工作流的开发者与用户。安装命令见上文；更多信息见 SkillHub 目录 与 GitHub：GenePad/dsh-zot-library。