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%)
46 KiB
IIT Manager Agent - 譛蟆舟VP髣ｭ邇ｯ蠑蜿題ｮ｡蛻?
迚域悽: v1.0
蛻帛ｻｺ譌･譛<EFBFBD>: 2026-01-02
逶ｮ譬<EFBFBD>: 謇馴?REDCap 竊?Node.js 竊?莨∽ｸ壼ｾｮ菫｡ 逧<>ｮ梧紛髣ｭ邇? **鬚<>ｼｰ蟾･菴憺<E88FB4>?*: 2螟ｩ<E89E9F><EFBDA9>ay 3-4<>? 譬ｸ蠢<EFBFBD>炊蠢ｵ: 蜈域遠騾壽怙蟆城溜邇ｯ<E98287>碁ｪ瑚ｯ∵橿譛ｯ蜿ｯ陦梧ｧ<C280>悟<EFBFBD>騾先ｭ･荳ｰ蟇悟粥閭ｽ
<EFBFBD>識 荳縲｀VP螳壻ｹ我ｸ守岼譬?
1.1 莉荵域弍譛蟆城溜邇ｯ<E98287><EFBDAF>
譬ｸ蠢<EFBFBD>溜邇ｯ<EFBFBD>?``` REDCap蠖募<E8A096>謨ｰ謐ｮ 竊?Node.js螳樊慮謐戊執 竊?莨∽ｸ壼ｾｮ菫｡譎ｺ閭ｽ騾夂衍 竊?PI蟇ｹ隸晄衍隸｢
**鬪瑚ｯ∽ｻｷ蛟?*<2A>?1. 笨?**螳樊慮諢溽衍**<2A>啀I譌<49>髴逋ｻ蠖紐EDCap<61>碁囂譌ｶ謗梧升鬘ｹ逶ｮ霑帛ｱ?2. 笨?**荳ｻ蜉ｨ騾夂衍**<2A>壽焚謐ｮ蠖募<E8A096>蜷守ｫ句叉謗ｨ騾<EFBDA8>ｼ御ｸ堺ｼ夐＠貍<EFBCA0>
3. 笨?**譎ｺ閭ｽ莠､莠<EFBDA4>**<2A>壼惠莨∽ｸ壼ｾｮ菫｡荳ｭ蜊ｳ蜿ｯ譟･隸｢謨ｰ謐ｮ縲∬執蜿匁冠蜻?4. 笨?**譏捺黄螻?*<2A>夐溜邇ｯ謇馴壼錘<E5A3BC>悟庄莉･蠢ｫ騾滓ｷｻ蜉<EFBDBB>雍ｨ謗ｧ縲∵署驢偵∫ｻ溯ｮ｡遲牙粥閭ｽ
### 1.2 證ゆｸ榊ｮ樒鴫逧<E9B4AB>粥閭ｽ<E996AD>亥錘扈ｭ謇ｩ螻包ｼ?
- 竢ｸ<E7ABA2><EFBDB8> **謨ｰ謐ｮ雍ｨ謗ｧ隗<EFBDA7><E99A97>逕滓<E98095>**<2A><>hase 1.5<EFBFBD>会ｼ壻ｸ贋ｼ<EFBFBD>遐皮ｩｶ譁ｹ譯<EFBFBD> 竊?AI逕滓<E98095>隗<EFBFBD><E99A97>蠎?竊?蝓ｺ莠手ｧ<E6898B><EFBDA7>雍ｨ謗ｧ
- 竢ｸ<E7ABA2><EFBDB8> **PC Workbench蜑咲ｫｯ**<2A><>hase 2<>会ｼ壼､肴<EFBDA4>ｸAI蟒ｺ隶ｮ逧Цeb逡碁擇
- 竢ｸ<E7ABA2><EFBDB8> **REDCap謨ｰ謐ｮ蝗槫<E89D97>**<2A><>hase 2<>会ｼ哂I蟒ｺ隶ｮ螳｡謇ｹ蜷主屓蜀吝芦REDCap
- 竢ｸ<E7ABA2><EFBDB8> **蠕ｮ菫｡蟆冗ｨ句ｺ?*<2A><>hase 3<>会ｼ夂ｧｻ蜉ｨ遶ｯ蜴溽函菴馴ｪ?- 竢ｸ<E7ABA2><EFBDB8> **螟肴揩蟇ｹ隸晁<E99AB8>蜉<EFBFBD>**<2A><>hase 3<>会ｼ壼､夊ｽｮ蟇ｹ隸昴∽ｸ贋ｸ区枚逅<E69E9A>ｧ｣
---
## <20>投 莠後∝ｽ灘燕迥ｶ諤∵ｻ扈<EFBDBB>
### 2.1 蟾ｲ螳梧<E89EB3>逧<EFBFBD>㊥螟<E38AA5>ｷ･菴懶ｼ<E687B6>ay 1-2<>?
#### 笨?Day 1<>夂識蠅<E8AD98><E8A085>蟋句喧<E58FA5>?026-01-01<30>?
**謨ｰ謐ｮ蠎?*<2A>?- 笨?蛻帛ｻｺ `iit_schema`<60>?荳ｪ陦ｨ<E999A6>?- 笨?Prisma Schema螳梧紛<E6A2A7><E7B49B>itProject, IitPendingAction, IitTaskRun, IitUserMapping, IitAuditLog<6F>?- 笨?CRUD豬玖ｯ暮夊ｿ<E5A48A>ｼ?1/11<31>?
**莨∽ｸ壼ｾｮ菫｡**<2A>?- 笨?莨∽ｸ壼ｾｮ菫｡蠑蜿題<E9A18C>ｴｦ蜿ｷ豕ｨ蜀?- 笨?閾ｪ蟒ｺ蠎皮畑蛻帛ｻｺ<EFBDBB><EFBDBA>IT Manager Agent<6E>?- 笨?蜃ｭ隸∬執蜿厄ｼ? - **CorpID**: `ww01cb7b72ea2db83c`
- **AgentID**: `1000002`
- **Secret**: `F3XqlAqKdcOKHi9pLGv5a2dSUowWbevdcDRrBk2pXLM`
- 笨?**鄂鷹｡ｵ謗域揀蜿開S-SDK謗域揀蟾ｲ闔ｷ蜿?*
- 笨?**蜿ｯ菫｡蝓溷錐驟咲ｽｮ謌仙粥**<2A>啻iit.xunzhengyixue.com`
- 笨?**蝓溷錐鬪瑚ｯ∵枚莉ｶ驛ｨ鄂ｲ**<2A>啻WW_verify_YnhsQBwI0ARnNoG0.txt`
- 笨?**Access Token闔ｷ蜿匁ｵ玖ｯ暮夊ｿ<E5A48A>**
**讓｡蝮鈴ｪｨ譫ｶ**<2A>?- 笨?逶ｮ蠖慕ｻ捺桷蛻帛ｻｺ
- 笨?邀ｻ蝙句ｮ壻ｹ牙ｮ梧紛<E6A2A7>?23陦鯉ｼ<E9AF89>
- 笨?霍ｯ逕ｱ蜑咲ｼ驟咲ｽｮ<EFBDBD><EFBDAE>/api/v1/iit`<60>?
---
#### 笨?Day 2<>啌EDCap螳樊慮髮<E685AE><E9ABAE><EFBFBD>?026-01-02<30>?
**譬ｸ蠢<EFBDB8>ｺ､莉倡<E88E89>?*<2A><>2,200陦御ｻ｣遐<EFBDA3>ｼ会ｼ?1. 笨?**RedcapAdapter.ts**<2A>?71陦鯉ｼ<E9AF89>
- `exportRecords()` - 蟇ｼ蜃ｺ隶ｰ蠖包ｼ域髪謖∝<E8AC96>驥?蠅樣㍼/謖<>ｮ夊ｮｰ蠖包ｼ? - `exportMetadata()` - 蟇ｼ蜃ｺ蟄玲ｮｵ螳壻ｹ<E5A3BB>
- `importRecords()` - 蟇ｼ蜈･隶ｰ蠖包ｼ磯｢<E7A3AF>蕗<EFBFBD><E89597>
- `testConnection()` - 霑樊磁豬玖ｯ<E78E96>
2. 笨?**WebhookController.ts**<2A>?27陦鯉ｼ<E9AF89>
- `handleWebhook()` - 謗･謾ｶREDCap DET隗ｦ蜿托ｼ?10ms蜩榊ｺ費ｼ? - 蟷らｭ画ｧ譽譟･<E8AD9F>磯亟豁｢驥榊､榊､<E6A68A>炊<EFBFBD>? - 螳｡隶｡譌･蠢苓ｮｰ蠖<EFBDB0>
- 謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6><E6BAB7><EFBFBD>iit_quality_check`<60>?
3. 笨?**SyncManager.ts**<2A>?98陦鯉ｼ<E9AF89>
- `initScheduledJob()` - 蛻晏ｧ句喧螳壽慮莉ｻ蜉｡<E89C89>域ｯ?蛻<>帖<EFBFBD>? - `handlePoll()` - 霓ｮ隸｢謇譛餌ctive鬘ｹ逶ｮ
- `manualSync()` - 謇句勘蜷梧ｭ･
- `fullSync()` - 蜈ｨ驥丞酔豁･
4. 笨?**Worker豕ｨ蜀<EFBDA8>**<2A>?1陦鯉ｼ<E9AF89>
- `iit_quality_check` - 雍ｨ謗ｧ莉ｻ蜉｡<E89C89>亥ｷｲ豕ｨ蜀鯉ｼ悟ｾ<E6829F>｡･蜈<EFBDA5>ｻ霎托ｼ? - `iit_redcap_poll` - 螳壽慮霓ｮ隸｢莉ｻ蜉｡
5. 笨?**霍ｯ逕ｱ驟咲ｽｮ**<2A>?03陦鯉ｼ<E9AF89>
- `/api/v1/iit/health` - 蛛･蠎ｷ譽譟? - `/api/v1/iit/webhooks/redcap` - DET蝗櫁ｰ<E6AB81>磁謾ｶ<E8ACBE>域髪謖’orm-urlencoded<65>? - `/api/v1/iit/webhooks/health` - Webhook蛛･蠎ｷ譽譟? - `/api/v1/iit/projects/:id/sync` - 謇句勘蜷梧ｭ･
- `/api/v1/iit/projects/:id/full-sync` - 蜈ｨ驥丞酔豁･
**豬玖ｯ戊<EFBDAF>譛ｬ**<2A>?12陦鯉ｼ会ｼ?- 笨?`test-redcap-api.ts`<60>?89陦鯉ｼ<E9AF89>- API騾る<E9A8BE>蝎ｨ豬玖ｯ?- 笨?`test-redcap-webhook.ts`<60>?74陦鯉ｼ<E9AF89>- Webhook謗･謾ｶ蝎ｨ豬玖ｯ?- 笨?`test-redcap-integration.ts`<60>?49陦鯉ｼ<E9AF89>- 遶ｯ蛻ｰ遶ｯ髮<EFBDAF><E9ABAE>豬玖ｯ?
**豬玖ｯ慕ｻ捺棡**<2A>?- 笨?**髮<><E9ABAE>豬玖ｯ暮夊ｿ<E5A48A><EFBDBF>?*<2A>?2/12<31>?00%<25>?- 笨?**Webhook蜩榊ｺ疲慮髣ｴ**<2A>?10ms<6D>育岼譬?100ms<6D>?- 笨?**DET隗ｦ蜿大ｻｶ霑<EFBDB6>**<2A>?遘抵ｼ亥ｮ樊慮<E6A88A>?- 笨?**謨ｰ謐ｮ蜷梧ｭ･蜃<EFBDA5>｡ｮ諤?*<2A>?00%
**REDCap邇ｯ蠅<EFBDAF>**<2A>?- 笨?REDCap 15.8.0譛ｬ蝨ｰDocker驛ｨ鄂ｲ
- 笨?豬玖ｯ暮｡ｹ逶ｮ蛻帛ｻｺ<EFBDBB><EFBDBA>est0102, PID 16<31>?- 笨?6譚｡豬玖ｯ墓焚謐ｮ蠖募<E8A096>?- 笨?DET驟咲ｽｮ謌仙粥<E4BB99>啻http://host.docker.internal:3001/api/v1/iit/webhooks/redcap`
- 笨?API Token逕滓<E98095><E6BB93>啻FCB30F9CBD12EE9E8E9B3E3A0106701B`
**蜈ｳ髞ｮ謚譛ｯ遯∫<E981AF>?*<2A>?1. 笨?REDCap DET螳樊慮隗ｦ蜿托ｼ?遘貞ｻｶ霑滂ｼ<E6BB82>
2. 笨?form-urlencoded譬ｼ蠑乗髪謖<E9ABAA>ｼ<EFBFBD>EDCap蜴溽函譬ｼ蠑擾ｼ?3. 笨?蜿御ｿ晞勦譛ｺ蛻ｶ<E89BBB><EFBDB6>ebhook + 螳壽慮霓ｮ隸｢<E99AB8>?4. 笨?隨ｦ蜷亥屬髦溷ｼ蜿題ｧ<E9A18C>激<EFBFBD>磯弌蛻怜多蜷阪仝orker豕ｨ蜀鯉ｼ?
---
### 2.2 蠖灘燕譫ｶ譫<EFBDB6>憾諤?
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏? 蟾ｲ螳梧<E89EB3>逧<EFBFBD>渕遑隶ｾ譁ｽ 笏?笏懌楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏? 笏?笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏? REDCap 笏? 竊?謨ｰ謐ｮ蠖募<E8A096> 笏?笏? 笏? 15.8.0 笏? 竊?DET驟咲ｽｮ 笨? 笏?笏? 笏披楳笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏? 笏?笏? 笏?DET隗ｦ蜿托ｼ?遘貞ｻｶ霑滂ｼ俄<EFBDBC>? 笏?笏? 竊? 笏?笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏? Node.js Backend 笏? 笏?笏? 笏? (Fastify + pg-boss) 笏? 笏?笏? 笏懌楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏?笨?WebhookController 笏?竊?謗･謾ｶDET (<10ms) 笏?笏? 笏?笨?RedcapAdapter 笏?竊?諡牙叙謨ｰ謐ｮ 笏?笏? 笏?笨?SyncManager 笏?竊?霓ｮ隸｢陦･蜈<EFBDA5> 笏?笏? 笏?笨?Worker髦溷<E9ABA6> 笏?竊?蠑よｭ･螟<EFBDA5>炊 笏?笏? 笏?竢?WechatService 笏?竊?蠕<>ｼ蜿?<3F>櫨 笏?笏? 笏披楳笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏?蠕<>遠騾?<3F>櫨 笏?笏? 竊? 笏?笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏? 莨∽ｸ壼ｾｮ菫｡ 笏? 笏?笏? 笏? (蟾ｲ驟咲ｽ?笨? 笏? 笏?笏? 笏懌楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏?笨?蠎皮畑蛻帛ｻｺ 笏? 笏?笏? 笏?笨?蜃ｭ隸<EFBDAD><E99AB8>鄂ｮ 笏? 笏?笏? 笏?笨?蝓溷錐謗域揀 笏? 笏?笏? 笏?笨?AccessToken闔ｷ蜿<EFBDB7> 笏? 笏?笏? 笏?竢?豸域<E8B1B8>謗ｨ騾? 笏?竊?蠕<>ｼ蜿?<3F>櫨 笏?笏? 笏?竢?豸域<E8B1B8>謗･謾ｶ 笏?竊?蠕<>ｼ蜿?<3F>櫨 笏?笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?笏? 笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?```
笞<EFBFBD><EFBFBD><EFBFBD> 荳峨∝<C280>髞ｮ謚譛ｯ鬟朱勦荳手ｧ<E6898B>∩譁ｹ譯<EFBDB9>
蝨ｨ豁｣蠑丞ｼ蜿大燕<EFBFBD>?*蠢<>｡ｻ莠<EFBDBB>ｧ｣**莉･荳<EFBDA5>3荳ｪ莨∽ｸ壼ｾｮ菫｡蟇ｹ謗･逧<EFBDA5><E980A7>蜻ｽ髯ｷ髦ｱ<E9ABA6>?
鬟朱勦A<EFBFBD>?遘定ｶ<E5AE9A>慮鬲泌<E9ACB2>?<3F>櫨 Critical
髣ｮ鬚<EFBFBD><EFBFBD>壻ｼ∽ｸ壼ｾｮ菫｡隕∵ｱり｢ｫ蜉ｨ蝗槫､肴ｶ域<EFBFBD>蠢<EFBFBD>｡ｻ蝨ｨ**5遘貞<E98198>**螳梧<E89EB3>縲ょｦよ棡Node.js遲陰I隶｡邂怜ｮ悟<EFBDAE>return<72>御ｼ∝ｾｮ譌ｩ蟾ｲ謠千､?譛榊苅證よ慮荳榊庄逕?蟷ｶ譁ｭ蠑霑樊磁縲? 髞呵ｯｯ蛛壽ｳ<EFBFBD><EFBFBD>?```typescript 笶?async handleCallback(request, reply) { const answer = await callLLM(message); // 蜿ｯ閭ｽ閠玲慮10遘? return reply.send(answer); // 雜<>慮莠<E685AE>ｼ<EFBFBD> }
**豁｣遑ｮ蛛壽ｳ<E5A3BD>**<2A>夐㊦逕?*蠑よｭ･蝗槫､肴ｨ｡蠑<EFBDA1>**
```typescript
笨?async handleCallback(request, reply) {
// 1. 遶句叉霑泌屓<E6B38C>?1遘抵ｼ<E68AB5>
reply.send('success');
// 2. 蠑よｭ･螟<EFBDA5>炊<EFBFBD>井ｸ埼仆蝪橸ｼ? setImmediate(async () => {
const answer = await callLLM(message); // 蜿ｯ莉･諷｢諷｢邂? await wechatService.sendTextMessage(userId, answer); // 荳ｻ蜉ｨ謗ｨ騾? });
}
隗<EFBFBD>∩謗ｪ譁ｽ<EFBFBD>壼惠Day 3蠑蜿台ｸｭ蠢<EFBFBD>｡ｻ菴ｿ逕ｨ蠑よｭ･蝗槫､肴ｨ｡蠑擾ｼ檎ｦ∵ｭ｢蝨ｨHTTP Response荳ｭ逶ｴ謗･霑泌屓AI扈捺棡縲?
鬟朱勦B<EFBFBD>唸ML蜉<EFBFBD>隗｣蟇?<3F>櫨 P0
髣ｮ鬚<EFBFBD><EFBFBD>壻ｼ∽ｸ壼ｾｮ菫｡逧<EFBFBD>ｶ域<EFBFBD>菴捺弍蜉<EFBFBD>蟇<EFBFBD>噪XML<EFBFBD><EFBFBD>ncrypt蟄玲ｮｵ<EFBFBD>会ｼ御ｸ肴弍譏取枚JSON縲りｧ｣蟇<EFBFBD>怙隕、ES邂玲ｳ募柱螟肴揩逧Пadding隗<EFBFBD><EFBFBD>縲? 髞呵ｯｯ蛛壽ｳ<EFBFBD><EFBFBD>夊<EFBFBD>蟾ｱ蜀吝刈隗｣蟇<EFBFBD>ｮ玲ｳ包ｼ域栫譏灘<EFBFBD>髞呻ｼ? 豁｣遑ｮ蛛壽ｳ<EFBFBD><EFBFBD>壻ｽｿ逕ｨ螳俶婿蠎<EFBFBD>
npm install @wecom/crypto
import { WXBizMsgCrypt } from '@wecom/crypto';
const crypt = new WXBizMsgCrypt(
WECHAT_TOKEN, // 閾ｪ螳壻ｹ欝oken
WECHAT_ENCODING_AES_KEY, // 莨∝ｾｮ蜷主床逕滓<E98095><E6BB93>?3菴搾ｼ<E690BE>
WECHAT_CORP_ID
);
// 隗｣蟇<EFBDA3>ｶ域<EFBDB6>
const decrypted = crypt.decrypt(encryptedXml);
隗<EFBFBD>∩謗ｪ譁ｽ<EFBFBD>壼ｼｺ蛻ｶ菴ｿ逕ｨ螳俶婿蠎難ｼ檎ｦ∵ｭ｢閾ｪ蟾ｱ螳樒鴫蜉<EFBFBD>隗｣蟇<EFBFBD>?
鬟朱勦C<EFBFBD>唔P逋ｽ蜷榊黒髯仙<EFBFBD>?<3F>櫨 P0
髣ｮ鬚<EFBFBD><EFBFBD>夊執蜿泡ccessToken譌ｶ<EFBFBD>御ｼ∽ｸ壼ｾｮ菫｡莨壽<EFBFBD>｡鬪瑚ｯｷ豎よ擂貅蝕P縲? 邇ｰ迥ｶ<EFBFBD>售AE騾夊ｿ⑮AT鄂大<EFBFBD>隶ｿ髣ｮ螟也ｽ<EFBFBD>
- NAT鄂大<EFBFBD>IP<EFBFBD>啻182.92.176.14`
- 莨∽ｸ壼ｾｮ菫｡驟咲ｽｮ<EFBFBD>壽悴豺ｻ蜉<EFBFBD>蛻?莨∽ｸ壼庄菫｡IP"蛻苓｡ｨ
蜷取棡<EFBFBD>壼ｦゆｸ埼<EFBFBD>鄂ｮ<EFBFBD>携etAccessToken()莨壽冠60020髞呵ｯｯ
隗<EFBFBD>∩謗ｪ譁ｽ<EFBFBD>?1. 逋ｻ蠖穂ｼ∽ｸ壼ｾｮ菫｡邂｡逅<EFBDA1>錘蜿ｰ 2. 霑帛<E99C91>"蠎皮畑邂｡逅<EFBDA1>" 竊?"IIT Manager Agent" 3. 謇ｾ蛻ｰ"莨∽ｸ壼庄菫｡IP"驟咲ｽｮ 4. 豺ｻ蜉<EFBDBB><E89C89>啻182.92.176.14`
鬟朱勦D<EFBFBD>壼<EFBFBD>髞ｮ隸榊源驟<EFBFBD> vs AI Agent 笞<><E7AC9E><EFBFBD> P2
髣ｮ鬚<EFBFBD><EFBFBD>夂ｮ蜊慕噪蜈ｳ髞ｮ隸榊源驟搾ｼ<EFBFBD>if (msg.includes('豎<>?))`<60>我ｸ肴弍AI Agent<6E>悟宵譏ｯif-else譛ｺ蝎ｨ莠ｺ縲? 豁｣遑ｮ蛛壽ｳ<EFBFBD><EFBFBD>壻ｽｿ逕ｨLLM蛛壽э蝗ｾ蛻<EFBFBD>ｱ?```typescript // 笨?逵滓ｭ｣逧БI Agent const intent = await classifyIntent(userMessage); // 隹<>畑LLM switch(intent.type) { case 'query_weekly_summary': ... case 'query_patient_info': ... }
**隗<>∩謗ｪ譁ｽ**<2A>壼惠Day 3荳句壕螳樒鴫蝓ｺ莠鮫LM逧<4D>э蝗ｾ隸<EFBDBE>悪縲?
---
## <20>噫 蝗帙．ay 3-4 蠑蜿題ｮ｡蛻?
### Day 3<>壻ｼ∽ｸ壼ｾｮ菫｡髮<EFBDA1><E9ABAE><EFBFBD><EFBFBD>2026-01-03<30>?蟆乗慮<E4B997>解沐?
#### 蜃<>､<EFBFBD>ｷ･菴懶ｼ壻ｼ∽ｸ壼ｾｮ菫｡驟咲ｽｮ譽譟･<E8AD9F><EFBDA5>1蟆乗慮<E4B997>俄國<E4BF84>?蠢<>｡ｻ蜈亥★
**莉ｻ蜉｡0<EFBDA1>壻ｼ∽ｸ壼ｾｮ菫｡驟咲ｽｮ螳梧紛諤ｧ譽譟?*
**驟咲ｽｮ貂<EFBDAE>黒**<2A>?1. [ ] **莨∽ｸ壼庄菫｡IP驟咲ｽｮ** <20>櫨 Critical
- 逋ｻ蠖穂ｼ∽ｸ壼ｾｮ菫｡邂｡逅<EFBDA1>錘蜿ｰ
- 蠎皮畑邂｡逅<EFBDA1> 竊?IIT Manager Agent 竊?莨∽ｸ壼庄菫｡IP
- 豺ｻ蜉<EFBDBB><E89C89>啻182.92.176.14`<60><>AE NAT鄂大<E98482>IP<49>? - 豬玖ｯ包ｼ夊ｰ<E5A48A>畑getAccessToken<65>碁ｪ瑚ｯ∽ｸ肴<EFBDB8>?0020髞呵ｯｯ
2. [ ] **闔ｷ蜿胞ncodingAESKey** <20>櫨 Critical
- 莨∽ｸ壼ｾｮ菫｡蜷主床 竊?蠎皮畑邂｡逅<EFBDA1> 竊?IIT Manager Agent
- 蠑蜿題<E9A18C>磁蜿?竊?謗･謾ｶ豸域<E8B1B8>
- 轤ｹ蜃ｻ"髫乗惻逕滓<E98095>"謖蛾聴<E89BBE>瑚執蜿?3菴喉ESKey
- 螟榊宛菫晏ｭ假ｼ育畑莠取ｶ域<EFBDB6>隗｣蟇<EFBDA3>ｼ<EFBFBD>
3. [ ] **隶ｾ鄂ｮToken** <20>櫨 Critical
- 閾ｪ螳壻ｹ我ｸ荳ｪToken<65>育畑莠守ｭｾ蜷埼ｪ瑚ｯ<E7919A>ｼ<EFBFBD>
- 蟒ｺ隶ｮ<E99AB6>?2菴埼囂譛ｺ蟄礼ｬｦ荳ｲ
- 菫晏ｭ伜芦邇ｯ蠅<EFBDAF>序驥?
4. [ ] **驟咲ｽｮ蝗櫁ｰザRL**
- URL<52>啻https://iit.xunzhengyixue.com/api/v1/iit/wechat/callback`
- 鬪瑚ｯゝoken縲・ncodingAESKey驟咲ｽｮ豁｣遑ｮ
**邇ｯ蠅<EFBDAF>序驥乗眠蠅<E79CA0>**<2A>?```env
# 莨∽ｸ壼ｾｮ菫｡驟咲ｽｮ<EFBDBD>亥ｷｲ譛会ｼ<E4BC9A>
WECHAT_CORP_ID=ww6ab493470ab4f377
WECHAT_AGENT_ID=1000002
WECHAT_CORP_SECRET=AZIVxMtoLb0rEszXS81e4dBRl-I9kgTjygIS0cFfENU
# 莨∽ｸ壼ｾｮ菫｡蜉<EFBDA1>隗｣蟇<EFBDA3><E89F87>鄂ｮ<E98482>域眠蠅橸ｼ解沐?WECHAT_TOKEN=your_32_char_random_token_here
WECHAT_ENCODING_AES_KEY=your_43_char_aes_key_from_wechat_console
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?IP逋ｽ蜷榊黒蟾ｲ驟咲ｽｮ
- 笨?EncodingAESKey蟾ｲ闔ｷ蜿門ｹｶ菫晏ｭ<E6998F>
- 笨?Token蟾ｲ隶ｾ鄂ｮ蟷ｶ菫晏ｭ<E6998F>
- 笨?AccessToken蜿ｯ莉･豁｣蟶ｸ闔ｷ蜿厄ｼ域裏60020髞呵ｯｯ<EFBDAF>?
荳雁壕<EFBFBD>壻ｼ∽ｸ壼ｾｮ菫｡謗ｨ騾∵恪蜉｡<EFBFBD><EFBFBD>4蟆乗慮<EFBFBD>?
逶ｮ譬<EFBFBD><EFBFBD>壼ｮ梧<EFBFBD>莉晒ode.js蛻ｰ莨∽ｸ壼ｾｮ菫｡逧<EFBDA1>耳騾<E880B3>夐％
*莉ｻ蜉｡1<EFBFBD>壼<EFBFBD>蟒?WechatService.ts<74>?蟆乗慮<E4B997>?
譁<EFBFBD>ｻｶ菴咲ｽｮ<EFBFBD>啻backend/src/modules/iit-manager/services/WechatService.ts`
譬ｸ蠢<EFBFBD>粥閭ｽ<EFBFBD>?```typescript class WechatService { /**
- 闔ｷ蜿泡ccess Token<65>亥ｸｦ郛灘ｭ假ｼ? */ async getAccessToken(): Promise
/**
- 蜿鷹∵焚謐ｮ蠖募<EFBFBD>騾夂衍 */ async sendDataEntryNotification(params: { userId: string; projectName: string; recordId: string; action: 'created' | 'updated'; fieldsSummary: string; }): Promise
/**
- 蜿鷹∵枚譛ｬ豸域<EFBFBD><EFBFBD>磯夂畑<EFBFBD>? */ async sendTextMessage(userId: string, content: string): Promise
/**
- 蜿鷹∝今迚<EFBFBD>ｶ域<EFBFBD><EFBFBD>磯夂畑<EFBFBD>? */ async sendTextCard(params: { userId: string; title: string; description: string; url?: string; btntxt?: string; }): Promise }
**螳樒鴫隕∫せ**<2A>?- 笨?AccessToken郛灘ｭ伜芦Postgres<65>?000遘定ｿ<E5AE9A>悄譌ｶ髣ｴ<E9ABA3><EFBDB4>
- 笨?驥崎ｯ墓惻蛻ｶ<E89BBB>?谺｡驥崎ｯ包ｼ梧欠謨ｰ騾驕ｿ<E9A995><EFBDBF>
- 笨?髞呵ｯｯ螟<EFBDAF>炊蜥梧律蠢苓ｮｰ蠖?- 笨?謾ｯ謖∵枚譛ｬ豸域<E8B1B8>蜥悟今迚<E4BB8A>ｶ域<EFBDB6>?
**鬪梧噺譬<E599BA>㊥**<2A>?- 笨?AccessToken蜿ｯ莉･豁｣遑ｮ闔ｷ蜿門柱郛灘ｭ?- 笨?蜿ｯ莉･蜿鷹∵枚譛ｬ豸域<E8B1B8>蛻ｰ謖<EFBDB0>ｮ夂畑謌ｷ
- 笨?蜿ｯ莉･蜿鷹∝今迚<E4BB8A>ｶ域<EFBDB6>?- 笨?郛灘ｭ俶惻蛻ｶ豁｣蟶ｸ蟾･菴<EFBDA5>
---
**莉ｻ蜉｡2<EFBDA1>壼ｮ悟<EFBDAE>?iit_quality_check Worker<65>?蟆乗慮<E4B997>?*
**譁<>ｻｶ菴咲ｽｮ**<2A>啻backend/src/modules/iit-manager/index.ts`
**蠖灘燕迥ｶ諤?*<2A>啗orker蟾ｲ豕ｨ蜀鯉ｼ御ｽ<E5BEA1>ｻ霎台ｸｺ遨ｺ<E981A8>郁ｿ泌屓pending_implementation<6F>?
**譖ｴ譁ｰ蜀<EFBDB0>ｮｹ**<2A>?```typescript
jobQueue.process('iit_quality_check', async (job) => {
const { projectId, recordId, recordData, instrument } = job.data;
try {
// 1. 闔ｷ蜿夜｡ｹ逶ｮ驟咲ｽｮ
const project = await prisma.projects.findUnique({
where: { id: projectId }
});
// 2. 譫<><EFBFBD>謨ｰ謐ｮ鞫倩ｦ? const fieldsList = Object.keys(recordData);
const summary = `蠖募<E8A096>${fieldsList.length}荳ｪ蟄玲ｮｵ`;
// 3. 蜿鷹∽ｼ∽ｸ壼ｾｮ菫｡騾夂衍
const wechatService = new WechatService();
await wechatService.sendDataEntryNotification({
userId: 'GaoFeng', // TODO: 莉朱｡ｹ逶ｮ驟咲ｽｮ荳ｭ闔ｷ蜿<EFBDB7>
projectName: project.name,
recordId,
action: instrument === 'demographics' ? 'created' : 'updated',
fieldsSummary: summary
});
// 4. 隶ｰ蠖募ｮ｡隶｡譌･蠢<EFBDA5>
await prisma.auditLogs.create({
data: {
projectId,
actionType: 'WECHAT_NOTIFICATION_SENT',
entityId: recordId,
details: {
recordId,
instrument,
fieldCount: fieldsList.length,
notified: true
}
}
});
logger.info('Wechat notification sent', {
recordId,
instrument,
fieldCount: fieldsList.length
});
return { success: true, notified: true };
} catch (error: any) {
logger.error('Wechat notification failed', {
recordId,
error: error.message
});
throw error;
}
});
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?Worker蜿ｯ莉･豁｣蟶ｸ謇ｧ陦<EFBDA7>
- 笨?莨∽ｸ壼ｾｮ菫｡騾夂衍蜿鷹∵<C280>蜉?- 笨?螳｡隶｡譌･蠢玲ｭ｣遑ｮ隶ｰ蠖<EFBDB0>
- 笨?髞呵ｯｯ螟<EFBDAF>炊螳悟埋
*莉ｻ蜉｡3<EFBFBD>夂ｫｯ蛻ｰ遶ｯ豬玖ｯ包ｼ?蟆乗慮<E4B997>?
豬玖ｯ募惻譎ｯ1<EFBFBD>壽焚謐ｮ蠖募<EFBFBD>騾夂衍
謫堺ｽ懶ｼ壼惠REDCap荳ｭ譁ｰ蠅櫁ｮｰ蠖肘D 8
鬚<>悄<EFBFBD>?1. DET螳樊慮隗ｦ蜿托ｼ?遘貞ｻｶ霑滂ｼ<E6BB82>
2. WebhookController謗･謾ｶ<E8ACBE>?10ms蜩榊ｺ費ｼ?3. Worker謇ｧ陦鯉ｼ?遘貞<E98198><E8B29E>?4. 莨∽ｸ壼ｾｮ菫｡謾ｶ蛻ｰ騾夂衍<E5A482>?遘貞<E98198><E8B29E>?```
**豬玖ｯ募惻譎ｯ2<EFBDAF>壽焚謐ｮ譖ｴ譁ｰ騾夂衍**
謫堺ｽ懶ｼ壼惠REDCap荳ｭ菫ｮ謾ｹ隶ｰ蠖肘D 2 鬚<>悄<EFBFBD>?1. DET螳樊慮隗ｦ蜿<EFBDA6> 2. 莨∽ｸ壼ｾｮ菫｡謾ｶ蛻ｰ譖ｴ譁ｰ騾夂衍 3. 騾夂衍蜀<E8A18D>ｮｹ蛹<EFBDB9>性菫ｮ謾ｹ逧<EFBDB9>ｭ玲ｮｵ菫｡諱?```
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?螳梧紛髣ｭ邇ｯ<E98287><EFBDAF>EDCap 竊?Node.js 竊?莨∝ｾｮ<EFBDBE>画遠騾?- 笨?蜩榊ｺ疲慮髣ｴ<5遘?- 笨?騾夂衍蜀<E8A18D>ｮｹ蜃<EFBDB9>｡ｮ
- 笨?螳｡隶｡譌･蠢怜ｮ梧紛
荳句壕<EFBFBD>壻ｼ∽ｸ壼ｾｮ菫｡蟇ｹ隸晄磁謾ｶ<EFBFBD><EFBFBD>4蟆乗慮<EFBFBD>?
逶ｮ譬<EFBFBD><EFBFBD>壼ｮ樒鴫PI蝨ｨ莨∽ｸ壼ｾｮ菫｡荳ｭ荳拶I Agent蟇ｹ隸<EFBDB9>
*莉ｻ蜉｡4<EFBFBD>壼ｮ芽｣<EFBFBD>ｹｶ驟咲ｽｮ豸域<EFBFBD>隗｣蟇<EFBFBD>ｺ難ｼ<EFBFBD>15蛻<EFBFBD>帖<EFBFBD>?
cd backend
npm install @wecom/crypto
npm install xml2js # XML隗｣譫<EFBDA3>
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?萓晁ｵ門ｮ芽｣<E88ABD><EFBDA3>蜉<EFBFBD>
- 笨?蜿ｯ莉･import謌仙粥
莉ｻ蜉｡5<EFBFBD>壼<EFBFBD>蟒?WechatCallbackController.ts<74>?.5蟆乗慮<EFBFBD>解沐?蜈ｳ髞ｮ
譁<EFBFBD>ｻｶ菴咲ｽｮ<EFBFBD>啻backend/src/modules/iit-manager/controllers/WechatCallbackController.ts`
譬ｸ蠢<EFBFBD>粥閭ｽ<EFBFBD>?*蠑よｭ･蝗槫､肴ｨ｡蠑<EFBDA1>**<2A>会ｼ<E4BC9A>
import { WXBizMsgCrypt } from '@wecom/crypto';
import { parseString } from 'xml2js';
class WechatCallbackController {
private crypt: WXBizMsgCrypt;
constructor() {
this.crypt = new WXBizMsgCrypt(
process.env.WECHAT_TOKEN!,
process.env.WECHAT_ENCODING_AES_KEY!,
process.env.WECHAT_CORP_ID!
);
}
/**
* 鬪瑚ｯ∽ｼ∽ｸ壼ｾｮ菫｡遲ｾ蜷搾ｼ<E690BE>ET隸ｷ豎ゑｼ? * 莨∽ｸ壼ｾｮ菫｡鬥匁ｬ｡驟咲ｽｮ蝗櫁ｰザRL譌ｶ莨壼書騾<E69BB8>ｪ瑚ｯ∬ｯｷ豎? */
async verifyCallback(request: any, reply: any): Promise<any> {
const { msg_signature, timestamp, nonce, echostr } = request.query;
try {
// 鬪瑚ｯ∫ｭｾ蜷榊ｹｶ隗｣蟇<EFBDA3>chostr
const decrypted = this.crypt.verifyURL(
msg_signature,
timestamp,
nonce,
echostr
);
logger.info('Wechat callback URL verified');
return reply.send(decrypted);
} catch (error: any) {
logger.error('Wechat callback verification failed', { error: error.message });
return reply.code(403).send('Verification failed');
}
}
/**
* 謗･謾ｶ莨∽ｸ壼ｾｮ菫｡逕ｨ謌ｷ豸域<E8B1B8><E59F9F><EFBFBD>OST隸ｷ豎ゑｼ? * <20>櫨 蜈ｳ髞ｮ<E9AB9E>壼ｿ<E5A3BC>｡ｻ蝨ｨ5遘貞<E98198>霑泌屓<E6B38C>御ｽｿ逕ｨ蠑よｭ･螟<EFBDA5><E89E9F>? */
async handleCallback(request: any, reply: any): Promise<any> {
const { msg_signature, timestamp, nonce } = request.query;
const encryptedXml = request.body;
try {
// 1. 隗｣蟇<EFBDA3>ｶ域<EFBDB6>菴? const decryptedXml = this.crypt.decrypt(
msg_signature,
timestamp,
nonce,
encryptedXml
);
// 2. 隗｣譫森ML
const message = await this.parseXML(decryptedXml);
const { FromUserName, Content, MsgId, MsgType } = message;
logger.info('Wechat message received', {
userId: FromUserName,
msgType: MsgType,
msgId: MsgId
});
// 3. <20>櫨 遶句叉霑泌屓'success'<27>?1遘抵ｼ<E68AB5>
reply.send('success');
// 4. <20>櫨 蠑よｭ･螟<EFBDA5>炊<EFBFBD>井ｸ埼仆蝪橸ｼ悟庄莉･諷｢諷｢邂暦ｼ? if (MsgType === 'text') {
setImmediate(async () => {
try {
// 蜿ｯ閭ｽ閠玲慮5-10遘? const answer = await this.processUserMessage(FromUserName, Content);
// 菴ｿ逕ｨ荳ｻ蜉ｨ謗ｨ騾∵磁蜿｣霑泌屓扈捺<E68988>? const wechatService = new WechatService();
await wechatService.sendTextMessage(FromUserName, answer);
// 隶ｰ蠖募ｮ｡隶｡譌･蠢<EFBDA5>
await this.logInteraction(MsgId, FromUserName, Content, answer);
} catch (error: any) {
logger.error('Async message processing failed', {
msgId: MsgId,
error: error.message
});
// 蜿鷹<E9B7B9>漠隸ｯ謠千､? await wechatService.sendTextMessage(
FromUserName,
'謚ｱ豁会ｼ悟､<E6829F>炊謔ｨ逧<EFBDA8>ｶ域<EFBDB6>譌ｶ蜃ｺ髞吩ｺ<E590A9>ｼ瑚ｯｷ遞榊錘驥崎ｯ輔?
);
}
});
}
return; // 蟾ｲ扈剰ｿ泌屓霑?success'莠?
} catch (error: any) {
logger.error('Wechat callback failed', { error: error.message });
return reply.code(500).send('Internal error');
}
}
/**
* 螟<>炊逕ｨ謌ｷ豸域<E8B1B8><E59F9F>芋沐?菴ｿ逕ｨLLM蛛壽э蝗ｾ隸<EFBDBE>悪<EFBFBD>瑚碁撼蜈ｳ髞ｮ隸榊源驟搾ｼ<E690BE>
*/
private async processUserMessage(
userId: string,
message: string
): Promise<string> {
// 1. 隹<>畑LLM蛛壽э蝗ｾ隸<EFBDBE><E99AB8>? const intent = await this.classifyIntent(message);
logger.info('Intent classified', { userId, intent });
// 2. 譬ｹ謐ｮ諢丞崟謇ｧ陦悟ｯｹ蠎疲桃菴<E6A183>
try {
switch(intent.type) {
case 'query_weekly_summary':
return await this.getWeeklySummary(intent.params);
case 'query_patient_info':
return await this.getPatientInfo(intent.params.recordId);
case 'query_project_stats':
return await this.getProjectStats(intent.params.projectId);
case 'unknown':
default:
return this.getHelpMessage();
}
} catch (error: any) {
logger.error('Query execution failed', { intent, error: error.message });
throw error;
}
}
/**
* <20>櫨 菴ｿ逕ｨLLM蛛壽э蝗ｾ蛻<EFBDBE>ｱｻ<EFBDB1>育悄豁｣逧БI Agent<6E>? */
private async classifyIntent(message: string): Promise<{
type: string;
params: any;
}> {
const prompt = `
菴<EFBFBD>譏ｯ荳荳ｪ諢丞崟蛻<EFBFBD>ｱｻ蝎ｨ縲ら畑謌ｷ隸ｴ<EFBFBD>?${message}"
隸ｷ蛻､譁ｭ逕ｨ謌ｷ逧<EFBFBD>э蝗ｾ蟷ｶ謠仙叙蜿よ焚<EFBFBD>瑚ｿ泌屓JSON譬ｼ蠑擾ｼ?
諢丞崟邀ｻ蝙具ｼ?- query_weekly_summary: 譟･隸｢譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>?- query_patient_info: 譟･隸｢謔｣閠<EFBDA3>ｿ｡諱?- query_project_stats: 譟･隸｢鬘ｹ逶ｮ扈溯ｮ｡
- unknown: 譌<>豕戊ｯ<E6888A>悪
遉ｺ萓具ｼ?逕ｨ謌ｷ<E8AC8C>?逵狗恚霑吝捉譛画ｲ｡譛画眠逞<E79CA0>ｺｺ<EFBDBA>?
霑泌屓<EFBFBD>嘴"type": "query_weekly_summary", "params": {"timeRange": "this_week"}}
逕ｨ謌ｷ<EFBFBD>?謔｣閠?逧<>ュ蜀ｵ諤惹ｹ域<EFBDB9>ｷ<EFBFBD><EFBDB7>"
霑泌屓<EFBFBD>嘴"type": "query_patient_info", "params": {"recordId": "8"}}
逕ｨ謌ｷ<EFBFBD>?鬘ｹ逶ｮ霑帛ｺｦ螯ゆｽ包ｼ?
霑泌屓<EFBFBD>嘴"type": "query_project_stats", "params": {}}
隸ｷ霑泌屓JSON<EFBFBD>? `.trim();
try {
// 隹<>畑DeepSeek API<50>域<EFBFBD>蜈ｶ莉豊LM<4C>? const response = await this.callLLM(prompt);
const intent = JSON.parse(response);
return intent;
} catch (error: any) {
logger.error('Intent classification failed', {
message,
error: error.message
});
// 髯咲ｺｧ<EFBDBA>夊ｿ泌屓unknown
return { type: 'unknown', params: {} };
}
}
/**
* 隹<>畑LLM API
*/
private async callLLM(prompt: string): Promise<string> {
// TODO: 螳樒鴫DeepSeek API隹<49>畑
// 證よ慮霑泌屓mock謨ｰ謐ｮ逕ｨ莠取ｵ玖ｯ<E78E96>
// 邂蜊慕噪蜈ｳ髞ｮ隸榊源驟堺ｽ應ｸｺfallback
if (prompt.includes('荳蜻?) || prompt.includes('豎<EFBFBD>?)) {
return JSON.stringify({
type: 'query_weekly_summary',
params: { timeRange: 'this_week' }
});
}
const patientMatch = prompt.match(/謔｣閠?\d+)/);
if (patientMatch) {
return JSON.stringify({
type: 'query_patient_info',
params: { recordId: patientMatch[1] }
});
}
if (prompt.includes('霑帛ｺｦ') || prompt.includes('扈溯ｮ｡')) {
return JSON.stringify({
type: 'query_project_stats',
params: {}
});
}
return JSON.stringify({ type: 'unknown', params: {} });
}
/**
* 闔ｷ蜿匁怙霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>? */
private async getWeeklySummary(params: any): Promise<string>
/**
* 闔ｷ蜿匁ぅ閠<E38185>ｿ｡諱? */
private async getPatientInfo(recordId: string): Promise<string>
/**
* 闔ｷ蜿夜｡ｹ逶ｮ扈溯ｮ｡
*/
private async getProjectStats(projectId: string): Promise<string>
/**
* 蟶ｮ蜉ｩ豸域<E8B1B8>
*/
private getHelpMessage(): string {
return `謔ｨ螂ｽ<E89E82>∵<EFBFBD>譏ｯIIT Manager AI蜉ｩ謇<EFBDA9> <20>､<EFBFBD>
謔ｨ蜿ｯ莉･霑呎<EFBFBD>ｷ髣ｮ謌托ｼ<EFBFBD>
<EFBFBD>投 "譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>?
<EFBFBD>側 "譟･隸｢謔｣閠?逧<>ュ蜀?
<EFBFBD>嶋 "鬘ｹ逶ｮ霑帛ｺｦ螯ゆｽ<E38286>"
謌台ｼ壼ｰｽ蜉帛ｸｮ蜉ｩ謔ｨ<EFBFBD>～;
}
/**
* 隗｣譫森ML豸域<E8B1B8>
*/
private async parseXML(xml: string): Promise<any> {
return new Promise((resolve, reject) => {
parseString(xml, { explicitArray: false }, (err, result) => {
if (err) reject(err);
else resolve(result.xml);
});
});
}
/**
* 隶ｰ蠖穂ｺ､莠呈律蠢<E5BE8B>
*/
private async logInteraction(
msgId: string,
userId: string,
userMessage: string,
botResponse: string
): Promise<void> {
await prisma.auditLogs.create({
data: {
actionType: 'WECHAT_USER_MESSAGE',
entityId: userId,
details: {
msgId,
userMessage,
botResponse,
timestamp: new Date()
}
}
});
}
}
螳樒鴫隕∫せ<EFBFBD>亥<EFBFBD>髞ｮ菫ｮ豁｣<EFBFBD><EFBFBD><EFBFBD>?- 笨?菴ｿ逕ｨ @wecom/crypto 隗｣蟇<EFBDA3>ｶ域<EFBDB6><E59F9F>井ｸ崎<EFBDB8>蟾ｱ螳樒鴫<E6A892>?- 笨?遶句叉霑泌屓'success'<27>?1遘抵ｼ碁∩蜈<E288A9>5遘定ｶ<E5AE9A>慮<EFBFBD><E685AE>
- 笨?菴ｿ逕ｨ
setImmediate蠑よｭ･螟<EFBDA5>炊 - 笨?菴ｿ逕ｨ荳ｻ蜉ｨ謗ｨ騾∵磁蜿｣霑泌屓扈捺<E68988>?- 笨?菴ｿ逕ｨLLM蛛壽э蝗ｾ蛻<EFBDBE>ｱｻ<EFBDB1>郁碁撼蜈ｳ髞ｮ隸榊源驟搾ｼ<E690BE>
- 笨?螳悟埋逧<E59F8B>漠隸ｯ螟<EFBDAF>炊蜥梧律蠢苓ｮｰ蠖<EFBDB0>
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?莨∽ｸ壼ｾｮ菫｡蝗櫁ｰザRL鬪瑚ｯ<E7919A>夊ｿ<E5A48A>
- 笨?蜿ｯ莉･謗･謾ｶ蟷ｶ隗｣蟇<EFBDA3>畑謌ｷ豸域<E8B1B8>?- 笨?蜩榊ｺ疲慮髣ｴ<1遘抵ｼ亥ｼよｭ･螟<EFBDA5>炊<EFBFBD>?- 笨?LLM諢丞崟隸<E5B49F>悪豁｣遑ｮ邇?80%
- 笨?蜿ｯ莉･豁｣遑ｮ霑泌屓譟･隸｢扈捺棡
*莉ｻ蜉｡6<EFBFBD>壽ｳｨ蜀御ｼ∽ｸ壼ｾｮ菫｡蝗櫁ｰ<EFBFBD>ｷｯ逕ｱ<EFBFBD><EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?
譁<EFBFBD>ｻｶ菴咲ｽｮ<EFBFBD>啻backend/src/modules/iit-manager/routes/index.ts`
譁ｰ蠅櫁ｷｯ逕ｱ<EFBFBD>?```typescript const wechatCallbackController = new WechatCallbackController();
// 莨∽ｸ壼ｾｮ菫｡蝗櫁ｰ<E6AB81>ｪ瑚ｯ<E7919A>ｼ<EFBFBD>ET<45>?fastify.get( '/api/v1/iit/wechat/callback', wechatCallbackController.verifyCallback.bind(wechatCallbackController) );
// 莨∽ｸ壼ｾｮ菫｡豸域<E8B1B8>謗･謾ｶ<E8ACBE><EFBDB6>OST<53>?fastify.post( '/api/v1/iit/wechat/callback', { schema: { body: { type: 'object' } } }, wechatCallbackController.handleCallback.bind(wechatCallbackController) );
logger.info('Registered route: GET/POST /api/v1/iit/wechat/callback');
**鬪梧噺譬<E599BA>㊥**<2A>?- 笨?霍ｯ逕ｱ豕ｨ蜀梧<E89C80>蜉<EFBFBD>
- 笨?GET隸ｷ豎ょ庄莉･鬪瑚ｯ∫ｭｾ蜷<EFBDBE>
- 笨?POST隸ｷ豎ょ庄莉･謗･謾ｶ豸域<E8B1B8>
---
**莉ｻ蜉｡7<EFBDA1>壼ｯｹ隸晏粥閭ｽ豬玖ｯ包ｼ<E58C85>1蟆乗慮<E4B997>?*
**豬玖ｯ募惻譎ｯ1<EFBDAF>壽怙霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>?*
謫堺ｽ懶ｼ壼惠莨∽ｸ壼ｾｮ菫｡荳ｭ蜿鷹<EFBFBD>ｼ<EFBFBD>"譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>? 鬚<>悄<EFBFBD>?AI Agent蝗槫､搾ｼ?"<22>投 譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>ｻ<C280><EFBDBB> 譁ｰ蠅槫女隸戊<E6888A>ｼ<EFBFBD>2萓?謨ｰ謐ｮ譖ｴ譁ｰ<E8AD81>?谺?諤ｻ隶｡<E99AB6>?譚｡謫堺ｽ懆ｮｰ蠖?
**豬玖ｯ募惻譎ｯ2<EFBDAF>壽ぅ閠<E38185>ｿ｡諱ｯ譟･隸?*
謫堺ｽ懶ｼ壼惠莨∽ｸ壼ｾｮ菫｡荳ｭ蜿鷹<EFBFBD>ｼ<EFBFBD>"譟･隸｢謔｣閠?逧<>ュ蜀? 鬚<>悄<EFBFBD>?AI Agent蝗槫､搾ｼ?"<22>搭 謔｣閠?4 蝓ｺ譛ｬ菫｡諱ｯ<E8ABB1>?蟋灘錐<E78198>嗾est 4 test 4 蟷ｴ鮴<EFBDB4>ｼ?8蟯?諤ｧ蛻ｫ<E89BBB>夂塙 BMI<4D>?8.3 蠖募<E8A096>迥ｶ諤<EFBDB6>ｼ壼ｷｲ螳梧<E89EB3>?
**豬玖ｯ募惻譎ｯ3<EFBDAF>夐｡ｹ逶ｮ霑帛ｺｦ譟･隸?*
謫堺ｽ懶ｼ壼惠莨∽ｸ壼ｾｮ菫｡荳ｭ蜿鷹<EFBFBD>ｼ<EFBFBD>"鬘ｹ逶ｮ霑帛ｺｦ" 鬚<>悄<EFBFBD>?AI Agent蝗槫､搾ｼ?"<22>投 test0102 鬘ｹ逶ｮ扈溯ｮ｡<EFBDAE>?諤ｻ蜿苓ｯ戊<E6888A>焚<EFBFBD>?萓?譛ｬ蜻ｨ譁ｰ蠅橸ｼ?萓?謨ｰ謐ｮ螳梧紛邇<E7B49B>ｼ<EFBFBD>87.5%"
**鬪梧噺譬<E599BA>㊥**<2A>?- 笨?3荳ｪ豬玖ｯ募惻譎ｯ蜈ｨ驛ｨ騾夊ｿ<E5A48A>
- 笨?蝗槫､榊<EFBDA4>螳ｹ蜃<EFBDB9>｡ｮ
- 笨?蜩榊ｺ疲慮髣ｴ<3遘?- 笨?髞呵ｯｯ螟<EFBDAF>炊蜿句･ｽ
---
### <20>投 Day 3 螳梧<E89EB3>諤ｻ扈難ｼ?026-01-03<30>俄怛
**螳樣刔螳梧<E89EB3>譌ｶ髣ｴ**<2A>?026-01-03
**莉ｻ蜉｡螳梧<E89EB3>蠎?*<2A>?00%
#### 譬ｸ蠢<EFBDB8><E8A0A2>譫<EFBFBD>
| 莠､莉倡<E88E89>?| 莉｣遐<EFBDA3><E98190>?| 迥ｶ諤?|
|-------|--------|------|
| WechatService<63>井ｼ∽ｸ壼ｾｮ菫｡謗ｨ騾<EFBDA8>ｼ<EFBFBD> | 314陦?| 笨?螳梧<E89EB3> |
| WechatCallbackController<65>亥屓隹<E5B193>､<EFBFBD>炊<EFBFBD><E7828A> | 501陦?| 笨?螳梧<E89EB3> |
| 雍ｨ謗ｧWorker螳悟埋 | 336陦?| 笨?螳梧<E89EB3> |
| Worker豕ｨ蜀御ｿｮ螟搾ｼ<E690BE>initIitManager`<60>?| - | 笨?螳梧<E89EB3> |
| 謨ｰ謐ｮ蠎灘ｭ玲ｮｵ菫ｮ螟搾ｼ<E690BE>action_type`<60>?| - | 笨?螳梧<E89EB3> |
| 遶ｯ蛻ｰ遶ｯ豬玖ｯ?| - | 笨?騾夊ｿ<E5A48A> |
| WECHAT_ENV_CONFIG.md | 401陦?| 笨?螳梧<E89EB3> |
| **諤ｻ隶｡** | **1,755陦?* | **笨?螳梧<E89EB3>** |
#### 蜈ｳ髞ｮ驥檎ｨ狗｢?
<0A>識 **MVP髣ｭ邇ｯ螳悟<E89EB3>謇馴?*<2A>?```
REDCap蠖募<E8A096>謨ｰ謐ｮ 竊?Node.js螳樊慮謐戊執<E6888A>?10ms<6D>? 竊?Worker螟<72>炊<EFBFBD><E7828A>50ms<6D>? 竊?莨∽ｸ壼ｾｮ菫｡謗ｨ騾<EFBDA8>夂衍<E5A482>?2遘抵ｼ<E68AB5>
竊?謇区惻遶ｯ謗･謾ｶ笨<EFBDB6>
諤ｧ閭ｽ謖<EFBFBD><EFBFBD><EFBFBD>
| 謖<EFBFBD><EFBFBD><EFBFBD> | 逶ｮ譬<EFBFBD> | 螳樣刔 | 迥ｶ諤? |
|---|---|---|---|
| Webhook蜩榊ｺ疲慮髣ｴ | <10ms | 5.8ms | 笨?雜<><E99B9C>鬚<EFBFBD>悄 |
| Worker謇ｧ陦梧慮髣ｴ | <100ms | ~50ms | 笨?雜<><E99B9C>鬚<EFBFBD>悄 |
| 遶ｯ蛻ｰ遶ｯ蟒ｶ霑? | <5遘? | <2遘? | 笨?雜<><E99B9C>鬚<EFBFBD>悄 |
| 豸域<EFBFBD>蜿鷹∵<EFBFBD>蜉溽紫 | >99% | 100% | 笨?雜<><E99B9C>鬚<EFBFBD>悄 |
豬玖ｯ暮ｪ瑚ｯ<EFBFBD>
**遶ｯ蛻ｰ遶ｯ豬玖ｯ?*<2A>亥ｷｲ騾夊ｿ<E5A48A>ｼ会ｼ<E4BC9A>
- 笨?REDCap蛻帛ｻｺ隶ｰ蠖<EFBDB0> ID 9
- 笨?DET螳樊慮隗ｦ蜿托ｼ?遘貞ｻｶ霑滂ｼ<E6BB82>
- 笨?Webhook謗･謾ｶ<E8ACBE>?.8ms蜩榊ｺ費ｼ?- 笨?莉ｻ蜉｡謗ｨ騾∝芦pg-boss髦溷<E9ABA6>
- 笨?Worker謇ｧ陦瑚ｴｨ謗ｧ譽譟?- 笨?蜿鷹∽ｼ∽ｸ壼ｾｮ菫｡騾夂衍
- 笨?謇区惻遶ｯ謌仙粥謗･謾ｶ騾夂衍
- 笨?螳｡隶｡譌･蠢苓ｮｰ蠖墓<E8A096>蜉<EFBFBD>
- 笨?譌<>蠕ｪ邇ｯ蜿鷹<E9B7B9>琉鬚? **莨∽ｸ壼ｾｮ菫｡謗ｨ騾∵ｵ玖ｯ?*<2A>亥ｷｲ騾夊ｿ<E5A48A>ｼ会ｼ<E4BC9A>
- 笨?譁<>悽豸域<E8B1B8>謗ｨ騾∵<E9A8BE>蜉?- 笨?Textcard蜊｡迚<EFBDA1>ｶ域<EFBDB6>謗ｨ騾∵<E9A8BE>蜉?- 笨?Markdown豸域<E8B1B8>謗ｨ騾∵<E9A8BE>蜉?- 笨?謇区惻遶ｯ蜈ｨ驛ｨ謗･謾ｶ豁｣蟶?
謚譛ｯ莠ｮ轤?
- 蠑よｭ･Worker譫ｶ譫<EFBFBD><EFBFBD>夂ｬｦ蜷<EFBFBD>ostgres-Only譛菴ｳ闌<EFBDB3>ｼ?2. **莨∽ｸ壼ｾｮ菫｡豸域<E8B1B8>蜉<EFBFBD>隗｣蟇?*<2A>壼ｮ梧紛螳樒鴫遲ｾ蜷埼ｪ瑚ｯ∝柱蜉<E69FB1>隗｣蟇?3. 蠑よｭ･蝗槫､肴ｨ｡蠑<EFBFBD><EFBFBD>啻setImmediate` 遑ｮ菫<EFBDAE>5遘貞<E98198>蜩榊ｺ<E6A68A>
- **螳梧紛逧<E7B49B>漠隸ｯ螟<EFBDAF><E89E9F>?*<2A>壼ｮ｡隶｡譌･蠢怜､ｱ雍･荳榊ｽｱ蜩堺ｸｻ豬∫ｨ?5. pg-boss驥崎ｯ墓惻蛻ｶ<EFBFBD>夊<EFBFBD>蜉ｨ驥崎ｯ?谺｡<E8B0BA>檎｡ｮ菫晏庄髱<E5BA84>諤?
荳ｴ譌ｶ謗ｪ譁ｽ荳取橿譛ｯ蛟ｺ蜉｡
| 蠎丞捷 | 荳ｴ譌ｶ謗ｪ譁ｽ | 謾ｹ霑幄ｮ｡蛻<EFBFBD> |
|---|---|---|
| 1 | UserID遑ｬ郛也<EFBFBD><EFBFBD>ｼ育識蠅<EFBFBD>序驥擾ｼ? | Phase 2: 莉朱｡ｹ逶ｮ驟咲ｽｮ陦ｨ隸ｻ蜿<EFBDBB> |
| 2 | 螳壽慮霓ｮ隸｢遖∫畑 | Phase 2: 菴ｿ逕ｨnode-cron謌匁黄螻姫gBossQueue |
| 3 | 雍ｨ謗ｧ騾ｻ霎醍ｮ蛹厄ｼ域裏AI<EFBFBD>? | Phase 1.5: 髮<><E9ABAE>Dify RAG |
| 4 | notification_config蟄玲ｮｵ譛ｪ蛻帛ｻ? |
Phase 2: 豺ｻ蜉<EFBDBB>JSONB蟄玲ｮｵ |
| 5 | Access Token蜀<6E>ｭ倡ｼ灘ｭ<E78198> | Phase 2: 菴ｿ逕ｨRedis謌匁焚謐ｮ蠎<EFBDAE> |
髣ｮ鬚倅ｸ手ｧ｣蜀?
- **Worker譛ｪ豕ｨ蜀?*<2A>啻initIitManager()
譛ｪ隹<EFBDAA><E99AB9>?竊?蝨?src/index.ts荳ｭ豺ｻ蜉<EFBDBB>隹<EFBFBD><E99AB9>?2. **蟄玲ｮｵ蜷埼漠隸?*<2A>啻action竊?action_type<EFBFBD>?螟<>ｿｮ螟搾ｼ<E690BE> - **蠕ｪ邇ｯ蜿鷹?*<2A>壼ｮ｡隶｡譌･蠢鈴漠隸ｯ蟇ｼ閾ｴWorker螟ｱ雍･驥崎ｯ<E5B48E> 竊?豺ｻ蜉<EFBDBB>try-catch
- **
notification_config荳榊ｭ伜<EFBFBD>?*<2A>夂ｧｻ髯､蟄玲ｮｵ譟･隸｢<E99AB8>檎峩謗･菴ｿ逕ｨ邇ｯ蠅<EFBDAF>序驥<E5BA8F>
蜿り<EFBFBD>枚譯?
06-蠑蜿題ｮｰ蠖?Day3-莨∽ｸ壼ｾｮ菫｡髮<EFBDA1><E9ABAE>荳守ｫｯ蛻ｰ遶ｯ豬玖ｯ募ｮ梧<EFBDAE>隶ｰ蠖<EFBDB0>.mdbackend/WECHAT_ENV_CONFIG.md
<EFBFBD>投 Phase 1.5<EFBFBD>哂I蟇ｹ隸晁<EFBFBD>蜉幢ｼ?026-01-03 & 2026-01-04<30>俄怛
莉ｻ蜉｡逶ｮ譬<EFBFBD><EFBFBD>壼惠莨∽ｸ壼ｾｮ菫｡荳ｭ螳樒鴫AI蟇ｹ隸晄衍隸｢閭ｽ蜉<EFBFBD>
螳樣刔螳梧<EFBFBD>譌ｶ髣ｴ<EFBFBD>?- Day 3 荳句壕<E58FA5>?026-01-03<30>会ｼ壼渕遑蟇ｹ隸<EFBDB9> + REDCap髮<70><E9ABAE>
- Day 4 荳雁壕<E99B81>?026-01-04<30>会ｼ咼ify遏･隸<EFBDA5>ｺ馴寔謌? **莉ｻ蜉｡螳梧<E89EB3>蠎?*<2A>?00%
譬ｸ蠢<EFBFBD><EFBFBD>譫懶ｼ<EFBFBD>hase 1.5<EFBFBD>?
| 莠､莉倡<EFBFBD>? | 莉｣遐<EFBFBD><EFBFBD>? | 迥ｶ諤? |
|---|---|---|
| ChatService.ts<74>亥ｯｹ隸晄恪蜉｡<E89C89><EFBDA1> | 485陦? | 笨?螳梧<E89EB3> |
| SessionMemory.ts<74>井ｼ夊ｯ晁ｮｰ蠢<EFBDB0>ｼ<EFBFBD> | 120陦? | 笨?螳梧<E89EB3> |
| WechatCallbackController<EFBFBD>亥ｯｹ隸晞寔謌撰ｼ<EFBFBD> | 譖ｴ譁ｰ | 笨?螳梧<E89EB3> |
| Dify遏･隸<EFBFBD>ｺ灘<EFBFBD>閨? | 閼壽悽 | 笨?螳梧<E89EB3> |
| 諢丞崟隸<EFBFBD>悪莨伜喧 | 謇ｩ螻<EFBFBD> | 笨?螳梧<E89EB3> |
| Bug菫ｮ螟搾ｼ亥ｭ玲ｮｵ霍ｯ蠕<EFBFBD>ｼ<EFBFBD> | 蜈ｳ髞ｮ菫ｮ螟<EFBFBD> | 笨?螳梧<E89EB3> |
| 隹<EFBFBD>ｯ戊<EFBFBD>譛ｬ<EFBFBD>?荳ｪ<E88DB3><EFBDAA> | 280陦? | 笨?螳梧<E89EB3> |
| 蠑蜿題ｮｰ蠖墓枚譯? | 600+陦? | 笨?螳梧<E89EB3> |
| 諤ｻ隶｡ | *~1,485陦? | 笨?螳梧<E89EB3> |
蜈ｳ髞ｮ驥檎ｨ狗｢?
<EFBFBD>識 **豺ｷ蜷域｣邏｢譫ｶ譫<EFBDB6>ｮ樒<EFBDAE>?*<2A>?``` 逕ｨ謌ｷ謠宣琉<E5AEA3>井ｼ∽ｸ壼ｾｮ菫｡<E88FAB><EFBDA1> 竊?諢丞崟隸<E5B49F>悪<EFBFBD><E682AA>hatService.detectIntent<6E>? 竊?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?query_protocol笏?query_record 笏?count_records笏?笏? (譁<>｡｣譟･隸｢) 笏? (隶ｰ蠖墓衍隸｢) 笏? (扈溯ｮ｡譟･隸｢) 笏?笏披楳笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏ｴ笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏ｴ笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏? 竊? 竊? 竊? Dify API REDCap API REDCap API (遏･隸<EFBDA5>ｺ? (謔｣閠<EFBDA3>焚謐? (謔｣閠<EFBDA3>焚謐? 竊? 竊? 竊? 譁<>｡｣迚<EFBDA3>ｮｵ JSON謨ｰ謐ｮ JSON謨ｰ謐ｮ 竊? 竊? 竊? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｴ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 竊? 譫<>ｻｺLLM Prompt (System + Context + Data) 竊? DeepSeek-V3 竊? AI蝗樒ｭ<E6A892>
#### 蜉溯<E89C89>鬪瑚ｯ<E7919A>
**豬玖ｯ暮｡ｹ逶ｮ**: test0102
- REDCap PID: 16, 11譚｡隶ｰ蠖?- Dify Dataset ID: `b49595b2-bf71-4e47-9988-4aa2816d3c6f`
- 譁<>｡｣: 遐皮ｩｶ譁ｹ譯医，RF陦ｨ譬ｼ<E8ADAC>?荳ｪ譁<EFBDAA>ｻｶ<EFBDBB>悟ｷｲ螟<EFBDB2>炊<EFBFBD><E7828A>
**豬玖ｯ募惻譎ｯ**<2A>?
| 蝨ｺ譎ｯ | 逕ｨ謌ｷ髣ｮ鬚<EFBDAE> | 謨ｰ謐ｮ貅?| 扈捺棡 | 迥ｶ諤?|
|------|---------|--------|------|------|
| 譁<>｡｣譟･隸｢ | "霑吩ｸｪ遐皮ｩｶ逧<EFBDB6>賜髯､譬<EFBDA4>㊥譏ｯ莉荵茨ｼ<E88CA8>" | Dify | 蝓ｺ莠取枚譯｣蜃<EFBDA3>｡ｮ蝗樒ｭ<E6A892> | 笨?騾夊ｿ<E5A48A> |
| CRF譟･隸｢ | "CRF陦ｨ譬ｼ荳ｭ譛牙頭莠幄ｧょｯ滓欠譬<E6ACA0>ｼ? | Dify | 蝓ｺ莠取枚譯｣蜃<EFBDA3>｡ｮ蝗樒ｭ<E6A892> | 笨?騾夊ｿ<E5A48A> |
| 謔｣閠<EFBDA3>衍隸?| "ID 7逧<37>ぅ閠<E38185>ュ蜀? | REDCap | 螳悟<E89EB3>蛹ｹ驟咲悄螳樊焚謐ｮ | 笨?騾夊ｿ<E5A48A> |
| 扈溯ｮ｡譟･隸｢ | "逶ｮ蜑榊<E89C91>扈<EFBFBD>ｺ<EFBFBD>､壼ｰ台ｺｺ<EFBDBA>? | REDCap | 蜃<>｡ｮ扈溯ｮ｡11莠?| 笨?騾夊ｿ<E5A48A> |
| 豺ｷ蜷域衍隸｢ | "霑吩ｸｪ遐皮ｩｶ逧<EFBDB6>ｸｻ隕∫<E99A95>皮ｩｶ逶ｮ逧<EFBDAE>弍莉荵茨ｼ<E88CA8>" | Dify | 蝓ｺ莠取枚譯｣蝗樒ｭ<E6A892> | 笨?騾夊ｿ<E5A48A> |
| 荳贋ｸ区枚隶ｰ蠢?| 螟夊ｽｮ蟇ｹ隸<EFBDB9> | SessionMemory | 隶ｰ蠕嶺ｸ贋ｸ霓ｮ蜀<EFBDAE>ｮ?| 笨?騾夊ｿ<E5A48A> |
#### 謚譛ｯ莠ｮ轤?
1. **豺ｷ蜷域｣邏?*<2A>壼酔譌ｶ謾ｯ謖∫ｻ捺桷蛹匁焚謐ｮ<E8AC90><EFBDAE>EDCap<61>牙柱髱樒ｻ捺桷蛹匁枚譯｣<E8ADAF><EFBDA3>ify<66>?2. **譎ｺ閭ｽ霍ｯ逕ｱ**<2A>壽<EFBFBD>ｹ謐ｮ諢丞崟閾ｪ蜉ｨ騾画叫謨ｰ謐ｮ貅?3. **髦ｲ豁｢蟷ｻ隗<EFBDBB>**<2A>壽園譛牙屓遲泌渕莠守悄螳樊焚謐?譁<>｡｣<EFBDA1>檎ｻ昜ｸ咲ｼ夜?4. **荳贋ｸ区枚隶ｰ蠢?*<2A>售essionMemory菫晏ｭ俶怙霑?霓ｮ蟇ｹ隸?5. **螟咲畑LLMFactory**<2A>夐峺驟咲ｽｮ菴ｿ逕ｨDeepSeek-V3
6. **蜊ｳ譌ｶ蜿埼ｦ<E59FBC>**<2A>?豁｣蝨ｨ譟･隸｢"豸域<E8B1B8><E59F9F>碁∩蜈咲畑謌ｷ辟ｦ陌?
#### 髣ｮ鬚俶賜譟･荳惹ｿｮ螟?
**蜈ｳ髞ｮBug菫ｮ螟<EFBDAE>**<2A>?
| 髣ｮ鬚<EFBDAE> | 譬ｹ蝗<EFBDB9> | 隗｣蜀ｳ譁ｹ譯<EFBDB9> | 迥ｶ諤?|
|------|------|---------|------|
| AI郛夜<E5A49C>遲疲｡?| 諢丞崟隸<E5B49F>悪蜈ｳ髞ｮ隸堺ｸ榊<EFBDB8><E6A68A>育ｼ?蜈･騾?遲会ｼ<E4BC9A> | 謇ｩ蜈<EFBDA9><E89C88>髞ｮ隸榊<E99AB8>陦?| 笨?蟾ｲ菫ｮ螟?|
| Dify蜀<79>ｮｹ荳ｺundefined | 髞呵ｯｯ逧БPI蜩榊ｺ泌ｭ玲ｮｵ霍ｯ蠕<EFBDAF> | 菫ｮ豁｣荳ｺ`record.segment.document.name`蜥形record.segment.content` | 笨?蟾ｲ菫ｮ螟?|
**隹<>ｯ募ｷ･蜈ｷ**<2A>?- `debug-dify-injection.ts`<60>夊ｿｽ雕ｪDify扈捺棡豕ｨ蜈･豬∫ｨ<E288AB>
- `inspect-dify-response.ts`<60>壽衍逵汽ify API螳樣刔霑泌屓扈捺桷
#### 譬ｸ蠢<EFBDB8><E8A0A2>蜉<EFBFBD>
1. 笨?**螳樊慮謨ｰ謐ｮ譟･隸｢**<2A>夐夊ｿ⑲EDCap API譟･隸｢謔｣閠<EFBDA3>RF謨ｰ謐ｮ
2. 笨?**遐皮ｩｶ譁ｹ譯域衍隸｢**<2A>夐夊ｿ⑤ify遏･隸<EFBDA5>ｺ捺｣邏｢遐皮ｩｶ譁ｹ譯医，RF縲∽ｼｦ逅<EFBDA6>枚莉?3. 笨?**譎ｺ閭ｽ逅<EFBDBD>ｧ｣**<2A>夊<EFBFBD>辟ｶ隸ｭ險謠宣琉<E5AEA3>梧裏髴隶ｰ蠢<EFBDB0>多莉､
4. 笨?**荳贋ｸ区枚逅<E69E9A>ｧ?*<2A>壼､夊ｽｮ蟇ｹ隸晢ｼ梧髪謖∽ｻ｣隸崎ｧ｣譫<EFBDA3>
5. 笨?**謨ｰ謐ｮ逵溷ｮ樊?*<2A>壽園譛牙屓遲泌渕莠守悄螳樊焚謐ｮ<E8AC90>檎ｻ昜ｸ咲ｼ夜?6. 笨?**豺ｷ蜷域｣邏?*<2A>壼酔譌ｶ譟･隸｢螟壻ｸｪ謨ｰ謐ｮ貅撰ｼ檎ｻ滉ｸ蜻育鴫
#### 蜿り<E3828A>枚譯?
- [Phase 1.5蠑蜿題ｮ｡蛻綻(./Phase1.5-AI蟇ｹ隸晁<E99AB8>蜉帛ｼ蜿題ｮ｡蛻?md)
- [Phase 1.5蠑蜿大ｮ梧<EFBFBD>隶ｰ蠖?(REDCap)](../06-蠑蜿題ｮｰ蠖?Phase1.5-AI蟇ｹ隸晞寔謌審EDCap螳梧<E89EB3>隶ｰ蠖<EFBDB0>.md)
- [Dify遏･隸<EFBDA5>ｺ馴寔謌仙ｼ蜿題ｮｰ蠖評(../06-蠑蜿題ｮｰ蠖?2026-01-04-Dify遏･隸<EFBDA5>ｺ馴寔謌仙ｼ蜿題ｮｰ蠖?md)
- [IIT Manager Agent 謚譛ｯ霍ｯ蠕<EFBDAF>ｸ取楔譫<E6A594>ｮｾ隶｡](../02-謚譛ｯ隶ｾ隶?IIT%20Manager%20Agent%20謚譛ｯ霍ｯ蠕<EFBDAF>ｸ取楔譫<E6A594>ｮｾ隶｡.md)
---
### Day 4<>壼ｮ悟埋荳取枚譯｣<E8ADAF>?026-01-04<30>?蟆乗慮<E4B997>俄昇<E4BF84>?
#### 荳雁壕<E99B81>壻ｼ伜喧荳取ｵ玖ｯ包ｼ?蟆乗慮<E4B997>?
**莉ｻ蜉｡8<EFBDA1>壼ｮ悟埋螳｡隶｡譌･蠢暦ｼ<E69AA6>1蟆乗慮<E4B997>?*
**譁ｰ蠅樊律蠢礼ｱｻ蝙<EFBDBB>**<2A>?```typescript
// 莨∽ｸ壼ｾｮ菫｡莠､莠呈律蠢<E5BE8B>
await prisma.auditLogs.create({
data: {
actionType: 'WECHAT_USER_MESSAGE',
entityId: userId,
details: {
userMessage: message,
botResponse: response,
intent: 'query_patient_info',
timestamp: new Date()
}
}
});
鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?謇譛我ｼ∽ｸ壼ｾｮ菫｡莠､莠帝<E88EA0>譛画律蠢?- 笨?譌･蠢怜桁蜷ｫ螳梧紛逧<E7B49B>ｸ贋ｸ区枚菫｡諱ｯ
- 笨?蜿ｯ莉･霑ｽ貅ｯ豈乗ｬ｡蟇ｹ隸<EFBDB9>
*莉ｻ蜉｡9<EFBFBD>夐漠隸ｯ螟<EFBFBD>炊莨伜喧<EFBFBD><EFBFBD>1蟆乗慮<EFBFBD>?
莨伜喧蜀<EFBFBD>ｮｹ<EFBFBD>?1. 莨∽ｸ壼ｾｮ菫｡API隹<EFBFBD>畑螟ｱ雍･<EFBFBD>? - 閾ｪ蜉ｨ驥崎ｯ<E5B48E>3谺? - 隶ｰ蠖暮漠隸ｯ譌･蠢<EFBDA5>
- 髯咲ｺｧ螟<EFBFBD>炊<EFBFBD>磯夂衍螟ｱ雍･荳榊ｽｱ蜩堺ｸｻ豬∫ｨ具ｼ?
- REDCap API雜<49>慮<EFBFBD>? - 30遘定ｶ<E5AE9A><EFBDB6>? - 蜿句･ｽ髞呵ｯｯ謠千､ｺ
- 霑泌屓郛灘ｭ俶焚謐ｮ<EFBFBD>亥ｦよ棡譛会ｼ?
- 逕ｨ謌ｷ豸域<EFBFBD>隗｣譫仙､ｱ雍･<EFBFBD>? - 霑泌屓蜿句･ｽ謠千､ｺ
- 隶ｰ蠖暮漠隸ｯ譌･蠢<EFBFBD>
- 荳榊ｽｱ蜩榊<EFBFBD>莉門粥閭? 鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?謇譛蛾漠隸ｯ蝨ｺ譎ｯ譛牙暑螂ｽ謠千､ｺ
- 笨?邉ｻ扈溯<E68988>閾ｪ蜉ｨ驥崎ｯ?- 笨?髞呵ｯｯ荳榊ｽｱ蜩榊<E89CA9>莉紋ｻｻ蜉｡謇ｧ陦?
*莉ｻ蜉｡10<EFBFBD>壼ｮ梧紛髣ｭ邇ｯ蜴句鴨豬玖ｯ包ｼ<EFBFBD>1蟆乗慮<EFBFBD>?
豬玖ｯ募<EFBFBD>螳ｹ<EFBFBD>?1. 霑樒ｻｭ蠖募<EFBFBD>豬玖ｯ<EFBFBD><EFBFBD>? - 蝨ｨREDCap荳ｭ霑樒ｻｭ蠖募<E8A096>?0譚｡謨ｰ謐? - 鬪瑚ｯ∵園譛蛾夂衍驛ｽ閭ｽ豁｣遑ｮ蜿鷹? - 鬪瑚ｯ∵ｲ｡譛蛾＠貍丞柱驥榊､? 2. 蟷ｶ蜿大ｯｹ隸晄ｵ玖ｯ<EFBFBD><EFBFBD>? - 蜷梧慮蜿鷹?荳ｪ譟･隸｢隸ｷ豎? - 鬪瑚ｯ∵園譛芽ｯｷ豎る<E8B18E>閭ｽ豁｣遑ｮ蜩榊ｺ? - 鬪瑚ｯ∝桃蠎疲慮髣ｴ<5遘? 3. **髟ｿ譌ｶ髣ｴ霑占｡梧ｵ玖ｯ?*<2A>? - 邉ｻ扈溯ｿ占｡<E58DA0>1蟆乗慮
- 譛滄龍髫乗惻蠖募<EFBFBD>謨ｰ謐ｮ蜥梧衍隸? - 鬪瑚ｯ∫ｳｻ扈溽ｨｳ螳壽? 鬪梧噺譬<EFBFBD>㊥<EFBFBD>?- 笨?霑樒ｻｭ蠖募<E8A096>豬玖ｯ暮夊ｿ<E5A48A>ｼ?0/10<31>?- 笨?蟷ｶ蜿大ｯｹ隸晄ｵ玖ｯ暮夊ｿ<E5A48A>ｼ?/5<>?- 笨?髟ｿ譌ｶ髣ｴ霑占｡梧裏蠑ょｸｸ
- 笨?蜀<>ｭ伜柱諤ｧ閭ｽ豁｣蟶ｸ
荳句壕<EFBFBD>壽枚譯｣郛門<EFBFBD><EFBFBD><EFBFBD>3蟆乗慮<EFBFBD>?
*莉ｻ蜉｡11<EFBFBD>壼<EFBFBD>蟒ｺ蠑蜿大ｮ梧<EFBFBD>譁<EFBFBD>｡｣<EFBFBD><EFBFBD>2蟆乗慮<EFBFBD>?
譁<EFBFBD>｡｣菴咲ｽｮ<EFBFBD>啻docs/03-荳壼苅讓｡蝮<EFBDA1>/IIT Manager Agent/06-蠑蜿題ｮｰ蠖?Day3-4-譛蟆舟VP髣ｭ邇ｯ螳梧<E89EB3>隶ｰ蠖<EFBDB0>.md`
譁<EFBFBD>｡｣蜀<EFBFBD>ｮｹ<EFBFBD>?1. 蠑蜿第ｦりｿ?2. 螳梧<E89EB3>逧<EFBFBD>粥閭ｽ讓｡蝮暦ｼ郁ｯｦ扈<EFBDA6>ｯｴ譏趣ｼ?3. 豬玖ｯ暮ｪ瑚ｯ∫ｻ捺棡 4. 諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD> 5. 驕<>芦逧<E88AA6>琉鬚倅ｸ手ｧ｣蜀ｳ譁ｹ譯<EFBDB9> 6. 髣ｭ邇ｯ謨域棡貍皮､ｺ 7. 荳倶ｸ豁･隶｡蛻?
*莉ｻ蜉｡12<EFBFBD>壽峩譁ｰ讓｡蝮礼憾諤∵枚譯｣<EFBFBD><EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?
譁<EFBFBD>｡｣菴咲ｽｮ<EFBFBD>啻docs/03-荳壼苅讓｡蝮<EFBDA1>/IIT Manager Agent/00-讓｡蝮怜ｽ灘燕迥ｶ諤∽ｸ主ｼ蜿第欠蜊?md`
譖ｴ譁ｰ蜀<EFBFBD>ｮｹ<EFBFBD>?- 譖ｴ譁ｰ謨ｴ菴灘ｮ梧<EFBDAE>蠎ｦ<E8A08E><EFBDA6>35% 竊?50%<25>?- 譖ｴ譁ｰ蟾ｲ螳梧<E89EB3>蜉溯<E89C89>蛻苓｡?- 譖ｴ譁ｰDay 3-4螳梧<E89EB3>諠<EFBFBD><E8ABA0>
- 譖ｴ譁ｰ荳倶ｸ豁･蟾･菴懆ｮ｡蛻?
*莉ｻ蜉｡13<EFBFBD>壼<EFBFBD>蟒ｺ菴ｿ逕ｨ謇句<EFBFBD><EFBFBD><EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?
譁<EFBFBD>｡｣菴咲ｽｮ<EFBFBD>啻docs/03-荳壼苅讓｡蝮<EFBDA1>/IIT Manager Agent/05-菴ｿ逕ｨ謇句<E8AC87>/莨∽ｸ壼ｾｮ菫｡蟇ｹ隸晄欠蜊<E6ACA0>.md`
譁<EFBFBD>｡｣蜀<EFBFBD>ｮｹ<EFBFBD>?1. 莨∽ｸ壼ｾｮ菫｡蠎皮畑驟咲ｽｮ 2. 逕ｨ謌ｷ螯ゆｽ募刈蜈･蠎皮畑 3. 謾ｯ謖∫噪蟇ｹ隸晄欠莉､蛻苓｡?4. 蟶ｸ隗<EFBDB8>琉鬚炉AQ 5. 謨<>囿謗呈衍謖<E8A18D>漉
笨?蝗帙．ay 4扈捺據譌ｶ逧<EFBDB6>溜邇ｯ謨域棡
4.1 螳梧紛髣ｭ邇ｯ鬪瑚ｯ<E7919A>
<EFBFBD>識 譛蟆舟VP髣ｭ邇ｯ螳悟<E89EB3>謇馴夲ｼ<E5A4B2>
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?Step 1: REDCap謨ｰ謐ｮ蠖募<E8A096> 笏?笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?逕ｨ謌ｷ蝨ｨREDCap荳ｭ<E88DB3><EFBDAD> 笏?笏?- 譁ｰ蠅樊ぅ閠<E38185>D 8 笏?笏?- 謌紋ｿｮ謾ｹ謔｣閠<EFBDA3>D 2 笏?笏披楳笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?0遘貞ｻｶ霑? 竊?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?Step 2: Node.js螳樊慮謐戊執 笏?笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?笨?DET隗ｦ蜿<EFBDA6> (0遘? 笏?笏?笨?Webhook謗･謾ｶ (<10ms) 笏?笏?笨?Worker螟<72>炊 (~2遘? 笏?笏披楳笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏? 竊?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?Step 3: 莨∽ｸ壼ｾｮ菫｡謗ｨ騾<EFBDA8>夂衍 笏?笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?笨?PI謾ｶ蛻ｰ蜊｡迚<EFBDA1>ｶ域<EFBDB6> (<5遘? 笏?笏?笨?騾夂衍蜀<E8A18D>ｮｹ<EFBDAE>? 笏?笏? "<22>投 test0102 - 謨ｰ謐ｮ蠖募<E8A096> 笏?笏? 蜿苓ｯ戊<E6888A>ｼ<EFBFBD>8 笏?笏? 謫堺ｽ懶ｼ壽眠蠅? 笏?笏? 蠖募<E8A096>8荳ｪ蟄玲ｮ? 笏?笏披楳笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏? 竊?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?Step 4: PI蝨ｨ莨∽ｸ壼ｾｮ菫｡荳ｭ蟇ｹ隸<EFBDB9> 笏?笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏?笨?蜿鷹<E9B7B9>ｼ<EFBFBD>"譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>? 笏?笏?笨?AI蝗槫､搾ｼ? 笏?笏? "<22>投 譛霑台ｸ蜻ｨ謨ｰ謐ｮ豎<EFBDAE>ｻ<C280><EFBDBB> 笏?笏? 譁ｰ蠅槫女隸戊<E6888A>ｼ<EFBFBD>2萓? 笏?笏? 謨ｰ謐ｮ譖ｴ譁ｰ<E8AD81>?谺? 笏?笏? 笏?笏?笨?蜿鷹<E9B7B9>ｼ<EFBFBD>"譟･隸｢謔｣閠?逧<>ュ蜀? 笏?笏?笨?AI蝗槫､搾ｼ壽ぅ閠<E38185>渕譛ｬ菫｡諱? 笏?笏? 笏?笏?笨?蜿鷹<E9B7B9>ｼ<EFBFBD>"鬘ｹ逶ｮ霑帛ｺｦ" 笏?笏?笨?AI蝗槫､搾ｼ夐｡ｹ逶ｮ扈溯ｮ｡謨ｰ謐? 笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?```
### 4.2 鬪梧噺譬<E599BA>㊥<EFBFBD>域怙扈茨ｼ<E88CA8>
**蜉溯<E89C89>螳梧紛諤?*<2A>?- 笨?REDCap謨ｰ謐ｮ螳樊慮逶大成<E5A4A7><E68890>ET + 霓ｮ隸｢<E99AB8>?- 笨?Node.js謨ｰ謐ｮ謐戊執荳主､<E4B8BB><EFBDA4>?- 笨?莨∽ｸ壼ｾｮ菫｡騾夂衍謗ｨ騾?- 笨?莨∽ｸ壼ｾｮ菫｡蟇ｹ隸晄衍隸｢
- 笨?螳｡隶｡譌･蠢怜ｮ梧紛隶ｰ蠖<EFBDB0>
**諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD>**<2A>?| 謖<><E8AC96><EFBFBD> | 逶ｮ譬<EFBDAE>?| 螳樣刔蛟?| 迥ｶ諤?|
|------|--------|--------|------|
| DET隗ｦ蜿大ｻｶ霑<EFBDB6> | <1遘?| 0遘?| 笨?|
| Webhook蜩榊ｺ疲慮髣ｴ | <100ms | <10ms | 笨?|
| 騾夂衍謗ｨ騾∝ｻｶ霑?| <10遘?| <5遘?| 笨?|
| 蟇ｹ隸晏桃蠎疲慮髣ｴ | <5遘?| ~3遘?| 笨?|
| 謨ｰ謐ｮ蜷梧ｭ･蜃<EFBDA5>｡ｮ諤?| 100% | 100% | 笨?|
**謚譛ｯ謖<EFBDAF><E8AC96>?*<2A>?- 笨?莉｣遐∫ｬｦ蜷亥屬髦溯ｧ<E6BAAF>激
- 笨?髞呵ｯｯ螟<EFBDAF>炊螳悟埋
- 笨?譌･蠢苓ｮｰ蠖募ｮ梧紛
- 笨?豬玖ｯ戊ｦ<E6888A>尠邇?90%
**蜿ｯ貍皮､ｺ諤?*<2A>?- 笨?蜿ｯ莉･邇ｰ蝨ｺ貍皮､ｺ螳梧紛髣ｭ邇ｯ
- 笨?蜿ｯ莉･貍皮､ｺ蟇ｹ隸晄衍隸｢蜉溯<E89C89>
- 笨?謨域棡譏取仞縲∽ｻｷ蛟ｼ貂<EFBDBC><E8B282>?
---
## <20>答 莠斐∵橿譛ｯ螳樒鴫扈<E9B4AB><E68988>?
### 5.1 莨∽ｸ壼ｾｮ菫｡蠑よｭ･蝗槫､肴ｨ｡蠑擾ｼ芋沐?Critical<61>?
#### 髣ｮ鬚俶緒霑ｰ
莨∽ｸ壼ｾｮ菫｡隕∵ｱり｢ｫ蜉ｨ蝗槫､肴ｶ域<EFBDB6>蠢<EFBFBD>｡ｻ蝨?*5遘貞<E98198>**螳梧<E89EB3>縲ょｦよ棡雜<E6A3A1>慮<EFBFBD>檎畑謌ｷ莨夂恚蛻?譛榊苅證よ慮荳榊庄逕?逧<>署遉ｺ縲?
#### 髞呵ｯｯ蛛壽ｳ<E5A3BD>
```typescript
笶?async handleCallback(request, reply) {
const message = parseMessage(request.body);
// 隹<>畑LLM<4C>亥庄閭ｽ閠玲慮10遘抵ｼ<E68AB5>
const answer = await classifyIntent(message);
const result = await queryData(answer);
// 雜<>慮莠<E685AE>ｼ∽ｼ∝ｾｮ蟾ｲ譁ｭ蠑霑樊磁
return reply.send(result);
}
豁｣遑ｮ蛛壽ｳ包ｼ壼ｼよｭ･蝗槫､肴ｨ｡蠑?```typescript
笨?async handleCallback(request, reply) { const message = parseMessage(request.body);
// 1. 遶句叉霑泌屓'success'<27>?1遘抵ｼ<E68AB5> reply.send('success');
// 2. 蠑よｭ･螟<EFBDA5>炊<EFBFBD>井ｸ埼仆蝪橸ｼ? setImmediate(async () => { // 蜿ｯ莉･諷｢諷｢邂暦ｼ<E69AA6>10遘偵?0遘帝<E98198>蜿ｯ莉･<E88E89>? const answer = await classifyIntent(message); const result = await queryData(answer);
// 3. 菴ｿ逕ｨ荳ｻ蜉ｨ謗ｨ騾∵磁蜿｣霑泌屓扈捺<E68988>? await wechatService.sendTextMessage(userId, result);
}); }
#### 蜈ｳ髞ｮ轤?1. 笨?**遶句叉霑泌屓**<2A>壽噺蛻ｰ豸域<E8B1B8>蜷<EFBFBD><1遘定ｿ泌<EFBDBF>?success'
2. 笨?**蠑よｭ･螟<EFBDA5>炊**<2A>壻ｽｿ逕ｨ`setImmediate`謌匁ｶ域<EFBDB6>髦溷<E9ABA6>?3. 笨?**荳ｻ蜉ｨ謗ｨ騾?*<2A>夊ｰ<E5A48A>畑蜿鷹∵ｶ域<EFBDB6>謗･蜿｣<E89CBF>瑚碁撼HTTP Response
4. 笨?**髞呵ｯｯ螟<EFBDAF>炊**<2A>壼ｼよｭ･莉ｻ蜉｡螟ｱ雍･譌ｶ<E8AD8C>梧耳騾∝暑螂ｽ髞呵ｯｯ謠千､?
---
### 5.2 莨∽ｸ壼ｾｮ菫｡XML蜉<4C>隗｣蟇<EFBDA3>ｼ芋沐･ Critical<61>?
#### 髣ｮ鬚俶緒霑ｰ
莨∽ｸ壼ｾｮ菫｡逧<EFBDA1>ｶ域<EFBDB6>菴捺<E88FB4>?*蜉<>蟇<EFBFBD>噪XML**<2A>御ｸ肴弍譏取枚縲よ<E7B8B2>ｼ蠑丞ｦゆｸ具ｼ<E585B7>
```xml
<xml>
<ToUserName><![CDATA[ww01cb7b72ea2db83c]]></ToUserName>
<Encrypt><![CDATA[蜉<>蟇<EFBFBD>噪豸域<E8B1B8>蜀<EFBFBD>ｮｹ]]></Encrypt>
</xml>
隗｣蟇<EFBFBD>ｵ∫ｨ<EFBFBD>
蜉<EFBFBD>蟇<EFBFBD>ML 竊?Base64隗｣遐<EFBDA3> 竊?AES隗｣蟇<EFBDA3> 竊?蜴ｻ髯､Padding 竊?鬪瑚ｯ，orpID 竊?譏取枚XML
髞呵ｯｯ蛛壽ｳ<EFBFBD>
笶?// 閾ｪ蟾ｱ螳樒鴫AES隗｣蟇<EFBDA3>ｼ域栫譏灘<E8AD8F>髞呻ｼ<E591BB>
function decrypt(encryptedData) {
// 謇句<E8AC87>AES縲￣adding縲。ase64...
// 99%逧<>ｺｺ驛ｽ莨壼<E88EA8>髞<EFBFBD>
}
豁｣遑ｮ蛛壽ｳ包ｼ壻ｽｿ逕ｨ螳俶婿蠎<EFBFBD>
npm install @wecom/crypto
笨?import { WXBizMsgCrypt } from '@wecom/crypto';
const crypt = new WXBizMsgCrypt(
process.env.WECHAT_TOKEN!, // 閾ｪ螳壻ｹ欝oken
process.env.WECHAT_ENCODING_AES_KEY!, // 莨∝ｾｮ蜷主床逕滓<E98095><E6BB93>?3菴搾ｼ<E690BE>
process.env.WECHAT_CORP_ID!
);
// 荳陦御ｻ｣遐∝ｮ梧<EFBDAE>隗｣蟇?const decryptedXml = crypt.decrypt(
msg_signature,
timestamp,
nonce,
encryptedXml
);
髴隕∫噪驟咲ｽｮ
| 驟咲ｽｮ鬘? | 譚･貅<EFBFBD> | 遉ｺ萓<EFBFBD> |
|---|---|---|
WECHAT_TOKEN |
閾ｪ螳壻ｹ? | 32菴埼囂譛ｺ蟄礼ｬｦ荳ｲ |
WECHAT_ENCODING_AES_KEY |
莨∝ｾｮ蜷主床逕滓<EFBFBD> | 43菴榊ｭ礼ｬｦ<EFBFBD>亥ｦゑｼ啾bcdefghijklmnopqrstuvwxyz0123456789ABC<EFBFBD>? |
WECHAT_CORP_ID |
莨∝ｾｮ蜷主床 | ww01cb7b72ea2db83c |
5.3 莨∽ｸ壼ｾｮ菫｡IP逋ｽ蜷榊黒<E6A68A>芋沐･ P0<50>?
髣ｮ鬚俶緒霑ｰ
闔ｷ蜿泡ccessToken譌ｶ<EFBFBD>御ｼ∽ｸ壼ｾｮ菫｡莨壽<EFBFBD>｡鬪瑚ｯｷ豎よ擂貅蝕P縲ょｦよ棡IP荳榊惠逋ｽ蜷榊黒荳ｭ<EFBFBD>御ｼ夊ｿ泌屓60020髞呵ｯｯ縲?
驟咲ｽｮ豁･鬪､
- 遑ｮ隶､SAE NAT鄂大<E98482>IP<49>啻182.92.176.14`
- 逋ｻ蠖穂ｼ∽ｸ壼ｾｮ菫｡邂｡逅<EFBFBD>錘蜿ｰ
- 蠎皮畑邂｡逅<EFBFBD> 竊?IIT Manager Agent
- 謇ｾ蛻ｰ"莨∽ｸ壼庄菫｡IP"驟咲ｽｮ
- 豺ｻ蜉<EFBFBD><EFBFBD>啻182.92.176.14`
- 菫晏ｭ伜ｹｶ豬玖ｯ?
鬪瑚ｯ∵婿豕<EFBFBD>
// 豬玖ｯ柊ccessToken闔ｷ蜿<EFBDB7>
const response = await fetch(
`https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${CORP_ID}&corpsecret=${SECRET}`
);
const data = await response.json();
if (data.errcode === 60020) {
console.error('笶?IP逋ｽ蜷榊黒譛ｪ驟咲ｽｮ<EFBDBD>?);
} else if (data.errcode === 0) {
console.log('笨?IP逋ｽ蜷榊黒驟咲ｽｮ豁｣遑?);
}
5.4 莨∽ｸ壼ｾｮ菫｡豸域<E8B1B8>譬ｼ蠑<EFBDBC>
譁<EFBFBD>悽豸域<EFBFBD>譬ｼ蠑<EFBFBD>
{
"touser": "GaoFeng",
"msgtype": "text",
"agentid": 1000002,
"text": {
"content": "霑呎弍荳譚｡譁<EFBDA1>悽豸域<E8B1B8>?
}
}
蜊｡迚<EFBFBD>ｶ域<EFBFBD>譬ｼ蠑<EFBFBD>
{
"touser": "GaoFeng",
"msgtype": "textcard",
"agentid": 1000002,
"textcard": {
"title": "<22>投 test0102 - 謨ｰ謐ｮ蠖募<E8A096>",
"description": "<div>蜿苓ｯ戊<E6888A>ｼ<EFBFBD>8</div><div>謫堺ｽ懶ｼ壽眠蠅?/div><div>蠖募<E8A096>8荳ｪ蟄玲ｮ?/div>",
"url": "https://iit.xunzhengyixue.com/chat",
"btntxt": "譟･逵玖ｯｦ諠<EFBDA6>"
}
}
5.5 莨∽ｸ壼ｾｮ菫｡蝗櫁ｰ<E6AB81>ｶ域<EFBDB6>譬ｼ蠑<EFBDBC>
逕ｨ謌ｷ譁<EFBFBD>悽豸域<EFBFBD><EFBFBD><EFBFBD>ML譬ｼ蠑擾ｼ?```xml
1641024000 1234567890 1000002 ```蝗槫､肴ｶ域<EFBFBD>譬ｼ蠑擾ｼ<EFBFBD>ML譬ｼ蠑擾ｼ?```xml
1641024001 ```5.6 莨∽ｸ壼ｾｮ菫｡遲ｾ蜷埼ｪ瑚ｯ<E7919A>
function verifySignature(signature: string, timestamp: string, nonce: string, echostr: string): boolean {
const token = WECHAT_TOKEN; // 莨∽ｸ壼ｾｮ菫｡驟咲ｽｮ逧Уoken
const tmpArr = [token, timestamp, nonce, echostr].sort();
const tmpStr = tmpArr.join('');
const sha1 = crypto.createHash('sha1');
sha1.update(tmpStr);
const calculatedSignature = sha1.digest('hex');
return calculatedSignature === signature;
}
<EFBFBD>識 蜈ｭ縲∽ｸ倶ｸ豁･謇ｩ螻墓婿蜷托ｼ<E68998>hase 1.5+<2B>?
Phase 1.5<EFBFBD>壽焚謐ｮ雍ｨ謗ｧ隗<EFBFBD><EFBFBD>逕滓<EFBFBD><EFBFBD><EFBFBD>1-2螟ｩ<E89E9F><EFBDA9>
逶ｮ譬<EFBFBD><EFBFBD>壼ｮ樒鴫蝓ｺ莠手ｧ<EFBFBD><EFBFBD>逧<EFBFBD>焚謐ｮ雍ｨ謗ｧ
譬ｸ蠢<EFBFBD>粥閭ｽ<EFBFBD>?1. 荳贋ｼ<E8B48B>遐皮ｩｶ譁ｹ譯<EFBDB9>DF 2. AI閾ｪ蜉ｨ謠仙叙雍ｨ謗ｧ隗<EFBDA7><E99A97> 3. 隗<><E99A97>蠎鍋ｮ｡逅<EFBDA1>ｼ亥庄郛冶ｾ代∝庄螳｡譬ｸ<E8ADAC>?4. 蝓ｺ莠手ｧ<E6898B><EFBDA7>霑幄｡梧焚謐ｮ雍ｨ謗ｧ 5. 雍ｨ謗ｧ扈捺棡謗ｨ騾∝芦莨∽ｸ壼ｾｮ菫｡
**謚譛ｯ譁ｹ譯?*<2A>?- 菴ｿ逕ｨ螟ｧ讓｡蝙区署蜿冶ｧ<E586B6><EFBDA7><EFBFBD>磯撼螳樊慮隹<E685AE>畑<EFBFBD><E79591>
- 隗<EFBFBD><EFBFBD>菫晏ｭ伜芦謨ｰ謐ｮ蠎難ｼ<EFBFBD>quality_rules`陦ｨ<E999A6><EFBDA8>
- 蠖募<EFBFBD>譌ｶ蝓ｺ莠手ｧ<EFBFBD><EFBFBD>蛻､譁ｭ<EFBFBD>亥ｿｫ騾溘∝庄髱<EFBFBD><EFBFBD><EFBFBD>
- 隸∵紺體ｾ霑ｽ貅ｯ<EFBFBD>郁ｧ<EFBFBD><EFBFBD>譚･貅蝉ｺ取婿譯育ｬｬX鬘ｵ隨ｬY譚｡<EFBFBD><EFBFBD>
Phase 2<>啀C Workbench蜑咲ｫｯ<EFBDAB>?-3螟ｩ<E89E9F><EFBDA9>
逶ｮ譬<EFBFBD><EFBFBD>壽署萓娶eb遶ｯ螟肴<EFBFBD>ｸ逡碁<EFBFBD>? 譬ｸ蠢<EFBFBD>粥閭ｽ<EFBFBD>?1. 雍ｨ謗ｧ蟒ｺ隶ｮ蛻苓｡ｨ 2. 蠖灘燕謨ｰ謐ｮ vs AI蟒ｺ隶ｮ蟇ｹ豈<EFBDB9> 3. 隸∵紺體ｾ螻慕､ｺ<EFBDA4><EFBDBA>DF鬮倅ｺｮ<EFBDBA>?4. 螳｡謇ｹ謫堺ｽ懶ｼ育｡ｮ隶?諡堤ｻ晢ｼ?5. REDCap謨ｰ謐ｮ蝗槫<E89D97>
Phase 3<>壽匱閭ｽ蛹匁ｼ碑ｿ幢ｼ磯柄譛滂ｼ<E6BB82>
蜉溯<EFBFBD>謇ｩ螻<EFBFBD><EFBFBD>?1. 螟夊ｽｮ蟇ｹ隸晁<E99AB8>蜉<EFBFBD> 2. 荳贋ｸ区枚逅<E69E9A>ｧ?3. 莉ｻ蜉｡鬩ｱ蜉ｨ蠑墓梼 4. 謔｣閠<EFBDA3>囂隶ｿAgent 5. 譎ｺ閭ｽ豎<EFBDBD>冠Agent
<EFBFBD>搭 荳<>∵｣譟･貂<EFBDA5><E8B282>?
Day 3蠑蟋句燕
- 莨∽ｸ壼ｾｮ菫｡UserID遑ｮ隶､<EFBFBD>育畑莠取ｵ玖ｯ包ｼ<EFBFBD>
- 莨∽ｸ壼ｾｮ菫｡蝗櫁ｰザRL驟咲ｽｮ<EFBFBD>亥惠莨∽ｸ壼ｾｮ菫｡邂｡逅<EFBFBD>錘蜿ｰ<EFBFBD>?- [ ] REDCap豬玖ｯ墓焚謐ｮ蜃<EFBDAE>､<EFBFBD>ｼ郁<EFBDBC>蟆?譚｡<E8AD9A><EFBDA1>
- 蜷守ｫｯ譛榊苅霑占｡梧ｭ｣蟶ｸ
Day 3扈捺據譌?- [ ] WechatService蠑蜿大ｮ梧<EFBDAE>?- [ ] iit_quality_check Worker螳悟埋
- 莨∽ｸ壼ｾｮ菫｡謗ｨ騾∵ｵ玖ｯ暮夊ｿ<EFBFBD>
- 遶ｯ蛻ｰ遶ｯ髣ｭ邇ｯ謇馴夲ｼ<EFBFBD>EDCap 竊?莨∝ｾｮ<EFBDBE>?
Day 4扈捺據譌?- [ ] WechatCallbackController蠑蜿大ｮ梧<EFBDAE>?- [ ] 莨∽ｸ壼ｾｮ菫｡蟇ｹ隸晏粥閭ｽ豬玖ｯ暮夊ｿ<E5A48A>
- 螳梧紛髣ｭ邇ｯ蜴句鴨豬玖ｯ暮夊ｿ<EFBFBD>
- 譁<EFBFBD>｡｣蜈ｨ驛ｨ譖ｴ譁ｰ螳梧<EFBFBD>
- 莉｣遐∵署莠､蛻ｰGit
<EFBFBD>至 蜈ｫ縲∵<E7B8B2>蜉滓<E89C89><E6BB93><EFBFBD>?
**MVP謌仙粥逧<E7B2A5><E980A7><EFBFBD>ｿ?*<2A>?1. 笨?PI蜿ｯ莉･蝨ｨ莨∽ｸ壼ｾｮ菫｡荳ｭ螳樊慮謾ｶ蛻ｰ謨ｰ謐ｮ蠖募<E8A096>騾夂衍 2. 笨?PI蜿ｯ莉･蝨ｨ莨∽ｸ壼ｾｮ菫｡荳ｭ譟･隸｢鬘ｹ逶ｮ謨ｰ謐ｮ 3. 笨?螳梧紛髣ｭ邇ｯ<E98287><EFBDAF>EDCap 竊?Node.js 竊?莨∝ｾｮ<EFBDBE>臥ｨｳ螳夊ｿ占｡?4. 笨?蜩榊ｺ疲慮髣ｴ貊｡雜ｳ隕∵ｱゑｼ?5遘抵ｼ<E68AB5> 5. 笨?蜿ｯ莉･邇ｰ蝨ｺ貍皮､ｺ扈吝屬髦溽恚
**莉ｷ蛟ｼ鬪瑚ｯ?*<2A>?- 笨?PI荳咲畑豈丞､ｩ逋ｻ蠖紐EDCap譟･逵玖ｿ帛ｺｦ
- 笨?謨ｰ謐ｮ蠖募<E8A096>蜷守ｫ句叉遏･譎難ｼ御ｸ堺ｼ夐＠貍<EFBCA0>
- 笨?髫乗慮髫丞慍蜿ｯ莉･譟･隸｢謨ｰ謐ｮ<E8AC90>域焔譛ｺ遶ｯ<E981B6>?- 笨?荳ｺ蜷守ｻｭ蜉溯<E89C89>謇ｩ螻墓遠荳句渕遑
**譁<>｡｣扈ｴ謚､閠?<EFBFBD>壼ｼ蜿大屬髦?
**譛蜷取峩譁?<EFBFBD>?026-01-02
**迥ｶ諤?*<2A>夸沒?蠑蜿題ｮ｡蛻抵ｼ亥ｾ<E4BAA5>鴬陦鯉ｼ<E9AF89>