GAIA UI 组件库
为 AI 助手和聊天机器人打造的生产级 React 界面组件注册库，直接复制安装，免去从零搭建对话式界面的成本。
按维度查看评分与理由
证据显示这是一个 shadcn 风格的 UI 组件注册库，而非具有运行时权限的 Agent；无恶意行为迹象，但也没有关于权限、确认流程、数据流或敏感数据处理的设计说明，故相关项均记 1。依赖声明详尽但包含可疑的 [email protected] 占位包，且无审计或 lockfile 安全证据，dependency_security 记 1。安装过程从外部 URL 拉取代码且未说明回滚机制，均扣分。来源归属清晰（公司名、仓库、MIT），记 2。
README、package. 与 CI 工作流自洽（版本 0.3.4、changeset 流程一致），记 2。依赖均为常见活跃包，记 2，但 fs 占位包与多个未使用的间接依赖（如 @heroui/react 与文档称已弃用 HeroUI 矛盾）扣分。失败信息、错误处理完全没有展示，记 1。
目标受众（构建对话式 AI 界面的开发者）与场景说明充分，记 2。beta 状态与 API 可能变更的边界已声明，记 2。该仓库不含 Agent 触发机制，trigger_precision 记 1。适配 Next.js 15/Tailwind v4/shadcn 生态，环境说明良好，记 2。
信息架构清晰（README/REGISTRY/ROADMAP 分层），记 2。安装说明非常详细（npx、shadcn CLI、components. 配置），记 3。命名以 @heygaia/ui 为准，但 beta 阶段承诺 API 可能变化，记 2。示例主要指向外部文档站，仓库内示例少，记 2。beta 限制已声明，记 2。MIT 许可证全文齐备，记 3。使用 changesets 且有 CI 强制检查，但未见 CHANGELOG 文件本身，记 2。维护者为 The Experience Company，有 Discord/issue 渠道，记 2。
组件输出为可直接粘贴的源码（shadcn 模式），可用性合理，记 2。宣称复用生产验证组件有一定差异化价值，但与通用 shadcn 组件的边际差异未在仓库内证明，记 2。安装成本低、收益中等，记 2。
battle-tested、production-ready 等宣传性声明无仓库内证据可追溯，记 1。交叉印证仅限项目自己的站点与社交渠道，发布者身份未经核实，记 1。事实陈述（版本、许可、依赖）与推断区分清楚，记 2。
- 该仓库是 UI 组件注册库而非可执行 Agent，多数 trust 维度缺乏适用证据，不应按 Agent 安全模型解读。
- 依赖列表中的 [email protected] 是占位包，属可疑/无意义依赖，建议移除并审查整个依赖树。
- 安装命令会从 ui.heygaia.io 外部拉取并执行注册代码，供应链信任完全依赖未验证的发布者。
- 'battle-tested in production' 等声明无法在仓库内验证。
- package. 中保留 @heroui/react 与 README 宣称的迁移说法不一致，需确认是否冗余。
这个 Agent 能做什么，适合哪些场景？
GAIA UI（theexperiencecompany/gaia-ui）是 The Experience Company 开源的 UI 组件注册库，收录了 GAIA 产品在生产环境中实际使用的对话式界面组件。它采用 shadcn 注册库的分发模式，通过 npx @heygaia/ui add 命令或 shadcn CLI 将组件源码直接安装到项目中，而不是以 npm 依赖包形式引用。技术栈为 React、TypeScript、Next.js 15、Tailwind CSS v4、Radix UI 和 Framer Motion，文档站点部署在 ui.heygaia.io。项目目前处于 beta 阶段，团队正在把内部 GAIA 代码库中的组件迁移出来（用 shadcn/ui 替换 HeroUI），API 在 v1.0 之前可能变动。适合需要快速构建聊天或助手界面的前端团队，但需要接受组件尚未冻结、依赖 shadcn/ui 生态这一前提。
该仓库本身不是一个 Agent，而是面向 AI 助手/聊天界面开发的组件注册库。它提供 navbar-menu、raised-button、chat-bubble、tool-calls-section 等生产验证过的组件，开发者通过 npx @heygaia/ui add <组件名> 或 npx shadcn@latest add https://ui.heygaia.io/r/<组件名>. 将组件源码拉取到自己的项目中。安装前需用 npx shadcn@latest add button tooltip avatar dropdown-menu popover skeleton 安装 shadcn/ui 基础组件。组件以 registry/new-york/ui/ 目录下的源码形式维护，注册在 registry. 中，通过 pnpm run registry:build 构建注册库。文档站提供实时示例和 API 参考（ui.heygaia.io），贡献流程和路线图分别见 REGISTRY.md 和 ROADMAP.md。
- 正在用 React 构建聊天机器人或 AI 助手前端的团队，直接引入 chat-bubble、tool-calls-section 等对话界面组件而不用从零实现
- 已有 shadcn/ui 项目的前端开发者，想在 components. 中配置 @heygaia 命名空间后按需增量安装组件
- 对界面可访问性、响应式和性能有要求的产品团队，希望复用已在 GAIA 生产环境验证过的组件而非通用轮子
- 希望为对话式 UI 生态贡献组件的开源贡献者，按 REGISTRY.md 流程 fork 仓库、在 registry/new-york/ui/ 下新增组件并提交 PR
- 正在从 HeroUI 迁移到 shadcn/ui 的团队，可以参考其迁移实践和打包体积优化思路
这个 Agent 有哪些优点和局限？
- 组件均经 GAIA 生产环境实战验证，针对对话式 UI 的边界情况和真实场景做过打磨，而非泛用组件的简单复刻
- 采用 shadcn 注册库模式，组件源码直接进入你的代码库，可完全定制，无需维护上游 npm 依赖
- 基于 Radix UI 原语和 Tailwind CSS v4，文档宣称组件具备可访问性、响应式和高性能
- 社区活跃：提供 Discord 社区、公开路线图（ROADMAP.md）和完善的贡献指南（REGISTRY.md）
- MIT 许可证，可自由用于商业项目
如何安装或部署这个 Agent？
前置条件：Node.js 环境、shadcn CLI，以及可用的包管理器（仓库开发使用 pnpm）。步骤：
- 安装 shadcn/ui 基础组件：npx shadcn@latest add button tooltip avatar dropdown-menu popover skeleton
- 通过 GAIA 专用 CLI 添加组件：npx @heygaia/ui add navbar-menu
- 或批量添加：npx @heygaia/ui add raised-button chat-bubble tool-calls-section
- 或使用 shadcn CLI 直接指定注册库 URL：npx shadcn@latest add https://ui.heygaia.io/r/navbar-menu.
- 或在项目的 components. 中配置 {"registries":{"@heygaia":"https://ui.heygaia.io/r/{name}."}} 后使用 npx shadcn@latest add @heygaia/navbar-menu
参与贡献时：fork 仓库，运行 pnpm install 安装依赖，pnpm run dev 启动开发服务器，pnpm run registry:build 构建注册库，pnpm run type 做类型检查。
如何使用这个 Agent？
- 按上述命令将组件添加到你的 React/shadcn 项目中，组件源码会落到你的代码库里，可自由修改。2. 访问 https://ui.heygaia.io 查看每个组件的实时示例和 API 参考。3. 本地开发组件时，可用 npx shadcn@latest add http://localhost:3000/r/[组件名]. 从本地开发服务器测试。4. 遇到问题可在 Discord（discord.heygaia.io）社区求助，或在 GitHub Issues 反馈。注意：项目处于 beta，API 在 v1.0 前可能变化，升级组件时留意破坏性变更。