dsh-zotero：在 DeepSeek Harness 中浏览和引用 Zotero 文献库的 DSH plugin

dsh-zotero 是 DeepSeek Harness（DSH）的 Zotero 集成插件（DSH plugin），它让你在 DSH 的右侧边栏中直接浏览、搜索并引用本地 Zotero 文献库，无需 API key。该插件解决了在编写 prompt 时频繁切换窗口查找文献的痛点，通过文件树、内联搜索和斜杠命令，将文献引用无缝注入输入框。核心能力包括 Zotero 文件树、双击引用、& 内联搜索、/zotero 命令、模型工具 resolve_zotero_ref 以及 Zotero 深链。由 yuzh2001 维护，采用 TypeScript 编写，最近更新于 2026-08。

dsh-zotero 这个 DSH 插件支持哪些核心特性？

• Zotero 文件树：在基于 dsh-better-sidebar 的右侧栏中渲染 Zotero 文库，支持收藏夹层级和懒加载，直接读取本地 zotero.sqlite。
• 双击引用：双击论文或文件夹，在输入框注入可读引用 《论文题名》{%ZoteroItem:key%}，纯文本无破坏。
• & 内联搜索：在输入框输入 & 弹出搜索层，按标题或作者搜索，方向键选择后插入引用。
• /zotero 命令：斜杠命令打开同一搜索层，交互一致。
• 模型工具：注册 resolve_zotero_ref，模型可解析引用对应的标题、作者、年份和摘要。
• Zotero 深链：悬停引用可跳转 zotero://select/items/... 打开原文。

dsh-zotero 怎么安装？

安装前需确保已安装 DSH（dsh web 可运行）、dsh-better-sidebar、Node.js ≥ 20、pnpm ≥ 10，以及 Zotero 桌面端。推荐使用一键脚本（macOS/Linux 用 curl，Windows 用 PowerShell），或手动执行以下命令：

cd ~/.dsh/profiles/web
pnpm approve-builds --all
echo -e "\nminimumReleaseAgeExclude:\n  - dsa-zotero-sidebar" >> pnpm-workspace.yaml
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsa-zotero-sidebar

安装后硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到 Zotero 标签。更新时重跑 dsh plugin --profile web add dsa-zotero-sidebar 或修改版本号后 pnpm install。

dsh-zotero 兼容哪些 DeepSeek Harness 版本和平台？

该插件作为 npm 包 [email protected] 发布，通过 dsh.bundle.patch 由官方 CLI 自动挂载，不修改 DSH 源码。它依赖 dsh-better-sidebar 作为宿主，支持 macOS、Linux 和 Windows。读取 Zotero 数据库时，默认路径为 %LOCALAPPDATA%/Zotero/zotero.sqlite（Windows）或 ~/Zotero/zotero.sqlite（macOS/Linux），可通过环境变量 DSH_ZOTERO_DIR 自定义。

dsh-zotero 遇到常见问题怎么排查？

• 右侧栏无 Zotero 标签：先安装 dsh-better-sidebar。
• 搜不到论文：检查 Zotero 数据库路径，或设置 DSH_ZOTERO_DIR。
• 报 Ignored build scripts：运行 pnpm approve-builds --all。
• 出现两个 Zotero 标签：删除 cordis.patch.yml 中旧的手动挂载行。

dsh-zotero 的安装脚本做了什么？

一键脚本自动完成 5 件事：检查上游依赖、预写 allowBuilds、预写 minimumReleaseAgeExclude、执行插件添加命令、清理旧挂载。脚本幂等，可安全重复执行。

查看更多 DSH 插件，访问 dsh-plugin.org