把 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）。每張截圖都以精確秒深鏈回源影片。