@chatui/core

中文文档
3.9.0发布于 2026/10/12MITTypeScriptESM + CJS近 30 天下载 1.1万

Chatbot UI 反应库

中文使用文档
文档目录9 节
  1. 特性
  2. 兼容环境
  3. 安装
  4. 示例
  5. 本地开发
  6. 定制主题
  7. 国际化
  8. 交流讨论
  9. License

ChatUI

服务于对话领域的设计和开发体系

官网:https://chatui.io

LICENSE NPM version NPM downloads Gzip Size Jsdelivr Hits

English | 简体中文

特性

  • 😎 最佳实践:基于阿里小蜜业务积累和打磨的对话式交互最佳实践
  • 🛡 TypeScript:使用 TypeScript 开发,提供完整的类型定义文件
  • 📱 响应式:响应式布局,在无线和 PC 端都可以友好展现
  • ♿ 障碍:支持无障碍,已通过深圳市无障碍研究会的认证
  • 🎨 主题:支持灵活的样式定制,以满足业务和品牌上多样化的视觉需求
  • 🌍 国际化:支持多语言和本土化特性

兼容环境

Edge
Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
iOS Safari
iOS Safari
Android WebView
Android WebView
16+31+49+9.1+9.3+6+

安装

npm install @chatui/core --save
yarn add @chatui/core

示例

import Chat, { Bubble, useMessages } from '@chatui/core';
import '@chatui/core/dist/index.css';

const App = () => {
  const { messages, appendMsg, setTyping } = useMessages([]);

  function handleSend(type, val) {
    if (type === 'text' && val.trim()) {
      appendMsg({
        type: 'text',
        content: { text: val },
        position: 'right',
      });

      setTyping(true);

      setTimeout(() => {
        appendMsg({
          type: 'text',
          content: { text: 'Bala bala' },
        });
      }, 1000);
    }
  }

  function renderMessageContent(msg) {
    const { content } = msg;
    return <Bubble content={content.text} />;
  }

  return (
    <Chat
      navbar={{ title: '智能助理' }}
      messages={messages}
      renderMessageContent={renderMessageContent}
      onSend={handleSend}
    />
  );
};

DEMO

本地开发

cd storybook
npm i
npm run storybook

定制主题

参考 定制主题 文档。

国际化

参考 国际化 文档。

交流讨论

License

MIT

版本与发布记录

@chatui/core 共发布 103 个版本,首次发布于 2020/09/17;过去 12 个月发布了 6 个版本。

版本发布日期距今
3.9.0latest2026/10/1228 天前
3.8.02026/05/265 个月前
3.7.02026/03/267 个月前
3.6.12026/03/167 个月前
3.6.02025/12/1610 个月前
3.5.02025/12/1110 个月前

关于 @chatui/core 的常见问题

@chatui/core 是什么?

Chatbot UI 反应库

如何安装 @chatui/core?

在项目目录运行 npm install @chatui/core,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、react-dom(>=16.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@chatui/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chatui/core 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@chatui/core 可以商用吗?

@chatui/core 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chatui/core 的下载量有多少?

根据 npm 官方下载统计,@chatui/core 在 2026/10/10 – 2026/11/08 这 30 天内被下载 10,576 次,日均约 353 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chatui/core 还在维护吗?

最新版本 3.9.0 发布于 2026/10/12(28 天前);至今共发布 103 个版本,其中过去 12 个月发布了 6 个;首次发布于 2020/09/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。