Files
AIclinicalresearch/docs/03-业务模块/IIT Manager Agent/04-开发计划/企业微信注册指南.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

231 lines
5.1 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.
# 隡<><E99AA1>敺桐縑瘜典<E7989C>銝𡡞<E98A9D>蝵格<E89DB5><E6A0BC>?
> **<2A><EFBFBD>**嚗朞繮<E69C9E><EFBFBD>銝𡁜凝靽PI<50><EFBFBD>嚗𣬚鍂鈭穉IT Manager Agent<6E><EFBFBD><E785BE><EFBFBD><EFBFBD>霅血㨃<E8A180>?
> **憸<><EFBFBD>園𡢿**嚗?0<><30><EFBFBD>
---
## <20><> 甇仿炊1嚗𡁏釣<F0A1818F><EFBFBD>銝𡁜凝靽∟揭<E2889F>?
### 1.1 霈輸䔮隡<E494AE><E99AA1>敺桐縑摰条<E691B0>
霈輸䔮嚗冴ttps://work.weixin.qq.com/
### 1.2 瘜典<E7989C><EFBFBD><E99AA1>
1. <20>孵稬"**蝡见朖瘜典<E7989C>**"
2. <20>㗇𥋘"**隡<><E99AA1>**"蝐餃<E89D90>
3. 憛怠<E6869B><EFBFBD><E99AA1>靽⊥<E99DBD>嚗?
-<><E99AA1><EFBFBD>滨妍嚗䫤瘚贝<E7989A><E8B49D>駁堺`嚗<><E59A97><EFBFBD><EFBFBD>摰鮋<E691B0><E9AE8B><EFBFBD><E7AEB8>滨妍嚗?
- 銵䔶<E98AB5>蝐餃<E89D90>嚗䫤<E59A97><EFBFBD><E9A48C>亙熒`
-<><E99AA1>鈭箸㺭嚗䫤100鈭箔誑銝㞗
- 蝞∠<E89D9E><E288A0><EFBFBD><E79D83><EFBFBD><E3B5AA><EFBFBD>憪枏<E686AA>
- 蝞∠<E89D9E><E288A0><EFBFBD><E480B9><EFBFBD><E7B6BD><EFBFBD><E587BD>𧢲㦤<F0A7A2B2><EFBFBD><E79880>交𤣰撉諹<E69289><E8ABB9><EFBFBD><EFBFBD>
4. 摰峕<E691B0>撉諹<E69289>嚗峕釣<E5B395><EFBFBD><E5B395>?
---
## <20><> 甇仿炊2嚗𡁜<E59A97>撱箄䌊撱箏<E692B1><E7AE8F>?
### 2.1 <20><EFBFBD>蝞∠<E89D9E><E288A0>𤾸蝱
1. 霈輸䔮嚗冴ttps://work.weixin.qq.com/wework_admin/loginpage_wx
2. 雿輻鍂隡<E98D82><E99AA1>敺桐縑APP<50><EFBFBD><E6808E><EFBFBD><EFBFBD><E59A97><EFBFBD><EFBFBD><EFBFBD>𧢲㦤銝𠹺<E98A9D>頧賭<E9A0A7>銝𡁜凝靽PP嚗?
### 2.2 <20>𥕦遣摨𠉛鍂
1. 餈𥕦<E9A488>**<2A>𣂼<EFBFBD><F0A382BC>函恣<E587BD><E681A3><EFBFBD>?* <20>?**<2A>鞱䌊撱箝<E692B1>?* <20>?**<2A>𣂼<EFBFBD>撱箏<E692B1><E7AE8F><EFBFBD>?*
2. 憛怠<E6869B>摨𠉛鍂靽⊥<E99DBD>嚗?
- **摨𠉛鍂<F0A0899B>滨妍**嚗䫤IIT Manager Agent嚗<74><E59A97>霂𤏪<E99C82>`
- **摨𠉛鍂Logo**嚗帋<E59A97>隡牐<E99AA1>銝芸㦛<E88AB8><E3A69B><EFBFBD><EFBFBD><EFBFBD><E88880>嗡蝙<E597A1><EFBFBD>霈歹<E99C88>
- **摨𠉛鍂隞讠<E99A9E>**嚗䫤IIT<49>𠉛弦<F0A0899B><EFBFBD>韐冽綉<E586BD><EFBFBD> - <20>唳旿韐券<E99F90>摰墧𧒄<E5A2A7>烐綉`
- **<2A><EFBFBD><E888AA><EFBFBD>凒**嚗𡁻<E59A97>㗇𥋘"**<2A><><EFBFBD>劐犖**"嚗<><E59A97>霂閖𧫴畾蛛<E795BE>
3. <20>孵稬"**<2A>𥕦遣摨𠉛鍂**"
### 2.3 <20><EFBFBD>API<50><EFBFBD><EFBFBD><E59A97><EFBFBD><E996AC>嚗?
<EFBFBD>𥕦遣<EFBFBD>𣂼<EFBFBD><EFBFBD>𠬍<EFBFBD><EFBFBD><EFBFBD><EFBFBD>刻祕<EFBFBD><EFBFBD><EFBFBD>臭誑<EFBFBD><EFBFBD>嚗?
```
<EFBFBD><EFBFBD>ID嚗㇃orpID嚗㚁<EFBFBD> ww1234567890abcdef
AgentID嚗? 1000002
Secret嚗? <20>孵稬"<22><EFBFBD>"<22>厰僼<E58EB0><EFBFBD>
```
**<EFBFBD>𩤃<EFBFBD> <20><EFBFBD><E6BBA9>鞟內**嚗?
- **Secret** <20>芣遬蝷箔<E89DB7>甈∴<E79488>霂瑞<E99C82><E7919E><EFBFBD><E596B3><EFBFBD>摮矋<E691AE>
-<><E68692>敹䁅扇Secret嚗屸<E59A97><EFBFBD><E996AC>蝵殷<E89DB5>隡𡁜紡<F0A1819C>湔唂Secret憭望<E686AD>嚗?
---
## <20><> 甇仿炊3嚗𡁻<E59A97>蝵唧PI<50><49><EFBFBD>
### 3.1 霈曄蔭蝵煾△<E785BE><E296B3><EFBFBD><EFBFBD>蹆S-SDK
1. <20><EFBFBD><E585B8>刻祕<E588BB><E7A595>△嚗峕𪄳<E5B395>?**蝵煾△<E785BE><E296B3><EFBFBD><EFBFBD>蹆S-SDK**"
2. 霈曄蔭**<2A>臭縑<E887AD><EFBFBD>**嚗?
-<><E69298>𤑳㴓憓<E3B493><E68693>`localhost`<EFBFBD><EFBFBD><EFBFBD>𨀣𣈲<EFBFBD><EFBFBD><EFBFBD>
- <20>煺漣<E785BA><EFBFBD>嚗𡁏<E59A97><F0A1818F><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>憒?`iit.example.com`嚗?
### 3.2 霈曄蔭<E69B84>交𤣰瘨<F0A4A3B0><E798A8>
1. <20><EFBFBD>"**<2A>交𤣰瘨<F0A4A3B0><E798A8>**"<22>滨蔭
2. <20><>𧒄銝滨鍂<E6BBA8>滨蔭嚗㇈VP<56>嗆挾<E59786><EFBFBD><EFBFBD><EFBFBD><E7B6AB><EFBFBD><EFBFBD><EFBFBD>銝漤<E98A9D><EFBFBD>𦻖<EFBFBD><EFBFBD>
### 3.3 霈曄蔭<E69B84><E894AD><EFBFBD><EFBFBD><EFBFBD>
蝖桐<EFBFBD>摨𠉛鍂<EFBFBD>劐誑銝𧢲<EFBFBD><EFBFBD><EFBFBD>
- <20>?**<2A><EFBFBD><E785BE><EFBFBD><EFBFBD><EFBFBD>敺桐縑** - <20><EFBFBD><E8A9A8><EFBFBD>
- <20>?**<2A>𣂼<EFBFBD>靽⊥<E99DBD>霂餃<E99C82>** - <20><EFBFBD><E585B6><EFBFBD><E79195><EFBFBD>OpenID
- <20>?**<2A>朞悖敶閧恣<E996A7>?* - <20><EFBFBD><E585B6><EFBFBD><E586BD><EFBFBD>
---
## <20><> 甇仿炊4嚗𡁻<E59A97>蝵桀<E89DB5>憿寧𤌍銝?
### 4.1 憭滚<E686AD><E6BB9A><EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鐯霂<EFBFBD>扇敶蓥<EFBFBD><EFBFBD><EFBFBD>
```
CorpID: ww1234567890abcdef
AgentID: 1000002
Secret: abc123xyz789_your_secret_here
```
### 4.2 瘛餃<E7989B><E9A483>?.env <20><>
蝻𤥁<EFBFBD> `AIclinicalresearch/backend/.env`嚗峕溶<EFBFBD>𩤃<EFBFBD>
```bash
# ==================== 隡<><E99AA1>敺桐縑<E6A190>滨蔭 ====================
WECHAT_CORP_ID=ww1234567890abcdef
WECHAT_CORP_SECRET=abc123xyz789_your_secret_here
WECHAT_AGENT_ID=1000002
```
**<EFBFBD>𩤃<EFBFBD> 瘜冽<E7989C>**嚗?
- 銝滩<E98A9D><E6BBA9>𣂷漱 `.env` <20><><EFBFBD>蚣it嚗<74><EFBFBD>?`.gitignore` 銝哨<E98A9D>
- <20>煺漣<E785BA><EFBFBD>雿輻鍂<E8BCBB><EFBFBD><E7A589><EFBFBD><EFBFBD>銝𡁜凝靽<E99DBD><E288AA>?
---
## <20><> 甇仿炊5嚗𡁏<E59A97>霂蓥<E99C82>敺唧PI
### 5.1 <20>滚鍳<E6BB9A>𡒊垢<F0A1928A>滚𦛚
靽嘥<EFBFBD> `.env` <20>𠬍<EFBFBD><F0A0AC8D>滚鍳<E6BB9A>𡒊垢嚗?
```bash
# <20>𨀣迫敶枏<E695B6><E69E8F>滚𦛚嚗㇃trl+C嚗?
# <20>齿鰵<E9BDBF>臬𢆡
cd D:\MyCursor\AIclinicalresearch\backend
npm run dev
```
### 5.2 <20>见𢆡瘚贝<E7989A><EFBFBD><EFBFBD>沌ostman<61>鈪url嚗?
**瘚贝<E7989A>蝡舐<E89DA1>**嚗<><E59A97>蝏胖ay 5隡𡁜<E99AA1>撱綽<E692B1>嚗?
```bash
POST http://localhost:3001/api/v1/iit/test/wechat-push
Content-Type: application/json
{
"toUser": "YourUserID",
"title": "瘚贝<E7989A><E8B49D>𡁶䰻",
"description": "餈蹱糓銝<E7B393><E98A9D>⊥䔉<E28AA5>杷IT Manager<65><72><EFBFBD>霂閙<E99C82><E99699>?,
"url": "http://localhost:5173"
}
```
**憸<><E686B8>蝏𤘪<E89D8F>**嚗?
- <20>?餈𥪜<E9A488>200<30><EFBFBD><E59786><EFBFBD>
- <20>?隡<><E99AA1>敺桐縑APP<50><EFBFBD><E59785><EFBFBD><EFBFBD><E798A8>
---
## <20><> 撣貉<E692A3><E8B289><EFBFBD>嚗㇅AQ嚗?
### Q1嚗𡁏<E59A97>瘝⊥<E7989D><EFBFBD><E99AA1><EFBFBD>虾隞交釣<E4BAA4><E987A3><EFBFBD>嚗?
**A**嚗𡁜虾隞伐<E99A9E><E4BC90>㗇𥋘"**銝芯犖**"<22>?**銝芯<E98A9D>撌亙<E6928C><E4BA99>?*"蝐餃<E89D90>瘜典<E7989C><EFBFBD><E59A97><EFBFBD><EFBFBD><E8B3A2>函㮾<E587BD><EFBFBD>?
### Q2嚗锭ecret敹䁅扇鈭<E68987><E988AD>𦒘<EFBFBD><F0A69298><EFBFBD>
**A**嚗𡁜銁摨𠉛鍂霂行<E99C82>憿萇<E686BF><E89087>?**<EFBFBD>滨蔭Secret**"嚗䔶<E59A97>隡𡁜紡<F0A1819C>湔唂Secret憭望<E686AD><E69C9B>?
### Q3嚗𡁏<E59A97>霂閧㴓憓<E3B493><E68693><EFBFBD><E996AC><EFBFBD>滩恕霂<E68195><E99C82>嚗?
**A**嚗帋<E59A97><E5B88B><EFBFBD><EFBFBD><E996AC><EFBFBD>𧊋霈方<E99C88><EFBFBD><E99AA1>銋笔虾隞乩蝙<E4B9A9>刻䌊撱箏<E692B1><E7AE8F><EFBFBD><E587BD><EFBFBD><E588B8><EFBFBD><EFBFBD><EFBFBD>臭犖<E887AD><EFBFBD><E594B3>𣂼<EFBFBD>嚗?00鈭綽<E988AD><E7B6BD>?
### Q4嚗𡁜<E59A97>雿閙𪄳<E99699>啁鍂<E59581><EFBFBD> UserID嚗?
**A**嚗?
1. <20><EFBFBD>1嚗𡁶蒈敶閧恣<E996A7><E681A3><EFBFBD><EFBFBD>?<3F>?<3F>朞悖敶?<3F>?<3F>孵稬<E5ADB5>𣂼<EFBFBD> <20>?<3F><EFBFBD>"韐血噡"
2. <20><EFBFBD>2嚗朞<E59A97><E69C9E><EFBFBD>銝𡁜凝靽PI<50><EFBFBD>嚗䫤GET /cgi-bin/user/getuserinfo`
### Q5嚗𡁏<E59A97><F0A1818F><EFBFBD><E887AC><EFBFBD>仃韐伐<E99F90>餈𥪜<E9A488>40014<31>躰秤嚗?
**A**嚗䫤invalid access_token`嚗<><EFBFBD><EFBFBD><E8B3A2>𩤃<EFBFBD>
- Secret<65>滨蔭<E6BBA8>躰秤
- Access Token餈<6E><E9A488><EFBFBD><E59A97><EFBFBD>齿鰵<E9BDBF><EFBFBD>嚗?
- CorpID<49>䨝gentID<49>滨蔭<E6BBA8>躰秤
---
## <20>?撉峕𤣰<E5B395><F0A4A3B0><EFBFBD>
摰峕<EFBFBD>隞乩<EFBFBD>隞餃𦛚<EFBFBD>𠬍<EFBFBD>Day 1撠勗<E692A0>蝢擧𤣰摰䀝<E691B0>嚗?
- [ ] 隡<><E99AA1>敺桐縑韐血噡瘜典<E7989C><E585B8>𣂼<EFBFBD>
- [ ] <20>芸遣摨𠉛鍂<F0A0899B>𥕦遣<F0A595A6>𣂼<EFBFBD>
- [ ] <20><EFBFBD><E79195>蚓orpID<49><44>gentID<49><44>ecret
- [ ] <20>滨蔭<E6BBA8>?`.env` <20><>
- [ ] <20>𡒊垢<F0A1928A>滚𦛚<E6BB9A>賣迤撣詨鍳<E8A9A8><EFBFBD><E58981>䭾𥁒<E4ADBE><EFBFBD>
---
## <20>㴓 銝衤<E98A9D>甇?
摰峕<EFBFBD><EFBFBD><EFBFBD>敺桐縑<EFBFBD>滨蔭<EFBFBD>𠬍<EFBFBD>Day 2<>睲賑撠<E8B391><E692A0>憪页<E686AA>
1. **REDCap API Adapter撘<72><E69298>?*嚗<>瓲敹<E793B2><E695B9><EFBFBD><EFBFBD>
2. **SyncManager撘<72><E69298>?*嚗<><EFBFBD><E6AFBD><EFBFBD>甇交芋撘𧶏<E69298>
3. 摰䂿緵REDCap<61>唳旿<E594B3><EFBFBD><E58CA7>諹蔭霂?
<EFBFBD>恣摰峕<EFBFBD><EFBFBD>園𡢿嚗?撠𤩺𧒄
---
**<EFBFBD>𥕦遣<EFBFBD><EFBFBD>**嚗?025-12-31
**蝏湔擪<E6B994>?*嚗𡁜<E59A97><F0A1819C>穃𣪧<E7A983>?
**<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>獢?*嚗?
-<><E99AA1>敺桐縑摰䀹䲮<E480B9><E4B2AE>﹝嚗冴ttps://developer.work.weixin.qq.com/document/
- <20><EFBFBD><E785BE><EFBFBD><EFBFBD><EFBFBD><E586BD><EFBFBD>https://developer.work.weixin.qq.com/document/path/90236