前言¶
在 DeepSeek Harness（DSH）裏做聯網或科研輔助時，常見流程是：模型幫你搜到 DOI 或題名，但真正耗時的是之後的三件事——判斷是不是開放獲取（OA）、嘗試下載 PDF、以及遇到付費牆時該走哪條人工渠道。各數據源接口、Unpaywall 標記與出版商反爬規則分散，很難在一次對話裏穩定復現。
下面介紹社區插件 melano514/dsh-plugin-paper-radar（文獻雷達）。它在 DSH 中註冊隨包技能 paper-radar，用 Python 標準庫腳本串聯檢索、OA 判定、可直鏈時的 PDF 下載，以及非 OA 或自動下載失敗時的「決策卡」與四條人工通道鏈接。分類屬於聯網工具；維護者爲 melano514。社區目錄見 SkillHub 插件頁，源碼與說明見 GitHub 倉庫。目錄站點爲社區生態，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-plugin-paper-radar 是給 DeepSeek Harness 用的文獻檢索插件：按領域、檢索詞或 DOI 找論文，自動判定能否合法免費獲取全文；能獲取則下載 PDF 到統一文獻庫；不能或自動鏈路被攔則寫入決策卡，並給出四條按成功率排序的手動渠道深鏈。
面向醫學與生命科學時優先 Europe PMC / PubMed；也支持跨學科檢索（OpenAlex / Crossref）。插件當前版本爲 0.1.0（見倉庫 package.json），許可證 MIT。
核心功能¶
檢索與數據源¶
檢索環節默認按學科自動路由，涉及的數據源包括：
| 環節 | 數據源 |
|---|---|
| 檢索 | Europe PMC、PubMed E-utilities、OpenAlex、Crossref |
| OA 判定 | Unpaywall、OpenAlex、Europe PMC 的 OA 標記 |
| PDF 直取 | Unpaywall 直鏈 → 出版商 URL 規律（PLOS、MDPI、Frontiers、Springer、Nature、BMJ、Wiley、T&F、SAGE、OUP、ScienceDirect 等）→ 落地頁 citation_pdf_url |
| 全文校驗 | 校驗 %PDF- 文件頭與頁數，避免把登錄頁 HTML 存成 PDF |
判定結果在技能邏輯中對應三態：OA 直取（有直鏈且下載成功）、疑似 OA 但被攔（官方標 OA 但自動下載失敗）、非 OA（合法源無免費副本，走決策卡四通道）。
非 OA 與自動失敗時的四條通道¶
決策卡中固定排序並附帶可點開鏈接：
- 科研通（AbleSci）：文獻互助與站內搜索，README 稱成功率較高，耗時通常爲數分鐘到數小時。
- Sci-Hub：已知 DOI 時路徑短，但有人機驗證，需手工處理。
- SciDown：國內直連，結果頁爲前端渲染。
- X-MOL：便於查找預印本或其它 OA 入口。
README 明確：通道 2、3 屬於版權灰色渠道，僅供個人學習研究；插件只生成鏈接，不自動過驗證碼，也不批量分發全文。使用前請遵守機構與當地法規。
文獻庫與配置¶
- 文獻庫根目錄探測順序：
--root> 配置項root> 環境變量PAPER_RADAR_ROOT> 候選目錄列表中第一個可寫路徑。 - 配置文件：Windows 爲
%APPDATA%\paper-radar\config.json，非 Windows 爲~/paper-radar/config.json；可用PAPER_RADAR_HOME改位置，或通過config子命令修改。 - 庫結構：
library/（PDF）、inbox/（待獲取決策卡）、reports/（檢索報告）、notes/、catalog.jsonl（唯一事實來源）。
人工從某通道拿到 PDF 後，可用 admit 子命令登記到統一庫。
技術形態¶
- 插件爲 ESM 入口
index.js，安裝後無需構建、無需npm install；通過 Cordis patch 將技能paper-radar註冊進技能目錄。 - 唯一運行時依賴：Python 3.8+，腳本僅使用標準庫，不需要
pip install。未安裝 Python 時插件仍可安裝，技能會提示先安裝 Python。 - Node 引擎要求：
>=20（見package.json）。
安裝與啓用¶
在已安裝 DSH 的環境中執行官方 README 給出的命令：
dsh plugin add melano514/dsh-plugin-paper-radar
也可通過 Plugin Manager 的 install_bundle 指向本地目錄。安裝前應自行查看倉庫源碼與 MIT 許可證；插件以當前 dsh 進程權限運行，涉及聯網與本地寫盤，請在可信環境中使用。
典型用法¶
自然語言¶
安裝後可直接對 Harness 說明需求，例如：
- 「幫我找 10 篇 2022 年以後腸道菌羣和結直腸癌的文獻，只要 OA 的」
- 「這幾篇的 PDF 都下下來：10.1038/nature14539、10.1371/journal.pmed.1000097」
- 「這篇有沒有免費全文？」
- 「按我的研究方向建個庫」
命令行（技能內腳本路徑由插件解析，下文以 $PR 指代該腳本）¶
python "$PR" search "gut microbiome colorectal cancer" --limit 12 --since 2021 --oa-only
python "$PR" get 10.1038/nature14539
python "$PR" fetch 10.1038/nature14539
python "$PR" batch --file dois.txt --delay 1.5
python "$PR" admit 10.1038/nature14539 "D:\Downloads\x.pdf" --channel scihub
python "$PR" status
python "$PR" config --email me@univ.edu --root "D:\文獻庫"
說明：get 只做 OA 判定不下載；fetch 嘗試下載或生成決策卡；batch 可配合 DOI 列表與請求間隔。
倉庫提供冒煙測試：
node test/smoke.mjs
用樁 Cordis 上下文加載插件，斷言技能註冊、安裝期路徑佔位符替換及隨包腳本存在。
適用場景與注意¶
適合誰：需要在 DSH 對話或腳本中統一完成「檢索 → OA 判斷 → 能下則入庫 → 不能則給可操作鏈接」的醫學/生命科學或跨學科文獻工作流；希望減少在 Unpaywall、PMC 與各出版商站點之間手工切換的人。
README 記載的實測邊界（7 篇真實 DOI，5 篇自動成功、2 篇出卡），用於設定預期，而非普遍成功率承諾：
| 案例 | 結果 |
|---|---|
PLOS Medicine 10.1371/journal.pmed.1000097 |
自動下載 |
Frontiers 10.3389/fcimb.2026.1907957 |
自動下載 |
BMC 10.1186/s13045-024-01549-2 |
自動下載（落地頁 citation_pdf_url） |
Springer 10.1007/s00432-026-06635-1 |
自動下載 |
MDPI 10.3390/cells15191800 |
出卡（mdpi.com 對非瀏覽器 IP 403） |
Nature 10.1038/nature14539 |
出卡（Unpaywall green 但 HAL 倉庫抓不到 PDF） |
已知不可用或已規避的路徑（技能內不會反覆重試）：Europe PMC ?pdf=render、NCBI PMC /pdf/ 在普通網絡下 403/反爬；部分 Sci-Hub 域名失效或 403；科研通無可用按 DOI 檢索 API。
結尾¶
dsh-plugin-paper-radar 把 DSH 裏的文獻工作收成一條鏈路：多源檢索、OA 三態判定、校驗後的 PDF 入庫，以及付費牆或反爬失敗時的決策卡與四通道深鏈。若你要在 Harness 中落地醫學與生命科學文獻雷達，可先安裝上述命令，配置 Python 3.8+ 與可選的 root / 郵箱，再從自然語言或 search / fetch 子命令試起。
