DeepSeek Harness 插件：read-paper - PDF 论文结构化阅读面板

前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。对于需要在本地运行智能体、处理文档的开发者而言，直接阅读 PDF 论文往往存在痛点：排版混乱、公式和图表难以解析、且无法在对话流中直接针对局部内容提问。read-paper 插件旨在解决这些问题，它将 PDF 转换为结构化的可选择文本，并在 DSH 的对话界面中提供论文阅读面板与问答能力。

这是什么¶

read-paper 是一个为 DeepSeek Harness 设计的论文阅读面板插件。由开发者 louwenbo580 维护，采用 MIT 许可证。它通过将 PDF 论文解析为结构化的 HTML 文档（包含双栏布局、标题、表格、目录等），并在侧边栏提供可选择的文本和图片渲染，同时支持针对选中内容的即时问答和项目工作区功能。

核心功能¶

该插件提供以下主要能力：

PDF 转结构化文本
基于宿主机的 Poppler 工具链运行，能够重建双栏布局、提取标题（支持大小写归一化和标题拆分）、识别表格（包括几何列检测和换行单元格处理）、处理上下标以及目录。
图表与公式渲染
使用 pdftoppm 和 pdfimages 提取图片和显示公式，将其渲染为图片。同时，公式内的文本会保留为隐藏的 HTML span，确保可搜索性。
右侧阅读面板
在 DSH 的 details 列中提供第三栏。当空间允许时显示为完整列，空间不足时自动折叠，并支持浮动布局和精简的 Tab 模式。
Ask 对话框
在阅读面板中选中任意文本，会触发一个浮动对话框。输入问题（如“解释这段逻辑”）后，选中的文本、上下文摘要以及论文摘要会被发送给模型进行回答。
Projects
利用“创建项目”功能，可以将论文（PDF、MD、HTML、图片、README）实体化为一个 Paper 工作区。这会打开一个新的会话，并让智能体加载该论文作为上下文，支持多个项目共存。

安装与启用¶

安装前请确保已安装 DeepSeek Harness (dsh)。

安装插件
使用以下命令将插件安装到指定的 profile（例如 readPaper）：

    dsh plugin --profile readPaper add @deepseek-ai/dsh-web-app paper-review

*注意：`@deepseek-ai/dsh-web-app` 包含了插件渲染所需的浏览器 GUI 层。*

安装依赖工具
插件依赖 Poppler 命令行工具。请确保 pdftotext、pdftoppm 和 pdfimages 已添加到系统 PATH 中。
- macOS: brew install poppler
- Debian/Ubuntu: sudo apt-get install poppler-utils
启动 Harness
使用配置好的 profile 启动：

    dsh --profile readPaper

典型用法¶

安装并启动后，可以通过以下步骤使用：

打开右侧的 “Paper” 标签页，进入阅读列。
点击 “Load PDF…” 按钮上传文件，或直接将 PDF 拖入阅读列。
在转换后的文本中选中某段内容，会弹出 Ask 对话框。输入问题并回车，模型将基于该段落及上下文进行回答。
点击工具栏的 “Create project”，系统会将论文材料转化为 Paper 工作区，并开启一个自动加载该论文上下文的会话。

适用场景与注意¶

适用场景：需要深度阅读 arXiv 或学术 PDF，并希望结合大模型对局部内容进行解释或总结的开发者。
注意 1：转换保真度严重依赖 PDF 的文本层。如果是扫描版 PDF，插件会退化为渲染为页面图片。
注意 2：显示公式被渲染为图片，其数学文本被隐藏为 span，因此无法通过 OCR 提取图片中的文字。
注意 3：无法提取仅存在于 PDF 注释（Annotation）中的内容（如某些期刊的全长作者列表）。
注意 4：插件的 HTTP 路由遵循 DSH 的本地信任模型，无需额外配置。

结语¶

read-paper 为 DSH 用户提供了一个从单纯对话到深度文档分析的中间地带。它通过结构化解析降低了处理 PDF 的门槛，并利用 Ask Dialog 和 Projects 功能强化了智能体对论文的上下文理解能力。相关代码与文档可在其 GitHub 仓库查看。