# html2video

**Repository Path**: xkpro/html2video

## Basic Information

- **Project Name**: html2video
- **Description**: 录制 Html 页面为视频
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网页转视频工具 (html2video)

使用 Puppeteer + FFmpeg 将网页（在线 URL 或本地 HTML 文件）录制为高清视频。

## 功能特性

- **在线 URL / 本地 HTML 双支持**：本地文件自动启动临时 HTTP 服务器，`fetch`/AJAX/相对路径资源均可正常工作
- **自动匹配操作系统显示**：自动检测主屏幕物理分辨率和 DPI 缩放，默认与您的屏幕所见完全一致
- **像素级高清捕获**：PNG 无损截图 + 物理分辨率捕获，无放大、无模糊
- **多编解码器支持**：H.264 / H.265 / VP9 / RGB 无损，通过 `--codec` 参数选择
- **数学级无损模式**：`--crf 0` 或 `--codec lossless` 时自动启用 RGB 色彩空间编码，输出与原网页逐像素一致
- **高质量默认值**：60fps、yuv444p 完整色度、CRF 18 视觉无损
- **音频捕获与自动停止**：拦截 `<audio>`/`<video>` 元素及 Web Audio API，音频结束后自动停止录制（+2s 尾音保留）
- **封面图支持**：指定封面图片，视频开头展示 1 秒静态封面后转入录制内容
- **整体进度显示**：录制与合并阶段实时百分比进度条，无需猜测等待时间
- **资源就绪检测**：录制前自动等待字体、图片、媒体元素全部加载完毕
- **图形界面（GUI）**：内置 Web 管理界面，可视化配置参数、实时查看输出日志、一键定位生成视频文件，无需记忆命令行参数
- **临时目录自动清理**：每次任务执行前自动清理上次录制的临时文件，无需手动干预
- **视频定位**：录制完成后可在资源管理器中一键定位视频文件位置

## 环境要求

- Node.js 16+
- Windows / macOS / Linux

## 安装

```bash
npm install --legacy-peer-deps
```

> `--legacy-peer-deps` 用于避免 `puppeteer` 与 `puppeteer-screen-recorder` 之间可能的 peer dependency 冲突。

安装会自动下载 Chromium 浏览器（约 300MB）和 FFmpeg 二进制。

依赖（`package.json` 中已声明，`npm install` 后自动安装）：

| 依赖 | 作用 |
|------|------|
| `puppeteer` | 浏览器自动化（自带 Chromium） |
| `puppeteer-screen-recorder` | 屏幕录制核心库 |
| `ffmpeg-static` | FFmpeg 二进制（视频编码，随包安装无需系统配置） |

## 快速开始

```bash
# 录制本地 HTML 文件（最常用，参数全部自动匹配系统）
node index.js --url ./demo.html

# 录制在线网页
node index.js --url https://example.com

# 查看帮助
node index.js --help
```

输出视频默认保存在 `./videos/<名称>-<时间戳>.mp4`。

不想记命令行参数？直接启动图形界面：

```bash
# 方式一：直接运行（推荐）
node gui/server.js

# 方式二：通过 npm script
npm run gui
```

启动后浏览器会自动打开图形界面（端口冲突时自动 +1 重试）。详见 [图形界面（GUI）](#图形界面gui)。

## 命令行参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--url <url>` | 网页地址或本地 HTML 文件路径（**必需**） | - |
| `--output <path>` | 输出视频路径 | `./videos/<名称>-<时间戳>.mp4` |
| `--duration <秒>` | 录制时长（指定 `--audio` 时为最大兜底，音频结束自动停止） | 10 |

| `--width <px>` | 输出视频宽度（物理像素） | 主屏幕物理分辨率 |
| `--height <px>` | 输出视频高度（物理像素） | 主屏幕物理分辨率 |
| `--scale <百分比>` | 页面缩放级别（等同 OS 显示缩放） | OS DPI 缩放值 |
| `--fps <帧率>` | 视频帧率 | 60 |
| `--quality <0-100>` | 单帧截图质量（4K 建议 ≤ 90） | 90 |
| `--crf <值>` | 编码质量（0 = 数学级无损，18 = 视觉无损） | 18 |
| `--bitrate <kbps>` | 视频比特率 | 100000 |
| `--preset <预设>` | 编码速度/体积权衡（`ultrafast`->`veryslow`） | `medium` |
| `--codec <编码器>` | 视频编解码器（`h264`/`h265`/`vp9`/`lossless`） | `h264` |
| `--pixel-format <fmt>` | 像素格式（`yuv420p`/`yuv444p`），流媒体发布建议 `yuv420p` | `yuv444p` |
| `--show-browser` | 显示浏览器窗口（调试用） | 后台无头运行 |
| `--click` | 录制开始后点击页面右下角，触发音频播放 | 关闭 |
| `--audio` | 捕获页面音频（MediaRecorder 拦截，原始音质，自动合并到视频）；音频结束后自动停止录制 | 关闭 |
| `--cover <path>` | 封面图片路径，视频开头展示 1 秒静态封面后转入录制内容 | 无（可选） |
| `--ffmpeg-path <path>` | 显式指定 ffmpeg 路径 | 自动检测 |
| `--help` | 显示帮助 | - |

## 编解码器选择 (--codec)

| 编解码器 | FFmpeg 编码器 | 像素格式 | 输出格式 | 说明 |
|---------|--------------|---------|---------|------|
| `h264` | `libx264` | `yuv444p` | `.mp4` | H.264/AVC，兼容性最好（默认） |
| `h265` | `libx265` | `yuv444p` | `.mp4` | H.265/HEVC，同等画质体积更小 |
| `vp9` | `libvpx-vp9` | `yuv444p` | `.webm` | VP9，Google 开源编码 |
| `lossless` | `libx264rgb` | `rgb24` | `.mp4` | RGB 数学级无损（`-qp 0`） |

**注意**：`--crf 0` 也会自动启用 `lossless` 模式（向后兼容）。即以下两条命令等价：

```bash
node index.js --url ./demo.html --crf 0
node index.js --url ./demo.html --codec lossless
```

输出文件扩展名会根据编解码器自动修正（如 `--codec vp9` 时 `.mp4` 会改为 `.webm`）。

## 使用示例

```bash
# 基础：录制 10 秒，全自动参数
node index.js --url ./demo.html

# 指定时长和输出路径
node index.js --url ./demo.html --duration 30 --output ./videos/demo.mp4

# 数学级无损（与原网页逐像素一致，文件较大）
node index.js --url ./demo.html --duration 60 --crf 0

# 显式指定无损模式
node index.js --url ./demo.html --codec lossless --output ./videos/demo.mp4

# 使用 H.265 编码（更小体积，相同画质）
node index.js --url ./demo.html --codec h265 --output ./videos/demo.mp4

# 使用 VP9 编码（输出 WebM）
node index.js --url ./demo.html --codec vp9 --output ./videos/demo.webm

# 指定分辨率（如只录 1080p）
node index.js --url ./demo.html --width 1920 --height 1080 --scale 100

# 显示浏览器窗口，观察录制过程
node index.js --url ./demo.html --show-browser

# 更小编码体积（编码更慢，画质不变）
node index.js --url ./demo.html --preset slow

# 录制带音频的网页（点击触发播放 + 捕获音频，音频结束自动停止）
node index.js --url "http://localhost:8080/03-glass.html?path=01&name=%E6%AE%8B%E7%BE%BD%E8%B0%A3%20-%20%E9%BB%84%E8%AF%97%E6%89%B6" --duration 300 --click --audio --codec h264 --pixel-format yuv420p --crf 18 --preset slow --fps 60

# 带封面图的音频录制（封面 1 秒 → 录制内容）
node index.js --url ./demo.html --cover ./cover.jpg --click --audio --duration 120
```

## 音频录制说明

使用 `--audio` 时，工具会通过页面注入的 MediaRecorder 拦截所有音频源（`<audio>`/`<video>` 元素及 Web Audio API），以 Opus 编码原始音质录制，录制完成后自动合并到视频（AAC 320kbps）。

### 音频捕获原理

| 音频源 | 检测方式 | 说明 |
|--------|---------|------|
| `<audio>` / `<video>` 元素 | 拦截 `HTMLMediaElement.play()` | 通过 `createMediaElementSource` 接入捕获 AudioContext，同时保持原始扬声器输出 |
| Web Audio API | 拦截 `AudioNode.prototype.connect` | 当页面节点连接到 `ctx.destination` 时，同时 tee 到录制节点 |

> 两种方式均不影响页面原有音频播放行为，且捕获的是原始音质（非麦克风回采）。

### 自动停止策略

指定 `--audio` 后，`--duration` 变为**最大兜底时长**，录制会在以下任一条件满足时停止：

| 条件 | 说明 |
|------|------|
| 音频播完 | 页面 `<audio>` 元素全部播放结束（`ended` 属性或 `currentTime` 到达 `duration`），背景视频不阻塞 |
| 达到 `--duration` | 兜底超时，防止异常情况 |

音频播完即停止，不额外追加时长；同时以音频实际时长 + `--duration` 的较小值作为录制目标。

> **建议**：将 `--duration` 设为略大于音频实际时长的值（如音频 3 分钟，设 `--duration 200`），既能自动停止，又有兜底保护。

## 封面图说明

使用 `--cover <图片路径>` 可在视频开头添加 1 秒静态封面，适用于视频平台缩略图展示。

### 合并流程

```
封面图片 → scale + pad 居中填充（匹配视频分辨率）→ 1 秒静态画面
                                                          ↓
录制视频 → 整体延迟 1 秒（setpts=PTS+1/TB）
录制音频 → 整体延迟 1 秒（adelay=1000ms）
                                                          ↓
                    第 1 秒        第 2 秒起
                    封面画面    录制内容（音视频同步）
```

### 示例

```bash
# 带封面的音频录制
node index.js --url ./demo.html --cover ./cover.jpg --click --audio --duration 120

# 无音频的封面视频
node index.js --url ./demo.html --cover ./cover.jpg --duration 15
```

## 性能优化

工具针对 4K 高分辨率录制做了以下优化：

| 优化项 | 说明 |
|--------|------|
| **GPU 加速** | 使用新版无头模式（`headless: 'new'`）+ GPU 栅格化，4K 页面渲染帧率显著提升 |
| **JPEG 截图** | CDP 截图使用 JPEG 格式（默认 quality 90），帧体积比 PNG 减小 ~60%，降低传输瓶颈 |
| **两阶段编码** | 有音频时：录制阶段用 `ultrafast` 预设（保证不丢帧），合并阶段用用户指定预设（保证压缩质量） |
| **帧率覆盖** | 追加 `-r {fps}` 覆盖库内硬编码的 `-framerate 1`，确保输出帧率正确 |

## 4K 流媒体发布推荐配置

针对 YouTube / Bilibili / 抖音等流媒体平台发布 4K 视频，推荐以下参数：

```bash
node index.js --url "http://localhost:8080/01-vinyl.html?path=01&name=xxx" \
  --duration 300 \
  --click --audio \
  --codec h264 \
  --pixel-format yuv420p \
  --crf 20 \
  --preset slow \
  --fps 60
```

> `--duration 300` 为最大兜底时长，音频播放结束后会自动停止（实际录制时长 = 音频时长）。

### 参数选择说明

| 参数 | 推荐值 | 说明 |
|------|--------|------|
| `--codec` | `h264` | 兼容性最好，所有流媒体平台均支持 H.264/AVC |
| `--pixel-format` | `yuv420p` | 流媒体平台标准格式；默认的 `yuv444p` 画质更高但部分平台不兼容 |
| `--crf` | `20` | 4K 下视觉无损与体积的平衡点（CRF 18 文件偏大，CRF 23 画质有损） |
| `--preset` | `slow` | 编码更慢但压缩率更高，上传体积更小（离线发布无需实时编码） |
| `--fps` | `60` | 60fps 动效流畅，平台普遍支持 4K60 |
| `--quality` | `90` | 单帧截图质量（默认值）；4K 下 `100` 帧体积过大导致 CDP 传输瓶颈 |
| `--audio` | 启用 | 捕获页面原始音频（Opus -> AAC 320kbps） |
| `--click` | 启用 | 录制开始后点击页面触发音频播放 |
| `--duration` | 略大于音频时长 | 最大兜底时长，音频结束自动停止（如音频 3 分钟设 `300`） |

> **关于像素格式**：默认 `yuv444p` 保留了完整的色度信息（适合本地存档/后期编辑）；
> `yuv420p` 进行色度下采样（人眼不可见的精度损失），但兼容性最广。
> 流媒体平台转码时会统一转为 `yuv420p`，提前指定可避免平台转码引入的额外损失。

> **关于分辨率**：工具会自动检测屏幕物理分辨率和 DPI 缩放。
> 4K 屏幕（3840x2160）下无需手动指定 `--width`/`--height`/`--scale`，自动输出 4K 视频。

## 画质说明

### 画质链路

```
浏览器渲染（物理分辨率）
  -> PNG 无损截图（screencast）
  -> FFmpeg 编码（libx264 / libx264rgb / libx265 / libvpx-vp9）
  -> MP4 / WebM 输出
```

每个环节均无降质：截图是 PNG 无损格式、按物理像素分辨率捕获（无放大）、色度不抽样（yuv444p 或 RGB）。

### CRF 取值建议

| CRF | 效果 | 适用场景 |
|-----|------|---------|
| 0 | 数学级无损（RGB 编码），与原网页逐像素一致 | 存档、二次编辑、追求极致清晰 |
| 18 | 视觉无损（默认），人眼无法分辨差异 | 日常分享、演示 |
| 23~28 | 良好画质，文件明显变小 | 对体积敏感的场景 |

注意：`--crf 0` 输出的 MP4 使用 RGB 色彩空间（`libx264rgb`），VLC、mpv、Chrome、Edge 均可播放；Windows 自带"媒体播放器"可能不兼容，遇到时换播放器即可。

### 缩放 (--scale) 的工作原理

模拟操作系统的显示缩放（如 4K 屏 175% 缩放）：

- CSS 视口 = `输出尺寸 / 缩放比例`（如 3840/1.75 = 2194），页面布局与您屏幕所见一致
- 通过 `--force-device-scale-factor` 让浏览器按物理像素渲染
- 最终捕获 = `CSS视口 x 缩放比例` = 完整物理分辨率，无放大无模糊

默认值自动读取您的系统设置（Windows/macOS/Linux 均已支持），通常**无需手动指定**。

## 本地 HTML 文件的工作原理

当 `--url` 是本地路径时，工具会：

1. 在该文件所在目录启动一个临时 HTTP 服务器（`127.0.0.1`，端口自动分配）
2. 通过 HTTP 协议加载页面（而非 `file://`）
3. 录制结束后自动关闭服务器

好处：`fetch`/AJAX 请求、相对路径的 JS/CSS/图片/字体/WASM 全部正常工作，无跨域限制，无需任何特殊浏览器参数。服务器内置路径穿越防护。

## 编程 API

可将录制能力集成到自己的脚本中：

```js
const { recordWebPage } = require('./recorder');

await recordWebPage({
  url: 'https://example.com',        // 或本地路径需自行起服务器
  outputPath: './videos/demo.mp4',
  duration: 10,                      // 录制秒数
  width: 3840,
  height: 2160,
  scale: 175,                        // 缩放百分比
  fps: 60,
  videoCrf: 18,                      // 0 = 无损
  videoBitrate: 100000,
  videoPreset: 'medium',
  codec: 'h264',                     // h264 / h265 / vp9 / lossless
  headless: true,
  captureAudio: true,                // 启用音频捕获
  coverPath: './cover.jpg',          // 可选：封面图片路径

  // 录制前钩子：登录、滚动、点击等
  beforeRecord: async (page) => {
    await page.type('#username', 'admin');
    await page.click('#login');
  },

  // 录制中钩子：录制开始后执行（如缓慢滚动展示内容）
  afterRecord: async (page) => {
    await page.evaluate(() => window.scrollTo(0, document.body.scrollHeight));
  },
});
```

## 常见问题

**Q: 输出视频不如原网页清晰？**
A: 确认使用最新代码。早期版本在低分辨率捕获后放大会导致模糊，现已修复为物理分辨率直接捕获。若仍不满意，用 `--crf 0` 或 `--codec lossless` 获得逐像素无损输出，并用 VLC/mpv 等播放器查看（避免播放器缩放干扰判断）。

**Q: 录制 4K 视频文件很大？**
A: 高画质必然带来大体积。用默认 `--crf 18`（视觉无损）可大幅缩小体积；或加 `--preset slow` 在同等画质下进一步压缩；也可用 `--codec h265` 在同等画质下获得更小文件。

**Q: 本地 HTML 中的数据请求（fetch）失败？**
A: 本地文件会自动通过临时 HTTP 服务器加载，此问题不应出现。请确认资源使用的是相对路径，且文件确实存在于 HTML 同目录或子目录中。

**Q: 无头模式下屏幕左上角出现小窗口？**
A: 已通过 `--disable-gpu` 等参数修复。如仍出现请反馈。

**Q: 支持哪些输出格式？**
A: 由 `--codec` 参数决定。`h264`/`h265`/`lossless` 输出 `.mp4`，`vp9` 输出 `.webm`。文件扩展名会自动匹配编解码器。

**Q: `--codec lossless` 和 `--crf 0` 有什么区别？**
A: 完全等价。`--crf 0` 是 `--codec h264` 时自动升级为 RGB 无损模式的快捷方式，`--codec lossless` 是显式指定。两者都使用 `libx264rgb` + `rgb24` + `-qp 0` 实现数学级无损。

## 图形界面（GUI）

内置一个轻量 Web 管理界面，可视化完成录制与便携版打包，无需记忆命令行参数。

### 启动方式

```bash
# 直接运行
node gui/server.js

# 或通过 npm script
npm run gui
```

启动后浏览器自动打开界面（默认端口 `3456`，端口被占用时自动 +1 重试）。界面地址如 `http://localhost:3456`。

### 界面功能

| 功能 | 说明 |
|------|------|
| **录制页面** | 填写 URL、时长、分辨率、编码等参数，一键开始录制；实时显示命令输出日志，可随时停止 |
| **打包便携版** | 选择平台、Node.js 版本、镜像/代理等选项，一键执行便携版打包 |
| **已生成视频** | 列出 `videos/` 下所有输出，支持查看、删除，以及 **📌 定位**（在资源管理器中选中该文件） |
| **参数上传** | 可直接上传本地 HTML 文件作为录制源，自动放入临时目录 |

### 临时目录自动清理

- 每次**开始录制任务前**自动清理 `temp/` 中残留的 `player-*` 临时目录
- **GUI 服务启动时**同样会清理一次，避免磁盘占用累积
- 无需手动点击清理按钮

### 定位文件

录制完成后，在「已生成视频」列表中点击 **📌 定位** 按钮：

- **Windows**：打开资源管理器并选中该视频文件（`explorer /select,<path>`）
- **macOS**：在 Finder 中显示（`open -R`）
- **Linux**：打开视频所在目录（`xdg-open`）

## 打包便携版

`build-portable.js` 可将工具打包为跨平台绿色便携版（Windows / macOS / Linux），目标机器无需安装 Node.js。

### 打包命令

```bash
# 共 6 个源，镜像加速站优先，GitHub 直连放最后兜底
npm run build
```

打包选项：

```bash
# 指定 Node.js 版本（默认使用当前系统版本）
npm run build -- --node-version v20.11.0

# 指定目标平台（默认自动检测当前系统）
# 可选值: win32, darwin, linux
npm run build -- --platform linux

# 指定下载代理（用于 Node.js / Chromium 下载和 npm install）
npm run build -- --proxy http://127.0.0.1:7890

# 使用国内镜像源（自动配置 npm registry / Chromium / ffmpeg / Node.js 下载）
npm run build -- --mirror

# 仅指定 npm registry（不影响二进制下载地址）
npm run build -- --registry https://mirrors.cloud.tencent.com/npm/

# 强制完整重建（清空缓存，等价于删除 dist 后重建）
npm run build -- --force

# 增量构建（默认行为，仅更新修改的部分）
npm run build -- --incremental
npm run build -- --registry https://registry.npmmirror.com

# 使用腾讯镜像源
npm run build -- --mirror --registry https://mirrors.cloud.tencent.com/npm/
```

> **代理说明**：`--proxy` 用于在网络受限环境下加速或完成 Node.js 运行时和 Chromium 的下载。也可通过环境变量 `HTTP_PROXY` / `HTTPS_PROXY` 设置，`--proxy` 参数优先级更高。
>
> **镜像源说明**：`--mirror` 使用 [npmmirror](https://npmmirror.com) 国内镜像，自动加速 npm 包安装、Chromium / ffmpeg / Node.js 二进制下载。无需代理即可在国内网络环境完成打包。`ffmpeg-static` 的 postinstall 从 GitHub 下载二进制容易超时，`--mirror` 会跳过该步骤并从镜像源手动下载。
>
> **增量构建说明**：默认情况下，二次构建会自动检测文件变化，仅更新有修改的部分：
> - 对比应用文件（`index.js`、`recorder.js`、`package.json`、`README.md`）及 `gui/`、`plugins/` 目录的内容哈希，仅拷贝变化的文件/目录
> - 检测 `package.json` 依赖变化，仅在新增/删除/升级依赖时重新执行 `npm install`
> - 跳过已完成的 `node_modules` 清理
> - 跳过未变化的启动脚本生成
>
> 使用 `--force` 可强制完整重建（忽略所有缓存，同时重新拷贝 `gui/`、`plugins/`）。增量状态保存在 `dist/html2video/.buildcache.json`。

### 打包流程

1. 清理并创建 `dist/html2video/` 输出目录
2. 拷贝应用文件（`index.js`、`recorder.js`、`package.json`、`README.md`）+ GUI（`gui/`）+ 插件资源（`plugins/`）
3. 在输出目录中 `npm install` 安装生产依赖（puppeteer + ffmpeg-static + Chromium，约 300MB）
4. 验证 FFmpeg 和 Chromium 二进制是否就绪
5. 清理 `node_modules` 中不必要的文件（文档、测试、类型定义等），减小体积
6. 下载对应版本的 `node.exe`（Windows x64）
7. 生成启动脚本（`html2video.ps1` / `html2video.sh`，支持 `--gui` 参数）+ 双击启动脚本（`启动GUI.bat` / `启动GUI.sh`）
8. 生成 `使用说明.txt`

### 产物结构

```
dist/
└── html2video/          # 便携版目录（可直接拷贝分发）
    ├── node.exe         # Node.js 运行时
    ├── html2video.ps1   # Windows 启动脚本（PowerShell）
    ├── 启动GUI.bat      # Windows 双击启动图形界面
    ├── index.js         # 应用入口
    ├── recorder.js      # 录制模块
    ├── package.json
    ├── README.md
    ├── gui/             # Web 图形界面（server.js + index.html）
    ├── plugins/         # 插件资源（音乐播放器等）
    ├── temp/            # 临时目录（录制前自动清理）
    ├── videos/          # 输出视频（自动创建）
    ├── node_modules/    # 依赖（已精简）
    └── browser/         # Chromium 浏览器缓存
```

### 使用便携版

```powershell
# Windows PowerShell 直接运行（命令行方式）
.\html2video.ps1 --url ./demo.html
.\html2video.ps1 --help

# 启动图形界面
.\html2video.ps1 --gui
# 或直接双击 启动GUI.bat

# 如遇权限问题，请先运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

```bash
# macOS / Linux（命令行方式）
./html2video.sh --url ./demo.html

# 启动图形界面
./html2video.sh --gui
# 或直接运行 ./启动GUI.sh
```

> 便携版完全自包含：内置 Node.js 运行时、Chromium 浏览器、FFmpeg 二进制及图形界面，目标机器无需任何额外安装。

## 项目结构

```
html2video/
├── index.js            # 命令行入口：参数解析、屏幕检测、临时服务器
├── recorder.js         # 核心录制模块：浏览器控制、录制配置、多编解码器
├── build-portable.js   # 便携版打包脚本
├── package.json
├── gui/                # Web 图形界面（server.js 服务端 + index.html 页面）
│   ├── server.js       #   本地 HTTP 服务：启动录制/打包、SSE 日志、视频管理
│   └── index.html      #   图形界面前端页面
├── plugins/            # 插件资源（音乐播放器等，供 GUI 录制使用）
├── temp/               # 临时目录（GUI 上传文件与录制中间产物，录制前自动清理）
├── dist/               # 打包产物目录（构建后生成）
└── videos/             # 默认输出目录（自动创建）
```