用途：帮助创建小型、高性能的 Three.js 网页应用与 3D 场景，使用现代 ES 模块（JS/TS）写法。核心思路是场景图（scene graph）心智模型：加入 scene 的对象才会渲染，用 Group 处理层级变换。
主要能力：提供场景、相机、渲染器的基础搭建；内置几何体（Box、Sphere、Cylinder、Torus、Plane、Cone、Icosahedron）与材质选择（Basic、Standard、Physical、Normal、Phong）；光照类型（Ambient、Directional、Point、Spot）与阴影配置；动画循环、鼠标交互、窗口缩放处理；OrbitControls 相机控制；以及旋转立方体、粒子场、网格背景等常见场景模式。
使用方式：真实项目推荐 npm + 打包器，执行 npm i three，从 three 与 three/addons/... 导入；单文件演示可用 CDN。动画推荐 renderer.setAnimationLoop((time) => {...})，并设置 renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))。OrbitControls 需从 three/addons/controls/OrbitControls.js 或对应 CDN examples/jsm 路径导入。
适用场景：作品集展示、游戏/交互、数据可视化、背景特效、产品查看器等。
限制与注意：无光照时除 Basic/Normal 材质外画面为黑；避免在动画循环中新建几何体、避免过高分段数、避免不设 pixelRatio 上限；现代 Three.js（r150+）使用 ES 模块，CommonJS 与全局 THREE 变量属旧写法。GLTF 模型、着色器、后处理等进阶主题见 references/advanced-topics.md，游戏开发模式见 references/game-patterns.md。具体收费、价格与平台信息暂未提供。