dsh-paper-tutor：面向中文讀者的英文論文精讀 Agent 預設

前言¶

在 DeepSeek Harness (DSH) 的插件體系中，構建特定場景的 Agent 是提升效率的關鍵。對於以中文爲母語的研究者而言，直接閱讀英文論文往往面臨術語理解、數學推導和版式閱讀的障礙。dsh-paper-tutor 插件正是爲此設計的預設插件，它提供了一套專門針對論文精讀的工作流和工具集，旨在降低英文文獻的閱讀門檻。

插件介紹¶

該插件由 ASAKAFENG 維護，開源協議爲 MIT。它是一個面向中文讀者的英文論文精讀 Agent 預設，核心價值在於通過自動化工具鏈和中文講解型人格，輔助用戶完成從資產盤點、內容提取到深度講解的全過程。

插件提供以下核心組件：

paper-tutor Agent 預設：這是一個專門配置好的會話預設，包含中文講解提示詞和 paper-reading skill。啓動後會自動安裝到 $DSH_HOME/.agent-presets/paper-tutor/。
paper_scan 工具：用於盤點工作區中的論文資產，包括 PDF 文件、LaTeX 源碼、圖表圖片、配套代碼及數據集。
pdf_extract 工具：基於純 JS 實現（無 npm 依賴），用於提取 PDF 全文。它能按頁提取，保留版式和雙欄順序，並自動提取內嵌圖表（自動匹配 caption）。
tex_structure 工具：解析 LaTeX 源碼結構，輸出章節大綱、圖表浮動體、公式、定理、引用鍵以及 \input 包含關係。
paper_figure 工具：從 PDF 頁面提取圖表（支持 PNG/JPEG），並利用啓發式匹配將圖表標題與圖片關聯。若配置了視覺端點，可進一步解讀圖表內容。

安裝與啓用¶

插件支持遠程一鍵安裝和本地開發安裝兩種方式。安裝完成後需重啓 DSH 以使預設生效。

方式一：遠程安裝（推薦）¶

使用官方提供的安裝腳本，自動下載最新版本並裝配到 DSH 環境：

curl -fsSL https://raw.githubusercontent.com/ASAKAFENG/dsh-paper-tutor/main/scripts/install.sh | bash -s -- --github

腳本會自動處理預設安裝到 $DSH_HOME/.agent-presets/paper-tutor/ 的流程。

方式二：本地安裝¶

若需修改源碼或離線安裝，可克隆倉庫後執行本地裝配：

git clone https://github.com/ASAKAFENG/dsh-paper-tutor.git
bash dsh-paper-tutor/scripts/install.sh

方式三：Profile Bundle¶

作爲 profile bundle 裝配，需在插件目錄構建，然後手動編輯 profile 的 package.json，添加依賴和 bundles 列表，最後重啓 DSH。

使用方法¶

啓用插件的核心流程如下：

啓動會話：在 DSH 中創建一個新會話，並在預設選擇器中選擇「論文精讀 · Paper Tutor」。
準備文件：將待閱讀的論文 PDF（或 LaTeX 源碼及配套代碼）放入當前工作區。
發起指令：向 Agent 發送自然語言指令，例如：
- “精讀這篇論文”
- “幫我看一下 xxx.pdf，講清楚方法部分”
Agent 工作流：
- paper_scan 掃描並盤點工作區資產。
- pdf_extract 提取 PDF 內容並建立閱讀卡片。
- 逐節進行中文講解。
- paper_figure 讀取圖表內容（若配置了視覺端點）。
- 對照工作區代碼進行溯源講解。
- 輸出精讀筆記。

建議將論文的配套代碼放在同一工作區或子目錄中，以便 Agent 進行代碼與論文的對照分析。

配置說明¶

插件支持多種配置項，主要用於控制 PDF 處理質量和視覺模型調用。

配置項	默認值	說明
`installPreset`	`false`	是否隨包安裝預設。
`pdftotext`	`"auto"`	`auto`/`on`/`off`。是否優先使用系統 poppler-utils (`pdftotext`) 提升提取質量。
`imageDir`	`".paper-figures"`	圖表提取輸出目錄（相對工作區）。
`maxPdfBytes`	200MB	單次解析的 PDF 大小上限。
`visionBaseURL`	`""`	OpenAI 兼容視覺端點地址。
`visionApiKey`	`""`	視覺 API Key（優先級高於環境變量）。
`visionApiKeyEnv`	`"VISION_API_KEY"`	存放 Key 的環境變量名。
`visionModel`	`"gpt-4o-mini"`	視覺模型名稱。

若未配置視覺端點，paper_figure 將返回圖片路徑，供用戶手動查看或配合其他多模態模型使用。

環境與依賴¶

該插件對運行環境有明確要求：

Node.js：必須安裝 Node.js ≥ 22。
DeepSeek Harness：依賴 DSH 0.1.x rc 系列。
系統工具：
- 安裝腳本需依賴 bash ≥ 3.2 (Linux/macOS) 或 PowerShell 5.1+ (Windows)。
- 推薦安裝 poppler-utils (pdftotext) 以獲得更佳的版式提取效果，若缺失則自動降級爲內置純 JS 引擎。

注意事項¶

目標用戶：插件專爲中文母語者設計，支持速覽、精讀、溯源（對照代碼）和批判四層深度。
運行權限：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
冪等性：安裝腳本具有冪等性，舊版本會自動備份爲 .bak-<timestamp>，重複執行安全。

結語¶

dsh-paper-tutor 通過集成論文資產盤點、結構解析和圖文提取能力，爲中文用戶提供了從“看懂”到“喫透”的完整輔助方案。配合可選的視覺端點，它能夠進一步解放雙手，專注於論文的邏輯梳理。