SuperAPI AI 工具集

shader-extract

设计与创作

查看项目

更新于 10-15 20:29

技能介绍

用途:捕获网页中单个 GPU 渲染表面(WebGL/WebGPU/Canvas/着色器/动画 3D 效果),重建为经过验证、可本地运行的效果模块。核心原则是“证据先于实现”:捕获页面 GPU 管线的真实行为(着色器、uniform、通道顺序、纹理、时序)并与之匹配,而非目测仿制。

主要能力:封装了 vendor/web-shader-extractor/ 中由 lixiaolin94 开发(MIT)的证据门控状态机,流程为 surface lock → source/runtime trace → capture → verified baseline → projectize。本技能额外提供两件事:一是接收 clone-site 协调器已锁定的表面,跳过侦察直接捕获;二是明确具体捕获后端——WebGL1/2 用 Spector.js,WebGPU 用 WebGPU Inspector。

使用方式:若由 clone-site 驱动,会收到已锁定表面(选择器、包围盒、推测驱动如 three.js/unicorn-studio/spline/regl/raw WebGL)和输出目录 output/<host>/effects/<surface-id>/,直接读取 vendor/web-shader-extractor/SKILL.md 与 references/replay-policy.md,按表面类型选捕获后端,从 CAPTURE_MINIMUM_TRUTH 起运行状态流,返回挂载契约模块与诚实标签。若独立使用(用户给 URL),需先锁定表面,从 INTAKE 运行完整流程;scripts/surface-map.js 可快速枚举分类 canvas,但 TARGET_LOCK 门控为准。

输出契约:除 vendor 输出布局(capture-baseline、editable-project、qa-report、known-gaps)外,暴露 mount(canvasEl, opts)、unmount(handle)、resize(handle, w, h, dpr) 生命周期,并输出 poster frame 作为 reduced-motion 回退。

限制与原则:所有关键事实须标注 SOURCE/PARTIAL/GUESS,未标注即 GUESS;禁止补偿性调参掩盖缺失证据,缺口记入 known-gaps.md;先获得验证基线再重构为可编辑模块;跨域画布若像素/着色器读取被阻止,须如实说明并回退到捕获的静态帧,不得编造着色器。