Communitygithub.com

premium-3d-website

构建高端3D网站的指导方针,专注于自定义WebGL着色器、后期处理、基于物理的交互、流畅动画、预加载器及设备优化。

premium-3d-website 是什么?

该技能为开发高性能、沉浸式3D网站提供了详尽的架构指南和代码模式。它面向希望实现高级WebGL视觉效果、自定义着色器管线、物理交互元素以及流畅页面过渡的开发者,同时确保在移动设备和高DPI屏幕上的流畅运行。该技能支持Three.js、React Three Fiber (R3F) 和 Spline 等框架,并详细介绍了如何通过限制像素比、禁用抗锯齿、使用实例渲染以及压缩模型来优化性能。它涵盖从渲染循环搭建、后期处理效果(如泛光、景深)到物理集成和资产预加载的完整工作流,并提供了可复用的代码示例和最佳实践。

兼容平台✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/premium-3d-website

在你喜欢的 AI 中提问

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

文档

高端3D网站

概述

本技能为开发高端、杰出的3D网站提供架构指导与代码模式。它面向希望实现高级WebGL视觉效果、自定义着色器管线、交互式物理元素及沉浸式页面过渡,同时保持高性能的开发者。

何时使用本技能

  • 在设计包含3D元素的高端或获奖创意网站时使用。
  • 在集成Three.js、React Three Fiber (R3F) 或 Spline 并搭配自定义着色器 (GLSL) 时使用。
  • 在实现泛光、景深或自定义胶片颗粒等后期处理效果时使用。
  • 在设计交互式预加载器及高性能资产加载策略时使用。
  • 在优化复杂3D场景以适配移动端响应与性能时使用。

工作原理

步骤 1:建立渲染循环与场景架构

搭建一个健壮的WebGL上下文,并正确处理尺寸变化和性能友好的像素比,这至关重要。应将像素比上限设置为2,避免在高DPI屏幕上渲染过多像素。

步骤 2:实现着色器效果与后期处理

集成后期处理管线(使用 EffectComposer 或 @react-three/postprocessing)以添加泛光、色差、景深或胶片颗粒效果。保持渲染通道数量较少,并合并自定义片段着色器以最小化绘制调用。

步骤 3:集成交互式物理与运动

利用物理框架(如 Cannon.js 或 Rapier)或过程式弹簧动画,使3D物体能够对鼠标悬停、拖拽和点击输入做出有机反馈。

步骤 4:资产管线与预加载器

优化3D模型(使用Draco压缩),并通过自定义加载管理器加载它们。在后台获取重型资产时,渲染交互式预加载器以吸引用户。

示例

示例 1:React Three Fiber (R3F) 中的自定义后期处理

import { Canvas } from '@react-three/fiber';
import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';

export default function PremiumComposer() {
  return (
    <Canvas dpr={[1, 2]} gl={{ powerPreference: "high-performance", antialias: false }}>
      <ambientLight intensity={0.5} />
      <mesh>
        <boxGeometry />
        <meshStandardMaterial emissive="orange" emissiveIntensity={2.0} />
      </mesh>
      
      <EffectComposer disableNormalPass>
        <DepthOfField focusDistance={0} focalLength={0.02} bokehScale={2} height={480} />
        <Bloom luminanceThreshold={0.3} luminanceSmoothing={0.9} height={300} />
        <Vignette eskil={false} offset={0.1} darkness={1.1} />
      </EffectComposer>
    </Canvas>
  );
}

示例 2:用于液体/波浪效果的自定义GLSL着色器材质

import * as THREE from 'three';

const CustomWavyMaterial = new THREE.ShaderMaterial({
  vertexShader: `
    varying vec2 vUv;
    uniform float uTime;
    void main() {
      vUv = uv;
      vec3 pos = position;
      pos.z += sin(pos.x * 5.0 + uTime) * 0.1;
      pos.z += cos(pos.y * 5.0 + uTime) * 0.1;
      gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
    }
  `,
  fragmentShader: `
    varying vec2 vUv;
    uniform float uTime;
    uniform vec3 uColor;
    void main() {
      float pulse = 0.5 + 0.5 * sin(uTime + vUv.x * 10.0);
      gl_FragColor = vec4(uColor * pulse, 1.0);
    }
  `,
  uniforms: {
    uTime: { value: 0.0 },
    uColor: { value: new THREE.Color('#3b82f6') }
  }
});

最佳实践

  • ✅ 设置 dpr={[1, 2]} 以将设备像素比限制为最大2。
  • ✅ 在启用后期处理时禁用WebGLRenderer的抗锯齿,以避免双重抗锯齿导致性能损失。
  • ✅ 使用Blender或其他3D软件将环境光遮蔽、光照和阴影烘焙到纹理中,而不是使用动态光源和实时阴影。
  • ✅ 对于包含多个相同网格的场景,使用实例渲染(THREE.InstancedMesh 或 R3F 的 <Instances>)。
  • ❌ 避免使用未压缩的GLTF/OBJ模型。始终使用Draco或Meshopt压缩模型。
  • ❌ 避免在移动端或低端设备上使用实时阴影贴图(如 THREE.DirectionalLightShadow),因其性能开销较大。

限制

  • 本技能不能替代特定环境的验证、测试或专家评审。
  • 如果缺少必要的输入、权限或安全边界,请停下来请求澄清。
  • 复杂的着色器数学和高级物理模拟边界需要在不同设备芯片组上进行手动测试。

安全与注意事项

  • 验证外部3D模型URL(通过 GLTFLoader 加载)是否托管在受信任的安全CDN上(使用HTTPS)。
  • 不要执行未经验证的任意Shell脚本,也不应使用未锁定版本的NPM包来优化资产。

常见陷阱

  • 问题:在移动端或高DPI(Retina)屏幕上出现严重卡顿/帧率下降。 解决方案:确保像素比限制为2(renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))),并禁用未使用的后期处理通道。
  • 问题:初始化过程中加载时间过长并出现白屏。 解决方案:使用加载管理器(THREE.LoadingManager)并显示一个响应式、交互式的预加载器,以保持用户参与度。

相关技能

  • @3d-web-experience - 核心WebGL、Three.js和Spline概念。
  • @scroll-experience - 将3D动画与滚动控制器集成。
  • @performance-optimizer - 通用代码执行性能调优。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能