Ethscriptions commited on
Commit
674a5a3
·
verified ·
1 Parent(s): 7c250c2

Step 1: 劝学视频项目计划写入 README

Browse files
Files changed (1) hide show
  1. README.md +96 -4
README.md CHANGED
@@ -1,13 +1,105 @@
1
  ---
2
- title: 腱鞘炎 3D 医学科普动画
3
- emoji: 🖐️
4
- colorFrom: indigo
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、清晰、干净、专业、易懂