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