用途
webgl-debug 是一个 WebGL 调试与 GPU 追踪技能,用于调查 WebGL 渲染中的异常。根据资料,它主要服务于 debug-viewer 中 VRM 的渲染问题排查,并会在相关调试场景中被自动使用。
主要能力
该技能结合 Playwright MCP 与 Spector.js 形成调试工作流,可处理以下问题:
- 纹理无法正确显示
- 画面变黑、变白或显示异常
- 着色器错误
- GPU 性能问题
使用方式
资料给出的流程如下:
- 确认 debug-viewer 是否已启动:
curl -s -o /dev/null -w "%{http_code}" http://localhost:5173/ 2>/dev/null || echo "not running"
返回 200 表示已启动,否则需启动。
- 若未启动,在另一终端运行:
pnpm -F debug-viewer run dev
- 使用 Playwright MCP 打开页面并等待加载:
browser_navigate({ url: "http://localhost:5173/" })
browser_wait_for({ text: "VRM loaded" })
- 捕获下一帧:
browser_evaluate({
function: "() => { window.__spector.captureNextFrame(document.querySelector('canvas')); return 'started'; }"
})
browser_wait_for({ time: 2 })
- 获取结果:
browser_console_messages({ level: "debug" })
更多细节需参考其 REFERENCE.md。
适用场景
适合在 WebGL/VRM 渲染调试过程中定位纹理、着色器与 GPU 性能相关问题,并获取 GPU 帧追踪信息。
限制
资料未说明该技能对浏览器、显卡或环境的其他具体要求;除上述调试流程外,未提供更多功能或配置说明。