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 通过集成论文资产盘点、结构解析和图文提取能力，为中文用户提供了从“看懂”到“吃透”的完整辅助方案。配合可选的视觉端点，它能够进一步解放双手，专注于论文的逻辑梳理。