开发工具#AI 生成

json-render:让 AI 按开发者的组件目录生成界面

json-render 是面向开发者的生成式 UI 框架:用 Zod 定义组件目录,让模型返回受约束的 JSON,再渲染为 Web、移动端、视频和文档界面。

项目资料

GitHub Ecosystem
仓库地址github.com/vercel-labs/json-render
许可证
Apache-2.0
主语言
TypeScript
星标
19,572
核查时间
2026-11-12

以上快照资料以核查当日为准,可能随版本或运营策略变化。

让模型在助手或产品功能里返回界面,难点通常不在把 JSON 画出来,而在决定它能用哪些组件、能填哪些属性,以及控件能触发哪些操作。我用 @json-render/core 与 @json-render/react 0.22.0 在临时项目里测试了 json-render 的这些边界:照抄 README 的目录示例,定义三个组件,然后在服务端渲染一个三元素规格。输出正是我定义的 Card、Metric 与 Button 结构。把其中一个元素改成目录里没有定义的 Chart 类型后,catalog.validate 以枚举错误拒绝了这份规格。

json-render 是 Vercel Labs 的生成式 UI 框架。开发者用 Zod 定义组件目录,模型按目录返回结构化 JSON,渲染器再把每个节点映射到应用里的真实组件。GitHub API 在 2026 年 11 月 12 日显示它有 19,572 颗星。测试中唯一的麻烦出在快速上手:裸的 <Renderer> 会抛出 useVisibility must be used within a VisibilityProvider,用 JSONUIProvider 包住组件树后才正常。

核心功能

  • 组件目录由开发者定义:defineCatalog 声明模型可用的组件、属性、操作与数据绑定;属性和 action 参数可用 Zod schema 描述。测试中,引用未定义组件类型的规格在校验阶段就失败了。新增一种界面行为,要先定义再实现。
  • JSON 规格映射到真实组件:模型返回的是 UI spec,而不是可直接执行的任意前端代码。应用的 registry 把每种组件类型对应到自己的 React、Vue、Svelte 或 SolidJS 实现。我只测试了 React 路径。
  • 支持流式生成:README 把渐进式渲染列为能力,模型返回内容时界面可以逐步出现,控件触发的行为也由应用提供。我没有测试流式输出。
  • 渲染目标不止 Web:README 的包清单包括 React、Vue 3、Svelte 5、SolidJS、React Native、Remotion 视频、PDF、HTML 邮件、Ink 终端和 React Three Fiber 3D 场景。各 renderer 的文档深浅不一,选用前要看对应包的指南。
  • 带有 shadcn/ui 组件包:README 称 @json-render/shadcn 提供 36 个基于 Radix UI 与 Tailwind CSS 的预制组件。我安装后,@json-render/shadcn/catalog 导出了 36 个组件定义。它们是可纳入目录的现成选项,并不替产品决定应暴露哪些控件。
  • Code Export 是可定制的代码生成:官方 Code Export 指南示范如何用 @json-render/codegen 根据 UI spec 生成独立的 Next.js 项目文件,导出的组件不依赖 json-render 运行时。我没有运行生成器。生成器要由项目自己编写,因此这不是对任意规格的一键转换承诺。
json-render 的目标README 列出的 renderer
WebReact、Vue 3、Svelte 5、SolidJS
移动、视频与 3DReact Native、Remotion、React Three Fiber
文档与终端React PDF、React Email、Ink

把它理解成“按自家组件目录组装 UI”更准确:如果某个组件、属性或 action 不在目录里,模型就没有受支持的路径去生成它。想先用文字自由试画界面并导出代码,也可看 OpenUI;两者主要区别在于 json-render 把产品自己的组件边界作为运行时约束。

典型使用场景

  • 给 AI 助手加产品内界面:开发者可以让模型依照已登记的组件和属性拼出表单、卡片或仪表盘,再把用户操作交给应用定义的 actions。团队需要逐项确定允许出现的组件和动作,而不是把任意代码交给模型执行。
  • 同一份界面规格面向多个终端:如果产品已有 React Web 界面,也要为移动端、PDF 报告或邮件生成内容,可以评估对应 renderer 是否覆盖所需控件和交互。README 列出多个目标包,但并不意味着每种目标具有完全相同的功能。
  • 把界面生成纳入现有设计系统:目录可复用团队实现的组件和属性约束,输出结果因此有机会沿用现有视觉与交互部件。组件本身如何设计、权限如何控制,仍由应用团队负责。
  • 需要把规格导出成项目代码:Code Export 指南适合愿意自己维护生成器的团队;若期望现成的通用一键代码导出器,文档没有作这样的承诺。

快速上手

README 给出的 React 安装命令是:

npm install @json-render/core @json-render/react

之后按 README 的 Quick Start 定义 Zod 目录和组件 registry,再把 JSON spec 交给 Renderer。我的服务端测试中,裸的 <Renderer> 会报错,包上 JSONUIProvider 后才正常,这与 README 状态示例中的写法一致(<JSONUIProvider initialState={{}}>)。接入时应从这个包装开始。模型调用和实际组件实现仍由应用负责。

小结

json-render 适合希望让 AI 生成产品内 UI、同时由开发者限定可用组件与操作的前端团队。它不是替你设计完整产品的无代码工具:组件目录越窄,模型能组合的界面越有限;目录之外的组件和业务行为需要团队自己补齐。项目以 TypeScript 编写。GitHub API 在 2026 年 11 月 12 日报告 Apache-2.0 许可、19,572 颗星;仓库未归档,最近推送时间为 2026 年 11 月 10 日。

我的测试覆盖了服务端 React 渲染、目录校验和 shadcn 导出数量。Vue、Svelte、React Native、Remotion、PDF、邮件、3D 与 Next.js 目标、流式输出以及 Code Export 都没有测试。Zod schema 描述规格结构;应用仍需提供真实组件、校验模型输出,并为每个 action 实现权限和副作用控制。目录收窄了模型能生成的界面,却不能替代应用自身的授权逻辑。模型服务、提示设计和数据授权仍由宿主应用决定,只安装 React 包不能得到完整的 AI 产品。