先把脑内模型缩小
把这三层分清楚,文档导航会更清晰,产品后续扩展也会更顺手。
- Web app 是引导式产品体验。
- 发布后的 toolkit package 是可复用引擎。
- Shape IR 是 parser、traversal 和 generator 之间的共享契约。
文档文章
快速开始
探索时先用 playground,集成时优先使用已发布的 toolkit package。
Schema Transformation Web 是面向用户的产品层,toolkit package 则提供底层转换能力,web 先把这套能力包装成更清晰的体验。
最轻量的入口是 playground,但先建立 package 与产品层之间的关系,会让后续文档更容易理解。
把这三层分清楚,文档导航会更清晰,产品后续扩展也会更顺手。
如果你只是想验证一条转换路径,先从 playground 开始。它没有安装阻力,而且能最快展示当前支持的流程。
如果你要把转换能力集成进自己的系统,优先跟随 toolkit 仓库和发布包,而不是依赖本地 workspace link。
具体装哪些包取决于你的源格式和目标格式,但文档默认应该始终指向已发布的 release artifact。
常见的 package 起点
npm install @aio/sdk @aio/parser-typescript @aio/generator-json-schema