Chat Ui

💬 shadcn 风格原子化聊天组件库

基于 shadcn/ui 的 React 聊天界面组件库,提供容器、消息气泡、输入框、输入指示器等原子化构建模块,支持流式响应与 AI 对话场景。

收藏
8.1k
安装
2k
版本
0.1.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Chat UI 是一套面向 React/Next.js 生态的原子化聊天界面组件库,源自 inference.sh 的 UI 体系。它提供四种核心组件:

  • ChatContainer:聊天窗口容器,负责布局与滚动管理
  • ChatMessage:消息气泡组件,支持 user/assistant/system 三种角色,自动对齐与样式区分
  • ChatInput:受控输入框,集成发送回调与禁用状态
  • TypingIndicator:流式响应时的加载指示动画

显著优点

1. 与 shadcn/ui 深度整合:复用 Tailwind CSS 设计令牌,主题切换无缝兼容
2. 原子化架构:按需引入,避免过度封装,灵活性高于全功能聊天库

3. 流式响应支持:内置加载状态与打字指示器,适配 AI 实时生成场景

4. TypeScript 完备:角色类型、事件回调均有完整类型定义

潜在局限

  • 无状态管理:需自行实现消息列表、历史记录、错误重试等逻辑
  • 无内置 API 层:不涉及 WebSocket 或 SSE 连接封装
  • 样式依赖:必须项目已配置 Tailwind CSS 与 shadcn/ui 基础组件
  • 生态锁定:组件路径硬编码 @/registry/blocks/chat,迁移成本较高

适合人群

  • 已采用 shadcn/ui 技术栈、需要快速搭建定制聊天界面的团队
  • 希望保留最大控制权、不愿引入重量级聊天 SDK 的开发者
  • 构建 AI 助手、客服机器人、文档对话等场景的前端工程师

常规风险

| 风险项 | 说明 |
|--------|------|
| 维护依赖 | 组件托管于第三方 registry,版本更新需关注 inference.sh 变动 |
| 安全审计 | 未执行独立安全扫描,生产环境建议审查源码后锁定版本 |
| SSR 兼容 | 部分动画/交互在 Next.js App Router 中需确认 hydration 一致性 |
| 可访问性 | 需自行补充 ARIA 属性与键盘导航测试 |

使用建议

推荐搭配 inference-sh/skills@agent-ui 获取完整代理组件,或与 @markdown-ui 结合实现富文本消息渲染。

Chat Ui 内容

手动下载zip · 2.8 kB
skill-card.mdtext/markdown
请选择文件