故障排查

页面打不开或显示异常

• HEU-keep 是一个纯静态网页——不需要服务器。确保你打开的是本地的 index.html 文件（双击即可），或者是部署后的在线地址
• 如果在在线地址上打不开，可能是浏览器拦截了跨域资源。HEU-keep 的所有资源都是本地的——确认 index.html 和所有的 CSS、JS 文件在同一个目录下
• 建议使用 Chrome、Edge 或 Firefox 的最新版本。IE 和旧版 Safari 可能存在兼容性问题

导出的图片模糊或有黑边

• 确保在点击导出之前左侧预览已经完成渲染——如果预览还在加载中（地图图片尚未完全显示），导出的结果会不完整
• 尝试增大导出宽度（在右侧面板的"输出尺寸"中设置）。宽度越大，图片越清晰，但文件体积也越大
• 如果导出图片边缘有黑色区域，可能是因为 Canvas 在离屏渲染时使用了错误的尺寸。尝试刷新页面后重新导出

轨迹生成的位置不对

• 不同的校园场地（南体育场、军工操场、北体育场）有不同的几何参数——轨迹算法会为每个场地使用对应的 r（半圆半径）和 a（直道半长）值。如果你选择的场地和实际看到的背景地图不一致，需要在右侧面板中切换场地
• 轨迹通过 -4° 旋转来匹配场地方向。如果轨迹和跑道方向仍然有偏差，可能是你的浏览器渲染时有轻微差异。尝试切换到不同的场地再切回来

保存的配置丢失了

• 配置保存在浏览器的 IndexedDB 中。如果你清除了浏览器数据（包括"缓存的图片和文件"或"站点数据"），保存的配置也会被删除。定期点击"保存配置"并不能防止这种情况——建议对你满意的配置截图留念
• 隐私模式/无痕模式下 IndexedDB 在浏览器关闭后会被清空。如果你需要在隐私模式下使用，每次打开都需要重新设置参数
• 如果 IndexedDB 不可用（某些企业策略或浏览器设置可能禁用），系统会自动降级为 localStorage。但 localStorage 容量只有 5MB，大的自定义背景图片可能存不下

自定义背景图片上传后不显示

• 支持的图片格式为 JPG、PNG、WebP。其他格式（如 BMP、TIFF）可能无法正确显示
• 图片文件大小不能过大——建议在 5MB 以内。太大的图片上传时可能导致浏览器卡顿或超时
• 上传后需要等待图片加载完成（左侧预览中背景地图应该发生变化）。如果预览中没有变化，检查浏览器控制台是否有报错