Vercel 开源跨框架界面交互库
测试版 UI SDK 将键盘导航、焦点管理、选择和拖拽等交互封装为可组合的 TypeScript 行为。开发者和代理可用同一套逻辑构建无样式组件,并通过适配器接入 React、Vue、Svelte、Solid 或 Web Components。
AI 深度解读
Vercel 推出的 UI SDK,想把组件里最难反复实现的交互逻辑拆成可组合的行为,再让开发者和 AI agent 共用这套能力。它既提供无样式组件,也让 agent 能读取组件状态、调用组件操作,不必完全依赖截图判断界面。
对前端团队,值得关注的是两件事:交互逻辑如何跨框架复用,以及组件如何向 agent 开放受控操作。不过,当前版本仍是 0.1.0-beta.1,原文介绍的是设计与能力,没有提供生产验证或效率对照数据。
把交互拆成行为,能少重复哪些工作
做一个下拉选择器,画出输入框和选项只是开始。键盘导航、焦点移动、选中状态、弹层开关,才是容易遗漏边界条件的部分。
UI SDK 把这些能力放进 @ui-sdk/core。据 Vercel 介绍,目前已有超过 50 种行为,包括 createPopup、createSelection、createTypeahead、createRovingFocus、createReorder、createResize、createViewport、createListbox、createChange、createFocusRecovery 和 createVirtualizer。
开发者通过 definePrimitive 声明组件状态、API 和槽位,再由适配器使用 createParts,将同一套原语渲染到 React、Vue、Svelte、Solid 或 Web Components。这里的原语,可以理解为组件的基础交互定义。
它要复用的是组件如何工作,外观仍由项目决定。
组件的各个部分没有预设样式,而是暴露属性和 CSS 变量。初始组件库同样超过 50 个组件,包含 Color Picker、Token Input、Command、Calendar、Tree 和 OTP Input,且五种适配器中的部件名称保持一致。
这对维护多个技术栈的设计系统有吸引力:交互逻辑可以共享,视觉层继续遵循各项目的设计规范。但原文没有证明跨框架维护成本实际降低了多少。
Agent 不只写组件,也能操作运行中的组件
UI SDK 对 agent 的支持分成开发阶段和运行阶段。
开发阶段,ui-sdk skill 引导 agent 阅读已安装包中附带的 Markdown 文档。下面的命令用于把这项 skill 加入环境:
npx skills add vercel-labs/ui --skill ui-sdk
注意 --skill ui-sdk:这一步添加的是 agent 使用 SDK 的指引,应用依赖还要单独安装。
运行阶段,应用可以从对应框架包导入 createAgent,例如 @ui-sdk/react/agent,并使用 snapshot、act 和 query。Agent 因而能查询组件状态、通过 API 执行操作,不必仅靠截图推测选中了什么、弹层是否打开。
组件向 agent 提供了可查询、可调用的交互入口。
应用仍可批准或拒绝操作。变更回调会把来源标识为 agent,并允许取消变更。如果环境提供 document.modelContext,还可以通过 registerTools,借助 WebMCP 将同样的方法暴露给浏览器集成的 agent。
不过,原文没有展开工具描述、具体接入流程,也没有给出操作成功率或延迟数据。这些能力能否改善实际任务,需要结合应用验证。
我的判断
拆分行为与视觉层,是合理且已有先例的方向。Radix UI、Base UI、React Aria、Ark UI 和 Headless UI 都提供无样式方案,其中 Ark UI 包含 Zag.js 状态机。UI SDK 值得观察的区别,是跨框架组合行为,以及直接连接 agent 的运行时接口。
shadcn/ui 则处于更上一层,它是把组件代码复制进项目的组件套件。原文明确说,Vercel 没有公布是否会用新 SDK 重建 shadcn/ui,不能把两者的未来关系当成既定路线。
采用门槛也要算进去。React 适配器要求 React 19 或更高版本;Vue、Svelte、Solid 的文档分别涉及 Vue 3.5、Svelte 5.33、Solid 2,并提到 2.0.0-rc.14,具体兼容范围还需核对。
项目以 Apache 2.0 许可和 Vercel 公开 beta 条款发布。正式可用前,API、文档和行为都可能调整。当前更适合做有边界的试验;原文没有作者实测,也没有与现有组件库的对照,尚不足以支持全面迁移。
能拿来做什么
- 在 React 19 或更高版本的试验项目中,执行
npm install @ui-sdk/react @ui-sdk/core,选一个带键盘导航和弹层的组件,验证行为组合与现有样式体系是否匹配。 - 如果团队维护多个框架版本,可以用同一个组件检查交互是否能够共享、部件名称是否方便统一维护,再决定是否扩大范围。
- 给应用接入 agent 时,可以先开放少量可撤销操作,验证
snapshot、query、act与来源为agent的变更拦截,再评估 WebMCP 接入。