dsh-paperlens：文献检索科研副驾驶插件

前言¶

DeepSeek Harness (DSH) 生态采用“一切皆插件”的设计理念。针对科研场景中的文献检索、引用格式化及管理需求，开发者常需集成外部服务或编写脚本。dsh-paperlens 是一个原生 Cordis 插件，提供多源学术检索、引文格式化、文献导出及本地 SQLite 文献库管理。它完全重写了功能思路，不依赖浏览器认证，数据不出机器。

核心功能¶

插件提供以下工具，覆盖从检索到归档的全流程：

paper_search：跨源检索学术论文。支持 OpenAlex 和 CrossRef，按相关性排序，自动去重，并提供元数据完整度评分（0-100）。
paper_details：获取单篇论文的完整元数据，包括扩展摘要、作者信息、被引次数及原始链接。
paper_cite：生成标准引文格式，支持 APA 7th、MLA 9th、GB/T 7714、Chicago 17th 和 Vancouver。
paper_import_doi：批量导入 DOI，自动充实元数据并可选存入文献库。
paper_save：将论文存入本地 SQLite 文献库，支持收藏夹分类、标签管理及阅读状态标记（unread/reading/read）。
paper_export：将整个文献库导出为 RIS、BibTeX 或 CSV 格式。

安装与启用¶

安装插件后，插件会通过 dsh.bundle.patch 自动挂载，无需手动修改配置文件。

安装命令：

# 本地开发安装（file: 路径免 allowBuilds）
dsh plugin --profile web add file:D:/Coding/DSH-Plugin/dsh-paperlens

# 或从 GitCode 安装（包内已包含 lib/，无 prepare 脚本）
dsh plugin --profile web add https://gitcode.com/foqiang/dsh-paperlens.git

配置说明¶

插件依赖 cordis.patch.yml 配置数据源。在 DSH 配置文件中插入以下内容：

- insert:
  - id: dsh-paperlens
    name: dsh-paperlens
    config:
      sources:
        openalex: { enabled: true, email: "you@example.com" }
        crossref: { enabled: true, email: "you@example.com" }
      defaultMaxResults: 20
      # libraryDir: 默认为 ~/.dsh/paperlens/

注意：OpenAlex 使用邮箱注册可提升 polite pool 优先级。

典型用法¶

检索论文：在 DSH 会话中使用 paper_search 工具，指定关键词进行跨源检索。
生成引用：使用 paper_cite 工具，将论文 DOI 或 ID 转换为 GB/T 7714 等格式。
管理文献：使用 paper_save 将论文存入本地库，使用 paper_export 导出为 BibTeX 格式供 LaTeX 使用。

适用场景与注意事项¶

数据隐私：数据仅经开放学术 API 传输，文献库存于本机 ~/.dsh/paperlens/library.db，无明文 API Key 必需，数据不出机器。
源限制：目前不包含需浏览器认证的源（如 CNKI、万方、Scopus、ScienceDirect）。
KV Cache 影响：插件默认不注入任何模型可见上下文（无 systemPrompt section），仅在调用工具时产生一次性结果，对 KV cache 稳定前缀无影响，采用 append-only 会话记录。

生态与许可¶

该项目受 PaperLens 工作流启发，但代码全部重写。许可证为 MIT 许可证。