SuperAPI AI 工具集

webgl-debug

编程与开发

查看项目

更新于 11-12 23:20

技能介绍

用途

webgl-debug 是一个 WebGL 调试与 GPU 追踪技能,用于调查 WebGL 渲染中的异常。根据资料,它主要服务于 debug-viewer 中 VRM 的渲染问题排查,并会在相关调试场景中被自动使用。

主要能力

该技能结合 Playwright MCP 与 Spector.js 形成调试工作流,可处理以下问题:

  • 纹理无法正确显示
  • 画面变黑、变白或显示异常
  • 着色器错误
  • GPU 性能问题

使用方式

资料给出的流程如下:

  1. 确认 debug-viewer 是否已启动:
curl -s -o /dev/null -w "%{http_code}" http://localhost:5173/ 2>/dev/null || echo "not running"

返回 200 表示已启动,否则需启动。

  1. 若未启动,在另一终端运行:
pnpm -F debug-viewer run dev
  1. 使用 Playwright MCP 打开页面并等待加载:
browser_navigate({ url: "http://localhost:5173/" })
browser_wait_for({ text: "VRM loaded" })
  1. 捕获下一帧:
browser_evaluate({
  function: "() => { window.__spector.captureNextFrame(document.querySelector('canvas')); return 'started'; }"
})
browser_wait_for({ time: 2 })
  1. 获取结果:
browser_console_messages({ level: "debug" })

更多细节需参考其 REFERENCE.md。

适用场景

适合在 WebGL/VRM 渲染调试过程中定位纹理、着色器与 GPU 性能相关问题,并获取 GPU 帧追踪信息。

限制

资料未说明该技能对浏览器、显卡或环境的其他具体要求;除上述调试流程外,未提供更多功能或配置说明。