@zero-library/chat-agent 2.3.16 → 2.4.0

package/README.md

@@ -1 +1,55 @@
-## lolr 会话
+# @zero-library/chat-agent
+
+AI 会话 UI 组件库。提供页面级聊天组件 `ChatCopilot`，并内置会话/消息编排、HTTP 服务封装、WebSocket 收消息、文件预览等能力。
+
+该文档只维护稳定信息（安装、入口、能力、开发方式）。所有具体类型/方法以源码与类型注释为准，避免文档与实现重复维护。
+
+## 安装
+
+```bash
+pnpm add @zero-library/chat-agent
+```
+
+样式（建议在应用入口引入一次）：
+
+```ts
+import '@zero-library/chat-agent/style'
+```
+
+## 快速开始
+
+```tsx
+import { ChatCopilot } from '@zero-library/chat-agent'
+import '@zero-library/chat-agent/style'
+
+export default function App() {
+  return <ChatCopilot config={{ receiverType: 3, receiverId: 'agent-001' }} services={{ http: { config: { baseURL: '/api' } } }} />
+}
+```
+
+## 能力与边界
+
+- 组件：`ChatCopilot`（主聊天 UI），以及少量通用子组件（发言框/附件/消息渲染）
+- 状态：Valtio store 统一管理会话、消息、预览等
+- HTTP：内置服务层，默认基于 `@zero-library/common` 的请求封装
+- WebSocket：支持配置主/备地址，提升可用性
+- 预览：支持 URL 文件预览与 Markdown 文本预览
+
+## 入口与结构
+
+- 对外导出入口：`src/index.ts`
+- UI：`src/ui`
+- 状态与业务编排：`src/stores`
+- 服务与类型：`src/services`
+
+## 开发
+
+```bash
+pnpm --filter=chat-agent run dev
+pnpm --filter=chat-agent run build
+```
+
+## 维护约定
+
+- README 仅描述稳定能力与使用约定，不罗列具体方法列表
+- API/类型说明以源码的类型与注释为准（例如 `src/ui/layouts/types.ts`、`src/stores/types.ts`、`src/services/*.ts`）

package/dist/index.cjs.js

@@ -593,7 +593,7 @@ function createChatStore() {
       if (file?.fileUrl) {
         window.open(file.fileUrl, "_blank");
       } else if (file?.content) {
-        console.log("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u9884\u89C8");
+        antd.message.warning("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u9884\u89C8");
       }
     }
     config.hooks?.onAfterFilePreview?.(file, preview);