API#MCP

Persona

Runtypelabs 出品的开源无框架 AI 聊天组件,TypeScript 编写 MIT 协议,GitHub 248 星,原生支持 WebMCP 工具调用。

产品资料

Commercial Suite
官方网站github.com/runtypelabs/persona
定价模式
开源免费
核查时间
2026-10-06

核心能力

  • 原生 JS 零外部框架依赖
  • WebMCP 客户端工具自动发现
  • 流式回复与语音输入输出
  • 插件系统自定义每一层 UI

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

Persona 是 Runtypelabs 开发的开源 AI 聊天 UI 组件库,用 TypeScript 写成、不依赖任何前端框架,MIT 协议开源,GitHub 仓库截至 2026-10-06 有 248 星标且最近一次提交在 10 月 4 日。npm 包名是 @runtypelabs/persona,官方把它称作”用纯 Vanilla JS 做 Agentic 前端体验”。

核心定位与用途

Persona 解决的问题是:想在任意网站或产品里嵌入一个可定制的 AI 聊天窗口,又不想为此引入 React、Vue 或某个特定框架。它直接渲染成原生 DOM,可以叠加在已有的框架应用上,也能用一个 <script> 标签接入纯静态 HTML 站点。功能上覆盖流式响应、WebMCP 页面工具发现与执行(内置用户确认机制,防止智能体未经允许就点按钮)、内置本地客户端工具、语音输入输出、多模态内容渲染、工具调用可视化、安全的 Markdown/HTML 渲染,以及分层插件系统。它支持任意带 SSE 的后端,仓库自带针对 Vercel AI SDK、OpenAI Agents SDK、LangGraph.js 等多种后端的现成适配示例。官方自己也说清楚了边界:如果已经在用 JSX 搭 AI 界面,更适合去看 Assistant UI、CopilotKit 或 Vercel AI Elements;Persona 的定位是”不想写 JSX,只想用纯 TS/JS 钩子”的场景。与同样走 MCP 路线但聚焦知识检索的 OpenCrab 不同,Persona 解决的是前端嵌入层,不涉及知识图谱或文档摄取。

适用场景

  1. 静态站点智能增强:文档站或官网插一个 <script> 标签,就能加上带流式回复的 AI 问答侧栏。
  2. 跨框架应用内副驾驶:已经用 React、Vue 搭好产品,想叠加一层聊天组件而不重构现有代码。
  3. WebMCP 工具执行场景:需要 AI 智能体安全调用页面自身暴露的操作(购物车、筛选、表单提交),且要有用户确认环节。
  4. 自定义后端编排:配套的 @runtypelabs/persona-proxy(基于 Hono)可单独部署,专门处理对话流程配置,不想把编排逻辑写进前端的团队可以直接拿来用。

上手与局限

克隆仓库后在根目录跑 pnpm dev,Vite 开发服务器会直接加载 apps/web 里 35+ 个交互演示页面,组件改动无需发布到 npm 即可生效;线上演示在 persona-chat.dev。生产项目直接 npm install @runtypelabs/persona 即可。局限:项目仍在快速迭代(10 月初还有提交),API 可能变动,正式项目接入前建议锁定版本号;WebMCP 标准本身还年轻,并非所有宿主页面都已暴露可被发现的工具,需要宿主方自己实现 WebMCP 接口才能被 Persona 调用;文档以仓库内 README 和示例为主,没有独立的完整文档站。