开始前适用开发板：ESP32 系列 · 开发框架：ESP-IDF
用途：本仓库全部 Markdown 的 唯一总索引；按章节顺序录制即可得到完整视频课。
维护：新增/改文档时同步更新本页集号与链接。
例程资料：淘宝酷世DIY 购板 → 联系客服 → 百度网盘（见 README）。
一、文档四层体系
第 0 层 · 总控（你现在看的）
└── 文档总目录与视频教程大纲.md
第 1 层 · 入门与框架（所有观众先看）
└── 通用-搭建编译环境 / 框架构成 / 工程结构 / 例程开发流程 …
第 2 层 · API 概念（配合例程穿插讲）
└── 通用-gpio / wifi / audio / lvgl …（旧版笔记标「附录」）
第 3 层 · 板级路线（二选一，不要混烧）
├── Korvo：开发板介绍 → 学习指南 → Korvo例程详解-*
└── P4C5：开发板介绍 → 学习指南 → P4C5例程详解-*
第 4 层 · 专题与查表
└── 对照表 / 05.test / GMF / SP V4 / 在线组件
| 前缀 | 数量级 | 视频用法 |
|---|---|---|
通用- | ~35 篇 | 概念课 + 屏幕录 IDE/API |
Korvo例程详解- | 35 篇 | 实操课，必须 Korvo 板 |
P4C5例程详解- | 34 篇 | 实操课，必须 P4C5 板 |
| 板介绍/学习指南 | 各 2～3 篇 | 系列开篇 / 路线图 |
二、视频系列总览（建议片单）
| 系列 | 观众 | 集数建议 | 硬件 |
|---|---|---|---|
| A · 零基础入门 | 所有人 | 6 集 | 任意一块板（后期实操分板） |
| B · 外设与存储 | 所有人 | 9 集 | 例程包 01.basic.* |
| C · 网络与物联网 | 所有人 | 5 集 | Wi-Fi 例程 |
| D · 多媒体与 UI | 所有人 | 8 集 | 按板选例程 |
| K · Korvo 实战 | Korvo 用户 | 36 集 | Korvo S3 |
| P · P4C5 实战 | P4C5 用户 | 35 集 | P4C5 |
| 附录 · 旧版长文 | 选讲 | 按需 | — |
三、系列 A · 零基础入门（必拍）
| 集号 | 建议标题 | 文档 | 录制要点 | 例程/现象 |
|---|---|---|---|---|
| A01 | Windows 安装 ESP-IDF 5.5 | 通用-搭建编译环境 | 安装器选项、P4 勾选 target、idf 导入 | 终端 idf.py --version |
| A02 | ESP-IDF 是什么、装在哪 | 通用-ESP-IDF框架构成 | IDF_PATH、components、分层图 | 打开 $IDF_PATH/components 目录 |
| A03 | 工程文件夹每个文件（对比 Keil） | 通用-ESP-IDF工程结构 | CMakeLists、sdkconfig、app_main | 打开 01.basic.hello_world |
| A04 | 例程从哪来、怎么编译烧录 | 例程开发流程与公共组件 | 百度网盘流程、set-target、flash monitor | hello_world 或 board_test |
| A05 | menuconfig 与 Kconfig | 通用-menuconfig + 通用-kconfig | 改 SSID、保存 sdkconfig | 任意联网例程 |
| A06 | 分区表与自定义组件 | 通用-partition + 通用-创建组件 | partitions.csv、components/ | OTA 或 SPIFFS 例程 |
系列 A 串词建议：「文档公开、例程淘宝客服百度网盘发；路径不要中文。」
四、系列 B · 外设与存储（API + basic 例程）
| 集号 | 文档 | 配合例程目录（Korvo / P4 均有类似名） |
|---|---|---|
| B01 | 通用-gpio | 01.basic.gpio / blink |
| B02 | 通用-button | 01.basic.button |
| B03 | 通用-uart | 01.basic.uart_echo |
| B04 | 通用-i2c | 01.basic.i2c |
| B05 | 通用-spi | SPI 相关 basic |
| B06 | 通用-adc | 01.basic.adc_* |
| B07 | 通用-nvs | 01.basic.nvs |
| B08 | 通用-spiffs | 01.basic.spiffs |
| B09 | 通用-tfcard | fatfs / SD 例程 |
每集结构建议：5 min 概念（通用-doc）→ 10 min 打开例程改参数 → 5 min FAQ。
五、系列 C · 网络与物联网
| 集号 | 文档 | Korvo 例程详解 | P4C5 例程详解 |
|---|---|---|---|
| C01 | 通用-wifi | wifi_station | wifi_station |
| C02 | 通用-配网 | blufi | （P4 小智内触摸配网，见 xiaozhi） |
| C03 | 通用-http | http_server | http_server |
| C04 | 通用-mqtt | mqtt_tcp | mqtt_tcp |
| C05 | OTA 专题 | ota HTTPS | ota HTTP+HFS |
C01 P4 必提：C5 协处理器等待 10～20 s。
六、系列 D · 多媒体与 UI（概念 + 分板实操）
| 集号 | 通用/API 文档 | Korvo 实操 | P4C5 实操 |
|---|---|---|---|
| D01 | 通用-lvgl-v9 | spi_lcd_touch | mipi_lcd_touch |
| D02 | lvgl adapter | lvgl_esp_adapter | lvgl_esp_adapter |
| D03 | 通用-audio + 录音播放 | mp3_player | mp3_player |
| D04 | 通用-camera | camera_lvgl | camera_lvgl |
| D05 | 网页图传 | camera_webserver | — |
| D06 | 二维码 | qrcode | qrcode |
| D07 | 视觉 AI | face_recognition | face_recognition |
| D08 | 通用-usb | usb_hid | usb_hid |
附录（旧项目笔记，视频可缩略）：avi播放、摄像头LVGL显示、lvgl-mp3播放、jpg下载显示、综合硬件测试 — 优先讲 例程详解 新版。
D 系列 AVI：Korvo avi_player · P4 avi_player。
七、系列 K · Korvo 实战（按学习指南顺序）
| 集号 | 文档 | 工程 | 验板/现象 |
|---|---|---|---|
| K00 | Korvo开发板介绍 | — | 硬件 tour |
| K01 | Korvo例程学习指南 §1 | korvo_board_test | 整板测试 UI |
| K02 | korvo_board_test | 同上 | 逐项点测 |
| K03～K17 | 见 热门例程详解 · Korvo 表 | 各 Korvo例程详解-* | 每集一个工程 |
Korvo 完整路线细节：Korvo例程学习指南 内「阶段 0～10 / 30 天计划」。
八、系列 P · P4C5 实战
| 集号 | 文档 | 工程 | 备注 |
|---|---|---|---|
| P00 | ESP32P4-C5开发板介绍 | — | 双芯架构 |
| P01 | P4C5例程学习指南 §1 | p4c5_board_test | NODE P4 UI |
| P02 | p4c5_board_test | 同上 | 8 磁贴 |
| P03～P17 | 热门例程详解 · P4 表 | 各 P4C5例程详解-* | 含 xiaozhi、esp-album |
| P专题1 | P4C5专项测试 | 05.test.* | 可选系列 |
| P专题2 | P4C5-GMF | 06.gmf_* | 进阶 |
| P组件 | P4C5在线组件使用说明 | 自建工程 | 组件库引用 |
九、其他硬件
| 文档 | 视频建议 |
|---|---|
| ESP32S3-SP-V4开发板介绍 | 独立短系列，对接小智 upstream |
| Korvo与P4C5例程对照表 | 一集 FAQ：「两块板能否互烧」 |
十、单集录制模板（复制到提词器 / 分镜）
## [系列][集号] 标题
**文档**：docs/xxx.md
**前置集**：A03
**硬件**：Korvo / P4C5
**工程路径**：Korvo_Firmware/02.beginner.xxx
**target**：esp32s3 / esp32p4
### 开场（30s）
- 本集目标一句话
- 提醒：例程淘宝客服百度网盘
### 演示（8～15min）
1. menuconfig 要改什么
2. 编译烧录命令
3. 屏幕/串口现象
4. 改一处代码看效果
### 收尾（1min）
- 常见问题 1～2 条
- 下集预告 + 文档链接
十一、全部文档文件清单（按文件夹排序）
11.1 总控与流程
| 文件 | 视频角色 |
|---|---|
| 文档总目录与视频教程大纲 | 制片索引 |
| README | 观众入口 |
| 例程开发流程与公共组件 | A04 |
| 热门例程详解 | 例程跳转表 |
11.2 通用-入门与构建
| 文件 |
|---|
| 通用-搭建编译环境 |
| 通用-ESP-IDF框架构成 |
| 通用-ESP-IDF工程结构 |
| 通用-kconfig |
| 通用-menuconfig |
| 通用-partition |
| 通用-创建组件 |
11.3 通用-外设
通用-gpio · 通用-adc · 通用-uart · 通用-i2c · 通用-spi · 通用-button · 通用-tca9554
11.4 通用-存储
通用-nvs · 通用-spiffs · 通用-tfcard
11.5 通用-网络
通用-wifi · 通用-配网 · 通用-http · 通用-mqtt
11.6 通用-多媒体（长文 + 附录）
| 主推荐 | 附录/旧笔记 |
|---|---|
| 例程详解为主 | 通用-audio 通用-录音播放 通用-camera 通用-cst816 通用-lvgl-v9 |
通用-avi播放 通用-网页图传 通用-摄像头LVGL显示 通用-lvgl-mp3播放 通用-jpg下载显示 通用-二维码识别 通用-综合硬件测试 |
11.7 通用-其他
11.8 Korvo 板级（35 篇例程详解 + 2 篇指南）
Korvo开发板介绍 · Korvo例程学习指南 · Korvo例程详解-*
11.9 P4C5 板级
ESP32P4-C5开发板介绍 · P4C5例程学习指南 · P4C5在线组件使用说明 · P4C5例程详解-* · P4C5专项测试例程 · P4C5-GMF多媒体例程
十二、后期制作建议
| 项目 | 建议 |
|---|---|
| 分辨率 | 1080p 录屏 + 板子特写画中画 |
| 章节 | B 站/YouTube 按系列 A/B/C/D/K/P 分播放列表 |
| 简介 | 固定粘贴：淘宝链接 + 本文档链接 + 所需集号前置 |
| 代码 | 屏幕放大 125%；终端用高对比主题 |
| 时长 | 入门 10～20 min/集；例程实操 15～30 min/集 |
| 更新 | 例程版本升级时重录 menuconfig 差异即可 |
十三、文档与视频一致性检查清单
- 文档无私有 Git 链接，例程获取统一为淘宝 + 百度网盘
- Korvo / P4 例程 分篇，无混烧表述
- 每篇
*例程详解-*含：工程路径、target、menuconfig、现象、FAQ - 新增例程：补
Korvo/P4C5例程详解-xxx.md+ 本页集号 + 热门例程详解 -
通用-*文首有「文档类型」说明块
十四、推荐观看/学习顺序（给观众的一页纸）
1. A01～A04（环境 + 框架 + 工程 + 烧录）
2. 选板：K00～K02 或 P00～P02（介绍 + 验板）
3. B 系列按需跳看 API
4. C 系列联网（wifi → http → mqtt → ota）
5. D 系列多媒体
6. K 或 P 系列例程详解逐个实战
7. 查表：Korvo与P4C5例程对照表
酷世DIY · Kevincoooool