前言¶
DeepSeek Harness（DSH）的核心理念是“一切皆插件”。当智能体或开发者需要处理学术文献时，通常面临跨数据源检索效率低、引文格式难以统一、以及批量提取 BibTeX 数据繁琐的问题。flan246/dsh-lit-search 旨在解决这些痛点，它将 Crossref、OpenAlex 和 Semantic Scholar 的能力整合在一起，提供统一的命令行接口和 DSH 工具集。
插件定位¶
这是一个集成式的学术文献工具包，支持 DSH 插件、独立 CLI 和 Agent Skill 三种形态。它主要服务于需要构建学术研究型 Agent、撰写论文或进行文献管理的开发者。
核心功能¶
- 合并检索：同时查询 Crossref、OpenAlex 和 Semantic Scholar，按 DOI 去重，返回标题、作者、年份、期刊及引用次数。支持通过
--from/--to过滤年份，或按引用数、日期、相关性排序。 - 引文格式化：默认支持中文论文常用的 GB/T 7714 标准，也支持 GB/T 7714 数字格式（如
[1]-style）、APA 和 BibTeX。 - 批量 BibTeX 生成：针对一组 DOI 生成合并的
.bib文件，并单独列出生成失败的条目。 - 相关文献：基于 OpenAlex 的
related_works接口，获取指定 DOI 的相关论文。
安装与启用¶
通过官方目录安装插件：
dsh plugin add dsh-lit-search
安装完成后，DSH 会注册四个工具：lit_search、lit_cite、lit_bib 和 lit_related。
典型用法¶
安装成功后，可直接通过命令行调用工具，或在 Agent 中使用上述工具名称。以下是 CLI 的典型用法：
# 检索论文，限制返回数量
npx dsh-lit-search search "attention is all you need" -n 5
# 检索 2024 年后的论文，并按日期排序
npx dsh-lit-search search "moe" --from 2024 --sort date
# 生成 BibTeX 格式的引文
npx dsh-lit-search cite 10.1038/nature14539 -s bibtex
# 生成 GB/T 7714 数字格式的引文（适用于中文论文）
npx dsh-lit-search cite 10.1038/nature14539 -s gbt7714-numeric
# 批量生成 BibTeX 文件
npx dsh-lit-search bib 10.1038/nature14539 10.48550/arXiv.1706.03762
# 获取相关文献
npx dsh-lit-search related 10.1038/nature14539 -n 5
所有命令默认输出人类可读文本。若需机器输出，可在子命令前添加 --json（例如 npx dsh-lit-search --json search "transformers"）。
适用场景与注意¶
- 数据源：所有接口均为免费公共 API，无需申请 API Key。
- 网络层：HTTP 请求设置了 10 秒超时，遇到 5xx 或网络错误会重试一次，User-Agent 设置为礼貌的
mailto:格式。 - 错误处理：程序退出码定义如下：
0表示成功，1表示业务逻辑错误，2表示用法错误。 - 安全提示：插件以当前进程权限运行，建议在使用前确认源码内容与许可证（MIT）。
总结¶
对于需要构建学术研究型 Agent 或处理论文引用的开发者，dsh-lit-search 提供了一个轻量且无需配置的解决方案。更多技术细节和源码可参考其 GitHub 仓库。
