@zero-library/chat-agent 2.3.16 → 2.4.1

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

@@ -142,13 +142,9 @@ var init_IndexQuote = __esm({
     IndexQuote_default = ({ data, loading, message: message2 }) => {
       const [open, setOpen] = react.useState(false);
       const citation = react.useMemo(() => {
-        let citations = [];
-        try {
-          citations = JSON.parse(message2.citations);
-        } catch (e) {
-        }
+        const citations = message2.msgExtra?.citations ?? [];
         return citations?.find((item) => String(item.citationId) === String(data.citationId));
-      }, [data.citationId, message2.citations]);
+      }, [data.citationId, message2.msgExtra?.citations]);
       const onClick = () => {
         if (!citation?.citationUrl) return;
         if (common.isExternal(citation.citationUrl)) {
@@ -428,7 +424,7 @@ var createChatService = (request) => {
     return request.delete("/lolr/label/item", { id });
   };
   const labelsQuery = (params) => {
-    return request.get("/lolr/label", params);
+    return request.post("/lolr/label", params);
   };
   const labelItemsQuery = (params) => {
     return request.get("/lolr/label/item", params);
@@ -593,7 +589,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);
@@ -866,16 +862,17 @@ function createChatStore() {
       conversation.messages[conversationId].questionList = [];
     }
   };
-  const getQuestionList = async (conversationId, messageId) => {
+  const getQuestionList = async (message2) => {
+    if (message2?.msgExtra?.sug === 0) return;
     if (receiver.active.feature?.prompts === false) return;
-    const messages = conversation.messages[conversationId]?.message;
+    const messages = conversation.messages[message2.conversationId]?.message;
     if (!messages?.length) return;
     let lastMessage = messages[messages.length - 1];
-    if (!lastMessage || lastMessage.sender.type !== 3 || lastMessage.id !== messageId) return;
-    const { data } = await config.services.request.messageSuggestedQuery(messageId);
+    if (!lastMessage || lastMessage.sender.type !== 3 || lastMessage.id !== message2.id) return;
+    const { data } = await config.services.request.messageSuggestedQuery(message2.id);
     lastMessage = messages[messages.length - 1];
-    if (lastMessage.id !== messageId) return;
-    conversation.messages[conversationId].questionList = data;
+    if (lastMessage.id !== message2.id) return;
+    conversation.messages[message2.conversationId].questionList = data;
   };
   const getRecommendQuestions = async (conversationId) => {
     if (conversationId === conversation.active.id && conversation.active.member.agent?.memberId && !conversation.messages[conversationId].message.length) {
@@ -1124,16 +1121,19 @@ function createChatStore() {
       type: void 0
     };
     conversation.messages[msg.conversationId].loading = false;
-    getQuestionList(msg.conversationId, msg.id);
+    getQuestionList(messages[idx]);
   };
-  const citationCallback = (msg) => {
+  const extraMsgCallback = (msg) => {
     const messages = conversation.messages[msg.conversationId]?.message;
     const idx = findMsgIndex(msg.id, messages);
     if (idx === -1) return;
     conversation.messages[msg.conversationId].loading = true;
     messages[idx] = {
       ...messages[idx],
-      citations: msg.msgContent
+      msgExtra: {
+        ...messages[idx]?.msgExtra,
+        ...msg.msgExtra
+      }
     };
   };
   const errCallback = (msg) => {
@@ -1171,7 +1171,7 @@ function createChatStore() {
         endCallback(newMessage.data);
         break;
       case "TEXT_MESSAGE_CITATION":
-        citationCallback(newMessage.data);
+        extraMsgCallback(newMessage.data);
         break;
       case "RUN_ERROR":
         errCallback(newMessage.data);