| name | pdf-to-video |
| description | Use when user wants to convert a PDF document into a showcase video, extract key points from PDF, or create video presentation from PDF file |
PDF to Video
将 PDF 文档转换为展示视频，自动提取核心观点并生成动态展示。
工作流程
digraph pdf_to_video {
rankdir=TB;
"接收 PDF 路径" -> "读取 PDF 内容";
"读取 PDF 内容" -> "分析提取核心观点";
"分析提取核心观点" -> "生成 props.json";
"生成 props.json" -> "复制 PDF 到 public";
"复制 PDF 到 public" -> "执行 remotion render";
"执行 remotion render" -> "输出 MP4 视频";
}
步骤详解
1. 读取 PDF 文件
使用 Read 工具读取用户提供的本地 PDF 文件路径。
2. 分析并提取核心观点
从 PDF 内容中识别：
- 标题：文档主标题，通常在首页
- 副标题：可选，如"核心内容概览"
- 核心观点：3-5 个关键页面及其标题
- 内容描述：每个关键页面的简要说明（1-2 句话），用于底部打字机效果展示
分析时关注：
- 章节标题和大纲
- 重点段落（加粗、高亮）
- 摘要和结论部分
- 图表和数据页面
3. 生成配置并渲染
目录结构：
props/ # 配置文件目录
glm45.json # 以文档名命名
report-2024.json
out/ # 输出视频目录
glm45.mp4
report-2024.mp4
public/ # 源 PDF 文件
document.pdf
创建 props/<name>.json：
{
"src": "/document.pdf",
"title": "文档标题",
"subtitle": "核心内容概览",
"highlights": [1, 3, 7, 12, 15],
"pageTitles": {
"1": "封面",
"3": "执行摘要",
"7": "市场分析"
},
"pageDescriptions": {
"1": "这是文档的封面页，展示了报告的主题和作者信息。",
"3": "执行摘要概述了报告的核心发现和建议。",
"7": "市场分析部分详细分析了当前市场趋势和竞争格局。"
}
}
执行命令：
cp /path/to/source.pdf ./public/document.pdf
npx remotion render PdfShowcase out/<name>.mp4 --props=./props/<name>.json
Props 参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|
src | string | 是 | PDF 文件路径，相对于 public 目录 |
title | string | 否 | 主标题 |
subtitle | string | 否 | 副标题 |
highlights | number[] | 否 | 要聚焦展示的页码 |
pageTitles | Record<string, string> | 否 | 每页的标题 |
pageDescriptions | Record<string, string> | 否 | 每页的内容描述，底部打字机效果展示 |
script | ScriptItem[] | 否 | 自定义脚本，完全控制展示流程 |
场景类型
可通过 script 参数使用不同的展示模式：
| 类型 | 说明 | 默认时长 |
|---|
stack | 卡片堆叠展示 | 60 帧 |
focus | 聚焦放大某页 | 120 帧 |
switch | 滑动切换 | 120 帧 |
fan | 扇形轮盘展示 | 150 帧 |
扇形模式示例：
{
"script": [
{ "type": "stack", "duration": 60 },
{ "type": "fan", "page": 1, "duration": 150 },
{ "type": "fan", "page": 3, "duration": 150 },
{ "type": "stack", "duration": 120 }
]
}
输出
- 视频文件：
out/<name>.mp4
- 格式：MP4
- 分辨率：1920x1080
- 帧率：30fps
示例交互
用户： 帮我把这个 PDF 转成展示视频：/Users/me/docs/report-2024.pdf
执行：
- 读取 PDF 内容
- 分析识别：标题"2024年度报告"，核心观点在第1、3、7、12、15页
- 复制 PDF 到
public/report-2024.pdf
- 生成配置
props/report-2024.json
- 执行
npx remotion render PdfShowcase out/report-2024.mp4 --props=./props/report-2024.json
- 告知用户视频已生成在
out/report-2024.mp4
