前言¶
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
- macOS:
-
啓動 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 倉庫 查看。
