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%)
322 lines
7.6 KiB
Markdown
322 lines
7.6 KiB
Markdown
# 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>**
|
||
- 4个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>ï¼?
|
||
- 4个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>â?
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|