Communitygithub.com

premium-3d-website

建立高階 3D 網站的指南,聚焦於自訂 WebGL 著色器、後製處理、基於物理的互動、流暢動畫、預載入器以及裝置最佳化。

premium-3d-website 是什麼?

這個技能提供開發 premium 等級 3D 網站的架構指南與程式碼模式。目標對象是希望實作進階 WebGL 視覺效果、自訂著色器管線、互動物理元素以及沉浸式頁面轉場,同時維持高效能的開發者。支援的平台包括 Three.js、React Three Fiber (R3F) 和 Spline,並涵蓋後製特效(如 bloom、景深)、Draco 壓縮模型、自訂 GLSL ShaderMaterial 以及基於 Cannon.js 或 Rapier 的物理互動。此技能還強調調整裝置像素比(dpr)至最大值 2、在啟用後製時停用 WebGLRenderer 抗鋸齒、使用 InstancedMesh 提升渲染效能,以及使用 LoadingManager 搭配互動預載入器來解決初始載入白畫面的問題。整體而言,它能協助開發者打造兼具視覺衝擊與高效能的行動版 3D 體驗。

相容平台✓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 網站

概述

此技能提供開發 premium、高階 3D 網站的架構指南與程式碼模式。目標對象是希望實作進階 WebGL 視覺效果、自訂著色器管線、互動物理元素以及沉浸式頁面轉場,同時維持高效能的開發者。

何時使用此技能

  • 在設計包含 3D 元素的 premium 或獲獎級創意網站時使用。
  • 在整合 Three.js、React Three Fiber (R3F) 或 Spline 並搭配自訂著色器 (GLSL) 時使用。
  • 在實作如 bloom、景深或自訂底片顆粒等後製特效時使用。
  • 在設計互動式預載入器與高效能資源載入策略時使用。
  • 在針對行動裝置回應性與效能最佳化複雜 3D 場景時使用。

運作方式

步驟 1:建立渲染循環與場景架構

設定穩健的 WebGL 上下文,並妥善處理視窗縮放與效能友善的像素比是關鍵。將像素比維持在最大值 2,以避免在高 DPI 螢幕上渲染過多像素。

步驟 2:實作著色器特效與後製處理

整合後製管線(使用 EffectComposer 或 @react-three/postprocessing)來加入 bloom、色差、景深或底片顆粒。保持較少的通道數量,並結合自訂片段著色器以減少繪製呼叫。

步驟 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.

相關技能