deepseekplugins

DeepSeek Harness plugin

dsh-paper-tutor

面向中文读者的英文论文精读 Agent 预设插件：自动安装 paper-tutor 预设，提供零依赖 PDF 文本/图表提取（pdf_extract）、工作区论文盘点（paper_scan）、LaTeX 结构解析（tex_structure）与图表视觉分析（paper_figure），结合论文代码溯源讲解论文。

Workflow & Automation
Jump to install

Source facts

Repository
ASAKAFENG/dsh-paper-tutor
Latest update
Aug 16, 2026
Category
Workflow & Automation
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/ASAKAFENG/dsh-paper-tutor
Plugin: dsh-paper-tutor
Author: ASAKAFENG

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-paper-tutor

面向中文读者的英文论文精读 Agent 预设插件，为 DeepSeek Harness 提供：

  • paper-tutor Agent 预设（论文精读）：中文讲解型人格 + 精读工作流提示词 + 随附 paper-reading skill。启动时自动安装到 $DSH_HOME/.agent-presets/paper-tutor/，在会话预设选择器中直接可选。
  • 4 个论文工具（仅对选用该预设的会话生效）：
工具作用
------
paper_scan盘点工作区论文资产：PDF / LaTeX / 图表图片 / 论文代码 / 数据
pdf_extract纯 JS 提取 PDF 全文（按页、保留版式与双栏顺序）与内嵌图表（自动匹配 caption）
tex_structure解析 LaTeX 结构：章节大纲、图表浮动体、公式、定理、引用键、\input 包含关系
paper_figure从 PDF 提取图表并（可选）调用视觉端点解读图表内容

面向的用户：以中文为母语、可能对英文论文/术语/数学推导感到吃力的学习者。预设默认按"零基础也能听懂"讲解，支持速览/精读/溯源（对照代码）/批判四层深度，输出论文卡片、术语表与论文↔代码对照表。

特性

  • 零 npm 运行时依赖：PDF 文本/图片提取为纯 JS 实现（node 内置 zlib），跨平台开箱即用；检测到 pdftotext（poppler-utils）时自动使用它加速并提升版式质量（config.pdftotext: "auto"，可关）。
  • 图表提取：从 PDF 页面提取内嵌图片（Flate/DCT/Indexed/CMYK/1-16bit），写为 PNG/JPEG 到 .paper-figures/，并启发式匹配 "Fig. 1: …" 标题。
  • 图表解读：可选 OpenAI 兼容视觉端点（与 dsh-tool-vision 同款配置约定），未配置时优雅降级为返回图片路径供多模态模型/用户查看。
  • 幂等安装：预设安装器只在版本变化时升级（旧版自动备份为 .bak-<ts>），从不覆盖未标记的用户自建目录。

一键安装

方式 A：远程安装（推荐，无需克隆仓库）

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

脚本会自动：下载最新 Release → 解压装配进 profile（$DSH_HOME/profiles/<profile>/node_modules/ + dsh.profile.bundles 注册，默认 profile 为 web，可用 --profile <name> 指定）→ 安装预设到 $DSH_HOME/.agent-presets/paper-tutor/。幂等，重复执行安全。

Windows（PowerShell 5.1+/7）：

irm https://raw.githubusercontent.com/ASAKAFENG/dsh-paper-tutor/main/scripts/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Github

方式 B：本地安装（克隆仓库后）

git clone https://github.com/ASAKAFENG/dsh-paper-tutor.git
bash dsh-paper-tutor/scripts/install.sh            # 本地装配（link: 指向克隆目录，便于开发）

方式 C：作为 profile bundle（手动）

# 在插件仓库目录构建
bash scripts/build.sh

# 装配进 profile（web profile 示例）——加入 dependencies link: + bundles 列表，
# 建 node_modules junction
# （在 DSH 内使用 dev_install_package 注入器，或手动编辑 profile package.json：
#   "dependencies": { "@dsh-external/dsh-paper-tutor": "link:<本目录>" },
#   "dsh": { "profile": { "bundles": [ ..., "@dsh-external/dsh-paper-tutor" ] } }
#   然后重启 dsh）

三种方式任选其一，然后重启 DSH：bundle 层装配后，安装器把 paper-tutor 预设写入 $DSH_HOME/.agent-presets/，新开会话即可在预设选择器中选择「论文精读 · Paper Tutor」。

> 卸载：从 profile 的 package.json 移除 dependencies/dsh.profile.bundles 条目，删除 node_modules/@dsh-external/dsh-paper-tutor 与 $DSH_HOME/.agent-presets/paper-tutor。

发布为 marketplace 插件

npm pack 产出 tgz 后按 DSH marketplace 规范发布；包内 cordis.patch.yml 会在装配时自动注册安装器（安装器同时把预设装入 $DSH_HOME/.agent-presets/）。

配置

插件行（cordis.patch.yml 或预设 agent.cordis.yml 的 config）：

键默认说明
installPresetfalsehost 面：安装/升级随包预设
pdftotext"auto"auto/on/off：是否优先使用 poppler pdftotext
imageDir".paper-figures"图表输出目录（相对会话工作区）
maxPdfBytes200MB单次解析的 PDF 大小上限
visionBaseURL""OpenAI 兼容视觉端点（如 https://dashscope.aliyuncs.com/compatible-mode/v1）
visionApiKey""API Key（优先于环境变量）
visionApiKeyEnv"VISION_API_KEY"存放 Key 的环境变量名
visionModel"gpt-4o-mini"视觉模型名
visionMaxTokens2048视觉回答上限
visionTimeoutMs90000视觉调用超时

视觉端点也可用环境变量配置：PAPER_TUTOR_VISION_BASE_URL、PAPER_TUTOR_VISION_API_KEY、PAPER_TUTOR_VISION_MODEL。未配置时 paper_figure 返回图片路径并给出引导，不报错。

使用示例

1. 开一个「论文精读 · Paper Tutor」会话，工作区放好论文 PDF（或 LaTeX 源码 + 代码）。 2. 说："精读这篇论文" 或 "帮我看一下 xxx.pdf，讲清楚方法部分"。 3. Agent 会：paper_scan 盘点 → pdf_extract 建卡片 → 逐节讲解 → paper_figure 读图 → 对照工作区代码 → 输出精读笔记。

建议把论文配套代码放在同一工作区（或子目录），溯源讲解效果最佳。

插件市场

本插件已关联 DSH 插件市场（索引：bradeGithub/DSH-Plugins-Marketplace，按 topic:dsh-plugin 聚合、每 2 小时自动刷新）：

  • 仓库 topics：dsh-plugin deepseek-harness dsh paper-reading pdf latex academic agent-preset llm
  • 市场页搜索 paper-tutor（或 dsh-paper-tutor）即可找到；市场按 cordis-plugin 管线安装（根目录刻意不放 install 脚本以避免误判为脚本型；包声明 dsh.plugin + bundle.patch + scripts.build，市场会克隆仓库 → 检测到未构建的 lib/ 自动执行 npm run build → 注册 bundle → 重启生效），预设由插件运行时自动安装到 $DSH_HOME/.agent-presets/，卸载可回滚
  • 市场安装同样会触发包内安装器：$DSH_HOME/.agent-presets/paper-tutor/ 自动就位

> 若刚发布/刚加 topic 暂时搜不到，等市场索引刷新（≤2 小时）或先用上方一键安装命令。

环境依赖与配套插件

系统依赖（本机）

级别依赖说明
必需Node.js ≥ 22DSH 运行时本身的要求（插件 engines 声明同款）；安装脚本也复用 node
必需DSH 0.1.x rc 系列依赖 dsh.profile.bundles 装配机制；profile 布局 $DSH_HOME/profiles/<name>/
安装必需bash ≥ 3.2（Linux/macOS）或 PowerShell 5.1+ / Windows 10 1803+（tar.exe）一键安装脚本环境
安装必需curl（或 node ≥ 18 的 fetch 兜底）+ tar远程下载与解压
强烈推荐poppler-utils（pdftotext）文本提取更快、版式/双栏更准；缺失时自动回退内置纯 JS 引擎
可选OpenAI 兼容视觉端点paper_figure 的图表解读能力（见下文"视觉端点"）
可选网络可达 GitHub远程一键安装需要；离线可用本地模式（克隆/拷贝后安装）

poppler-utils 安装（一行命令）：

# Debian / Ubuntu
sudo apt install -y poppler-utils
# RHEL / Fedora
sudo dnf install -y poppler-utils
# macOS（Homebrew）
brew install poppler
# Windows（Scoop / Chocolatey）
scoop install poppler
choco install poppler

> 验证：pdftotext -v。不装也不影响使用——pdf_extract 自动检测并降级为内置引擎（config.pdftotext 可强制 on/off）。

配套 DSH 插件（可选，推荐）

插件推荐度与本插件的关系
dsh-tool-vision（视觉模型）⭐ 强烈推荐提供 inspect_image 工具、Web UI 设置栏（可视化配置视觉端点）与图片桥接（粘贴的图片自动转文字提示）。paper_figure 提取出图表后，若本插件未配置视觉端点，模型可改调 inspect_image 读图。两端点配置约定一致（默认读取 VISION_API_KEY 环境变量），装了它再配一个视觉端点，图表解读开箱即用
dsh-tdai-memory（跨会话记忆）可选长期读论文时累积术语表/笔记，新会话可直接延续之前的阅读上下文
dsh-plugin-marketplace（插件市场）可选DSH 官方插件市场，装上述插件最方便：dsh plugin add <name>

> 以上均为可选。不装任何配套插件，paper-tutor 也能独立工作（PDF/LaTeX/图表提取全内置；图表解读降级为返回图片路径）。

视觉端点（可选）配置对照

paper_figure 与 dsh-tool-vision 共用同一套约定，任选一种配置方式：

配置途径键/变量示例
环境变量（本插件）PAPER_TUTOR_VISION_BASE_URL / VISION_API_KEY / PAPER_TUTOR_VISION_MODELhttps://dashscope.aliyuncs.com/compatible-mode/v1 / sk-... / qwen-vl-max
插件 config（本插件预设行）visionBaseURL / visionApiKey / visionModel同上
dsh-tool-vision Web UI 设置设置页"tool-vision"分区同一端点，UI 可视化编辑、热生效

常见免费/低门槛端点：DashScope（阿里云百炼，qwen-vl 系列）、智谱 GLM-4V、Ollama 本地（llava/qwen2.5vl 等）。

开发

bash scripts/build.sh   # 装配 lib/ + 链接运行时依赖（Windows 用 Git Bash/WSL）
node test/pdf-smoke.mjs # PDF 引擎冒烟测试（生成合成 PDF 验证提取）

许可证

MIT

Back to searchOpen GitHub repository

More related plugins

View category