What makes paper-report-ppt notable?

2.4K downloads. Trust evidence available

How should paper-report-ppt be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

paper-report-ppt

Turn research PDFs into editable group-meeting PPTX following the paper's structure; embed figures verbatim. Invoke when converting a paper into a group meeting presentation. Skill: paper-report-ppt Owner: mlj-1212 Summary: Turn research PDFs into editable group-meeting PPTX following the paper's structure; embed figures verbatim. Invoke when converting a paper into a group meeting presentation. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-04T12:26:12.609Z | auto paper-report-ppt 0.1.0 — Initial Release - Generate editable group-meeting PPTX directly from research article PDFs, ma

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.4k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.4K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.4K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.0release · observed Aug 4, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17bgbmh9vtr5sth8pdq39p3118bam87:paper-report-ppt

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-mlj-1212-paper-report-ppt/snapshot"

Documentation

CLAWHUB

45,492 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: paper-report-ppt
description: "Turn research PDFs into editable group-meeting PPTX following the paper's structure; embed figures verbatim. Invoke when converting a paper into a group meeting presentation."
---

# Paper Report PPT Skill

把研究生文献（PDF）按文章脉络生成用于组会汇报的**可编辑** PPTX。文献配图**原样嵌入不改**，使用自由设计路径生成学术专业风格演示文稿。

本 skill 是**自包含场景编排层**，所有核心能力通过内置 Python 脚本实现，不依赖任何外部 skill。只需 `pip install python-pptx PyMuPDF python-docx Pillow matplotlib` 即可在任何 AI 环境中使用。

---

## 触发条件

当用户出现以下意图时调用本 skill：
- "把这篇论文做成组会汇报 PPT"
- "这篇文献帮我整理成汇报 slides"
- "研究生组会汇报，按文章脉络来"
- 上传 PDF 并要求生成汇报演示文稿
- "paper report" / "literature presentation" / "journal club slides"

---

## 输入契约

| 输入 | 必需 | 说明 |
|---|---|---|
| 文献 PDF | 是 | 研究生文献（论文 / 预印本 / 学位论文），本地路径 |
| 汇报场景 | 否 | 组会 / 开题 / 中期 / 答辩；默认组会 |
| 目标页数 | 否 | 固定 17 页（含封面目录），不可更改 |
| 语言 | 否 | 默认跟随文献语言；中文文献默认中文汇报 |
| 侧重 | 否 | IMRaD 均衡 / 问题驱动 / 创新点驱动 / 综述对比；默认均衡 |
| 演讲稿 | 否 | 是否同步生成完整演讲稿（独立 DOCX 文稿）；默认生成 |

---

## 工作流（S0–S5）

### S0 — 意图确认与需求收集

- **输入**：用户对话 + PDF 路径
- **输出**：需求摘要（场景 / 页数 / 语言 / 侧重 + 矢量图处理决策）
- **脚本**：`scripts/install_check.py`
- **门禁**：⛔ ① 环境自检通过 ② 用户确认需求摘要后进入 S1

#### S0.1 环境自检（首要步骤）

进入 S0 后**第一件事**是运行环境自检：

```bash
python ${PAPER_REPORT_PPT_DIR}/scripts/install_check.py --json
```

自检内容：
- Python >= 3.8
- 4 个必需 pip 包：`python-pptx`、`PyMuPDF`、`python-docx`、`Pillow`（Pillow 用于 PDF 配图反色修复，缺失会导致黑底图问题）
- 1 个可选 pip 包：`matplotlib`（公式渲染）

退出码：0=就绪，2=需安装依赖。若退出码为 2，提示用户运行：
```bash
pip install python-pptx PyMuPDF python-docx Pillow matplotlib
```

#### S0.2 需求收集

**收集项**：
1. PDF 路径
2. 汇报场景与目标页数
3. 汇报语言
4. 脉络侧重（IMRaD 均衡 / 问题驱动 / 创新点驱动 / 综述对比）
5. PDF 中矢量图处理方式（默认不提取；如需保留接受栅格化）
6. 是否同步生成演讲稿（DOCX 格式，默认生成）

> **矢量图决策**：PDF 矢量图（图表 / 流程图）默认不提取。若用户要求保留：栅格化（`parse_pdf.py --render-vector-figures`，180 DPI）。在 S0 与用户确认。

---

### S1 — 文献解析与素材提取

- **输入**：PDF
- **输出**：
  - `<work_dir>/<stem>.md`（结构化 Markdown，含 `<!-- Page N -->` 标记）
  - `<work_dir>/<stem>_files/`（原样提取的配图 PNG/JPG + `image_manifest.json`）
  - `<work_dir>/pages/page_XXXX.txt`（逐页文本，长文献检索用）
  - `<work_dir>/formula_list.json`（公式检测清单）
- **门禁**：✅ `<stem>.md` 与 `image_manifest.json` 存在

**PDF 解析**（自包含，仅依赖 PyMuPDF）：

```bash
python ${PAPER_REPORT_PPT_DIR}/scripts/parse_pdf.py <pdf_path> -o <work_dir>/<stem>.md
```

> `parse_pdf.py` 是本 skill 自带的 PDF 解析器。功能包括：标题级别检测、加粗/斜体格式化、列表检测、页眉页脚过滤、图片原样提取（不重采样）、image_manifest.json 生成（字段：filename / sha256 / page_number / pixel_width / pixel_height / caption / figure_number）、基础表格检测、矢量图渲染（`--render-vector-figures`）。

**公式检测**：在 `<stem>.md` 中搜索 LaTeX 数学标记（`$...$` / `$$...$$` / `\(...\)` / `\[...\]`），生成 `formula_list.json`（每条记录：id / latex / source_page / complexity / render_as）。详细规则见 `references/formula-rendering.md`。

---

### S2 — 组会汇报脉络大纲生成

- **输入**：`<stem>.md` + `image_manifest.json` + `formula_list.json`
- **输出**：`<work_dir>/outline.md`（组会脉络页序列）
- **脚本**：`scripts/filter_images.py`（配图筛选）
- **门禁**：⛔ 用户确认大纲后进入 S3

#### 脉络模板预设

根据 S0 收集的"侧重"方向，从 `references/outline-templates.md` 选取对应模板。**无论选哪个模板，最终 slides.json 的 page_type 序列必须遵循 R1 硬性规则（17

README.md

# paper-report-ppt

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![TRAE Skill](https://img.shields.io/badge/TRAE-Skill-green.svg)]()
[![Python 3.8+](https://img.shields.io/badge/Python-3.8+-blue.svg)]()

> 上传一篇文献 PDF，自动生成**可编辑**的组会汇报 PPT。论文中的实验图表原样保留，同步生成配套的演讲稿 Word 文档。**自包含架构，无外部 skill 依赖，所有 AI 桌面应用通用。**

---

## 效果预览

以下是用真实文献生成的组会汇报 PPT 截图：

| 封面页 | 结果页（实验图原样嵌入） | 工作模型页 |
|:------:|:------:|:------:|
| [![封面页](assets/screenshots/slide_01.png)](assets/screenshots/slide_01.png) | [![结果页](assets/screenshots/slide_07.png)](assets/screenshots/slide_07.png) | [![工作模型](assets/screenshots/slide_13.png)](assets/screenshots/slide_13.png) |

**17 页完整 PPT，7 张实验图原样嵌入，三重质检全部通过。** [查看完整案例](#真实案例)

---

## 30 秒开始

```bash
git clone https://github.com/mlj-1212/paper-report-ppt.git
cd paper-report-ppt
python install.py
```

`install.py` 会自动安装全部依赖并完成环境自检，看到 `🎉 安装完成！` 即可使用。

> **AI 环境用户**：也可以直接告诉 AI「安装 https://github.com/mlj-1212/paper-report-ppt 这个 skill」，AI 会自动完成克隆和安装。
>
> **仓库体积仅 ~220 KB**（不含截图） — 完全自包含，无外部 skill 依赖，无 Node.js 依赖。

---

## 用法：两步生成 PPT

### 第 1 步：上传 PDF

把你的文献 PDF 发给 AI，说一句"生成组会汇报 PPT"就行。AI 会自动处理语言识别、页数、结构、图表嵌入、演讲稿生成等所有细节。

### 第 2 步：确认大纲，等待生成

AI 会先给你一个汇报大纲（类似目录），你回复"确认"后，AI 开始生成 PPT。处理完成后，你会收到：

- **一份 PPTX 文件** — 可编辑的组会汇报 PPT，论文图表原样保留
- **一份 DOCX 文件** — 完整的演讲稿，约 3000–6000 字

---

## 进阶用法

如果你想自定义汇报风格，可以在上传 PDF 时附带说明：

| 你想做什么 | 告诉 AI |
|---|---|
| 侧重创新点 | "侧重展示创新点和核心发现，控制在 10 页以内" |
| 英文汇报 | "用英文生成汇报" |
| 开题/答辩场景 | "用于开题汇报，约 20 页，重点展示研究背景和方法对比" |
| 切换视觉主题 | "使用 ref 主题风格（深蓝顶部条 + 中英文对照封面）" |

---

## 功能特性

| 特性 | 说明 |
|------|------|
| **脉络模板预设** | 4 种汇报模板：IMRaD 均衡 / 问题驱动 / 创新点驱动 / 综述对比，一键切换 |
| **配图智能筛选** | 基于 caption 语义自动筛选和排序配图，过滤装饰图，sha256 去重 |
| **公式保真渲染** | 检测文献中 LaTeX 数学公式，复杂公式渲染为高清 PNG 嵌入 PPT，简单公式保留可编辑文本 |
| **文献脉络还原** | 按引言-方法-结果-讨论的结构自动组织汇报内容 |
| **配图原样保留** | 实验图、数据图从 PDF 原样提取，SHA256 校验，不做裁剪 |
| **多视觉主题** | 内置 academic / minimal / trae / ref 四种主题，自由设计路径生成专业学术风格 |
| **同步演讲稿** | 生成完整口头演讲文字稿（DOCX），含开场白、逐页讲解、时长分配、问题预判 |
| **完全可编辑** | 输出为原生 PPTX，文本、形状、图片均可修改 |
| **自动质检** | 可编辑性 + 图片完整性 + 脉络一致性三重核验 |
| **跨平台通用** | 纯 Python 实现，任何有文件系统的 AI 环境均可使用 |

---

## 适用场景

- 研究生组会文献汇报（Journal Club）
- 开题 / 中期 / 答辩演示
- 学术会议快速准备

---

## 真实案例

以下是用本工具处理一篇真实植物病理学文献的完整测试结果。

### 文献信息

| 项目 | 内容 |
|------|------|
| 论文 | *RSV infection induces upregulation of deubiquitinase UBP16 to stabilize SHMT1 for promoting viral infection* |
| 期刊 | **Stress Biology**, 2025, 5:62 |
| 作者 | Wang et al. |
| PDF | 10 页，含 7 张配图（Figure 1–7） |
| 汇报语言 | 中文 |

### 生成结果

| 指标 | 数值 |
|------|------|
| 总页数 | **17 页**（IMRaD 均衡模式） |
| 配图嵌入 | 7/7 原样嵌入（SHA256 全匹配） |
| PPTX 大小 | 1.15 MB |
| 演讲稿字数 | ~3,500 字（约 20 分钟） |

### 幻灯片结构

```
P01  封面          — 标题、作者、期刊、汇报人
P02  目录          — 六大板块导航
P03  文献选择依据   — 为什么选这篇
P04  研究背景      — RSV 与植物泛素化防御
P05  科学问题      — 核心假说与研究策略
P06  方法总览      — 多层次验证体系
P07  系统筛选      — NbUBP16 响应 RSV 感染 [Figure 1]
P08  蛋白互作      — NbUBP16.1 与 NbSHMT1 互作 [Figure 2]
P09  酶活验证      — 去泛素化稳定 NbSHMT1 [Figure 3]
P10  功能分析      — OE-Nb

_meta.json

{
  "ownerId": "kn716er85s8hpr2aj2tw6qg4h18baz6a",
  "slug": "paper-report-ppt",
  "version": "0.1.0",
  "publishedAt": 1785846372609
}

references/example-slides.json

[
  {
    "page_num": 1,
    "page_type": "cover",
    "cn_title": "泛素特异性蛋白酶16通过调控Na+/H+逆向转运活性调节拟南芥的耐盐性",
    "en_title": "UBIQUITIN-SPECIFIC PROTEASE16 Modulates Salt Tolerance in Arabidopsis",
    "subtitle": "Zhou et al., The Plant Cell, 2012, Vol. 24: 5106-5122",
    "presenter": "汇报人：研究生组会汇报",
    "date": "2026年7月29日",
    "notes": "今天汇报的文献是2012年发表在The Plant Cell上的文章，主要报道了去泛素化酶UBP16在拟南芥耐盐调控中的功能机制。"
  },
  {
    "page_num": 2,
    "page_type": "toc",
    "title": "汇报提纲",
    "sections": ["研究背景与科学问题", "材料与方法", "主要结果", "讨论与结论"],
    "notes": "本次汇报分为四个部分：首先介绍研究背景和科学问题，然后简要介绍材料与方法，重点展示主要结果，最后进行讨论和总结。"
  },
  {
    "page_num": 3,
    "page_type": "section",
    "title": "研究背景与科学问题",
    "section_no": 1,
    "notes": "首先进入第一部分，研究背景与科学问题。"
  },
  {
    "page_num": 4,
    "page_type": "content",
    "title": "研究背景：盐胁迫与植物响应",
    "sub_title": "盐胁迫信号通路与Na+稳态调控",
    "kicker": "背景介绍",
    "bullets": [
      "土壤盐渍化是全球农业主要非生物胁迫之一，导致作物减产",
      "植物通过SOS信号通路调控Na+外排，维持离子稳态",
      "泛素化修饰在胁迫信号传导中发挥关键调控作用",
      "去泛素化酶（DUBs）是否参与耐盐调控尚不清楚"
    ],
    "conclusion": "去泛素化酶在植物耐盐调控中的功能是本文要回答的核心问题",
    "notes": "盐胁迫是影响植物生长的重要非生物胁迫。植物主要通过SOS通路调控Na+外排来维持离子稳态。泛素化修饰在胁迫信号传导中有重要作用，但去泛素化酶是否参与耐盐调控还不清楚，这就是本文的切入点。"
  },
  {
    "page_num": 5,
    "page_type": "content",
    "title": "科学问题与研究策略",
    "sub_title": "UBP16的发现与功能假说",
    "kicker": "科学问题",
    "bullets": [
      "前期筛选发现ubp16突变体对盐胁迫高度敏感",
      "UBP16是否通过去泛素化调控SOS1蛋白稳定性？",
      "研究策略：遗传学+生化+生理学三管齐下",
      "预期：UBP16去泛素化稳定SOS1，增强Na+外排能力"
    ],
    "conclusion": "核心假说：UBP16通过去泛素化SOS1维持其蛋白稳定性，从而调控耐盐性",
    "notes": "作者在前期筛选中发现ubp16突变体对盐胁迫高度敏感，由此提出科学问题：UBP16是否通过去泛素化调控SOS1蛋白稳定性？研究采用了遗传学、生化和生理学三种手段相结合的策略。"
  },
  {
    "page_num": 6,
    "page_type": "section",
    "title": "主要结果",
    "section_no": 2,
    "notes": "接下来进入第二部分，主要结果展示。"
  },
  {
    "page_num": 7,
    "page_type": "figure",
    "title": "图1 ubp16突变体盐敏感表型",
    "sub_title": "UBP16缺失导致耐盐性显著下降",
    "kicker": "遗传学验证",
    "bullets": [
      "ubp16突变体在150mM NaCl处理下根长显著缩短",
      "回补株系恢复了野生型耐盐表型"
    ],
    "conclusion": "UBP16正调控拟南芥耐盐性",
    "image_path": "JPGR_p6_0.jpeg",
    "image_caption": "Fig. 1 ubp16 mutant shows salt-hypersensitive phenotype.",
    "notes": "请看这张图，左 panel 是野生型、突变体和回补株系在正常和盐胁迫条件下的根长比较。可以看到ubp16突变体在盐处理下根长显著缩短，而回补株系恢复了正常表型，说明UBP16正调控耐盐性。"
  },
  {
    "page_num": 8,
    "page_type": "figure",
    "title": "图2 UBP16蛋白结构域分析",
    "sub_title": "UBP16含有典型去泛素化酶催化结构域",
    "kicker": "结构分析",
    "bullets": [
      "UBP16含C19泛素特异性蛋白酶催化结构域",
      "催化活性关键位点Cys和His保守"
    ],
    "conclusion": "UBP16是典型的去泛素化酶家族成员",
    "image_path": "JPGR_p7_1.jpeg",
    "image_caption": "Fig. 2 Domain architecture of UBP16.",
    "notes": "这张图展示了UBP16的蛋白结构域，可以看到它含有典型的C19去泛素化酶催化结构域，催化活性关键位点Cys和His都很保守，说明它是典型的去泛素化酶。"
  },
  {
    "page_num": 9,
    "page_type": "figure",
    "title": "图3 UBP16与SOS1蛋白互作验证",
    "sub_title": "酵母双杂交与Co-IP证实互作",
    "kicker": "互作验证",
    "bullets": [
      "酵母双杂交显示UBP16与SOS1 C端互作",
      "Co-IP实验在体内证实两者形成复合物"
    ],
    "conclusion":

references/formula-rendering.md

# 公式保真渲染规则

## 概述

检测文献中的关键数学公式（LaTeX 风格），通过 LaTeX 渲染为高清 PNG 嵌入 PPTX，保证公式可读性。

---

## 公式检测

### 1. 检测范围

在 S1 文献解析时，从 `<stem>.md` 中检测以下 LaTeX 公式标记：

| 标记形式 | 示例 | 处理方式 |
|----------|------|----------|
| `$...$` (inline) | `$E = mc^2$` | 渲染为 PNG，inline 嵌入 |
| `$$...$$` (display) | `$$\int_0^1 f(x)dx$$` | 渲染为 PNG，单独占一行 |
| `\(...\)` (inline) | `\(x^2 + y^2 = r^2\)` | 渲染为 PNG，inline 嵌入 |
| `\[...\]` (display) | `\[\sum_{i=1}^n x_i\]` | 渲染为 PNG，单独占一行 |

### 2. 检测策略

- 在 `<stem>.md` 中搜索所有 LaTeX 数学标记
- 生成公式清单，每公式记录：页码、上下文、复杂度评估
- 判断规则：
  - **简单公式**（单行、无矩阵、无嵌套分式）：尝试保留为可编辑文本（Unicode 数学符号 + 上下标）
  - **复杂公式**（多行、矩阵、分式、积分、求和）：渲染为高清 PNG

### 3. 公式清单格式

```json
{
  "formulas": [
    {
      "id": "formula_01",
      "latex": "\\frac{d[P]}{dt} = k_{cat}[E]_0\\frac{[S]}{K_m + [S]}",
      "source_page": 5,
      "context": "Michaelis-Menten equation",
      "complexity": "complex",
      "render_as": "png",
      "width": 250,
      "height": 60
    },
    {
      "id": "formula_02",
      "latex": "p < 0.05",
      "source_page": 8,
      "context": "Statistical significance",
      "complexity": "simple",
      "render_as": "text"
    }
  ]
}
```

---

## LaTeX 渲染为 PNG

### 1. 渲染脚本

使用 `matplotlib` + `mathtext` 渲染（不需要完整 LaTeX 环境）：

```python
# render_formula.py
import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt

def render_latex_to_png(latex_str, output_path, dpi=300):
    """
    将 LaTeX 公式渲染为高清 PNG。
    dpi=300 确保高分辨率，适合 PPT 嵌入。
    """
    fig, ax = plt.subplots(figsize=(4, 0.8))
    ax.axis('off')
    ax.text(0.5, 0.5, f'${latex_str}$',
            fontsize=14,
            horizontalalignment='center',
            verticalalignment='center',
            transform=ax.transAxes)
    fig.savefig(output_path, dpi=dpi, bbox_inches='tight',
                pad_inches=0.1, transparent=True)
    plt.close(fig)
```

### 2. 调用方式

```bash
python ${PAPER_REPORT_PPT_DIR}/scripts/render_formula.py <formula_list.json> <output_dir>
```

输出：`<output_dir>/formula_01.png`, `formula_02.png`, ...

### 3. 渲染参数

| 参数 | 默认值 | 说明 |
|------|--------|------|
| dpi | 300 | 输出分辨率，300 DPI 保证 PPT 中清晰显示 |
| fontsize | 14 | 公式字号 |
| bbox_inches | tight | 自动裁剪白边 |
| transparent | true | 透明背景，适合嵌入 PPT |
| pad_inches | 0.1 | 最小内边距 |

---

## 公式嵌入 PPTX

### 1. 图片契约

公式图片在 Strategist 阶段标记为：

```
Acquire Via: formula
Status: Existing
Crop Policy: no-crop
Dimensions: 见 render_formula.py 输出
```

### 2. 嵌入方式

- **Display 公式**（`$$...$$`）：在 SVG 中单独占一行，居中显示
- **Inline 公式**（`$...$`）：在 SVG 中与正文同行，保持基线对齐
- **简单公式**（保留为文本）：在 SVG 中用 `<text>` 元素 + Unicode 数学符号

### 3. SVG 嵌入示例

```xml
<!-- Display 公式（复杂，渲染为 PNG） -->
<image href="../images/formula_01.png"
       x="100" y="400" width="300" height="60"
       preserveAspectRatio="xMidYMid meet"/>

<!-- Inline 公式（简单，保留为文本） -->
<text x="100" y="500" font-size="14" fill="#333">
  Statistical significance: p &lt; 0.05
</text>
```

---

## 公式质量检查

### 1. 渲染检查

- 检查 PNG 是否成功生成，文件大小 > 0
- 检查公式是否清晰可读（无模糊、无截断）
- 检查公式背景是否透明

### 2. 内容检查

- 对比渲染结

Github ReposUpdated 3h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.