SuperAPI AI 工具集

typegpu

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:该技能作为紧凑路由器与领域检查清单,覆盖 TypeGPU 的 schema、类型化缓冲与纹理、着色器函数、管线、WebGPU 能力检查,以及 CPU/GPU 资源归属。触发条件为任务涉及 TypeGPU 导入;原生 WebGPU(无 TypeGPU 导入)不触发,Three/R3F 场景应使用 web-three-r3f,React Native GPU 表面应使用 native-three-r3f 或 native-skia。

主要能力与工作流:先检查已安装的 typegpu、unplugin-typegpu、@webgpu/types、tsover 及浏览器/运行时支持;在定义资源与着色器签名之前先定义 schema;保持 root/device/resource 归属显式;验证不支持浏览器的回退、减少动态效果/静态质量以及 GPU 清理。

关键注意点:d.* schema 是 CPU 布局、GPU 布局与 TypeScript 类型的唯一事实来源;TypeScript 着色器函数需要 unplugin-typegpu,仅用 WGSL 时可能不需要;除非经过测量并缓存,不要逐帧分配缓冲、纹理、绑定组或管线。

资源与用法:内置 references 目录包含 typegpu-codex-playbook、shader-resource-boundaries、webgpu-runtime-validation、browser-capability-and-adapter-selection、compute-vs-render-pipeline-design 等按条件加载的参考文档,以及 matrices、pipelines、setup、shaders、textures、types、advanced、noise、sdf 等源码摘录。审计 CLI 用法:node scripts/audit.mjs doctor --root . --format json;node scripts/audit.mjs scan --root . --format markdown;node scripts/audit.mjs scan --root . --format json --output typegpu-audit.json。脚本发现仅作为线索,修改行为前须对照当前代码核实。

限制:编辑前须对照目标仓库已安装包版本核实 API 细节;本地代码或内置笔记对版本敏感时,以官方当前文档/包源码为 API 事实来源;不引用本地抓取路径、机器缓存路径或隐藏源位置。收尾前运行仓库聚焦验证命令、相关审计 CLI 及所需的浏览器/设备/手动证明,并报告已运行命令、已修复发现、跳过原因与残余风险。