threejs-debug-profiler

Three.js 调试分析器

找出根本原因，并优化测得的瓶颈，同时确保游戏仍然可玩。

根据行为变更的影响范围进行处理。复用负责人已有的复现步骤和证据；修复后验证受影响的路径。只有在共享行为发生变化或存在未解决风险时，才需要在通过针对性检查后进行更广泛的测试。将测量结果和缺陷反馈给负责人，以便进行整体验证。

参考

references/debug-playbook.md — 针对空白画布、资源和音频加载、循环／动画／物理、输入和移动设备的有序排查流程、分析步骤，以及 __THREE_GAME_DIAGNOSTICS__ 的结构。调试或分析任何不明显的问题时，请阅读此文档。

调试

先使用用户所用的相同命令和 URL 进行复现，并查看控制台、页面和网络错误。找出负责故障的模块（渲染器、循环、摄像机、场景、资源、音频、输入、物理、UI 或基础路径），在该模块中修复根本原因，并重新测试确切的故障路径。排查手册中的顺序涵盖常见原因，例如有多个活动循环、画布显示尺寸与绘图缓冲区不匹配，以及 delta 单位错误。

分析

当用户可见的性能至关重要时，请分析生产预览。为一个固定场景建立基准，将瓶颈分类（CPU、GPU 绘制、片元、顶点、内存或网络），每次只更改一项，然后在相同场景下重新测量，并确认视觉效果和可玩性未受影响。排查手册列出了需要建立基准的指标，以及按收益排序的优化措施。

报告

首先说明根本原因或测得的瓶颈。然后列出更改的文件、优化前后的指标、命令、截图、重新测试的故障路径，以及遗留风险。