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%)
8.1 KiB
8.1 KiB
謚譛ｯ隶ｾ隶｡譁<EFBFBD>｡｣<EFBFBD>壼ｷ･蜈ｷ C - 遘醍<E98198>疲焚謐ｮ郛冶ｾ大<EFBDBE>?(V7 莠醍ｫｯ豐咏ｮｱ謚鈴｣朱勦迚<E58BA6>)
| 譁<EFBFBD>｡｣邀ｻ蝙<EFBFBD> | Technical Design Document (TDD) |
|---|---|
| 蟇ｹ蠎泌次蝙<EFBFBD> | 蟾･蜈ｷC_遘醍<EFBFBD>疲焚謐ｮ郛冶ｾ大勣_蜴溷梛隶ｾ隶｡_V6_菫ｮ螟咲<EFBFBD>?html |
| 迚域悽 | V7.1 (螳梧紛謾ｶ蠖墓楔譫<E6A594><E8ADAB>遲<EFBFBD> ADR 荳守ｺ｢髦滄｣朱勦蟇ｹ遲? |
| *迥ｶ諤? | Final Standard |
| 譬ｸ蠢<EFBFBD>岼譬<EFBFBD> | 譫<EFBFBD>ｻｺ荳荳ｪ鬮伜庄髱<EFBFBD>逧<EFBFBD>ｺ醍ｫ?Python 謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｹｳ蜿ｰ縲ょ惠菫晞囿窶懈焚謐ｮ荳榊<E88DB3>蝓溪晉噪蜑肴署荳具ｼ碁夊ｿ<E5A48A> Apache Arrow 蜥梧<E89CA5>ｷ蠑丞<E8A091>遖ｻ謚譛ｯ<E8AD9B>瑚ｧ｣蜀ｳ譛榊苅遶ｯ謇ｧ陦悟ｸｦ譚･逧<EFBDA5>ｻｶ霑滉ｸ取<EFBDB8>ｼ蠑丈ｸ｢螟ｱ髣ｮ鬚倥? |
1. 諤ｻ菴捺楔譫<E6A594>ｮｾ隶｡ (System Architecture)
驩ｴ莠取枚莉ｶ螟ｧ蟆城剞蛻ｶ (<20MB) 蜥瑚┳謨丞燕謠撰ｼ碁㊦逕ｨ 窶廸ode.js BFF + Python Microservice窶?譫ｶ譫<EFBDB6>? V7 譬ｸ蠢<EFBDB8>合郤ｧ<E983A4>?蠑募<E8A091> Apache Arrow 菴應ｸｺ蜑榊錘遶ｯ謨ｰ謐ｮ莠､謐｢譬<EFBDA2>㊥<EFBFBD>梧崛莉｣菴取譜逧?Excel 譁<>ｻｶ蜿榊､崎ｯｻ蜀呻ｼ悟ｰ<E6829F>黒谺｡莠､莠貞ｻｶ霑滉ｻ?8s 髯堺ｽ手<EFBDBD>?0.5s縲?
1.1 譫ｶ譫<EFBDB6>挙謇大<E8AC87>?(V7 莨伜喧迚?
graph TD
subgraph Client_Layer [逕ｨ謌ｷ遶ｯ]
ReactApp[React 19 + AG Grid]
ArrowClient[Apache Arrow JS]
end
subgraph Aliyun\_SAE \[髦ｿ驥御ｺ?Serverless 蠎皮畑蠑墓梼\]
BFF\[Node.js Web 譛榊苅 (Fastify)\]
PythonService\[Python 隶｡邂怜ｾｮ譛榊<E8AD9B>?(FastAPI)\]
end
subgraph Cache\_Layer \[鬮倬溽ｼ灘ｭ伜ｱ<E4BC9C>]
Redis\_Session\[Redis (蟄?DataFrame Arrow 蠎丞<E8A08E>蛹?\]
end
subgraph AI\_PaaS \[AI 閭ｽ蜉帛ｱ<E5B89B>]
Dify\[Dify 郛匁賜蠑墓梼\]
DeepSeek\[DeepSeek-V3 讓｡蝙欺]
end
subgraph Cloud\_Infra \[謖∽ｹ<E288BD>喧螻<E596A7>]
OSS\[蟇ｹ雎｡蟄伜お (蟄?Excel 蠎墓攸)\]
RDS\[RDS PostgreSQL (蟄伜<E89F84>謨ｰ謐ｮ)\]
end
%% 莠､莠呈ｵ?
User\[逕ｨ謌ｷ\] \--\>|1. 荳贋ｼ<E8B48B>| BFF
BFF \--\>|2. 蟄伜次蟋畿xcel| OSS
BFF \--\>|3. 鬚<>Ο Session| PythonService
PythonService \--\>|4. 蜉<>霓ｽ蟷ｶ霓ｬ荳?Arrow| Redis\_Session
User \--\>|5. AI 謖<>ｻ､| Dify
Dify \--\>|6. Python 莉｣遐－ BFF
BFF \--\>|7. 蜿鷹∽ｻ｣遐－ PythonService
PythonService \--\>|8. 隸ｻ蜿<EFBDBB> Arrow (蜀<>ｭ<EFBFBD>)| Redis\_Session
PythonService \--\>|9. Pandas 謇ｧ陦芸 PythonService
PythonService \--\>|10. 蜀吝屓 Arrow| Redis\_Session
PythonService \--\>|11. 霑泌屓 Preview 謨ｰ謐ｮ (JSON/Arrow)| ReactApp
User \--\>|12. 蟇ｼ蜃ｺ/菫晏ｭ<E6998F> BFF
BFF \--\>|13. 隗ｦ蜿大粋蟷ｶ| PythonService
PythonService \--\>|14. 隸ｻOSS蠎墓攸 \+ 蝪ｫ蜈･謨ｰ謐ｮ| OSS
2. 蜈ｳ髞ｮ譫ｶ譫<EFBDB6><E8ADAB>遲冶ｮｰ蠖<EFBDB0> (ADR)
譛ｬ闃りｮｰ蠖穂ｺ<EFBFBD>ｸｺ菴穂ｻ寂懷燕遶?Pyodide窶晁ｽｬ蜷鯛懷錘遶ｯ豐咏ｮｱ窶晉噪蜀ｳ遲冶ｿ<E586B6>ｨ具ｼ御ｾ帛屬髦溷盾閠<E79BBE>?
蜀ｳ遲也せ<EFBFBD>壼燕遶ｯ霑占｡<EFBFBD> (WASM) vs 蜷守ｫｯ霑占｡<E58DA0> (Server-side)
| 扈ｴ蠎ｦ | 譁ｹ譯<EFBFBD> A<>壼燕遶?Pyodide (WASM) | 譁ｹ譯<EFBFBD> B<>壼錘遶?Python (譛ｬ譁ｹ譯? | 蜀ｳ遲也ｻ楢ｮｺ |
|---|---|---|---|
| 蜷ｯ蜉ｨ蟒ｶ霑<EFBFBD> | **譫∵<E8ADAB> (15s+)**縲る怙荳玖ｽｽ ~20MB 蠑墓梼蛹<E6A2BC>ｼ檎畑謌ｷ菴馴ｪ梧栫蟾ｮ縲? | 遘貞ｼ縲ら識蠅<EFBFBD>惠譛榊苅蝎ｨ鬚<EFBFBD>Ο<EFBFBD>悟叉蠑蜊ｳ逕ｨ縲? | *蜷守ｫｯ閭? |
| 莠､莠貞ｻｶ霑<EFBFBD> | **譫∝ｿｫ (< 0.1s)**縲よ悽蝨ｰ蜀<EFBDB0>ｭ俶桃菴懶ｼ梧裏鄂醍ｻ懷ｼ髞縲? | **荳ｭ遲<EFBDAD> (0.5s)**縲る夊ｿ<E5A48A> Apache Arrow 莨伜喧蜷主庄謗･蜿励? | 蜑咲ｫｯ閭? |
| *遞ｳ螳壽? | **鬮倬｣朱<EFBDA3>?*縲よｵ剰ｧ亥勣 Tab 蜀<>ｭ俶怏髯撰ｼ梧<EFBDBC> OOM 蟠ｩ貅<EFBDA9>? | **鬮倡ｨｳ螳?*縲よ恪蜉｡蝎ｨ蜀<EFBDA8>ｭ伜<EFBDAD>雜ｳ<E99B9C>悟ｮｹ蝎ｨ髫皮ｦｻ<EFBDA6>悟ｴｩ貅<EFBDA9>ｸ榊ｽｱ蜩榊燕遶ｯ縲? | *蜷守ｫｯ閭? |
| *蠎捺髪謖? | 譛蛾剞縲ゆｸ肴髪謖<EFBFBD>Κ蛻<EFBFBD> C 謇ｩ螻募ｺ?(螯ょ､肴揩扈溯ｮ｡蠎<EFBDA1>)縲? | **譌<>髯<EFBFBD>**縲よ<E7B8B2><E38288><EFBFBD>?Linux 邇ｯ蠅<EFBDAF>ｼ檎函諤∝ｮ梧紛縲? | *蜷守ｫｯ閭? |
| *蠑蜿鷹埓蠎? | **譫<>ｫ<EFBFBD>**縲る怙螟<E68099>炊 JS-Python 騾壻ｿ｡縲∝<E7B8B2>蟄倡ｮ｡逅<EFBDA1>? | **菴?*縲よ<E7B8B2><E38288><EFBFBD>?Web API 蠑蜿代? | *蜷守ｫｯ閭? |
*扈楢ｮｺ<EFBFBD>? 驩ｴ莠寂懈焚謐ｮ蟾ｲ閼ｱ謨鞘昜ｸ披懈枚莉ｶ霎<EFBDB6>ｰ鞘晢ｼ<E699A2>蜷守ｫｯ謇ｧ陦梧婿譯<EFBFBD> 蝨ｨ遞ｳ螳壽ｧ縲∝<E7B8B2>螳ｹ諤ｧ蜥悟ｼ蜿第<E89CBF>譛ｬ荳雁<E88DB3>髱｢閭懷<E996AD>縲?
3. 謚譛ｯ騾牙梛荳手檮蜷?(Tech Stack Fusion)
3.1 譬ｸ蠢<EFBDB8>ｻ<EFBFBD>ｻｶ譖ｴ譁ｰ
| 鬚<EFBFBD>沺 | 騾牙梛 | V7 譁ｰ蠅樒炊逕ｱ |
|---|---|---|
| 謨ｰ謐ｮ莠､謐｢ | Apache Arrow | 蜈ｳ髞ｮ蜊<EFBFBD>ｺｧ縲ら畑莠?Python 蜥?Node.js/蜑咲ｫｯ荵矩龍逧<E9BE8D>ｫ俶ｧ閭ｽ謨ｰ謐ｮ莨<EFBDAE>霎難ｼ碁∩蜈?JSON 蠎丞<E8A08E>蛹門ｼ髞<E9AB9E>?*隗｣蜀ｳ IO 蟒ｶ霑滓<E99C91>ｸ蠢<EFBDB8>**縲? |
| Excel 螟<>炊 | openpyxl | 譖ｿ莉｣郤?Pandas縲ら畑莠主惠蟇ｼ蜃ｺ譌?*菫晉蕗蜴溷ｧ<E6BAB7> Excel 譬ｷ蠑<EFBDB7>**<2A>亥ｦる｢懆牡縲∬ｾｹ譯<EFBDB9>ｼ会ｼ?*隗｣蜀ｳ譬ｼ蠑丈ｸ｢螟ｱ譬ｸ蠢<EFBDB8>**縲? |
| 莨夊ｯ晉ｼ灘ｭ<EFBFBD> | Redis | 逕ｨ莠取嘯蟄倡畑謌ｷ逧?DataFrame (蠎丞<E8A08E>蛹紋ｸｺ Parquet/Arrow)<29>碁∩蜈肴ｯ乗ｬ｡謫堺ｽ憺<EFBDBD>蜴?OSS 隸ｻ譁<EFBDBB>ｻｶ縲? |
| 隶｡邂玲恪蜉｡ | FastAPI + Celery | 蠑募<EFBFBD> Celery 螟<>炊蠑よｭ･莉ｻ蜉｡<E89C89>碁亟豁｢髟ｿ隶｡邂鈴仆蝪<E4BB86> HTTP 郤ｿ遞九? |
4. 騾<>髄鬟朱勦隸<E58BA6>ｼｰ荳主ｯｹ遲?(Red Teaming Analysis)
譛ｬ闃りｯｦ扈<EFBFBD>ｮｰ蠖穂ｺ<EFBFBD>懃ｺ｢髦滓ｵ玖ｯ補昜ｸｭ蜿醍鴫逧<EFBFBD>ｽ懷惠閾ｴ蜻ｽ鬟朱勦蜿雁<EFBFBD>蟾･遞句喧隗｣蜀ｳ譁ｹ譯医?
*鬟朱勦荳<EFBFBD>壻ｺ､莠貞ｻｶ霑溽噪窶應ｽ捺─蟠ｩ蝪娯?
- *騾<EFBFBD>髄諡ｷ髣ｮ<EFBFBD>? 豈乗ｬ｡ AI 謫堺ｽ憺<EFBDBD>襍ｰ OSS 荳玖ｽｽ -> Pandas 隸ｻ蜿<EFBDBB> -> 隶｡邂<EFBDA1> -> 荳贋ｼ<E8B48B><EFBDBC>悟黒谺｡閠玲慮蜿ｯ閭ｽ雜<EFBDBD>ｿ<EFBFBD> 8遘抵ｼ檎畑謌ｷ譌<EFBDB7>豕募ｿ榊女縲?
- *V7 隗｣蜀ｳ譁ｹ譯茨ｼ? Session 鬩ｻ逡呎ｨ｡蠑<EFBDA1> (Memory-Resident)
- 蛻晏ｧ句喧<EFBFBD><EFBFBD> 逕ｨ謌ｷ荳贋ｼ<E8B48B> Excel 蜷趣ｼ悟錘遶ｯ蟆<EFBDAF><E89F86>蜉<EFBFBD>霓ｽ荳?DataFrame<6D>悟ｹｶ蠎丞<E8A08E>蛹紋ｸｺ Arrow 譬ｼ蠑丞ｭ伜<EFBDAD> Redis (TTL 30min)縲?
- *蠅樣㍼莠､莠抵ｼ? 蜑咲ｫｯ蜿鷹∵欠莉､<E88E89>訓ython 莉?Redis 隸ｻ蜿<EFBDBB> Arrow 謨ｰ謐ｮ<E8AC90>域ｯｫ遘堤ｺｧ<EFBDBA>会ｼ梧鴬陦<E9B4AC> Pandas 隶｡邂暦ｼ悟ｰ<E6829F>ｻ捺棡蜀吝屓 Redis縲?
- *霓ｻ驥丞渚鬥茨ｼ? 隶｡邂怜ｮ梧<EFBDAE>蜷趣ｼ悟宵霑泌<E99C91>?*蜑?100 陦碁｢<E7A281>ｧ域焚謐? 扈吝燕遶?AG Grid 貂ｲ譟薙?
- *謨域棡<EFBFBD>? 閠玲慮郛ｩ遏ｭ閾?0.5s - 1s縲?
鬟朱勦莠鯉ｼ哘xcel 譬ｼ蠑丈ｸ｢螟ｱ (The Format Loss)
- *騾<EFBFBD>髄諡ｷ髣ｮ<EFBFBD>? Pandas 逧?to_excel 莨夐㍾鄂ｮ謇譛牙黒蜈<E9BB92><E89C88>ｼ譬ｷ蠑擾ｼ悟現逕滓<E98095><E6BB93>ｳｨ逧<EFBDA8>｢懆牡蜥梧音豕ｨ莨壻ｸ｢螟ｱ縲?
- *V7 隗｣蜀ｳ譁ｹ譯茨ｼ? 蠎墓攸蛻<EFBFBD>ｦｻ遲也払 (Template Separation)
- 荳贋ｼ<EFBFBD>譌ｶ<EFBFBD><EFBFBD> 蟆<>次蟋?Excel 譬<>ｮｰ荳?"Style Template" (譬ｷ蠑丞ｺ墓攸)<EFBFBD>梧ｰｸ荵<EFBFBD>ｿ晏ｭ伜惠 OSS縲?
- 隶｡邂玲慮<EFBFBD><EFBFBD> 蜿ｪ蝨ｨ蜀<EFBDA8>ｭ<EFBFBD>/Redis 荳ｭ螟<EFBDAD>炊郤ｯ謨ｰ謐ｮ (Values)<29>御ｸ榊<EFBDB8>蠢<EFBFBD><E8A0A2>ｷ蠑上?
- 蟇ｼ蜃ｺ譌ｶ<EFBFBD><EFBFBD> 菴ｿ逕ｨ openpyxl 蜉<>霓ｽ窶懈<E7AAB6>ｷ蠑丞ｺ墓攸窶晢ｼ悟ｰ<E6829F><EFBDB0>蟄倅ｸｭ逧<EFBDAD>眠謨ｰ謐ｮ**蝪ｫ蜈･**蛻ｰ蠎墓攸逧<E694B8>ｯｹ蠎泌攝譬<E6949D>ｸｭ<EFBDB8>御ｿ晉蕗譛ｪ菫ｮ謾ｹ蛹ｺ蝓溽噪閭梧勹濶ｲ蜥梧音豕ｨ縲?
*鬟朱勦荳会ｼ夂憾諤∝酔豁･逧<EFBFBD>懷曙蜀吝<EFBFBD>遯≫?
- *騾<EFBFBD>髄諡ｷ髣ｮ<EFBFBD>? 逕ｨ謌ｷ謇句勘菫ｮ謾ｹ莠<EFBDB9>ｬｬ 5 陦鯉ｼ悟酔譌ｶ AI 蛻<>髯､莠<EFBDA4>ｬｬ 5 陦鯉ｼ悟ｯｼ閾ｴ謨ｰ謐ｮ迥ｶ諤∽ｸ堺ｸ閾ｴ縲?
- *V7 隗｣蜀ｳ譁ｹ譯茨ｼ? UI 莠呈箕髞?(UI Locking)
- 蠖?AI 豁｣蝨ｨ逕滓<E98095>莉｣遐∵<E98190>蜷守ｫｯ豁｣蝨ｨ隶｡邂玲慮<E78EB2>窟G Grid 蠑ｺ蛻ｶ霑帛<E99C91> readOnly 讓｡蠑擾ｼ悟ｹｶ蝨ｨ逡碁擇譏ｾ遉?"AI 豁｣蝨ｨ螟<EFBDA8>炊..." 驕ｮ鄂ｩ<E98482>?*迚ｩ逅<EFBDA9>ｱる擇荳顔ｦ∵ｭ｢蟷ｶ蜿第桃菴?*縲?
*鬟朱勦蝗幢ｼ壼ｮ牙<EFBFBD>豐咏ｮｱ騾<EFBFBD>?
- *騾<EFBFBD>髄諡ｷ髣ｮ<EFBFBD>? AI 逕滓<E98095>莠?import os; os.system('rm -rf /')縲?
- *V7 隗｣蜀ｳ譁ｹ譯茨ｼ? AST 髱呎∝<C280>譫?+ 螳ｹ蝎ｨ髫皮ｦｻ
- *鬚<EFBFBD>｣<EFBFBD>? 蝨ｨ謇ｧ陦?exec() 蜑搾ｼ御ｽｿ逕ｨ Python ast 讓｡蝮玲沖謠丈ｻ｣遐∵<E98190>托ｼ梧｣豬句芦 import os 遲牙<E981B2>髞ｮ隸咲峩謗･謚帛<E8AC9A>蠑ょｸｸ縲?
- *襍<EFBFBD>ｺ宣剞鬚晢ｼ? 菴ｿ逕ｨ Python resource 讓｡蝮鈴剞蛻ｶ蜊墓ｬ｡謇ｧ陦檎<E999A6>?CPU 譌ｶ髣ｴ (10s) 蜥?蜀<>ｭ<EFBFBD> (1GB)縲?
5. 謨ｰ謐ｮ蠎楢ｮｾ隶?(蜈<>焚謐ｮ螻<EFBDAE>)
譁ｰ蠅<EFBFBD> TaskAudit 陦ｨ逕ｨ莠手ｮｰ蠖墓ｯ丈ｸ谺?AI 謫堺ｽ懃噪荳贋ｸ区枚<E58CBA>御ｾｿ莠主屓貊壼柱螳｡隶｡縲?
model TaskAudit {
id String @id @default(uuid())
datasetId String
version Int // 謫堺ｽ懷錘逧<E98C98>沿譛ｬ蜿?
actionType String // "AI_CODE" or "MANUAL_EDIT"
prompt String? // 逕ｨ謌ｷ逧<EFBDB7><E980A7>辟ｶ隸ｭ險謖<C280>ｻ､
code String? // AI 逕滓<E98095>逧?Python 莉｣遐<EFBDA3>
executionTime Int // 謇ｧ陦瑚玲慮 (ms)
status String // SUCCESS / FAILED
createdAt DateTime @default(now())
}
6. API 謗･蜿｣螳壻ｹ<E5A3BB> (V7 莨伜喧)
- POST /api/session/init: 荳贋ｼ<E8B48B>譁<EFBFBD>ｻｶ<EFBDBB>悟<EFBFBD>蟋句喧 Redis Session<6F>瑚ｿ泌<EFBDBF>?sessionId縲?
- POST /api/session/execute:
- Input: { sessionId, code, version }
- Output: { previewData: ArrowBase64, newVersion: int, logs: string }
- 隸ｴ譏<EFBFBD>: 莉<>ｿ泌屓鬚<E5B193>ｧ域焚謐ｮ<E8AC90>御ｸ咲函謌?Excel 譁<>ｻｶ縲?
- POST /api/session/save:
- Input: { sessionId }
- Output: { downloadUrl }
- 隸ｴ譏<EFBFBD>: 隗ｦ蜿<EFBDA6> openpyxl 蜷亥ｹｶ騾ｻ霎托ｼ檎函謌先怙扈?Excel 蟷ｶ荳贋ｼ?OSS縲?
*7. 蠑蜿大<E89CBF>蟾･蟒ｺ隶?
- Python 扈?(驥堺ｸｭ荵矩㍾):
- 螳樒鴫 Arrow <-> Pandas 逧<>ｺ丞<EFBDBA>蛹夜ｻ霎代?
- 蟆∬｣<EFBFBD> openpyxl 逧<><E980A7>ｷ蠑丞屓蝪ｫ騾ｻ霎代?
- 謳ｭ蟒ｺ FastAPI + Redis 邇ｯ蠅<EFBDAF>?
- Node.js 扈?
- 雍溯ｴ｣ Dify 霓ｬ蜿大柱驩ｴ譚<EFBDB4>?
- 蜑咲ｫｯ扈?
- 髮<EFBFBD><EFBFBD> apache-arrow JS 蠎難ｼ瑚ｧ｣譫仙錘遶ｯ霑泌屓逧<E5B193>ｺ瑚ｿ帛宛豬∝ｹｶ蝨?AG Grid 螻慕､ｺ縲?
- 螳樒鴫窶廣I 螟<>炊荳ｭ窶晉噪蜈ｨ螻城煤螳壻ｺ､莠偵