Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(aia): Complete AIA V2.0 with universal streaming capabilities

Browse Source 
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:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

122
docs/03-业务模块/Redcap/01-部署与配置/13-部署问题排查手册.md
View File

@@ -1,19 +1,19 @@
# REDCap Docker <20>砍𧑐<E7A08D>函蔡<E587BD>桅<EFBFBD>閫<EFBFBD><E996AB>霈啣<E99C88>
**日期：** 2026-01-02
**版本：** REDCap 15.8.0
**环境：** Windows 10 + Docker Desktop + Docker Compose
**<EFBFBD>交<EFBFBD>嚗?* 2026-01-02
**<EFBFBD><EFBFBD>𧋦嚗?* REDCap 15.8.0
**<EFBFBD>臬<EFBFBD>嚗?* Windows 10 + Docker Desktop + Docker Compose
---
## <20><> <20>函蔡<E587BD>𣂼<EFBFBD>蝖株恕
✅ **REDCap 15.8.0 已成功部署在本地Docker环境**
<EFBFBD>?**REDCap 15.8.0 撌脫<EFBFBD><EFBFBD>罸<EFBFBD>蝵脣銁<EFBFBD>砍𧑐Docker<EFBFBD>臬<EFBFBD>**
- **访问地址：** http://localhost:8080/
- **霈輸䔮<EFBFBD>啣<EFBFBD>嚗?* http://localhost:8080/
- **蝞∠<E89D9E><E288A0>䁅揭<E48185>瘀<EFBFBD>** Admin / Admin123!
- **数据库：** MySQL 8.0（Docker容器）
- **PHPMyAdmin：** http://localhost:8081/
- **<EFBFBD>唳旿摨橒<EFBFBD>** MySQL 8.0嚗㇄ocker摰孵膥嚗?
- **PHPMyAdmin嚗?* http://localhost:8081/
---
@@ -21,25 +21,25 @@
### <20>桅<EFBFBD>1嚗鍃RR_CONTENT_DECODING_FAILED
**现象：**
**<EFBFBD>啗情嚗?*
- 瘚讛<E7989A><E8AE9B>刻挪<E588BB>娜EDCap擐㚚△<E39A9A>嗆𥁒<E59786>辷<EFBFBD>`net::ERR_CONTENT_DECODING_FAILED 200 (OK)`
- CSS/JS韏<53><E99F8F><EFBFBD>㰘蝸憭梯揖
**根本原因：**
**<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?*
1. Apache<68><65>mod_deflate`璅∪<E79285>銝窰HP<48><50>zlib.output_compression`<EFBFBD>脩<EFBFBD>
2. REDCap源码中动态启用了压缩（`System.php`、`general_settings.php`中的`ini_set`）
3. 导致数据被多次压缩，浏览器无法解码
2. REDCap皞鞟<EFBFBD>銝剖𢆡<EFBFBD><EFBFBD>鍳<EFBFBD>其<EFBFBD><EFBFBD>讠憬嚗ǑSystem.php`<EFBFBD><EFBFBD>general_settings.php`銝剔<EFBFBD>`ini_set`嚗?
3. 撖潸稲<EFBFBD>唳旿鋡怠<EFBFBD>甈∪<EFBFBD>蝻抬<EFBFBD>瘚讛<EFBFBD><EFBFBD>冽<EFBFBD>瘜閗圾<EFBFBD>?
**解决方案：**
1. ✅ 在`docker-entrypoint.sh`中强制禁用Apache的deflate模块：`a2dismod -f deflate`
2. ✅ 在`php.ini`中显式关闭压缩：
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?*
1. <EFBFBD>?<3F>灼docker-entrypoint.sh`銝剖撩<E58996>嗥<EFBFBD><E597A5>杗pache<EFBFBD><EFBFBD>eflate璅∪<EFBFBD>嚗䫤a2dismod -f deflate`
2. <EFBFBD>?<3F>灼php.ini`銝剜遬撘誩<EFBFBD><EFBFBD>剖<EFBFBD>蝻抬<EFBFBD>
```ini
zlib.output_compression = Off
output_buffering = Off
```
3. ✅ 在`docker-entrypoint.sh`中自动注释REDCap源码中的`ini_set('zlib.output_compression', ...)`
3. <EFBFBD>?<3F>灼docker-entrypoint.sh`銝剛䌊<EFBFBD>冽釣<EFBFBD>䟕EDCap皞鞟<EFBFBD>銝剔<EFBFBD>`ini_set('zlib.output_compression', ...)`
**预防措施：**
**憸<EFBFBD>俈<EFBFBD>芣鴌嚗?*
- 撌脣銁`redcap.conf`銝剜釣<EFBFBD>𦠜<EFBFBD>`mod_deflate`<EFBFBD>滨蔭
- 撘<><E69298>𤑳㴓憓<E3B493><E68693><EFBFBD><EFBFBD>閬<EFBFBD>zip<69>讠憬嚗<E686AC>虾<EFBFBD>鞾<EFBFBD>靚<EFBFBD><E99D9A><EFBFBD><EFBFBD><EFBFBD>
@@ -47,54 +47,54 @@
### <20>桅<EFBFBD>2嚗鋳ase URL<52>滨蔭<E6BBA8>躰秤
**现象：**
**<EFBFBD>啗情嚗?*
- CSS/JS<4A><53>辣頝臬<E9A09D><E887AC><EFBFBD>鉄憭帋<E686AD><E5B88B><EFBFBD>/redcap/`<60>滨<EFBFBD>
- 靘见<E99D98>嚗䫤http://localhost:8080/redcap/redcap_v15.8.0/Resources/...`
- 撖潸稲404<30>躰秤
**根本原因：**
**<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?*
- REDCap<61>唳旿摨㯄<E691A8>蝵株”`redcap_config`銝剔<EFBFBD>`redcap_base_url`霈曄蔭銝槁http://localhost:8080/redcap`
- 雿<>pache<68><65>DocumentRoot`摰鮋<E691B0><E9AE8B><EFBFBD><EFBFBD>`/var/www/html/redcap_v15.8.0`
**解决方案：**
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?*
```sql
UPDATE redcap_config
SET value = 'http://localhost:8080'
WHERE field_name = 'redcap_base_url';
```
**预防措施：**
- 在安装向导或SQL导入时确保Base URL与DocumentRoot一致
**憸<EFBFBD>俈<EFBFBD>芣鴌嚗?*
- <20>典<EFBFBD>鋆<EFBFBD><E98B86>撖潭<E69296>SQL撖澆<E69296><E6BE86>嗥＆靽𨈚ase URL銝𥟠ocumentRoot銝<EFBFBD><EFBFBD>?
---
### 问题3：登录失败 - 响应数据无法加载
### <EFBFBD>桅<EFBFBD>3嚗𡁶蒈敶訫仃韐?- <20>滚<EFBFBD><E6BB9A>唳旿<E594B3>䭾<EFBFBD><E4ADBE>㰘蝸
**现象：**
- 输入正确的用户名密码后，页面不跳转
**<EFBFBD>啗情嚗?*
- 颲枏<E9A2B2>甇<EFBFBD>＆<EFBFBD><EFBC86>鍂<EFBFBD>瑕<EFBFBD>撖<EFBFBD><E69296><EFBFBD>𠬍<EFBFBD>憿菟𢒰銝滩歲頧?
- Network<72>Ｘ踎<EFBCB8>曄內POST霂瑟<E99C82>餈𥪜<E9A488>200嚗䔶<E59A97>"<22>䭾<EFBFBD><E4ADBE>㰘蝸<E3B098>滚<EFBFBD><E6BB9A>唳旿"
**根本原因：**
- **`database.php`文件末尾有`?>`PHP结束标签和空行**
**<EFBFBD>寞𧋦<EFBFBD>笔<EFBFBD>嚗?*
- **`database.php`<EFBFBD><EFBFBD>辣<EFBFBD>怠偏<EFBFBD>头?>`PHP蝏𤘪<EFBFBD><EFBFBD><EFBFBD>倌<EFBFBD>𣬚征銵?*
- Windows蝟餌<E89D9F><E9A48C><EFBFBD>RLF<4C>Ｚ<EFBFBD>蝚西◤颲枏枂<E69E8F>蚜TTP<54>滚<EFBFBD>
- 导致响应体污染，浏览器无法解析
- 撖潸稲<E6BDB8>滚<EFBFBD>雿𤘪情<F0A498AA>橒<EFBFBD>瘚讛<E7989A><E8AE9B>冽<EFBFBD>瘜閗圾<E99697>?
**详细分析：**
**霂衣<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?*
```bash
# database.php末尾的十六进制内容
# database.php<EFBFBD>怠偏<EFBFBD><EFBFBD><EFBFBD><EFBFBD>剛<EFBFBD><EFBFBD>嗅<EFBFBD>摰?
00000050: e585 a80d 0a20 2a2f 0d0a 0d0a 3f3e 0d0a ..... */....?>..
00000060: 0d0a 0d0a ....
# `*/` CRLF CRLF `?>` CRLF CRLF CRLF
```
**解决方案：**
1. ✅ **删除`database.php`末尾的`?>`和所有空行**
2. ✅ **创建`.gitattributes`强制PHP文件使用LF换行符**
3. ✅ **在`docker-entrypoint.sh`中添加检查逻辑（警告提示）**
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>嚗?*
1. <20>?**<2A>𣳇膄`database.php`<EFBFBD>怠偏<EFBFBD><EFBFBD>?>`<60>峕<EFBFBD><E5B395>厩征銵?*
2. <20>?**<2A>𥕦遣`.gitattributes`撘箏<EFBFBD>PHP<EFBFBD><EFBFBD>辣雿輻鍂LF<EFBFBD>Ｚ<EFBFBD>蝚?*
3. <20>?**<2A>灼docker-entrypoint.sh`銝剜溶<E5899C>䭾<EFBFBD><E4ADBE>仿<EFBFBD>餉<EFBFBD>嚗<EFBFBD>郎<EFBFBD>𦠜<EFBFBD>蝷綽<E89DB7>**
**PHP<48><50>雿喳<E99BBF>頝蛛<E9A09D>**
- <20><> **<EFBFBD>滨蔭<EFBFBD><EFBFBD>辣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>辣<EFBFBD>怠偏銝滚<EFBFBD>霂亙<EFBFBD>`?>`**
- 📌 这是PHP官方推荐，用于防止末尾空行污染输出
- <20><> 餈蹱糓PHP摰䀹䲮<E480B9>刻<EFBFBD>嚗𣬚鍂鈭𡡞俈甇Ｘ錰撠曄征銵峕情<E5B395>栞<EFBFBD><E6A09E>?
- <20><> REDCap摰䀹䲮皞鞟<E79A9E><E99E9F>賡<EFBFBD>敺芣迨閫<E8BFA8><E996AB>
---
@@ -103,7 +103,7 @@ WHERE field_name = 'redcap_base_url';
### 撖<><E69296><EFBFBD>滨蔭撌亙<E6928C>
创建了`scripts/create-redcap-password.php`，用于重置REDCap用户密码：
<EFBFBD>𥕦遣鈭<EFBFBD>scripts/create-redcap-password.php`嚗𣬚鍂鈭𡡞<EFBFBD>蝵娜EDCap<EFBFBD>冽<EFBFBD>撖<EFBFBD><EFBFBD>嚗?
```bash
# 雿輻鍂<E8BCBB>寞<EFBFBD>
@@ -111,54 +111,54 @@ docker cp scripts/create-redcap-password.php redcap-apache:/tmp/
docker exec redcap-apache php /tmp/create-redcap-password.php
```
**注意：** 此脚本仅用于开发环境！生产环境应禁用。
**瘜冽<EFBFBD>嚗?* 甇方<E79487><E696B9>砌<EFBFBD><E7A08C>其<EFBFBD>撘<EFBFBD><E69298>𤑳㴓憓<E3B493><E68693><EFBFBD>煺漣<E785BA>臬<EFBFBD>摨𠉛<E691A8><F0A0899B>具<EFBFBD>?
---
## ✅ 最终确认
## <EFBFBD>?<3F><>蝏<EFBFBD>＆霈?
### REDCap蝟餌<E89D9F><E9A48C>臬<EFBFBD><E887AC>函<EFBFBD>
**重要结论：**
1. ✅ **REDCap官方源码（15.8.0版本，数千个PHP文件）都是规范的**
2. ✅ **官方文件末尾都没有`?>`，不存在CRLF污染问题**
3. ✅ **问题仅存在于我们创建的配置文件`database.php`**
4. ✅ **一旦修复，不会有其他类似问题**
**<EFBFBD>滩<EFBFBD>蝏栞捏嚗?*
1. <EFBFBD>?**REDCap摰䀹䲮皞鞟<EFBFBD>嚗?5.8.0<EFBFBD><EFBFBD>𧋦嚗峕㺭<EFBFBD><EFBFBD>葵PHP<EFBFBD><EFBFBD>辣嚗厰<EFBFBD><EFBFBD>航<EFBFBD><EFBFBD><EFBFBD><EFBFBD>**
2. <EFBFBD>?**摰䀹䲮<E480B9><E4B2AE>辣<EFBFBD>怠偏<E680A0>賣瓷<E8B3A3>头?>`嚗䔶<EFBFBD>摮睃銁CRLF瘙⊥<EFBFBD><EFBFBD>桅<EFBFBD>**
3. <20>?**<2A>桅<EFBFBD>隞<EFBFBD><E99A9E><EFBFBD>其<EFBFBD><E585B6>睲賑<E79DB2>𥕦遣<F0A595A6><E981A3><EFBFBD>蝵格<E89DB5>隞跆database.php`**
4. <20>?**銝<><E98A9D>虫耨憭㵪<E686AD>銝滢<E98A9D><E6BBA2>匧<EFBFBD>隞𣇉掩隡潮䔮憸?*
**验证证据：**
**撉諹<EFBFBD>霂<EFBFBD>旿嚗?*
```bash
# REDCap摰䀹䲮index.php<68>怠偏嚗<E5818F><E59A97><EFBFBD><EFBFBD><EFBFBD>
tail -c 20 /var/www/html/redcap/redcap_v15.8.0/index.php | xxd
00000000: 656e 6572 616c 2f66 6f6f 7465 722e 7068 eneral/footer.ph
00000010: 7027 3b0a p';.
# 末尾只有 '; 和换行符，没有?>
# <EFBFBD>怠偏<EFBFBD>芣<EFBFBD> '; <20>峕揢銵𣬚泵嚗峕瓷<E5B395>?>
# REDCap摰䀹䲮Authentication.php<68>怠偏嚗<E5818F><E59A97><EFBFBD><EFBFBD><EFBFBD>
tail -c 30 /var/www/html/redcap/redcap_v15.8.0/Classes/Authentication.php | xxd
00000000: 6c2c 205b 2475 7365 7269 645d 2929 203e l, [$userid])) >
00000010: 2030 3b0a 0909 7d0a 097d 0a0a 7d0a 0;...}..}..}.
# 末尾只有 } 和换行符，没有?>
# <EFBFBD>怠偏<EFBFBD>芣<EFBFBD> } <20>峕揢銵𣬚泵嚗峕瓷<E5B395>?>
```
---
## <20><> 蝏誯<E89D8F><E8AAAF>餌<EFBFBD>
### 1. Docker跨平台注意事项
### 1. Docker頝典像<EFBFBD>唳釣<EFBFBD>譍<EFBFBD>憿?
**Windows + Docker + Linux摰孵膥蝏<E886A5><E89D8F>隡𡁏𠂔<F0A1818F>脫<EFBFBD>隞嗆聢撘誯䔮憸矋<E686B8>**
- Windows暺䁅恕CRLF (`\r\n`)
- Linux暺䁅恕LF (`\n`)
- Git<69><74>autocrlf`霈曄蔭<E69B84>航<EFBFBD><E888AA>芸𢆡頧祆揢
- 使用`.gitattributes`显式控制换行符
- 雿輻鍂`.gitattributes`<EFBFBD>曉<EFBFBD><EFBFBD>批<EFBFBD><EFBFBD>Ｚ<EFBFBD>蝚?
### 2. PHP配置文件最佳实践
### 2. PHP<EFBFBD>滨蔭<EFBFBD><EFBFBD>辣<EFBFBD><EFBFBD>雿喳<EFBFBD>頝?
```php
<?php
// <20>滨蔭隞<E894AD><E99A9E>...
// ❌ 错误：有结束标签和空行
// <EFBFBD>?<3F>躰秤嚗𡁏<E59A97>蝏𤘪<E89D8F><F0A498AA><EFBFBD>倌<EFBFBD>𣬚征銵?
?>
@@ -168,12 +168,12 @@ tail -c 30 /var/www/html/redcap/redcap_v15.8.0/Classes/Authentication.php | xxd
<?php
// <20>滨蔭隞<E894AD><E99A9E>...
// ✅ 正确：没有结束标签
// <EFBFBD>?甇<>＆嚗𡁏瓷<F0A1818F>厩<EFBFBD><E58EA9><EFBFBD><EFBFBD>蝑?
```
### 3. REDCap部署检查清单
### 3. REDCap<EFBFBD>函蔡璉<EFBFBD><EFBFBD>交<EFBFBD><EFBFBD>?
- [ ] Apache DocumentRoot与Base URL一致
- [ ] Apache DocumentRoot銝𦻓ase URL銝<EFBFBD><EFBFBD>?
- [ ] 蝳<>鍂<EFBFBD>讠憬璅∪<E79285>嚗<EFBFBD><E59A97><EFBFBD>𤑳㴓憓<E3B493><E68693>
- [ ] `database.php`<EFBFBD>怠偏<EFBFBD>鮏?>`
- [ ] <20><>辣<EFBFBD>Ｚ<EFBFBD>蝚衣<E89D9A>銝<EFBFBD>銝摔F
@@ -182,22 +182,22 @@ tail -c 30 /var/www/html/redcap/redcap_v15.8.0/Classes/Authentication.php | xxd
---
## 🚀 后续部署到生产环境
## <EFBFBD><EFBFBD> <20>𡒊賒<F0A1928A>函蔡<E587BD>啁<EFBFBD>鈭抒㴓憓?
**本地Docker开发环境已验证通过，可以安全迁移到阿里云ECS：**
**<EFBFBD>砍𧑐Docker撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD>歇撉諹<EFBFBD><EFBFBD>朞<EFBFBD>嚗<EFBFBD>虾隞亙<EFBFBD><EFBFBD>刻<EFBFBD>蝘餃<EFBFBD><EFBFBD>輸<EFBFBD>鈭䫿CS嚗?*
1. ✅ 使用相同的`Dockerfile.redcap`构建镜像
2. ✅ 修改`database.php`连接到RDS
3. ✅ 生产环境可以启用Gzip压缩（使用Nginx反向代理）
4. ✅ 所有配置文件已经过验证，不会有CRLF问题
1. <20>?雿輻鍂<E8BCBB>詨<EFBFBD><E8A9A8><EFBFBD>Dockerfile.redcap`<60><>遣<EFBFBD>𨅯<EFBFBD>
2. <20>?靽格㺿`database.php`餈墧𦻖<EFBFBD>訌DS
3. <20>?<3F>煺漣<E785BA>臬<EFBFBD><E887AC>臭誑<E887AD>舐鍂Gzip<69>讠憬嚗<E686AC>蝙<EFBFBD>沐ginx<6E>滚<EFBFBD>隞<EFBFBD><E99A9E>嚗?
4. <20>?<3F><><EFBFBD>厰<EFBFBD>蝵格<E89DB5>隞嗅歇蝏讛<E89D8F>撉諹<E69289>嚗䔶<E59A97>隡𡁏<E99AA1>CRLF<4C>桅<EFBFBD>
**未来不需要逐个排查REDCap文件，因为官方代码是规范的！** ✨
**<EFBFBD>芣䔉銝漤<EFBFBD>閬<EFBFBD><EFBFBD>𣂷葵<EFBFBD>埝䰻REDCap<EFBFBD><EFBFBD>辣嚗<EFBFBD><EFBFBD>銝箏<EFBFBD><EFBFBD>嫣誨<EFBFBD><EFBFBD>糓閫<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>** <20>?
---
## <20><> <20>𠉛頂<F0A0899B>孵<EFBFBD>
如有问题，请查看：
憒<EFBFBD><EFBFBD><EFBFBD>桅<EFBFBD>嚗諹窈<EFBFBD>亦<EFBFBD>嚗?
- REDCap摰䀹䲮<E480B9><E4B2AE>﹝嚗冴ttps://projectredcap.org/
- 部署方案文档：`docs/03-REDCap本地Docker开发环境部署方案.md`
- <20>函蔡<E587BD>寞<EFBFBD><E5AF9E><EFBFBD>﹝嚗䫤docs/03-REDCap<EFBFBD>砍𧑐Docker撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD><EFBFBD>蝵脫䲮獢?md`