@tdesign-react/chat 1.1.0-alpha.7 → 1.1.0-alpha.8

package/CHANGELOG.md

@@ -5,6 +5,19 @@ toc: false
 spline: explain
 ---
 
-## 🌈 0.1.0-alpha.1 `2025-05-26`
+## 🌈 1.0.2 `2026-02-05`
+
+### 🚀 Features
+
+- `ChatEngine`: 
+  - 支持AG-UI Activity-Snapshot/Delta事件的适配，新增useAgentActivity注册hook，并增加示例 @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+  - 增加在无 UI 场景下使用 ChatEngine 事件总线机制，并增加示例 @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+  - ToolCallRender 增加错误边界处理 @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+  - AG-UI协议下几个Delta事件，支持自动初始化接收无Snapshot情况下SSE Chunk流 @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+  - Immutable JSON Patch 性能优化，并支持append操作用来追加字符串 @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+- `ChatMarkdown`: 大幅优化依赖CherryMarkdown造成的打包体积膨胀问题，**不再内置highlight代码块样式高亮**，需要业务自行引入配置 @LzhengH @carolin913 ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+- `ChatSender`: 支持readyToSend可以接管发送前校验  @LzhengH ([#4119](https://github.com/Tencent/tdesign-react/pull/4119))
+
+## 🌈 1.0.0 `2026-11-20`
 
 - Release 1st version

package/README.md

@@ -23,54 +23,108 @@ TDesign AIGC Components for React Framework
 
 # 📦 Installation
 
-```shell
-npm i @tdesign-react/chat
-```
+```bash
+# npm
+npm install @tdesign-react/chat
 
-```shell
+# yarn
 yarn add @tdesign-react/chat
-```
 
-```shell
+# pnpm
 pnpm add @tdesign-react/chat
 ```
 
-# 🔨 Usage
+**依赖要求**: React >= 18.0.0
+
+# 🔨 Quick Start
+
+## 一体化组件集成
+
+直接使用 `ChatBot` 组件，内置完整的 UI 结构和交互逻辑，适合快速集成标准聊天界面。
 
 ```tsx
 import React from 'react';
 import { ChatBot } from '@tdesign-react/chat';
 import '@tdesign-react/chat/es/style/index.js';
 
-function App() {
+export default function App() {
   return (
-    <div style={{ height: '600px' }}>
-      <ChatBot
-        chatServiceConfig={{
-          endpoint: 'https://your-api-endpoint.com/chat',
-        }}
-      />
-    </div>
+    <ChatBot
+      chatServiceConfig={{
+        endpoint: 'https://your-api-endpoint.com/chat',
+        stream: true,
+      }}
+    />
   );
 }
+```
+
+## 组合式开发
+
+通过 `useChat` Hook 自由组合 UI 组件，适合需要深度定制 UI 结构和交互逻辑的场景。
+
+```tsx
+import React from 'react';
+import { useChat, ChatList, ChatMessage, ChatSender } from '@tdesign-react/chat';
+import '@tdesign-react/chat/es/style/index.js';
 
-ReactDOM.createRoot(document.getElementById('app')).render(<App />);
+export default function CompositeChat() {
+  const { chatEngine, messages, status } = useChat({
+    chatServiceConfig: {
+      endpoint: 'https://your-api-endpoint.com/chat',
+      stream: true,
+    },
+  });
+
+  return (
+    <>
+      <ChatList>
+        {messages.map((message) => (
+          <ChatMessage key={message.id} message={message} />
+        ))}
+      </ChatList>
+      <ChatSender
+        loading={status === 'streaming'}
+        onSend={(e) => chatEngine.sendUserMessage({ prompt: e.detail.value })}
+        onStop={() => chatEngine.abortChat()}
+      />
+    </>
+  );
+}
 ```
 
-# Browser Support
+## 协议配置
 
-| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br/> IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br/>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br/>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br/>Safari |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Edge >=84                                                                                                                                                                                                        | Firefox >=83                                                                                                                                                                                                      | Chrome >=84                                                                                                                                                                                                   | Safari >=14.1                                                                                                                                                                                                 |
+支持**自定义协议**和**AG-UI 标准协议**两种模式：
 
-Read our [browser compatibility](https://github.com/Tencent/tdesign/wiki/Browser-Compatibility) for more details.
+| 场景               | 推荐协议   |
+| ------------------ | ---------- |
+| 快速集成到现有服务 | 自定义协议 |
+| 构建复杂 AI 应用   | AG-UI 协议 |
+| 多工具调用场景     | AG-UI 协议 |
 
+```javascript
+// 通过 onMessage 解析数据
+const customConfig = {
+  endpoint: '/api/chat',
+  protocol: 'agui', // 开启 AG-UI 协议，自动解析标准事件
+  onMessage: (chunk) => chunk.data,
+};
+
+```
+
+📖 [体验示例和完整文档](https://tdesign.tencent.com/react-chat/overview)
+
+# Browser Support
+
+| IE / Edge | Firefox      | Chrome      | Safari        |
+| --------- | ------------ | ----------- | ------------- |
+| Edge >=84 | Firefox >=83 | Chrome >=84 | Safari >=14.1 |
 
 # Contributing
 
 Contributing is welcome. Read [guidelines for contributing](https://github.com/Tencent/tdesign-react/blob/develop/CONTRIBUTING.md) before submitting your [Pull Request](https://github.com/Tencent/tdesign-react/pulls).
 
-
 # Feedback
 
 Create your [Github issues](https://github.com/Tencent/tdesign-react/issues) or scan the QR code below to join our user groups