threejs-skill-router

Three.js 视觉技能路由器

将模型对 Three.js 的了解和官方文档视为必备基础。仅加载会改变视觉效果的专业知识。

这个技能包不止提供程序化指导：其中的可运行示例和配套资源包含了许多实用实现价值。与当前任务相关时，请特别关注它们。

根据正在创作的视觉系统进行路由

所需结果	加载
镜头构图、追逐／侧向／环绕机位装置、镜头交接、投影归属、指针视角、浮动原点	$threejs-camera-direction
发射与对接时间线、程序化变换阶段、弹簧、分段布置、旋转参考系对齐、碎片运动	$threejs-procedural-animation
可复用的标量／向量场、域扭曲、因果遮罩、程序化法线	$threejs-procedural-fields
模拟纸张燃烧（耦合纸张燃烧与火焰流体）、发光水母（模拟附肢与分层组织光学效果）、发光蝴蝶（关节式鳞片闪光与有限翼面发射器）、图集过滤的积木、行星表面、混合式纹理驱动 PBR 土壤／苔藓（带程序化位移与遮罩）、地面与模型上的苔藓累积、地形湿度、可变形颗粒沙（质量耦合的颗粒着色）、模拟可撕裂牛仔布（隐式纱线力学与毛边纤维）、GPU XPBD 编织布料与纱线微结构、模拟毛皮（交互式梳理与毛丝着色）、熔岩／自发光表面、反射式波光学衍射光栅、带艾里干涉的薄膜肥皂泡、光线追踪钻石／宝石折射、带内部反射与体积吸收的色散玻璃透射、采用 XPBD 力学与折射焦散的可变形软体果冻材质、手工制作的逐帧 PBR、高光抗锯齿	$threejs-procedural-materials
高度场光线步进、感知轮廓的 POM、弯曲浮雕外壳、浮雕自阴影	$threejs-parallax-occlusion-mapping
精心制作且完整的硬表面物体组合、程序化载具与人形机器人、参数曲线截面轨道、倾斜外壳与脊柱放样、枕形面板、精确多边形切割、UV 归属的开口、沿翼展方向的翼型放样、雕刻式导轨／框架、分支环、鳍片放样、轮廓拉伸、内嵌、旋转成形、扫掠、实体化、倒角与圆角、外壳厚度、直接拓扑开口、语义网格写入器、材质槽与组、基元构建的形体、共面闪烁、松散／非流形几何体、分离部件、相互穿插、支撑、间隙与扫掠包络缺陷	$threejs-procedural-geometry
树木、贴合表面的常春藤、手绘藤蔓、风格化草地、GPU 计算草地、GPU 剔除的虚拟花田、按距离分级的植物几何体、根系、枝叶、根系固定的风致形变	$threejs-procedural-vegetation
建筑、立面语法、轮廓、装饰、模块化网格写入器	$threejs-procedural-architecture
行星、地形、陨石坑、生物群系场、海岸线、球面细节	$threejs-procedural-planets
天空散射、行星外壳、基于深度的大气透视	$threejs-atmosphere-aerial-perspective
天气驱动的光线步进云与云影	$threejs-volumetric-clouds
FFT 海洋、近岸碎浪过渡、有限体积浅水海滩波浪、带符号距离海岸线、浅水拍岸波链、湿沙、岩石撞击飞溅、风格化海面上下光学效果、水下斯涅尔窗口、全内反射、前向折射结构、基于像素足迹的光谱 LOD、水中透视、焦散光束、光谱级联、陡峭波面导数、雅可比白浪	$threejs-spectral-ocean
发光浅水河流（耦合流动、生物发光激发、平流泡沫与 RGB 焦散）、照片级浅水效果（重力毛细波 FFT、色散焦散与衍射眩光）、手工制作的解析波、有限边界高度场水池、物体涟漪、微分面积焦散、光线追踪水池体积光学效果、共享法线、启发式折射、回退吸收、波峰泡沫	$threejs-water-optics
飘雪、积雪、模型积雪覆盖、湿沥青水坑、程序化涟漪法线、飞溅翻页动画、雨丝、共享天气包络、表面湿润	$threejs-precipitation-surfaces
弯曲光线黑洞、吸积盘、虫洞与喉部穿越、零测地线积分、引力透镜天球与星野	$threejs-raymarched-space-effects
电影感 HDR 镜头光晕合成器、由高光生成的径向鬼影、视场角瞳孔形变、光谱瞳孔环、局部眩光与泛光、光线步进极光帘、有限足迹自发光平板、均匀体积积分、等距柱状辐射探针、WebGPU 体素火焰与烟雾、体积流体场、网格表面发射器、SDF 火焰碰撞、粒子、轨迹、等离子体、冲击波、全息投影、菲涅耳边缘外壳、扫描线条带、分层事件特效	$threejs-procedural-vfx
累积屏幕霜冻、触控清除、湿窗雨滴、与视角对齐的水滴折射与模糊	$threejs-temporal-surfaces
稳定的大世界阴影、级联、裁剪贴图、缓存更新	$threejs-shadow-systems
GTAO、弯曲法线、双边重建	$threejs-screen-space-ambient-occlusion
HDR 泛光与选择性自发光贡献	$threejs-bloom
眼部适应、色调映射、LUT 调色、输出颜色	$threejs-exposure-color-grading
共享深度／法线／速度归属与多通道排序	$threejs-image-pipeline
固定视图诊断、种子扫描、时序与预算证据	$threejs-visual-validation

执行顺序

对于新的程序化场景：

1. 定义视觉约定：主体、比例、相机距离、运动和目标帧预算。
2. 如果构图、镜头、相机画面或模式转换会影响目标，则加载 $threejs-camera-direction。
3. 加载主体生成技能。
4. 如果物体运动需要预先编写的阶段、动态帧或弹簧收敛，则添加 $threejs-procedural-animation。
5. 如果多个视觉通道需要共享连贯结构，则添加 $threejs-procedural-fields。
6. 只有在不加效果时剪影和材质遮罩也清晰可辨后，才添加灯光／阴影和氛围效果。
7. 最后添加 $threejs-image-pipeline。
8. 仅加载实际需要的原子图像效果。
9. 使用 $threejs-visual-validation 获取一组确定性证据。

路由约束

• 不要仅为 API 设置加载技能。检查已安装的 Three.js 版本，并使用官方文档。
• 不要将“让它更漂亮”直接路由到后期处理。找出缺失的创作系统。
• 优先采用一条有力且可检查的视觉规则，而不是叠加多层彼此独立的噪声。
• 根据所提供的参考进行改编时，应保留塑造其特色的机制。不要将其简化为通用的效果类别。
• 除非构图明确要求耦合，否则应将物体空间、世界空间和屏幕空间系统分开。
• 如果没有适用的技能，则说明该技能包缺乏对该系统的专家覆盖。不要勉强用最相近的技能来覆盖它。

验收关卡

路由任务只有在实现中提供以下内容后才算完成：

• 确定性种子或可复现的输入；
• 用于控制场的视觉调试模式；
• 按感知角色分组的参数；
• 当系统定义了质量或分辨率等级时，提供基于明确机制的专用等级；
• 即使不使用后期处理，基线效果仍清晰可辨。