Recipe：从 OpenAPI component schema 到 Zod

先从一个小型 component 开始，而不是直接转换完整文档。这样生成代码更容易阅读，路线限制也更容易定位。

操作流程

1. 选择 OpenAPI 作为 source，选择 Zod 作为 target。
2. 选择 component entry point，避免无关路径干扰当前 schema。
3. 运行转换，同时查看 Shape IR、输出和 diagnostics。

需要检查什么

重点检查对象的 optional、nullable 字段、联合类型和被引用的 component。转换成功只说明路线完成，并不代表所有 OpenAPI 注解都有直接的 Zod 对应物。

路线目录和 Playground 彼此相连，可以用它们对照当前支持范围和生成代码。