IIIF Manifest 查看器失败或结果异常？排错指南
排查IIIF Manifest 查看器的扩展名、文件结构、依赖、编码、内存和结果误差，同时保留原文件。
先保留原文件
不要改后缀后覆盖源文件，也不要把网页预览当成唯一验收记录。复制一份小样本并记录文件大小、来源软件、版本、浏览器和完整错误提示。
这个格式最容易忽略的事实
例如博物馆 Manifest v3 的 items 中有多个 Canvas。先检查每个 Canvas 的 painting annotation 与 ImageService，再遵循 requiredStatement/rights 所写的使用条件。
推荐排查顺序
- 使用页面示例或较小的已知正常文件，确认工具本身能够运行。
- 检查扩展名、文件签名、配套文件、远程 URL 和 CORS，排除下载到 HTML 错误页。
- 对照操作步骤重新提供输入：
- 粘贴公开 Manifest URL 或选择 JSON 文件。
- 检查 Presentation 版本、label、items/sequences 和 Canvas。
- 选择 Canvas 并加载可访问的 Image API 服务。
- 复制原始来源链接，按机构权利声明使用图像。
- 关闭占内存的标签页并使用最新版 Chrome 或 Edge 重试。
- 仍异常时回到生成文件的专业软件重新导出，在目标系统复核。
常见问题与答案
为什么 URL 打不开？
Manifest 或瓦片服务器可能没有允许浏览器跨域访问，或需要登录。
支持 IIIF v2 和 v3 吗？
支持常见 Presentation 2/3 基础结构，复杂扩展需在机构查看器复核。
会保存远程地址吗？
不会为运行工具保存；浏览器仍会直接请求你提供的公开来源。
不应绕过的限制
- 受远程服务器 CORS、认证和可用性影响
- 不完整支持所有扩展、annotation 和 range 结构
- 能显示不代表允许下载、再发布或商用
隐私处理
本地输入不会为了处理上传到 FreeTool；远程 IIIF/DZI URL 会由浏览器访问来源服务器。排错截图、OCR 文本、模型摘要和转换文件可能包含敏感或受版权保护内容，分享前应脱敏并确认权限。