Files

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

19 KiB

Raw Blame History

蟷ｳ蜿ｰ蜑咲ｫｯ諤ｻ菴捺楔譫<EFBFBD>ｮｾ隶｡

*譁<EFBFBD>｡｣迚域悽<EFBFBD>? v1.0
*蛻帛ｻｺ譌･譛滂ｼ? 2025-10-29
扈ｴ謚､閠<EFBFBD>ｼ<EFBFBD> 蜑咲ｫｯ蠑蜿大屬髦? 譛蜷取峩譁ｰ<EFBFBD><EFBFBD> 2025-10-29

<EFBFBD>搭譁<>｡｣隸ｴ譏<EFBDB4>

譛ｬ譁<EFBFBD>｡｣譏ｯ**蟷ｳ蜿ｰ郤ｧ蜑咲ｫｯ譫ｶ譫<EFBDB6>ｮｾ隶?*<2A>梧ｶｵ逶匁紛荳ｪAI遘醍<E98198>泌ｹｳ蜿ｰ逧<EFBDB0>燕遶ｯ譫ｶ譫<EFBDB6>ｼ悟桁諡ｬ<E8ABA1>?

扈滉ｸ逧<EFBFBD>｡ｶ驛ｨ蟇ｼ闊ｪ隶ｾ隶?
讓｡蝮怜喧譫ｶ譫<EFBFBD>ｮｾ隶?
霍ｯ逕ｱ隶ｾ隶｡
譚<EFBFBD>剞謗ｧ蛻ｶ邉ｻ扈滂ｼ?迚域悽驟咲ｽｮ螳悟<EFBFBD>蜿ｯ隹<EFBFBD><EFBFBD>?<EFBFBD>?
讓｡蝮礼峡遶区ｧ隶ｾ隶｡<EFBFBD>域髪謖∵悴譚･迢ｬ遶句<EFBFBD>諡<EFBFBD>ｼ?

*豕ｨ諢擾ｼ? 譛ｬ譁<EFBDAC>｡｣譏ｯ蟷ｳ蜿ｰ郤ｧ隶ｾ隶｡<E99AB6>悟推讓｡蝮礼噪隸ｦ扈<EFBDA6>楔譫<E6A594>ｮｾ隶｡隸ｷ蜿り<E3828A>推讓｡蝮礼噪荳灘ｱ樊枚譯｣縲?

驥崎ｦ∵署遉ｺ<EFBFBD>? 譛ｬ譁<EFBDAC>｡｣荳ｭ豸牙所逧<E68980>沿譛ｬ譚<EFBDAC>剞蛻<E5899E><E89BBB><EFBFBD>亥渕遑迚医<E58CBB>ｫ倡ｺｧ迚医∵覧闊ｰ迚育噪讓｡蝮怜<E89DAE>驟搾ｼ牙插荳ｺ蛻晏ｧ区婿譯<EFBFBD>*<2A>悟庄莉･譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBDB6>紛<EFBFBD>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代よ耳闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ縲?

<EFBFBD>識隶ｾ隶｡蜴溷<E89CB4>

1. 讓｡蝮怜喧隶ｾ隶?

豈丈ｸｪ蜉溯<EFBFBD>讓｡蝮礼峡遶句ｼ蜿代∫峡遶矩Κ鄂?
讓｡蝮鈴龍譌<EFBFBD>萓晁ｵ門<EFBFBD>邉ｻ<EFBFBD>悟庄迢ｬ遶玖ｿ占｡<EFBFBD>
謾ｯ謖∵ｨ｡蝮礼峡遶倶ｺｧ蜩∝喧<EFBFBD>亥ｦ<EFBFBD>I譎ｺ閭ｽ譁<EFBFBD>鍵迢ｬ遶句醗蜊厄ｼ?

2. 譚<>剞謗ｧ蛻ｶ隶ｾ隶｡

蝓ｺ莠守畑謌ｷ迚域悽逧<EFBFBD>揀髯先而蛻?
轣ｵ豢ｻ逧<EFBFBD>粥閭ｽ讓｡蝮怜ｼ蜈ｳ譛ｺ蛻?
謾ｯ謖∵悴譚･蝠<EFBFBD>ｸ壽ｨ｡蠑乗挙螻包ｼ亥渕遑迚医<EFBFBD>ｫ倡ｺｧ迚医∵覧闊ｰ迚茨ｼ?

3. 蜿ｯ謇ｩ螻墓ｧ隶ｾ隶?

鬚<EFBFBD>蕗譁ｰ讓｡蝮玲磁蜈･謗･蜿?
謠剃ｻｶ蛹也噪讓｡蝮怜刈霓ｽ譛ｺ蛻ｶ
驟咲ｽｮ鬩ｱ蜉ｨ逧<EFBFBD>粥閭ｽ蠑蜈?

4. 荳閾ｴ諤ｧ隶ｾ隶?

扈滉ｸ逧ФI/UX隗<58>激
扈滉ｸ逧<EFBFBD>ｺ､莠呈ｨ｡蠑?
扈滉ｸ逧<EFBFBD>憾諤∫ｮ｡逅?

<EFBFBD>ｧｭ鬘ｶ驛ｨ蟇ｼ闊ｪ隶ｾ隶｡

蟇ｼ闊ｪ扈捺桷

笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
笏?Logo  [AI髣ｮ遲脳 [AI譎ｺ閭ｽ譁<EFBDBD>鍵] [遏･隸<EFBDA5>ｺ転 [譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ余 [譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵] [扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ]  [逕ｨ謌ｷ蜷?笆ｼ] 笏?
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?

蟇ｼ闊ｪ鬘ｹ隸ｦ諠?

菴咲ｽｮ	荳ｭ譁<EFBFBD>錐遘ｰ	闍ｱ譁<EFBFBD><EFBFBD><EFBFBD>ｯ<EFBFBD>	霍ｯ逕ｱ霍ｯ蠕<EFBFBD>	蠑蜿醍憾諤?	譚<EFBFBD>剞隕∵ｱゑｼ亥<EFBFBD>蟋矩<EFBFBD>鄂ｮ<EFBFBD><EFBFBD>
1	AI髣ｮ遲<EFBFBD>	`ai-qa`	`/ai-qa`	笨?蟾ｲ蠑蜿?	蝓ｺ遑迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
2	AI譎ｺ閭ｽ譁<EFBFBD>鍵	`literature-platform`	`/literature`	<EFBFBD>圦蠕<>ｼ蜿?	鬮倡ｺｧ迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
3	遏･隸<EFBFBD>ｺ?	`knowledge-base`	`/knowledge-base`	笨?蟾ｲ蠑蜿?	蝓ｺ遑迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
4	譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBFBD>ｴ<EFBFBD>	`data-cleaning`	`/data-cleaning`	<EFBFBD>搭蜊<>菴<EFBFBD>	鬮倡ｺｧ迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
5	譎ｺ閭ｽ扈溯ｮ｡蛻<EFBFBD>梵	`statistical-analysis`	`/intelligent-analysis`	笨?蟾ｲ蠑蜿托ｼ<E68998>ava蝗｢髦滂ｼ?	譌苓芦迚?笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
6	扈溯ｮ｡蛻<EFBFBD>梵蟾･蜈ｷ	`statistical-tools`	`/statistical-tools`	笨?蟾ｲ蠑蜿托ｼ<E68998>ava蝗｢髦滂ｼ?	譌苓芦迚?笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?
譛蜿ｳ萓ｧ	荳ｪ莠ｺ荳ｭ蠢<EFBFBD>	`user-center`	`/user/*`	笨?蟾ｲ蠑蜿?	謇譛臥畑謌?

隸ｴ譏趣ｼ? 譚<>剞隕∵ｱょ<EFBDB1>荳ｭ逧?蝓ｺ遑迚?"縲?鬮倡ｺｧ迚?"縲?譌苓芦迚?荳?蛻晏ｧ矩<EFBFBD>鄂ｮ<EFBFBD>悟庄譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBFBD>紛<EFBFBD>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBFBD>ｻ霎代よ耳闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ縲?

霍ｯ逕ｱ霍ｯ蠕<EFBFBD>ｮｾ隶｡

// 荳ｻ霍ｯ逕ｱ扈捺<E68988>?
const routes = {
  // 讓｡蝮苓ｷｯ逕ｱ
  '/ai-qa': 'AI髣ｮ遲疲ｨ｡蝮<EFBDA1>',
  '/literature': 'AI譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮<EFBDA1>',
  '/knowledge-base': '遏･隸<EFBDA5>ｺ捺ｨ｡蝮?,
  '/data-cleaning': '譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBFBD>ｴ玲ｨ｡蝮暦ｼ亥頃菴搾ｼ<EFBFBD>',
  '/intelligent-analysis': '譎ｺ閭ｽ扈溯ｮ｡蛻<EFBFBD>梵讓｡蝮暦ｼ<EFBFBD>ava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBFBD><EFBFBD><EFBFBD>?,
  '/statistical-tools': '扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ讓｡蝮暦ｼ<E69AA6>ava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBDAA><E9ABAE><EFBFBD>?,
  
  // 逕ｨ謌ｷ逶ｸ蜈ｳ
  '/user/profile': '荳ｪ莠ｺ荳ｭ蠢<EFBFBD> - 荳ｪ莠ｺ襍<EFBFBD>侭',
  '/user/settings': '荳ｪ莠ｺ荳ｭ蠢<EFBFBD> - 隶ｾ鄂ｮ',
  '/user/history': '荳ｪ莠ｺ荳ｭ蠢<EFBFBD> - 蜴<EFBFBD>彰隶ｰ蠖<EFBFBD>',
  '/user/subscription': '荳ｪ莠ｺ荳ｭ蠢<EFBFBD> - 隶｢髦<EFBFBD>ｮ｡逅<EFBFBD>',
};

<EFBFBD>女<EFBFBD>?謨ｴ菴捺楔譫<E6A594>ｮｾ隶｡

譫ｶ譫<EFBFBD>ｱよｬ｡蝗?

笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
笏?                   蠎皮畑螻?(Application)                       笏?
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏?     笏?
笏? 笏?AI髣ｮ遲<EFBDAE>   笏?笏<>I譎ｺ閭ｽ譁<EFBDBD>鍵笏?笏?遏･隸<EFBDA5>ｺ?  笏?笏?蜈ｶ莉匁ｨ｡蝮<EFBDA1> 笏?     笏?
笏? 笏?Module   笏?笏?Module   笏?笏?Module   笏?笏?Module   笏?     笏?
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏?     笏?
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
                        竊?
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
笏?                  譯<>楔螻?(Framework Layer)                    笏?
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?      笏?
笏? 笏?蟇ｼ闊ｪ邉ｻ扈<EFBDBB>     笏?笏?霍ｯ逕ｱ邉ｻ扈<EFBDBB>     笏?笏?譚<>剞謗ｧ蛻ｶ     笏?      笏?
笏? 笏?Navigation   笏?笏?Router       笏?笏?Permission   笏?      笏?
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?      笏?
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?      笏?
笏? 笏?蟶<>ｱ邉ｻ扈<EFBDBB>     笏?笏?迥ｶ諤∫ｮ｡逅?    笏?笏?驟咲ｽｮ邂｡逅<EFBDA1>     笏?      笏?
笏? 笏?Layout       笏?笏?State Mgmt   笏?笏?Config       笏?      笏?
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏?      笏?
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
                        竊?
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
笏?                  蝓ｺ遑螻?(Base Layer)                         笏?
笏? React + TypeScript + Ant Design + Tailwind CSS             笏?
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?

逶ｮ蠖慕ｻ捺桷隶ｾ隶｡

frontend-v2/
笏懌楳笏 src/
笏?  笏懌楳笏 app/                        # 蠎皮畑蜈･蜿｣
笏?  笏?  笏懌楳笏 App.tsx                # 譬ｹ扈<EFBDB9>ｻ?
笏?  笏?  笏懌楳笏 main.tsx               # 蜈･蜿｣譁<EFBDA3>ｻｶ
笏?  笏?  笏披楳笏 routes.tsx             # 霍ｯ逕ｱ驟咲ｽｮ
笏?  笏?
笏?  笏懌楳笏 framework/                 # 譯<>楔螻ゑｼ域<EFBDBC>ｸ蠢<EFBDB8>ｼ?
笏?  笏?  笏懌楳笏 navigation/            # 蟇ｼ闊ｪ邉ｻ扈<EFBDBB>
笏?  笏?  笏?  笏懌楳笏 TopNavigation.tsx  # 鬘ｶ驛ｨ蟇ｼ闊ｪ
笏?  笏?  笏?  笏懌楳笏 SideNavigation.tsx # 蟾ｦ萓ｧ蟇ｼ闊ｪ
笏?  笏?  笏?  笏披楳笏 navigationConfig.ts # 蟇ｼ闊ｪ驟咲ｽｮ
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 routing/               # 霍ｯ逕ｱ邉ｻ扈<EFBDBB>
笏?  笏?  笏?  笏懌楳笏 RouterConfig.tsx   # 霍ｯ逕ｱ驟咲ｽｮ
笏?  笏?  笏?  笏懌楳笏 RouteGuard.tsx     # 霍ｯ逕ｱ螳亥梱<E4BAA5>域揀髯撰ｼ<E692B0>
笏?  笏?  笏?  笏披楳笏 LazyLoader.tsx     # 諛貞刈霓?
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 permission/            # 譚<>剞謗ｧ蛻ｶ
笏?  笏?  笏?  笏懌楳笏 PermissionProvider.tsx
笏?  笏?  笏?  笏懌楳笏 usePermission.ts   # 譚<>剞Hook
笏?  笏?  笏?  笏懌楳笏 permissionConfig.ts # 譚<>剞驟咲ｽｮ
笏?  笏?  笏?  笏披楳笏 versionConfig.ts   # 迚域悽驟咲ｽｮ
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 layout/                # 蟶<>ｱ邉ｻ扈<EFBDBB>
笏?  笏?  笏?  笏懌楳笏 MainLayout.tsx     # 荳ｻ蟶<EFBDBB>ｱ
笏?  笏?  笏?  笏懌楳笏 ModuleLayout.tsx   # 讓｡蝮怜ｸ<E6809C>ｱ
笏?  笏?  笏?  笏披楳笏 EmptyLayout.tsx    # 遨ｺ蟶<EFBDBA>ｱ
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 config/                # 驟咲ｽｮ邂｡逅<EFBDA1>
笏?  笏?  笏?  笏懌楳笏 moduleConfig.ts    # 讓｡蝮鈴<E89DAE>鄂ｮ
笏?  笏?  笏?  笏懌楳笏 appConfig.ts       # 蠎皮畑驟咲ｽｮ
笏?  笏?  笏?  笏披楳笏 environment.ts     # 邇ｯ蠅<EFBDAF><E8A085>鄂ｮ
笏?  笏?  笏?
笏?  笏?  笏披楳笏 state/                 # 蜈ｨ螻迥ｶ諤?
笏?  笏?      笏懌楳笏 userStore.ts       # 逕ｨ謌ｷ迥ｶ諤?
笏?  笏?      笏懌楳笏 navigationStore.ts # 蟇ｼ闊ｪ迥ｶ諤?
笏?  笏?      笏披楳笏 permissionStore.ts # 譚<>剞迥ｶ諤?
笏?  笏?
笏?  笏懌楳笏 modules/                   # 蜉溯<E89C89>讓｡蝮暦ｼ育峡遶具ｼ<E585B7>
笏?  笏?  笏懌楳笏 ai-qa/                 # AI髣ｮ遲疲ｨ｡蝮<EFBDA1>
笏?  笏?  笏?  笏懌楳笏 index.tsx
笏?  笏?  笏?  笏懌楳笏 routes.tsx
笏?  笏?  笏?  笏披楳笏 ...
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 literature/            # AI譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮<EFBDA1>
笏?  笏?  笏?  笏懌楳笏 index.tsx
笏?  笏?  笏?  笏懌楳笏 routes.tsx
笏?  笏?  笏?  笏披楳笏 ...
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 knowledge-base/        # 遏･隸<EFBDA5>ｺ捺ｨ｡蝮?
笏?  笏?  笏?  笏懌楳笏 index.tsx
笏?  笏?  笏?  笏懌楳笏 routes.tsx
笏?  笏?  笏?  笏披楳笏 ...
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 data-cleaning/         # 譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ暦ｼ亥頃菴搾ｼ<E690BE>
笏?  笏?  笏?  笏披楳笏 Placeholder.tsx
笏?  笏?  笏?
笏?  笏?  笏懌楳笏 intelligent-analysis/  # 譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵
笏?  笏?  笏?  笏披楳笏 ...
笏?  笏?  笏?
笏?  笏?  笏披楳笏 statistical-tools/     # 扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ
笏?  笏?      笏披楳笏 ...
笏?  笏?
笏?  笏懌楳笏 components/                # 騾夂畑扈<E79591>ｻｶ
笏?  笏?  笏懌楳笏 common/                # 蝓ｺ遑扈<C280>ｻｶ
笏?  笏?  笏懌楳笏 business/              # 荳壼苅扈<E88B85>ｻｶ
笏?  笏?  笏披楳笏 hooks/                 # 騾夂畑Hooks
笏?  笏?
笏?  笏懌楳笏 api/                       # API螻?
笏?  笏?  笏懌楳笏 client.ts              # API螳｢謌ｷ遶?
笏?  笏?  笏懌楳笏 modules/               # 讓｡蝮輸PI
笏?  笏?  笏披楳笏 types/                 # API邀ｻ蝙<EFBDBB>
笏?  笏?
笏?  笏懌楳笏 utils/                     # 蟾･蜈ｷ蜃ｽ謨ｰ
笏?  笏披楳笏 types/                     # 蜈ｨ螻邀ｻ蝙<EFBDBB>

<EFBFBD>柏譚<>剞謗ｧ蛻ｶ隶ｾ隶｡

逕ｨ謌ｷ迚域悽螳壻ｹ<EFBFBD>

驥崎ｦ∬ｯｴ譏趣ｼ? 迚域悽譚<E682BD>剞蛻<E5899E><E89BBB>譏ｯ螳悟<E89EB3>?*蜿ｯ驟咲ｽｮ縲∝庄隹<E5BA84>紛逧<EFBFBD>ゆｻ･荳矩<EFBFBD>鄂ｮ荳ｺ蛻晏ｧ区婿譯<EFBFBD>*<2A>悟庄莉･譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ菫ｮ謾ｹ<E8ACBE>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代?

// 逕ｨ謌ｷ迚域悽邀ｻ蝙<EFBDBB>
type UserVersion = 'basic' | 'advanced' | 'premium';

// 迚域悽驟咲ｽｮ<EFBDBD>亥庄驟咲ｽｮ<EFBDBD>梧髪謖∝錘譛溯ｰ<E6BAAF>紛<EFBFBD><E7B49B>
// 驟咲ｽｮ譁<EFBDAE>ｻｶ菴咲ｽｮ<EFBDBD>嘖rc/framework/permission/versionConfig.ts
// 謌冶<E586B6>夊ｿ<E5A48A>錘遶ｯAPI蜉ｨ諤∬執蜿夜<E89CBF>鄂?
const VERSION_CONFIG = {
  basic: {
    name: '蝓ｺ遑迚?,
    modules: ['ai-qa', 'knowledge-base'], // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>壼渕遑迚亥桁蜷ｫ讓｡蝮?
  },
  advanced: {
    name: '鬮倡ｺｧ迚?,
    modules: [
      'ai-qa',
      'knowledge-base',
      'literature-platform',
      'data-cleaning',
    ], // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>夐ｫ倡ｺｧ迚亥桁蜷ｫ讓｡蝮<EFBDA1>
  },
  premium: {
    name: '譌苓芦迚?,
    modules: [
      'ai-qa',
      'knowledge-base',
      'literature-platform',
      'data-cleaning',
      'intelligent-analysis',
      'statistical-tools',
    ], // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>壽覧闊ｰ迚亥桁蜷ｫ蜈ｨ驛ｨ讓｡蝮<EFBDA1>
  },
};

// 隸ｴ譏趣ｼ?
// 1. 莉･荳頑ｨ｡蝮怜<E89DAE>驟堺ｸｺ蛻晏ｧ区婿譯茨ｼ悟庄譬ｹ謐ｮ螳樣刔荳壼苅髴豎りｰ<E3828A><EFBDB0>?
// 2. 謾ｯ謖<EFBDAF>夊ｿ<E5A48A><EFBDBF>鄂ｮ譁<EFBDAE>ｻｶ菫ｮ謾ｹ<E8ACBE>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>
// 3. 譖ｴ謗ｨ闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>御ｾｿ莠主ｮ樊慮隹<E685AE>紛

譚<EFBFBD>剞謗ｧ蛻ｶ螳樒鴫

*隶ｾ隶｡隸ｴ譏趣ｼ? 譚<>剞謗ｧ蛻ｶ驥<EFBDB6>畑驟咲ｽｮ鬩ｱ蜉ｨ逧<EFBDA8>婿蠑擾ｼ梧髪謖<E9ABAA>夊ｿ<E5A48A><EFBDBF>鄂ｮ譁<EFBDAE>ｻｶ謌門錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>御ｾｿ莠主錘譛溽<E8AD9B>豢ｻ隹<EFBDBB>紛縲?

// 譚<>剞謗ｧ蛻ｶHook
export const usePermission = () => {
  const userVersion = useUserStore((state) => state.version);
  
  // 譁ｹ蠑<EFBDB9>1<EFBFBD>壻ｻ朱撕諤<E69295><E8ABA4>鄂ｮ隸ｻ蜿厄ｼ磯ょ粋蠑蜿鷹亳谿ｵ<E8B0BF><EFBDB5>
  // const allowedModules = VERSION_CONFIG[userVersion].modules;
  
  // 譁ｹ蠑<EFBDB9>2<EFBFBD>壻ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿厄ｼ域耳闕撰ｼ梧髪謖∝ｮ樊慮隹<E685AE>紛<EFBFBD><E7B49B>
  const versionConfig = useVersionConfig(); // 莉拶PI闔ｷ蜿匁怙譁ｰ驟咲ｽ?
  const allowedModules = versionConfig[userVersion]?.modules || [];
  
  const hasAccess = (moduleId: string): boolean => {
    return allowedModules.includes(moduleId);
  };
  
  const getFilteredNavigation = (navigation: NavigationItem[]) => {
    return navigation.filter((item) => {
      // 譽譟･逕ｨ謌ｷ迚域悽譏ｯ蜷ｦ貊｡雜ｳ讓｡蝮苓ｦ∵ｱ?
      if (!item.requiredVersion) return true;
      const versionHierarchy = ['basic', 'advanced', 'premium'];
      const userLevel = versionHierarchy.indexOf(userVersion);
      const requiredLevel = versionHierarchy.indexOf(item.requiredVersion);
      return userLevel >= requiredLevel;
    });
  };
  
  return {
    hasAccess,
    getFilteredNavigation,
    userVersion,
    versionConfig, // 霑泌屓蠖灘燕迚域悽驟咲ｽｮ<EFBDBD>御ｾｿ莠手ｰ<E6898B>ｯ?
  };
};

迚域悽驟咲ｽｮ蜉ｨ諤∬執蜿厄ｼ域耳闕先婿譯茨ｼ?

// src/framework/permission/useVersionConfig.ts
import { useQuery } from '@tanstack/react-query';

export const useVersionConfig = () => {
  const { data, isLoading } = useQuery({
    queryKey: ['versionConfig'],
    queryFn: async () => {
      // 莉主錘遶ｯAPI闔ｷ蜿也沿譛ｬ驟咲ｽｮ
      const response = await fetch('/api/config/version');
      return response.json();
    },
    staleTime: 5 * 60 * 1000, // 郛灘ｭ<E78198>5蛻<35>帖
    refetchOnWindowFocus: false,
  });
  
  // 螯よ棡API隸ｷ豎ょ､ｱ雍･<E99B8D>悟屓騾蛻ｰ譛ｬ蝨ｰ驟咲ｽ?
  return data || VERSION_CONFIG;
};

*莨伜漢<EFBFBD>?

笨?迚域悽驟咲ｽｮ蜿ｯ蝨ｨ蜷守ｫｯ螳樊慮隹<E685AE>紛<EFBFBD>梧裏髴蜑咲ｫｯ蜿醍沿
笨?謾ｯ謖、/B豬玖ｯ穂ｸ榊酔迚域悽驟咲ｽｮ
笨?萓ｿ莠手ｿ占是莠ｺ蜻倡<E89CBB>豢ｻ隹<EFBDBB>紛莠ｧ蜩∫ｭ也払
笨?蜑咲ｫｯ譛画悽蝨ｰ驟咲ｽｮ菴應ｸｺ蜈懷ｺ墓婿譯茨ｼ御ｿ晁ｯ∝庄逕ｨ諤?

霍ｯ逕ｱ螳亥梱

// RouteGuard.tsx
export const RouteGuard = ({ moduleId, children }) => {
  const { hasAccess } = usePermission();
  
  if (!hasAccess(moduleId)) {
    return <UpgradePrompt moduleId={moduleId} />;
  }
  
  return children;
};

<EFBFBD>伯讓｡蝮礼峡遶区ｧ隶ｾ隶?

讓｡蝮玲ｳｨ蜀梧惻蛻ｶ

// 讓｡蝮玲磁蜿｣螳壻ｹ<E5A3BB>
interface ModuleDefinition {
  id: string;              // 讓｡蝮怜髪荳譬<C280>ｯ<EFBFBD>
  name: string;            // 讓｡蝮怜錐遘ｰ
  route: string;           // 霍ｯ逕ｱ霍ｯ蠕<EFBDAF>
  icon?: ReactNode;        // 蝗ｾ譬<EFBDBE>
  component: LazyComponent; // 諛貞刈霓ｽ扈<EFBDBD>ｻ?
  sideNav?: SideNavConfig; // 蟾ｦ萓ｧ蟇ｼ闊ｪ驟咲ｽｮ
  version?: UserVersion[];  // 謾ｯ謖∫噪迚域<E8BF9A>?
  standalone?: boolean;     // 譏ｯ蜷ｦ謾ｯ謖∫峡遶玖ｿ占｡<E58DA0>
  apiBaseUrl?: string;     // 迢ｬ遶玖ｿ占｡梧慮逧БPI蝨ｰ蝮
}

// 讓｡蝮鈴<E89DAE>鄂ｮ
const MODULES: ModuleDefinition[] = [
  {
    id: 'literature-platform',
    name: 'AI譎ｺ閭ｽ譁<EFBDBD>鍵',
    route: '/literature',
    component: lazy(() => import('@/modules/literature')),
    version: ['advanced', 'premium'],
    standalone: true, // 謾ｯ謖∫峡遶玖ｿ占｡<E58DA0>
    apiBaseUrl: process.env.LITERATURE_API_URL, // 蜿ｯ驟咲ｽ?
  },
  // ... 蜈ｶ莉匁ｨ｡蝮<EFBDA1>
];

迢ｬ遶矩Κ鄂ｲ謾ｯ謖<EFBFBD>

// 讓｡蝮怜刈霓ｽ蝎?
export const ModuleLoader = ({ moduleId }: { moduleId: string }) => {
  const module = MODULES.find((m) => m.id === moduleId);
  
  if (!module) {
    return <NotFound />;
  }
  
  // 譽譟･譏ｯ蜷ｦ迢ｬ遶玖ｿ占｡梧ｨ｡蠑?
  const isStandalone = module.standalone && 
    window.location.hostname === module.apiBaseUrl;
  
  if (isStandalone) {
    // 迢ｬ遶玖ｿ占｡鯉ｼ壻ｸ肴仞遉ｺ鬘ｶ驛ｨ蟇ｼ闊ｪ<E9978A>悟宵譏ｾ遉ｺ讓｡蝮怜<E89DAE>螳ｹ
    return <StandaloneLayout module={module} />;
  }
  
  // 髮<><E9ABAE>霑占｡鯉ｼ壽仞遉ｺ螳梧紛蟇ｼ闊ｪ蜥悟ｸ<E6829F>ｱ
  return <ModuleLayout module={module} />;
};

驟咲ｽｮ鬩ｱ蜉ｨ逧<EFBFBD>ｨ｡蝮怜刈霓?

// 邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ
// .env
REACT_APP_ENABLED_MODULES=ai-qa,knowledge-base,literature-platform
REACT_APP_STANDALONE_MODULE=literature-platform

// 讓｡蝮鈴<E89DAE>鄂ｮ隸ｻ蜿<EFBDBB>
const getEnabledModules = () => {
  const enabled = process.env.REACT_APP_ENABLED_MODULES?.split(',') || [];
  return MODULES.filter((m) => enabled.includes(m.id));
};

<EFBFBD>盗蟶<>ｱ邉ｻ扈溯ｮｾ隶｡

蟶<EFBFBD>ｱ螻よｬ｡

MainLayout (荳ｻ蟶<EFBDBB>ｱ)
笏懌楳笏 Header (鬘ｶ驛ｨ蟇ｼ闊ｪ)
笏?  笏懌楳笏 Logo
笏?  笏懌楳笏 TopNavigation (蟇ｼ闊ｪ鬘?
笏?  笏披楳笏 UserMenu (逕ｨ謌ｷ闖懷黒)
笏?
笏披楳笏 MainContent (荳ｻ蜀<EFBDBB>ｮｹ蛹ｺ)
    笏懌楳笏 SideNavigation (蟾ｦ萓ｧ蟇ｼ闊ｪ) - 蜿ｯ騾?
    笏披楳笏 Content (蜀<>ｮｹ蛹ｺ蝓<EFBDBA>)
        笏披楳笏 ModuleLayout (讓｡蝮怜ｸ<E6809C>ｱ)

蟶<EFBFBD>ｱ扈<EFBFBD>ｻｶ

// MainLayout.tsx
export const MainLayout = () => {
  return (
    <div className="min-h-screen flex flex-col">
      <Header />
      <div className="flex flex-1">
        <SideNavigation /> {/* 譬ｹ謐ｮ讓｡蝮玲仞遉ｺ/髫占酪 */}
        <main className="flex-1">
          <Outlet /> {/* 霍ｯ逕ｱ蜃ｺ蜿｣ */}
        </main>
      </div>
    </div>
  );
};

// ModuleLayout.tsx
export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => {
  return (
    <div className="module-layout">
      {module.sideNav && <ModuleSideNav config={module.sideNav} />}
      <div className="module-content">
        <Outlet />
      </div>
    </div>
  );
};

<EFBFBD>耳 UI/UX隶ｾ隶｡隗<EFBDA1>激

鬘ｶ驛ｨ蟇ｼ闊ｪ譬ｷ蠑<EFBFBD>

.top-navigation {
  height: 64px;
  background: #ffffff;
  border-bottom: 1px solid #e5e7eb;
  display: flex;
  align-items: center;
  padding: 0 24px;
}

.nav-item {
  padding: 8px 16px;
  margin: 0 4px;
  color: #4b5563;
  font-weight: 500;
  border-bottom: 2px solid transparent;
  transition: all 0.2s;
}

.nav-item:hover {
  color: #0ea5e9;
}

.nav-item.active {
  color: #0ea5e9;
  border-bottom-color: #0ea5e9;
  font-weight: 600;
}

蜩榊ｺ泌ｼ剰ｮｾ隶?

譯碁擇遶?(>1024px): 螳梧紛譏ｾ遉ｺ謇譛牙ｯｼ闊ｪ鬘ｹ
蟷ｳ譚ｿ遶?(768-1024px): 譏ｾ遉ｺ蜑?荳ｪ<E88DB3>悟<EFBFBD>菴呎釜蜿<E9879C>蛻?譖ｴ螟<EFBDB4>"闖懷黒
遘ｻ蜉ｨ遶?(<768px): 豎牙<E8B18E>｡闖懷黒 + 謚ｽ螻牙ｯｼ闊ｪ

<EFBFBD>統螳樊命隶｡蛻<EFBDA1>

隨ｬ荳髦ｶ谿ｵ<EFBFBD>壽｡<EFBFBD>楔謳ｭ蟒ｺ<EFBFBD><EFBFBD>eek 1<>?

蛻帛ｻｺ譁ｰ蜑咲ｫｯ鬘ｹ逶ｮ扈捺<EFBFBD>?
螳樒鴫鬘ｶ驛ｨ蟇ｼ闊ｪ扈<EFBFBD>ｻｶ
螳樒鴫霍ｯ逕ｱ邉ｻ扈<EFBFBD>
螳樒鴫譚<EFBFBD>剞謗ｧ蛻ｶ蝓ｺ遑
螳樒鴫蝓ｺ遑蟶<EFBFBD>ｱ邉ｻ扈<EFBFBD>

隨ｬ莠碁亳谿ｵ<EFBFBD>壽ｨ｡蝮鈴寔謌撰ｼ<EFBFBD>eek 2<>?

霑∫ｧｻAI髣ｮ遲疲ｨ｡蝮<EFBFBD>
霑∫ｧｻ遏･隸<EFBFBD>ｺ捺ｨ｡蝮?
螳樒鴫蜊<EFBFBD>菴肴ｨ｡蝮暦ｼ域匱閭ｽ謨ｰ謐ｮ貂<EFBFBD>ｴ暦ｼ<EFBFBD>
螳悟埋譚<EFBFBD>剞謗ｧ蛻ｶ

隨ｬ荳蛾亳谿ｵ<EFBFBD>哂I譎ｺ閭ｽ譁<EFBFBD>鍵蠑蜿托ｼ<EFBFBD>eek 3+<2B>?

蠑蜿羨I譎ｺ閭ｽ譁<EFBFBD>鍵讓｡蝮<EFBFBD>
螳樒鴫讓｡蝮礼峡遶玖ｿ占｡梧髪謖<EFBFBD>
螳悟埋譁<EFBFBD>｡｣蜥梧ｵ玖ｯ?

<EFBFBD>売譛ｪ譚･謇ｩ螻戊<E6888A>剔

1. 讓｡蝮礼峡遶倶ｺｧ蜩∝<E89CA9>?

謾ｯ謖<EFBFBD>夊ｿ<EFBFBD>識蠅<EFBFBD>序驥城<EFBFBD>鄂ｮ迢ｬ遶玖ｿ占｡<EFBFBD>
迢ｬ遶狗噪API蝨ｰ蝮驟咲ｽｮ
迢ｬ遶狗噪驛ｨ鄂ｲ驟咲ｽ?

2. 迚域悽譚<E682BD>剞邂｡逅<EFBDA1>

蜷守ｫｯAPI謠蝉ｾ帷畑謌ｷ迚域悽菫｡諱ｯ
迚域悽驟咲ｽｮ螳悟<EFBFBD>蜿ｯ隹<EFBFBD>紛<EFBFBD>域裏髴謾ｹ蜉ｨ莉｣遐<EFBFBD>ｼ?
謗ｨ闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBFBD>梧髪謖∝ｮ樊慮隹<EFBFBD>紛讓｡蝮怜<EFBFBD>驟<EFBFBD>
蜑咲ｫｯ譬ｹ謐ｮ迚域悽蜉ｨ諤∵仞遉?髫占酪讓｡蝮<EFBDA1>
謾ｯ謖∫沿譛ｬ蜊<EFBFBD>ｺｧ謠千､ｺ
迚域悽譚<EFBFBD>剞蛻<EFBFBD><EFBFBD>遲也払蜿ｯ髫乗慮譬ｹ謐ｮ荳壼苅髴豎りｰ<EFBFBD><EFBFBD>?

3. 譁ｰ讓｡蝮玲磁蜈?

驕ｵ蠕ｪ讓｡蝮玲磁蜿｣隗<EFBFBD>激
蝨ｨ驟咲ｽｮ譁<EFBFBD>ｻｶ荳ｭ豕ｨ蜀梧ｨ｡蝮<EFBFBD>
閾ｪ蜉ｨ髮<EFBFBD><EFBFBD>蛻ｰ蟇ｼ闊ｪ邉ｻ扈?

<EFBFBD>答逶ｸ蜈ｳ譁<EFBDB3>｡｣

*譁<EFBFBD>｡｣迚域悽<EFBFBD>? v1.0
譛蜷取峩譁ｰ<EFBFBD><EFBFBD> 2025-10-29

19 KiB Raw Blame History Unescape Escape