前言¶
在 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 子命令试起。
