文章Shape IRProduct note

为什么 Shape IR 是多格式转换的核心

共享中间表示让不断增长的 parser 与 generator 组合变得可检查、可诊断,也更容易扩展。

2026年7月28日 · 6 min

为什么 Shape IR 是多格式转换的核心

直接编写格式到格式的适配器一开始很有吸引力,但格式越来越多以后,每条适配路径都会带着自己的假设,组合数量也会快速增长。

一个语义中心

Shape IR 为对象、字段、联合类型、引用和约束提供共享词汇。parser 可以专注于提取语义,generator 则专注于用目标格式表达这些语义,而不用了解所有输入格式。

诊断应该和输出一起存在

转换不只是成功或失败。某条路线可能保留了整体结构,却丢失了某个约束或缩窄了联合类型。把 diagnostics 放在同一条流水线里,才能让审阅生成结果的人看到这些取舍。

支持自动发现

当 parser 和 generator 通过 SDK registry 注册能力后,web 产品就可以从 SDK 发现可执行组合,而不需要维护第二份手写矩阵。这让架构和产品界面能够一起演进。

相关链接