前言¶
在 DeepSeek Harness（DSH）里做研究助手时，模型往往需要按关键词拉一批题录：中文期刊走知网、预印本走 arXiv、要 DOI 元数据再看 Crossref，被引和 WoS 题录又要另开站点。各站字段不一、去重要靠 DOI 或标题手工合并，WoS 还带着必须浏览器会话的反爬约束。下面介绍社区插件 dsh-papersearch（维护者 waizzie，分类：联网工具）：把 Web of Science、中国知网（CNKI）、arXiv、Crossref 接到同一套模型工具里，结果归一成统一 Paper 记录，并预留可插拔的源注册与侧栏面板。
这是什么¶
dsh-papersearch（npm 包名 dsh-papersearch，当前版本 0.4.1，MIT 许可证）是面向 DSH 的多源学术文献检索插件。它在 Host 侧暴露 paper_* 工具，在桌面端提供「文献检索」侧栏；知网、arXiv、Crossref 走纯 HTTP，装完即用；WoS 因站点要求 OnePass 会话，默认走侧栏内嵌 <webview> 同源请求，而不是裸 HTTP。
插件零第三方依赖，要求 Node.js ≥ 22（自带 fetch 与 WebSocket）。可选依赖 dsh-better-sidebar（>=0.24.0）用于侧栏体验。
- 目录页：https://www.skillhub.cn/plugins/waizzie/dsh_papersearch
- 源码：https://github.com/waizzie/dsh_papersearch
核心功能¶
一次检索、多源合并¶
paper_search 可按关键词跨源检索，支持按 DOI / 标题自动去重。单源失败不会中断整次查询，错误落在 perSource[].error 里返回给模型。
统一字段包括：标题、作者、来源出版物、年份、卷、期、页、DOI、被引、摘要、链接。拿不到的字段留空，不编造。
内置数据源与传输方式¶
| id | 名称 | 传输 | 说明 |
|---|---|---|---|
cnki |
中国知网 | http | 免登录，走 search.cnki.com.cn；中文文献主力 |
arxiv |
arXiv | http | 免登录预印本 |
crossref |
Crossref | http | 免登录，DOI 元数据与被引 |
wos |
Web of Science | browser（侧栏 webview） | 需会话；机构订阅影响结果集 |
默认源由配置项 config.defaultSources 决定；单次调用可在 sources 参数里指定。WoS 检索建议用英文关键词；知网用中文。
WoS 与侧栏桥接¶
Host 与「文献检索」面板通过请求队列（lib/wos-bridge.js）协作：paper_search(wos) 入队，面板在内嵌 webview 里发同源请求，再回填分片并由 Host 解析为 Paper。面板未打开或未就绪时，工具会返回可读原因，不会默认拉起外部 Chrome。旧方案 wosTransport: cdp（9222 + CDP）仍保留但默认关闭；外部浏览器需配置 allowExternalBrowser: true 且通过 paper_browser 的 launch / open。
扩展新站点¶
三种方式（资料原文）：
- 配置式：在
cordis.patch.yml的config.sources增加 JSON API 源，用url占位符与map字段路径做映射。 - 代码式：在
lib/providers/新增 provider，在lib/providers/index.js注册；改 Host 侧模块后需重启 DSH。 - 运行时：其它插件通过
registerProvider注册源。
安装与启用¶
方式 A：DSH 桌面端（推荐）¶
打开 DSH 桌面端的插件管理页，从社区目录或本地目录安装本插件。DSH NEXT 的 desktop profile 由应用独占管理，不要在应用外对其直接执行 dsh plugin 命令。
方式 B：命令行（非 desktop profile）¶
在已有插件目录的前提下，对 web、tui 等 profile 执行：
dsh plugin --profile <你的 profile> add "<插件目录的绝对路径>"
dsh plugin add 以 link: 方式装入 profile 并登记到 dsh.profile.bundles。安装后 paper_* 工具即可见，一般无需重启（新 bundle 走 HMR）；替换已安装旧版本需重启 DSH。
典型用法¶
检查源与 WoS 通道¶
paper_sources
可看到各源列表、默认源，以及 WoS 侧栏是否已连接（「侧栏面板已连接」或「未连接」）。
首次使用 WoS（知网 / arXiv / Crossref 可跳过）¶
- 打开右侧栏 「文献检索」 面板。
- 可对 WoS 行点 「准备」（不点也行，首次 WoS 检索会自动准备）。
- 等待状态为 「WoS 内嵌已就绪（检索走侧栏）」（首次约 30～40 秒）。
- 需要机构订阅结果时，展开内嵌窗口登录一次（会话在独立分区，通常只需一次）。
之后可在面板检索，或让模型调用 paper_search，WoS 均走侧栏内嵌窗口。
模型工具一览¶
| 工具 | 作用 |
|---|---|
paper_search |
跨源检索。参数：query（必填）、sources、limit、year_from、year_to、sort（relevance / date / cited）、with_abstract、dedupe、export_path |
paper_sources |
列出源、默认源、WoS 面板与浏览器状态 |
paper_browser |
默认仅 status；launch / open 需 allowExternalBrowser: true |
导出示例：给 paper_search 传入 export_path: "results.csv"（亦支持 .json / .bib），相对路径基于 DSH 进程工作目录，返回绝对路径。
适用场景与注意¶
适合谁：在 DSH 智能体或对话里需要批量查文献、统一题录字段、按需导出 BibTeX/CSV 的开发者与研究者；扩展配置或 provider 后也可接自有 API。
权限与安全：插件以当前 DSH 进程的权限访问网络与本地路径；安装前请阅读源码与 MIT 许可证，自行评估机构账号与导出路径。
站点边界（资料实录）：
- WoS：不绕过付费墙、不破解验证码；访客可检索但结果与订阅相关；可能出现被动验证或 reCAPTCHA，需在内嵌窗口完成。
- 知网免费入口：列表页无 DOI、卷、页码；现代
kns.cnki.net滑块入口未采用。 - 知网
year_from/year_to在服务端按年过滤，非本地筛大批结果。
SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本插件是其中一条联网检索链路。
结尾¶
dsh-papersearch 把 WoS、知网、arXiv、Crossref 收成一套工具与统一 Paper 结构，并用侧栏 webview 解决 WoS 会话问题，同时保留配置、代码与运行时三种扩源方式。要进一步安装或读完整 README，可从目录页 https://www.skillhub.cn/plugins/waizzie/dsh_papersearch 或 GitHub https://github.com/waizzie/dsh_papersearch 入手。
