用途：给定 mapbox/mapbox-gl-js 公开 issue 或 PR 链接，产出最小的自包含调试页面 debug/<issue-number>.html 来复现报告的 bug，目标是让开发者打开后一分钟内看到问题并开始调试。
主要能力：先用 gh issue view <N> --repo mapbox/mapbox-gl-js --comments（PR 用 gh pr view）读取全文与评论，提取预期与实际行为、最小复现输入（style、source、layer、属性、相机参数、交互）以及版本与外部资源；若已存在同名文件会先读取并询问覆盖或迭代；把报告者的大型代码片段裁剪到只保留与 bug 因果相关部分。
使用方式：页面使用固定脚手架，引入 ../dist/mapbox-gl.css 与 ../dist/mapbox-gl-dev.js，通过 import {getAccessToken} from './access_token_generated.js' 获取令牌，不硬编码 token。按约定 window.map = new mapboxgl.Map({...})、hash: true，脚本顶部写一行注释关联 issue 链接与预期/实际行为简述。运行前需 npm run build-dev；验证时用 npm run start 后打开 http://localhost:9966/debug/<N>.html。完成后报告文件路径、预期与实际行为一句话、歧义处的假设以及疑似子系统。不提交 commit、不开 PR。
限制：仅支持公开 issue，私有仓库或 404 会快速失败，建议用户直接粘贴相关内容；若 issue 是提问而非 bug 则不生成复现；构建/工具链类问题不适用本调试页；平台特定问题只在注释中标注约束。若无法实际运行，须明确说明，不能声称复现已验证。