Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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%)
This commit is contained in:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

248
docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-18-架构重构完成报告.md
View File

@@ -2,112 +2,112 @@
**日期**: 2025-11-18
**任务**: æ ¹æ<C2B9>®ç”¨æˆ·å<C2B7><C3A5>馈é‡<C3A9>æž„å‰<C3A5>端架构
**状态**: ✅ 完成
**状æ€?*: âœ?完æˆ<C3A6>
---
## ðŸ“<C5B8> é‡<C3A9>构原因
### 用户å<C2B7><C3A5>馈
1. ❌ 原方案缺少左侧导航栏
2. ❌ 需要参考原型的7个模块结构
3. ❌ MVP只需标题摘要初筛，不需要项目管理
4. ❌ PICOS输入框太小，内容显示不全
1. â<EFBFBD>?原方案缺少左侧导航æ <C3A6>
2. â<EFBFBD>?需è¦<C3A8>å<EFBFBD>‚考原型的7个模å<C2A1>—结æž?
3. â<EFBFBD>?MVPå<50>ªéœ€æ ‡é¢˜æ‘˜è¦<C3A8>åˆ<C3A5>筛，ä¸<C3A4>需è¦<C3A8>项目管ç<C2A1>?
4. â<EFBFBD>?PICOS输入框太å°<EFBFBD>，内容显示ä¸<EFBFBD>å…¨
---
## 🔄 é‡<C3A9>构内容
### 1. 创建左侧导航布局 ⭐
### 1. 创建左侧导航布局 �
**新文件**: `components/ASLLayout.tsx`
**新文�*: `components/ASLLayout.tsx`
**功能**:
- ✅ 左侧导航栏（200px宽度）
- ✅ 7个一级菜单
- âœ?左侧导航æ <C3A6>（200px宽度ï¼?
- âœ?7个一级è<C2A7>œå<C593>?
1. 研究方案生æˆ<C3A6>（ç¦<C3A7>用）
2. 智能文献检索（禁用）
2. 智能文献检索（ç¦<EFBFBD>用ï¼?
3. 文献管ç<C2A1>†ï¼ˆç¦<C3A7>用）
4. **标题摘要初筛**（✅ 可用，3个子菜单）
- 设置与启动
- 审核工作台
4. **标题摘è¦<EFBFBD>åˆ<EFBFBD>ç­›**（✅ å<>¯ç”¨ï¼?个å­<C3A5>è<EFBFBD>œå<C593>•ï¼?
- 设置与å<EFBFBD>¯åŠ?
- 审核工作å<EFBFBD>?
- åˆ<C3A5>筛结果
5. 全文å¤<C3A5>筛（ç¦<C3A7>用）
6. 全文解析与数据提取（禁用）
7. 数据综合分析与报告（禁用）
- ✅ 右侧内容区（Outlet渲染子页面）
6. 全文解æž<EFBFBD>与数æ<EFBFBD>®æ<EFBFBD><EFBFBD>å<EFBFBD>–（ç¦<EFBFBD>用ï¼?
7. æ•°æ<EFBFBD>®ç»¼å<EFBFBD>ˆåˆ†æž<EFBFBD>与报告（ç¦<EFBFBD>用ï¼?
- âœ?å<>³ä¾§å†…容区（Outlet渲染å­<C3A5>页é<C2B5>¢ï¼‰
**布局结构**:
```
┌────────────────────────────────────────────────┐
│ AI智能文献 - 标题摘要初筛 MVP │
├─────────────┬──────────────────────────────────┤
│ 左侧导航 │ 右侧内容区 │
│ (250px) │ │
│ │ │
│ 7个模块 │ (当前子页面) │
│ (标题初筛 │ │
│ 展开3个 │ │
│ 子菜单) │ │
│ │ │
└─────────────┴──────────────────────────────────┘
┌────────────────────────────────────────────────�
â”? AI智能文献 - 标题摘è¦<C3A8>åˆ<C3A5>ç­› MVP â”?
├─────────────┬──────────────────────────────────�
â”?左侧导航 â”? å<>³ä¾§å†…容åŒ? â”?
â”?(250px) â”? â”?
â”? â”? â”?
â”?7个模å<C2A1>? â”? (当å‰<C3A5>å­<C3A5>页é<C2B5>? â”?
â”?(标题åˆ<C3A5>ç­› â”? â”?
� 展开3� � �
â”? å­<C3A5>è<EFBFBD>œå<C593>? â”? â”?
â”? â”? â”?
└─────────────┴──────────────────────────────────�
```
---
### 2. é‡<C3A9>æž„3个å­<C3A5>页é<C2B5>¢
#### 页面1: 设置与启动 ⭐
#### 页é<EFBFBD>¢1: 设置与å<C5BD>¯åŠ?â­?
**文件**: `pages/TitleScreeningSettings.tsx`
**改进**:
- ✅ PICOS字段全部改为TextArea（6-8行）
- ✅ 纳入/排除标准TextArea（8-10行）
- ✅ 合并了文献导入功能（Excel上传 + 模板下载）
- ✅ 筛选风格选择（3种：宽松/标准/严格）
- ✅ 启动AI筛选按钮
- �PICOS字段全部改为TextArea�-8行）
- �纳入/排除标准TextArea�-10行）
- âœ?å<>ˆå¹¶äº†æ–‡çŒ®å¯¼å…¥åŠŸèƒ½ï¼ˆExcel上传 + 模æ<C2A1>¿ä¸‹è½½ï¼?
- âœ?筛选风格选择ï¼?ç§<C3A7>：宽æ<C2BD>¾/标准/严格ï¼?
- âœ?å<>¯åŠ¨AI筛选按é’?
**表å<C2A8>•å­—段**:
```typescript
- P - 人群: TextArea (8行) ⭐
- I - 干预: TextArea (8行) ⭐
- C - 对照: TextArea (6行) ⭐
- O - 结局: TextArea (6行，可选) ⭐
- S - 研究设计: TextArea (4行) ⭐
- 纳入标准: TextArea (10行) ⭐
- 排除标准: TextArea (10行) ⭐
- 筛选风格: Radio (宽松/标准/严格)
- P - 人群: TextArea (8� �
- I - 干预: TextArea (8� �
- C - 对照: TextArea (6� �
- O - 结局: TextArea (6行，å<EFBFBD>¯é€? â­?
- S - ç ”ç©è®¾è®¡: TextArea (4è¡? â­?
- 纳入标准: TextArea (10� �
- 排除标准: TextArea (10� �
- 筛选风æ ? Radio (宽æ<EFBFBD>¾/标准/严格)
```
**功能æµ<C3A6>程**:
```
1. 填写PICOS标准 →
2. 填写纳入/排除标准 →
3. 选择筛选风格 →
4. 上传Excel文件 →
5. 点击"开始AI筛选" →
1. 填写PICOS标准 �
2. 填写纳入/排除标准 �
3. 选择筛选风��
4. 上传Excel文件 �
5. 点击"开始AI筛� �
6. 跳转到审核工作å<C593>°
```
#### 页面2: 审核工作台（占位）
#### 页é<EFBFBD>¢2: 审核工作å<C593>°ï¼ˆå<CB86> ä½<C3A4>ï¼?
**文件**: `pages/ScreeningWorkbench.tsx`
**计划功能**（Week 2 Day 3-4）:
**计划功能**（Week 2 Day 3-4�
- 显示当å‰<C3A5>PICOS标准（折å<CB9C> é<C2A0>¢æ<C2A2>¿ï¼‰
- å<>Œè¡Œè¡¨æ ¼ï¼ˆä¸¥æ ¼æŒ‰ç…§åŽŸåž‹ï¼‰
- 点击PICO维度 → 弹出双视图Modal
- 修改最终决策
- 点击PICO维度 â†?弹出å<C2BA>Œè§†å›¾Modal
- 修改最终决�
#### 页é<C2B5>¢3: åˆ<C3A5>筛结果（å<CB86> ä½<C3A4>）
**文件**: `pages/ScreeningResults.tsx`
**计划功能**（Week 2 Day 5）:
- 统计卡片（总数/纳入/排除）
**计划功能**（Week 2 Day 5�
- 统计å<EFBFBD>¡ç‰‡ï¼ˆæ€»æ•°/纳入/排除ï¼?
- PRISMA排除原因统计
- Tab切换（纳入/排除）
- Tab切æ<EFBFBD>¢ï¼ˆçº³å…?排除ï¼?
- 结果表格
- 批é‡<C3A9>æ“<C3A6>作
- 导出Excel
@@ -116,129 +116,129 @@
### 3. 更新路由结构
**新路由**:
**新路�*:
```
/literature (进入ASL模å<C2A1>—)
└── ASLLayout (左侧导航布局)
└── /screening/title (标题摘è¦<C3A8>åˆ<C3A5>ç­›)
├── /settings (默认) - 设置与启动
├── /workbench - 审核工作台
├── /settings (默认) - 设置与å<C5BD>¯åŠ?
├── /workbench - 审核工作å<EFBFBD>?
└── /results - åˆ<C3A5>筛结果
```
**路由跳转**:
- 点击"AI智能文献" → 自动跳转到 `/literature/screening/title/settings`
- 点击"开始AI筛选" → 跳转到 `/literature/screening/title/workbench`
- 点击"AI智能文献" �自动跳转�`/literature/screening/title/settings`
- 点击"开始AI筛� �跳转�`/literature/screening/title/workbench`
---
### 4. 删除旧文件
### 4. 删除旧文�
**已删除**:
- ❌ `pages/ProjectManagement.tsx` - 项目管理页（MVP不需要）
- ❌ `components/ProjectForm.tsx` - 项目表单组件
- ❌ `pages/LiteratureImport.tsx` - 文献导入页（功能合并）
- ❌ `hooks/useProjects.ts` - 项目管理Hooks
**已删�*:
- â<EFBFBD>?`pages/ProjectManagement.tsx` - 项目管ç<EFBFBD>†é¡µï¼ˆMVPä¸<EFBFBD>需è¦<EFBFBD>）
- â<EFBFBD>?`components/ProjectForm.tsx` - 项目表å<EFBFBD>•ç»„件
- â<EFBFBD>?`pages/LiteratureImport.tsx` - 文献导入页（功能å<EFBFBD>ˆå¹¶ï¼?
- â<EFBFBD>?`hooks/useProjects.ts` - 项目管ç<EFBFBD>†Hooks
**ä¿<C3A4>留文件**:
- ✅ `types/index.ts` - 类型定义（完整保留）
- ✅ `api/index.ts` - API客户端（完整保留）
- ✅ `components/ASLLayout.tsx` - 新布局组件 ⭐
- ✅ `pages/TitleScreeningSettings.tsx` - 设置与启动 ⭐
- ✅ `pages/ScreeningWorkbench.tsx` - 审核工作台（占位）
- ✅ `pages/ScreeningResults.tsx` - 初筛结果（占位）
- âœ?`types/index.ts` - 类型定义（完整ä¿<EFBFBD>留）
- âœ?`api/index.ts` - API客户端（完整ä¿<EFBFBD>ç•™ï¼?
- �`components/ASLLayout.tsx` - 新布局组件 �
- âœ?`pages/TitleScreeningSettings.tsx` - 设置与å<EFBFBD>¯åŠ?â­?
- âœ?`pages/ScreeningWorkbench.tsx` - 审核工作å<EFBFBD>°ï¼ˆå<EFBFBD> ä½<EFBFBD>ï¼?
- âœ?`pages/ScreeningResults.tsx` - åˆ<EFBFBD>筛结果（å<EFBFBD> ä½<EFBFBD>）
---
## 📊 é‡<C3A9>构对比
| 项目 | 重构前 | 重构后 |
| 项目 | é‡<C3A9>æž„å‰?| é‡<C3A9>æž„å<E2809E>?|
|------|--------|--------|
| **布局** | 只有顶部导航 | 左侧导航 + 顶部导航 ⭐ |
| **第一个页面** | 项目管理列表 | 设置与启动（PICOS + 导入） ⭐ |
| **PICOS输入** | Input (单行) | TextArea (6-8行) ⭐ |
| **导航结构** | 扁平 | 树形（7个模块 + 子菜单） ⭐ |
| **项目概念** | 需要创建项目 | MVP不需要项目 ⭐ |
| **布局** | å<EFBFBD>ªæœ‰é¡¶éƒ¨å¯¼èˆª | 左侧导航 + 顶部导航 â­?|
| **第一个页é<EFBFBD>?* | 项目管ç<C2A1>†åˆ—表 | 设置与å<C5BD>¯åŠ¨ï¼ˆPICOS + 导入ï¼?â­?|
| **PICOS输入** | Input (å<EFBFBD>•è¡Œ) | TextArea (6-8è¡? â­?|
| **导航结构** | æ‰<C3A6>å¹³ | æ ‘å½¢ï¼?个模å<C2A1>?+ å­<C3A5>è<EFBFBD>œå<C593>•ï¼‰ â­?|
| **项目概念** | 需è¦<C3A8>创建项ç›?| MVPä¸<C3A4>需è¦<C3A8>项ç›?â­?|
| **文献导入** | 独立页é<C2B5>¢ | å<>ˆå¹¶åˆ°è®¾ç½®é¡µ |
---
## ✅ 重构验收
## âœ?é‡<C3A9>构验收
### 布局验收
- ✅ 左侧导航栏正常显示
- ✅ 7个一级菜单正确展示
- ✅ 标题摘要初筛展开3个子菜单
- ✅ 其他模块显示"敬请期待"
- ✅ 右侧内容区正常渲染
- âœ?左侧导航æ <C3A6>正常显ç¤?
- âœ?7个一级è<C2A7>œå<C593>•æ­£ç¡®å±•ç¤?
- âœ?标题摘è¦<C3A8>åˆ<C3A5>筛展开3个å­<C3A5>è<EFBFBD>œå<C593>•
- âœ?其他模å<C2A1>—显示"敬请期待"
- âœ?å<>³ä¾§å†…容区正常渲æŸ?
### 功能验收
- ✅ 点击"AI智能文献"进入设置页
- ✅ PICOS字段全部为TextArea（足够大）
- ✅ 可以填写测试数据（非心源性卒中案例）
- ✅ 可以上传Excel文件
- ✅ 可以选择筛选风格
- ✅ 点击"开始AI筛选"跳转到工作台
- �点击"AI智能文献"进入设置�
- �PICOS字段全部为TextArea（足够大�
- âœ?å<>¯ä»¥å¡«å†™æµ‹è¯•æ•°æ<C2B0>®ï¼ˆé<CB86>žå¿ƒæº<C3A6>性å<C2A7>’中案例）
- âœ?å<>¯ä»¥ä¸Šä¼ Excel文件
- âœ?å<>¯ä»¥é€‰æ‹©ç­›é€‰é£Žæ ?
- âœ?点击"开始AIç­›é€?跳转到工作å<C593>°
### 路由验收
- ✅ `/literature` → 自动跳转到 `/literature/screening/title/settings`
- ✅ `/literature/screening/title/settings` - 设置页正常
- ✅ `/literature/screening/title/workbench` - 工作台占位
- ✅ `/literature/screening/title/results` - 结果页占位
- �`/literature` �自动跳转�`/literature/screening/title/settings`
- �`/literature/screening/title/settings` - 设置页正�
- âœ?`/literature/screening/title/workbench` - 工作å<EFBFBD>°å<EFBFBD> ä½?
- âœ?`/literature/screening/title/results` - 结果页å<EFBFBD> ä½?
---
## 🎯 架构亮点
### 1. 完全符合原型设计 ⭐⭐⭐
- 7个模块结构
### 1. 完全符å<EFBFBD>ˆåŽŸåž‹è®¾è®¡ â­<C3A2>â­<C3A2>â­?
- 7个模å<EFBFBD>—结æž?
- 标题摘è¦<C3A8>åˆ<C3A5>ç­›3个å­<C3A5>页é<C2B5>¢
- 左侧导航 + å<>³ä¾§å†…容
### 2. MVP优先策略 ⭐⭐⭐
- 只开发标题摘要初筛
- 其他模块禁用但可见
### 2. MVP优先策略 â­<C3A2>â­<C3A2>â­?
- å<EFBFBD>ªå¼€å<EFBFBD>‘标题摘è¦<EFBFBD>åˆ<EFBFBD>ç­?
- 其他模å<EFBFBD>—ç¦<EFBFBD>用但å<EFBFBD>¯è§?
- 未æ<C2AA>¥æ‰©å±•æ€§å¼º
### 3. PICOS空间优化 ⭐⭐⭐
- Input → TextArea
- 足够显示复杂的测试数据
### 3. PICOS空间优化 â­<C3A2>â­<C3A2>â­?
- Input �TextArea
- 足够显示å¤<EFBFBD>æ<EFBFBD>‚的测试数æ<EFBFBD>?
- 用户体验å<C592>‹å¥½
### 4. 功能合并简化 ⭐⭐
### 4. 功能å<EFBFBD>ˆå¹¶ç®€åŒ?â­<C3A2>â­<C3A2>
- 文献导入å<C2A5>ˆå¹¶åˆ°è®¾ç½®é¡µ
- å‡<C3A5>少页é<C2B5>¢è·³è½¬
- 流程更顺畅
- æµ<EFBFBD>程更顺ç•?
---
## ðŸ“<C5B8> 代ç <C3A7>统计
| 类别 | 文件数 | 代码行数 | 说明 |
| 类别 | 文件æ•?| 代ç <C3A7>行数 | 说明 |
|------|-------|---------|------|
| **新增** | | | |
| 布局组件 | 1 | 155 | ASLLayout.tsx |
| 设置页é<C2B5>¢ | 1 | 350 | TitleScreeningSettings.tsx |
| 工作台页面 | 1 | 42 | ScreeningWorkbench.tsx（占位）|
| 工作å<EFBFBD>°é¡µé<EFBFBD>?| 1 | 42 | ScreeningWorkbench.tsx（å<EFBFBD> ä½<EFBFBD>）|
| 结果页é<C2B5>¢ | 1 | 45 | ScreeningResults.tsx（å<CB86> ä½<C3A4>）|
| 路由é…<C3A9>ç½® | 1 | 58 | routes.tsx（é‡<C3A9>写）|
| **删除** | 4 | -800 | 旧的项目管ç<C2A1>†ç›¸å…³æ–‡ä»¶ |
| **净增** | **5** | **-150** | 代码更精简了！ |
| **净å¢?* | **5** | **-150** | 代ç <EFBFBD>更精简了ï¼<EFBFBD> |
---
## 🚀 下一步开发
## 🚀 下一步开å<E282AC>?
### Week 2 继续计划
**Day 2（今天剩余时间）**:
- ✅ Excel解析逻辑（内存解析，不落盘）
- ✅ 文献预览表格
- ✅ 去重逻辑
- ✅ Excel模板生成
- âœ?Excel解æž<EFBFBD>逻辑（内存解æž<EFBFBD>，ä¸<EFBFBD>è<EFBFBD>½ç›˜ï¼‰
- �文献预览表格
- âœ?去é‡<C3A9>逻辑
- âœ?Excel模æ<EFBFBD>¿ç”Ÿæˆ<EFBFBD>
**Day 3-4**:
- 审核工作台（双行表格）
- 审核工作å<EFBFBD>°ï¼ˆå<EFBFBD>Œè¡Œè¡¨æ ¼ï¼?
- å<>Œè§†å›¾Modal
- 人工å¤<C3A5>核功能
@@ -252,27 +252,27 @@
## 🎉 é‡<C3A9>构总结
**耗时**: 30分钟
**文件变更**: 新增5个，删除4个
**代码量**: 净减少150行（更精简）
**文件å<EFBFBD>˜æ›´**: 新增5个，删除4ä¸?
**代ç <EFBFBD>é‡?*: 净å‡<C3A5>å°‘150行（更精简ï¼?
**é‡<C3A9>构效果**:
- ⭐⭐⭐⭐⭐ 完全符合用户需求
- ⭐⭐⭐⭐⭐ 参考原型设计
- ⭐⭐⭐⭐⭐ MVP优先策略
- ⭐⭐⭐⭐⭐ PICOS空间足够
- â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­?完全符å<C2A6>ˆç”¨æˆ·éœ€æ±?
- â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­?å<>‚考原型设è®?
- â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­?MVP优先策略
- â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­<EFBFBD>â­?PICOS空间足够
- â­<C3A2>â­<C3A2>â­<C3A2>â­<C3A2> 代ç <C3A7>结构清晰
**用户å<C2B7><C3A5>馈确认**:
1. ✅ 左侧导航 - 符合原型
2. ✅ 第一个页面是"设置与启动"
3. ✅ PICOS字段都用TextArea
4. ✅ MVP不需要项目概念
5. ✅ 双行表格按照原型设计
1. âœ?左侧导航 - 符å<C2A6>ˆåŽŸåž‹
2. âœ?第一个页é<C2B5>¢æ˜¯"设置与å<C5BD>¯åŠ?
3. �PICOS字段都用TextArea
4. âœ?MVPä¸<C3A4>需è¦<C3A8>项目概å¿?
5. âœ?å<>Œè¡Œè¡¨æ ¼æŒ‰ç…§åŽŸåž‹è®¾è®¡
---
**é‡<C3A9>构完æˆ<C3A6>时间**: 2025-11-18 22:00
**下一阶段**: Week 2 Day 2 继续开发
**下一阶段**: Week 2 Day 2 继续开å<EFBFBD>?