Spaces:
Running
Running
Step 1: 劝学视频项目计划写入 README
Browse files
README.md
CHANGED
|
@@ -1,13 +1,105 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
colorTo: red
|
| 6 |
sdk: static
|
| 7 |
-
app_file: index.html
|
| 8 |
pinned: false
|
| 9 |
---
|
| 10 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 11 |
# 腱鞘炎 · 3D 人体解剖科普动画(网页实时渲染版)
|
| 12 |
|
| 13 |
> 类型:医学科普 + 3D 人体解剖动画 | 时长:约 80–90 秒 | 画幅:9:16 竖屏 | 风格:真实医学 3D、清晰、干净、专业、易懂
|
|
|
|
| 1 |
---
|
| 2 |
+
title: 劝学 · 荀子 — 课文精讲视频
|
| 3 |
+
emoji: 📜
|
| 4 |
+
colorFrom: gray
|
| 5 |
colorTo: red
|
| 6 |
sdk: static
|
| 7 |
+
app_file: quanxue/index.html
|
| 8 |
pinned: false
|
| 9 |
---
|
| 10 |
|
| 11 |
+
# 《劝学》· 荀子 —— 网页实时渲染课文精讲视频
|
| 12 |
+
|
| 13 |
+
> 在线观看:本 Space 首页(`quanxue/index.html`)
|
| 14 |
+
> 本项目为**全新制作**:未参考本仓库已有代码,也未删除任何已有文件;仓库中原有项目保持原样(原入口仍为根目录 `index.html`),新项目全部以**新增目录**的方式加入:
|
| 15 |
+
> - `quanxue/` —— 构建后的网页(可直接访问)
|
| 16 |
+
> - `quanxue-src/` —— 全部源代码(React + TypeScript + Canvas + Web Audio + WebCodecs)
|
| 17 |
+
|
| 18 |
+
---
|
| 19 |
+
|
| 20 |
+
## 一、项目目标
|
| 21 |
+
|
| 22 |
+
| # | 需求 | 实现方式 |
|
| 23 |
+
|---|------|---------|
|
| 24 |
+
| 1 | 荀子《劝学》课文讲解视频,内容有深度 | 原创解说文案:从荀子其人、"性恶论"与"化性起伪"切入,逐段精讲原文的三层论证(学不可以已 → 善假于物 → 积·恒·专),落到"学至乎没而后止" |
|
| 25 |
+
| 2 | 画面有高级感 | 全程序化 Canvas 2D 绘制:水墨山水、宣纸肌理、胶片颗粒、竖排书法、朱砂印章、金线、墨晕转场、电影级字幕与缓慢运镜 |
|
| 26 |
+
| 3 | 音效 + 音乐 + 旁白 | 旁白:神经网络 TTS 预生成中文男声(引文放慢语速、更有吟诵感);音乐:Web Audio 实时合成"古琴(Karplus-Strong 拨弦)+ 箫 + 低音铺底 + 混响",旁白处自动闪避(Ducking);音效:墨滴、笔刷、印章、磬声、风、水滴、刻凿等全部程序化合成 |
|
| 27 |
+
| 4 | 网页上直接看视频,不预先制作 mp4 | 自研时间轴播放器:画面按时间确定性渲染,与音频时钟同步,可播放/暂停/拖动/章节跳转/全屏 |
|
| 28 |
+
| 5 | 浏览器本地导出 MP4 | WebCodecs(H.264 + AAC/Opus)逐帧离线渲染 + Mediabunny 封装 MP4,全程在本地浏览器完成,不上传任何数据 |
|
| 29 |
+
| 6 | 手机竖屏适配 | 每个场景都有横屏 16:9 / 竖屏 9:16 两套构图;手机竖握时自动切换竖屏版 |
|
| 30 |
+
| 7 | 导出选项 | 分辨率 2K / 1080P / 720P;帧率 24 / 30 / 60;画幅 横屏 / 竖屏;背景音乐 导出 / 不导出 |
|
| 31 |
+
| 8 | 发布文案 | 小红书(标题≤20字,≤10话题)、抖音(≤30字,≤5话题)、微信视频号(≤16字,话题不限)、哔哩哔哩(≤80字,≤10话题),一键复制,实时字数校验 |
|
| 32 |
+
| 9 | 封面 | 多套原创封面设计 × 4:3 / 3:4 / 16:9 可多选,批量生成、单张或全部下载 PNG |
|
| 33 |
+
|
| 34 |
+
---
|
| 35 |
+
|
| 36 |
+
## 二、视频大纲(约 6 分钟)
|
| 37 |
+
|
| 38 |
+
| 章 | 标题 | 内容要点 | 画面设计 |
|
| 39 |
+
|----|------|---------|---------|
|
| 40 |
+
| 序 | 片头 | 劝学 · 荀子 | 墨滴入水晕开、书法标题笔势显现、朱砂印"荀子"落印 |
|
| 41 |
+
| 一 | 其人其书 | 战国末年;荀况,赵人;年五十游学于齐,三为稷下祭酒;韩非、李斯之师;《荀子》三十二篇,《劝学》居首——一种思想宣言 | 水墨远山视差、年代题签、竹简三十二枚依次排开,第一枚亮起 |
|
| 42 |
+
| 二 | 思想底色 | "人之性恶,其善者伪也";"伪"即"人为";孟荀之别:向内寻回 vs 向外筑起;"化性起伪"——《劝学》是这条路的总纲 | "伪"字拆解为"人"+"为";孟荀对照图(种子向内 / 砖石向外垒筑) |
|
| 43 |
+
| 三 | 学不可以已 | 青于蓝、寒于水:后天胜先天;輮以为轮:改变是根本且不可逆的;木受绳、金就砺、博学参省:外在规范 + 向内反省,知行合一 | 靛青晕染、冰晶生长、直木弯成车轮、墨线弹直、砺石火花、内外双环示意 |
|
| 44 |
+
| 四 | 善假于物 | 终日而思不如须臾之所学;登高、顺风、舆马、舟楫四喻;"君子生非异也,善假于物也";最伟大的"物"是前人的知识 | 踮脚 vs 登高视野扩展、声波随风、道路延向地平线、孤舟横渡、书卷叠成台阶 |
|
| 45 |
+
| 五 | 积 · 恒 · 专 | 积土成山、积水成渊、积善成德:量变到质变;跬步千里;骐骥与驽马;锲而不舍;蚓与蟹:用心一 vs 用心躁 | 粒子堆叠成山兴云雨、水滴汇渊龙影游动、足迹连成千里、刻刀反复凿石、蚯蚓与螃蟹线描对照、三枚印章 |
|
| 46 |
+
| 结 | 学至乎没而后止 | 学习是以自身为材料的终身雕琢;天性给出起点,学习决定能走多远 | 行者走向群山、日出、"学不可以已"书法收束、片尾 |
|
| 47 |
+
|
| 48 |
+
---
|
| 49 |
+
|
| 50 |
+
## 三、技术架构
|
| 51 |
+
|
| 52 |
+
```
|
| 53 |
+
quanxue-src/
|
| 54 |
+
├── scripts/
|
| 55 |
+
│ ├── gen_tts.py # 旁白生成:逐句 TTS → mp3 + 时长清单(timeline.json)
|
| 56 |
+
│ └── gen_fonts.py # 字体子集化:扫描全部用到的汉字 → 下载对应 woff2 子集,自托管(国内可用)
|
| 57 |
+
├── public/quanxue/
|
| 58 |
+
│ ├── voice/*.mp3 # 旁白音频
|
| 59 |
+
│ ├── timeline.json # 每句旁白的时长
|
| 60 |
+
│ └── fonts/*.woff2 # 书法 / 宋体字体子集
|
| 61 |
+
└── src/quanxue/
|
| 62 |
+
├── script.ts # 文案、章节、每句旁白对应的画面类型
|
| 63 |
+
├── timeline.ts # 由音频时长自动排布全片时间轴(章节、字幕、音效点)
|
| 64 |
+
├── engine/ # 渲染引擎:缓动、噪声、随机、纹理缓存、水墨笔触、文字排版
|
| 65 |
+
├── scenes/ # 各章节的场景绘制(横竖屏两套构图)
|
| 66 |
+
├── audio/ # 古琴/箫/铺底合成器、音效合成、混响、闪避、整体混音
|
| 67 |
+
├── player.ts # 播放器:音频时钟驱动、拖动、章节跳转
|
| 68 |
+
├── exporter.ts # MP4 导出:WebCodecs + Mediabunny,分辨率/帧率/音乐选项
|
| 69 |
+
├── covers.ts # 封面生成(多设计 × 多比例)
|
| 70 |
+
└── publish.ts # 四个平台的标题、描述、话题
|
| 71 |
+
```
|
| 72 |
+
|
| 73 |
+
**关键设计**
|
| 74 |
+
|
| 75 |
+
1. **确定性渲染**:`render(ctx, t, W, H)` 只依赖时间 t 与画幅,不依赖帧率 → 网页播放与导出画面完全一致,任意分辨率/帧率均可导出。
|
| 76 |
+
2. **音频时钟为主**:播放时以 `AudioContext.currentTime` 作为主时钟,画面跟随,保证音画同步。
|
| 77 |
+
3. **自适应构图**:以 `u = min(W,H)/1080` 为单位尺寸,每个场景读取 `portrait` 标志切换布局。
|
| 78 |
+
4. **导出流程**:离线逐帧渲染到 Canvas → `VideoEncoder`(H.264);旁白 + 音效 +(可选)音乐 在 JS 中混成 PCM → `AudioEncoder`(AAC,不支持时回退 Opus)→ MP4 封装 → 本地下载。带进度条、预计剩余时间、可取消。
|
| 79 |
+
5. **性能**:纹理(宣纸、远山、颗粒)按分辨率预渲染缓存;避免逐帧滤镜;导出时控制编码队列背压。
|
| 80 |
+
|
| 81 |
+
---
|
| 82 |
+
|
| 83 |
+
## 四、实施步骤(每完成一步推送一次到本 Space)
|
| 84 |
+
|
| 85 |
+
- [x] **Step 1** 编写计划(本文件)→ 推送
|
| 86 |
+
- [ ] **Step 2** 文案定稿 + 旁白 TTS 生成 + 字体子集化 → 推送
|
| 87 |
+
- [ ] **Step 3** 渲染引擎与全部场景(横竖屏)→ 推送
|
| 88 |
+
- [ ] **Step 4** 音乐、音效合成与播放器(播放/暂停/拖动/章节/全屏)→ 推送
|
| 89 |
+
- [ ] **Step 5** 浏览器本地 MP4 导出(2K/1080P/720P、24/30/60fps、音乐可选、横竖屏)→ 推送
|
| 90 |
+
- [ ] **Step 6** 封面生成(4:3 / 3:4 / 16:9 多选多张)+ 四平台发布文案 → 推送
|
| 91 |
+
- [ ] **Step 7** 手机竖屏适配、生产构建、整体验收 → 最终推送
|
| 92 |
+
|
| 93 |
+
## 五、进度日志
|
| 94 |
+
|
| 95 |
+
- Step 1:计划已写入 README。
|
| 96 |
+
|
| 97 |
+
---
|
| 98 |
+
|
| 99 |
+
# 附:仓库原有项目说明(原样保留,未删除)
|
| 100 |
+
|
| 101 |
+
> 原项目入口:根目录 `index.html`
|
| 102 |
+
|
| 103 |
# 腱鞘炎 · 3D 人体解剖科普动画(网页实时渲染版)
|
| 104 |
|
| 105 |
> 类型:医学科普 + 3D 人体解剖动画 | 时长:约 80–90 秒 | 画幅:9:16 竖屏 | 风格:真实医学 3D、清晰、干净、专业、易懂
|