用途
该技能用于处理 React Three Fiber(R3F)native 场景,即在 Expo/React Native 中使用 Three.js 进行 3D 渲染的开发任务。它定位为紧凑路由器加领域检查清单,帮助开发者在原生端完成 R3F 场景搭建、资产加载、GPU 生命周期管理和平台验证。
主要能力
- 覆盖 R3F native 安装与生命周期,包括 @react-three/fiber/native 的初始化设置和场景所有权。
- 处理 expo-gl、react-native-wgpu 与 WebGPU 的边界问题,并提供 Expo GL、WebGPU、Three.js、R3F native 及回退渲染面的决策树。
- 提供原生 3D 资产加载配方,适用于 GLTF/GLB、纹理、HDR/环境贴图及解码器支持资产。
- 提供原生 GPU 验证清单,要求在关闭 R3F/Three 原生改动前进行设备或开发构建验证。
- 附带审计 CLI 与报告模板、手动审查清单、起始示例文件,以及触发查询和任务质量评估集。
使用方式
技能强调按条件加载参考文档:仅当当前任务匹配参考文档条件时才读取对应文件。工作流依次为:检查 Expo SDK、GL/WebGPU 包、R3F/Three 版本与资产管线;仅在 3D 场景是产品表面时选择 native R3F;掌控画布尺寸、DPR/质量、加载器与清理;在设备/开发构建上验证原生 GPU 风险。审计 CLI 提供 doctor 和 scan 命令,支持 JSON 与 Markdown 输出。脚本发现需视为线索,修改行为或报告前须对照当前代码核实。
适用场景
适用于 Expo/React Native 中的 Three.js 与 R3F native 3D 场景开发、原生 GPU 生命周期管理、原生端 3D 资产加载、expo-gl/WebGPU 互操作边界判断,以及原生 3D 改动的设备验证与审计。
限制与边界
技能明确不用于浏览器 Three/R3F(应使用 web-three-r3f)、Web TypeGPU 代码(typegpu)或 2D 画布绘制(native-skia)。浏览器 R3F 示例常假定原生端不存在的 DOM/WebGL API;原生资产加载与解码器路径与 Web 不同;GPU 运行时变更需要设备证明,不能仅靠 TypeScript。技能要求不引用本地抓取路径、机器缓存路径或隐藏源位置,并需根据目标仓库安装的包版本核实 API。技能文本未提供具体收费、价格、平台支持范围或效果数据。