超大图片深度缩放查看器失败或结果异常？排错指南
排查超大图片深度缩放查看器的扩展名、文件结构、依赖、编码、内存和结果误差，同时保留原文件。
先保留原文件
不要改后缀后覆盖源文件，也不要把网页预览当成唯一验收记录。复制一份小样本并记录文件大小、来源软件、版本、浏览器和完整错误提示。
这个格式最容易忽略的事实
例如 30000×20000 RGBA 图片解码内存约 2.4GB，远大于磁盘压缩体积。看到内存预警应停止并使用 DZI/IIIF 瓦片来源。
推荐排查顺序
- 使用页面示例或较小的已知正常文件，确认工具本身能够运行。
- 检查扩展名、文件签名、配套文件、远程 URL 和 CORS，排除下载到 HTML 错误页。
- 对照操作步骤重新提供输入：
- 选择一张高分辨率图片。
- 等待浏览器解码并查看宽高、格式和估算内存。
- 缩放、平移并用导航缩略图定位细节。
- 遇到内存警告时停止加载并改用瓦片化来源。
- 关闭占内存的标签页并使用最新版 Chrome 或 Edge 重试。
- 仍异常时回到生成文件的专业软件重新导出，在目标系统复核。
常见问题与答案
为什么100MB图片占用很多内存？
解码后通常按宽×高×4字节或更多保存，与压缩包大小不同。
TIFF 都能打开吗？
仅支持当前浏览器/解析器兼容的压缩和位深，专业多页或科学 TIFF 请用对应工具。
图片会上传吗？
文件在当前浏览器标签页中处理，不会为了运行该功能上传到 FreeTool 服务器。
不应绕过的限制
- 压缩文件小不代表解码内存小
- 超出浏览器画布、纹理或内存限制时无法打开
- 不生成瓦片、不做专业色彩管理或医学影像显示
隐私处理
本地输入不会为了处理上传到 FreeTool；远程 IIIF/DZI URL 会由浏览器访问来源服务器。排错截图、OCR 文本、模型摘要和转换文件可能包含敏感或受版权保护内容，分享前应脱敏并确认权限。