ChatWidget.tsx 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611
  1. "use client";
  2. import { useCallback, useEffect, useMemo, useState } from "react";
  3. import { MessageList } from "@/components/dashboard/MessageList";
  4. import { MessageInput } from "@/components/dashboard/MessageInput";
  5. import { OnlineAgentsList, type OnlineAgent } from "./OnlineAgentsList";
  6. import { Button } from "@/components/ui/button";
  7. import { Card } from "@/components/ui/card";
  8. import {
  9. ChatWebSocketPayload,
  10. MessageItem,
  11. MessagesReadPayload,
  12. } from "@/features/agent/types";
  13. import {
  14. fetchMessages,
  15. markMessagesRead,
  16. sendMessage,
  17. UploadFileResult,
  18. } from "@/features/agent/services/messageApi";
  19. import { initVisitorConversation } from "@/features/visitor/services/conversationApi";
  20. import { fetchOnlineAgents } from "@/features/visitor/services/visitorApi";
  21. import { fetchPublicAIModels } from "@/features/agent/services/aiConfigApi";
  22. import { useWebSocket } from "@/features/agent/hooks/useWebSocket";
  23. import type { WSMessage } from "@/lib/websocket";
  24. interface ChatWidgetProps {
  25. visitorId: number;
  26. isOpen: boolean;
  27. onToggle: () => void;
  28. }
  29. function parseUserAgent(userAgent: string) {
  30. const ua = userAgent.toLowerCase();
  31. let browser = "Unknown";
  32. let os = "Unknown";
  33. if (ua.includes("edg/")) {
  34. browser = "Edge";
  35. } else if (ua.includes("chrome/")) {
  36. browser = "Chrome";
  37. } else if (ua.includes("firefox/")) {
  38. browser = "Firefox";
  39. } else if (ua.includes("safari/")) {
  40. browser = "Safari";
  41. }
  42. if (ua.includes("windows nt")) {
  43. os = "Windows";
  44. } else if (ua.includes("mac os x") || ua.includes("macintosh")) {
  45. os = "macOS";
  46. } else if (ua.includes("android")) {
  47. os = "Android";
  48. } else if (ua.includes("iphone") || ua.includes("ipad")) {
  49. os = "iOS";
  50. } else if (ua.includes("linux")) {
  51. os = "Linux";
  52. }
  53. return { browser, os };
  54. }
  55. /**
  56. * 聊天小窗组件
  57. * 提供小窗形式的聊天界面,支持展开/收起
  58. */
  59. export function ChatWidget({ visitorId, isOpen, onToggle }: ChatWidgetProps) {
  60. // ===== 状态管理 =====
  61. const [conversationId, setConversationId] = useState<number | null>(null);
  62. const [conversationStatus, setConversationStatus] = useState<string>("open");
  63. const [messages, setMessages] = useState<MessageItem[]>([]);
  64. const [loadingMessages, setLoadingMessages] = useState(true);
  65. const [sending, setSending] = useState(false);
  66. const [input, setInput] = useState("");
  67. const [chatMode, setChatMode] = useState<"human" | "ai">("human");
  68. const [initializing, setInitializing] = useState(false);
  69. const [selectedAIConfigId, setSelectedAIConfigId] = useState<
  70. number | undefined
  71. >(undefined);
  72. const [aiModels, setAiModels] = useState<
  73. Array<{ id: number; provider: string; model: string }>
  74. >([]);
  75. const [onlineAgents, setOnlineAgents] = useState<OnlineAgent[]>([]);
  76. const [loadingAgents, setLoadingAgents] = useState(false);
  77. const noopHighlight = useCallback(() => {}, []);
  78. // 加载在线客服列表
  79. const loadOnlineAgents = useCallback(async () => {
  80. setLoadingAgents(true);
  81. try {
  82. const agents = await fetchOnlineAgents();
  83. setOnlineAgents(agents);
  84. } catch (error) {
  85. console.error("加载在线客服列表失败:", error);
  86. } finally {
  87. setLoadingAgents(false);
  88. }
  89. }, []);
  90. // 当小窗打开时,加载在线客服列表
  91. useEffect(() => {
  92. if (isOpen) {
  93. loadOnlineAgents();
  94. // 定期刷新在线客服列表(每30秒)
  95. const interval = setInterval(loadOnlineAgents, 30000);
  96. return () => clearInterval(interval);
  97. }
  98. }, [isOpen, loadOnlineAgents]);
  99. // 加载开放的 AI 模型列表
  100. useEffect(() => {
  101. async function loadModels() {
  102. try {
  103. const models = await fetchPublicAIModels("text");
  104. setAiModels(models);
  105. if (models.length > 0) {
  106. setSelectedAIConfigId(models[0].id);
  107. }
  108. } catch (error) {
  109. console.error("加载 AI 模型列表失败:", error);
  110. }
  111. }
  112. loadModels();
  113. }, []);
  114. // 创建或恢复访客会话
  115. const initializeConversation = useCallback(
  116. async (id: number, mode: "human" | "ai", aiConfigId?: number) => {
  117. setInitializing(true);
  118. try {
  119. const { browser, os } = parseUserAgent(navigator.userAgent);
  120. const language =
  121. navigator.language ||
  122. (navigator.languages && navigator.languages[0]) ||
  123. "";
  124. const result = await initVisitorConversation({
  125. visitorId: id,
  126. website: window.location.href,
  127. referrer: document.referrer || "",
  128. browser,
  129. os,
  130. language,
  131. chatMode: mode,
  132. aiConfigId,
  133. });
  134. if (result.conversation_id) {
  135. setConversationId(result.conversation_id);
  136. setConversationStatus(result.status);
  137. setChatMode(mode);
  138. }
  139. } catch (error) {
  140. console.error("初始化对话失败:", error);
  141. alert("初始化对话失败,请重试");
  142. } finally {
  143. setInitializing(false);
  144. }
  145. },
  146. []
  147. );
  148. // 初始化默认对话(人工模式)
  149. useEffect(() => {
  150. if (visitorId !== null && !conversationId && !initializing && isOpen) {
  151. initializeConversation(visitorId, "human");
  152. }
  153. }, [visitorId, conversationId, initializing, isOpen, initializeConversation]);
  154. // 处理模式切换
  155. const handleModeSwitch = useCallback(
  156. (mode: "human" | "ai") => {
  157. if (visitorId === null || initializing) {
  158. return;
  159. }
  160. if (mode === "ai" && !selectedAIConfigId) {
  161. alert("请先选择一个 AI 模型");
  162. return;
  163. }
  164. initializeConversation(
  165. visitorId,
  166. mode,
  167. mode === "ai" ? selectedAIConfigId : undefined
  168. );
  169. },
  170. [visitorId, initializing, selectedAIConfigId, initializeConversation]
  171. );
  172. // 标记客服消息已读
  173. const handleMarkAgentMessagesRead = useCallback(
  174. async (conversationIdParam?: number, readerIsAgentParam?: boolean) => {
  175. const targetConversationId = conversationIdParam ?? conversationId;
  176. const targetReaderIsAgent = readerIsAgentParam ?? false;
  177. if (!targetConversationId) {
  178. return;
  179. }
  180. const result = await markMessagesRead(
  181. targetConversationId,
  182. targetReaderIsAgent
  183. );
  184. if (!result || result.message_ids.length === 0) {
  185. return;
  186. }
  187. const idSet = new Set(result.message_ids);
  188. setMessages((prev) =>
  189. prev.map((msg) =>
  190. idSet.has(msg.id)
  191. ? {
  192. ...msg,
  193. is_read: true,
  194. read_at: result.read_at ?? msg.read_at ?? null,
  195. }
  196. : msg
  197. )
  198. );
  199. },
  200. [conversationId]
  201. );
  202. // 拉取历史消息
  203. const loadMessages = useCallback(async () => {
  204. if (!conversationId) {
  205. return;
  206. }
  207. setLoadingMessages(true);
  208. try {
  209. const data = await fetchMessages(conversationId);
  210. const normalizedMessages = data.map((msg) => ({
  211. ...msg,
  212. is_read: msg.is_read ?? false,
  213. read_at: msg.read_at ?? null,
  214. }));
  215. // 刷新消息列表时,移除所有临时消息(ID 大于 1000000000000 的消息是临时消息)
  216. // 临时消息使用 Date.now() 作为 ID,真实消息的 ID 通常较小
  217. setMessages(normalizedMessages);
  218. } catch (error) {
  219. console.error("拉取消息失败:", error);
  220. } finally {
  221. setLoadingMessages(false);
  222. }
  223. }, [conversationId]);
  224. useEffect(() => {
  225. if (isOpen && conversationId) {
  226. loadMessages();
  227. }
  228. }, [isOpen, conversationId, loadMessages]);
  229. // 收到新消息时更新状态
  230. const handleNewMessage = useCallback(
  231. (message: MessageItem) => {
  232. if (!conversationId || message.conversation_id !== conversationId) {
  233. return;
  234. }
  235. setMessages((prev) => {
  236. // 检查是否已存在相同ID的消息(真实消息)
  237. const exists = prev.some((item) => item.id === message.id);
  238. if (exists) {
  239. // 更新已存在的消息,确保创建新数组引用
  240. const updated = prev.map((msg) =>
  241. msg.id === message.id
  242. ? {
  243. ...msg,
  244. ...message,
  245. is_read: message.is_read ?? msg.is_read ?? false,
  246. read_at: message.read_at ?? msg.read_at ?? null,
  247. }
  248. : msg
  249. );
  250. // 检查是否有实际变化,如果没有变化也返回新数组引用
  251. const hasChange = updated.some((msg, idx) => {
  252. const oldMsg = prev[idx];
  253. return !oldMsg || msg.id !== oldMsg.id || JSON.stringify(msg) !== JSON.stringify(oldMsg);
  254. });
  255. if (!hasChange) {
  256. return [...updated]; // 强制创建新数组引用
  257. }
  258. return updated;
  259. }
  260. // 如果是访客自己发送的消息(sender_is_agent = false),移除对应的临时消息
  261. // 临时消息的 ID 是 Date.now(),通常大于 1000000000000
  262. // 真实消息的 ID 通常较小
  263. const isVisitorMessage = !message.sender_is_agent;
  264. if (isVisitorMessage) {
  265. // 移除所有临时消息(ID 大于 1000000000000)和已存在的相同真实消息(如果有)
  266. // 这样可以避免临时消息和真实消息重复显示
  267. const filteredPrev = prev.filter((msg) =>
  268. msg.id < 1000000000000 && msg.id !== message.id
  269. );
  270. // 检查过滤后的数组和原数组是否不同,或者消息ID是否变化
  271. const hasTempMessage = prev.some((msg) => msg.id >= 1000000000000);
  272. const hasSameMessage = prev.some((msg) => msg.id === message.id);
  273. // 如果列表没有变化(没有临时消息需要移除,且消息已存在),仍然创建新数组引用
  274. if (!hasTempMessage && hasSameMessage) {
  275. // 即使没有变化,也创建新数组引用,确保 React 检测到变化
  276. return [...prev];
  277. }
  278. // 确保新消息不在列表中,然后添加
  279. // 检查过滤后的列表是否已包含该消息
  280. const alreadyInFiltered = filteredPrev.some((msg) => msg.id === message.id);
  281. if (alreadyInFiltered) {
  282. // 即使已存在,也创建新数组引用以确保渲染
  283. return [...filteredPrev];
  284. }
  285. const newMessages = [
  286. ...filteredPrev,
  287. {
  288. ...message,
  289. is_read: message.is_read ?? false,
  290. },
  291. ];
  292. // 强制创建新数组引用,确保 React 检测到变化
  293. return newMessages;
  294. }
  295. // 其他消息(客服发送的)直接添加
  296. // 检查是否已存在,避免重复添加
  297. const alreadyExists = prev.some((msg) => msg.id === message.id);
  298. if (alreadyExists) {
  299. // 即使消息已存在,也创建新数组引用,确保 React 检测到变化
  300. return [...prev];
  301. }
  302. const newMessages = [
  303. ...prev,
  304. {
  305. ...message,
  306. is_read: message.is_read ?? false,
  307. },
  308. ];
  309. // 强制创建新数组引用,确保 React 检测到变化
  310. return newMessages;
  311. });
  312. },
  313. [conversationId]
  314. );
  315. // 处理 WebSocket 的已读事件
  316. const handleMessagesReadEvent = useCallback(
  317. (payload: MessagesReadPayload) => {
  318. if (!conversationId) {
  319. return;
  320. }
  321. const payloadConversationId = payload?.conversation_id;
  322. if (payloadConversationId && payloadConversationId !== conversationId) {
  323. return;
  324. }
  325. if (payload?.reader_is_agent !== true) {
  326. return;
  327. }
  328. const ids = Array.isArray(payload?.message_ids)
  329. ? payload.message_ids
  330. : [];
  331. if (ids.length === 0) {
  332. return;
  333. }
  334. const idSet = new Set(ids);
  335. const readAt = payload?.read_at;
  336. setMessages((prev) =>
  337. prev.map((msg) =>
  338. idSet.has(msg.id) && !msg.sender_is_agent
  339. ? {
  340. ...msg,
  341. is_read: true,
  342. read_at: readAt ?? msg.read_at ?? null,
  343. }
  344. : msg
  345. )
  346. );
  347. },
  348. [conversationId]
  349. );
  350. const handleWebSocketMessage = useCallback(
  351. (event: WSMessage<ChatWebSocketPayload>) => {
  352. if (!event) {
  353. return;
  354. }
  355. if (event.type === "new_message" && event.data) {
  356. handleNewMessage(event.data as MessageItem);
  357. } else if (event.type === "messages_read") {
  358. const payload = event.data as MessagesReadPayload;
  359. if (!payload.conversation_id && event.conversation_id) {
  360. payload.conversation_id = event.conversation_id;
  361. }
  362. handleMessagesReadEvent(payload);
  363. }
  364. },
  365. [handleMessagesReadEvent, handleNewMessage]
  366. );
  367. useWebSocket<ChatWebSocketPayload>({
  368. conversationId,
  369. enabled: Boolean(conversationId) && isOpen,
  370. isVisitor: true,
  371. onMessage: handleWebSocketMessage,
  372. onError: (error) => {
  373. console.error("WebSocket 连接错误(访客端):", error);
  374. },
  375. });
  376. const handleSendMessage = useCallback(
  377. async (fileInfo?: UploadFileResult) => {
  378. if (!conversationId || sending) {
  379. return;
  380. }
  381. if (!input.trim() && !fileInfo) {
  382. return;
  383. }
  384. const messageContent = input.trim();
  385. // 乐观更新:立即将消息添加到本地状态(临时消息,稍后会被服务器返回的真实消息替换)
  386. const tempMessage: MessageItem = {
  387. id: Date.now(), // 临时ID,发送成功后会被真实ID替换
  388. conversation_id: conversationId,
  389. content: messageContent,
  390. sender_id: visitorId || 0,
  391. sender_is_agent: false,
  392. message_type: fileInfo?.file_type === "image" ? "image" : fileInfo?.file_type === "document" ? "document" : "text",
  393. is_read: false,
  394. read_at: null,
  395. created_at: new Date().toISOString(),
  396. file_url: fileInfo?.file_url || null,
  397. file_name: fileInfo?.file_name || null,
  398. file_size: fileInfo?.file_size || null,
  399. mime_type: fileInfo?.mime_type || null,
  400. chat_mode: chatMode,
  401. };
  402. // 立即添加到消息列表
  403. setMessages((prev) => [...prev, tempMessage]);
  404. setInput("");
  405. setSending(true);
  406. try {
  407. await sendMessage({
  408. conversationId,
  409. content: messageContent,
  410. senderIsAgent: false,
  411. fileUrl: fileInfo?.file_url,
  412. fileType: fileInfo?.file_type as "image" | "document" | undefined,
  413. fileName: fileInfo?.file_name,
  414. fileSize: fileInfo?.file_size,
  415. mimeType: fileInfo?.mime_type,
  416. });
  417. // 不在这里调用 loadMessages,完全依赖 WebSocket 来接收新消息
  418. // WebSocket 会收到服务器广播的消息,包括自己发送的消息
  419. // 这样可以避免 loadMessages 覆盖 WebSocket 的更新
  420. } catch (error) {
  421. // 发送失败,移除临时消息
  422. setMessages((prev) => prev.filter((msg) => msg.id !== tempMessage.id));
  423. console.error("❌ 发送消息失败:", error);
  424. alert((error as Error).message || "发送消息失败,请稍后重试");
  425. // 恢复输入内容
  426. setInput(messageContent);
  427. } finally {
  428. setSending(false);
  429. }
  430. },
  431. [conversationId, input, sending, visitorId, chatMode]
  432. );
  433. // 如果不打开,不渲染内容
  434. if (!isOpen) {
  435. return null;
  436. }
  437. return (
  438. <Card className="fixed bottom-20 right-4 sm:bottom-24 sm:right-6 w-[calc(100vw-2rem)] max-w-[400px] h-[500px] sm:w-[400px] sm:max-w-none sm:h-[600px] md:w-[480px] md:h-[700px] flex flex-col shadow-2xl z-40 border border-border/50 overflow-hidden rounded-2xl bg-background backdrop-blur-sm ring-1 ring-black/5">
  439. {/* 头部:标题和关闭按钮 - 使用渐变背景 */}
  440. <div className="bg-gradient-to-r from-primary to-primary/80 border-b border-primary/20 p-4 flex items-center justify-between rounded-t-2xl">
  441. <div className="flex items-center gap-2">
  442. <div className="w-8 h-8 rounded-lg bg-white/20 backdrop-blur-sm flex items-center justify-center">
  443. <svg
  444. className="w-5 h-5 text-white"
  445. fill="none"
  446. stroke="currentColor"
  447. viewBox="0 0 24 24"
  448. >
  449. <path
  450. strokeLinecap="round"
  451. strokeLinejoin="round"
  452. strokeWidth={2}
  453. d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"
  454. />
  455. </svg>
  456. </div>
  457. <h2 className="text-lg font-bold text-white">客服聊天</h2>
  458. </div>
  459. <Button
  460. variant="ghost"
  461. size="sm"
  462. onClick={onToggle}
  463. className="text-white hover:bg-white/20 h-8 w-8 p-0 rounded-lg transition-colors"
  464. aria-label="关闭聊天"
  465. >
  466. <svg
  467. className="w-5 h-5"
  468. fill="none"
  469. stroke="currentColor"
  470. viewBox="0 0 24 24"
  471. >
  472. <path
  473. strokeLinecap="round"
  474. strokeLinejoin="round"
  475. strokeWidth={2}
  476. d="M6 18L18 6M6 6l12 12"
  477. />
  478. </svg>
  479. </Button>
  480. </div>
  481. {/* 模式切换和在线客服列表 */}
  482. <div className="p-4 border-b bg-gradient-to-b from-muted/50 to-background">
  483. {/* 模式切换按钮 */}
  484. <div className="flex items-center gap-2 mb-3 justify-center">
  485. <Button
  486. variant={chatMode === "human" ? "default" : "outline"}
  487. size="sm"
  488. onClick={() => handleModeSwitch("human")}
  489. disabled={initializing}
  490. className={
  491. chatMode === "human"
  492. ? "bg-primary text-primary-foreground shadow-md hover:shadow-lg transition-shadow"
  493. : "hover:bg-muted border-border"
  494. }
  495. >
  496. 人工客服
  497. </Button>
  498. <Button
  499. variant={chatMode === "ai" ? "default" : "outline"}
  500. size="sm"
  501. onClick={() => handleModeSwitch("ai")}
  502. disabled={initializing || aiModels.length === 0 || !selectedAIConfigId}
  503. className={
  504. chatMode === "ai"
  505. ? "bg-primary text-primary-foreground shadow-md hover:shadow-lg transition-shadow"
  506. : "hover:bg-muted border-border"
  507. }
  508. >
  509. AI 客服
  510. </Button>
  511. </div>
  512. {/* AI 模型选择下拉框(仅 AI 模式显示) */}
  513. {aiModels.length > 0 && chatMode === "ai" && (
  514. <div className="flex justify-center mb-3">
  515. <select
  516. value={selectedAIConfigId || ""}
  517. onChange={(e) => {
  518. const configId = Number(e.target.value);
  519. setSelectedAIConfigId(configId);
  520. if (visitorId) {
  521. initializeConversation(visitorId, "ai", configId);
  522. }
  523. }}
  524. disabled={initializing}
  525. className="px-3 py-1.5 text-xs rounded-md border border-border bg-background hover:border-primary/50 focus:outline-none focus:ring-2 focus:ring-primary/20 transition-colors"
  526. >
  527. {aiModels.map((model) => (
  528. <option key={model.id} value={model.id}>
  529. {model.provider} - {model.model}
  530. </option>
  531. ))}
  532. </select>
  533. </div>
  534. )}
  535. {/* 在线客服列表(仅人工模式显示) */}
  536. {chatMode === "human" && (
  537. <OnlineAgentsList
  538. agents={onlineAgents}
  539. onAgentClick={(agent) => {
  540. // 点击客服可以切换对话(如果需要的话)
  541. }}
  542. />
  543. )}
  544. </div>
  545. {/* 消息列表 */}
  546. <div className="flex-1 overflow-hidden min-h-0 bg-gradient-to-b from-background to-muted/20">
  547. <MessageList
  548. key={`messages-${conversationId}`} // 简化 key,只使用 conversationId,避免不必要的重新挂载
  549. messages={messages}
  550. loading={loadingMessages}
  551. highlightKeyword=""
  552. onHighlightClear={noopHighlight}
  553. currentUserIsAgent={false}
  554. disableAutoScroll={false}
  555. conversationId={conversationId}
  556. onMarkMessagesRead={handleMarkAgentMessagesRead}
  557. />
  558. </div>
  559. {/* 消息输入框 */}
  560. <div className="border-t border-border/50 bg-background rounded-b-2xl">
  561. <MessageInput
  562. value={input}
  563. onChange={setInput}
  564. onSubmit={handleSendMessage}
  565. sending={sending}
  566. conversationId={conversationId ?? undefined}
  567. />
  568. </div>
  569. </Card>
  570. );
  571. }