Files
AIclinicalresearch/docs/03-业务模块/Redcap/01-部署与配置/13-部署问题排查手册.md
HaHafeng 1b53ab9d52 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%)
2026-01-14 19:15:01 +08:00

204 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# REDCap Docker <20>砍𧑐<E7A08D>函蔡<E587BD><EFBFBD><EFBFBD><E996AB>霈啣<E99C88>
**<EFBFBD><EFBFBD>嚗?* 2026-01-02
**<EFBFBD><EFBFBD>𧋦嚗?* REDCap 15.8.0
**<EFBFBD><EFBFBD>嚗?* Windows 10 + Docker Desktop + Docker Compose
---
## <20><> <20>函蔡<E587BD>𣂼<EFBFBD>蝖株恕
<EFBFBD>?**REDCap 15.8.0 撌脫<E6928C><E884AB><EFBFBD>蝵脣銁<E884A3>砍𧑐Docker<65><EFBFBD>**
- **霈輸䔮<E8BCB8><EFBFBD>嚗?* http://localhost:8080/
- **蝞∠<E89D9E><E288A0>䁅揭<E48185><EFBFBD>** Admin / Admin123!
- **<2A>唳旿摨橒<E691A8>** MySQL 8.0嚗㇄ocker摰孵膥嚗?
- **PHPMyAdmin嚗?* http://localhost:8081/
---
## <20><> <20><><EFBFBD><EFBFBD><EFBFBD>䔮憸睃<E686B8><EFBFBD><E996AB><EFBFBD><EFBFBD>
### <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皞鞟<E79A9E>銝剖𢆡<E58996><F0A286A1><EFBFBD><EFBFBD><E585B6>讠憬嚗ǑSystem.php`<60><>general_settings.php`銝剔<EFBFBD>`ini_set`嚗?
3. 撖潸稲<E6BDB8>唳旿鋡怠<E98BA1><E79488>蝻抬<E89DBB>瘚讛<E7989A><E8AE9B><EFBFBD>瘜閗圾<E99697>?
**閫<><E996AB><EFBFBD><EFBFBD>嚗?*
1. <20>?<3F>灼docker-entrypoint.sh`銝剖撩<E58996><EFBFBD><E597A5>杗pache<68><65>eflate璅<E79285>嚗䫤a2dismod -f deflate`
2. <20>?<3F>灼php.ini`銝剜遬撘誩<E69298><E8AAA9><EFBFBD>蝻抬<E89DBB>
```ini
zlib.output_compression = Off
output_buffering = Off
```
3. <20>?<3F>灼docker-entrypoint.sh`銝剛䌊<EFBFBD>冽釣<EFBFBD>䟕EDCap皞鞟<EFBFBD>銝剔<EFBFBD>`ini_set('zlib.output_compression', ...)`
**憸<><EFBFBD>芣鴌嚗?*
- 撌脣銁`redcap.conf`銝剜釣<EFBFBD>𦠜<EFBFBD>`mod_deflate`<EFBFBD>滨蔭
-<><E69298>𤑳㴓憓<E3B493><E68693><EFBFBD><EFBFBD><EFBFBD>zip<69>讠憬嚗<E686AC><EFBFBD><EFBFBD><EFBFBD><E99D9A><EFBFBD><EFBFBD><EFBFBD>
---
### <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`
**閫<><E996AB><EFBFBD><EFBFBD>嚗?*
```sql
UPDATE redcap_config
SET value = 'http://localhost:8080'
WHERE field_name = 'redcap_base_url';
```
**憸<><EFBFBD>芣鴌嚗?*
- <20><EFBFBD><EFBFBD><E98B86>撖潭<E69296>SQL撖澆<E69296><E6BE86>靽𨈚ase URL銝𥟠ocumentRoot銝<74><E98A9D>?
---
### <20><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>唳旿"
**<EFBFBD>寞𧋦<EFBFBD><EFBFBD>嚗?*
- **`database.php`<EFBFBD><EFBFBD><EFBFBD>怠偏<EFBFBD>头?>`PHP蝏𤘪<E89D8F><F0A498AA><EFBFBD><EFBFBD>𣬚征銵?*
- Windows蝟餌<E89D9F><E9A48C><EFBFBD>RLF<4C><EFBFBD>蝚西◤颲枏枂<E69E8F>蚜TTP<54><EFBFBD>
- 撖潸稲<E6BDB8><EFBFBD>雿𤘪情<F0A498AA><EFBFBD>瘚讛<E7989A><E8AE9B><EFBFBD>瘜閗圾<E99697>?
**霂衣<E99C82><E8A1A3><EFBFBD><EFBFBD>嚗?*
```bash
# database.php<68>怠偏<E680A0><E5818F><EFBFBD><EFBFBD><EFBFBD><E5899B><EFBFBD>摰?
00000050: e585 a80d 0a20 2a2f 0d0a 0d0a 3f3e 0d0a ..... */....?>..
00000060: 0d0a 0d0a ....
# `*/` CRLF CRLF `?>` CRLF CRLF CRLF
```
**閫<><E996AB><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>`?>`**
- <20><> 餈蹱糓PHP摰䀹䲮<E480B9><EFBFBD>嚗𣬚鍂鈭𡡞俈甇錰撠曄征銵峕情<E5B395><EFBFBD><E6A09E>?
- <20><> REDCap摰䀹䲮皞鞟<E79A9E><E99E9F><EFBFBD>敺芣迨閫<E8BFA8><E996AB>
---
## <20><> 摰匧<E691B0><E58CA7>芣鴌
### 撖<><E69296><EFBFBD>滨蔭撌亙<E6928C>
<EFBFBD>𥕦遣鈭<EFBFBD>scripts/create-redcap-password.php`嚗𣬚鍂鈭𡡞<E988AD>蝵娜EDCap<61><EFBFBD><EFBFBD><E69296>嚗?
```bash
# 雿輻鍂<E8BCBB><EFBFBD>
docker cp scripts/create-redcap-password.php redcap-apache:/tmp/
docker exec redcap-apache php /tmp/create-redcap-password.php
```
**瘜冽<E7989C>嚗?* 甇方<E79487><E696B9><EFBFBD><E7A08C><EFBFBD><EFBFBD><E69298>𤑳㴓憓<E3B493><E68693><EFBFBD>煺漣<E785BA><EFBFBD>摨𠉛<E691A8><F0A0899B><EFBFBD>?
---
## <20>?<3F><><EFBFBD>霈?
### REDCap蝟餌<E89D9F><E9A48C><EFBFBD><E887AC><EFBFBD>
**<2A><EFBFBD>蝏栞捏嚗?*
1. <20>?**REDCap摰䀹䲮皞鞟<E79A9E>嚗?5.8.0<EFBFBD><EFBFBD>𧋦嚗峕㺭<EFBFBD><EFBFBD>葵PHP<EFBFBD><EFBFBD>辣嚗厰<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>**
2. <20>?**摰䀹䲮<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>隞𣇉掩隡潮䔮憸?*
**撉諹<E69289><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';.
# <20>怠偏<E680A0><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;...}..}..}.
# <20>怠偏<E680A0><EFBFBD> } <20>峕揢銵𣬚泵嚗峕瓷<E5B395>?>
```
---
## <20><> 蝏誯<E89D8F><E8AAAF><EFBFBD>
### 1. Docker頝典像<E585B8>唳釣<E594B3><EFBFBD>憿?
**Windows + Docker + Linux摰孵膥蝏<E886A5><E89D8F>隡𡁏𠂔<F0A1818F><EFBFBD>隞嗆聢撘誯䔮憸矋<E686B8>**
- Windows暺䁅恕CRLF (`\r\n`)
- Linux暺䁅恕LF (`\n`)
- Git<69><74>autocrlf`霈曄蔭<E69B84><EFBFBD><E888AA>芸𢆡頧祆揢
- 雿輻鍂`.gitattributes`<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝚?
### 2. PHP<48>滨蔭<E6BBA8><E894AD><EFBFBD><E8BEA3>雿喳<E99BBF>頝?
```php
<?php
// <20>滨蔭隞<E894AD><E99A9E>...
// <20>?<3F>躰秤嚗𡁏<E59A97>蝏𤘪<E89D8F><F0A498AA><EFBFBD><EFBFBD>𣬚征銵?
?>
```
```php
<?php
// <20>滨蔭隞<E894AD><E99A9E>...
// <20>?甇<>嚗𡁏瓷<F0A1818F><EFBFBD><E58EA9><EFBFBD><EFBFBD>蝑?
```
### 3. REDCap<61>函蔡璉<E894A1><E79289><EFBFBD><E4BAA4>?
- [ ] Apache DocumentRoot銝𦻓ase URL銝<4C><E98A9D>?
- [ ]<><EFBFBD>讠憬璅<E79285><EFBFBD><E59A97><EFBFBD>𤑳㴓憓<E3B493><E68693>
- [ ] `database.php`<EFBFBD>怠偏<EFBFBD>鮏?>`
- [ ] <20><><EFBFBD><EFBFBD>蝚衣<E89D9A><EFBFBD>銝摔F
- [ ]<><E69296><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBC86><EFBFBD>
- [ ] Session<6F><EFBFBD><E6A180><EFBFBD><EFBFBD><EFBFBD>
---
## <20><> <20>𡒊賒<F0A1928A>函蔡<E587BD><EFBFBD>鈭抒㴓憓?
**<EFBFBD>砍𧑐Docker撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD>歇撉諹<EFBFBD><EFBFBD><EFBFBD><EFBFBD>虾隞亙<EFBFBD><EFBFBD><EFBFBD>蝘餃<EFBFBD><EFBFBD><EFBFBD>鈭䫿CS嚗?*
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>
**<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/
- <20>函蔡<E587BD><EFBFBD><E5AF9E><EFBFBD>﹝嚗䫤docs/03-REDCap<61>砍𧑐Docker撘<72><E69298>𤑳㴓憓<E3B493><E68693>蝵脫䲮獢?md`