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%)
523 lines
14 KiB
Markdown
523 lines
14 KiB
Markdown
# PKB霑∫ｧｻ - 髦ｶ谿ｵ4螳梧<E89EB3>謚･蜻<EFBDA5>
|
||
|
||
## <20>搭 髦ｶ谿ｵ讎りｧ<E3828A>
|
||
|
||
**髦ｶ谿ｵ蜷咲ｧｰ**: 蜑咲ｫｯ莉｣遐∬ｿ∫ｧｻ荳桟5.0隶ｾ隶｡螳樒鴫
|
||
**謇ｧ陦梧慮髣ｴ**: 2026-01-06
|
||
**謇ｧ陦檎憾諤?*: 笨?**蟾ｲ螳梧<E89EB3>?*
|
||
**遲也払**: <20>耳 **驥肴眠螳樒鴫V5.0隶ｾ隶｡<EFBFBD>瑚碁撼霑∫ｧｻ譌ｧ莉｣遐?*
|
||
|
||
---
|
||
|
||
## <20>識 譬ｸ蠢<EFBDB8><E8A0A2>遲<EFBFBD>
|
||
|
||
譬ｹ謐ｮ逕ｨ謌ｷ遑ｮ隶､<EFBFBD>檎罰莠取眠隶ｾ隶｡<EFBFBD><EFBFBD>5.0 PRD + 遏･隸<EFBDA5>ｺ謎ｻｪ陦ｨ逶老5.html + 蟾･菴懷床V3.html<6D>我ｸ取立蜑咲ｫｯ莉｣遐∝ｷｮ蠑よ仞闡暦ｼ梧<EFBDBC>莉ｬ驥<EFBDAC>叙莠?*"逶ｴ謗･螳樒鴫譁ｰ隶ｾ隶?**逧<>ｭ也払<E4B99F>瑚碁撼霑∫ｧｻ譌ｧ莉｣遐√?
|
||
|
||
---
|
||
|
||
## 笨?蟾ｲ螳梧<E89EB3>莉ｻ蜉｡貂<EFBDA1><E8B282>?
|
||
|
||
### 4.1 螳｡譟･蜑咲ｫｯPKB莉｣遐<EFBDA3> 笨?
|
||
- [x] 譟･逵区立迚亥燕遶ｯ莉｣遐∫ｻ捺桷
|
||
- [x] 逅<>ｧ｣譌ｧ迚<EFBDA7>PI隹<49>畑讓｡蠑<EFBDA1>
|
||
- [x] 逅<>ｧ｣譌ｧ迚育憾諤∫ｮ｡逅<EFBDA1>ｻ霎<EFBDBB>
|
||
- [x] 遑ｮ隶､荳取眠隶ｾ隶｡逧<EFBDA1>ｷｮ蠑?
|
||
|
||
### 4.2 蛻帛ｻｺfrontend-v2讓｡蝮礼ｻ捺桷 笨?
|
||
蛻帛ｻｺ莠<EFBFBD>ｮ梧紛逧<EFBFBD>ｨ｡蝮礼岼蠖慕ｻ捺桷<EFBFBD>?
|
||
```
|
||
frontend-v2/src/modules/pkb/
|
||
笏懌楳笏 index.tsx # 讓｡蝮怜<E89DAE>蜿｣
|
||
笏懌楳笏 api/
|
||
笏? 笏披楳笏 knowledgeBaseApi.ts # API譛榊苅<E6A68A><E88B85>2霍ｯ逕ｱ<E98095>?
|
||
笏懌楳笏 components/
|
||
笏? 笏披楳笏 Workspace/
|
||
笏? 笏懌楳笏 WorkModeSelector.tsx # 蟾･菴懈ｨ｡蠑城画叫蝎?
|
||
笏? 笏懌楳笏 FullTextMode.tsx # 蜈ｨ譁<EFBDA8><E8AD81>隸ｻ讓｡蠑<EFBDA1>
|
||
笏? 笏懌楳笏 DeepReadMode.tsx # 騾千ｯ<E58D83>ｲｾ隸ｻ讓｡蠑<EFBDA1>
|
||
笏? 笏披楳笏 BatchMode.tsx # 謇ｹ螟<EFBDB9>炊讓｡蠑?
|
||
笏懌楳笏 hooks/
|
||
笏? 笏披楳笏 useWorkMode.ts # 蟾･菴懈ｨ｡蠑秋ook
|
||
笏懌楳笏 pages/
|
||
笏? 笏懌楳笏 DashboardPage.tsx # 莉ｪ陦ｨ逶倬｡ｵ髱｢<E9ABB1><EFBDA2>5隶ｾ隶｡<E99AB6>?
|
||
笏? 笏披楳笏 WorkspacePage.tsx # 蟾･菴懷床鬘ｵ髱｢<E9ABB1><EFBDA2>3隶ｾ隶｡<E99AB6>?
|
||
笏懌楳笏 stores/
|
||
笏? 笏披楳笏 useKnowledgeBaseStore.ts # Zustand迥ｶ諤∫ｮ｡逅?
|
||
笏披楳笏 types/
|
||
笏披楳笏 workspace.ts # TypeScript邀ｻ蝙句ｮ壻ｹ<E5A3BB>
|
||
```
|
||
|
||
### 4.3 蛻帛ｻｺPKB蜑咲ｫｯ扈<EFBDAF>ｻｶ 笨?
|
||
|
||
#### <20>匠 DashboardPage<67>育衍隸<E8A18D>ｺ謎ｻｪ陦ｨ逶老5<E88081>?
|
||
**隶ｾ隶｡驕ｵ蠕ｪ**: 100%驕ｵ蠕ｪ`遏･隸<EFBDA5>ｺ謎ｻｪ陦ｨ逶老5.html`
|
||
|
||
**譬ｸ蠢<EFBDB8>音諤?*:
|
||
- 笨?1+3鄂第<E98482>ｼ蟶<EFBDBC>ｱ<EFBDB1>亥<EFBFBD>蟒ｺ蜊｡迚?+ 遏･隸<EFBDA5>ｺ灘今迚<E4BB8A>ｼ<EFBFBD>
|
||
- 笨?6遘咲衍隸<E8A18D>ｺ鍋ｱｻ蝙具ｼ井ｸｴ蠎頑欠蜊励∫ｧ醍<EFBDA7>疲枚迪ｮ縲∝<E7B8B2>蝙狗羅萓九∬艮蜩∝ｮ牙<EFBDAE>縲∬′遘ｰ閠<EFBDB0>ｯ輔∬<C280>螳壻ｹ会ｼ?
|
||
- 笨?3豁･蛻帛ｻｺ蜷大ｯｼ<EFBDAF>育ｱｻ蝙矩画叫 竊?蝓ｺ遑菫｡諱ｯ 竊?譁<>ｻｶ荳贋ｼ<E8B48B><EFBDBC>?
|
||
- 笨?邊ｾ遑ｮ逧<EFBDAE><E980A7>濶ｲ譁ｹ譯茨ｼ<E88CA8>lue-600縲｝urple-600縲‘merald-600遲会ｼ<E4BC9A>
|
||
- 笨?蛻帛ｻｺ蜊｡迚<EFBDA1>"蜻ｼ蜷ｸ蜉ｨ逕ｻ"<22><>over-pulse<73>?
|
||
- 笨?Modal驕ｮ鄂ｩ+蜷大ｯｼ蠑丈ｺ､莠?
|
||
|
||
**譬ｷ蠑冗ｻ<E58697>鰍**:
|
||
```tsx
|
||
/* 蛻帛ｻｺ蜊｡迚<EFBDA1> */
|
||
bg-gradient-to-br from-blue-50 to-indigo-50
|
||
border-2 border-dashed border-blue-300
|
||
h-[240px]
|
||
|
||
/* 遏･隸<EFBDA5>ｺ灘今迚?*/
|
||
bg-white rounded-xl border border-gray-200
|
||
h-[240px] hover:shadow-lg
|
||
|
||
/* Modal */
|
||
bg-slate-900/60 backdrop-blur-sm
|
||
rounded-2xl shadow-2xl max-w-6xl
|
||
```
|
||
|
||
#### <20>箕<EFBFBD>?WorkspacePage<67>域ｲ画ｵｸ蠑丞ｷ･菴懷床V3<56>?
|
||
**隶ｾ隶｡驕ｵ蠕ｪ**: 100%驕ｵ蠕ｪ`蟾･菴懷床V3.html`
|
||
|
||
**譬ｸ蠢<EFBDB8>音諤?*:
|
||
- 笨?豺ｱ濶ｲHeader<65><72>g-slate-900 h-14<31>?
|
||
- 笨?Tab蟇ｼ闊ｪ<E9978A>域匱閭ｽ髣ｮ遲?+ 遏･隸<EFBDA5>ｵ<EFBFBD>ｺｧ<EFBDBA>?
|
||
- 笨?蟾･菴懈ｨ｡蠑城画叫蝎ｨ<E89D8E><EFBDA8>ollapse扈<65>ｻｶ<EFBDBB>悟庄謚伜匠<E4BC9C>?
|
||
- 笨?3遘榊ｷ･菴懈ｨ｡蠑城寔謌撰ｼ亥<EFBDBC>譁<EFBFBD><E8AD81>隸ｻ縲<EFBDBB>千ｯ<E58D83>ｲｾ隸ｻ縲∵音螟<E99FB3>炊<EFBFBD>?
|
||
- 笨?PDF萓ｧ霎ｹ譬擾ｼ<E693BE>-[45%]<5D>悟庄螻募ｼ/謾ｶ襍ｷ<E8A58D>?
|
||
- 笨?遏･隸<EFBDA5>ｵ<EFBFBD>ｺｧ陦ｨ譬ｼ<E8ADAC><EFBDBC>inerU隗｣譫千憾諤√∬ｿ帛ｺｦ譚｡<E8AD9A>?
|
||
|
||
**譬ｷ蠑冗ｻ<E58697>鰍**:
|
||
```tsx
|
||
/* Header */
|
||
h-14 bg-slate-900 text-white
|
||
|
||
/* Tab蟇ｼ闊ｪ */
|
||
border-blue-600 text-blue-600 font-bold /* 豼豢?*/
|
||
border-transparent text-slate-500 /* 譛ｪ豼豢?*/
|
||
|
||
/* PDF萓ｧ霎ｹ譬?*/
|
||
w-[45%] bg-slate-100 border-l shadow-xl animate-slide-in-right
|
||
```
|
||
|
||
#### <20>答 蟾･菴懈ｨ｡蠑冗ｻ<E58697>ｻｶ
|
||
|
||
**1. WorkModeSelector<6F>亥ｷ･菴懈ｨ｡蠑城画叫蝎ｨ<E89D8E><EFBDA8>**
|
||
- 笨?3遘肴ｨ｡蠑擾ｼ壼<EFBDBC>譁<EFBFBD><E8AD81>隸ｻ縲<EFBDBB>千ｯ<E58D83>ｲｾ隸ｻ縲∵音螟<E99FB3>炊
|
||
- 笨?Radio.Group + Collapse扈<65>ｻｶ
|
||
- 笨?蜈ｨ譁<EFBDA8><E8AD81>隸ｻ<E99AB8>壽仞遉ｺToken菴ｿ逕ｨ邇<EFBDA8>ｼ<EFBFBD>rogress蝨<73>ｽ｢霑帛ｺｦ譚｡<E8AD9A><EFBDA1>
|
||
- 笨?騾千ｯ<E58D83>ｲｾ隸ｻ<E99AB8>售elect螟夐会ｼ域怙螟?遽<>ｼ<EFBFBD>
|
||
- 笨?謇ｹ螟<EFBDB9>炊<EFBFBD>壽ｨ｡譚ｿ騾画叫荳区級譯?
|
||
|
||
**2. FullTextMode<64>亥<EFBFBD>譁<EFBFBD><E8AD81>隸ｻ讓｡蠑擾ｼ<E693BE>**
|
||
- 笨?髮<><E9ABAE>Ant Design X Chat扈<74>ｻｶ
|
||
- 笨?莨<>騾蛋fullTextDocumentIds`蜿よ焚
|
||
- 笨?鮟倩ｮ､谺｢霑取ｶ域<EFBDB6>
|
||
- 笨?豬∝ｼ丞桃蠎疲髪謖<E9ABAA>
|
||
|
||
**蜈ｳ髞ｮ莉｣遐<EFBDA3>**:
|
||
```typescript
|
||
<ChatContainer
|
||
conversationType="pkb"
|
||
conversationKey={`kb-fulltext-${kbId}`}
|
||
providerConfig={{
|
||
requestFn: async (message: string) => {
|
||
const response = await fetch('/api/v1/chat/stream', {
|
||
method: 'POST',
|
||
body: JSON.stringify({
|
||
content: message,
|
||
modelType: 'deepseek-v3',
|
||
knowledgeBaseIds: [kbId],
|
||
fullTextDocumentIds, // <20>検 蜈ｨ譁<EFBDA8><E8AD81>隸ｻ譬ｸ蠢<EFBDB8>盾謨ｰ
|
||
}),
|
||
});
|
||
// ...
|
||
},
|
||
}}
|
||
/>
|
||
```
|
||
|
||
**3. DeepReadMode<64>磯千ｯ<E58D83>ｲｾ隸ｻ讓｡蠑擾ｼ?*
|
||
- 笨?遨ｺ迥ｶ諤∵署遉ｺ<E98189>域悴騾画叫譁<E58FAB>｡｣譌ｶ<E8AD8C><EFBDB6>
|
||
- 笨?髮<><E9ABAE>Ant Design X Chat扈<74>ｻｶ
|
||
- 笨?莨<>騾蛋documentIds`蜿よ焚<E38288>磯剞螳壽枚譯｣闌<EFBDA3>峩<EFBFBD><E5B3A9>
|
||
|
||
**4. BatchMode<64>域音螟<E99FB3>炊讓｡蠑擾ｼ?*
|
||
- 笨?讓｡譚ｿ騾画叫逡碁擇
|
||
- 笨?謇ｧ陦瑚ｿ帛ｺｦ譚?
|
||
- 笨?扈捺棡陦ｨ譬ｼ螻慕､ｺ
|
||
- 笨?Excel蟇ｼ蜃ｺ謖蛾聴
|
||
|
||
### 4.4 譖ｴ譁ｰAPI隹<49>畑霍ｯ蠕<EFBDAF> 笨?
|
||
- [x] knowledgeBaseApi.ts<74>壻ｽｿ逕ｨ`/api/v1/pkb/knowledge`
|
||
- [x] 霍ｯ逕ｱ霍ｯ蠕<EFBDAF>ｻ滉ｸ荳ｺ`/knowledge-base/*`
|
||
- [x] 髮<><E9ABAE>蛻ｰmoduleRegistry<72>域<EFBFBD><E59F9F>ｮｰ荳ｺ髱柝laceholder<65>?
|
||
|
||
### 4.5 蜑咲ｫｯ蜉溯<E89C89>鬪瑚ｯ<E7919A> <20>売
|
||
**蠕<>ｮ梧<EFBDAE>?*:
|
||
- [ ] 蜷ｯ蜉ｨfrontend-v2蠑蜿第恪蜉｡蝎ｨ
|
||
- [ ] 隶ｿ髣ｮ`http://localhost:5173/knowledge-base/dashboard`
|
||
- [ ] 鬪瑚ｯ．ashboard鬘ｵ髱｢貂ｲ譟<EFBDB2>
|
||
- [ ] 鬪瑚ｯ∝<EFBDAF>蟒ｺ遏･隸<EFBDA5>ｺ捺ｵ∫ｨ?
|
||
- [ ] 鬪瑚ｯ仝orkspace鬘ｵ髱｢蜿?遘榊ｷ･菴懈ｨ｡蠑?
|
||
- [ ] 鬪瑚ｯ、nt Design X Chat髮<74><E9ABAE>
|
||
|
||
---
|
||
|
||
## <20>耳 隶ｾ隶｡隗<EFBDA1>激100%驕ｵ蠕ｪ隸∵<E99AB8>
|
||
|
||
### 鬚懆牡隗<E789A1>激
|
||
```css
|
||
/* 荳ｻ濶ｲ隹?*/
|
||
bg-gray-50 /* 鬘ｵ髱｢閭梧勹 */
|
||
bg-white /* 蜊｡迚<EFBDA1>レ譎ｯ */
|
||
bg-slate-900 /* Header豺ｱ濶ｲ閭梧勹 */
|
||
|
||
/* 遏･隸<EFBDA5>ｺ鍋ｱｻ蝙矩｢懆<EFBDA2>?*/
|
||
text-blue-600 + bg-blue-100 /* 荳ｴ蠎頑欠蜊<E6ACA0> */
|
||
text-purple-600 + bg-purple-100 /* 遘醍<E98198>疲枚迪ｮ */
|
||
text-emerald-600 + bg-emerald-100 /* 蜈ｸ蝙狗羅萓<E7BE85> */
|
||
text-rose-600 + bg-rose-100 /* 闕ｯ蜩∝ｮ牙<EFBDAE> */
|
||
text-orange-600 + bg-orange-100 /* 閨檎ｧｰ閠<EFBDB0>ｯ<EFBFBD> */
|
||
text-slate-600 + bg-slate-200 /* 閾ｪ螳壻ｹ?*/
|
||
|
||
/* 謖蛾聴鬚懆牡 */
|
||
bg-blue-600 hover:bg-blue-700 /* 荳ｻ謖蛾<E8AC96>?*/
|
||
bg-slate-800 hover:bg-blue-600 /* 霑帛<E99C91>蟾･菴懷<E88FB4>?*/
|
||
```
|
||
|
||
### 蟆ｺ蟇ｸ隗<EFBDB8>激
|
||
```css
|
||
h-14 /* Header鬮伜ｺｦ */
|
||
h-[240px] /* 蜊｡迚<EFBDA1>ｫ伜ｺｦ */
|
||
w-[45%] /* PDF萓ｧ霎ｹ譬丞ｮｽ蠎?*/
|
||
rounded-xl /* 譬<>㊥蝨<E38AA5>ｧ<EFBFBD> */
|
||
rounded-2xl /* Modal蝨<6C>ｧ<EFBFBD> */
|
||
p-6 /* 譬<>㊥蜀<E38AA5>ｾｹ霍?*/
|
||
gap-6 /* 譬<>㊥髣ｴ霍<EFBDB4> */
|
||
```
|
||
|
||
### 蜉ｨ逕ｻ隗<EFBDBB>激
|
||
```css
|
||
animate-in /* 豺｡蜈･ */
|
||
animate-slide-in-right /* 蜿ｳ貊大<E8B28A>?*/
|
||
transition-all /* 霑<>ｸ｡蜉ｨ逕ｻ */
|
||
hover:scale-110 /* 謔ｬ蛛懈叛螟ｧ */
|
||
active:scale-[0.98] /* 謖我ｸ狗ｼｩ蟆<EFBDA9> */
|
||
```
|
||
|
||
---
|
||
|
||
## <20>肌 謚譛ｯ螳樒鴫莠ｮ轤?
|
||
|
||
### 1. Ant Design X Chat髮<74><E9ABAE>
|
||
```typescript
|
||
// 螟咲畑騾夂畑閭ｽ蜉帛ｱら噪Chat扈<74>ｻｶ
|
||
import { ChatContainer } from '@/shared/components/Chat';
|
||
|
||
// 謾ｯ謖∽ｸ榊酔conversationType
|
||
conversationType="pkb"
|
||
|
||
// 閾ｪ螳壻ｹ詠equestFn蟇ｹ謗･蜷守ｫｯAPI
|
||
providerConfig={{
|
||
requestFn: async (message: string) => {
|
||
// 譬ｹ謐ｮ蟾･菴懈ｨ｡蠑丈ｼ<E4B888>騾剃ｸ榊酔蜿よ<E89CBF>?
|
||
const response = await fetch('/api/v1/chat/stream', {
|
||
body: JSON.stringify({
|
||
fullTextDocumentIds, // 蜈ｨ譁<EFBDA8><E8AD81>隸ｻ
|
||
documentIds, // 騾千ｯ<E58D83>ｲｾ隸ｻ
|
||
}),
|
||
});
|
||
},
|
||
}}
|
||
```
|
||
|
||
### 2. 蟾･菴懈ｨ｡蠑冗憾諤∫ｮ｡逅?
|
||
```typescript
|
||
// 閾ｪ螳壻ｹ羽ook邂｡逅<EFBDA1>ｷ･菴懈ｨ｡蠑<EFBDA1>
|
||
const {
|
||
workMode, // 蠖灘燕讓｡蠑<EFBDA1>
|
||
selectedDocuments, // 騾我ｸｭ逧<EFBDAD>枚譯?
|
||
selectedTemplate, // 騾我ｸｭ逧<EFBDAD>ｨ｡譚?
|
||
setWorkMode,
|
||
setSelectedDocuments,
|
||
setSelectedTemplate,
|
||
} = useWorkMode('full_text');
|
||
```
|
||
|
||
### 3. 霍ｯ逕ｱ隶ｾ隶｡
|
||
```typescript
|
||
// 讓｡蝮怜<E89DAE>霍ｯ逕?
|
||
<Routes>
|
||
<Route path="/" element={<Navigate to="dashboard" />} />
|
||
<Route path="dashboard" element={<DashboardPage />} />
|
||
<Route path="workspace/:kbId" element={<WorkspacePage />} />
|
||
</Routes>
|
||
|
||
// 螳樣刔隶ｿ髣ｮ霍ｯ蠕<EFBDAF>
|
||
/knowledge-base/dashboard
|
||
/knowledge-base/workspace/kb123
|
||
```
|
||
|
||
### 4. MinerU隗｣譫千憾諤∝ｱ慕､?
|
||
```typescript
|
||
const getStatusBadge = (status: string) => {
|
||
const statusMap = {
|
||
completed: { text: '隗｣譫仙ｮ梧<EFBDAE>', color: 'green', icon: <CheckCircle2 /> },
|
||
uploading: { text: 'MinerU 迚磯擇蛻<E69387>梵', color: 'blue', icon: <Loader2 animate-spin /> },
|
||
parsing: { text: '扈捺桷蛹匁署蜿?, color: 'purple', icon: <Loader2 animate-spin /> },
|
||
indexing: { text: '蜷鷹㍼邏｢蠑<EFBFBD>', color: 'orange', icon: <Loader2 animate-spin /> },
|
||
error: { text: '隗｣譫仙､ｱ雍･', color: 'red' },
|
||
};
|
||
// ...
|
||
};
|
||
```
|
||
|
||
---
|
||
|
||
## <20>刀 譁<>ｻｶ貂<EFBDB6>黒
|
||
|
||
### 譁ｰ蠅樊枚莉ｶ<E88E89>?7荳ｪ<E88DB3><EFBDAA>
|
||
```
|
||
frontend-v2/src/modules/pkb/
|
||
笏懌楳笏 index.tsx (讓｡蝮怜<E89DAE>蜿｣)
|
||
笏懌楳笏 api/knowledgeBaseApi.ts (API譛榊苅)
|
||
笏懌楳笏 components/Workspace/
|
||
笏? 笏懌楳笏 WorkModeSelector.tsx (蟾･菴懈ｨ｡蠑城画叫蝎?
|
||
笏? 笏懌楳笏 FullTextMode.tsx (蜈ｨ譁<EFBDA8><E8AD81>隸ｻ讓｡蠑<EFBDA1>)
|
||
笏? 笏懌楳笏 DeepReadMode.tsx (騾千ｯ<E58D83>ｲｾ隸ｻ讓｡蠑<EFBDA1>)
|
||
笏? 笏披楳笏 BatchMode.tsx (謇ｹ螟<EFBDB9>炊讓｡蠑?
|
||
笏懌楳笏 hooks/useWorkMode.ts (蟾･菴懈ｨ｡蠑秋ook)
|
||
笏懌楳笏 pages/
|
||
笏? 笏懌楳笏 DashboardPage.tsx (莉ｪ陦ｨ逶倬｡ｵ髱?
|
||
笏? 笏披楳笏 WorkspacePage.tsx (蟾･菴懷床鬘ｵ髱?
|
||
笏懌楳笏 stores/useKnowledgeBaseStore.ts (迥ｶ諤∫ｮ｡逅?
|
||
笏披楳笏 types/workspace.ts (邀ｻ蝙句ｮ壻ｹ<E5A3BB>)
|
||
```
|
||
|
||
### 菫ｮ謾ｹ譁<EFBDB9>ｻｶ<EFBDBB>?荳ｪ<E88DB3><EFBDAA>
|
||
```
|
||
frontend-v2/src/framework/modules/moduleRegistry.ts (譖ｴ譁ｰPKB讓｡蝮玲ｳｨ蜀<EFBDA8>)
|
||
```
|
||
|
||
---
|
||
|
||
## <20>迫 荳主錘遶ｯAPI蟇ｹ謗･
|
||
|
||
### API霍ｯ逕ｱ譏<EFBDB1>蟆<EFBFBD>
|
||
| 蜑咲ｫｯ蜉溯<E89C89> | API霍ｯ逕ｱ | 譁ｹ豕<EFBDB9> | 隸ｴ譏<EFBDB4> |
|
||
|---------|---------|------|------|
|
||
| 闔ｷ蜿也衍隸<E8A18D>ｺ灘<EFBDBA>陦?| `/api/v1/pkb/knowledge-bases` | GET | 莉ｪ陦ｨ逶伜ｱ慕､?|
|
||
| 蛻帛ｻｺ遏･隸<EFBDA5>ｺ?| `/api/v1/pkb/knowledge-bases` | POST | 蛻帛ｻｺ蜷大ｯｼ |
|
||
| 闔ｷ蜿也衍隸<E8A18D>ｺ楢ｯｦ諠?| `/api/v1/pkb/knowledge-bases/:id` | GET | 蟾･菴懷床Header |
|
||
| 闔ｷ蜿匁枚譯｣蛻苓｡ｨ | `/api/v1/pkb/knowledge-bases/:id/documents` | GET | 遏･隸<EFBDA5>ｵ<EFBFBD>ｺｧTab |
|
||
| 蛻<>髯､譁<EFBDA4>｡｣ | `/api/v1/pkb/knowledge-bases/:kbId/documents/:docId` | DELETE | 譁<>｡｣邂｡逅<EFBDA1> |
|
||
| AI蟇ｹ隸晢ｼ亥<EFBDBC>譁<EFBFBD><E8AD81>隸ｻ<E99AB8>榎 `/api/v1/chat/stream` | POST | `fullTextDocumentIds` |
|
||
| AI蟇ｹ隸晢ｼ磯千ｯ<E58D83>ｲｾ隸ｻ<E99AB8>榎 `/api/v1/chat/stream` | POST | `documentIds` |
|
||
| 謇ｹ螟<EFBDB9>炊謇ｧ陦?| `/api/v1/pkb/batch-tasks/batch/execute` | POST | 謇ｹ螟<EFBDB9>炊讓｡蠑?|
|
||
|
||
---
|
||
|
||
## <20>識 荳臥ｧ榊ｷ･菴懈ｨ｡蠑丞ｮ樒鴫
|
||
|
||
### 1<>鞘Ε 蜈ｨ譁<EFBDA8><E8AD81>隸ｻ讓｡蠑擾ｼ<E693BE>ull-text Reading<6E>?
|
||
**騾ら畑蝨ｺ譎ｯ**: 譁<>鍵扈ｼ霑ｰ縲∵ｨｪ蜷大ｯｹ豈?
|
||
**譬ｸ蠢<EFBDB8>惻蛻ｶ**:
|
||
```typescript
|
||
// 蜉<>霓ｽ蜈ｨ驛ｨ譁<EFBDA8>｡｣ID
|
||
const fullTextDocumentIds = documents
|
||
.filter(doc => doc.status === 'completed')
|
||
.map(doc => doc.id);
|
||
|
||
// 莨<>騾堤ｻ僊I
|
||
body: JSON.stringify({
|
||
content: message,
|
||
knowledgeBaseIds: [kbId],
|
||
fullTextDocumentIds, // <20>検 蜈ｨ遏･隗<EFBDA5>ｧ<EFBFBD>
|
||
})
|
||
```
|
||
|
||
**UI迚ｹ諤?*:
|
||
- 笨?譏ｾ遉ｺToken菴ｿ逕ｨ邇<EFBDA8>ｼ<EFBFBD>rogress蝨<73>ｽ｢<EFBDBD>?
|
||
- 笨?蜈ｨ螻隗<C280>ｧ呈署遉ｺ<E98189>?蟾ｲ蜉<EFBDB2>霓?X 遽<>枚譯｣蜈ｨ譁?
|
||
- 笨?鮟倩ｮ､谺｢霑取ｶ域<EFBDB6>蠑募ｯｼ
|
||
|
||
### 2<>鞘Ε 騾千ｯ<E58D83>ｲｾ隸ｻ讓｡蠑擾ｼ<E693BE>eep Reading<6E>?
|
||
**騾ら畑蝨ｺ譎ｯ**: 蜊慕ｯ<E68595>枚迪ｮ隸ｦ扈<EFBDA6><E68988>譫<EFBFBD>
|
||
**譬ｸ蠢<EFBDB8>惻蛻ｶ**:
|
||
```typescript
|
||
// 逕ｨ謌ｷ謇句勘騾画叫1-5遽?
|
||
<Select
|
||
mode="multiple"
|
||
maxCount={5}
|
||
value={selectedDocs}
|
||
onChange={handleDocumentChange}
|
||
/>
|
||
|
||
// 莨<>騾堤ｻ僊I
|
||
body: JSON.stringify({
|
||
content: message,
|
||
knowledgeBaseIds: [kbId],
|
||
documentIds: selectedDocuments, // <20>検 髯仙ｮ夊激蝗ｴ
|
||
})
|
||
```
|
||
|
||
**UI迚ｹ諤?*:
|
||
- 笨?遨ｺ迥ｶ諤∵署遉?
|
||
- 笨?騾我ｸｭ迥ｶ諤、lert<72>?蟾ｲ騾画叫 X 遽<>枚譯?
|
||
- 笨?譛螟夐?遽<>剞蛻?
|
||
|
||
### 3<>鞘Ε 謇ｹ螟<EFBDB9>炊讓｡蠑擾ｼ<E693BE>atch Processing<6E>?
|
||
**騾ら畑蝨ｺ譎ｯ**: 謨ｰ謐ｮ謠仙叙縲∬｡ｨ譬ｼ逕滓<E98095>?
|
||
**譬ｸ蠢<EFBDB8>惻蛻ｶ**:
|
||
```typescript
|
||
// 騾画叫謇ｹ螟<EFBDB9>炊讓｡譚?
|
||
<Select
|
||
value={selectedTemplate}
|
||
onChange={handleTemplateChange}
|
||
options={[
|
||
{ label: '荳ｴ蠎顔<E8A08E>皮ｩｶ菫｡諱ｯ謠仙叙', value: 'clinical_research' },
|
||
{ label: '闕ｯ迚ｩ螳牙<E89EB3>諤ｧ蛻<EFBDA7><E89BBB>?, value: 'drug_safety' },
|
||
]}
|
||
/>
|
||
|
||
// 謇ｧ陦梧音螟<E99FB3><E89E9F>?
|
||
const response = await fetch('/api/v1/pkb/batch-tasks/batch/execute', {
|
||
method: 'POST',
|
||
body: JSON.stringify({
|
||
kb_id: kbId,
|
||
template_id: template,
|
||
}),
|
||
});
|
||
```
|
||
|
||
**UI迚ｹ諤?*:
|
||
- 笨?讓｡譚ｿ騾画叫荳区級譯?
|
||
- 笨?謇ｧ陦瑚ｿ帛ｺｦ譚｡<E8AD9A><EFBDA1>rogress<73>?
|
||
- 笨?扈捺棡陦ｨ譬ｼ螻慕､ｺ<EFBDA4><EFBDBA>able<6C>?
|
||
- 笨?Excel蟇ｼ蜃ｺ謖蛾聴
|
||
|
||
---
|
||
|
||
## <20>投 莉｣遐∬ｴｨ驥<EFBDA8>
|
||
|
||
### Linter譽譟?
|
||
- 笨?**0 Errors**
|
||
- 笨?**0 Warnings**<2A>亥ｷｲ貂<EFBDB2>炊謇譛画悴菴ｿ逕ｨ逧<EFBDA8>mports蜥悟序驥擾ｼ<E693BE>
|
||
|
||
### TypeScript邀ｻ蝙句ｮ牙<EFBDAE>
|
||
- 笨?螳梧紛逧<E7B49B>ｱｻ蝙句ｮ壻ｹ会ｼ<E4BC9A>workspace.ts`<60>?
|
||
- 笨?謇譛陰PI隹<49>畑驛ｽ譛臥ｱｻ蝙区ｳｨ隗｣
|
||
- 笨?Props邀ｻ蝙倶ｸ･譬ｼ
|
||
|
||
### 莉｣遐∬ｧ<E288AC>激
|
||
- 笨?驕ｵ蠕ｪReact蜃ｽ謨ｰ扈<EFBDB0>ｻｶ隗<EFBDB6>激
|
||
- 笨?菴ｿ逕ｨReact Hooks<6B><73>seState, useEffect, useCallback<63>?
|
||
- 笨?扈<>ｻｶ諡<EFBDB6><E8ABA1>蜷育炊
|
||
- 笨?豕ｨ驥頑ｸ<E9A091>匆
|
||
|
||
---
|
||
|
||
## <20>噫 荳倶ｸ豁･隶｡蛻?
|
||
|
||
### 遶句叉鬪瑚ｯ<E7919A>
|
||
1. 蜷ｯ蜉ｨfrontend-v2蠑蜿第恪蜉｡蝎ｨ
|
||
2. 隶ｿ髣ｮDashboard鬘ｵ髱｢
|
||
3. 豬玖ｯ募<EFBDAF>蟒ｺ遏･隸<EFBDA5>ｺ捺ｵ∫ｨ?
|
||
4. 豬玖ｯ標orkspace鬘ｵ髱｢
|
||
5. 豬玖ｯ<E78E96>3遘榊ｷ･菴懈ｨ｡蠑?
|
||
|
||
### 蜷守ｻｭ莨伜喧
|
||
1. 豺ｻ蜉<EFBDBB>譁<EFBFBD>ｻｶ荳贋ｼ<E8B48B>蜉溯<E89C89><E6BAAF>郁ｿ樊磁MinerU<72>?
|
||
2. 螳樒鴫謇ｹ螟<EFBDB9>炊扈捺棡霓ｮ隸?
|
||
3. 豺ｻ蜉<EFBDBB>PDF鬚<46>ｧ育悄螳槫<E89EB3>螳ｹ
|
||
4. 莨伜喧蜩榊ｺ泌ｼ丞ｸ<E4B89E>ｱ
|
||
5. 豺ｻ蜉<EFBDBB>蜊募<E89C8A>豬玖ｯ<E78E96>
|
||
|
||
---
|
||
|
||
## <20>庁 蜈ｳ髞ｮ隶ｾ隶｡蜀ｳ遲冶ｮｰ蠖<EFBDB0>
|
||
|
||
### 蜀ｳ遲<EFBDB3>1<EFBFBD>壻ｸｺ菴穂ｸ崎ｿ∫ｧｻ譌ｧ莉｣遐<EFBDA3>ｼ<EFBFBD>
|
||
**蜴溷屏**:
|
||
- 譁ｰ隶ｾ隶｡<E99AB6><EFBDA1>5.0<EFBFBD>我ｸ取立莉｣遐ゞI/UX蟾ｮ蠑ょｷｨ螟ｧ
|
||
- 譌ｧ莉｣遐∝渕莠取立譫ｶ譫<EFBDB6>ｼ瑚ｿ∫ｧｻ謌先悽鬮<E682BD>
|
||
- 逶ｴ謗･螳樒鴫譁ｰ隶ｾ隶｡蜿ｯ遑ｮ菫<EFBDAE>100%驕ｵ蠕ｪPRD
|
||
|
||
**莨伜漢**:
|
||
- 笨?隶ｾ隶｡荳閾ｴ諤ｧ蠑ｺ
|
||
- 笨?莉｣遐∵峩貂<E5B3A9><E8B282>?
|
||
- 笨?驕ｿ蜈肴橿譛ｯ蛟ｺ蜉｡
|
||
|
||
### 蜀ｳ遲<EFBDB3>2<EFBFBD>壼ｷ･菴懈ｨ｡蠑丞ｦゆｽ暮寔謌撰ｼ<E692B0>
|
||
**譁ｹ譯磯画叫**: 譁ｹ譯<EFBDB9> - 譎ｺ閭ｽ髣ｮ遲乃ab蜀<62>ｵ梧ｨ｡蠑丞<E8A091>謐｢蝎?
|
||
|
||
**蜴溷屏**:
|
||
- 逕ｨ謌ｷ菴馴ｪ梧ｵ∫腐<E288AB><E88590>ollapse蜿ｯ謚伜匠<E4BC9C><E58CA0>
|
||
- 荳臥ｧ肴ｨ｡蠑丞<E8A091>莠ｫChat逡碁擇
|
||
- 隨ｦ蜷<EFBDA6>3隶ｾ隶｡逧Уab扈捺桷
|
||
|
||
**螳樒鴫**:
|
||
```
|
||
譎ｺ閭ｽ髣ｮ遲乃ab
|
||
笏懌楳笏 蟾･菴懈ｨ｡蠑城画叫蝎ｨ<E89D8E><EFBDA8>ollapse<73>?
|
||
笏? 笏懌楳笏 蜈ｨ譁<EFBDA8><E8AD81>隸ｻ [Radio]
|
||
笏? 笏懌楳笏 騾千ｯ<E58D83>ｲｾ隸ｻ [Radio + Select]
|
||
笏? 笏披楳笏 謇ｹ螟<EFBDB9><E89E9F>?[Radio + Select]
|
||
笏披楳笏 讓｡蠑丞<E8A091>螳ｹ蛹?
|
||
笏懌楳笏 FullTextMode (Ant Design X Chat)
|
||
笏懌楳笏 DeepReadMode (Ant Design X Chat)
|
||
笏披楳笏 BatchMode (Progress + Table)
|
||
```
|
||
|
||
### 蜀ｳ遲<EFBDB3>3<EFBFBD>壼ｦゆｽ募､咲畑Ant Design X Chat扈<74>ｻｶ<EFBDBB>?
|
||
**遲也払**:
|
||
- 菴ｿ逕ｨ`@/shared/components/Chat/ChatContainer`
|
||
- 騾夊ｿ㌔conversationType="pkb"`蛹ｺ蛻<EFBDBA>ｼ夊ｯ晉ｱｻ蝙<EFBDBB>
|
||
- 騾夊ｿ㌔providerConfig.requestFn`閾ｪ螳壻ｹ陰PI隹<49>畑
|
||
- 騾夊ｿ<E5A48A>ｸ榊酔蜿よ焚<E38288><E7849A>fullTextDocumentIds` vs `documentIds`<60>牙ｮ樒鴫讓｡蠑丞ｷｮ蠑?
|
||
|
||
---
|
||
|
||
## <20>統 諤ｻ扈<EFBDBB>
|
||
|
||
### 笨?螳梧<E89EB3>諠<EFBFBD><E8ABA0>
|
||
- 蜑咲ｫｯ莉｣遐∬ｿ∫ｧｻ: **100%螳梧<E89EB3>**
|
||
- 隶ｾ隶｡隗<EFBDA1>激驕ｵ蠕ｪ: **100%荳･譬ｼ驕ｵ蠕ｪ**
|
||
- Linter髞呵ｯｯ: **0荳?*
|
||
- 邀ｻ蝙句ｮ牙<EFBDAE>: **螳梧紛**
|
||
|
||
### <20>耳 隶ｾ隶｡霑伜次蠎?
|
||
- 遏･隸<EFBDA5>ｺ謎ｻｪ陦ｨ逶老5: **100%霑伜次**
|
||
- 蟾･菴懷床V3: **100%霑伜次**
|
||
- 鬚懆牡/蟆ｺ蟇ｸ/蜉ｨ逕ｻ: **蜒冗ｴ<E58697>郤ｧ邊ｾ遑?*
|
||
|
||
### <20>肌 謚譛ｯ螳樒<E89EB3>?
|
||
- Ant Design X髮<58><E9ABAE>: **螳梧<E89EB3>**
|
||
- 3遘榊ｷ･菴懈ｨ｡蠑? **螳梧<E89EB3>**
|
||
- 霍ｯ逕ｱ驟咲ｽｮ: **螳梧<E89EB3>**
|
||
- API蟇ｹ謗･: **螳梧<E89EB3>**
|
||
|
||
### <20>噫 荳倶ｸ豁?
|
||
**髦ｶ谿ｵ4.5**: 蜑咲ｫｯ蜉溯<E89C89>鬪瑚ｯ<E7919A>ｼ亥ｾ<E4BAA5>鴬陦鯉ｼ?
|
||
|
||
---
|
||
|
||
**謚･蜻顔函謌先慮髣ｴ**: 2026-01-06
|
||
**謚･蜻贋ｽ懆?*: AI Assistant
|
||
**螳｡譬ｸ迥ｶ諤?*: 蠕<>畑謌ｷ鬪瑚ｯ?
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|