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%)
224 lines
5.4 KiB
Markdown
224 lines
5.4 KiB
Markdown
# PKB鍚庣<E98D9A>浠ｇ爜杩佺Щ - 闃舵<E99783>1瀹屾垚鎶ュ憡
|
||
|
||
> **瀹屾垚鏃ユ湡锛?* 2026-01-06
|
||
> **鎵ц<E98EB5>浜哄憳锛?* AI鍔╂墜
|
||
> **鐘舵€侊細** 鉁?瀹屾垚
|
||
|
||
---
|
||
|
||
## 馃搵 鎵ц<E98EB5>鎽樿<E98EBD>
|
||
|
||
**闃舵<E99783>1锛氬悗绔<E68297>唬鐮佸<E990AE>鍒?*宸叉垚鍔熷畬鎴愶紒鎵€鏈塒KB鐩稿叧鐨勫悗绔<E68297>唬鐮佸凡浠巂src/legacy`澶嶅埗鍒癭src/modules/pkb`锛屽苟鏇存柊浜嗗<EFBFBD>鍏ヨ矾寰勩€?
|
||
|
||
### 鏍稿績鎴愭灉
|
||
- 鉁?鏂扮洰褰曠粨鏋勫凡鍒涘缓
|
||
- 鉁?鎵€鏈塁ontroller銆丼ervice銆丷outes鏂囦欢宸插<E5AEB8>鍒?
|
||
- 鉁?瀵煎叆璺<E58F86>緞宸叉洿鏂?
|
||
- 鉁?鏃т唬鐮佸畬鍏ㄦ湭鍔<E6B9AD>紝100%鍙<>洖婊?
|
||
|
||
---
|
||
|
||
## 馃搨 宸插<E5AEB8>鍒剁殑鏂囦欢
|
||
|
||
### 1. Controllers锛?涓<>枃浠讹級
|
||
```
|
||
src/modules/pkb/controllers/
|
||
鈹溾攢 knowledgeBaseController.ts (342琛? - 鐭ヨ瘑搴揅RUD
|
||
鈹溾攢 documentController.ts (315琛? - 鏂囨。涓婁紶绠＄悊
|
||
鈹斺攢 batchController.ts (430琛? - 鎵瑰<E98EB5>鐞嗕换鍔?
|
||
```
|
||
|
||
### 2. Services锛?涓<>枃浠讹級
|
||
```
|
||
src/modules/pkb/services/
|
||
鈹溾攢 knowledgeBaseService.ts (365琛? - 鐭ヨ瘑搴撲笟鍔￠€昏緫
|
||
鈹溾攢 documentService.ts (361琛? - 鏂囨。澶勭悊鏈嶅姟
|
||
鈹溾攢 batchService.ts (421琛? - 鎵瑰<E98EB5>鐞嗘湇鍔?
|
||
鈹斺攢 tokenService.ts (150琛? - Token璁＄畻
|
||
```
|
||
|
||
### 3. Routes锛?涓<>枃浠讹級
|
||
```
|
||
src/modules/pkb/routes/
|
||
鈹溾攢 knowledgeBases.ts - 鐭ヨ瘑搴撹矾鐢?
|
||
鈹溾攢 batchRoutes.ts - 鎵瑰<E98EB5>鐞嗚矾鐢?
|
||
鈹斺攢 index.ts - 璺<>敱鍏ュ彛锛堟柊鍒涘缓锛?
|
||
```
|
||
|
||
### 4. 鍏ュ彛鏂囦欢
|
||
```
|
||
src/modules/pkb/
|
||
鈹斺攢 index.ts - 妯″潡瀵煎嚭鍏ュ彛锛堟柊鍒涘缓锛?
|
||
```
|
||
|
||
---
|
||
|
||
## 馃敡 宸蹭慨澶嶇殑瀵煎叆璺<E58F86>緞
|
||
|
||
### 淇<>敼鍓嶏紙legacy浣嶇疆锛?
|
||
```typescript
|
||
import { prisma } from '../../config/database.js';
|
||
import { difyClient } from '../../common/rag/DifyClient.js';
|
||
import { LLMFactory } from '../../common/llm/adapters/LLMFactory.js';
|
||
```
|
||
|
||
### 淇<>敼鍚庯紙modules/pkb浣嶇疆锛?
|
||
```typescript
|
||
import { prisma } from '../../../config/database.js';
|
||
import { difyClient } from '../../../common/rag/DifyClient.js';
|
||
import { LLMFactory } from '../../../common/llm/adapters/LLMFactory.js';
|
||
```
|
||
|
||
### 鍏抽敭淇<E695AD><E6B787>
|
||
- 鉁?prisma璺<61>緞锛歚../../../config/database.js`
|
||
- 鉁?difyClient璺<74>緞锛歚../../../common/rag/DifyClient.js`
|
||
- 鉁?extractionClient璺<74>緞锛歚../../../common/document/ExtractionClient.js`
|
||
- 鉁?LLMFactory璺<79>緞锛歚../../../common/llm/adapters/LLMFactory.js`
|
||
- 鉁?templates璺<73>緞锛歚../../../legacy/templates/clinicalResearch.js`
|
||
- 鉁?batchRoutes鏀逛负default export
|
||
|
||
---
|
||
|
||
## 鉁?楠岃瘉缁撴灉
|
||
|
||
### 1. 鏂囦欢瀹屾暣鎬ч獙璇?
|
||
```bash
|
||
鉁?鎵€鏈夋枃浠跺凡鎴愬姛澶嶅埗锛?涓<>枃浠讹級
|
||
鉁?鏃ф枃浠朵粛鐒跺瓨鍦<E793A8>紙Test-Path杩斿洖True锛?
|
||
鉁?鏂版棫浠ｇ爜瀹屽叏鐙<E58F8F>珛锛屼簰涓嶅奖鍝?
|
||
```
|
||
|
||
### 2. 鐩<>綍缁撴瀯楠岃瘉
|
||
```
|
||
D:\MyCursor\AIclinicalresearch\backend\src\modules\pkb
|
||
鈹溾攢鈹€鈹€controllers/
|
||
鈹? 鈹溾攢 batchController.ts
|
||
鈹? 鈹溾攢 documentController.ts
|
||
鈹? 鈹斺攢 knowledgeBaseController.ts
|
||
鈹溾攢鈹€鈹€routes/
|
||
鈹? 鈹溾攢 batchRoutes.ts
|
||
鈹? 鈹溾攢 knowledgeBases.ts
|
||
鈹? 鈹斺攢 index.ts
|
||
鈹溾攢鈹€鈹€services/
|
||
鈹? 鈹溾攢 batchService.ts
|
||
鈹? 鈹溾攢 documentService.ts
|
||
鈹? 鈹溾攢 knowledgeBaseService.ts
|
||
鈹? 鈹斺攢 tokenService.ts
|
||
鈹溾攢鈹€鈹€types/
|
||
鈹溾攢鈹€鈹€utils/
|
||
鈹斺攢 index.ts
|
||
```
|
||
|
||
### 3. 缂栬瘧鐘舵€?
|
||
```bash
|
||
鈿狅笍 鏈夊皯閲廡ypeScript绫诲瀷閿欒<E996BF>锛堥潪鑷村懡锛夛細
|
||
- 'any' type warnings锛堝凡瀛樺湪浜庢棫浠ｇ爜锛?
|
||
- 鍙<>互鍦ㄥ悗缁<E68297>紭鍖栦腑淇<E88591><E6B787>
|
||
鉁?鏃犳柊澧炵殑涓ラ噸缂栬瘧閿欒<E996BF>
|
||
鉁?瀵煎叆璺<E58F86>緞鍏ㄩ儴姝ｇ‘
|
||
```
|
||
|
||
---
|
||
|
||
## 馃敀 瀹夊叏鎺<E58F8F>柦
|
||
|
||
### 1. 鏃т唬鐮佸畬鍏ㄤ繚鐣?
|
||
```bash
|
||
鉁?src/legacy/controllers/ - 鏈<>慨鏀?
|
||
鉁?src/legacy/services/ - 鏈<>慨鏀?
|
||
鉁?src/legacy/routes/ - 鏈<>慨鏀?
|
||
```
|
||
|
||
### 2. 鍥炴粴鏂规<E98F82>锛?1鍒嗛挓锛?
|
||
```bash
|
||
# 濡傛灉鏂颁唬鐮佹湁闂<E6B981><E99782>锛岀洿鎺ュ垹闄ゆ柊鐩<E69F8A>綍鍗冲彲
|
||
rm -rf src/modules/pkb
|
||
# 鏃т唬鐮佺户缁?00%宸ヤ綔
|
||
```
|
||
|
||
### 3. 鍙岃建骞惰<E9AA9E>
|
||
```bash
|
||
鉁?鏃ц矾鐢憋細/api/v1/knowledge/* - 缁х画宸ヤ綔
|
||
馃啎 鏂拌矾鐢憋細鍑嗗<E98D91>灏辩华锛屽緟涓嬩竴闃舵<E99783>娉ㄥ唽
|
||
```
|
||
|
||
---
|
||
|
||
## 馃搳 浠ｇ爜琛屾暟缁熻<E7BC81>
|
||
|
||
| 绫诲瀷 | 鏂囦欢鏁?| 浠ｇ爜琛屾暟 | 璇存槑 |
|
||
|------|--------|---------|------|
|
||
| **Controllers** | 3 | ~1,087琛?| API绔<49>偣澶勭悊 |
|
||
| **Services** | 4 | ~1,297琛?| 涓氬姟閫昏緫 |
|
||
| **Routes** | 2 | ~85琛?| 璺<>敱瀹氫箟 |
|
||
| **鏂板缓鏂囦欢** | 2 | ~35琛?| index.ts鍏ュ彛 |
|
||
| **鎬昏<E98EAC>** | 11 | ~2,504琛?| 瀹屾暣PKB鍚庣<E98D9A> |
|
||
|
||
---
|
||
|
||
## 馃幆 涓嬩竴姝ワ細闃舵<E99783>2
|
||
|
||
**闃舵<E99783>2鐩<32>爣锛氬悗绔疉PI璺<49>敱娉ㄥ唽锛堝弻璺<E5BCBB>敱鍏卞瓨锛?*
|
||
|
||
棰勪及鏃堕棿锛?.5澶?
|
||
|
||
### 浠诲姟娓呭崟
|
||
1. 鉁?闃舵<E99783>1瀹屾垚
|
||
2. 鈴<>笍 鍦ㄤ富璺<E5AF8C>敱涓<E695B1>敞鍐屾柊PKB璺<42>敱锛?api/v2/pkb锛?
|
||
3. 鈴<>笍 閰嶇疆鍙岃矾鐢卞叡瀛橈紙v1鍜寁2锛?
|
||
4. 鈴<>笍 娣诲姞鍋ュ悍妫€鏌ョ<E98F8C>鐐?
|
||
5. 鈴<>笍 娴嬭瘯鏂拌矾鐢卞彲璁块棶鎬?
|
||
6. 鈴<>笍 纭<><E7BAAD>鏃ц矾鐢变粛姝ｅ父宸ヤ綔
|
||
|
||
---
|
||
|
||
## 馃摑 缁忛獙鎬荤粨
|
||
|
||
### 鉁?鍋氬緱濂界殑鍦版柟
|
||
1. **淇濆畧绛栫暐**锛氬彧澶嶅埗锛屼笉鍒犻櫎锛岀‘淇濆彲鍥炴粴
|
||
2. **绯荤粺鎬ф<E98EAC>鏌?*锛氶獙璇佹棫鏂囦欢瀛樺湪
|
||
3. **娓呮櫚鏂囨。**锛氬畬鏁磋<E98F81>褰曟墍鏈変慨鏀?
|
||
4. **鍒嗘<E98D92>鎵ц<E98EB5>**锛氭瘡涓<E798A1>瓙浠诲姟鐙<E5A79F>珛瀹屾垚
|
||
|
||
### 馃摎 閬囧埌鐨勯棶棰樺強瑙ｅ喅
|
||
1. **闂<><E99782>**锛氱洰褰曡矾寰勫垱寤洪敊璇<E6958A>紙璺<E7B499>緞閲嶅<E996B2>锛?
|
||
**瑙ｅ喅**锛氫娇鐢ㄧ浉瀵硅矾寰勮€岄潪缁濆<E7BC81>璺<EFBFBD>緞
|
||
|
||
2. **闂<><E99782>**锛歱risma瀵煎叆璺<E58F86>緞涓嶅<E6B693>
|
||
**瑙ｅ喅**锛氭煡鎵炬<E98EB5>纭<EFBFBD>殑瀵煎嚭浣嶇疆锛坈onfig/database.js锛?
|
||
|
||
3. **闂<><E99782>**锛歜atchRoutes娌℃湁default export
|
||
**瑙ｅ喅**锛氫慨鏀逛负default export
|
||
|
||
4. **闂<><E99782>**锛歩ndex.ts閲嶅<E996B2>瀵煎嚭
|
||
**瑙ｅ喅**锛氱畝鍖栧<E98D96>鍑猴紝鍙<E7B49D><E98D99>鍑鸿矾鐢卞叆鍙?
|
||
|
||
---
|
||
|
||
## 馃帀 鎴愬姛鏍囧噯杈炬垚
|
||
|
||
- 鉁?**鏂囦欢瀹屾暣鎬?*锛氭墍鏈夋枃浠跺凡澶嶅埗
|
||
- 鉁?**鏃т唬鐮佷繚鎶?*锛氭湭淇<E6B9AD>敼浠讳綍鏃т唬鐮?
|
||
- 鉁?**瀵煎叆姝ｇ‘鎬?*锛氭墍鏈夊<E98F88>鍏ヨ矾寰勫凡鏇存柊
|
||
- 鉁?**缂栬瘧閫氳繃**锛氭棤鏂板<E98F82>涓ラ噸閿欒<E996BF>
|
||
- 鉁?**鍙<>洖婊氭€?*锛氬彲鍦?鍒嗛挓鍐呭洖婊?
|
||
- 鉁?**鏂囨。瀹屾暣**锛氬畬鏁磋<E98F81>褰曟墍鏈夋搷浣?
|
||
|
||
---
|
||
|
||
**闃舵<E99783>1璇勪及锛氣渽 鎴愬姛瀹屾垚锛屽彲浠ヨ繘鍏ラ樁娈?锛?* 馃殌
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|