# Paper Explainer

科研论文解读：解析 arXiv/PDF 的公式与图表，提炼问题、贡献、方法、关键图和结论，再产出 B站/视频号解读视频或知乎/公众号图文。...

- Repository: https://github.com/ZJU-REAL/Easel (4293 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add ZJU-REAL/Easel --skill paper-explainer -g -a claude-code -y`
Codex: `npx skills add ZJU-REAL/Easel --skill paper-explainer -g -a codex -y`
Cursor: `npx skills add ZJU-REAL/Easel --skill paper-explainer -g -a cursor -y`
Gemini CLI: `npx skills add ZJU-REAL/Easel --skill paper-explainer -g -a gemini-cli -y`

## Description

科研论文解读：解析 arXiv/PDF 的公式与图表，提炼问题、贡献、方法、关键图和结论，再产出 B站/视频号解读视频或知乎/公众号图文。 当用户说“论文解读、讲论文、论文转视频/图文、科研科普、arXiv、学术视频”时使用。 本 SKILL 从论文做内容；video-to-article 从视频做图文，doc-convert 只转换文档格式。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 科研论文解读（论文 → 视频 / 图文）

> 把一篇论文讲成普通人/同行都爱看的视频号视频或图文。核心中间产物是一份
> **结构化 asset library**（一次解析+提炼，视频与图文两条产线共用，不重复调 LLM）。
> 确定性 IO（拉论文/解析 PDF/骨架）走 `scripts/paper_ingest.py`；**提炼与分镜脚本由你 LLM 完成**, , 这是本 SKILL 的核心价值。

> 视频转图文（反向）见 **video-to-article**；纯格式转换见 **doc-convert**；
> 只做图表见 **chart-visualization / infographic**；发视频号见 **skill-channels-upload**。

## 输入

| 字段 | 必填 | 说明 |
|------|------|------|
| 论文 | 是 | arxiv id（2401.12345）/ arxiv 链接 / 本地 PDF 路径（没给就问） |
| 目标形态 | 否 | 视频（默认，视频号/B站）/ 图文（知乎/公众号）/ 两者都要 |
| 视频画幅 | 视频时必填 | 用户或上游任务未明确横版/竖版（或 16:9/9:16/具体分辨率）时，进入视频制作前必须追问并等确认；不得按平台、Profile 或默认值静默推断，已明确则不重复问 |
| 受众深度 | 否 | 大众科普（默认）/ 同行向（更专业） |
| 时长 | 否 | 视频默认 2, 4 分钟（视频号中视频） |

## 产物结构（`outputs/论文简称/`）

```
article.md               图文版（知乎/公众号）
final.mp4                成片
assets/                  paper.pdf / parsed/ / asset-library.json / script.md
  slide-plan.json        结构化分页（页面唯一输入，口播与屏幕文字分离）
  slides/                稳定渲染的逐页 PNG + HTML + audit report
  slides-contact-sheet.jpg  整套视觉复核图
```

脚本（相对项目根）：`paper_ingest.py`（解析）+ `render_slides.py`（分页校验/渲染/审计）。

## 执行步骤

### 1. 取原文 + 解析

1. **环境自检**：`python skills/builtin/paper-explainer/scripts/paper_ingest.py check`
   （看 pdfplumber / MinerU token / 代理；缺 pdfplumber 则 `pip install pdfplumber`）。
2. **拉论文**：`paper_ingest.py fetch --paper <id/url/本地pdf> -o outputs/论文简称/assets/paper.pdf`。
3. **解析**：`paper_ingest.py parse -i outputs/论文简称/assets/paper.pdf -o outputs/论文简称/assets/parsed/`
   （有 `MINERU_API_TOKEN` 走 MinerU 含公式/图表结构化，否则 pdfplumber 纯文本 + 尽力抽图）。

### 2. 结构化提炼（你来做，核心）

The rest: https://github.com/ZJU-REAL/Easel/blob/HEAD/skills/builtin/paper-explainer/SKILL.md