在 DeepSeek Harness (DSH) 的插件生态中，编写代码或进行研究时，频繁切换软件去管理文献和阅读 PDF 会打断心流。DSH Literature 是一个安装在侧边栏的文献工具，能够直接在对话上下文中识别文献来源、抓取元数据、下载全文，并提供本地 PDF 阅读器与引用生成功能。
该插件由 Aik358 维护，采用 MIT 许可证，完全本地运行，无云端中转。
核心功能¶
插件主要解决文献获取、管理与阅读的集成问题：
- 内置文献库：识别下载的文献默认存储在插件本地，不依赖外部软件。支持导出为目录或与本地文献库联动。
- 自动识别与抓取：在模型回复或粘贴的文本中自动识别 DOI / arXiv ID / 标题，并调用 Crossref、arXiv、OpenAlex 等接口补全元数据。
- 全文下载：支持 OA 多源下载，遇到付费墙或登录墙时，需先在浏览器登录，下载后导入即可入库。
- 侧窗阅读器：内置 PDF 阅读器，支持缩放、翻页、目录跳转、全文搜索、高亮笔记（支持 Markdown）以及夜读模式。
- 引用生成：支持 APA 7 / GB/T 7714 / MLA 9 / Chicago 17 / BibTeX 等多种格式，支持参考文献、文内引用与直接引用。
- AI 助手联动：在阅读器中选中文字，可触发翻译、解释或总结，结果可直接发送到当前对话。
安装与启用¶
确保 DeepSeek Harness 版本满足要求（需 >= 0.1.1-rc.2，Cordis v4），且 Node.js 环境版本 >= 20。
执行以下命令安装插件：
dsh plugin --profile web add @a9i5k4/dsh-literature
安装完成后，需要重启 dsh web 进程，侧边栏才会出现“文献”入口。
典型用法¶
- 安装与启动：完成安装并重启后，侧边栏会出现文献管理入口。
- 识别文献：
- 在对话框中让模型返回包含 DOI 或 arXiv ID 的文本。
- 或者直接在输入框粘贴类似
"DOI: 10.1038/xxxx"或"arXiv:1706.03762"的文本。
- 入库与阅读：系统解析后显示条目，点击“下载全文”，随后点击“保存”将条目存入内置文献库。
- 引用导出：在文献卡片上右键，选择引用格式（如 BibTeX）并复制。
适用场景与注意事项¶
- 环境要求：该插件依赖 DeepSeek Harness >= 0.1.1-rc.2，且宿主环境需运行 Node >= 20。
- 隐私与本地化：所有请求通过本机回环接口转发，元数据请求直连公开 API，不经过第三方中转，无遥测数据上传。
- 付费墙处理：对于需要登录机构订阅的文献，插件无法直接破解下载。正确的流程是点击“打开登录页”在浏览器完成登录，下载 PDF 后点击“导入本地 PDF”入库。
- 兼容性：若安装了
dsh-better-sidebar插件，该插件会自动注册为右侧栏 Tab，否则默认占用左侧栏按钮位。
总结¶
DSH Literature 将文献管理流程深度集成到 DSH 侧边栏中，实现了从识别、下载到阅读、引用的一站式闭环。对于需要在 AI 对话中频繁查阅文献的开发者和研究者，这是一个减少工具切换、提升效率的实用插件。
