用途:用于 WebGPU 渲染器相关工作,包括 three.js/TSL 场景层、节点材质,以及原生 WGSL 渲染通道与计算。适用于正确性依赖 GPU 资源归属、通道编排、着色器/材质布局、深度语义或浏览器实测输出的场景。改动前需先在代码库中确认当前归属方(投影、深度约定、环境预设),不要假设本技能了解当前模块布局。
主要能力与工作流:先检查现有 device/shell、通道图、绑定组布局、着色器契约与验证路径,再新增管线或缓冲。先定义资源:缓冲、纹理、uniform、存储布局、绑定组、归属、更新频率、读写权限与生命周期。按需选择阶段:计算用于并行准备、模拟、归约、纹理/缓冲变换与工作列表构建;渲染通道用于光栅化输出;当可见性语义不同时,拆分背景、深度测试世界、透明/特效与 UI 叠加阶段。共享契约单一来源:相机布局、投影辅助、深度模式、帧阶段、语义角色、顶点步长与绑定组模式应放在一个规范模块中,由渲染器、着色器与验证器导入。
规则要点:一个投影归属方、一个深度约定、一个环境归属方;相机通过共享相机辅助摆位,不在路由或通道中手写轨道数学。大型户外深度范围优先在浮点深度缓冲上使用反向 Z(近→1,远→0),且约定为引擎级统一。WGSL uniform 与存储结构体必须遵守对齐,标量字段可打包进 16 字节槽位。深度应视为访问契约而非布尔值,使用 read、read-write、write 等显式模式。同一渲染通道内所有管线必须与其附件兼容;新增深度附件是通道级改动。不要把 alpha 混合混入写深度的不透明几何。世界空间地面提示不是 HUD 叠加,应由世界相机提交并让真实几何遮挡。抬升或倾斜地形上的地面贴花需要与世界对象相同的表面高度。连续世界路径应为连续几何,不要通过切断端点间隙来制造连续性。实例化世界道具在抬升地形上需要基础高程字段。倾斜世界场景需要一个规范表面。地理效果需要规范遮罩/投影归属方。共享视觉概念不是通道局部旋钮。次级世界视图需要与主视图相同的契约。嵌套对象必须用敌意顺序夹具证明。浏览器检查可能通过而画布视觉错误,WGSL、管线、相机、通道顺序、深度或混合变更后应检查实际 PNG。有效渲染不一定是有用捕获,截图门禁必须证明目标主体被取景。GPU 渲染器验证警告应视为渲染失败。WGSL let 绑定不可变,需要覆盖时用 var。暴露通道级统计。场景断言应与渲染器代码同源。能力处理必须与产品匹配。空间预算不得抹除地理。统计提交实例数不等于 GPU 渲染了内容。
three.js WebGPU + TSL 规则:反向深度会翻转 three 的排序渲染列表,需实证绘制顺序。自定义 positionNode 会静默丢弃 instanceMatrix。normalNode 是视图空间。TSL 时间节点在渲染器代码中被禁用,动画应基于可注入的时间 uniform 与带种子的 RNG。不要使用无限远透视。renderer.info 每帧重置,需在渲染时快照。类型包会拓宽 TSL 字面量,应使用显式泛型。采样数应与产品匹配。屏幕雾范围是相机距离范围。
性能:SwiftShader 是正确性代理而非性能基准,性能门禁仅在硬件上运行。引用帧时间前需证明是哪块 GPU 绘制了帧;Playwright 默认无头 chromium_headless_shell 无 GPU 后端,会静默落到 SwiftShader。可用 npx playwright install chromium 修复回退。GPU 套件应单 worker 运行。优先实例化、批处理、存储缓冲、间接绘制与 GPU 侧阶段准备。逐实例视锥剔除并非免费。避免热路径中的 CPU 回读。迭代计算或模拟应拆分阶段并使用乒乓缓冲。邻居查询、人群、粒子或分块效果优先使用空间网格、瓦片或压缩工作列表。暴露有意义的旋钮与统计。
视觉验证:使用能覆盖变更视觉表面的最小路由,然后自行打开生成的 PNG。快照失败时检查实际候选产物而非基线路径。模型表、接触表、动画 GIF 与时间线条应检查每个瓦片或帧类。投影敏感场景有争议时,先添加小型合成对齐夹具。冻结帧缓存必须键控每个影响渲染的快照开关。诊断小几何、标签、精灵、旗帜、深度重叠或 LOD 伪影前,先裁剪并放大可疑区域。GPU 支持的屏幕叠加应暴露语义锚点。屏幕空间文本/图标仲裁应放在有测量叠加边界的地方。指标作为遥测使用。视觉变更若有争议或细微,可运行 screenshot-critique 进行未预热第二遍。
常见失败征兆:通道报告一种语义角色而其管线使用另一种深度或混合状态;背景或叠加通道绘制真实 3D 对象;平坦背景/底层被期望在相机倾斜、缩放或透视变化后与 3D 对象对齐;路由统计报告健康通道而控制台验证警告管线或命令缓冲无效;共享辅助旁出现私有着色器相机/投影辅助;验证器手工重复渲染器常量;绿色场景没有截图检查;截图大部分为空白场地、水面、天空或纯色而统计看似正常。
限制:资料未提供具体安装命令、收费方式、平台支持范围或版本要求,暂未提供。