dsh-scholar-digest:多源文獻檢索與五件套離線交付

前言

在 DeepSeek Harness(DSH)裏做文獻綜述,常見做法是讓智能體聯網搜索,或接一套依賴瀏覽器登錄態、自動化下載的管線。前者往往停在零散鏈接與未覈驗的題錄;後者又容易牽涉機構 SSO、風控與合規邊界。若目標只是「多源檢索 → 覈驗去重 → 一份能離線瀏覽、能點進官方頁面的交付物」,需要把學術 preset、文獻 MCP 與交付契約捆在一起。

dsh-scholar-digest 由維護者 LiYang-cyber 發佈,分類爲聯網工具,當前 GitHub 星標爲 1。插件版本 0.1.1,MIT 許可。下面介紹它是什麼、如何安裝,以及從檢索到交付的典型步驟。

這是什麼

一句話:dsh-scholar-digest 是 DSH 上的一個 bundle,同時提供「學術研究」agent preset 與 download-paper 技能——多源文獻檢索、元數據覈驗,以及 HTML / XLSX / BibTeX / RIS / arXiv 批量下載腳本組成的「五件套」離線交付。

知網部分在服務端把知網空間鏈映射到可打開主站(kns.cnki.net)的鏈接,不依賴瀏覽器端油猴跳轉,也不在插件內處理登錄或 cookie。

兩件核心交付

學術研究 preset

新建會話時在 preset 選擇器中選「學術研究」。preset 帶上學術向 persona,並掛載文獻數據源與常規工具:

  • CNKI(經隨插件安裝的 servers/cnki-search MCP,路徑由插件運行時解析,無需手寫目錄)
  • arXiv
  • PubMed / Europe PMC(經 npx 啓動)
  • Semantic Scholar

檢索側工具名形如:mcp__cnki__search、mcp__arxiv__*、mcp__pubmed__*、mcp__semantic-scholar__*。

download-paper 技能

技能約定「一個專題 = 一個交付目錄」。在同一份歸一化條目上生成:

  • 文獻下載索引(HTML)
  • 表格(xlsx)
  • 文獻清單(BibTeX、RIS)
  • 批量下載 arXiv 的 PowerShell 腳本

並帶來源追溯與交付自檢說明(見 skills/download-paper/AGENTS.md)。

全文 PDF 是否可下,仍取決於機構 IP 或你在知網、出版商官方頁面的登錄狀態;HTML 索引負責按主題分組擺好「點哪裏」,不自動繞過訪問控制。

工作流概覽

研究主題
   │  preset:CNKI(主站鏈接)+ arXiv + PubMed + Semantic Scholar
   ▼
候選條目 ── 去重(DOI / arXiv ID / PMID / S2 ID / kns 主站 URL)── 覈驗 ── 分級
   │  skill:同一份條目數據
   ▼
<項目>/<專題>/  文獻下載索引.html · 表格.xlsx · 文獻清單.bib · 文獻清單.ris · 批量下載_arXiv.ps1
   │  過程產物(檢索記錄、DOI 對照、知網條目清單)
   ▼
<項目>/_archive/<專題>/

去重與分級在 preset 檢索之後、技能生成交付之前完成,避免同一文獻在多份導出格式裏口徑不一致。

安裝與啓用

前置環境

  • DeepSeek Harness 0.2.2-rc.1 及以上(engines.dsh 要求 >=0.2.2-rc.1 <0.3.0-0)
  • uv(CNKI / arXiv / Semantic Scholar 源)
  • Node.js >= 20(PubMed 源)

插件以當前 DSH 進程權限運行;安裝前宜瀏覽倉庫源碼與 MIT 許可證,確認與本地合規要求一致。

安裝命令

# npm 安裝(推薦)
dsh plugin --profile desktop add dsh-scholar-digest

# 或從 GitHub 安裝
dsh plugin --profile desktop add github:LiYang-cyber/dsh-scholar-digest

# 卸載
dsh plugin --profile desktop remove dsh-scholar-digest

裝好後重啓或重載應用:preset 選擇器會出現「學術研究」,技能目錄會出現 download-paper。

若你曾在 cordis.patch.yml 裏手動定義過同名 preset(id: academic),需先刪除該段再裝插件,否則會 preset id 衝突。

典型用法

  1. 新建會話,preset 選「學術研究」。
  2. 建專題目錄:<項目>_archive 與 <項目>\<專題名>\;可用 scripts/new-topic.ps1 建骨架,也可手建。
  3. 用 preset 內 MCP 工具檢索候選文獻。
  4. 按 skills/download-paper/AGENTS.md 第 3 節生成五件套。
  5. 打開 HTML 索引,在官方頁面完成 PDF 下載;交付前按 AGENTS.md 第 4 節自檢。

將已有 xlsx 總錶轉爲 HTML / RIS / arXiv 腳本時,可用技能自帶的生成器(路徑中的 <插件目錄> 換成本地安裝位置):

uv run --with openpyxl python "<插件目錄>\skills\download-paper\build_delivery.py" "<項目>\<專題>"

倉庫 examples/demo-topic/ 提供虛構數據的完整交付示例,可直接打開 文獻下載索引.html 查看形態。重新生成示例數據:

uv run --with openpyxl python examples/build_demo_dataset.py
uv run --with openpyxl python skills/download-paper/build_delivery.py examples/demo-topic

適用場景與注意

適合誰: 需要在 DSH 會話裏做多源文獻檢索、題錄去重,並希望輸出可歸檔、可引用的 BibTeX/RIS 與離線 HTML 索引的個人或小團隊研究者;知網使用場景限於公開檢索與合規範圍內的機構訪問。

與常見路線的差異: 已有方案多走 CDP/Playwright、機構 SSO 或中繼賬號的自動下載。本插件刻意不碰登錄態、不做風控對抗,只做鏈接映射與交付打包。CNKI 服務端基於 Biogod2020/cnki-search 並增加鏈接換算層。

已知限制(README 原文):

  • 四個文獻 MCP 進程隨 DSH 啓動常駐,與當前會話是否選中該 preset 無關。
  • 知網服務端走知網空間公開接口,覆蓋空間題錄,不是 KNS 全部館藏。
  • 主要在 Windows + DSH 0.2.2-rc.1 上實測;其他平臺腳本雖按跨平臺寫法,未驗證。
  • arXiv 批量腳本內置約 3 秒請求間隔,不宜擅自改短。

合規: 不內置 cookie/token,不模擬登錄;檢索請遵守各數據源使用條款,勿用於批量抓取或再分發全文。

不裝完整插件、僅想把 preset 寫入 profile patch 時,可用 preset/gen-preset.py 手動生成 patch;此時技能需單獨放進項目 .agents\skills\download-paper,且勿與插件版同名 preset 同時啓用。

結尾

dsh-scholar-digest 把學術 preset、四路文獻 MCP(含知網主站鏈接映射)與 download-paper 五件套交付綁在一個 DSH 插件裏,適合把「找文獻」和「整理成交付目錄」放在同一條可復現工作流中。DSH 社區插件目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。

  • 目錄頁:https://www.skillhub.cn/plugins/LiYang-cyber/dsh-scholar-digest
  • GitHub:https://github.com/LiYang-cyber/dsh-scholar-digest
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜