@gientech/modual 2.2.3-fix.6 → 2.2.3-fix.7

package/doc_assets/images/component-screenshot.png

@@ -1 +0,0 @@
-

package/doc_assets//346/226/271/346/241/210/v2.0.7/345/217/230/346/233/264/346/200/273/347/273/223.md

@@ -1,115 +0,0 @@
-# AIChat v2.0.0 变更总结
-
-> 📅 **版本**: v2.0.0  
-> 🎯 **类型**: Major（主版本升级）
-
-## 📊 变更统计
-
-### 删除的文件和目录
-
-| 目录/文件 | 说明 | 迁移位置 |
-|----------|------|----------|
-| `src/LoginPage/` | 登录/注册页面组件 | `gientech/src/modules/login/` 或 `web/src/shared/login/` |
-| `src/servers/` | 业务 API 调用层 | 业务项目的 API 层 |
-| `src/adopters/` | 业务适配器组件 | 业务项目的组件目录 |
-| `src/core/` | 旧的核心组件目录 | 已统一到 `src/components/` |
-
-### 新增的文件
-
-| 文件 | 说明 |
-|------|------|
-| `src/utils/fileIcon.tsx` | 文件类型图标工具函数 |
-| `doc_assets/更新说明/v2.0.0升级指南.md` | v2.0.0 升级指南文档 |
-| `doc_assets/更新说明/v2.0.0变更总结.md` | 本文档 |
-
-### 修改的文件
-
-| 文件 | 变更内容 |
-|------|----------|
-| `package.json` | 版本号更新到 2.0.0 |
-| `src/lib_enter.ts` | 移除业务适配器的导出 |
-| `src/components/Sender/FilesDisplay.tsx` | 使用新的 `fileIcon` 工具函数 |
-| `src/components/Sender/FileUpload.tsx` | 使用新的 `fileIcon` 工具函数 |
-| `README.md` | 更新项目结构说明，添加 v2.0.0 说明 |
-| `doc_assets/更新说明/CHANGELOG.md` | 添加 v2.0.0 版本说明 |
-
-## 🎯 核心变更
-
-### 1. 架构简化
-
-**变更前**：
-- 存在 `core/` 和 `components/` 两个组件目录
-- 业务层代码和 UI 组件库代码混合
-- 组件依赖关系复杂
-
-**变更后**：
-- 统一组件目录到 `components/`
-- 完全移除业务层代码
-- 简化组件依赖关系
-
-### 2. 职责明确
-
-**变更前**：
-- UI 组件库包含业务逻辑
-- 业务适配器和核心组件混合
-
-**变更后**：
-- UI 组件库专注于展示层
-- 业务逻辑完全分离到业务项目
-
-### 3. 工具函数提取
-
-**新增功能**：
-- `getFileTypeIcon()` 函数：统一的文件类型图标获取
-- 支持主题配置自定义图标
-- 提供默认图标兜底
-
-## 📦 包大小影响
-
-移除业务层代码后：
-- **减少包体积**：移除不必要的业务代码
-- **提升加载速度**：减少依赖和代码量
-- **更清晰的职责**：专注于 UI 组件功能
-
-## 🔄 兼容性
-
-### 破坏性变更
-
-- ❌ 移除了 `LoginPage` 组件
-- ❌ 移除了 `servers` API 调用层
-- ❌ 移除了 `adopters` 业务适配器
-- ❌ 移除了 `core` 目录
-
-### 保持兼容
-
-- ✅ `AiChat` 核心组件 API 保持不变
-- ✅ 事件系统保持不变
-- ✅ 主题配置保持不变
-- ✅ 样式文件路径保持不变
-
-## 📝 迁移检查清单
-
-升级到 v2.0.0 前，请检查：
-
-- [ ] 项目中是否使用了 `LoginPage` 组件
-- [ ] 项目中是否使用了 `servers/` 下的 API
-- [ ] 项目中是否使用了 `adopters/` 下的组件
-- [ ] 项目中是否使用了 `core/` 目录下的组件
-- [ ] 是否已准备好迁移业务层代码到业务项目
-
-## 🎉 升级收益
-
-1. **更清晰的架构**：UI 组件库和业务逻辑分离
-2. **更小的包体积**：移除不必要的业务代码
-3. **更好的维护性**：组件结构统一，依赖关系简化
-4. **更强的扩展性**：业务层可以独立演进
-
-## 📚 相关文档
-
-- [v2.0.0 升级指南](./v2.0.0升级指南.md) - 详细的升级步骤和迁移指南
-- [CHANGELOG.md](./CHANGELOG.md) - 完整的更新日志
-- [AiChat API](../接口/AiChat.md) - API 文档
-
----
-
-> 💡 **提示**：建议在升级前仔细阅读 [v2.0.0 升级指南](./v2.0.0升级指南.md)，确保了解所有变更和迁移步骤。

package/doc_assets//346/226/271/346/241/210//344/274/230/345/214/226/346/226/271/346/241/210-/345/244/232/344/274/232/350/257/235SSE/350/277/236/346/216/245/347/256/241/347/220/206.md

@@ -1,504 +0,0 @@
-# 优化方案：多会话 SSE 连接管理
-
-## 📋 文档信息
-
-- **创建日期**: 2025-01-XX
-- **方案状态**: 待实施
-- **优先级**: 中
-- **预计工作量**: 2-3 天
-
----
-
-## 🎯 问题描述
-
-### 当前问题
-
-1. **数据错位问题**：当一个对话发起请求后，在流式输出还没有开始的时候，如果用户切换历史聊天栏 item，输出的内容会直接打到切换到的历史聊天页面上。
-
-2. **用户体验问题**：
-   - 切换会话时会中断正在进行的流式输出
-   - 切换回来无法看到完整的输出内容
-   - 无法支持多会话并发处理
-
-### 当前方案
-
-- ✅ 已实现：流输出时禁止切换历史聊天
-- ✅ 已实现：切换会话时取消正在进行的流式请求（快速修复方案）
-
-### 当前方案的局限性
-
-- ❌ 切换会话会中断输出，用户无法继续查看
-- ❌ 无法支持多会话并发处理
-- ❌ 数据路由依赖 `activeSessionId`，存在时序问题
-
----
-
-## 💡 优化方案设计
-
-### 核心目标
-
-1. **每个对话维护自己的 SSE 连接**
-2. **切换回来还可以继续输出**
-3. **切换走不会错误把输出打到别的对话**
-
-### 方案架构
-
-```
-┌─────────────────────────────────────────────────────────┐
-│             多会话 SSE 连接管理架构                        │
-├─────────────────────────────────────────────────────────┤
-│                                                          │
-│  Session A ──┐                                          │
-│              │                                          │
-│  Session B ──┼──>  StreamControllerMap                  │
-│              │     {                                    │
-│  Session C ──┘       sessionId_A: AbortController,      │
-│                      sessionId_B: AbortController,      │
-│                      sessionId_C: AbortController        │
-│                    }                                     │
-│                                                          │
-│  ┌──────────────────────────────────────────────┐     │
-│  │  数据路由：根据接收到的 sessionId 精确路由      │     │
-│  │  reset_chat(sessionId, data)                  │     │
-│  └──────────────────────────────────────────────┘     │
-│                                                          │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 🔧 技术实现方案
-
-### 1. 数据结构改造
-
-#### 当前实现
-```typescript
-let currentStreamController: AbortController | null = null;
-let currentStreamSessionId: string | null = null;
-```
-
-#### 优化后
-```typescript
-interface StreamInfo {
-  controller: AbortController;
-  sessionId: string;
-  queryId?: string;
-  startTime: number;
-  onSuccess?: (gmtModified: number) => void;
-}
-
-const streamControllers = new Map<string, StreamInfo>();
-```
-
-### 2. 核心函数改造
-
-#### 2.1 `reset_chat` 函数改造
-
-**当前问题**：
-```typescript
-const reset_chat = ({ ... }) => {
-  setChatData((chatList: any) => {
-    const current = chatList[0]; // ❌ 假设第一个是当前对话
-    // ...
-  });
-};
-```
-
-**优化后**：
-```typescript
-const reset_chat = ({
-  sessionId, // ✅ 新增：明确指定会话ID
-  content,
-  status,
-  // ... 其他参数
-}) => {
-  setChatData((chatList: any) => {
-    // ✅ 根据 sessionId 精确查找
-    const targetChat = chatList.find(chat => chat.id === sessionId);
-    if (!targetChat) {
-      console.warn(`[reset_chat] 未找到会话: ${sessionId}`);
-      return chatList;
-    }
-    
-    const messages = targetChat.messages || [];
-    const lastIndex = messages.length - 1;
-    if (lastIndex < 0) return chatList;
-    
-    const lastMessage = messages[lastIndex];
-    if (lastMessage.istype !== 'ai') return chatList;
-    
-    // 更新找到的对话
-    const newMessages = messages.slice();
-    // ... 更新逻辑
-    
-    // ✅ 更新目标对话，保持数组结构
-    const updatedChat = { ...targetChat, messages: newMessages };
-    return chatList.map(chat => 
-      chat.id === sessionId ? updatedChat : chat
-    );
-  });
-};
-```
-
-#### 2.2 `api_startChat_re` 函数改造
-
-**优化后**：
-```typescript
-const api_startChat_re = (data: Api_Chat, onSuccess?: (gmtModified: number) => void) => {
-  const { sessionId, queryId } = data;
-  
-  // ✅ 同一会话：取消旧请求
-  if (streamControllers.has(sessionId)) {
-    const oldStream = streamControllers.get(sessionId);
-    oldStream?.controller.abort();
-    streamControllers.delete(sessionId);
-  }
-  
-  // ✅ 创建新连接
-  const controller = new AbortController();
-  const streamInfo: StreamInfo = {
-    controller,
-    sessionId,
-    queryId,
-    startTime: Date.now(),
-    onSuccess,
-  };
-  streamControllers.set(sessionId, streamInfo);
-  
-  // ✅ 发起 SSE 请求
-  fetchEventSource(eventSourceUrl, {
-    // ... 配置
-    onmessage: event => {
-      const curData = JSON.parse(event.data);
-      
-      // ✅ 根据接收到的 sessionId 路由，不依赖 activeSessionId
-      if (curData.sessionId !== sessionId) {
-        console.warn(`[api_startChat_re] sessionId 不匹配`, {
-          expected: sessionId,
-          received: curData.sessionId,
-        });
-        return;
-      }
-      
-      // ✅ 调用 reset_chat 时传入 sessionId
-      reset_chat({
-        sessionId, // ✅ 明确指定
-        content: reply.content || '',
-        status,
-        // ... 其他参数
-      });
-      
-      // ✅ 状态管理：只更新当前激活会话的状态
-      if (activeSessionId === sessionId) {
-        setAppStatus((pre: any) => ({
-          ...pre,
-          display: status === StatusType.Done ? 'ready' : 'processing',
-          sender: status === StatusType.Done ? 'ready' : 'processing',
-        }));
-      }
-    },
-    onclose: () => {
-      // ✅ 清理连接
-      if (streamControllers.get(sessionId)?.controller === controller) {
-        streamControllers.delete(sessionId);
-      }
-    },
-    onerror: (err) => {
-      // ✅ 错误隔离：只影响对应会话
-      if (streamControllers.get(sessionId)?.controller === controller) {
-        streamControllers.delete(sessionId);
-        if (activeSessionId === sessionId) {
-          setAppStatus((pre: any) => ({ ...pre, display: 'error', sender: 'ready' }));
-        }
-      }
-      onErrorCallback(err);
-    },
-  });
-};
-```
-
-#### 2.3 `stopStream` 函数改造
-
-**优化后**：
-```typescript
-// 停止指定会话的流式请求
-const stopStream = (sessionId?: string) => {
-  if (sessionId) {
-    // ✅ 停止指定会话
-    const stream = streamControllers.get(sessionId);
-    if (stream) {
-      stream.controller.abort();
-      streamControllers.delete(sessionId);
-      if (activeSessionId === sessionId) {
-        setAppStatus((pre: any) => ({ ...pre, display: 'ready', sender: 'ready' }));
-      }
-    }
-  } else {
-    // ✅ 停止所有会话（兼容旧接口）
-    streamControllers.forEach((stream) => {
-      stream.controller.abort();
-    });
-    streamControllers.clear();
-    setAppStatus((pre: any) => ({ ...pre, display: 'ready', sender: 'ready' }));
-  }
-};
-```
-
-#### 2.4 `handleItemClick` 函数改造
-
-**当前实现**：
-```typescript
-function handleItemClick(data: any) {
-  if (data?.sessionId && data.sessionId !== activeSessionId) {
-    // ❌ 取消当前会话的请求
-    if (activeSessionId) {
-      cancelStreamBySessionId(activeSessionId);
-    }
-    setActiveSessionId(data.sessionId);
-    // ...
-  }
-}
-```
-
-**优化后**：
-```typescript
-function handleItemClick(data: any) {
-  if (data?.sessionId && data.sessionId !== activeSessionId) {
-    // ✅ 不取消请求，让后台继续接收数据
-    setActiveSessionId(data.sessionId);
-    setAppStatus(prev => ({ ...prev, sender: 'ready' }));
-    // ... 其他逻辑
-  }
-}
-```
-
----
-
-## 📝 改动范围
-
-### 需要改动的文件
-
-#### 1. `gientech/src/utils/gientechCommon/hooks/AichatUseController.tsx`
-
-**改动点**：
-- [ ] 数据结构：单连接 → Map 管理
-- [ ] `reset_chat`：添加 `sessionId` 参数，改为精确查找
-- [ ] `api_startChat_re`：多连接管理，数据路由改造
-- [ ] `stopStream`：支持指定会话停止
-- [ ] `addEmptyMessage`：可能需要调整（检查是否依赖 `chatList[0]`）
-- [ ] `updateUserFilesMessage`：可能需要调整（检查是否依赖 `chatList[0]`）
-- [ ] `setLastEmptyMessage`：可能需要调整（检查是否依赖 `chatList[0]`）
-
-#### 2. `gientech/src/modules/chat/index.tsx`
-
-**改动点**：
-- [ ] `handleItemClick`：移除 `cancelStreamBySessionId` 调用
-- [ ] 状态管理：确保 `appStatus` 只反映当前激活会话
-
-#### 3. 其他可能受影响的文件
-
-- [ ] 检查是否有其他地方依赖 `chatList[0]` 的假设
-- [ ] 检查是否有其他地方调用 `stopStream`，需要适配新接口
-
----
-
-## ⚠️ 风险评估与应对
-
-### 风险 1：内存和连接数管理
-
-**风险描述**：
-- 用户打开很多会话时，每个会话都维护一个 SSE 连接
-- 可能导致内存和网络资源浪费
-- 浏览器对同一域名的并发连接数有限制（通常 6 个）
-
-**应对方案**：
-```typescript
-// 限制最大并发连接数
-const MAX_CONCURRENT_STREAMS = 5;
-
-const api_startChat_re = (data: Api_Chat, onSuccess?: (gmtModified: number) => void) => {
-  // 如果超过限制，关闭最久未激活的会话连接
-  if (streamControllers.size >= MAX_CONCURRENT_STREAMS) {
-    const oldestSessionId = findOldestInactiveSession();
-    if (oldestSessionId) {
-      stopStream(oldestSessionId);
-    }
-  }
-  // ... 继续创建新连接
-};
-```
-
-### 风险 2：同一会话的并发请求
-
-**风险描述**：
-- 用户快速发送多条消息时，可能产生多个并发请求
-- 需要决定是否允许同一会话多个并发请求
-
-**应对方案**：
-```typescript
-// 方案：同一会话只允许一个请求，新请求取消旧请求
-const api_startChat_re = (data: Api_Chat, onSuccess?: (gmtModified: number) => void) => {
-  const { sessionId } = data;
-  
-  // ✅ 同一会话：取消旧请求
-  if (streamControllers.has(sessionId)) {
-    const oldStream = streamControllers.get(sessionId);
-    oldStream?.controller.abort();
-    streamControllers.delete(sessionId);
-  }
-  
-  // 创建新连接...
-};
-```
-
-### 风险 3：错误隔离
-
-**风险描述**：
-- 某个会话的 SSE 连接出错，不应该影响其他会话
-
-**应对方案**：
-```typescript
-onerror: (err) => {
-  // ✅ 错误隔离：只影响对应会话
-  if (streamControllers.get(sessionId)?.controller === controller) {
-    streamControllers.delete(sessionId);
-    // 只更新对应会话的状态
-    if (activeSessionId === sessionId) {
-      setAppStatus((pre: any) => ({ ...pre, display: 'error', sender: 'ready' }));
-    }
-  }
-  onErrorCallback(err);
-},
-```
-
-### 风险 4：数据一致性
-
-**风险描述**：
-- `reset_chat` 改为根据 sessionId 查找，需要确保数据结构的正确性
-
-**应对方案**：
-- 添加防御性检查
-- 添加日志记录
-- 单元测试覆盖
-
----
-
-## 🧪 测试方案
-
-### 测试用例
-
-#### 1. 基础功能测试
-- [ ] 单个会话正常发送和接收
-- [ ] 多个会话并发发送和接收
-- [ ] 切换会话时，后台会话继续接收数据
-- [ ] 切换回来时，能看到完整的输出
-
-#### 2. 边界情况测试
-- [ ] 快速切换多个会话
-- [ ] 同一会话快速发送多条消息
-- [ ] 会话连接出错时的错误隔离
-- [ ] 超过最大连接数时的处理
-
-#### 3. 数据准确性测试
-- [ ] 数据不会写入错误的会话
-- [ ] 切换会话时数据路由正确
-- [ ] 多个会话同时有流式输出时，数据不混乱
-
-#### 4. 性能测试
-- [ ] 内存占用（多个会话时）
-- [ ] 网络连接数
-- [ ] 响应时间
-
----
-
-## 📅 实施步骤
-
-### Phase 1: 准备阶段（0.5 天）
-1. 代码审查，确认所有依赖点
-2. 创建功能分支
-3. 编写单元测试用例
-
-### Phase 2: 核心改造（1.5 天）
-1. 数据结构改造
-2. `reset_chat` 函数改造
-3. `api_startChat_re` 函数改造
-4. `stopStream` 函数改造
-5. `handleItemClick` 函数改造
-
-### Phase 3: 测试与优化（1 天）
-1. 单元测试
-2. 集成测试
-3. 性能测试
-4. Bug 修复
-
-### Phase 4: 代码审查与发布（0.5 天）
-1. Code Review
-2. 文档更新
-3. 发布
-
----
-
-## 📊 预期收益
-
-### 用户体验提升
-- ✅ 切换会话不中断输出
-- ✅ 切换回来能看到完整内容
-- ✅ 支持多会话并发处理
-
-### 技术架构优化
-- ✅ 数据路由更精确
-- ✅ 避免数据写入错误会话
-- ✅ 架构更合理，易于维护
-
-### 代码质量
-- ✅ 职责更清晰
-- ✅ 错误隔离更好
-- ✅ 可扩展性更强
-
----
-
-## 🔗 相关文档
-
-- [当前实现代码](../src/utils/gientechCommon/hooks/AichatUseController.tsx)
-- [业务层调用代码](../src/modules/chat/index.tsx)
-- [快速修复方案记录](./bugfix-切换会话取消SSE请求.md)（如有）
-
----
-
-## 📌 注意事项
-
-1. **向后兼容**：确保 `stopStream()` 无参数调用时，停止所有会话（兼容旧代码）
-
-2. **日志记录**：添加详细的日志，便于问题排查
-   ```typescript
-   console.log('[AichatUseController] 创建流式连接', { sessionId, queryId });
-   console.log('[AichatUseController] 数据路由', { sessionId, contentLength });
-   console.log('[AichatUseController] 关闭流式连接', { sessionId });
-   ```
-
-3. **性能监控**：监控连接数和内存占用
-
-4. **渐进式发布**：可以考虑先发布到测试环境，观察一段时间再全量
-
----
-
-## ✅ 检查清单
-
-实施前检查：
-- [ ] 代码审查完成
-- [ ] 测试用例编写完成
-- [ ] 风险评估完成
-- [ ] 回滚方案准备
-
-实施后检查：
-- [ ] 所有测试用例通过
-- [ ] 性能测试通过
-- [ ] 代码审查通过
-- [ ] 文档更新完成
-
----
-
-**文档版本**: v1.0  
-**最后更新**: 2025-01-XX  
-**维护者**: 开发团队
-