文档文章

常见问题

集中回答 IR、可信度、浏览器支持和性能这些高频问题。

FAQ7 分钟

用户第一次看到基于 IR 的 schema toolkit 时,几乎都会问同样几类问题: 为什么要多一层抽象、输出结果能信到什么程度、浏览器支持和性能应该怎么看。

好的 FAQ 应该缩短这些反复沟通,而不是假装所有边角问题都已经彻底解决。

适合人群
评估用户
难度
入门
最近更新
2026年7月28日
Shape IR
先看共享 IR 为什么存在。
Loss analysis
如果想知道输出的可信边界,继续看 loss analysis。

为什么不直接做格式到格式转换?

只有当这层抽象能让长期架构更简单时,它才值得存在。而这正是这个项目的核心判断。

  • 共享 IR 可以避免 parser 和 generator 退化成一堆点对点适配器。
  • 它为 diagnostics 和后续分析层提供稳定位置。
  • 它让跨格式转换的解释成本更低。

生成结果能信到什么程度?

生成成功,表示当前路径跑通了;它不自动等价于每个语义细节都被完整保留。

这也是为什么文档会反复强调 diagnostics、已知 lossy case 和不同 route 的成熟度,而不是把生成结果包装成天然无损。

浏览器支持和性能怎么理解?

随着覆盖面增加,这一页应该继续链接到更具体的 route 说明。现阶段先帮用户快速建立合理预期更重要。

  • 浏览器支持主要影响 Web 体验和轻量试用。
  • package 集成主要影响 CI、代码生成和可重复流水线。
  • 性能问题应该按 route 和规模回答,而不是给一个统一口号。