HaHafeng
1b53ab9d52
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%)
242 lines
6.6 KiB
Markdown
242 lines
6.6 KiB
Markdown
# PKB妯″潡鍓嶇<E98D93>V3璁捐<E79281>瀹炵幇 - 寮€鍙戣<E98D99>褰?
|
||
|
||
> **鏃ユ湡锛?* 2026-01-07
|
||
> **寮€鍙戣€咃細** PKB寮€鍙戝洟闃?
|
||
> **鐗堟湰锛?* v1.0
|
||
> **鐘舵€侊細** 鉁?鍩虹<E98DA9>妗嗘灦瀹屾垚锛屽緟缁嗗寲浼樺寲
|
||
|
||
---
|
||
|
||
## 馃搵 浠婃棩宸ヤ綔姒傝堪
|
||
|
||
浠婂ぉ瀹屾垚浜哖KB锛堜釜浜虹煡璇嗗簱锛夋ā鍧楃殑鍓嶇<EFBFBD>杩佺Щ鍜孷3璁捐<EFBFBD>瀹炵幇宸ヤ綔锛屼富瑕佸寘鎷<EFBFBD>細
|
||
|
||
1. **鍚庣<E98D9A>妯″潡杩佺Щ**锛氬皢PKB鍚庣<E98D9A>浠ｇ爜杩佺Щ鍒版柊鐨勬ā鍧楀寲鏋舵瀯
|
||
2. **鍓嶇<E98D93>V3璁捐<E79281>瀹炵幇**锛氬熀浜庡師鍨嬪浘瀹炵幇Dashboard鍜學orkspace椤甸潰
|
||
3. **3绉嶅伐浣滄ā寮忓疄鐜?*锛氬叏鏂囬槄璇汇€侀€愮瘒绮捐<E7BBAE>銆佹壒澶勭悊
|
||
4. **Chat缁勪欢闆嗘垚**锛氫娇鐢ˋnt Design X Chat缁勪欢瀹炵幇AI瀵硅瘽
|
||
|
||
---
|
||
|
||
## 鉁?瀹屾垚鐨勫伐浣?
|
||
|
||
### 1. 鍚庣<E98D9A>妯″潡杩佺Щ
|
||
|
||
**杩佺Щ鍐呭<E98D90>**锛?
|
||
- 灏咰ontroller銆丼ervice銆丷oute浠ｇ爜杩佺Щ鍒?`backend/src/modules/pkb/`
|
||
- 鏇存柊import璺<74>緞
|
||
- 娉ㄥ唽鏂癆PI璺<49>敱 `/api/v1/pkb/*`
|
||
- 淇濇寔鏃х増璺<E5A297>敱 `/api/v1/knowledge*` 鍏煎<E98D8F>
|
||
|
||
**鐩<>綍缁撴瀯**锛?
|
||
```
|
||
backend/src/modules/pkb/
|
||
鈹溾攢鈹€ controllers/
|
||
鈹? 鈹溾攢鈹€ knowledgeBaseController.ts
|
||
鈹? 鈹溾攢鈹€ documentController.ts
|
||
鈹? 鈹斺攢鈹€ batchController.ts
|
||
鈹溾攢鈹€ services/
|
||
鈹? 鈹溾攢鈹€ knowledgeBaseService.ts
|
||
鈹? 鈹溾攢鈹€ documentService.ts
|
||
鈹? 鈹斺攢鈹€ batchService.ts
|
||
鈹溾攢鈹€ routes/
|
||
鈹? 鈹斺攢鈹€ index.ts
|
||
鈹斺攢鈹€ index.ts
|
||
```
|
||
|
||
**璺<>敱娉ㄥ唽**锛?
|
||
- v2璺<32>敱锛歚/api/v1/pkb/knowledge`锛堟柊鏋舵瀯锛?
|
||
- v1璺<31>敱锛歚/api/v1/knowledge`銆乣/api/v1/batch-tasks`锛堝吋瀹癸級
|
||
|
||
### 2. 鍓嶇<E98D93>V3璁捐<E79281>瀹炵幇
|
||
|
||
**鍩轰簬鍘熷瀷鍥?*锛?
|
||
- `鐭ヨ瘑搴撲华琛ㄧ洏V5.html` 鈫?DashboardPage
|
||
- `宸ヤ綔鍙癡3.html` 鈫?WorkspacePage
|
||
|
||
**鍓嶇<E98D93>鐩<EFBFBD>綍缁撴瀯**锛?
|
||
```
|
||
frontend-v2/src/modules/pkb/
|
||
鈹溾攢鈹€ api/
|
||
鈹? 鈹斺攢鈹€ knowledgeBaseApi.ts # API瀹㈡埛绔?
|
||
鈹溾攢鈹€ stores/
|
||
鈹? 鈹斺攢鈹€ useKnowledgeBaseStore.ts # Zustand鐘舵€佺<E282AC>鐞?
|
||
鈹溾攢鈹€ pages/
|
||
鈹? 鈹溾攢鈹€ DashboardPage.tsx # 浠<>〃鐩橀〉闈?
|
||
鈹? 鈹斺攢鈹€ WorkspacePage.tsx # 宸ヤ綔鍙伴〉闈?
|
||
鈹溾攢鈹€ components/
|
||
鈹? 鈹斺攢鈹€ Workspace/
|
||
鈹? 鈹溾攢鈹€ WorkModeSelector.tsx # 宸ヤ綔妯″紡閫夋嫨鍣?
|
||
鈹? 鈹溾攢鈹€ FullTextMode.tsx # 鍏ㄦ枃闃呰<E99783>妯″紡
|
||
鈹? 鈹溾攢鈹€ DeepReadMode.tsx # 閫愮瘒绮捐<E7BBAE>妯″紡
|
||
鈹? 鈹溾攢鈹€ BatchMode.tsx # 鎵瑰<E98EB5>鐞嗘ā寮?
|
||
鈹? 鈹斺攢鈹€ BatchModeComplete.tsx # 鎵瑰<E98EB5>鐞嗗畬鏁村疄鐜?
|
||
鈹溾攢鈹€ hooks/
|
||
鈹? 鈹斺攢鈹€ useWorkMode.ts # 宸ヤ綔妯″紡Hook
|
||
鈹溾攢鈹€ types/
|
||
鈹? 鈹斺攢鈹€ index.ts # 绫诲瀷瀹氫箟
|
||
鈹斺攢鈹€ styles/
|
||
鈹斺攢鈹€ workspace.css # 鑷<>畾涔夋牱寮?
|
||
```
|
||
|
||
### 3. WorkspacePage甯冨眬璁捐<E79281>
|
||
|
||
**鏈€缁堥噰鐢ㄧ殑甯冨眬**锛?
|
||
```
|
||
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
|
||
鈹?[杩斿洖] 鈹?鐭ヨ瘑搴撳悕 鈹?[闂<>瓟][璧勪骇] 鈹?璁剧疆 澶村儚 鈹?Header 56px
|
||
鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
|
||
鈹?[宸ヤ綔妯″紡鈻糫 [鏂囨。鈻糫 宸插姞杞?x/y 绡?鈹?宸ヤ綔妯″紡鏍?40px
|
||
鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
|
||
鈹? 鈹?
|
||
鈹? 鑱婂ぉ鍖哄煙锛堟渶澶у寲锛? 鈹?
|
||
鈹? 鈹?
|
||
鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?
|
||
```
|
||
|
||
**璁捐<E79281>鐗圭偣**锛?
|
||
- 鍗曞眰Header鏁村悎瀵艰埅鍜孴ab鍒囨崲
|
||
- 绱у噾鐨勫伐浣滄ā寮忛€夋嫨鏍?
|
||
- 鏈€澶у寲鐨勮亰澶╁尯鍩?
|
||
- 鍏ㄥ睆妯″紡锛坒ixed瀹氫綅锛?
|
||
|
||
### 4. 3绉嶅伐浣滄ā寮?
|
||
|
||
| 妯″紡 | 璇存槑 | 鍚庣<E98D9A>API |
|
||
|------|------|---------|
|
||
| **鍏ㄦ枃闃呰<E99783>** | 鍔犺浇鍏ㄩ儴鏂囨。锛孉I鍏峰<E98D8F>鍏ㄧ煡瑙嗚<E79199> | `/api/v1/chat/stream` |
|
||
| **閫愮瘒绮捐<E7BBAE>** | 閫夋嫨1-5绡囨枃妗ｆ繁搴﹁В璇?| `/api/v1/chat/stream` |
|
||
| **鎵瑰<E98EB5>鐞?* | 鎵归噺鎻愬彇淇℃伅锛岀敓鎴愮粨鏋勫寲琛ㄦ牸 | `/api/v1/batch-tasks` |
|
||
|
||
### 5. Chat缁勪欢闆嗘垚
|
||
|
||
**浣跨敤Ant Design X Chat缁勪欢**锛?
|
||
- 澶嶇敤 `frontend-v2/src/shared/components/Chat/`
|
||
- 鏀<>寔SSE娴佸紡鍝嶅簲
|
||
- 鑷<>畾涔夋秷鎭<E7A7B7>覆鏌擄紙寮曠敤鏍煎紡鍖栵級
|
||
- 涓婁笅鏂囩<E98F82>鐞?
|
||
|
||
---
|
||
|
||
## 馃敡 鎶€鏈<E282AC>粏鑺?
|
||
|
||
### API璋冪敤閰嶇疆
|
||
|
||
```typescript
|
||
// knowledgeBaseApi.ts
|
||
const api = axios.create({
|
||
baseURL: `${API_BASE_URL}/api/v1/pkb`,
|
||
timeout: 30000,
|
||
});
|
||
|
||
// Chat浣跨敤v1鎺ュ彛
|
||
const chatApi = axios.create({
|
||
baseURL: `${API_BASE_URL}/api/v1/chat/stream`,
|
||
});
|
||
```
|
||
|
||
### 鐘舵€佺<E282AC>鐞?
|
||
|
||
浣跨敤Zustand绠＄悊鍏ㄥ眬鐘舵€侊細
|
||
- 鐭ヨ瘑搴撳垪琛?
|
||
- 褰撳墠鐭ヨ瘑搴?
|
||
- 鏂囨。鍒楄〃
|
||
- 宸ヤ綔妯″紡
|
||
- 閫変腑鐨勬枃妗?
|
||
|
||
### 鏍峰紡鏂规<E98F82>
|
||
|
||
- TailwindCSS浣滀负涓昏<E6B693>鏍峰紡鏂规<E98F82>
|
||
- Ant Design缁勪欢搴?
|
||
- 鑷<>畾涔塁SS澶勭悊鐗规畩鏍峰紡锛坵orkspace.css锛?
|
||
|
||
---
|
||
|
||
## 鈿狅笍 宸茬煡闂<E785A1><E99782>
|
||
|
||
### 1. 鎵瑰<E98EB5>鐞嗘墽琛屽姛鑳藉緟璋冭瘯
|
||
- **闂<><E99782>**锛氭壒澶勭悊妯″紡鏃犳硶鎵ц<E98EB5>
|
||
- **鍘熷洜**锛氬悗绔疉PI `/api/v1/batch-tasks` 闇€瑕侀獙璇?
|
||
- **浼樺厛绾?*锛氿煍?楂?
|
||
|
||
### 2. 鐭ヨ瘑璧勪骇椤甸潰瀵艰埅鏉?
|
||
- **闂<><E99782>**锛氱煡璇嗚祫浜ч〉闈㈢己灏戝<E7818F>鑸<EFBFBD>潯
|
||
- **褰卞搷**锛氱敤鎴锋棤娉曞湪璧勪骇椤甸潰杩涜<E69DA9>绛涢€夋搷浣?
|
||
- **浼樺厛绾?*锛氿煙?涓?
|
||
|
||
### 3. UI绮剧粏鍖?
|
||
- **闂<><E99782>**锛氫笌鍘熷瀷鍥句粛鏈夊樊璺濓紝闇€瑕佽繘涓€姝ヤ紭鍖?
|
||
- **褰卞搷**锛氱敤鎴蜂綋楠?
|
||
- **浼樺厛绾?*锛氿煙?涓?
|
||
|
||
---
|
||
|
||
## 馃摑 涓嬩竴姝ヨ<E5A79D>鍒?
|
||
|
||
### 楂樹紭鍏堢骇
|
||
1. 璋冭瘯鎵瑰<E98EB5>鐞咥PI鎵ц<E98EB5>鍔熻兘
|
||
2. 瀹屽杽鐭ヨ瘑璧勪骇椤甸潰瀵艰埅鏉?
|
||
3. 寮曠敤鏍煎紡鍖栦紭鍖?
|
||
|
||
### 涓<>紭鍏堢骇
|
||
4. UI绮剧粏鍖栵紙涓庡師鍨嬪浘瀵规瘮浼樺寲锛?
|
||
5. 閿欒<E996BF>澶勭悊瀹屽杽
|
||
6. 鍔犺浇鐘舵€佷紭鍖?
|
||
|
||
### 浣庝紭鍏堢骇
|
||
7. RAG妫€绱㈡ā寮忓疄鐜帮紙鍚庣<E98D9A>寰呭紑鍙戯級
|
||
8. PDF棰勮<E6A3B0>鍔熻兘澧炲己
|
||
|
||
---
|
||
|
||
## 馃搳 浠ｇ爜缁熻<E7BC81>
|
||
|
||
| 鏂囦欢 | 琛屾暟 | 璇存槑 |
|
||
|------|------|------|
|
||
| WorkspacePage.tsx | ~513 | 宸ヤ綔鍙颁富椤甸潰 |
|
||
| DashboardPage.tsx | ~450 | 浠<>〃鐩橀〉闈?|
|
||
| BatchModeComplete.tsx | ~511 | 鎵瑰<E98EB5>鐞嗗畬鏁村疄鐜?|
|
||
| WorkModeSelector.tsx | ~200 | 宸ヤ綔妯″紡閫夋嫨鍣?|
|
||
| FullTextMode.tsx | ~150 | 鍏ㄦ枃闃呰<E99783>妯″紡 |
|
||
| DeepReadMode.tsx | ~150 | 閫愮瘒绮捐<E7BBAE>妯″紡 |
|
||
| knowledgeBaseApi.ts | ~200 | API瀹㈡埛绔?|
|
||
| useKnowledgeBaseStore.ts | ~150 | 鐘舵€佺<E282AC>鐞?|
|
||
| **鎬昏<E98EAC>** | **~2300琛?* | PKB鍓嶇<E98D93>妯″潡 |
|
||
|
||
---
|
||
|
||
## 馃幆 鎬荤粨
|
||
|
||
浠婂ぉ瀹屾垚浜哖KB妯″潡鐨勬牳蹇冨墠绔<EFBFBD><EFBFBD>鏋舵惌寤猴紝瀹炵幇浜嗭細
|
||
- 鉁?鍚庣<E98D9A>妯″潡杩佺Щ鍜岃矾鐢辨敞鍐?
|
||
- 鉁?鍓嶇<E98D93>V3璁捐<E79281>鍩虹<E98DA9>瀹炵幇
|
||
- 鉁?3绉嶅伐浣滄ā寮忔<E5AFAE>鏋?
|
||
- 鉁?Chat缁勪欢闆嗘垚
|
||
- 鉁?鍝嶅簲寮忓竷灞€
|
||
|
||
铏界劧杩樻湁涓€浜涘姛鑳介渶瑕佽皟璇曞拰浼樺寲锛屼絾鏁翠綋鏋舵瀯宸茬粡鎼<EFBFBD>缓瀹屾垚锛屽彲浠ヤ綔涓哄悗缁<EFBFBD>紑鍙戠殑鍩虹<EFBFBD>銆?
|
||
|
||
---
|
||
|
||
**Git鎻愪氦**锛?
|
||
```
|
||
5a17d09 feat(pkb): Complete PKB module frontend migration with V3 design
|
||
```
|
||
|
||
---
|
||
|
||
**鏂囨。缂栧啓鏃堕棿**锛?026-01-07
|
||
**涓嬫<E6B693>鏇存柊**锛氭壒澶勭悊鍔熻兘璋冭瘯瀹屾垚鍚?
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|