用途：帮助在静态组件与 AI 生成界面之间做选择，并指导实现后者，适用于 generative UI、动态 UI、json-render、将 JSON 渲染为 UI 等场景。核心理念是只生成受组件目录约束的结构化 JSON，由渲染器转换为平台特定 UI，绝不写任意 JSX。
主要能力：提供按平台选择渲染器的对照，覆盖 Web（@json-render/react）、shadcn/ui（@json-render/shadcn）、MCP Apps（@json-render/mcp）、指令与数学（@json-render/directives）、开发检查器（@json-render/devtools）、移动原生（@json-render/react-native）、视频（@json-render/remotion）、HTML 邮件（@json-render/react-email）、OG/社交图（@json-render/image）、Vue（@json-render/vue）、PDF（@json-render/react-pdf）。React 场景下建议同时使用 json-render-core 与 json-render-react，显示计算加 json-render-directives，开发期加 json-render-devtools。
用法要点：实现前用 bun pm view <package> version 校验版本；已测稳定基线为 json-render 0.19.0、React 19、Zod 4、Tailwind 4，需锁定一致发行线。使用 @json-render/react 的扁平结构，root 是元素键，elements 是映射，children 数组存放键；渲染前校验每个规格，失败则重试或回退为文本。目录设计遵循少而精（起步 5-8 个组件）、显式挑选 shadcnComponentDefinitions 中的组件而非全量展开、用 Zod 定义自定义组件。权威 ID、权限与领域规则应留在应用状态或服务端，规格只决定呈现；每个流程都需可访问的纯文本兜底。细化用 patch、merge、diff 编辑模式，而非整体重生成。MCP Apps 交付时提供静态 ui:// 资源并通过工具结果传数据，同时返回有用文本。
限制：@json-render/mcp@0.19.0 只是脚手架而非完整生产边界，其辅助会把规格序列化为文本并使用宽泛 CSP。Vue 与 PDF 渲染器暂无对应技能。dither-kit 的图表与按钮颜色锁定为 7 值枚举（green/blue/purple/pink/orange/red/grey），需精确品牌色须 fork palette.ts；密集表格与文本密集界面不宜使用该抖动纹理。