feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
--- a/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-18-路由问题修复报告.md
+++ b/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-18-路由问题修复报告.md
@@ -1,17 +1,17 @@
 # ASLæ¨¡å<C2A1>— - è·¯ç”±é—®é¢˜ä¿®å¤<C3A5>æŠ¥å‘Š

 **æ—¥æœŸ**: 2025-11-18  
-**问题**: 点击"设置与启动"按钮后页面显示空白  
-**状态**: ✅ 已修复
+**é—®é¢˜**: ç‚¹å‡»"è®¾ç½®ä¸Žå<C5BD>¯åŠ?æŒ‰é’®å<C2AE>Žé¡µé<C2B5>¢æ˜¾ç¤ºç©ºç™? 
+**çŠ¶æ€?*: âœ?å·²ä¿®å¤?

 ---

 ## ðŸ<C3B0>› é—®é¢˜æ<CB9C><C3A6>è¿°

 ### ç”¨æˆ·å<C2B7><C3A5>é¦ˆ
-1. ❌ 点击左侧"设置与启动"按钮
-2. ❌ 页面显示空白
-3. ❌ 浏览器控制台警告：`Warning: [antd: Spin] tip only work in nest or fullscreen pattern.`
+1. â<EFBFBD>?ç‚¹å‡»å·¦ä¾§"è®¾ç½®ä¸Žå<C5BD>¯åŠ?æŒ‰é’®
+2. â<EFBFBD>?é¡µé<C2B5>¢æ˜¾ç¤ºç©ºç™½
+3. â<EFBFBD>?æµ<C3A6>è§ˆå™¨æŽ§åˆ¶å<C2B6>°è¦å‘Šï¼š`Warning: [antd: Spin] tip only work in nest or fullscreen pattern.`

 ---

@@ -19,29 +19,29 @@

 ### æ ¹æœ¬åŽŸå› 

-发现了**2个问题**：
+å<EFBFBD>‘çŽ°äº?*2ä¸ªé—®é¢?*ï¼?

-#### 问题1: Spin组件的tip属性警告 ⚠️
+#### é—®é¢˜1: Spinç»„ä»¶çš„tipå±žæ€§è¦å‘?âš ï¸<C3AF>

 **ä½<C3A4>ç½®**: `frontend-v2/src/framework/layout/MainLayout.tsx:30`

 ```typescript
-// ❌ 错误代码
-<Spin size="large" tip="加载中..." />
+// â<EFBFBD>?é”™è¯¯ä»£ç <C3A7>
+<Spin size="large" tip="åŠ è½½ä¸?.." />
 ```

-**原因**: Ant Design 的 `Spin` 组件的 `tip` 属性只能在以下模式使用：
+**åŽŸå› **: Ant Design çš?`Spin` ç»„ä»¶çš?`tip` å±žæ€§å<C2A7>ªèƒ½åœ¨ä»¥ä¸‹æ¨¡å¼<C3A5>ä½¿ç”¨ï¼?
 - `nest` æ¨¡å¼<C3A5>ï¼ˆåµŒå¥—åœ¨å†…å®¹ä¸ï¼‰
 - `fullscreen` æ¨¡å¼<C3A5>ï¼ˆå…¨å±<C3A5>æ˜¾ç¤ºï¼‰

-当前使用的是普通模式，不支持 `tip` 属性。
+å½“å‰<EFBFBD>ä½¿ç”¨çš„æ˜¯æ™®é€šæ¨¡å¼<EFBFBD>ï¼Œä¸<EFBFBD>æ”¯æŒ?`tip` å±žæ€§ã€?

-#### 问题2: 嵌套路由配置错误 ❌
+#### é—®é¢˜2: åµŒå¥—è·¯ç”±é…<C3A9>ç½®é”™è¯¯ â<>?

 **ä½<C3A4>ç½®**: `frontend-v2/src/modules/asl/index.tsx`

 ```typescript
-// ❌ 错误代码
+// â<EFBFBD>?é”™è¯¯ä»£ç <C3A7>
 <Routes>
  {aslRoutes.map((route, index) => (
    <Route
@@ -56,35 +56,35 @@

 **åŽŸå› **: 
 - `aslRoutes` æ˜¯ä¸€ä¸ªå¤<C3A5>æ<EFBFBD>‚çš„åµŒå¥—è·¯ç”±ç»“æž„
- `map` 方法只能渲染第一层路由，无法处理 `children` 属性
+- `map` æ–¹æ³•å<EFBFBD>ªèƒ½æ¸²æŸ“ç¬¬ä¸€å±‚è·¯ç”±ï¼Œæ— æ³•å¤„ç<EFBFBD>† `children` å±žæ€?
 - å¯¼è‡´ `ASLLayout` çš„å<C3A5>è·¯ç”±æ— æ³•æ£å¸¸æ¸²æŸ“
- 结果：页面显示空白
+- ç»“æžœï¼šé¡µé<EFBFBD>¢æ˜¾ç¤ºç©ºç™?

 **è·¯ç”±ç»“æž„**:
 ```
-ASLLayout (父路由)
-  └── screening/title (子路由)
+ASLLayout (çˆ¶è·¯ç”?
+  â””â”€â”€ screening/title (å<EFBFBD>è·¯ç”?
      â”œâ”€â”€ settings
      â”œâ”€â”€ workbench
      â””â”€â”€ results
 ```

-这种嵌套结构需要在 JSX 中显式声明。
+è¿™ç§<EFBFBD>åµŒå¥—ç»“æž„éœ€è¦<EFBFBD>åœ¨ JSX ä¸æ˜¾å¼<C3A5>å£°æ˜Žã€?

 ---

-## ✅ 修复方案
+## âœ?ä¿®å¤<C3A5>æ–¹æ¡ˆ

-### 修复1: 移除Spin的tip属性
+### ä¿®å¤<EFBFBD>1: ç§»é™¤Spinçš„tipå±žæ€?

 **æ–‡ä»¶**: `frontend-v2/src/framework/layout/MainLayout.tsx`

 ```typescript
-// ✅ 修复后
+// âœ?ä¿®å¤<C3A5>å<EFBFBD>?
 <Spin size="large" />
 ```

-**效果**: 警告消失，加载动画正常显示
+**æ•ˆæžœ**: è¦å‘Šæ¶ˆå¤±ï¼ŒåŠ è½½åŠ¨ç”»æ£å¸¸æ˜¾ç¤?

 ---

@@ -93,12 +93,12 @@ ASLLayout (父路由)
 **æ–‡ä»¶**: `frontend-v2/src/modules/asl/index.tsx`

 ```typescript
-// ✅ 修复后
+// âœ?ä¿®å¤<C3A5>å<EFBFBD>?
 import { Suspense, lazy } from 'react';
 import { Routes, Route, Navigate } from 'react-router-dom';
 import { Spin } from 'antd';

-// 懒加载组件
+// æ‡’åŠ è½½ç»„ä»?
 const ASLLayout = lazy(() => import('./components/ASLLayout'));
 const TitleScreeningSettings = lazy(() => import('./pages/TitleScreeningSettings'));
 const TitleScreeningWorkbench = lazy(() => import('./pages/ScreeningWorkbench'));
@@ -114,12 +114,12 @@ const ASLModule = () => {
      }
    >
      <Routes>
-        {/* 父路由: ASLLayout 布局 */}
+        {/* çˆ¶è·¯ç”? ASLLayout å¸ƒå±€ */}
        <Route path="" element={<ASLLayout />}>
-          {/* 默认重定向到设置页 */}
+          {/* é»˜è®¤é‡<EFBFBD>å®šå<EFBFBD>‘åˆ°è®¾ç½®é¡?*/}
          <Route index element={<Navigate to="screening/title/settings" replace />} />
          
-          {/* 标题摘要初筛子路由 */}
+          {/* æ ‡é¢˜æ‘˜è¦<EFBFBD>åˆ<EFBFBD>ç›å<EFBFBD>è·¯ç”?*/}
          <Route path="screening/title">
            <Route index element={<Navigate to="settings" replace />} />
            <Route path="settings" element={<TitleScreeningSettings />} />
@@ -136,11 +136,11 @@ export default ASLModule;
 ```

 **æ”¹è¿›**:
- ✅ 使用嵌套的 `<Route>` 标签显式声明层级关系
- ✅ `ASLLayout` 作为父路由
- ✅ `screening/title` 作为中间层
- ✅ `settings/workbench/results` 作为叶子路由
- ✅ 两个 `<Navigate>` 实现自动重定向
+- âœ?ä½¿ç”¨åµŒå¥—çš?`<Route>` æ ‡ç¾æ˜¾å¼<C3A5>å£°æ˜Žå±‚çº§å…³ç³»
+- âœ?`ASLLayout` ä½œä¸ºçˆ¶è·¯ç”?
+- âœ?`screening/title` ä½œä¸ºä¸é—´å±?
+- âœ?`settings/workbench/results` ä½œä¸ºå<EFBFBD>¶å<EFBFBD>è·¯ç”±
+- âœ?ä¸¤ä¸ª `<Navigate>` å®žçŽ°è‡ªåŠ¨é‡<EFBFBD>å®šå<EFBFBD>?

 ---

@@ -149,8 +149,8 @@ export default ASLModule;
 **åˆ é™¤**: `frontend-v2/src/modules/asl/routes.tsx`

 **åŽŸå› **: 
- 路由配置已经直接在 `index.tsx` 中实现
- `routes.tsx` 文件不再被引用
+- è·¯ç”±é…<EFBFBD>ç½®å·²ç»<EFBFBD>ç›´æŽ¥åœ?`index.tsx` ä¸å®žçŽ?
+- `routes.tsx` æ–‡ä»¶ä¸<EFBFBD>å†<EFBFBD>è¢«å¼•ç”?
 - é<>¿å…<C3A5>ç»´æŠ¤ä¸¤ä»½è·¯ç”±é…<C3A9>ç½®

 ---
@@ -161,47 +161,47 @@ export default ASLModule;

 ```
 1. ç‚¹å‡»"AIæ™ºèƒ½æ–‡çŒ®"
-   → 进入 /literature
+   â†?è¿›å…¥ /literature
   
 2. ASLModule æŽ¥æ”¶è·¯å¾„ ""
-   → 渲染 ASLLayout（左侧导航 + Outlet）
+   â†?æ¸²æŸ“ ASLLayoutï¼ˆå·¦ä¾§å¯¼èˆ?+ Outletï¼?
   
 3. index route è§¦å<C2A6>‘
-   → <Navigate to="screening/title/settings" replace />
+   â†?<Navigate to="screening/title/settings" replace />
   
 4. è·¯å¾„å<E2809E>˜ä¸º /literature/screening/title/settings
-   → ASLLayout 保持显示
-   → Outlet 渲染 TitleScreeningSettings 组件
+   â†?ASLLayout ä¿<EFBFBD>æŒ<EFBFBD>æ˜¾ç¤º
+   â†?Outlet æ¸²æŸ“ TitleScreeningSettings ç»„ä»¶
   
-5. 用户看到完整页面：
-   ┌─────────────────────────────────────────┐
-   │ 左侧导航  │  设置与启动页面             │
-   │ (ASL)     │  (PICOS + Excel上传)        │
-   └─────────────────────────────────────────┘
+5. ç”¨æˆ·çœ‹åˆ°å®Œæ•´é¡µé<EFBFBD>¢ï¼?
+   â”Œâ”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”?
+   â”?å·¦ä¾§å¯¼èˆª  â”? è®¾ç½®ä¸Žå<C5BD>¯åŠ¨é¡µé<C2B5>?            â”?
+   â”?(ASL)     â”? (PICOS + Excelä¸Šä¼ )        â”?
+   â””â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”?
 ```

 ### è·¯ç”±åŒ¹é…<C3A9>æµ‹è¯•

 | è·¯å¾„ | åŒ¹é…<C3A9>ç»“æžœ | æ˜¾ç¤ºç»„ä»¶ |
 |------|---------|---------|
-| `/literature` | index route | Navigate → settings |
-| `/literature/screening/title` | index route | Navigate → settings |
-| `/literature/screening/title/settings` | ✅ | TitleScreeningSettings |
-| `/literature/screening/title/workbench` | ✅ | TitleScreeningWorkbench |
-| `/literature/screening/title/results` | ✅ | TitleScreeningResults |
+| `/literature` | index route | Navigate â†?settings |
+| `/literature/screening/title` | index route | Navigate â†?settings |
+| `/literature/screening/title/settings` | âœ?| TitleScreeningSettings |
+| `/literature/screening/title/workbench` | âœ?| TitleScreeningWorkbench |
+| `/literature/screening/title/results` | âœ?| TitleScreeningResults |

 ---

 ## ðŸ“Š ä¿®å¤<C3A5>æ•ˆæžœ

-### 修复前 ❌
+### ä¿®å¤<EFBFBD>å‰?â<>?
 - é¡µé<C2B5>¢ç©ºç™½
- 控制台警告
+- æŽ§åˆ¶å<EFBFBD>°è¦å‘?
 - è·¯ç”±æ— æ³•æ£ç¡®æ¸²æŸ“

-### 修复后 ✅
+### ä¿®å¤<EFBFBD>å<EFBFBD>?âœ?
 - å·¦ä¾§å¯¼èˆªæ£å¸¸æ˜¾ç¤º
- "设置与启动"页面完整渲染
+- "è®¾ç½®ä¸Žå<EFBFBD>¯åŠ?é¡µé<C2B5>¢å®Œæ•´æ¸²æŸ“
 - PICOSè¡¨å<C2A8>•å<E280A2>¯ä»¥æ£å¸¸å¡«å†™
 - æ— æŽ§åˆ¶å<C2B6>°è¦å‘Š

@@ -223,17 +223,17 @@ export default ASLModule;
 const Parent = () => (
  <div>
    <Sidebar />
-    <Outlet /> {/* 子路由渲染位置 */}
+    <Outlet /> {/* å<EFBFBD>è·¯ç”±æ¸²æŸ“ä½<EFBFBD>ç½?*/}
  </div>
 );
 ```

-3. **不能用 `map` 渲染嵌套路由**:
+3. **ä¸<EFBFBD>èƒ½ç”?`map` æ¸²æŸ“åµŒå¥—è·¯ç”±**:
 ```tsx
-// ❌ 错误
+// â<EFBFBD>?é”™è¯¯
 {routes.map(r => <Route key={r.path} {...r} />)}

-// ✅ 正确
+// âœ?æ£ç¡®
 <Route path="parent" element={<Parent />}>
  <Route path="child" element={<Child />} />
 </Route>
@@ -243,51 +243,51 @@ const Parent = () => (

 1. **`tip` å±žæ€§çš„é™<C3A9>åˆ¶**:
 ```tsx
-// ❌ 普通模式不支持 tip
-<Spin size="large" tip="加载中..." />
+// â<EFBFBD>?æ™®é€šæ¨¡å¼<C3A5>ä¸<C3A4>æ”¯æŒ<C3A6> tip
+<Spin size="large" tip="åŠ è½½ä¸?.." />

-// ✅ 方案1: 移除 tip
+// âœ?æ–¹æ¡ˆ1: ç§»é™¤ tip
 <Spin size="large" />

-// ✅ 方案2: 使用 fullscreen
-<Spin size="large" tip="加载中..." fullscreen />
+// âœ?æ–¹æ¡ˆ2: ä½¿ç”¨ fullscreen
+<Spin size="large" tip="åŠ è½½ä¸?.." fullscreen />

-// ✅ 方案3: 自定义文本
+// âœ?æ–¹æ¡ˆ3: è‡ªå®šä¹‰æ–‡æœ?
 <div>
  <Spin size="large" />
-  <div className="mt-2">加载中...</div>
+  <div className="mt-2">åŠ è½½ä¸?..</div>
 </div>
 ```

 ---

-## ✅ 验收清单
+## âœ?éªŒæ”¶æ¸…å<E280A6>•

- [x] 点击"AI智能文献"能进入模块
- [x] 左侧导航正常显示7个菜单
+- [x] ç‚¹å‡»"AIæ™ºèƒ½æ–‡çŒ®"èƒ½è¿›å…¥æ¨¡å<C2A1>?
+- [x] å·¦ä¾§å¯¼èˆªæ£å¸¸æ˜¾ç¤º7ä¸ªè<EFBFBD>œå<EFBFBD>?
 - [x] "æ ‡é¢˜æ‘˜è¦<C3A8>åˆ<C3A5>ç›"å±•å¼€3ä¸ªå<C3A5>è<EFBFBD>œå<C593>•
- [x] 默认显示"设置与启动"页面
- [x] PICOS表单完整显示（6-8行TextArea）
- [x] 无浏览器控制台警告/错误
- [x] 点击其他子菜单可以正常跳转
+- [x] é»˜è®¤æ˜¾ç¤º"è®¾ç½®ä¸Žå<C5BD>¯åŠ?é¡µé<C2B5>¢
+- [x] PICOSè¡¨å<EFBFBD>•å®Œæ•´æ˜¾ç¤ºï¼?-8è¡ŒTextAreaï¼?
+- [x] æ— æµ<EFBFBD>è§ˆå™¨æŽ§åˆ¶å<EFBFBD>°è¦å‘?é”™è¯¯
+- [x] ç‚¹å‡»å…¶ä»–å<EFBFBD>è<EFBFBD>œå<EFBFBD>•å<EFBFBD>¯ä»¥æ£å¸¸è·³è½?

 ---

 ## ðŸŽ‰ ä¿®å¤<C3A5>å®Œæˆ<C3A6>

 **ä¿®å¤<C3A5>æ–‡ä»¶**:
-1. ✅ `MainLayout.tsx` - 移除Spin的tip属性
-2. ✅ `asl/index.tsx` - 重写嵌套路由
-3. ✅ 删除 `asl/routes.tsx`
+1. âœ?`MainLayout.tsx` - ç§»é™¤Spinçš„tipå±žæ€?
+2. âœ?`asl/index.tsx` - é‡<EFBFBD>å†™åµŒå¥—è·¯ç”±
+3. âœ?åˆ é™¤ `asl/routes.tsx`

 **ä¿®å¤<C3A5>æ—¶é—´**: 15åˆ†é’Ÿ  
-**问题复杂度**: ⭐⭐⭐ (中等)  
-**修复质量**: ⭐⭐⭐⭐⭐ (完美)
+**é—®é¢˜å¤<EFBFBD>æ<EFBFBD>‚åº?*: â<C3A2>â<C3A2>â?(ä¸ç‰)  
+**ä¿®å¤<EFBFBD>è´¨é‡<EFBFBD>**: â<C3A2>â<C3A2>â<C3A2>â<C3A2>â?(å®Œç¾Ž)

 ---

 **ä¿®å¤<C3A5>å®Œæˆ<C3A6>æ—¶é—´**: 2025-11-18 22:15  
-**下一步**: 继续 Week 2 Day 2 开发
+**ä¸‹ä¸€æ?*: ç»§ç» Week 2 Day 2 å¼€å<EFBFBD>?