能力目录

转换

浏览当前可见的转换路径,对比支持状态,并判断哪些路径已经足够可信,可以直接尝试。

能力快照

用这份快照了解当前可以尝试什么,以及哪些路径仍需要结合 diagnostics 判断。

当前可运行路径

3

Source formats

3

已记录路径

3

浏览当前可见的转换路径

对比当前支持的路径、部分支持的路径,以及运行转换前需要了解的限制。

TypeScript

从 typed source model 开始

TypeScript 目前是最清晰的一条 source 路径,适合先走通到结构化 schema 输出。

TypeScript -> JSON Schema

当前最强的一条路径,object shape 表现较好,但高级 TypeScript 语义仍有边界。

Alpha
已支持TypeScriptJSON Schema

这是当前最成熟的一条路径,适合把 interface 风格模型转成可移植的 schema 输出。

当前表现较好的部分

Interfaces 和 object shapes

Primitive fields 与 arrays

Optional properties

当前限制

更复杂的 TypeScript 语义仍会收敛成更简单的 schema 结构。

遇到不支持的构造时需要结合 diagnostics 一起看。

JSON Schema

从 schema 定义回到类型模型

JSON Schema 已经是一条真实可用的集成路径,但部分语义仍需要结合 diagnostics 细看。

JSON Schema -> TypeScript

这条 schema 双向路径已经可用,但复杂 schema 语义仍需要结合 diagnostics 审查。

Alpha
已支持JSON SchemaTypeScript

适合把 schema 定义重新转回面向 TypeScript 的模型视图。

当前表现较好的部分

Object properties 和 required fields

Primitive schema types

基础 title 与 model name

当前限制

某些 schema construct 会退化成更宽泛的 TypeScript 输出。

pattern 驱动或高度动态的 schema 场景需要额外审查。

JSON

从真实 payload 样例推断

Raw JSON 输入更适合快速探索,而不是承诺完整语义保持的正式工作流。

JSON -> TypeScript

适合快速探索式推断,但结果质量完全依赖 sample payload 的代表性。

Beta
部分支持JSONTypeScript

适合基于一段代表性 payload 快速推断出一个 typed model。

当前表现较好的部分

Primitive values

Nested objects

基于 sample payload 的 array inference

当前限制

只能转换当前观察到的 sample shape。

输入覆盖度完全取决于样例是否足够有代表性。

先突出当前最强的一条路径:TypeScript -> JSON Schema

这条路径最适合作为第一条重点 Playground context,因为它最能代表当前产品阶段下最强的一条工作流,也最符合用户直觉。

当前表现最好的部分

Interfaces 和 object shapes

Primitive fields 与 arrays

Optional properties

当前 caveats

更复杂的 TypeScript 语义仍会收敛成更简单的 schema 结构。

遇到不支持的构造时需要结合 diagnostics 一起看。

这个页面接下来会做什么

选择一条已记录的路径,先查看支持信号,再在准备好后打开对应的 Playground 流程。

先用这个页面理解路径成熟度,再进入 Playground 或后续更深入的路径说明。