Communitygithub.com

threejs-quality-kit

Three.js 视频质量提升套件,整合高质量资源、工作流程、检查清单和家长包,帮助您从“基础堆砌”迈向专业级 CGI 作品。

threejs-quality-kit 是什么?

**Three.js 质量套件 (threejs-quality-kit)** 是一个专为提升 Three.js + Remotion + React Three Fiber 视频质量而设计的 AI Agent 技能。它综合了全面的资源库(GitHub 仓库、已安装技能、资产库、测量工具、音频服务)、标准化工作流程(参考 → 加载技能 → 代码研究 → 实验 → 渲染/检查/修正 → 验证)以及可勾选的检查清单,帮助开发者生成更精美的代码出品。该技能支持 Claude Code、Cursor、Codex 等 AI 编码代理,并提供详细的资源索引、方法指南和检查清单,确保每一步工艺都经过审慎思考。通过 `install.js` 脚本,技能能够自动安装公共技能和起始项目;`planche.js` 脚本用于逐帧审阅视频;`polyfork-fetch.js` 可下载参数化 3D 模型;`face-landmarks.py` 和 `face-measure.py` 则用于基于照片的人脸测量,免去肉眼估算的不确定性。该套件帮助用户避免常见陷阱,强制遵循许可证规则,并确保每次交付的视频都经过完整审核。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alex-sia99/threejs-quality-kit/tree/HEAD/skills/threejs-quality-kit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

十步工作法

  1. 先找参考:将风格视频逐帧分析,收集参考图像,测量照片。
  2. 先加载技能,再写代码:加载相关的 threejs-* 或 remotion-* 技能,切勿凭记忆编写 API。
  3. 研究优秀代码,然后重写:阅读一个优秀的模块,记录方法,编写自己的版本。
  4. 一切函数化,纯函数依赖帧号:固定种子、基于距离移动、不累积状态。
  5. 脚本 → 语音 → 时间线:场景安排基于台词(at("l14")),而非硬编码的秒数。
  6. 每个问题一个实验:面部合成用 Lab 场景,角色绑定用 RigLab 实验,有疑问时运行一组测试。
  7. 渲染、检查、修正:静态图像 → 每场景预览 → 以 1 帧/秒的速度审阅最终视频。
  8. 在重大改版前,由新人进行严格的审查。
  9. 早期进行人工验证:在长渲染之前确定角色和风格方向。
  10. 沉淀知识:每个遇到的陷阱写入 pitfalls.md,每个方法写入一个技能。

详细说明请参阅:references/methode.md。

不可妥协的规则

  • 切勿提交未审阅的渲染结果。 静态图像不足以判断一个电影:必须通过逐帧预览审阅最终视频。
  • 风格优于精度。 在风格化世界中放置一个照片级真实的面部已被否决两次;相似度应通过形状和几个关键特征实现。
  • 遵守许可证。 Polyfork:视频中使用无限制,但 .mjs 模块和烘焙动画剪辑绝不能放入公共仓库或打包分发。
  • 一个线条 = 一个体积,一个地点 = 一个可识别的物体,一句台词 = 一个展示它的视觉效果。

将套件传给学员

该套件发布在仓库 https://github.com/Alex-sia99/threejs-quality-kit :只需发送该链接即可。README 面向学员(包含前提条件、三步安装法、供其代理使用的指令);install.js 脚本会自动下载公共技能和起始项目,因此仓库保持轻量和更新。切勿在其中添加 Polyfork .mjs 模块、anim-*.json 动画剪辑、API 密钥、照片或个人语音。

相关技能