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%)
173 lines
4.9 KiB
Markdown
173 lines
4.9 KiB
Markdown
# 04-寮€鍙戣<E98D99>鑼?
|
||
> **鐩<>爣锛?* 缁熶竴鍥㈤槦寮€鍙戣<E98D99>鑼冿紝鎻愰珮浠ｇ爜璐ㄩ噺鍜屽崗浣滄晥鐜?
|
||
> **閫傜敤鑼冨洿锛?* 骞冲彴灞?+ 鑳藉姏灞?+ 涓氬姟妯″潡灞?
|
||
> **寮哄埗绛夌骇锛?* 猸愨瓙猸愨瓙猸?蹇呴』閬靛畧
|
||
|
||
---
|
||
|
||
## 馃搵 瑙勮寖鏂囨。鍒楄〃
|
||
|
||
### 1. 鏁版嵁搴撹<E690B4>璁¤<E79281>鑼?猸愨瓙猸愨瓙猸?**鏂囦欢锛?* `01-鏁版嵁搴撹<E690B4>璁¤<E79281>鑼?md` 鈴?寰呭垱寤猴紙浠?`01-璁捐<E79281>鏂囨。/鏁版嵁搴撹<E690B4>璁℃枃妗?md` 鎻愬彇锛?
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- Schema闅旂<E99785>绛栫暐锛坧latform_schema銆乤sl_schema绛夛級
|
||
- 琛ㄥ懡鍚嶈<E98D9A>鑼冿紙灏忓啓+涓嬪垝绾匡級
|
||
- 瀛楁<E7809B>鍛藉悕瑙勮寖
|
||
- 绱㈠紩璁捐<E79281>瑙勮寖
|
||
- 澶栭敭绾︽潫瑙勮寖
|
||
- 閫氱敤瀛楁<E7809B>锛坈reated_at銆乽pdated_at绛夛級
|
||
|
||
**蹇<>€熷弬鑰冿細** [鏁版嵁搴撳叏灞€瑙嗗浘](./03-鏁版嵁搴撳叏灞€瑙嗗浘.md) 猸?宸插垱寤?
|
||
---
|
||
|
||
### 2. API璁捐<E79281>瑙勮寖 猸愨瓙猸愨瓙猸?**鏂囦欢锛?* `02-API璁捐<E79281>瑙勮寖.md` 鈴?寰呭垱寤猴紙浠?`01-璁捐<E79281>鏂囨。/API璁捐<E79281>瑙勮寖.md` 鎻愬彇锛?
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- RESTful API璁捐<E79281>鍘熷垯
|
||
- URL鍛藉悕瑙勮寖锛坄/api/v1/妯″潡/璧勬簮`锛?- HTTP鏂规硶浣跨敤瑙勮寖
|
||
- 璇锋眰/鍝嶅簲鏍煎紡瑙勮寖
|
||
- 閿欒<E996BF>鐮佽<E990AE>璁?- 璁よ瘉鍜屾潈闄?
|
||
**蹇<>€熷弬鑰冿細** [API璺<EFBFBD>敱鎬昏<EFBFBD>](./04-API璺<49>敱鎬昏<E98EAC>.md) 猸?宸插垱寤?
|
||
---
|
||
|
||
### 3. 鏁版嵁搴撳叏灞€瑙嗗浘 猸愨瓙猸愨瓙猸?鉁?鏂板<E98F82>
|
||
**鏂囦欢锛?* `03-鏁版嵁搴撳叏灞€瑙嗗浘.md`
|
||
|
||
**鐢ㄩ€旓細** 鎻愪緵鎵€鏈塖chema鍜岃〃鐨勫揩閫熺储寮?
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- Schema鍒掑垎绛栫暐锛?涓猄chema锛?- 鎵€鏈夎〃鐨勬€昏<E282AC>鍜岃烦杞<E783A6>摼鎺?- 璺⊿chema渚濊禆鍏崇郴
|
||
- 鏁版嵁閲忛<E996B2>浼?
|
||
**浣跨敤鍦烘櫙锛?*
|
||
- 鏌ョ湅鍏ㄥ眬鏁版嵁鏋舵瀯
|
||
- 蹇<>€熷畾浣嶆煇涓<E78587>〃灞炰簬鍝<E7B0AC>釜Schema
|
||
- 浜嗚В璺ㄦā鍧楁暟鎹<E69A9F>叧绯?
|
||
---
|
||
|
||
### 4. API璺<49>敱鎬昏<E98EAC> 猸愨瓙猸愨瓙猸?鉁?鏂板<E98F82>
|
||
**鏂囦欢锛?* `04-API璺<49>敱鎬昏<E98EAC>.md`
|
||
|
||
**鐢ㄩ€旓細** 鎻愪緵鎵€鏈堿PI绔<49>偣鐨勫揩閫熺储寮?
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- 璺<>敱鍛藉悕瑙勮寖
|
||
- 鎵€鏈夋ā鍧楃殑API绔<49>偣鎬昏<E98EAC>
|
||
- 璺<>敱鍐茬獊妫€鏌?- 绔<>偣缁熻<E7BC81>锛垀85涓<35>級
|
||
|
||
**浣跨敤鍦烘櫙锛?*
|
||
- 鏌ョ湅鍏ㄥ眬API鏋舵瀯
|
||
- 閬垮厤璺<E58EA4>敱鍐茬獊
|
||
- 蹇<>€熸煡鎵炬煇涓<E78587>姛鑳界殑API绔<49>偣
|
||
|
||
---
|
||
|
||
### 5. 浠ｇ爜瑙勮寖 猸愨瓙猸愨瓙
|
||
**鏂囦欢锛?* `05-浠ｇ爜瑙勮寖.md` 鈫?閲嶅懡鍚嶈嚜 `浠ｇ爜瑙勮寖.md`锛堝凡瀛樺湪锛?18琛岋級
|
||
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- TypeScript缂栫爜瑙勮寖
|
||
- React缁勪欢瑙勮寖
|
||
- 鏂囦欢鍜岀洰褰曞懡鍚?- 浠ｇ爜娉ㄩ噴瑙勮寖
|
||
- 閿欒<E996BF>澶勭悊瑙勮寖
|
||
- 鏃ュ織璁板綍瑙勮寖
|
||
|
||
**宸叉湁鍐呭<E98D90>锛屽寘鍚<E5AF98>細**
|
||
- ESLint閰嶇疆
|
||
- Prettier閰嶇疆
|
||
- 璇︾粏鐨勭紪鐮佽<E990AE>鑼?
|
||
---
|
||
|
||
### 6. Git鎻愪氦瑙勮寖 猸愨瓙猸愨瓙猸?鉁?宸插畬鎴?**鏂囦欢锛?* `06-Git鎻愪氦瑙勮寖.md`
|
||
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- 杩滅▼浠撳簱閰嶇疆锛圙itee锛?- Commit Message鏍煎紡瑙勮寖
|
||
- 鍒嗘敮绠＄悊绛栫暐
|
||
- 涓<>枃缂栫爜闂<E7889C><E99782>瑙ｅ喅鏂规<E98F82> 猸?閲嶈<E996B2>
|
||
- Git鍘嗗彶閲嶅啓涓庣淮鎶?- PR/MR瑙勮寖鍜屼唬鐮佸<E990AE>鏌ユ祦绋?- 甯歌<E794AF>闂<EFBFBD><E99782>涓庢渶浣冲疄璺?
|
||
**鍖呭惈瀹炵敤宸ュ叿锛?*
|
||
- `fix-git-commit-messages.ps1` 鑴氭湰浣跨敤璇存槑
|
||
- Git 鍒<>悕閰嶇疆
|
||
- 涓<>枃涔辩爜淇<E7889C><E6B787>瀹屾暣娴佺▼
|
||
|
||
**蹇<>€熷弬鑰冿細**
|
||
```
|
||
<type>(<scope>): <subject>
|
||
|
||
feat: 鏂板姛鑳? fix: Bug淇<67><E6B787> docs: 鏂囨。
|
||
style: 鏍煎紡 refactor: 閲嶆瀯 perf: 浼樺寲
|
||
test: 娴嬭瘯 chore: 鏋勫缓 ci: CI/CD
|
||
```
|
||
|
||
---
|
||
|
||
### 7. 娴嬭瘯瑙勮寖 猸愨瓙猸?**鏂囦欢锛?* `07-娴嬭瘯瑙勮寖.md` 鈴?寰呭垱寤?
|
||
**鏍稿績鍐呭<E98D90>锛?*
|
||
- 鍗曞厓娴嬭瘯瑙勮寖
|
||
- 闆嗘垚娴嬭瘯瑙勮寖
|
||
- E2E娴嬭瘯瑙勮寖
|
||
- 娴嬭瘯瑕嗙洊鐜囪<E9909C>姹?
|
||
**娴嬭瘯瑕嗙洊鐜囪<E9909C>姹傦細**
|
||
- 鏍稿績涓氬姟閫昏緫锛氣墺80%
|
||
- 宸ュ叿鍑芥暟锛氣墺90%
|
||
- API Controller锛氣墺70%
|
||
|
||
---
|
||
|
||
## 馃幆 瑙勮寖浼樺厛绾?
|
||
### P0 - 蹇呴』閬靛畧
|
||
- 鉁?鏁版嵁搴撹<E690B4>璁¤<E79281>鑼?- 鉁?API璁捐<E79281>瑙勮寖
|
||
- 鉁?Git鎻愪氦瑙勮寖锛圕ommit Message锛?
|
||
### P1 - 寮虹儓寤鸿<E5AFA4>
|
||
- 鉁?浠ｇ爜瑙勮寖锛圱ypeScript/React锛?- 鉁?閿欒<E996BF>澶勭悊瑙勮寖
|
||
- 鉁?鏃ュ織璁板綍瑙勮寖
|
||
|
||
### P2 - 寤鸿<E5AFA4>閬靛畧
|
||
- 鈿?娴嬭瘯瑙勮寖
|
||
- 鈿?鏂囨。娉ㄩ噴瑙勮寖
|
||
- 鈿?鎬ц兘浼樺寲瑙勮寖
|
||
|
||
---
|
||
|
||
## 馃攳 蹇<>€熸煡鎵?
|
||
**鎴戣<E98EB4>璁捐<E79281>鏁版嵁搴撹〃锛?* 鈫?`01-鏁版嵁搴撹<E690B4>璁¤<E79281>鑼?md`
|
||
**鎴戣<E98EB4>璁捐<E79281>API鎺ュ彛锛?* 鈫?`02-API璁捐<E79281>瑙勮寖.md`
|
||
**鎴戣<E98EB4>鏌ョ湅鍏ㄥ眬鏁版嵁鏋舵瀯锛?* 鈫?`03-鏁版嵁搴撳叏灞€瑙嗗浘.md` 鉁?
|
||
**鎴戣<E98EB4>鏌ョ湅鍏ㄥ眬API璺<49>敱锛?* 鈫?`04-API璺<49>敱鎬昏<E98EAC>.md` 鉁?
|
||
**鎴戣<E98EB4>缂栧啓浠ｇ爜锛?* 鈫?`05-浠ｇ爜瑙勮寖.md` 鉁?
|
||
**鎴戣<E98EB4>鎻愪氦浠ｇ爜锛?* 鈫?`06-Git鎻愪氦瑙勮寖.md` 鉁?
|
||
**鎴戣<E98EB4>瑙ｅ喅涓<E59685>枃涔辩爜锛?* 鈫?`06-Git鎻愪氦瑙勮寖.md` (绗?鑺? 鉁?
|
||
**鎴戣<E98EB4>閰嶇疆杩滅▼浠撳簱锛?* 鈫?`06-Git鎻愪氦瑙勮寖.md` (绗?鑺? 鉁?
|
||
**鎴戣<E98EB4>缂栧啓娴嬭瘯锛?* 鈫?`07-娴嬭瘯瑙勮寖.md`
|
||
|
||
---
|
||
|
||
## 鈿狅笍 杩濆弽瑙勮寖鐨勫悗鏋?
|
||
### 鏁版嵁搴撹<E690B4>璁′笉瑙勮寖
|
||
- 鉂?Schema娣蜂贡锛屾ā鍧楄€﹀悎
|
||
- 鉂?鏃犳硶瀹炵幇妯″潡鐙<E6BDA1>珛閮ㄧ讲
|
||
- 鉂?鏁版嵁杩佺Щ鍥伴毦
|
||
|
||
### API璁捐<E79281>涓嶈<E6B693>鑼?- 鉂?鍓嶅悗绔<E68297><E7BB94>鎺ュ洶闅?- 鉂?API鏂囨。娣蜂贡
|
||
- 鉂?鐗堟湰鍗囩骇鍥伴毦
|
||
|
||
### 浠ｇ爜涓嶈<E6B693>鑼?- 鉂?浠ｇ爜鍙<E7889C><E98D99>鎬у樊
|
||
- 鉂?缁存姢鎴愭湰楂?- 鉂?Bug鐜囦笂鍗?
|
||
---
|
||
|
||
## 馃摑 瑙勮寖鏇存柊娴佺▼
|
||
|
||
1. 鎻愬嚭瑙勮寖鍙樻洿闇€姹傦紙Issue鎴朠R锛?2. 鍥㈤槦璁ㄨ<E79281>鍜岃瘎瀹?3. 鏇存柊瑙勮寖鏂囨。
|
||
4. 閫氱煡鍏ㄥ憳
|
||
5. 閫愭<E996AB>杩佺Щ鏃т唬鐮?
|
||
---
|
||
|
||
## 馃敆 鐩稿叧宸ュ叿
|
||
|
||
**浠ｇ爜妫€鏌ワ細**
|
||
- ESLint锛圝avaScript/TypeScript锛?- Prettier锛堜唬鐮佹牸寮忓寲锛?- Stylelint锛圕SS锛?
|
||
**鎻愪氦妫€鏌ワ細**
|
||
- Husky锛圙it Hooks锛?- Commitlint锛圕ommit Message妫€鏌ワ級
|
||
|
||
**鏁版嵁搴擄細**
|
||
- Prisma锛圤RM + Migration锛?- pgAdmin锛堟暟鎹<E69A9F>簱绠＄悊锛?
|
||
---
|
||
|
||
**鏈€鍚庢洿鏂帮細** 2025-11-06
|
||
**缁存姢浜猴細** 鎶€鏈<E282AC>灦鏋勫笀
|