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-21-字段映射问题修复.md
+++ b/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-21-字段映射问题修复.md
@@ -1,9 +1,9 @@
 # å—æ®µæ˜ å°„é—®é¢˜ä¿®å¤<C3A5>æŠ¥å‘Š

 **æ—¥æœŸ**: 2025-11-21  
-**问题**: 真实LLM筛选失败（成功：0/20）  
+**é—®é¢˜**: çœŸå®žLLMç›é€‰å¤±è´¥ï¼ˆæˆ<EFBFBD>åŠŸï¼?/20ï¼? 
 **åŽŸå› **: å—æ®µå<C2B5><C3A5>ä¸<C3A4>åŒ¹é…<C3A9>  
-**状态**: ✅ 已修复  
+**çŠ¶æ€?*: âœ?å·²ä¿®å¤? 

 ---

@@ -11,16 +11,16 @@

 ### ç—‡çŠ¶
 ```
-任务状态: completed
+ä»»åŠ¡çŠ¶æ€? completed
 è¿›åº¦: 20/20
-成功: 0 ❌
+æˆ<EFBFBD>åŠŸ: 0 â<EFBFBD>?
 ç›é€‰ç»“æžœæ•°: 0
 ```

-**表现**：
- 任务瞬间完成（1秒）
- 所有文献处理失败
- 没有保存任何筛选结果
+**è¡¨çŽ°**ï¼?
+- ä»»åŠ¡çž¬é—´å®Œæˆ<EFBFBD>ï¼?ç§’ï¼‰
+- æ‰€æœ‰æ–‡çŒ®å¤„ç<EFBFBD>†å¤±è´?
+- æ²¡æœ‰ä¿<EFBFBD>å˜ä»»ä½•ç›é€‰ç»“æž?

 ---

@@ -28,11 +28,11 @@

 ### é—®é¢˜1: PICOSå—æ®µå<C2B5><C3A5>ä¸<C3A4>åŒ¹é…<C3A9>

-**前端/数据库格式** (`TitleScreeningSettings.tsx`):
+**å‰<EFBFBD>ç«¯/æ•°æ<C2B0>®åº“æ ¼å¼?* (`TitleScreeningSettings.tsx`):
 ```typescript
 picoCriteria: {
-  P: '2型糖尿病患者...',
-  I: 'SGLT2抑制剂...',
+  P: '2åž‹ç³–å°¿ç—…æ‚£è€?..',
+  I: 'SGLT2æŠ‘åˆ¶å‰?..',
  C: 'å®‰æ…°å‰‚æˆ–å¸¸è§„æ²»ç–—...',
  O: 'å¿ƒè¡€ç®¡ç»“å±€...',
  S: 'RCT'
@@ -43,15 +43,15 @@ picoCriteria: {
 ```typescript
 // å®žé™…ä¸Šæ”¯æŒ<C3A6>ä¸¤ç§<C3A7>æ ¼å¼<C3A5>ï¼Œä½†ä¼˜å…ˆä½¿ç”¨çŸæ ¼å¼<C3A5>
 picoCriteria: {
-  P: '...',  // ✅
-  I: '...',  // ✅
-  C: '...',  // ✅
-  O: '...',  // ✅
-  S: '...'   // ✅
+  P: '...',  // âœ?
+  I: '...',  // âœ?
+  C: '...',  // âœ?
+  O: '...',  // âœ?
+  S: '...'   // âœ?
 }
 ```

-**诊断**：前端使用 P/I/C/O/S 格式，但 `screeningService.ts` 直接传递了数据库的原始格式，未做映射。
+**è¯Šæ–**ï¼šå‰<C3A5>ç«¯ä½¿ç”?P/I/C/O/S æ ¼å¼<C3A5>ï¼Œä½† `screeningService.ts` ç›´æŽ¥ä¼ é€’äº†æ•°æ<C2B0>®åº“çš„åŽŸå§‹æ ¼å¼<C3A5>ï¼Œæœªå<C2AA>šæ˜ å°„ã€?

 ---

@@ -67,24 +67,24 @@ models: ['DeepSeek-V3', 'Qwen-Max']
 models: ['deepseek-chat', 'qwen-max']
 ```

-**原因**：前端使用展示名称，后端需要API名称。
+**åŽŸå› **ï¼šå‰<C3A5>ç«¯ä½¿ç”¨å±•ç¤ºå<C2BA><C3A5>ç§°ï¼Œå<C592>Žç«¯éœ€è¦<C3A8>APIå<49><C3A5>ç§°ã€?

 ---

 ### é—®é¢˜3: ç¼ºå°‘å—æ®µéªŒè¯<C3A8>

-文献可能缺少 `title` 或 `abstract`，导致LLM调用失败。
+æ–‡çŒ®å<EFBFBD>¯èƒ½ç¼ºå°‘ `title` æˆ?`abstract`ï¼Œå¯¼è‡´LLMè°ƒç”¨å¤±è´¥ã€?

 ---

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

 ### ä¿®å¤<C3A5>1: æ·»åŠ PICOSå—æ®µæ˜ å°„

 **æ–‡ä»¶**: `backend/src/modules/asl/services/screeningService.ts`

 ```typescript
-// 🔧 修复：字段名映射（数据库格式 → LLM服务格式）
+// ðŸ”§ ä¿®å¤<C3A5>ï¼šå—æ®µå<C2B5><C3A5>æ˜ å°„ï¼ˆæ•°æ<C2B0>®åº“æ ¼å¼<C3A5> â†?LLMæœ<C3A6>åŠ¡æ ¼å¼<C3A5>ï¼?
 const rawPicoCriteria = project.picoCriteria as any;
 const picoCriteria = {
  P: rawPicoCriteria?.P || rawPicoCriteria?.population || '',
@@ -95,22 +95,22 @@ const picoCriteria = {
 };
 ```

-**优势**：
- ✅ 兼容两种格式（P/I/C/O/S 或 population/intervention/...）
- ✅ 防御性编程，避免undefined
+**ä¼˜åŠ¿**ï¼?
+- âœ?å…¼å®¹ä¸¤ç§<C3A7>æ ¼å¼<C3A5>ï¼ˆP/I/C/O/S æˆ?population/intervention/...ï¼?
+- âœ?é˜²å¾¡æ€§ç¼–ç¨‹ï¼Œé<C592>¿å…<C3A5>undefined

 ---

-### 修复2: 添加模型名映射
+### ä¿®å¤<EFBFBD>2: æ·»åŠ æ¨¡åž‹å<E280B9><C3A5>æ˜ å°?

 ```typescript
-// 🔧 修复：模型名映射（前端格式 → API格式）
+// ðŸ”§ ä¿®å¤<C3A5>ï¼šæ¨¡åž‹å<E280B9><C3A5>æ˜ å°„ï¼ˆå‰<C3A5>ç«¯æ ¼å¼?â†?APIæ ¼å¼<C3A5>ï¼?
 const MODEL_NAME_MAP: Record<string, string> = {
  'DeepSeek-V3': 'deepseek-chat',
  'Qwen-Max': 'qwen-max',
  'GPT-4o': 'gpt-4o',
  'Claude-4.5': 'claude-sonnet-4.5',
-  'deepseek-chat': 'deepseek-chat',  // 兼容直接使用API名
+  'deepseek-chat': 'deepseek-chat',  // å…¼å®¹ç›´æŽ¥ä½¿ç”¨APIå<EFBFBD>?
  'qwen-max': 'qwen-max',
  // ... æ›´å¤šæ˜ å°„
 };
@@ -119,8 +119,8 @@ const rawModels = screeningConfig?.models || ['deepseek-chat', 'qwen-max'];
 const models = rawModels.map((m: string) => MODEL_NAME_MAP[m] || m);
 ```

-**映射表**：
-| 前端展示名 | API名称 |
+**æ˜ å°„è¡?*ï¼?
+| å‰<EFBFBD>ç«¯å±•ç¤ºå<EFBFBD>?| APIå<49><C3A5>ç§° |
 |-----------|---------|
 | DeepSeek-V3 | deepseek-chat |
 | Qwen-Max | qwen-max |
@@ -132,7 +132,7 @@ const models = rawModels.map((m: string) => MODEL_NAME_MAP[m] || m);
 ### ä¿®å¤<C3A5>3: æ·»åŠ æ–‡çŒ®éªŒè¯<C3A8>

 ```typescript
-// 🔧 验证：必须有标题和摘要
+// ðŸ”§ éªŒè¯<C3A8>ï¼šå¿…é¡»æœ‰æ ‡é¢˜å’Œæ‘˜è¦?
 if (!literature.title || !literature.abstract) {
  logger.warn('Skipping literature without title or abstract', {
    literatureId: literature.id,
@@ -150,62 +150,62 @@ if (!literature.title || !literature.abstract) {
 ### ä¿®å¤<C3A5>4: å¢žå¼ºè°ƒè¯•æ—¥å¿—

 ```typescript
-console.log('\n🚀 开始真实LLM筛选:');
+console.log('\nðŸš€ å¼€å§‹çœŸå®žLLMç›é€?');
 console.log('  ä»»åŠ¡ID:', taskId);
 console.log('  é¡¹ç›®ID:', projectId);
-console.log('  文献数:', literatures.length);
-console.log('  模型（映射后）:', models);  // ⭐ 显示映射后的值
-console.log('  PICOS-P:', picoCriteria.P?.substring(0, 50) || '(空)');
-console.log('  PICOS-I:', picoCriteria.I?.substring(0, 50) || '(空)');
-console.log('  PICOS-C:', picoCriteria.C?.substring(0, 50) || '(空)');
-console.log('  纳入标准:', inclusionCriteria?.substring(0, 50) || '(空)');
-console.log('  排除标准:', exclusionCriteria?.substring(0, 50) || '(空)');
+console.log('  æ–‡çŒ®æ•?', literatures.length);
+console.log('  æ¨¡åž‹ï¼ˆæ˜ å°„å<EFBFBD>Žï¼?', models);  // â?æ˜¾ç¤ºæ˜ å°„å<E2809E>Žçš„å€?
+console.log('  PICOS-P:', picoCriteria.P?.substring(0, 50) || '(ç©?');
+console.log('  PICOS-I:', picoCriteria.I?.substring(0, 50) || '(ç©?');
+console.log('  PICOS-C:', picoCriteria.C?.substring(0, 50) || '(ç©?');
+console.log('  çº³å…¥æ ‡å‡†:', inclusionCriteria?.substring(0, 50) || '(ç©?');
+console.log('  æŽ’é™¤æ ‡å‡†:', exclusionCriteria?.substring(0, 50) || '(ç©?');
 ```

 ---

 ## ðŸ§ª æµ‹è¯•æ¥éª¤

-### 1. 重启后端（必须！）
+### 1. é‡<EFBFBD>å<EFBFBD>¯å<EFBFBD>Žç«¯ï¼ˆå¿…é¡»ï¼<EFBFBD>ï¼?

 ```bash
-# 停止当前后端（Ctrl+C）
+# å<EFBFBD>œæ¢å½“å‰<EFBFBD>å<EFBFBD>Žç«¯ï¼ˆCtrl+Cï¼?
 cd D:\MyCursor\AIclinicalresearch\backend
 npm run dev
 ```

-### 2. 测试（小规模）
+### 2. æµ‹è¯•ï¼ˆå°<EFBFBD>è§„æ¨¡ï¼?

 1. è®¿é—®å‰<C3A5>ç«¯
 2. å¡«å†™PICOS
-3. **上传5篇文献**（先测试小规模）
+3. **ä¸Šä¼ 5ç¯‡æ–‡çŒ?*ï¼ˆå…ˆæµ‹è¯•å°<C3A5>è§„æ¨¡ï¼‰
 4. ç‚¹å‡»"å¼€å§‹AIåˆ<C3A5>ç›"

-### 3. 查看后端控制台
+### 3. æŸ¥çœ‹å<EFBFBD>Žç«¯æŽ§åˆ¶å<EFBFBD>?

-**应该看到**：
+**åº”è¯¥çœ‹åˆ°**ï¼?
 ```
-🚀 开始真实LLM筛选:
+ðŸš€ å¼€å§‹çœŸå®žLLMç›é€?
  ä»»åŠ¡ID: xxx
-  文献数: 5
-  模型（映射后）: [ 'deepseek-chat', 'qwen-max' ]
-  PICOS-P: 2型糖尿病患者...
-  PICOS-I: SGLT2抑制剂...
-  PICOS-C: 安慰剂...
+  æ–‡çŒ®æ•? 5
+  æ¨¡åž‹ï¼ˆæ˜ å°„å<EFBFBD>Žï¼? [ 'deepseek-chat', 'qwen-max' ]
+  PICOS-P: 2åž‹ç³–å°¿ç—…æ‚£è€?..
+  PICOS-I: SGLT2æŠ‘åˆ¶å‰?..
+  PICOS-C: å®‰æ…°å‰?..
  çº³å…¥æ ‡å‡†: æˆ<C3A6>äºº2åž‹ç³–å°¿ç—…...
-  排除标准: 综述、系统评价...
+  æŽ’é™¤æ ‡å‡†: ç»¼è¿°ã€<C3A3>ç³»ç»Ÿè¯„ä»?..

 [ç‰å¾…10-20ç§’]

-✅ 文献 1/5 处理成功
+âœ?æ–‡çŒ® 1/5 å¤„ç<E2809E>†æˆ<C3A6>åŠŸ
  DS: include / Qwen: include
-  冲突: 否
+  å†²çª<EFBFBD>: å<>?

 [ç‰å¾…10-20ç§’]

-✅ 文献 2/5 处理成功
+âœ?æ–‡çŒ® 2/5 å¤„ç<E2809E>†æˆ<C3A6>åŠŸ
  DS: exclude / Qwen: exclude
-  冲突: 否
+  å†²çª<EFBFBD>: å<>?
 ...
 ```

@@ -213,25 +213,25 @@ npm run dev

 ## ðŸ“Š é¢„æœŸæ•ˆæžœ

-### 修复前
- ⏱️ 1秒完成20篇
- ❌ 成功：0
- ❌ 筛选结果数：0
+### ä¿®å¤<EFBFBD>å‰?
+- â<EFBFBD>±ï¸<EFBFBD> 1ç§’å®Œæˆ?0ç¯?
+- â<EFBFBD>?æˆ<C3A6>åŠŸï¼?
+- â<EFBFBD>?ç›é€‰ç»“æžœæ•°ï¼?

-### 修复后
- ⏱️ 50-100秒完成5篇（每篇10-20秒）
- ✅ 成功：5
- ✅ 筛选结果数：5
- ✅ 证据包含真实的AI分析
- ✅ 证据不包含"模拟证据"
+### ä¿®å¤<EFBFBD>å<EFBFBD>?
+- â<EFBFBD>±ï¸<EFBFBD> 50-100ç§’å®Œæˆ?ç¯‡ï¼ˆæ¯<C3A6>ç¯‡10-20ç§’ï¼‰
+- âœ?æˆ<C3A6>åŠŸï¼?
+- âœ?ç›é€‰ç»“æžœæ•°ï¼?
+- âœ?è¯<C3A8>æ<EFBFBD>®åŒ…å<E280A6>«çœŸå®žçš„AIåˆ†æž<C3A6>
+- âœ?è¯<C3A8>æ<EFBFBD>®ä¸<C3A4>åŒ…å<E280A6>?æ¨¡æ‹Ÿè¯<C3A8>æ<EFBFBD>®"

 ---

 ## ðŸ”§ ä¿®æ”¹æ–‡ä»¶

- ✅ `backend/src/modules/asl/services/screeningService.ts`
+- âœ?`backend/src/modules/asl/services/screeningService.ts`
  - æ·»åŠ PICOSå—æ®µæ˜ å°„
-  - 添加模型名映射
+  - æ·»åŠ æ¨¡åž‹å<EFBFBD><EFBFBD>æ˜ å°?
  - æ·»åŠ æ–‡çŒ®éªŒè¯<C3A8>
  - å¢žå¼ºè°ƒè¯•æ—¥å¿—

@@ -239,42 +239,42 @@ npm run dev

 ## ðŸ’¡ ç»<C3A7>éªŒæ•™è®

-### 1. 前后端数据格式一致性
- 前端使用的展示格式 ≠ 后端API格式
+### 1. å‰<EFBFBD>å<EFBFBD>Žç«¯æ•°æ<EFBFBD>®æ ¼å¼<EFBFBD>ä¸€è‡´æ€?
+- å‰<EFBFBD>ç«¯ä½¿ç”¨çš„å±•ç¤ºæ ¼å¼?â‰?å<>Žç«¯APIæ ¼å¼<C3A5>
 - éœ€è¦<C3A8>åœ¨é›†æˆ<C3A6>å±‚å<E2809A>šæ˜ å°„

-### 2. 防御性编程
- 使用 `||` 提供默认值
+### 2. é˜²å¾¡æ€§ç¼–ç¨?
+- ä½¿ç”¨ `||` æ<EFBFBD><EFBFBD>ä¾›é»˜è®¤å€?
 - éªŒè¯<C3A8>å¿…éœ€å—æ®µ
 - å…¼å®¹å¤šç§<C3A7>æ ¼å¼<C3A5>

-### 3. 调试日志的重要性
+### 3. è°ƒè¯•æ—¥å¿—çš„é‡<EFBFBD>è¦<EFBFBD>æ€?
 - æ˜¾ç¤ºæ˜ å°„å<E2809E>Žçš„å€¼ï¼ˆä¸<C3A4>æ˜¯åŽŸå§‹å€¼ï¼‰
- 输出所有关键参数
- 帮助快速定位问题
+- è¾“å‡ºæ‰€æœ‰å…³é”®å<EFBFBD>‚æ•?
+- å¸®åŠ©å¿«é€Ÿå®šä½<EFBFBD>é—®é¢?

 ---

 ## ðŸŽ¯ å<>Žç»ä¼˜åŒ–

 ### çŸæœŸ
-1. ✅ 字段映射（已完成）
-2. ✅ 模型名映射（已完成）
-3. ✅ 验证必需字段（已完成）
+1. âœ?å—æ®µæ˜ å°„ï¼ˆå·²å®Œæˆ<C3A6>ï¼?
+2. âœ?æ¨¡åž‹å<E280B9><C3A5>æ˜ å°„ï¼ˆå·²å®Œæˆ<C3A6>ï¼‰
+3. âœ?éªŒè¯<C3A8>å¿…éœ€å—æ®µï¼ˆå·²å®Œæˆ<C3A6>ï¼?

 ### ä¸æœŸ
-1. 统一前后端数据格式（使用 TypeScript 接口）
-2. 添加数据格式验证中间件
+1. ç»Ÿä¸€å‰<EFBFBD>å<EFBFBD>Žç«¯æ•°æ<EFBFBD>®æ ¼å¼<EFBFBD>ï¼ˆä½¿ç”¨ TypeScript æŽ¥å<EFBFBD>£ï¼?
+2. æ·»åŠ æ•°æ<EFBFBD>®æ ¼å¼<EFBFBD>éªŒè¯<EFBFBD>ä¸é—´ä»?
 3. æ”¹è¿›é”™è¯¯æ<C2AF><C3A6>ç¤º

 ### é•¿æœŸ
-1. 使用 tRPC 或 GraphQL 确保类型安全
-2. 自动化测试覆盖
+1. ä½¿ç”¨ tRPC æˆ?GraphQL ç¡®ä¿<EFBFBD>ç±»åž‹å®‰å…¨
+2. è‡ªåŠ¨åŒ–æµ‹è¯•è¦†ç›?
 3. SchemaéªŒè¯<C3A8>

 ---

-**报告人**: AI Assistant  
+**æŠ¥å‘Šäº?*: AI Assistant  
 **æ—¥æœŸ**: 2025-11-21  
 **ç‰ˆæœ¬**: v1.0.0