Repository navigation
Agent UI Lab 的首个公开版本,面向前端开发者,提供 AG-UI、A2UI 与 MCP Apps 的交互式中文学习环境和参考实现。项目使用确定性样本,无需模型密钥。
在线体验:https://likebeans.github.io/agent-ui-lab/
主要功能
- 在同一聊天中体验 AG-UI 流式事件、A2UI 声明式表单与 MCP Apps 工具应用,并查看实际协议记录。
- 提供八个独立实验,覆盖协议基础、A2UI 兼容与编辑冲突、任务恢复与事件重放、人工确认,以及活动报名联合流程。
- 支持结果未知后的事实查询、精确命令重试、版本校验与业务幂等;人工确认和联合报名可通过定位信息打开已有任务。
- A2UI 兼容实验提供一次性“提交成功后丢失响应”开关,可观察草稿、服务端事实与回执之间的区别。
- 手机导航、浅色与深色主题、键盘操作,以及保留工作区状态的文档往返与模块加载失败恢复。
- 内置中文教程、全文搜索、源码导读、预测与验证练习、独立开发作业和学习验收材料。
本地运行
需要 Node.js 22.13.0 或更新版本,推荐 Node.js 24。
git clone --branch v0.1.0 https://github.com/likebeans/agent-ui-lab.git
cd agent-ui-lab
npm ci
npm run dev默认访问 http://127.0.0.1:5173/ 。本地模式启动 HTTP / SSE 服务,并为持久实验使用 SQLite。GitHub Pages 静态版在浏览器内运行;页面内存与本地 SQLite 的恢复边界在界面和教程中有明确说明。
验证与边界
- 功能基线在 Node.js 22.13.0 与 24.22.1 下各通过 721 项测试;本地浏览器回归 101 项通过、2 项按模式跳过,Pages 回归 55 项通过、7 项按模式跳过。
- 类型检查、格式检查、普通构建和 Pages 构建均通过,发布提交由 GitHub Actions 再次验证。
- 旅行和报名均为教学样本,不产生真实预订、支付或外部业务写入。聊天采用确定性路由,尚未接入真实模型自主规划或生产鉴权。
- 已完成内部学习任务预演;真实首次读者观察尚未进行,未将内部预演计为真人学习验收。
许可证
本项目采用 MIT 许可证,版权声明为 Copyright (c) 2026 likebeans。使用、修改和分发时请保留版权与许可声明;第三方依赖遵循各自许可证。