为什么不直接做格式到格式转换?
只有当这层抽象能让长期架构更简单时,它才值得存在。而这正是这个项目的核心判断。
- 共享 IR 可以避免 parser 和 generator 退化成一堆点对点适配器。
- 它为 diagnostics 和后续分析层提供稳定位置。
- 它让跨格式转换的解释成本更低。
文档文章
常见问题
集中回答 IR、可信度、浏览器支持和性能这些高频问题。
用户第一次看到基于 IR 的 schema toolkit 时,几乎都会问同样几类问题: 为什么要多一层抽象、输出结果能信到什么程度、浏览器支持和性能应该怎么看。
好的 FAQ 应该缩短这些反复沟通,而不是假装所有边角问题都已经彻底解决。
只有当这层抽象能让长期架构更简单时,它才值得存在。而这正是这个项目的核心判断。
生成成功,表示当前路径跑通了;它不自动等价于每个语义细节都被完整保留。
这也是为什么文档会反复强调 diagnostics、已知 lossy case 和不同 route 的成熟度,而不是把生成结果包装成天然无损。
随着覆盖面增加,这一页应该继续链接到更具体的 route 说明。现阶段先帮用户快速建立合理预期更重要。