🧬DSH 科研工具手册
Zotero × DSH Desktop × 生物信息学
🧩 第 3 部分 · 共 7 部分

③ DSH 插件区(重点推荐)

文献三件套 + 精选插件 + 安装顺序清单 · 本部分 8 小节

插件 = 给 DSH 装"外挂"。 技能(④)是"说明书",插件是"新器官"——它能让 AI 多出一些真正能用的工具,比如直接翻你的 Zotero 文库、解析 PDF、跑 Python、看图片。

⚠️ 先看 3-0 的通用方法,再挑插件;不知道装什么就直接跳到 3-7 清单。

3-0 装插件的通用方法(先看这个)

#三种装法

方法怎么做适合
① 插件市场 ⭐打开 DSH → 插件市场页面 → 搜索插件名 → 点安装 → 重启 App小白首选
② 终端命令 ⭐托盘 → Open DSH Terminal → 打 dsh plugin add <插件名> → 重启 App市场里搜不到的
③ 从 GitHub 装dsh plugin add github:作者/仓库名作者没发到 npm 的

常用命令(在 DSH 终端里打):

sh
dsh plugin add <插件名>       # 安装(默认装到当前用的 profile)
dsh plugin remove <插件名>    # 卸载
dsh plugin update            # 更新已装的全部插件
dsh plugin --profile web add <插件名>   # 指定装到某个 profile

💡 先确认插件到底叫什么名字:去它的 GitHub 页面看 README 的第一段,那里一定写了安装命令。直接抄作者给的命令最稳。 💡 DBH Desktop 的终端已经绑定你当前用的 profile,所以不用每次写 --profile。

#装完必做三件事

  1. 重启 App(托盘右键 → 退出,再打开)—— 90% 的"装了没反应"都是忘了这步
  2. 开一个新会话(旧会话可能没加载到新工具)
  3. 验证:在会话里问一句「你现在有哪些工具?」或「列出你所有的工具」,看新插件在不在

#⚠️ 三个坑,先记住

坑说明
工具名冲突同类插件可能注册同名工具(比如好几个插件都有 zotero_search),同时装会互相打架 → 同类只装一个
依赖要求有的插件要 Zotero 开着、有的要 Node 20+、有的要 Docker/Linux → 装之前先扫一眼 README 的"前置条件"
没写版本号 = 随时会变尽量选 README 里给了明确安装命令、最近有更新的插件

#装之前可以先"体检"(可选但推荐)

插件作用
dsh-plugin-doctor装任何插件前检查:仓库能不能访问、bundle 声明、peer 依赖、和你本地 DSH 版本是否兼容
dsh-plugin-check扫描插件仓库的清单协议 / patch 格式 / 常见踩坑

3-1 ⭐ 文献工作三件套(你点名的)

这三个都是把 Zotero 接进 DSH,但定位完全不同。我先说结论: 日常读文献用第一个,写 LaTeX 论文用第二个,做大综述/批量采集用第三个。

#🔧 三者的共同前置条件(很重要)

  1. 本机装 Zotero 7 及以上(推荐 Zotero 8/9),并且保持运行
  2. 打开 Zotero → 设置 → 高级 → 通用 → 勾选 「允许本机上的其他应用程序与 Zotero 通信」
  3. Zotero 默认监听 http://127.0.0.1:23119,不需要 API Key

检查有没有通:浏览器打开 http://127.0.0.1:23119/api/users/0/items?limit=2,能出 JSON 就是通了。 打不开 = Zotero 没开,或者上面那个勾没勾。


#📚 ① dsh-zotero —— 让 AI 直接读你的 Zotero 文库

安装:

sh
dsh plugin add dsh-zotero

(或从 GitHub:dsh plugin add github:Hongcheng-LI/dsh-zotero,装完重启 App)

它给你的 9 个工具:

工具干什么
zotero_collections列出所有分类(含每个分类的条目数),用来限定检索范围
zotero_search关键词检索(标题/作者/年份),可按类型、分类、标签、年份区间筛选、排序、分页
zotero_recent列出最近导入的条目("我刚加的文献"场景)
zotero_item按 key 读一条的完整元数据:作者、期刊、DOI、摘要、标签、附件
zotero_fulltext读全文纯文本:优先用 Zotero 自己的全文缓存(零下载),没有再现场解析本地 PDF
zotero_attachment_path直接返回附件在硬盘上的绝对路径,让 AI 零拷贝直读
zotero_download把条目的 PDF 下载到你的会话工作区
zotero_notes列出某条目的子笔记,或全库搜笔记正文
zotero_note笔记写入(⚠️ 见下方"注意")

可以这样用(直接抄):

code
在我的 Zotero 里搜一下 "single cell" 相关的论文,挑 2020 年以后的,
把第一篇的全文读一遍,给我写一份结构化摘要,存成笔记。

⚠️ 注意:

  • 笔记写入多数版本用不了 —— Zotero 本地 API 一般是只读的(POST/PATCH/DELETE 没开放),插件会明确提示,不会静默失败。要写笔记还是手动在 Zotero 里写。
  • 附件下载默认存到会话工作区,想固定目录可以在配置里改。

可选配置(在 profile 的 cordis.patch.yml 里改 tool-zotero 行):baseUrl、library(user 或 group:群组ID)、downloadDir、maxAttachmentBytes(默认 64MB)、maxFulltextChars(默认 80000)、maxLimit(默认 50)。


#🔗 ② zotero-mcp-dsh —— 专为写论文 / LaTeX

安装:

sh
dsh plugin add github:LiJunfeng000000000000/zotero-mcp-dsh

装完重启 DSH,工具列表里会出现 mcp__zotero__*。

它给的 5 个工具(都带 mcp__zotero__ 前缀,不会和别的插件撞名):

工具干什么
zotero_search按关键词/集合/年份搜,返回 itemKey、citekey、标题、作者、年份、期刊、DOI
zotero_get_item按 itemKey 取单条完整元数据(摘要、关键词、附件)
zotero_get_fulltext读 PDF 全文(用 Zotero 的全文索引),maxChars 控制长度
zotero_export_bibtex按查询/集合/条目导出 Better BibTeX 风格的 BibTeX 文本(含 citekey)
zotero_list_collections列出全部集合

写作工作流(作者给的 4 步):

code
① 找文献 → ② 用全文核对内容 → ③ 生成 .bib 写进 references.bib → ④ 正文写 \cite{citekey}

⚠️ 注意:

  • 这个插件是只读的,不会改你的 Zotero 库
  • 强烈建议同时装 Zotero 的 Better BibTeX 插件,citekey 才稳定
  • PDF 全文靠 Zotero 的全文索引;没索引的文献要去 Zotero 里右键「重新索引」

#🌾 ③ zotero-harvest —— 自动"检索 → 判断够不够 → 入库"

  • 仓库:https://github.com/Fisfzy/zotero-harvest
  • 一句话:把「找文献 → 判断文献够不够 → 存进 Zotero → 能立刻被检索到」这条链路做成 6 个确定性工具。做系统性综述时的"采集机"

它检索的免费数据源(都不需要 Key):

来源用途
OpenAlex主检索 + 开放获取状态 + 最佳 OA PDF
Europe PMC生物医学文献(生信很对口)+ PDF 直链
arXiv预印本 + 全文 PDF
CrossrefDOI 元数据
UnpaywallDOI → 免费全文链接
Semantic Scholar默认源之一
Google Scholar可选源(要走代理,容易失败)

6 个工具:

工具干什么
lit_fetch多源检索 + 去重排序 + 解析每篇的免费下载链接(传 DOI 或 arXiv ID 可精确定位)
lit_paper_detail下载 PDF → 抽全文 → 提取摘要/关键词/章节 → 生成"证据卡"
lit_save入库 Zotero(自动去重 + 挂 PDF 附件)
lit_sufficiency_check配额 + 子主题覆盖审计 → 告诉你"够不够、缺什么、下一轮搜什么"
lit_download_links批量解析免费下载链接
lit_review_run一键跑完整循环:检索 → 审计 → 不够就按缺口继续 → 达标后保存

可用的对话:

code
用 lit_review_run 帮我做「肝癌 单细胞 免疫微环境」这个主题的文献采集:
至少 5 篇核心 + 10 篇总共,最多跑 3 轮,采完存进 Zotero 的「综述-肝癌」分类。
跑之前先告诉我你打算用哪些检索词。

⚠️ 注意:这个插件作者的安装方式是开发者式的(dshx install zotero-harvest <插件目录>),比前两个麻烦一点。 如果你只是想用,先跳过它,等前面的用熟了再回来折腾(README 写得很清楚,照着做)。


#🌊 ④ 延伸:zotero-wave-rag —— 让检索"懂关系"

  • 仓库:https://github.com/Fisfzy/zotero-wave-rag
  • 一句话:面向 Zotero 库的 RAG 检索系统,直读 zotero.sqlite,能用上"标签关系网 + 全文 BM25 + 中英桥"
  • 为什么值得知道:普通检索只能找到"字面像"的论文;它还能顺着共享标签/作者往外跳,找到"语义不像但其实相关"的论文
  • 工具:zotero_status、zotero_search、zotero_paper_detail、zotero_compare(多篇并排对比)、zotero_embedder(切换嵌入模型)
  • 嵌入模型可选:hash(免费离线,开箱即用)/ bge-m3(推荐,需 API Key)/ Qwen 系列

⚠️ 重要提醒:dsh-zotero 和 zotero-wave-rag 都注册了 zotero_search 这个工具名,别同时装,二选一。 (zotero-mcp-dsh 的工具名带 mcp__zotero__ 前缀,可以和它们共存。)

#🧭 三件套怎么分工(一张表看懂)

你要干的事装哪个
日常读文献、让 AI 翻我的库、读全文dsh-zotero
写论文 / LaTeX / 需要 BibTeX 和 citekeyzotero-mcp-dsh
做综述,要批量检索+判断+自动入库zotero-harvest(+ wave-rag 做检索)
检索要"顺藤摸瓜"找相关文献zotero-wave-rag(换掉 dsh-zotero)

3-2 ⭐⭐ dsh-literature —— 文献侧窗(我最推荐先装这个)

  • 仓库:https://github.com/Aik358/dsh-literature | npm:@a9i5k4/dsh-literature
  • 一句话:一个插件顶四个——文献库 + PDF 阅读器 + 划词翻译 + 引用格式生成器,而且不装 Zotero 也能单独用

安装(一行命令):

sh
dsh plugin add @a9i5k4/dsh-literature

装完重启 App,侧边栏会出现「文献」入口。

它能干什么:

能力说明
🔍 自动识别从 AI 的回复或你粘贴的文字里认出 DOI / arXiv / PMID / ISBN / 标题,自动去重
📋 元数据抓取从 Crossref / arXiv / OpenAlex 自动补全标题、作者、期刊、年份、摘要
⬇️ 全文下载多个免费源依次尝试(arXiv → OpenAlex → Unpaywall → DOI → 出版商),失败会明确告诉你为什么
📖 内置 PDF 阅读器缩放、翻页、目录、全文搜索、多色高亮 + 笔记(支持简单 Markdown)、阅读位置记忆、夜读模式、一键导出全部高亮为 Markdown
✍️ 引用生成器APA 7 / GB/T 7714-2015(中文学位论文就用它)/ MLA 9 / Chicago 17 / BibTeX,参考文献 + 文内引用 + 带页码的直接引用,一键复制
🤖 划词 AI选中文字 → 翻译 / 解释 / 总结;也能对全文提问或一键总结全文,结果直接发到当前对话继续追问
🗂 库管理扫描导入文件夹(自动识别文件名里的 DOI/标题)、标签、状态过滤、排序、多选批量导出 RIS/BibTeX/CSL-JSON
🌐 全网入口每条文献直达 Google Scholar / 百度学术 / 知网
🔒 完全本地只监听 127.0.0.1,无遥测、无云端中转、不需要账号

为什么强烈建议她先装这个:

  • 门槛最低:不依赖 Zotero(保存方式可选"内置文献库"),装上就能用
  • 覆盖了她 80% 的日常动作:看 PDF、翻译、记高亮、生成中文参考文献格式
  • 中文学位论文要的 GB/T 7714-2015 格式直接内置,不用自己拼
  • 有 QQ 交流群,出问题好问人

zotero_lookup 是什么:它同时提供让 AI 调用的 zotero_lookup 工具,所以你可以直接在对话里说:

code
帮我找一下 DOI 10.1038/xxxxx 这篇,下载全文,然后总结它的方法部分。

和 Zotero 的关系:它是 Zotero 生态的独立兼容实现,和 Zotero 官方无隶属关系。装上 Zotero 后也能把条目导出到 Zotero(走官方 Connector 协议)。

兼容性要求:DSH ≥ 0.1.1-rc.2、Node ≥ 20;本地 Zotero 可选(8.x)。


3-3 🔧 必装基础件(装上就离不开)

这一组不是"科研专用",但没有它们你会很痛苦。按优先级从上到下装。

#🧠 管理技能和 MCP(管好你的"工具箱")

插件干什么链接
⭐ dsh-skill-manager在设置里管技能:图形界面查看/启停/删除技能,不用手翻文件夹https://github.com/bitterSmilezzz/dsh-skill-manager
⭐ dsh-find-skill从 vercel-labs/skills 生态里搜索并安装技能(让 AI 帮你找技能)https://github.com/Moximxxx/dsh-find-skill
dsh-skillport让你已有的 Claude Code / Codex / Cursor 技能也能在 DSH 里用https://github.com/Jesse-njx/dsh-skillport
⭐ dsh-mcp-manager管理 MCP 服务器(装 Zotero MCP 类插件要用),支持 OAuth/stdio、工作区隔离https://github.com/hyqhyq3/dsh-mcp-manager
dsh-mcp-proxy省 token 的 MCP 访问方式(不一次性塞进所有工具的 schema)https://github.com/ben7am1n/dsh-mcp-proxy

#🐍 跑代码 / 处理数据(生信必需)

插件干什么链接
⭐⭐ dsh-plugin-interpreters提供 run_python / run_node 工具,可配置解释器路径 → 让 AI 直接跑你的 Python 脚本https://github.com/HuanLinOTO/dsh-plugin-interpreters
⭐ dsh-tool-csv零依赖 CSV 解析/查询/统计(读表达矩阵、样本表)https://github.com/omdsh-dev/dsh-tool-csv
⭐ dsh-tool-stat描述统计 / 分位数 / 频数 / 相关系数https://github.com/omdsh-dev/dsh-tool-stat
dsh-tool-diff文本/JSON/CSV/Markdown 结构化对比https://github.com/omdsh-dev/dsh-tool-diff
dsh-tool-markdownHTML→Markdown、表格规范化、自动生成目录https://github.com/omdsh-dev/dsh-tool-markdown
dsh-batch-regression同一条命令跑 N 轮,用中位数/分布判断结果(而不是单次结果)—— 跑生物实验重复时很有用https://github.com/PangYiMing/dsh-batch-regression
dsh-automation定时任务:晚上挂着跑分析,早上看结果https://github.com/titanwings/dsh-automation

#👁 让 AI"看得见"(读图、OCR、扫描件)

插件干什么链接
⭐ dsh-tool-describe-image贴图即理解(接任意兼容 OpenAI 的视觉接口)https://github.com/sala003/dsh-tool-describe-image
⭐ dsh-paddle-ocrPaddleOCR 文档版面解析:扫描版论文、图表、表格转文字https://github.com/omdsh-dev/dsh-paddle-ocr
dsh-multimodal视觉转写 + OCR + 文生图https://github.com/MC5lan/dsh-multimodal
dsh-vision-sidecar给"纯文本模型"外挂一个视觉能力(不换主模型)https://github.com/121103qwq/dsh-vision-sidecar
modlensOCR + 版面 + 语义识别(市场里搜 modlens)市场内
dsh-plugin-mineruMinerU 文档解析(PDF → Markdown,公式表格都能保)市场内

💡 为什么这几个对生信重要:论文里的通路图、热图、电泳图、表格,AI 默认"看不见"。装上视觉/OCR 插件后,你就能直接问「这张图说明了什么」。

#📄 Office / 报告 / 笔记

插件干什么链接
⭐ dsh-report-html把 Markdown + 表格 + 图表数据生成自带交互的 HTML 报告(组会汇报神器)https://github.com/hccccc01333/dsh-report-html
dsh-office-tools / dsh-univer-officeOffice 文档处理(市场里搜名字)市场内
dsh-md-notes / notesMarkdown 笔记管理市场内
dsh-read-url读取网页内容市场内

#💰 看花销(学生党必装)

插件干什么链接
⭐ dsh-plugin-cost-trackerToken 用量与成本追踪 + 预算告警https://github.com/YYTbit/dsh-plugin-cost-tracker
dsh-token-usage用量统计卡片 + 3 个月热力图https://github.com/hashdiana/dsh-token-usage
dsh-usage-cost每步 API 用量的时间线 + 高峰/低谷价格https://github.com/Dino6021/dsh-usage-cost
dsh-balance-display侧边栏直接显示账户余额,余额低会提醒https://github.com/Liu-ty/dsh-balance-display

#↩️ 后悔药(防手抖)

插件干什么链接
⭐ dsh-undo/undo 命令:把对话回退到上一条消息之前https://github.com/LingLambda/dsh-undo
dsh-archive-manager已归档会话管理,找回来https://github.com/zimixvx/dsh-archive-manager
dsh-session-index跨会话全文搜索("我上个月是不是查过这个")https://github.com/longyu065/dsh-session-index
dsh-turn-index右侧列出每一轮提问,点击跳转https://github.com/Simon314620/dsh-turn-index
dsh-backup备份配置与会话(市场里搜)市场内

3-4 🎓 学术科研专项插件

#🔬 重量级:DSH Scholar(科研操作系统)

  • 仓库:https://github.com/lzszq/dsh-scholar
  • 一句话:把「项目对话 + 研究材料 + 代码数据 + 受控实验 + 证据 + TeX 论文」全部放进一个可追溯的项目里。流程是:
code
建项目 → Grill Me 追问 → 定 Scope → 文献综述 → 出 Idea → 基线 → 定 Contract
→ 受控实验 → 结果分类与综合 → 证据与结论 → TeX 写作与评审 → 人工放行
  • 它特别"学术"的地方:gate-only 是默认模式 —— AI 不能伪造"已通过的证据",也不能绕过研究节点的确认;每次实验必须绑定不可变的代码和数据快照
  • 明确说了面向:机器学习、数据科学、生物信息学 等计算型研究

⚠️ 但门槛很高:要求 Linux + Node.js 24 + pnpm + Docker,还要自己 build 源码。DSH Desktop 在 Windows/Mac 上目前跑不了它的完整形态。 👉 结论:这个是"以后进阶"的目标,现在别装。 先把 3-1/3-2/3-3 用熟。

#📖 其他学术向(都在插件市场里,搜名字即可)

插件名干什么
dsh-ai4scholar学术文献检索
dsh-fund-research基金项目检索
dsh-science-workbench科研工作台
dsh-reference-checker参考文献检查(投稿前必用,防幻觉引用)
dsh-deep-research深度研究编排(自适应多轮检索)
dsh-book2skill把一本书变成一套技能(5 阶段,含 3 个人工确认点)
dsh-ultramath数学/公式相关
dsh-diagram生成图表/示意图
dsh-data-agent数据处理智能体
dsh-data-cleaning-agent数据清洗智能体(处理乱表格)
Perplexity 学术与科技检索用 Perplexity 做学术检索
dsh-web-search-multi / dsh-web-search-exa多引擎搜索 / Exa 语义搜索

#🧠 记忆与上下文(长项目必备)

插件干什么链接
dsh-memento分层的、需审批的跨会话记忆https://github.com/PerryLink/dsh-memento
dsh-mnemon三层记忆控制平面(运行时上下文 + 可搜索项目文档)https://github.com/omdsh-dev/dsh-mnemon
dsh-memory本地 SQLite 全文检索的持久记忆https://github.com/ben7am1n/dsh-memory
dsh-plugin-rag本地知识库 RAG:索引项目文件并检索https://github.com/YYTbit/dsh-plugin-rag

💡 一个课题做半年,最痛的就是"AI 忘了我们之前干了什么"。记忆类插件在她进入第二个学期时价值最大。


3-5 🎨 让界面好用的插件

插件干什么链接
dsh-web-skins第三方换肤仓库https://github.com/Moeblack/dsh-skins
dsh-custom-css自定义 CSS(自己调样式)https://github.com/AnacondaKC/dsh-custom-css
dsh-skin背景图片设置市场内
dsh-notification桌面 + webhook 通知(跑完提醒你)https://github.com/omdsh-dev/dsh-notification
dsh-conversation-share把对话选段导出成长图(做组会截图、发给导师)https://github.com/bill9109/dsh-conversation-share
dsh-learn-everything费曼学习模式:结构化课程卡片,适合啃新领域https://github.com/cendaifeng/dsh-learn-everything
dsh-emoji / dsh-pixel-whale好玩的(表情、像素鲸鱼)dsh-pixel-whale

3-6 ⚠️ 装插件的四条纪律(别跳过)

#纪律为什么
1一次只装一个,装完就重启 + 验证出问题才知道是谁的锅。一次装五个,崩了只能全部卸掉重来
2同类插件只留一个工具名会冲突(比如两个插件都叫 zotero_search),冲突时表现是"工具莫名其妙消失"
3装之前看两件事:README 的"前置条件" + 最近更新时间半年没更新的插件很可能和你现在的 DSH 版本不兼容
4数据安全底线:任何要"把数据上传到某服务器"的插件,先想清楚未发表数据、病例信息、测序原始数据 → 本地处理,不外传。插件市场里有很多好东西,但也有粗制滥造的,只看名字看不出安不安全

万一装崩了怎么办(记住这一招):

  • 从托盘的 Harness 菜单 → 以安全模式重启(Safe Mode) → 它会临时屏蔽所有第三方插件,让你能进去把坏插件卸掉
  • 完全进不去界面:用命令行启动并加参数 --safe-mode
  • 报 bug 用:托盘右键 → 导出诊断信息…

3-7 给她的安装顺序清单(照着装就行)

不用一次全装!按下面的顺序,一步一步来。

#📅 第 1 天(只装这 3 个)

顺序插件为什么先装它
1dsh-literature一个顶四个(文献库+PDF阅读器+翻译+引用格式),不依赖 Zotero,当天就能看文献
2dsh-skill-manager以后装技能时会感谢自己(图形界面管理,不用手翻文件夹)
3dsh-plugin-interpreters让 AI 能跑 Python —— 生信的核心动作
sh
dsh plugin add @a9i5k4/dsh-literature
dsh plugin add dsh-skill-manager
dsh plugin add @huanlin/dsh-plugin-interpreters

上面第二、三个如果名字搜不到,就打开插件市场搜关键词("skill manager"、"interpreter"),或按各自 README 给的命令装。

#📅 第 1 周(再补 4 个)

插件为什么
dsh-zotero让 AI 翻你的 Zotero 库(前提:Zotero 7+ 且开着)
dsh-tool-describe-image 或 dsh-paddle-ocr让 AI 看懂论文里的图和扫描件
dsh-plugin-cost-tracker 或 dsh-balance-display看着点花销,别月底才发现账单
dsh-undo后悔药,放在手边安心

#📅 写论文的时候

插件为什么
zotero-mcp-dsh一键导出 BibTeX + citekey,LaTeX 引用不头疼
dsh-reference-checker投稿前查引用,专治 AI 编造文献

#📅 做综述的时候

插件为什么
zotero-harvest自动检索 + 判断够不够 + 入库(Europe PMC 对生信友好)
zotero-wave-rag检索"顺藤摸瓜"找关系文献(⚠️ 与 dsh-zotero 二选一)
dsh-deep-research多轮深度检索编排

#📅 以后进阶(现在别碰)

插件为什么先别碰
dsh-scholar要求 Linux + Docker + 从源码构建
dsh-plugin-rag / dsh-memento长项目才有价值,先积累几个课题再说
dsh-report-html等你第一次要做组会汇报时再装