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%)
This commit is contained in:
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions

View File

@@ -2,31 +2,31 @@
**鏃ユ湡**: 2025-11-18
**闂<><E99782>**: 鍓嶇<E98D93>妯″潡鍔犺浇澶辫触
**状态**: ✅ 已修复
**鐘舵€?*: 鉁?宸蹭慨澶?
---
## 馃悰 闂<><E99782>鎻忚堪
### 错误1: React Query未配置
### 閿欒<EFBFBD>1: React Query<EFBFBD>厤缃?
```
Error: No QueryClient set, use QueryClientProvider to set one
```
**原因**: 主应用(App.tsx)缺少`QueryClientProvider`配置导致ASL模块使用`useQuery` Hook时报错。
**鍘熷洜**: 涓诲簲鐢<EFBFBD>App.tsx锛夌己灏慲QueryClientProvider`閰嶇疆锛屽<E9949B>鑷碅SL妯″潡浣跨敤`useQuery` Hook鏃舵姤閿欍€?
### 閿欒<E996BF>2: Ant Design Spin璀﹀憡
```
Warning: [antd: Spin] `tip` only work in nest or fullscreen pattern.
```
**原因**: Spin组件的`tip`属性只在特定模式下生效(`spinning={true}`或嵌套模式)。
**鍘熷洜**: Spin缁勪欢鐨刞tip`灞炴€у彧鍦ㄧ壒瀹氭ā寮忎笅鐢熸晥锛坄spinning={true}`鎴栧祵濂楁ā寮忥級銆?
---
## ✅ 修复方案
## 鉁?淇<><E6B787>鏂规<E98F82>
### 1. 添加QueryClientProvider(主应用)
### 1. 娣诲姞QueryClientProvider锛堜富搴旂敤锛?
**鏂囦欢**: `frontend-v2/src/App.tsx`
@@ -41,7 +41,7 @@ const queryClient = new QueryClient({
queries: {
staleTime: 1000 * 60 * 5, // 5鍒嗛挓
gcTime: 1000 * 60 * 10, // 10鍒嗛挓
retry: 1, // 失败重试1次
retry: 1, // 澶辫触閲嶈瘯1娆?
refetchOnWindowFocus: false, // 绐楀彛鑱氱劍鏃朵笉閲嶆柊鑾峰彇
},
},
@@ -51,13 +51,13 @@ const queryClient = new QueryClient({
function App() {
return (
<ConfigProvider locale={zhCN}>
<QueryClientProvider client={queryClient}> {/* ⭐ 新增 */}
<QueryClientProvider client={queryClient}> {/* 猸?鏂板<E98F82> */}
<PermissionProvider>
<BrowserRouter>
{/* ... */}
</BrowserRouter>
</PermissionProvider>
</QueryClientProvider> {/* ⭐ 新增 */}
</QueryClientProvider> {/* 猸?鏂板<E98F82> */}
</ConfigProvider>
)
}
@@ -70,36 +70,36 @@ function App() {
---
### 2. 修复Spin组件ASL模块
### 2. <EFBFBD><EFBFBD>Spin缁勪欢锛圓SL妯″潡锛?
**鏂囦欢**: `frontend-v2/src/modules/asl/index.tsx`
**淇<>敼鍐呭<E98D90>**:
```tsx
// 修改前
<Spin size="large" tip="加载中..." /> // ❌ 警告
// <EFBFBD>敼鍓?
<Spin size="large" tip="鍔犺浇涓?.." /> // 鉂?璀﹀憡
// 修改后
<Spin size="large" /> // ✅ 正确
// <EFBFBD>敼鍚?
<Spin size="large" /> // 鉁?姝g‘
```
**原因**: Suspense的fallback不需要显示tip文字。
**鍘熷洜**: Suspense鐨刦allback涓嶉渶瑕佹樉绀簍ip鏂囧瓧銆?
---
## 馃И 楠岃瘉缁撴灉
### 修复后测试
1. ✅ 刷新浏览器,无报错
2. ✅ 点击"AI智能文献",正常进入项目列表页
3. ✅ 控制台无警告信息
4. React Query正常工作
### <EFBFBD><EFBFBD>鍚庢祴璇?
1. 鉁?鍒锋柊娴忚<E5A8B4><EFBFBD>紝鏃犳姤閿?
2. 鉁?鐐瑰嚮"AI鏅鸿兘鏂囩尞"锛屾<E9949B>甯歌繘鍏ラ」鐩<E3808D>垪琛ㄩ〉
3. 鉁?鎺у埗鍙版棤璀﹀憡淇℃伅
4. 鉁?React Query姝e父宸ヤ綔
### 控制台输出
### 鎺у埗鍙拌緭鍑?
```
No errors
No warnings
Application loaded successfully
鉁?No errors
鉁?No warnings
鉁?Application loaded successfully
```
---
@@ -107,17 +107,17 @@ function App() {
## 馃搳 褰卞搷鑼冨洿
### 鍙楃泭妯″潡
所有使用React Query的模块都可以正常工作:
- **ASL模块**AI智能文献- 主要受益
- **AIA模块**AI问答- 未来可使用
- **PKB模块**(知识库)- 未来可使用
- **其他模块** - 统一的状态管理方案
鎵€鏈変娇鐢≧eact Query鐨勬ā鍧楅兘鍙<EFBFBD>互姝父宸ヤ綔锛?
- 鉁?**ASL妯″潡**锛圓I鏅鸿兘鏂囩尞锛? 涓昏<E6B693>鍙楃泭
- 鉁?**AIA妯″潡**锛圓I闂<49>瓟锛? 鏈<>潵鍙<E6BDB5>娇鐢?
- 鉁?**PKB妯″潡**锛堢煡璇嗗簱锛? 鏈<>潵鍙<E6BDB5>娇鐢?
- 鉁?**鍏朵粬妯″潡** - 缁熶竴鐨勭姸鎬佺<EFBFBD>鐞嗘柟妗?
### 技术价值
### 鎶€鏈<EFBFBD>环鍊?
1. **鐘舵€佺<E282AC>鐞嗙粺涓€**: 鎵€鏈夋ā鍧椾娇鐢≧eact Query
2. **性能优化**: 自动缓存、去重请求
3. **用户体验**: 更好的Loading状态管理
4. **代码质量**: 减少重复的状态管理代码
2. **鎬ц兘浼樺寲**: <EFBFBD>姩缂撳瓨銆佸幓閲嶈<EFBFBD>姹?
3. **鐢ㄦ埛浣撻獙**: 鏇村ソ鐨凩oading鐘舵€佺<EFBFBD>鐞?
4. **浠g爜璐ㄩ噺**: 鍑忓皯閲嶅<EFBFBD>鐨勭姸鎬佺<EFBFBD>鐞嗕唬鐮?
---
@@ -134,11 +134,11 @@ const queryClient = new QueryClient({
// 閫傚悎澶у<E6BEB6>鏁板満鏅<E6BA80>紝鍑忓皯涓嶅繀瑕佺殑璇锋眰
gcTime: 1000 * 60 * 10,
// 垃圾回收时间10分钟后清除缓存
// 保持合理的内存使用
// 鍨冨溇鍥炴敹鏃堕棿锛?0鍒嗛挓鍚庢竻闄ょ紦瀛?
// 淇濇寔鍚堢悊鐨勫唴瀛樹娇鐢?
retry: 1,
// 失败重试1次
// 澶辫触閲嶈瘯1娆?
// 閬垮厤杩囧<E69DA9>閲嶈瘯瀵艰嚧鐨勬€ц兘闂<E58598><E99782>
refetchOnWindowFocus: false,
@@ -149,14 +149,14 @@ const queryClient = new QueryClient({
})
```
### 为什么选择这些配置?
### 涓轰粈涔堥€夋嫨杩欎簺閰嶇疆锛?
| 配置项 | 值 | 原因 |
| 閰嶇疆椤?| 鍊?| 鍘熷洜 |
|-------|---|------|
| `staleTime` | 5鍒嗛挓 | 椤圭洰鏁版嵁鍙樺寲涓嶉<E6B693>绻侊紝鍑忓皯閲嶅<E996B2>璇锋眰 |
| `gcTime` | 10分钟 | 保持合理缓存,避免内存泄漏 |
| `retry` | 1次 | 快速失败,不过度重试 |
| `refetchOnWindowFocus` | false | 用户切换窗口时不需要重新加载 |
| `gcTime` | 10鍒嗛挓 | 淇濇寔鍚堢悊缂撳瓨锛岄伩鍏嶅唴瀛樻硠婕?|
| `retry` | 1娆?| 蹇<>€熷け璐ワ紝涓嶈繃搴﹂噸璇?|
| `refetchOnWindowFocus` | false | 鐢ㄦ埛鍒囨崲绐楀彛鏃朵笉闇€瑕侀噸鏂板姞杞?|
---
@@ -170,26 +170,26 @@ const queryClient = new QueryClient({
**闂<><E99782>**: Spin缁勪欢鐨刞tip`灞炴€ф湁浣跨敤闄愬埗
**鏁欒<E98F81>**: 鏌ラ槄瀹樻柟鏂囨。锛岀悊瑙粍浠禔PI
### 3. 前端架构分层清晰很重要
### 3. 鍓嶇<EFBFBD>鏋舵瀯鍒嗗眰娓呮櫚寰堥噸瑕?
**鏀惰幏**:
- 涓诲簲鐢<E7B0B2>紙App.tsx锛夎礋璐叏灞€閰嶇疆
- 涓氬姟妯″潡锛坅sl/锛夊彧鍏虫敞涓氬姟閫昏緫
- 清晰的职责划分避免问题
- 娓呮櫚鐨勮亴璐e垝鍒嗛伩鍏嶉棶棰?
---
## 🚀 下一步
## 馃殌 涓嬩竴姝?
修复完成后,可以继续:
1. ✅ 测试项目创建功能
2. ✅ 测试后端API联调
3. ✅ 继续Week 2 Day 2开发
<EFBFBD><EFBFBD>瀹屾垚鍚庯紝鍙<EFBFBD>互缁х画锛?
1. 鉁?娴嬭瘯椤圭洰鍒涘缓鍔熻兘
2. 鉁?娴嬭瘯鍚庣<E98D9A>API鑱旇皟
3. 鉁?缁х画Week 2 Day 2寮€鍙?
---
**淇<><E6B787>鏃堕棿**: 10鍒嗛挓
**修复难度**: ⭐ 简单
**影响范围**: ⭐⭐⭐ 全局
**<EFBFBD><EFBFBD>闅惧害**: 猸?绠€鍗?
**褰卞搷鑼冨洿**: 猸愨瓙猸?鍏ㄥ眬
**淇<><E6B787>瀹屾垚**: 2025-11-18 21:15