前言¶
DeepSeek Harness (DSH) 是一个基于插件的智能体开发平台。在使用大模型进行学术研究或文档写作时，模型有时会编造论文、作者或 DOI 等文献信息，即产生“幻觉”。DeepSeek Harness 学术文献插件旨在解决这个问题。它作为纯工具型插件接入 DSH，负责真实数据源的检索与引用格式生成，从机制上杜绝模型编造文献信息。
核心功能¶
该插件提供以下核心能力：
- 多数据源检索：支持 arXiv 和 Semantic Scholar 两个公开数据源。检索时支持关键词、作者、年份范围过滤，并支持相关性、日期或引用数排序。
- 单篇论文详情：可按 paperId、DOI 或 arXiv ID 获取论文的完整元数据，包括摘要、作者列表、期刊/会议名称、引用数以及 PDF 链接。
- 引用格式生成：本地确定性生成 GB/T 7714、APA 和 BibTeX 三种格式的引用，不依赖大模型。
- 本地文献库管理：支持将检索到的文献加入当前会话的文献库。文献库具备会话隔离、自动去重（基于 DOI/arXiv ID/标题）功能，支持删除、清空及批量导出。
- 侧边面板与防幻觉：提供可视化的侧边面板（支持浅色/深色主题适配），用于查看历史记录、管理文献库。系统 Prompt 强制要求学术文献必须经工具检索，禁止编造。
安装与启用¶
安装前请确保已安装 DeepSeek Harness 环境，版本需满足 Node.js 22+，并使用 Web profile。
安装命令¶
执行以下命令将插件添加到 Web profile：
dsh plugin --profile web add dsh-plugin-academic-paper
重启生效¶
安装完成后，需重启 Web profile 使插件生效：
dsh web
验证¶
重启后，DeepSeek Harness 网页右下角会出现“📚 文献”胶囊入口。点击即可展开侧边文献库面板，此时模型即可使用 academic_* 系列工具。
配置项¶
插件支持行配置，修改后通常无需重启即可热更新生效。主要配置项包括：
enable：是否启用插件（默认 true）。default_source：默认数据源，可选arxiv、semantic_scholar或both。max_results：单次检索最大返回条数（1-50，默认 10）。default_cite_format：默认引用格式，可选gb_t_7714、apa或bibtex。request_timeout：API 请求超时时间（秒，默认 15）。max_library_size：单会话文献库上限（默认 500）。
典型用法¶
通过自然语言与模型交互，即可调用上述功能：
- 检索文献：
> “帮我检索关于 transformer 的论文，最近 5 年，来源 arXiv” - 获取详情：
> “检索 Vaswani 2017 那篇 Attention Is All You Need 的详细信息” - 生成引用：
> “把这篇文献加入文献库，然后用 GB/T 7714 生成引用” - 导出文献库：
> “导出文献库为 BibTeX 和 Markdown”
注意事项¶
- 纯工具型：本插件不提供付费全文下载服务，仅返回元数据与公开摘要。
- 数据隔离：文献库、检索历史及缓存仅保存在内存中，按会话隔离，插件卸载或 Harness 重启后自动清空，无磁盘残留。
- 许可证：遵循 MIT 许可证。
结尾¶
该插件通过对接公开 API 并在本地进行确定性处理，为 DSH 提供了可靠的学术文献检索与引用管理能力。对于需要严谨引用背景的开发者或研究者，这是一个必要的辅助工具。
- GitHub: https://github.com/zhaoxuejie/dsh-plugin-academic-paper
