用途：面向网页 3D 开发，Three.js 作为渲染引擎，React Three Fiber（R3F）作为 React 渲染器。资料给出简明规则，深入内容放在 references/ 目录。
主要能力：场景搭建模式（Canvas、Environment、OrbitControls、Suspense）；R3F 钩子（useFrame、useThree、useLoader、useGraph）；drei 常用组件（Environment、Float、Text3D、useGLTF、MeshTransmissionMaterial、PresentationControls、Center、Detailed、useTexture、Instances）；后期处理（EffectComposer、Bloom、ChromaticAberration）；性能模式（Instances、LOD、Draco、KTX2、frameloop="demand"、invalidate、离屏画布）。
使用方式：场景内容需包在 Suspense 中；设置 dpr={[1,2]} 限制像素比；保持 Canvas 父组件精简。useFrame 中用 delta 做帧率无关动画，禁止在其中 setState，禁止在渲染循环中分配对象，注意 dispose 释放 GPU 资源，避免重渲染 Canvas 父组件，加载资源必须配合 Suspense。
适用场景：完整 3D 场景用 R3F + drei；无 React 用 Three.js 直接开发；UI 简单 3D 变换用 CSS transform3d；2D 粒子用 Canvas 2D；纯着色器视觉用原生 WebGL/ShaderMaterial。
限制：资料未提供安装命令、版本要求、收费与平台信息；目标指标为少于 100 次绘制调用、少于 100 万三角形、中端 GPU 60fps，可用 stats-gl 或 r3f-perf 监控。