把 dsh 变成科研工具：Tavily 文献检索逐步实操
dsh 文献检索能交付什么、检索插件怎么装、中英文文献检索怎么跑——12 步实录图文。
最近更新: 2026-10-04
dsh 能不能查文献、下参考文献、让综述有个框架？能。本页是一份 12 步截图实录：装 dsh-plugin-tavily 检索插件、配好 Key、重启生效，然后跑通中文核心期刊与英文文献检索，直到一份带标注的参考文献清单落进对话框。导出前，每一帧都对照源视频的水印与烧录字幕逐帧核对过。
查到的文献也要有地方放：知识库存的是你自己的文档、供 dsh 随取随引，本页解决的则是去开放网络检索新文献——两条线互补，不重复。 把文档存进知识库
太长不看
- ▸一条命令装 dsh-plugin-tavily：web_search 工具的后端换成 Tavily，设置里多出「设置 → 插件 → 网页搜索」配置卡。
- ▸到 tavily.com 免费注册，控制台发放 tvly-dev- 开头的 Key，免费档带每月额度；免费档限流是真实的，检索失败先重试再怀疑配置。
- ▸把 Key 粘进配置卡，确认运行状态行把检索记在 Tavily 名下，再重启 dsh（Ctrl+C → pnpm dsh web）让提供方生效。
- ▸中英文都能检：中文核心期刊与英文论文都以结果卡返回；综述工作流按「划方向 → 10 篇清单 → 建框架 → 分部撰写」推进。
12 步实操
先看产出：这套工作流交付什么
- 1
先看终点：一份带标注的中文参考文献清单
动手装任何东西之前，先看这套工作流的产出。源视频里，dsh 对一次中文文献请求的回复是一份参考文献清单，带 [综述专题]、[必读]、[可选] 标注，每条附期刊、年份与链接字段。接下来 11 步要抵达的就是它。
交付物：参考文献分好综述专题、必读、可选，出处齐全。去源视频看 0:06 - 2
要一次分诊，得到三栏分类
同一套工作流还能对检索结果做分类：帧里论文被拆成三栏——医学诊疗、NLP 专家期刊、LLM 医学文献反馈。读之前先让 dsh 把参考文献分类，检索结果堆才会变成阅读计划。
同一工作流的分诊模式——三栏定下阅读顺序。去源视频看 1:36 - 3
认清插件生态的位置
awesome-dsh-plugin 的 README「工具与能力」段就是地图：本页要装的 Tavily 检索插件与 voice-input、hdc-bridge、computer-use 等并列在册。何静副教授的讲座把同一版图归纳为三条路线——复用插件、编排脚本、手动开发。本页走第一条。
生态地图：Tavily 插件位列社区工具长单之中。去源视频看 0:44
安装并配置 Tavily 检索插件
- 4
打开 dsh-plugin-tavily 仓库并安装
GitHub 页一行话讲清这个插件：Tavily 后端的网页搜索提供方，注册进 dsh 的 web 接缝，并在 web GUI 里自带一张设置卡——纯 TypeScript，MIT 协议，★5。README 安装段（2026-10-04 经 GitHub API 实查）只需一条命令；开发场景另有本地路径变体。
$dsh plugin --profile web add "github:1624318455/dsh-plugin-tavily#main"$dsh plugin --profile web add "file:/absolute/path/to/dsh-plugin-tavily"
README 一条命令装好插件；本地路径变体留给开发。去源视频看 1:02 - 5
安装前先读 README 的平台与优先级说明
帧里是装前值得花两分钟的 README 段落：哪些配置会在 Web GUI 里手动可见、环境变量优先级如何裁决。搞清取值冲突时哪层生效，能省掉「改了文件却被 GUI 覆盖」的经典弯路。
先花两分钟，省掉取值冲突时猜哪层生效的一小时。去源视频看 1:20 - 6
找到将来要粘 Key 的设置卡
在 dsh 的 web UI 里，设置 → 插件打开帧中这枚 modal：Agent 键所在行加上 API Key 配置行——Tavily 的 Key 之后就填在这里。这张卡在安装时就已注册，第 4 步的命令跑完，字段就在等你。
安装即注册——字段早就等着你的 Key。去源视频看 1:54 - 7
注册 Tavily 账号
Tavily 官网的口号是把 AI 代理接上网络——它在本页扮演的正是这个角色。注册免费；支撑整篇实操的就是免费档，全程不涉及付费计划。
免费账号、免费档——本篇全程没离开它。去源视频看 2:03 - 8
在控制台签发 tvly-dev API Key
Tavily 控制台的 API Keys 页里，实录拍到 default 与 dev 两把 tvly-dev- 前缀的 Key，外加免费月度额度余额（帧里恰好拍到已用 17/1,000 credits）。现在复制 Key——下一步就把它粘进 dsh。
default 与 dev 两把都能用；帧里恰好拍到已用 17/1,000。去源视频看 2:16 - 9
粘入 Key，确认配置卡显示已配置
回到 dsh，这帧是全页的题眼：插件卡上 @dsh-external/dsh-plugin-tavily 包名、检索深度 advanced、主题 news、api.tavily.com 端点、TAVILY_API_KEY 已打勾配置——运行状态行还注明进程启动时加载了 tavily 配置、刚才几轮中文期刊检索都是通过 Tavily 执行的。deepseek-official 备用提供方仍挂在系统里：把 searchProvider 改回去再重启即可切回。
已配置，且查得到在用：状态行把当天检索记在 Tavily 名下。去源视频看 2:30
重启生效，跑通中英文文献检索
- 10
重启 dsh，让提供方真正加载
实录在此专门停下警告：searchProvider 是启动时加载的配置项，正在运行的 dsh 会继续用旧后端。在运行 dsh 的终端按 Ctrl+C 停止，再重新启动——帧里就是这套动作。
$pnpm dsh web
最容易跳过的一步：不重启，旧后端。去源视频看 3:10 - 11
跑一次中文核心期刊检索
提供方就位后，中文查询以 SearchExtCard 结果卡返回核心期刊条目——第 9 步的运行状态行正是「这些结果走了 Tavily」的凭证。插件详情里的最佳使用方案覆盖各路场景：DeepSearch 查文献、SearchAll 中文/英文/中英混合、DeepSearch Shell 全流程检索。
中文核心期刊以结果卡返回，不是裸链接。去源视频看 3:20 - 12
扫一遍英文文献，进入综述
英文轮次返回论文清单（帧里是 MedMCQA、UltraMedical、小语言模型等条目）。同频道的综述专题片补完闭环：检索不超过 30 个工具上限、12 次工具调用、检索测试 3/3 通过，产出 10 篇逐篇介绍的清单，再人工筛选建框架——不能让模型自己随便生成——最后分部撰写。给免费档限流留好余量：那支视频的首次检索失败了三次才成功。
喂给综述工作流 10 篇清单的英文轮次。去源视频看 4:22
常见问题
关于 dsh 科研插件、Tavily Key、费用与隐私的快问快答。
dsh 科研插件到底能做什么？
本页走的这条路——dsh-plugin-tavily——把 web_search 后端换成 Tavily，让文献查询返回真实、带链接的中英文论文，并支撑综述工作流：划方向、10 篇带注清单、建框架、分部撰写。检索之外，生态里还有一站式工作台：1692775560/dsh-Mimir-Academic-research（★543，MIT）覆盖 LaTeX 边写边编译、arXiv 文献管理、实验追踪、指标图表、GPU 服务器 SSH 任务编排；literaf/dsh-ai4scholar（★29）提供 Semantic Scholar、PubMed、arXiv 等 38 个学术工具；SihanLv/dsh-literature（★5）做 dblp + arXiv 检索并导出 BibTeX。
TAVILY_API_KEY 从哪里来？
在 tavily.com 注册，打开控制台的 API Keys 页复制 Key——免费档发放 tvly-dev- 开头的 Key（见第 8 步帧）。把它粘进 dsh 设置卡（设置 → 插件 → 网页搜索）；dsh 经凭据服务保存 Key，而不是写进配置文件。
免费吗？
三层都免费：插件本体是 MIT 开源；Tavily 有带每月额度的免费档（第 8 步帧里拍到 17/1,000 credits）；Tavily 甚至支持无 Key 的限流模式。真实成本是免费档限流——综述视频的首次检索失败了三次才成功，所以失败先重试，别急着断定配置坏了。
和直接问 DeepSeek 有什么区别？
直接问 DeepSeek，模型靠训练数据作答——引用可能是像模像样的编造。装插件后，web_search 工具由 Tavily 供数，返回的是带真实标题与链接的抓取文档，模型侧工具不变。而且没有锁定：deepseek-official 备用提供方仍在系统里，把 searchProvider 改回去并重启即可切回。
数据隐私呢？
你的查询会发往 Tavily 的 API（api.tavily.com）执行检索——这就是该服务的本职。Key 本身经 dsh 凭据服务（~/.dsh/.credentials.yaml）保存，不落配置文件也不进明文环境变量，设置卡刻意设计成浏览器读不回已存密钥。dsh 与 Tavily 之间没有第三方中转。
支持中文文献吗？
支持——第 11 步帧里中文核心期刊结果以 Tavily 结果卡返回，插件推荐用法清单里有 SearchAll 中文与中英混合条目，与英文检索并列。实录自己的运行备注也确认其中文期刊检索是经 Tavily 执行的。
dsh-Mimir-Academic-research 和本页装的是同一个东西吗？
不是。本页装的是 dsh-plugin-tavily（★5，个人开发者插件——非官方），升级 dsh 的检索后端。dsh-Mimir-Academic-research（★543，MIT）是大得多的一站式科研工作台——LaTeX 写作实时编译、arXiv 文献管理、实验追踪、指标图表、GPU 服务器 SSH 任务编排。它是学术插件集合的头牌，货比三家去集合页；跟着做步骤在本页。
相关攻略
dsh 科研与工作流路线的下一站。
来源与署名
本页 12 帧全部取自 Paperjia免费开题报告 在 B 站的参考文献教程（主源）；截图对照其水印与烧录字幕逐帧复核导出。同频道后续的综述专题片提供了综述工作流事实——该片贴纸段未取帧。北航何静副教授的讲座提供了科研三路线框架——幻灯与口播段未取帧。仓库事实 2026-10-04 经 GitHub API 实查：1624318455/dsh-plugin-tavily（★5，MIT）、1692775560/dsh-Mimir-Academic-research（★543，MIT）、literaf/dsh-ai4scholar（★29，MIT）、SihanLv/dsh-literature（★5）。每张截图都以精确秒深链回源视频。