Files
AIclinicalresearch/docs/08-项目管理/V2.2版本变化说明.md
HaHafeng 1b53ab9d52 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

322 lines
7.6 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# V2.2版本å<EFBFBD>˜åŒè¯´æ˜Ž
> **版本ï¼?* V2.2(å‰<EFBFBD>端架构优先版ï¼?
> **å<>布日期ï¼?* 2025-11-09
> **核心å<C692>˜åŒï¼?* å‰<C3A5>端统一架构æ<E2809E><C3A6>å‰<C3A5>到Week 2 â­<C3A2>â­<C3A2>â­?
---
## 📊 V2.2 vs V2.1 核心差异
| 维度 | V2.1�| V2.2��| 为什么调整? |
|------|-------|---------|------------|
| **Week 2核心任务** | å<>Žç«¯åˆ†å± + LLMç½å…³ | **å‰<C3A5>端统一架构 + å<>Žç«¯åˆ†å±** | 架构先行,é<C592>¿å…<C3A5>ASLå¼€å<E282AC>å<E28098>Žè¿”å·¥ â­<C3A2>â­<C3A2>â­?|
| **å‰<C3A5>端架构时机** | 未明ç¡?| **Week 2上å<C5A0>Šå¨å®Œæˆ?* | ASL在统一框架ä¸å¼€å<E282AC>?|
| **LLMç½å…³å¼€å<E282AC>?* | Week 2完æˆ<C3A6> | **推迟到Week 5** | 现有调用已work,é<C592>¿å…<C3A5>过度设è®?|
| **ASLå¼€å<E282AC>环å¢?* | ç¬ç«å¼€å<E282AC>?| **统一架构ä¸å¼€å<E282AC>?* | ä¸<C3A4>需è¦<C3A8>å<EFBFBD>ŽæœŸé‡<C3A9>æž?|
| **CloseAIé…<C3A9>ç½®** | 未æ<C2AA><C3A6>å<EFBFBD>?| **已完æˆ?* | 4个LLMå<4D>¯ç”¨ï¼ˆå<CB86>«GPT-5ã€<C3A3>Claude-4.5)|
---
## 🎯 V2.2版核心ç<EFBFBD>†å¿?
### 1. 架构先行 â­<C3A2>â­<C3A2>â­?
**问题ï¼?* V2.1版中,å‰<EFBFBD>端架构时机ä¸<EFBFBD>明确
- Week 3å¼€å<E282AC>ASL时,å‰<C3A5>端还是散乱çš?
- å¼€å<E282AC>完å<C592>Žå†<C3A5>é‡<C3A9>æž„ â†?大é‡<C3A9>返工
**解决ï¼?* V2.2版将å‰<EFBFBD>端架构æ<EFBFBD><EFBFBD>å‰<EFBFBD>到Week 2
- âœ?Week 2先建ç«ç»Ÿä¸€å¸ƒå±€åŒå¯¼èˆ?
- âœ?所有模å<C2A1>—(AIAã€<C3A3>PKBã€<C3A3>审稿)æ<E280B0>ä»¶åŒæŽ¥å…?
- âœ?Week 3å¼€å<E282AC>ASLæ—¶ï¼Œç´æŽ¥åœ¨ç»Ÿä¸€æ¡†æž¶ä¸?
- âœ?ä¸<C3A4>需è¦<C3A8>å<EFBFBD>ŽæœŸé‡<C3A9>æž?
### 2. Just-in-timeå¼€å<E282AC>­<C3A2>â­<C3A2>
**问题ï¼?* V2.1版Week 2å°±è¦<C3A8>å¼€å<E282AC>LLMç½å…³
- 还没有实际使用场�
- 容易过度设计
**解决�* V2.2版推迟到Week 5
- âœ?Week 3-4 ASLå¼€å<E282AC>时,有了实际使用场æ™?
- âœ?Week 5抽å<C2BD>LLMç½å…³æ´å<C2B4>ˆç<CB86>?
- âœ?现有CloseAIé…<C3A9>置已够ç”?
### 3. è<>šç„¦æ ¸å¿ƒä»·å€?â­<C3A2>â­<C3A2>
**原则�*
- Week 1: æ•°æ<C2B0>®æž¶æž„基础 âœ?
- Week 2: **å‰<C3A5>端+å<>Žç«¯æž¶æž„统ä¸** â­?
- Week 3-4: ASL核心功能 �
- Week 5+: 优化和扩�
---
## 📋 Week 2详细对比
### V2.1版Week 2
```
Day 6-7: å<>Žç«¯ä»£ç <C3A7>分å±
Day 8-9: LLMç½å…³å¼€å<E282AC>?
Day 10: 验收
问题:å‰<EFBFBD>端架构未涉å<EFBFBD>Š
```
### V2.2版Week 2 �
```
Day 6-7(上å<C5A0>Šå¨ï¼? å‰<C3A5>端统一架构 â­<C3A2>â­<C3A2>â­?
- Day 6上å<C5A0>ˆ: å‰<C3A5>端架构设计(技术栈ã€<C3A3>模å<C2A1>—åŒã€<C3A3>导航)
- Day 6ä¸å<E280B9>ˆ-7: 实æ½ï¼ˆLayoutã€<C3A3>模å<C2A1>—注册ã€<C3A3>æ•´å<C2B4>ˆçŽ°æœ‰æ¨¡å<C2A1>—)
Day 8-9(ä¸å<E280B9>Šå¨ï¼? å<>Žç«¯ä»£ç <C3A7>分å±
- 三层目录结构
- ä¿<C3A4>留简å<E282AC>•LLM调用(够用)
Day 10: 验收 + Week 3准备
优势:å‰<EFBFBD>端架构一次到ä½?
```
---
## 🎨 å‰<C3A5>端架构设计è¦<C3A8>ç¹
### Week 2 Day 6上å<C5A0>ˆçš„æ ¸å¿ƒä»»åŠ?
**需è¦<C3A8>决ç­çš„问题ï¼?*
1. **技术栈确认**
- UI组件库:Ant Design? Material-UI?
- è·¯ç”±æ¹æ¡ˆï¼šReact Routeré…<C3A9>ç½®
- 状æ€<C3A6>管ç<C2A1>†ï¼šRedux? Zustand? ä¸<C3A4>用ï¼?
- 当å‰<C3A5>Vite构建工具是å<C2AF>¦éœ€è¦<C3A8>调整?
2. **统一布局设计**
- 顶部导航æ <C3A6>(Logoã€<C3A3>模å<C2A1>—切æ<E280A1>¢ã€<C3A3>用户信æ<C2A1>¯ï¼‰
- ä¾§è¾¹è<C2B9>œå<C593>•(收ç¼?展开ã€<C3A3>多级è<C2A7>œå<C593>•)
- 主内容区
- é<>¢åŒ…å±å¯¼èˆ?
3. **模å<C2A1>—æ<E28094>ä»¶åŒæœºåˆ?*
- 模å<C2A1>—å¦ä½•注册ï¼?
- 路由å¦ä½•动æ€<C3A6>加载?
- æ<>ƒé™<C3A9>å¦ä½•控制ï¼?
- æ ·å¼<C3A5>å¦ä½•隔离ï¼?
4. **导航结构**
- 一级导航:模å<C2A1>—级(AIAã€<C3A3>PKBã€<C3A3>ASL等)
- 二级导航:功能级(项ç®ã€<C3A3>对è¯<C3A8>ã€<C3A3>ç­é€‰ç­‰ï¼?
- å“<C3A5>应å¼<C3A5>é€é…<C3A9>
**设计原则�*
- 简å<E282AC>•易维护(å<CB86>•人开å<E282AC>)
- 模å<C2A1>—åŒæ¸…晰(支æŒ<C3A6>ç¬ç«å¼€å<E282AC>)
- æ‰©å±•æ€§å¥½ï¼ˆæ°æ¨¡å<C2A1>—快速接入)
- 用户体验佳(统一交互风格�
**说明ï¼?* è¿™äºé—®é¢˜åœ¨Week 2 Day 6上å<C5A0>ˆé†ä¸­è®¨è®ºå†³ç­ï¼Œä¸<C3A4>在计åˆä¸­è¯¦ç»†å±•å¼€ã€?
---
## 🚀 4个LLMé…<C3A9>置(æ°å¢žï¼‰
### V2.1版:å<EFBFBD>ªæ<EFBFBD><EFBFBD>到DeepSeekåŒQwen
### V2.2版:4个LLM完整é…<EFBFBD>ç½® â­?
**已完æˆ<C3A6>é…<C3A9>置(CloseAI):**
1. **DeepSeek-V3** (直连)
- 用途:快速åˆ<C3A5>ç­ï¼Œæˆ<C3A6>本ä½?
- 价格:�.001/1K tokens
2. **GPT-5-Pro** (CloseAI代ç<C2A3>†) â­?新增
- 用途:精准ç­é€‰ï¼Œè´¨é‡<C3A9>é«?
- 价格:�.10/1K tokens
- Model ID: `gpt-5-pro`
3. **Claude-4.5-Sonnet** (CloseAI代ç<C2A3>†) â­?新增
- 用途:冲çª<C3A7>仲è£<C3A8>,结构åŒè¾“出
- 价格:�.021/1K tokens
- Model ID: `claude-sonnet-4-5-20250929`
4. **Qwen-Max** (备�
- ç”¨é€”ï¼šé•¿æ‡æœ¬å¤„ç<E2809E>†ï¼Œæ€§ä»·æ¯”高
- 价格:�.004/1K tokens
**筛选策略:**
- **å<>Œæ¨¡åžå¯¹æ¯?*(DeepSeek + GPT-5ï¼? 推è<C2A8><C3A8> â­?
- **三模型仲è£?*ï¼?Claudeï¼? 冲çª<C3A7>æ—¶å<C2B6>¯ç”?
- **æˆ<C3A6>本优åŒ**ï¼?0% DeepSeekï¼?0% GPT-5ï¼?
**é…<C3A9>ç½®æ‡æ¡£ï¼?*
- `02-通用能力å±?01-LLM大模åžç½å…?03-CloseAI醿ˆ<C3A6>指å<E280A1>—.md` â­?
- `07-è¿<C3A8>ç»´æ‡æ¡£/01-环境é…<C3A9>置指å<E280A1>—.md`
- `backend/CLOSEAI-CONFIG.md`
---
## �V2.2版优势总结
### 核心优势 â­<C3A2>â­<C3A2>â­?
**1. é<>¿å…<C3A5>返工(最大价值)**
```
V2.1版æµ<EFBFBD>ç¨ï¼š
Week 2: å<>Žç«¯åˆ†å±
Week 3-4: ASLå¼€å<E282AC>(å‰<C3A5>端散乱ï¼?
Week 5: å<>现需è¦<C3A8>é‡<C3A9>æž„å‰<C3A5>ç«?â†?返工 â<>?
V2.2版æµ<EFBFBD>ç¨ï¼š
Week 2: å‰<C3A5>端架构先完æˆ?
Week 3-4: ASLç´æŽ¥åœ¨ç»Ÿä¸€æ¡†æž¶ä¸å¼€å<E282AC>?
Week 5: 继续扩展,ä¸<C3A4>需è¦<C3A8>é‡<C3A9>æž?âœ?
```
**2. å¼€å<E282AC>效率æ<E280A1><C3A6>å<EFBFBD>?*
- Week 3å¼€å<E282AC>ASL时,å‰<C3A5>端框架已就ç»?
- å<>ªéœ€å…³æ³¨ä¸šåС逻è¾ï¼Œä¸<C3A4>ç”¨è€ƒè™æž¶æž„
- 模å<C2A1>—æ<E28094>ä»¶åŒï¼Œä»£ç <C3A7>结构清晰
**3. è´¨é‡<C3A9>ä¿<C3A4>è¯<C3A8>**
-¸ªLLMå·²é…<C3A9>置好(å<CB86>«GPT-5åŒClaude-4.5ï¼?
- 统一的用户体�
- 便于测试和维�
**4. ç<>µæ´»æ‰©å±•**
- æ°æ¨¡å<C2A1>—ç´æŽ¥æ<C2A5>入统一框架
- ä¸<C3A4>å½±å“<C3A5>现有模å<C2A1>?
- å‰<C3A5>端架构稳定
---
## ðŸ“<C5B8> 关键决策记录
### 决ç­1:å‰<C3A5>端架构æ<E2809E><C3A6>å‰<C3A5>到Week 2
**背景�*
- 用户å<C2B7><C3A5>馈:å‰<C3A5>端å<C2AF>„模å<C2A1>—ç¬ç«æ•£ä¹±ï¼Œéœ€è¦<C3A8>统ä¸
- ASL是é‡<C3A9>ç¹æ¨¡å<C2A1>—,ä¸<C3A4>应该在散乱架构ä¸å¼€å<E282AC>?
**决策�*
- Week 2上å<C5A0>Šå¨ä¼˜å…ˆå®Œæˆ<C3A6>å‰<C3A5>端统一架构
- å»ºç«æ¨¡å<C2A1>—æ<E28094>ä»¶åŒæœºåˆ?
- ASL在统一框架ä¸å¼€å<E282AC>?
**收益�*
- é<>¿å…<C3A5>ASLå¼€å<E282AC>å<E28098>Žé‡<C3A9>æž„
- æ<><C3A6>å<EFBFBD>‡å¼€å<E282AC>效çŽ?
- ä¿<C3A4>è¯<C3A8>用户体验一致æ€?
---
### 决ç­2:LLMç½å…³æŽ¨è¿Ÿåˆ°Week 5
**背景�*
- 现有DeepSeekåŒQwen调用已work
- CloseAIé…<C3A9>置已完æˆ<C3A6>(GPT-5ã€<C3A3>Claude-4.5å<EFBFBD>¯ç”¨ï¼?
- Week 2时间有é™<C3A9>,需è¦<C3A8>è<EFBFBD>šç„¦å‰<C3A5>端架æž?
**决策�*
- Week 2å<32>ªä¿<C3A4>留简å<E282AC>•LLM调用
- Week 3-4 ASLå¼€å<E282AC>时使用现有调用
- Week 5有了实践ç»<C3A7>验,å†<C3A5>统一抽å<C2BD>LLMç½å…³
**收益�*
- é<>¿å…<C3A5>过度设计
- è<>šç„¦æ ¸å¿ƒä»·å€?
- Just-in-timeå¼€å<E282AC>?
---
### 决ç­3ï¼šé†æˆ<C3A6>CloseAI(GPT-5åŒClaude-4.5ï¼?
**背景�*
- AI智能æ‡çŒ®éœ€è¦<C3A8>高质é‡<C3A9>çš„LLM
- DeepSeek虽快但准确率85%
- GPT-5åŒClaude-4.5准确çŽ?5%+
**决策�*
- é…<C3A9>ç½®CloseAI代ç<C2A3>†ï¼ˆå·²å®Œæˆ<C3A6>ï¼?
-¸ªLLM组å<E2809E>ˆä½¿ç”¨
- å<>Œæ¨¡åžå¯¹æ¯?+ 三模型仲è£?
**收益�*
- æ‡çŒ®ç­é€‰è´¨é‡<C3A9>大幅æ<E280A6><C3A6>å<EFBFBD>?
- æˆ<C3A6>本å<C2AC>¯æŽ§ï¼ˆç<CB86>µæ´»ç­ç•¥ï¼‰
- 国内稳定访问
---
## 🎯 执行建议
### 妿žœè¿˜æ²¡å¼€å§Week 1
1. 按V2.2版执�
2. Week 1é‡<C3A9>ç¹ï¼šSchema隔离ï¼?详细+7空)
3. Week 2é‡<C3A9>ç¹ï¼?*å‰<C3A5>端架构优先** â­<C3A2>â­<C3A2>â­?
### 妿žœWeek 1已完æˆ?
1. **ç«å<E280B9>³å<C2B3>¯åЍWeek 2å‰<C3A5>端架构设计**
2. Day 6上å<C5A0>ˆï¼šå‰<C3A5>端架构设计会è®?â­?
3. Day 6ä¸å<E280B9>ˆ-7:实æ½å‰<C3A5>端统一架构
4. Day 8-9:å<C5A1>Žç«¯ä»£ç <C3A7>分å±?
### 妿žœå·²ç»<C3A7>在开å<E282AC>ASL
1. **æšå<E2809A>œASLå¼€å<E282AC>?*
2. **è¡¥å<C2A5>šå‰<C3A5>端统一架构**
3. å°†ASLé‡<C3A9>构到统一框架ä¸?
4. 虽然会有一点返工,但长远更�
---
## 📚 相关文档
**V2.2版完整计划:**
- [下一阶段行动计划-V2.2-å‰<C3A5>端架构优先ç‰?md](./下一阶段行动计划-V2.2-å‰<C3A5>端架构优先ç‰?md) â­<C3A2>â­<C3A2>â­?
**å‰<C3A5>端架构å<E2809E>考:**
- [å‰<EFBFBD>端总体架构设计](../01-å¹³å<C2B3>°åŸºç¡€å±?06-å‰<C3A5>端架构/01-å‰<C3A5>端总体架构设计.md)
- [导航结构设计](../01-å¹³å<C2B3>°åŸºç¡€å±?06-å‰<C3A5>端架构/02-导航结构设计.md)
**LLMé…<C3A9>ç½®å<C2AE>考:**
- [CloseAI醿ˆ<EFBFBD>指å<EFBFBD>](../02-通用能力å±?01-LLM大模åžç½å…?03-CloseAI醿ˆ<C3A6>指å<E280A1>—.md) â­?
- [环境é…<EFBFBD>置指å<EFBFBD>](../07-è¿<C3A8>ç»´æ‡æ¡£/01-环境é…<C3A9>置指å<E280A1>—.md)
**V2.1版对比:**
- [下一阶段行动计划-V2.1-务实�md](./下一阶段行动计划-V2.1-务实�md)
---
**更新日期�* 2025-11-09
**制定人:** AI助æ‰
**核心ç<C692>†å¿µï¼?* 架构先行 + Just-in-time + è<>šç„¦æ ¸å¿ƒ = 高效务实ï¼?â­<C3A2>â­<C3A2>â­?