Three.js 质量套件 —— 资源、方法、检查清单
这个技能旨在回答一个问题:是什么让我们的 Three.js 视频从“堆砌的基本体”变成了一个拥有绑骨角色、真实城市和精心场景的电影? 三个要素:逐步积累的资源、一套工作方法,以及系统的审核流程。姊妹技能 threejs-code-video 包含技术细节(管线、角色、相机、动画循环、常见陷阱);而本技能则是概览和启动套件。
目录
| 文件 | 用途 |
|---|---|
| references/ressources.md | 完整清单:仓库、技能、网站、工具、服务——每项的贡献、安装方法和许可证 |
| references/methode.md | 分步工作流程,以及真正提升质量的 6 个关键杠杆 |
| references/checklist.md | 可勾选的检查清单:安装、编码前、编码中、提交前 |
scripts/install-kit.js | 在项目中安装套件中的公共技能(克隆+复制,无依赖) |
scripts/planche.js | 视频 → 逐帧预览(1 帧/秒),用于全面审阅渲染结果 |
scripts/polyfork-fetch.js | 搜索并下载 Polyfork 模型(可参数化的 .mjs 模块) |
scripts/face-landmarks.py、scripts/face-measure.py | 基于照片测量面部(使用 MediaPipe),而不是凭眼估算 |
资源速览
| 需求 | 资源 | 我们使用的版本 |
|---|---|---|
| 最新 Three.js (r186)、R3F、着色器、光照…… | 13 个 threejs-* 技能 —— CloudAI-X/threejs-skills | 已安装,每次合成时查阅 |
| 逐帧视频渲染 | 8 个 Remotion 技能 —— remotion-dev/skills | 已安装 |
| 代码视频方法和模板 | 技能 threejs-code-video + 仓库 Alex-sia99/threejs-code-video | 由我们编写并公开 |
| 低多边形物体、场景、角色 | Polyfork(polyfork.dev,索引 lucas-martinic/polyfork-catalog) | 在 v3 版视频中使用 —— .mjs 模块从未重新分发 |
| 动画骨骼 | Mixamo 骨架和动作剪辑 | 视频 v3 版的绑骨角色 |
| 照片相似度 | img2threejs/img2threejs + MediaPipe 面部特征点 | 采用“测量,而非估计”的方法 |
| 建模前的参考图像 | Kie.ai nano-banana-2-lite | 用于比例和场景 |
| 语音、音效、音乐 | ElevenLabs、Suno、FFmpeg | 完整管线 |
| 代码式 2D 绘图(其他风格) | alexgreensh/anidoodle、html-anime | 已安装,独立于 Three.js |
详细内容、链接和注意事项请参阅:references/ressources.md。
十步工作法
- 先找参考:将风格视频逐帧分析,收集参考图像,测量照片。
- 先加载技能,再写代码:加载相关的
threejs-*或remotion-*技能,切勿凭记忆编写 API。 - 研究优秀代码,然后重写:阅读一个优秀的模块,记录方法,编写自己的版本。
- 一切函数化,纯函数依赖帧号:固定种子、基于距离移动、不累积状态。
- 脚本 → 语音 → 时间线:场景安排基于台词(
at("l14")),而非硬编码的秒数。 - 每个问题一个实验:面部合成用
Lab场景,角色绑定用RigLab实验,有疑问时运行一组测试。 - 渲染、检查、修正:静态图像 → 每场景预览 → 以 1 帧/秒的速度审阅最终视频。
- 在重大改版前,由新人进行严格的审查。
- 早期进行人工验证:在长渲染之前确定角色和风格方向。
- 沉淀知识:每个遇到的陷阱写入
pitfalls.md,每个方法写入一个技能。
详细说明请参阅:references/methode.md。
不可妥协的规则
- 切勿提交未审阅的渲染结果。 静态图像不足以判断一个电影:必须通过逐帧预览审阅最终视频。
- 风格优于精度。 在风格化世界中放置一个照片级真实的面部已被否决两次;相似度应通过形状和几个关键特征实现。
- 遵守许可证。 Polyfork:视频中使用无限制,但
.mjs模块和烘焙动画剪辑绝不能放入公共仓库或打包分发。 - 一个线条 = 一个体积,一个地点 = 一个可识别的物体,一句台词 = 一个展示它的视觉效果。
将套件传给学员
该套件发布在仓库 https://github.com/Alex-sia99/threejs-quality-kit :只需发送该链接即可。README 面向学员(包含前提条件、三步安装法、供其代理使用的指令);install.js 脚本会自动下载公共技能和起始项目,因此仓库保持轻量和更新。切勿在其中添加 Polyfork .mjs 模块、anim-*.json 动画剪辑、API 密钥、照片或个人语音。