feat(aia): Complete AIA V2.0 with universal streaming capabilities
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%)
This commit is contained in:
@@ -1,53 +1,44 @@
|
||||
# **REDCap 逕滉ｺｧ邇ｯ蠅<EFBDAF>Κ鄂ｲ<E98482>哘CS vs SAE 豺ｱ蠎ｦ蜀ｳ隶ｮ謚･蜻<EFBDA5>**
|
||||
|
||||
## **1\. 核心结论：认可 ECS 优先策略**
|
||||
## **1\. 譬ｸ蠢<EFBFBD>ｻ楢ｮｺ<EFBFBD>夊ｮ､蜿?ECS 莨伜<E88EA8>遲也払**
|
||||
|
||||
针对 IIT Manager Agent 项目，我们决定将 REDCap 生产环境部署在 **ECS (Docker 模式)** 运行，而不是 SAE。
|
||||
髓亥ｯｹ IIT Manager Agent 鬘ｹ逶ｮ<EFBFBD>梧<EFBFBD>莉ｬ蜀ｳ螳壼ｰ<EFBFBD> REDCap 逕滉ｺｧ邇ｯ蠅<EFBDAF>Κ鄂ｲ蝨?**ECS (Docker 讓｡蠑<EFBDA1>)** 霑占｡鯉ｼ瑚御ｸ肴<EFBDB8>?SAE縲?
|
||||
### **荳ｺ莉荵域<E88DB5>莉ｬ窶懆ｮ､髞吮晏ｹｶ霓ｬ蜷<EFBDAC> ECS<43>?*
|
||||
|
||||
### **为什么我们“认错”并转向 ECS？**
|
||||
|
||||
在讨论 AI 后端时，SAE 的免运维特性很吸引人，但 REDCap 的三个“致命特性”决定了它在 SAE 上会极其痛苦：
|
||||
|
||||
1. **Cron 依赖（心跳丢失）**：REDCap 每分钟都需要运行一次 cron.php。在 SAE 中，你得额外买 SchedulerX 服务；在 ECS，只需一行 crontab 就能搞定且 100% 可靠。
|
||||
2. **Session 粘滞（掉线噩梦）**：REDCap 默认将会话存本地。SAE 是多实例的，如果没做 Redis 共享，用户登录后会反复掉线，2 人团队去修这个 Bug 会耗费大量时间。
|
||||
3. **文件系统 POSIX 依赖**：REDCap 像 10 年前的软件一样极其依赖本地文件夹读写。SAE 必须挂载 NAS，网络延迟会拖慢整个系统的响应。
|
||||
|
||||
## **2\. 深度对比：务实派的决策依据**
|
||||
蝨ｨ隶ｨ隶?AI 蜷守ｫｯ譌ｶ<E8AD8C>郡AE 逧<><E980A7>霑千ｻｴ迚ｹ諤ｧ蠕亥精蠑穂ｺｺ<EFBDBA>御ｽ?REDCap 逧<>ｸ我ｸｪ窶懆<E7AAB6>蜻ｽ迚ｹ諤ｧ窶晏<E7AAB6>螳壻ｺ<E5A3BB>ｮ<EFBFBD>惠 SAE 荳贋ｼ壽栫蜈ｶ逞幄協<E5B984>?
|
||||
1. **Cron 萓晁ｵ厄ｼ亥ｿ<E4BAA5>ｷｳ荳｢螟ｱ<E89E9F><EFBDB1>**<EFBFBD>啌EDCap 豈丞<E8B188>髓滄<E9AB93>髴隕∬ｿ占｡御ｸ谺?cron.php縲ょ惠 SAE 荳ｭ<E88DB3>御ｽ<E5BEA1>蠕鈴｢晏､紋ｹ?SchedulerX 譛榊苅<E6A68A>帛惠 ECS<43>悟宵髴荳陦?crontab 蟆ｱ閭ｽ謳槫ｮ壻ｸ?100% 蜿ｯ髱<EFBDAF>縲?
|
||||
2. **Session 邊俶ｻ橸ｼ域脂郤ｿ蝎ｩ譴ｦ<E8ADB4><EFBDA6>**<EFBFBD>啌EDCap 鮟倩ｮ､蟆<EFBDA4>ｼ夊ｯ晏ｭ俶悽蝨ｰ縲４AE 譏ｯ螟壼ｮ樔ｾ狗噪<E78B97>悟ｦよ棡豐｡蛛<EFBDA1> Redis 蜈ｱ莠ｫ<E88EA0>檎畑謌ｷ逋ｻ蠖募錘莨壼渚螟肴脂郤ｿ<E983A4><EFBDBF>2 莠ｺ蝗｢髦溷悉菫ｮ霑吩ｸ?Bug 莨夊苓ｴｹ螟ｧ驥乗慮髣ｴ縲?
|
||||
3. **譁<>ｻｶ邉ｻ扈<EFBDBB> POSIX 萓晁ｵ<E69981>**<EFBFBD>啌EDCap 蜒?10 蟷ｴ蜑咲噪霓ｯ莉ｶ荳譬ｷ譫∝<E8ADAB>萓晁ｵ匁悽蝨ｰ譁<EFBDB0>ｻｶ螟ｹ隸ｻ蜀吶４AE 蠢<>｡ｻ謖りｽｽ NAS<41>檎ｽ醍ｻ懷ｻｶ霑滉ｼ壽許諷｢謨ｴ荳ｪ邉ｻ扈溽噪蜩榊ｺ斐?
|
||||
## **2\. 豺ｱ蠎ｦ蟇ｹ豈費ｼ壼苅螳樊ｴｾ逧<EFBDBE><E980A7>遲紋ｾ晄<EFBDBE>?*
|
||||
|
||||
| 扈ｴ蠎ｦ | ECS \+ Docker (謌台ｻｬ逧<EFBDAC>画叫) | SAE (Serverless) | 扈楢ｮｺ |
|
||||
| :---- | :---- | :---- | :---- |
|
||||
| **部署成本** | **低**。入门级 ECS (2核4G) 约 1500元/年。 | **高**。SAE \+ NAS \+ 闲置费用可能更贵。 | **ECS 胜** |
|
||||
| **配置复杂度** | **极简**。只需运行 docker-compose.yml。 | **复杂**。需解决共享存储、Session同步、定时任务。 | **ECS 胜** |
|
||||
| **系统透明度** | **透明**。直接 docker logs 查看 PHP 日志。 | **黑盒**。云原生链路长，报错时排查难度大。 | **ECS 胜** |
|
||||
| **可移植性** | **最强**。这份 Docker 配置可以原封不动挪到医院内网。 | **差**。医院内网通常没有 SAE 这种环境。 | **ECS 胜** |
|
||||
| **驛ｨ鄂ｲ謌先悽** | **菴?*縲ょ<E7B8B2>髣ｨ郤ｧ ECS (2譬?G) 郤?1500蜈?蟷ｴ縲?| **鬮?*縲４AE \+ NAS \+ 髣ｲ鄂ｮ雍ｹ逕ｨ蜿ｯ閭ｽ譖ｴ雍ｵ縲?| **ECS 閭?* |
|
||||
| **驟咲ｽｮ螟肴揩蠎?* | **譫∫ｮ**縲ょ宵髴霑占｡<E58DA0> docker-compose.yml縲?| **螟肴揩**縲る怙隗｣蜀ｳ蜈ｱ莠ｫ蟄伜お縲ヾession蜷梧ｭ･縲∝ｮ壽慮莉ｻ蜉｡縲?| **ECS 閭?* |
|
||||
| **邉ｻ扈滄乗<EFBFBD>蠎?* | **騾乗<EFBFBD>**縲ら峩謗?docker logs 譟･逵<EFBFBD> PHP 譌･蠢励?| **鮟醍將**縲ゆｺ大次逕滄得霍ｯ髟ｿ<E9AB9F>梧冠髞呎慮謗呈衍髫ｾ蠎ｦ螟ｧ縲?| **ECS 閭?* |
|
||||
| **蜿ｯ遘ｻ讀肴?* | **譛蠑?*縲りｿ吩ｻ?Docker 驟咲ｽｮ蜿ｯ莉･蜴溷ｰ∽ｸ榊勘謖ｪ蛻ｰ蛹ｻ髯｢蜀<EFBDA2>ｽ代?| **蟾?*縲ょ現髯｢蜀<EFBDA2>ｽ鷹壼ｸｸ豐｡譛<EFBDA1> SAE 霑咏ｧ咲識蠅<E8AD98>?| **ECS 閭?* |
|
||||
|
||||
## **3\. 2 人团队的“生存之道”**
|
||||
|
||||
作为一个只有 2 人的团队，我们的时间应该花在 **Agent 的 Prompt 调优** 和 **业务逻辑** 上，而不是花在“调试云产品之间的连接”上。
|
||||
|
||||
* **ECS 方案**：你就像拥有了一台真正的电脑。文件在哪、日志在哪、数据库连没连上，你一眼就能看清。
|
||||
* **SAE 方案**：你会陷入“为什么挂载了 NAS 还是没写权限？”、“为什么 Cron 没触发？”这种与业务无关的琐事中。
|
||||
## **3\. 2 莠ｺ蝗｢髦溽噪窶懃函蟄倅ｹ矩％窶?*
|
||||
|
||||
菴應ｸｺ荳荳ｪ蜿ｪ譛?2 莠ｺ逧<EFBDBA>屬髦滂ｼ梧<EFBDBC>莉ｬ逧<EFBDAC>慮髣ｴ蠎碑ｯ･闃ｱ蝨ｨ **Agent 逧?Prompt 隹<>ｼ<EFBFBD>** 蜥?**荳壼苅騾ｻ霎<EFBDBB>** 荳奇ｼ瑚御ｸ肴弍闃ｱ蝨ｨ窶懆ｰ<E68786>ｯ穂ｺ台ｺｧ蜩∽ｹ矩龍逧<E9BE8D>ｿ樊磁窶昜ｸ翫?
|
||||
* **ECS 譁ｹ譯<EFBDB9>**<2A>壻ｽ<E5A3BB>蟆ｱ蜒乗凶譛我ｺ<E68891>ｸ蜿ｰ逵滓ｭ｣逧<EFBDA3>鳩閼代よ枚莉ｶ蝨ｨ蜩ｪ縲∵律蠢怜惠蜩ｪ縲∵焚謐ｮ蠎楢ｿ樊ｲ｡霑樔ｸ奇ｼ御ｽ<E5BEA1>荳逵ｼ蟆ｱ閭ｽ逵区ｸ<E58CBA>?
|
||||
* **SAE 譁ｹ譯<EFBDB9>**<2A>壻ｽ<E5A3BB>莨夐匚蜈･窶應ｸｺ莉荵域撃霓ｽ莠<EFBDBD> NAS 霑俶弍豐｡蜀呎揀髯撰ｼ溪昴≫應ｸｺ莉荵?Cron 豐｡隗ｦ蜿托ｼ溪晁ｿ咏ｧ堺ｸ惹ｸ壼苅譌<E88B85>蜈ｳ逧<EFBDB3>瑞莠倶ｸｭ縲?
|
||||
## **4\. 譛扈亥ｮ夂ｨｿ<EFBDA8>壽ｷｷ蜷域楔譫<E6A594>統蝗ｾ**
|
||||
|
||||
我们将采取\*\*“混合云”\*\*的思路，发挥各自的长处：
|
||||
謌台ｻｬ蟆<EFBFBD>㊦蜿暴*\*窶懈ｷｷ蜷井ｺ鯛拿*\*逧<>晁ｷｯ<EFBDB7>悟書謖･蜷<EFBDA5><E89CB7>逧<EFBFBD>柄螟<E69F84>ｼ?
|
||||
### **4.1 謨ｰ謐ｮ蟷ｳ髱｢ (Data Layer) \-\> 驛ｨ鄂ｲ蝨?ECS**
|
||||
|
||||
### **4.1 数据平面 (Data Layer) \-\> 部署在 ECS**
|
||||
|
||||
* **组件**：REDCap (Apache \+ PHP 8.1)。
|
||||
* **方式**：使用 Docker-Compose 运行。
|
||||
* **存储**：附件存储在 ECS 挂载的云盘；数据库连接 **RDS MySQL**。
|
||||
* **优势**：保证了 EDC 系统的绝对稳定和传统运维的简便。
|
||||
|
||||
### **4.2 控制平面 (AI Agent Layer) \-\> 部署在 SAE**
|
||||
|
||||
* **组件**：Node.js 后端、Python 算法、AI 前端。
|
||||
* **方式**：Serverless 部署。
|
||||
* **优势**：利用 SAE 处理 AI 这种流量波动大、需要弹性伸缩的模块。
|
||||
* **扈<>ｻｶ**<2A>啌EDCap (Apache \+ PHP 8.1)縲?
|
||||
* **譁ｹ蠑<EFBDB9>**<2A>壻ｽｿ逕?Docker-Compose 霑占｡後?
|
||||
* **蟄伜お**<2A>夐刋莉ｶ蟄伜お蝨ｨ ECS 謖りｽｽ逧<EFBDBD>ｺ醍尨<E9868D>帶焚謐ｮ蠎楢ｿ樊<EFBDBF>?**RDS MySQL**縲?
|
||||
* **莨伜漢**<2A>壻ｿ晁ｯ∽ｺ<E288BD> EDC 邉ｻ扈溽噪扈晏ｯｹ遞ｳ螳壼柱莨<E69FB1>扈溯ｿ千ｻｴ逧<EFBDB4>ｮ萓ｿ縲?
|
||||
### **4.2 謗ｧ蛻ｶ蟷ｳ髱｢ (AI Agent Layer) \-\> 驛ｨ鄂ｲ蝨?SAE**
|
||||
|
||||
* **扈<>ｻｶ**<2A>哢ode.js 蜷守ｫｯ縲￣ython 邂玲ｳ輔、I 蜑咲ｫｯ縲?
|
||||
* **譁ｹ蠑<EFBDB9>**<2A>售erverless 驛ｨ鄂ｲ縲?
|
||||
* **莨伜漢**<2A>壼茜逕?SAE 螟<>炊 AI 霑咏ｧ肴ｵ<E882B4>㍼豕｢蜉ｨ螟ｧ縲<EFBDA7>怙隕∝ｼｹ諤ｧ莨ｸ郛ｩ逧<EFBDA9>ｨ｡蝮励?
|
||||
## **5\. 蟇ｹ蜷守ｻｭ蠑蜿醍噪諢丈ｹ<E4B888>**
|
||||
|
||||
1. **本地环境即生产环境**：由于 ECS 跑的是 Docker，你在本地 03-REDCap本地部署方案.md 里写的代码，直接就能上线，没有任何“环境漂移”。
|
||||
2. **离线交付预演**：如果未来医院要求内网部署，我们已经有了一套完整的、基于 ECS/Docker 的交付包，这比 SAE 方案更容易被医院 IT 接受。
|
||||
|
||||
**当前状态**：Deployment Strategy Locked | **建议**：立即执行基于 ECS 的生产环境搭建。
|
||||
1. **譛ｬ蝨ｰ邇ｯ蠅<EFBFBD>叉逕滉ｺｧ邇ｯ蠅?*<2A>夂罰莠?ECS 霍醍噪譏?Docker<65>御ｽ<E5BEA1>蝨ｨ譛ｬ蝨?03-REDCap譛ｬ蝨ｰ驛ｨ鄂ｲ譁ｹ譯<EFBDB9>.md 驥悟<E9A9A5>逧<EFBFBD>ｻ｣遐<EFBDA3>ｼ檎峩謗･蟆ｱ閭ｽ荳顔ｺｿ<EFBDBA>梧ｲ｡譛我ｻｻ菴補懃識蠅<E8AD98>ｼらｧｻ窶昴?
|
||||
2. **遖ｻ郤ｿ莠､莉倬｢<EFBFBD>ｼ<EFBFBD>**<EFBFBD>壼ｦよ棡譛ｪ譚･蛹ｻ髯｢隕∵ｱょ<EFBFBD>鄂鷹Κ鄂ｲ<EFBFBD>梧<EFBFBD>莉ｬ蟾ｲ扈乗怏莠<EFBFBD>ｸ螂怜ｮ梧紛逧<EFBFBD>∝渕莠?ECS/Docker 逧<>ｺ､莉伜桁<E4BC9C>瑚ｿ呎ｯ?SAE 譁ｹ譯域峩螳ｹ譏楢｢ｫ蛹ｻ髯｢ IT 謗･蜿励?
|
||||
**蠖灘燕迥ｶ諤?*<2A>咼eployment Strategy Locked | **蟒ｺ隶ｮ**<EFBFBD>夂ｫ句叉謇ｧ陦悟渕莠?ECS 逧<>函莠ｧ邇ｯ蠅<EFBDAF>政蟒ｺ縲
|
||||
Reference in New Issue
Block a user