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%)
86 lines
5.0 KiB
Markdown
86 lines
5.0 KiB
Markdown
# **CTO 莉｣遐∝ｮ｡譟･謚･蜻奇ｼ哂I荳ｴ蠎顔<E8A08E>皮ｩｶ蟷ｳ蜿ｰ驛ｨ鄂ｲ譫ｶ譫<EFBDB6>**
|
||
|
||
螳｡譬ｸ蟇ｹ雎｡<EFBFBD>?莉ｽ迢ｬ遶矩Κ鄂ｲ譁<EFBDB2>｡?(Dify/Python/Node/Frontend/PostgreSQL)
|
||
螳｡譬ｸ莠ｺ<EFBFBD>夊劒諡滓楔譫<EFBFBD>ｸ?
|
||
扈楢ｮｺ<EFBFBD>哂- (莨倡ｧ)縲よ楔譫<E6A594>ｮｾ隶｡隨ｦ蜷井ｺ大次逕溽炊蠢ｵ<E8A0A2>梧<EFBFBD>譛ｬ荳取黄螻墓ｧ蟷ｳ陦｡濶ｯ螂ｽ縲ゆｽ<E38286>ｭ伜惠鄂醍ｻ懷<EFBDBB>蜿｣蜥御ｾ晁ｵ夜溜邇ｯ荳､荳ｪ蜈ｳ髞ｮ鬟朱勦轤ｹ髴隗｣蜀ｳ縲?
|
||
## **1\. 讓｡蝮礼ｺｧ豺ｱ蠎ｦ螳｡隶?(Module-Level Audit)**
|
||
|
||
### **笨?1.1 蜑咲ｫｯ Nginx (SAE)**
|
||
|
||
* **莨倡せ**<2A>壼､夐亳谿ｵ譫<EFBDB5>ｻｺ莨倡ｧ<EFBDA7>井ｽ鍋ｧｯ蟆擾ｼ会ｼ帷識蠅<E8AD98>序驥乗ｳｨ蜈･譁ｹ譯茨ｼ<E88CA8>nvsubst<73>蛾撼蟶ｸ荳謎ｸ夲ｼ瑚ｧ｣蜀ｳ莠<EFBDB3>撕諤<E69295>｡ｵ髱｢譌<EFBDA2>豕募勘諤<E58B98><E8ABA4>鄂ｮ蜷守ｫｯ逧<EFBDAF>埓鬚倥?
|
||
* **菫ｮ豁｣蟒ｺ隶ｮ**<2A>?
|
||
* 遑ｮ隶､ nginx.conf 荳ｭ蠑蜷?gzip<69>瑚ｿ吝ｯ?React 螟ｧ菴鍋ｧ?JS 譁<>ｻｶ閾ｳ蜈ｳ驥崎ｦ√?
|
||
* 譽譟?Nginx 逧?client\_max\_body\_size 驟咲ｽｮ縲ょ現逍?PDF/Excel 蜿ｯ閭ｽ雜<EFBDBD>ｿ<EFBFBD>ｻ倩ｮ､逧?1MB<4D>悟ｻｺ隶ｮ隶ｾ鄂ｮ荳ｺ 50M縲?
|
||
### **笨?1.2 蜷守ｫｯ Node.js (SAE)**
|
||
|
||
* **莨倡せ**<2A>啀risma "蜿榊髄蜷梧ｭ･" 豬∫ｨ矩撼蟶ｸ蜉｡螳橸ｼ瑚ｧ｣蜀ｳ莠<EFBDB3>ｼ蜿台ｹ<E58FB0>諠ｯ荳崎ｧ<E5B48E>激逧<E6BF80>琉鬚倥１ostgres-Only 逧<>楔譫<E6A594>栫螟ｧ蝨ｰ髯堺ｽ惹ｺ<E683B9>ｿ千ｻｴ雍滓球縲?
|
||
* **菫ｮ豁｣蟒ｺ隶ｮ**<2A>?
|
||
* **霑樊磁豕<E7A381>ｼ城｣朱勦**<2A>啀ython 譛榊苅螯よ棡蜩榊ｺ疲<EFBDBA><E796B2>悟錘遶ｯ逧?HTTP Client 隶ｾ鄂ｮ雜<EFBDAE>慮莠<E685AE>雛<EFBFBD>溷ｻｺ隶ｮ隶ｾ鄂?timeout: 30s<30>碁亟豁｢蜷守ｫｯ霑樊磁謨ｰ蝣<EFBDB0>ｧｯ縲?
|
||
### **笨?1.3 Python 蠕ｮ譛榊<E8AD9B>?(SAE)**
|
||
|
||
* **莨倡せ**<2A>壽<EFBFBD>遑ｮ謖<EFBDAE><E8AC96>莠<EFBFBD> libGL 遲臥ｳｻ扈滉ｾ晁ｵ夜琉鬚假ｼ瑚ｿ呎弍 Python 螳ｹ蝎ｨ蛹匁怙螟ｧ逧<EFBDA7>搗<EFBFBD>梧枚譯｣蟾ｲ謠仙燕隗<E78795>∩縲?
|
||
* **菫ｮ豁｣蟒ｺ隶ｮ**<2A>?
|
||
* **OOM 鬟朱勦**<2A>啀ython 霑帷ｨ具ｼ亥ｰ､蜈ｶ譏ｯ PyMuPDF/OCR<43>蛾撼蟶ｸ蜷<EFBDB8><E89CB7>蟄倥ょ惠 2G 蜀<>ｭ倬剞蛻ｶ荳具ｼ悟苅蠢<E88B85>剞蛻ｶ蟷ｶ蜿第焚<E7ACAC><E7849A>unicorn Workers 荳崎ｦ∬ｶ<E288AC>ｿ<EFBFBD> 2 荳ｪ<E88DB3>峨?
|
||
### **笨?1.4 Dify (ECS)**
|
||
|
||
* **莨倡せ**<2A>夐画叫莠?ECS 驛ｨ鄂ｲ莉･菫晁ｯ∵焚謐ｮ遘∵怏蛹厄ｼ悟酔譌ｶ菴ｿ逕?Swap 髦ｲ豁｢ OOM<4F>碁撼蟶ｸ諛り｡後?
|
||
* **菫ｮ豁｣蟒ｺ隶ｮ**<2A>?
|
||
* **螳牙<E89EB3>諤?*<2A>哘CS 逧?Redis 遶ｯ蜿｣ (6379) 蜥?Weaviate 遶ｯ蜿｣ (8080) **扈晏ｯｹ荳崎ｦ<E5B48E>**蟇ｹ蜈ｬ鄂大ｼ謾ｾ縲ゆｻ<E38286><EFBDBB>隶ｸ localhost 蜥?VPC 蜀<>ｽ題ｮｿ髣ｮ縲?
|
||
### **笨?1.5 謨ｰ謐ｮ蠎?(RDS)**
|
||
|
||
* **莨倡せ**<2A>售chema 髫皮ｦｻ隶ｾ隶｡譫∽ｽｳ縲?
|
||
* **菫ｮ豁｣蟒ｺ隶ｮ**<2A>?
|
||
* **Dify 謨ｰ謐ｮ蠎馴囈遖?*<2A>夂｡ｮ隶?Dify 菴ｿ逕ｨ逧<EFBDA8>弍迢ｬ遶狗<E981B6>?dify\_prod 蠎難ｼ御ｸ崎ｦ∝柱荳壼苅陦ｨ豺ｷ蝨ｨ ai\_clinical\_research 蠎謎ｸｭ<EFBDB8>碁亟豁?Dify 蜊<>ｺｧ閼壽悽隸ｯ蛻<EFBDAF>荳壼苅陦ｨ縲?
|
||
## **2\. 霍ｨ讓｡蝮鈴寔謌宣｣朱<EFBDA3>?(Integration Risks)**
|
||
|
||
### **<2A>圷 鬟朱勦荳<E88DB3>售AE 逧?蟄､蟯帶譜蠎<E8AD9C>" (Internet Access)**
|
||
|
||
* **髣ｮ鬚<EFBDAE>**<2A>售AE 驛ｨ鄂ｲ蝨?VPC 蜀<>ｼ碁ｻ倩ｮ､**豐｡譛牙<E8AD9B>鄂大<E98482>蜿｣**縲?
|
||
* **蝨ｺ譎ｯ**<2A>壼錘遶ｯ隹<EFBDAF><E99AB9>?DeepSeek API縲￣ython 荳玖ｽｽ蜈ｬ鄂<EFBDAC> PDF縲¨PM 螳芽｣<E88ABD>ｾ晁ｵ厄ｼ域桷蟒ｺ譌ｶ<E8AD8C>峨?
|
||
* **蟇ｹ遲<EFBDB9>**<2A>壼ｿ<E5A3BC>｡ｻ蝨ｨ VPC 荳ｭ驟咲ｽ?**NAT 鄂大<E98482>** (謗ｨ闕<EFBDA8>) 謌也｡ｮ菫?SAE 譛臥ｻ大ｮ壼<EFBDAE>鄂?IP 逧<><E980A7>蜉帙?*蜷ｦ蛻吩ｸ顔ｺｿ蠖灘､ｩ謇譛?AI 蜉溯<E89C89>驛ｽ莨夊ｶ<E5A48A>慮縲?*
|
||
|
||
### **<2A>売 鬟朱勦莠鯉ｼ夐Κ鄂ｲ萓晁ｵ匁ｭｻ髞<EFBDBB> (Deployment Deadlock)**
|
||
|
||
* **邇ｰ雎｡**<2A>?
|
||
1. 蜷守ｫｯ蜷ｯ蜉ｨ髴隕?DIFY\_API\_KEY縲?
|
||
2. DIFY\_API\_KEY 髴隕?Dify 蜷ｯ蜉ｨ蟷ｶ莠ｺ蟾･逋ｻ蠖募錘謇崎<E8AC87>逕滓<E98095>縲?
|
||
3. 蜷守ｫｯ螯よ棡驟咲ｽｮ莠?蛛･蠎ｷ譽譟･螟ｱ雍･蛻咎㍾蜷ｯ"<22>悟惠蝪ｫ蜈･ Key 荵句燕莨壽裏髯宣㍾蜷ｯ縲?
|
||
* **蟇ｹ遲<EFBDB9>**<2A>夐ｦ匁ｬ｡驛ｨ鄂ｲ譌ｶ<E8AD8C>悟錘遶ｯ邇ｯ蠅<EFBDAF>序驥?DIFY\_API\_KEY 蜿ｯ莉･蜈亥｡ｫ荳ｪ蛛<EFBDAA>ｼ<C280>亥ｦ?temp<6D>会ｼ瑚ｮｩ譛榊苅霍題ｵｷ譚･縲らｭ<E38289> Dify 驛ｨ鄂ｲ螂ｽ諡ｿ蛻ｰ逵<EFBDB0> Key 蜷趣ｼ梧峩譁ｰ SAE 驟咲ｽｮ蟷ｶ驥榊星縲?
|
||
### **<2A>倹 鬟朱勦荳会ｼ壼燕遶ｯ荳?Dify 逧<>ｷｨ蝓?(CORS)**
|
||
|
||
* **髣ｮ鬚<EFBDAE>**<2A>壼燕遶ｯ逶ｴ謗･隹<EFBDA5>畑蜷守ｫｯ<EFBDAB>磯夊ｿ<E5A48A> Nginx 莉｣逅<EFBDA3>ｼ画ｲ｡髣ｮ鬚倥ゆｽ<E38286>ｦよ棡蜑咲ｫｯ髴隕?*逶ｴ謗･蠏悟<E8A08F>** Dify 逧?Web UI<55>亥ｦ<E4BAA5> iframe<6D>画<EFBFBD>逶ｴ謗･隹<EFBDA5>畑 Dify API<50>育ｻ戊ｿ<E6888A>錘遶ｯ<E981B6>会ｼ御ｼ夐∞蛻ｰ CORS縲?
|
||
* **蟇ｹ遲<EFBDB9>**<2A>壼撓謖―*\*"謇譛芽ｯｷ豎りｵｰ蜷守ｫｯ"\*\*逧<>次蛻吶ょ燕遶?\-\> Nginx \-\> 蜷守ｫｯ \-\> Dify縲ゆｸ崎ｦ∬ｮｩ蜑咲ｫｯ逶ｴ霑<EFBDB4> Dify<66>梧里螳牙<E89EB3>蜿磯∩蜈?CORS縲?
|
||
## **3\. 譫ｶ譫<EFBDB6><E8ADAB>邉ｻ蝗ｾ隹ｱ**
|
||
|
||
\[豬剰ｧ亥勣\]
|
||
| (HTTPS)
|
||
v
|
||
\[SAE: 蜑咲ｫｯ Nginx\]
|
||
| (蜿榊髄莉｣逅<EFBDA3> /api)
|
||
v
|
||
\[SAE: 蜷守ｫｯ Node.js\] \--(蜀<>ｽ践TTP)--\> \[SAE: Python 蠕ｮ譛榊苅\]
|
||
| | (蜀<>ｽ践TTP)
|
||
| v
|
||
| \[ECS: Dify API\] \<--\> \[ECS: Weaviate/Redis\]
|
||
|
|
||
\+--(TCP Connection)--\> \[RDS PostgreSQL 15\]
|
||
| | (Schema: platform, asl, dc...)
|
||
| \+ (Database: dify\_prod)
|
||
|
|
||
\+--(HTTPS)--\> \[OSS 蟇ｹ雎｡蟄伜お\]
|
||
|
|
||
\+--(NAT鄂大<E98482>)--\> \[莠定＃鄂? DeepSeek/OpenAI\]
|
||
|
||
## **4\. 扈?1-2 莠ｺ蝗｢髦溽噪逕溷ｭ伜ｻｺ隶ｮ**
|
||
|
||
1. **逵<>蝶鮟醍ｧ第橿**<EFBFBD>?
|
||
* SAE 2.0 譛?*髣ｲ鄂ｮ隶｡雍ｹ**蜉溯<E89C89>縲ょｼ蜿醍識蠅<E8AD98>ｼ域ｵ玖ｯ慕識蠅<E8AD98>ｼ牙苅蠢<E88B85>ｼ蜷ｯ<E89CB7>梧ｲ｡莠ｺ逕ｨ譌ｶ荳肴噺 CPU/蜀<>ｭ<EFBFBD> 雍ｹ縲?
|
||
* RDS 雍ｭ荵ｰ**騾夂畑蝙?* (2譬?G) 蜊ｳ蜿ｯ<E89CBF>御ｸ崎ｦ∽ｹｰ迢ｬ莠ｫ蝙具ｼ悟､溽畑蠕井ｹ<E4BA95>?
|
||
2. **荳崎ｦ∬<EFBDA6>蟒ｺ逶第而**<EFBFBD>?
|
||
* 逶ｴ謗･逕ｨ髦ｿ驥御ｺ<E5BEA1> **ARMS** (蠎皮畑螳樊慮逶第而譛榊苅) 逧<><E980A7>雍ｹ鬚晏ｺｦ謌門渕遑迚医ゆｸ崎ｦ∬<EFBDA6>蟾ｱ謳ｭ Prometheus \+ Grafana<6E>檎ｻｴ謚､謌先悽螟ｪ鬮倥?
|
||
3. **謨ｰ謐ｮ螟<EFBDAE>ｻｽ譏ｯ蠎慕ｺ?*<2A>?
|
||
* RDS 蠑蜷ｯ閾ｪ蜉ｨ螟<EFBDA8>ｻｽ<EFBDBB>井ｿ晉蕗7螟ｩ<E89E9F>峨?
|
||
* ECS 荳顔噪 Dify docker-compose.yaml 蜥?.env 譁<>ｻｶ<EFBDBB>悟苅蠢<E88B85>惠譛ｬ蝨ｰ謌?Git 遘∵怏莉灘ｺ灘､<E78198>ｻｽ荳莉ｽ縲<EFBDBD>CS 豐｡莠<EFBDA1>庄莉･驥堺ｹｰ<EFBDB9>碁<EFBFBD>鄂ｮ譁<EFBDAE>ｻｶ豐｡莠<EFBDA1>ｰｱ蠕鈴㍾驟阪?
|
||
4. **蠑蜿第譜邇?*<2A>?
|
||
* 蛻ｩ逕ｨ ECS 蛛?*霍ｳ譚ｿ譛?*<2A>梧悽蝨ｰ逶ｴ霑?RDS 蠑蜿代ゆｸ崎ｦ∵ｯ乗ｬ｡驛ｽ蜀吩ｻ｣遐∝悉譟･謨ｰ謐ｮ縲?
|
||
**譛扈育ｻ楢ｮ?*<2A>夊ｿ吝･玲楔譫<E6A594>ｮｾ隶｡蠕鈴撼蟶ｸ謇主ｮ橸ｼ悟ｮ悟<EFBDAE>蜿ｯ莉･謾ｯ謦台ｻ<E58FB0> 0 蛻?10 荳<>畑謌ｷ逧<EFBDB7>ｧ<EFBFBD>ｨ｡縲りｯｷ驥咲せ隗｣蜀ｳ **"SAE 隶ｿ髣ｮ蜈ｬ鄂<EFBDAC> (NAT)"** 霑吩ｸｪ髣ｮ鬚假ｼ悟叉蜿ｯ蠑蟋矩Κ鄂ｲ縲 |