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
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
--- a/docs/04-开发规范/04-API路由总览.md
+++ b/docs/04-开发规范/04-API路由总览.md
@@ -1,8 +1,8 @@
 # API頝舐眏<E88890>餉<EFBFBD>

-> **目的：** 提供所有API端点的快速索引，便于查找和避免路由冲突  
-> **详细设计：** 请查看各模块的 `02-API设计.md`  
-> **基础URL：** `http://localhost:3001/api/v1`  
+> **<EFBFBD>桃<EFBFBD>嚗?* <20>𣂷<EFBFBD><F0A382B7><EFBFBD><EFBFBD>𡅅PI蝡舐<E89DA1><E88890><EFBFBD>翰<EFBFBD>毺揣撘𤏪<E69298>靘蹂<E99D98><E8B982>交𪄳<E4BAA4>屸<EFBFBD><E5B1B8>滩楝<E6BBA9>勗<EFBFBD>蝒? 
+> **霂衣<EFBFBD>霈曇恣嚗?* 霂瑟䰻<E7919F>见<EFBFBD>璅∪<E79285><E288AA>?`02-API霈曇恣.md`  
+> **<EFBFBD>箇<EFBFBD>URL嚗?* `http://localhost:3001/api/v1`  
 > **<2A><><EFBFBD>擧凒<E693A7>堆<EFBFBD>** 2025-11-06

 ---
@@ -13,9 +13,9 @@
 ```
 /api/v{version}/{module}/{resource}/{id?}/{action?}

-示例：
+蝷箔<EFBFBD>嚗?
 /api/v1/literature/projects           # <20>瑕<EFBFBD><E79195><EFBFBD>讃憿寧𤌍<E5AFA7>𡑒”
-/api/v1/literature/projects/123       # 获取ID=123的项目
+/api/v1/literature/projects/123       # <EFBFBD>瑕<EFBFBD>ID=123<EFBFBD><EFBFBD>★<EFBFBD>?
 /api/v1/literature/projects/123/export  # 撖澆枂憿寧𤌍
 ```

@@ -23,350 +23,350 @@

 | 璅∪<E79285>隞<EFBFBD><E99A9E> | 頝舐眏<E88890>滨<EFBFBD> | 霂湔<E99C82> |
 |---------|---------|------|
-| 平台基础层 | `/auth`, `/users`, `/admin` | 认证、用户、管理 |
+| 撟喳蝱<EFBFBD>箇<EFBFBD>撅?| `/auth`, `/users`, `/admin` | 霈方<EFBFBD><EFBFBD><EFBFBD>鍂<EFBFBD>瑯<EFBFBD><EFBFBD>恣<EFBFBD>?|
 | LLM蝵穃<E89DB5> | `/llm` | LLM靚<4D>鍂 |
 | AIA | `/chat`, `/agents` | AI<41>箄<EFBFBD><E7AE84>桃<EFBFBD> |
 | ASL | `/literature` | AI<41>箄<EFBFBD><E7AE84><EFBFBD>讃 |
-| PKB | `/knowledge-bases`, `/kb` | 个人知识库 |
+| PKB | `/knowledge-bases`, `/kb` | 銝芯犖<EFBFBD>亥<EFBFBD>摨?|
 | DC | `/data-cleaning` | <20>唳旿皜<E697BF><E79A9C> |
 | SSA | `/analysis` | <20>箄<EFBFBD>蝏蠘恣<E8A098><E681A3><EFBFBD> |
 | ST | `/tools` | 蝏蠘恣撌亙<E6928C> |
 | RVW | `/review` | 蝔蹂辣摰⊥䰻 |
-| ADMIN | `/admin` | 运营管理端 |
+| ADMIN | `/admin` | 餈鞱𨯫蝞∠<EFBFBD>蝡?|

 ---

-## 🔐 认证与用户管理（/api/v1/auth, /api/v1/users）
+## <EFBFBD><EFBFBD> 霈方<E99C88>銝𡒊鍂<F0A1928A>瑞恣<E7919E><E681A3><EFBFBD>/api/v1/auth, /api/v1/users嚗?

-**状态：** ✅ 已实现  
-**详细设计：** [UAM/02-API设计](../01-平台基础层/01-用户与权限中心(UAM)/02-API设计.md)（待创建）
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?撌脣<E6928C><E884A3>? 
+**霂衣<EFBFBD>霈曇恣嚗?* [UAM/02-API霈曇恣](../01-撟喳蝱<EFBFBD>箇<EFBFBD>撅?01-<2D>冽<EFBFBD>銝擧<E98A9D><E693A7>𣂷葉敹?UAM)/02-API霈曇恣.md)嚗<EFBFBD><EFBFBD><EFBFBD>𥕦遣嚗?

 ### 霈方<E99C88><E696B9>詨<EFBFBD>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/auth/register` | POST | 用户注册 | ❌ |
-| `/api/v1/auth/login` | POST | 用户登录 | ❌ |
-| `/api/v1/auth/logout` | POST | 用户登出 | ✅ |
-| `/api/v1/auth/refresh` | POST | 刷新Token | ✅ |
-| `/api/v1/auth/profile` | GET | 获取当前用户信息 | ✅ |
-| `/api/v1/auth/profile` | PUT | 更新当前用户信息 | ✅ |
+| `/api/v1/auth/register` | POST | <EFBFBD>冽<EFBFBD>瘜典<EFBFBD> | <EFBFBD>?|
+| `/api/v1/auth/login` | POST | <EFBFBD>冽<EFBFBD><EFBFBD>餃<EFBFBD> | <EFBFBD>?|
+| `/api/v1/auth/logout` | POST | <EFBFBD>冽<EFBFBD><EFBFBD>餃枂 | <EFBFBD>?|
+| `/api/v1/auth/refresh` | POST | <EFBFBD>瑟鰵Token | <EFBFBD>?|
+| `/api/v1/auth/profile` | GET | <EFBFBD>瑕<EFBFBD>敶枏<EFBFBD><EFBFBD>冽<EFBFBD>靽⊥<EFBFBD> | <EFBFBD>?|
+| `/api/v1/auth/profile` | PUT | <EFBFBD>湔鰵敶枏<EFBFBD><EFBFBD>冽<EFBFBD>靽⊥<EFBFBD> | <EFBFBD>?|

 ### <20>冽<EFBFBD>蝞∠<E89D9E>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/users` | GET | 用户列表（分页） | ✅ ADMIN |
-| `/api/v1/users/:id` | GET | 用户详情 | ✅ ADMIN |
-| `/api/v1/users/:id` | PUT | 更新用户 | ✅ ADMIN |
-| `/api/v1/users/:id` | DELETE | 删除用户 | ✅ ADMIN |
+| `/api/v1/users` | GET | <EFBFBD>冽<EFBFBD><EFBFBD>𡑒”嚗<EFBFBD><EFBFBD>憿蛛<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/users/:id` | GET | <EFBFBD>冽<EFBFBD>霂行<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/users/:id` | PUT | <EFBFBD>湔鰵<EFBFBD>冽<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/users/:id` | DELETE | <EFBFBD>𣳇膄<EFBFBD>冽<EFBFBD> | <EFBFBD>?ADMIN |

 ---

-## 🤖 LLM大模型网关（/api/v1/llm）
+## <EFBFBD><EFBFBD> LLM憭扳芋<EFBFBD>讠<EFBFBD><EFBFBD>喉<EFBFBD>/api/v1/llm嚗?

-**状态：** ❌ 待实现（P0优先级）  
-**详细设计：** [LLM网关/02-API设计](../02-通用能力层/01-LLM大模型网关/02-API设计.md)
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?敺<><E695BA><EFBFBD>堆<EFBFBD>P0隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* [LLM蝵穃<EFBFBD>/02-API霈曇恣](../02-<EFBFBD>𡁶鍂<EFBFBD>賢<EFBFBD>撅?01-LLM憭扳芋<E689B3>讠<EFBFBD><E8AEA0>?02-API霈曇恣.md)

 ### LLM靚<4D>鍂

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/llm/chat` | POST | LLM对话（非流式） | ✅ |
-| `/api/v1/llm/chat/stream` | POST | LLM对话（流式SSE） | ✅ |
-| `/api/v1/llm/quota` | GET | 查询当前用户配额 | ✅ |
-| `/api/v1/llm/usage` | GET | 查询使用统计 | ✅ |
-| `/api/v1/llm/models` | GET | 获取可用模型列表 | ✅ |
+| `/api/v1/llm/chat` | POST | LLM撖寡<EFBFBD>嚗<EFBFBD><EFBFBD>瘚<EFBFBD><EFBFBD>嚗?| <20>?|
+| `/api/v1/llm/chat/stream` | POST | LLM撖寡<EFBFBD>嚗<EFBFBD><EFBFBD>撘莅SE嚗?| <20>?|
+| `/api/v1/llm/quota` | GET | <EFBFBD>亥砭敶枏<EFBFBD><EFBFBD>冽<EFBFBD><EFBFBD>漤<EFBFBD> | <EFBFBD>?|
+| `/api/v1/llm/usage` | GET | <EFBFBD>亥砭雿輻鍂蝏蠘恣 | <EFBFBD>?|
+| `/api/v1/llm/models` | GET | <EFBFBD>瑕<EFBFBD><EFBFBD>舐鍂璅∪<EFBFBD><EFBFBD>𡑒” | <EFBFBD>?|

 ---

-## 💬 AI智能问答（/api/v1/chat, /api/v1/agents）
+## <EFBFBD>俥 AI<EFBFBD>箄<EFBFBD><EFBFBD>桃<EFBFBD>嚗?api/v1/chat, /api/v1/agents嚗?

-**状态：** ✅ 已实现  
-**详细设计：** [AIA/02-API设计](../03-业务模块/AIA-AI智能问答/02-API设计.md)（待创建）
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?撌脣<E6928C><E884A3>? 
+**霂衣<EFBFBD>霈曇恣嚗?* [AIA/02-API霈曇恣](../03-銝𡁜𦛚璅∪<EFBFBD>/AIA-AI<EFBFBD>箄<EFBFBD><EFBFBD>桃<EFBFBD>/02-API霈曇恣.md)嚗<EFBFBD><EFBFBD><EFBFBD>𥕦遣嚗?

 ### 撖寡<E69296>蝞∠<E89D9E>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/chat/conversations` | GET | 对话列表 | ✅ |
-| `/api/v1/chat/conversations` | POST | 创建对话 | ✅ |
-| `/api/v1/chat/conversations/:id` | GET | 对话详情 | ✅ |
-| `/api/v1/chat/conversations/:id` | DELETE | 删除对话 | ✅ |
-| `/api/v1/chat/conversations/:id/messages` | GET | 对话消息列表 | ✅ |
-| `/api/v1/chat/conversations/:id/messages` | POST | 发送消息 | ✅ |
+| `/api/v1/chat/conversations` | GET | 撖寡<EFBFBD><EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/chat/conversations` | POST | <EFBFBD>𥕦遣撖寡<EFBFBD> | <EFBFBD>?|
+| `/api/v1/chat/conversations/:id` | GET | 撖寡<EFBFBD>霂行<EFBFBD> | <EFBFBD>?|
+| `/api/v1/chat/conversations/:id` | DELETE | <EFBFBD>𣳇膄撖寡<EFBFBD> | <EFBFBD>?|
+| `/api/v1/chat/conversations/:id/messages` | GET | 撖寡<EFBFBD>瘨<EFBFBD><EFBFBD><EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/chat/conversations/:id/messages` | POST | <EFBFBD>煾<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| <20>?|

-### 智能体管理
+### <EFBFBD>箄<EFBFBD>雿梶恣<EFBFBD>?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/agents` | GET | 智能体列表（12个） | ✅ |
-| `/api/v1/agents/:id` | GET | 智能体详情 | ✅ |
+| `/api/v1/agents` | GET | <EFBFBD>箄<EFBFBD>雿枏<EFBFBD>銵剁<EFBFBD>12銝迎<EFBFBD> | <EFBFBD>?|
+| `/api/v1/agents/:id` | GET | <EFBFBD>箄<EFBFBD>雿栞祕<EFBFBD>?| <20>?|

 ---

-## 📖 AI智能文献（/api/v1/literature）
+## <EFBFBD><EFBFBD> AI<EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>讃嚗?api/v1/literature嚗?

-**状态：** ⏳ 设计中（P0优先级）  
-**详细设计：** [ASL/02-API设计](../03-业务模块/ASL-AI智能文献/02-API设计.md)
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?霈曇恣銝哨<E98A9D>P0隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* [ASL/02-API霈曇恣](../03-銝𡁜𦛚璅∪<EFBFBD>/ASL-AI<EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>讃/02-API霈曇恣.md)

 ### 憿寧𤌍蝞∠<E89D9E>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/literature/projects` | GET | 文献项目列表 | ✅ |
-| `/api/v1/literature/projects` | POST | 创建文献项目 | ✅ |
-| `/api/v1/literature/projects/:id` | GET | 项目详情 | ✅ |
-| `/api/v1/literature/projects/:id` | PUT | 更新项目 | ✅ |
-| `/api/v1/literature/projects/:id` | DELETE | 删除项目 | ✅ |
+| `/api/v1/literature/projects` | GET | <EFBFBD><EFBFBD>讃憿寧𤌍<EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/literature/projects` | POST | <EFBFBD>𥕦遣<EFBFBD><EFBFBD>讃憿寧𤌍 | <EFBFBD>?|
+| `/api/v1/literature/projects/:id` | GET | 憿寧𤌍霂行<EFBFBD> | <EFBFBD>?|
+| `/api/v1/literature/projects/:id` | PUT | <EFBFBD>湔鰵憿寧𤌍 | <EFBFBD>?|
+| `/api/v1/literature/projects/:id` | DELETE | <EFBFBD>𣳇膄憿寧𤌍 | <EFBFBD>?|

 ### <20><>讃蝑偦<E89D91>㚁<EFBFBD><E39A81><EFBFBD><EFBFBD><EFBFBD>䁅<EFBFBD><E48185>萘<EFBFBD>嚗争<E59A97>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/literature/projects/:id/items/import` | POST | 导入CSV文件 | ✅ |
-| `/api/v1/literature/projects/:id/pico` | POST | 配置PICO标准 | ✅ |
-| `/api/v1/literature/projects/:id/pico` | GET | 获取PICO配置 | ✅ |
-| `/api/v1/literature/projects/:id/screening/title` | POST | 执行标题摘要初筛 | ✅ |
-| `/api/v1/literature/projects/:id/screening/status` | GET | 查询筛选进度 | ✅ |
-| `/api/v1/literature/projects/:id/screening/results` | GET | 获取筛选结果 | ✅ |
-| `/api/v1/literature/projects/:id/screening/export` | POST | 导出Excel | ✅ |
+| `/api/v1/literature/projects/:id/items/import` | POST | 撖澆<EFBFBD>CSV<EFBFBD><EFBFBD>辣 | <EFBFBD>?|
+| `/api/v1/literature/projects/:id/pico` | POST | <EFBFBD>滨蔭PICO<EFBFBD><EFBFBD><EFBFBD> | <EFBFBD>?|
+| `/api/v1/literature/projects/:id/pico` | GET | <EFBFBD>瑕<EFBFBD>PICO<EFBFBD>滨蔭 | <EFBFBD>?|
+| `/api/v1/literature/projects/:id/screening/title` | POST | <EFBFBD>扯<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>䁅<EFBFBD><EFBFBD>萘<EFBFBD> | <EFBFBD>?|
+| `/api/v1/literature/projects/:id/screening/status` | GET | <EFBFBD>亥砭蝑偦<EFBFBD>㕑<EFBFBD>摨?| <20>?|
+| `/api/v1/literature/projects/:id/screening/results` | GET | <EFBFBD>瑕<EFBFBD>蝑偦<EFBFBD>厩<EFBFBD><EFBFBD>?| <20>?|
+| `/api/v1/literature/projects/:id/screening/export` | POST | 撖澆枂Excel | <EFBFBD>?|

-### 文献筛选（全文复筛）
+### <EFBFBD><EFBFBD>讃蝑偦<EFBFBD>㚁<EFBFBD><EFBFBD>冽<EFBFBD>憭滨<EFBFBD>嚗?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/literature/projects/:id/screening/fulltext` | POST | 执行全文筛选 | ✅ |
-| `/api/v1/literature/projects/:id/screening/fulltext/status` | GET | 查询进度 | ✅ |
+| `/api/v1/literature/projects/:id/screening/fulltext` | POST | <EFBFBD>扯<EFBFBD><EFBFBD>冽<EFBFBD>蝑偦<EFBFBD>?| <20>?|
+| `/api/v1/literature/projects/:id/screening/fulltext/status` | GET | <EFBFBD>亥砭餈𥕦漲 | <EFBFBD>?|

 ---

-## 📚 个人知识库（/api/v1/knowledge-bases）
+## <EFBFBD><EFBFBD> 銝芯犖<E88AAF>亥<EFBFBD>摨橒<E691A8>/api/v1/knowledge-bases嚗?

-**状态：** ✅ 已实现  
-**详细设计：** [PKB/02-API设计](../03-业务模块/PKB-个人知识库/02-API设计.md)（待创建）
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?撌脣<E6928C><E884A3>? 
+**霂衣<EFBFBD>霈曇恣嚗?* [PKB/02-API霈曇恣](../03-銝𡁜𦛚璅∪<EFBFBD>/PKB-銝芯犖<E88AAF>亥<EFBFBD>摨?02-API霈曇恣.md)嚗<EFBFBD><EFBFBD><EFBFBD>𥕦遣嚗?

-### 知识库管理
+### <EFBFBD>亥<EFBFBD>摨梶恣<EFBFBD>?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/knowledge-bases` | GET | 知识库列表 | ✅ |
-| `/api/v1/knowledge-bases` | POST | 创建知识库 | ✅ |
-| `/api/v1/knowledge-bases/:id` | GET | 知识库详情 | ✅ |
-| `/api/v1/knowledge-bases/:id` | PUT | 更新知识库 | ✅ |
-| `/api/v1/knowledge-bases/:id` | DELETE | 删除知识库 | ✅ |
+| `/api/v1/knowledge-bases` | GET | <EFBFBD>亥<EFBFBD>摨枏<EFBFBD>銵?| <20>?|
+| `/api/v1/knowledge-bases` | POST | <EFBFBD>𥕦遣<EFBFBD>亥<EFBFBD>摨?| <20>?|
+| `/api/v1/knowledge-bases/:id` | GET | <EFBFBD>亥<EFBFBD>摨栞祕<EFBFBD>?| <20>?|
+| `/api/v1/knowledge-bases/:id` | PUT | <EFBFBD>湔鰵<EFBFBD>亥<EFBFBD>摨?| <20>?|
+| `/api/v1/knowledge-bases/:id` | DELETE | <EFBFBD>𣳇膄<EFBFBD>亥<EFBFBD>摨?| <20>?|

 ### <20><>﹝蝞∠<E89D9E>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/knowledge-bases/:id/documents` | GET | 文档列表 | ✅ |
-| `/api/v1/knowledge-bases/:id/documents` | POST | 上传文档 | ✅ |
-| `/api/v1/knowledge-bases/:id/documents/:docId` | GET | 文档详情 | ✅ |
-| `/api/v1/knowledge-bases/:id/documents/:docId` | DELETE | 删除文档 | ✅ |
+| `/api/v1/knowledge-bases/:id/documents` | GET | <EFBFBD><EFBFBD>﹝<EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/knowledge-bases/:id/documents` | POST | 銝𠹺<EFBFBD><EFBFBD><EFBFBD>﹝ | <EFBFBD>?|
+| `/api/v1/knowledge-bases/:id/documents/:docId` | GET | <EFBFBD><EFBFBD>﹝霂行<EFBFBD> | <EFBFBD>?|
+| `/api/v1/knowledge-bases/:id/documents/:docId` | DELETE | <EFBFBD>𣳇膄<EFBFBD><EFBFBD>﹝ | <EFBFBD>?|

 ### RAG<41>桃<EFBFBD>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/knowledge-bases/:id/chat` | POST | 知识库问答 | ✅ |
-| `/api/v1/knowledge-bases/:id/search` | GET | 语义检索 | ✅ |
+| `/api/v1/knowledge-bases/:id/chat` | POST | <EFBFBD>亥<EFBFBD>摨㯄䔮蝑?| <20>?|
+| `/api/v1/knowledge-bases/:id/search` | GET | 霂凋<EFBFBD>璉<EFBFBD>蝝?| <20>?|

 ---

-## 🧹 数据清洗整理（/api/v1/data-cleaning）
+## <EFBFBD>完 <20>唳旿皜<E697BF><E79A9C><EFBFBD>渡<EFBFBD>嚗?api/v1/data-cleaning嚗?

-**状态：** ⏳ 规划中（P1优先级）  
-**详细设计：** 待设计
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?閫<><E996AB>銝哨<E98A9D>P1隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* 敺<>挽霈?

 ### 皜<><E79A9C>憿寧𤌍

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/data-cleaning/projects` | GET | 清洗项目列表 | ✅ |
-| `/api/v1/data-cleaning/projects` | POST | 创建清洗项目 | ✅ |
-| `/api/v1/data-cleaning/projects/:id` | GET | 项目详情 | ✅ |
+| `/api/v1/data-cleaning/projects` | GET | 皜<EFBFBD><EFBFBD>憿寧𤌍<EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/data-cleaning/projects` | POST | <EFBFBD>𥕦遣皜<EFBFBD><EFBFBD>憿寧𤌍 | <EFBFBD>?|
+| `/api/v1/data-cleaning/projects/:id` | GET | 憿寧𤌍霂行<EFBFBD> | <EFBFBD>?|

 ### ETL<54>滨蔭

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/data-cleaning/projects/:id/etl` | POST | 配置ETL规则 | ✅ |
-| `/api/v1/data-cleaning/projects/:id/execute` | POST | 执行清洗任务 | ✅ |
+| `/api/v1/data-cleaning/projects/:id/etl` | POST | <EFBFBD>滨蔭ETL閫<EFBFBD><EFBFBD> | <EFBFBD>?|
+| `/api/v1/data-cleaning/projects/:id/execute` | POST | <EFBFBD>扯<EFBFBD>皜<EFBFBD><EFBFBD>隞餃𦛚 | <EFBFBD>?|

 ---

-## 📊 智能统计分析（/api/v1/analysis）
+## <EFBFBD><EFBFBD> <20>箄<EFBFBD>蝏蠘恣<E8A098><E681A3><EFBFBD>嚗?api/v1/analysis嚗?

-**状态：** ⏳ 规划中（P2优先级）  
-**详细设计：** 待设计
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?閫<><E996AB>銝哨<E98A9D>P2隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* 敺<>挽霈?

 ### <20><><EFBFBD>憿寧𤌍

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/analysis/projects` | GET | 分析项目列表 | ✅ |
-| `/api/v1/analysis/projects` | POST | 创建分析项目 | ✅ |
-| `/api/v1/analysis/projects/:id/execute` | POST | 执行分析 | ✅ |
+| `/api/v1/analysis/projects` | GET | <EFBFBD><EFBFBD><EFBFBD>憿寧𤌍<EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/analysis/projects` | POST | <EFBFBD>𥕦遣<EFBFBD><EFBFBD><EFBFBD>憿寧𤌍 | <EFBFBD>?|
+| `/api/v1/analysis/projects/:id/execute` | POST | <EFBFBD>扯<EFBFBD><EFBFBD><EFBFBD><EFBFBD> | <EFBFBD>?|

 ---

-## 🔧 统计分析工具（/api/v1/tools）
+## <EFBFBD>圲 蝏蠘恣<E8A098><E681A3><EFBFBD>撌亙<E6928C>嚗?api/v1/tools嚗?

-**状态：** ⏳ 规划中（P2优先级）  
-**详细设计：** 待设计
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?閫<><E996AB>銝哨<E98A9D>P2隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* 敺<>挽霈?

 ### 撌亙<E6928C>靚<EFBFBD>鍂

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/tools` | GET | 工具列表（100+） | ✅ |
-| `/api/v1/tools/:id` | GET | 工具详情 | ✅ |
-| `/api/v1/tools/:id/execute` | POST | 执行工具 | ✅ |
+| `/api/v1/tools` | GET | 撌亙<EFBFBD><EFBFBD>𡑒”嚗?00+嚗?| <20>?|
+| `/api/v1/tools/:id` | GET | 撌亙<EFBFBD>霂行<EFBFBD> | <EFBFBD>?|
+| `/api/v1/tools/:id/execute` | POST | <EFBFBD>扯<EFBFBD>撌亙<EFBFBD> | <EFBFBD>?|

 ---

-## 📄 稿件审查系统（/api/v1/review）
+## <EFBFBD><EFBFBD> 蝔蹂辣摰⊥䰻蝟餌<E89D9F>嚗?api/v1/review嚗?

-**状态：** ✅ 已实现（独立系统）  
-**详细设计：** [RVW/02-API设计](../03-业务模块/RVW-稿件审查系统/02-API设计.md)（待创建）
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?撌脣<E6928C><E884A3>堆<EFBFBD><E5A086>祉<EFBFBD>蝟餌<E89D9F>嚗? 
+**霂衣<EFBFBD>霈曇恣嚗?* [RVW/02-API霈曇恣](../03-銝𡁜𦛚璅∪<EFBFBD>/RVW-蝔蹂辣摰⊥䰻蝟餌<E89D9F>/02-API霈曇恣.md)嚗<EFBFBD><EFBFBD><EFBFBD>𥕦遣嚗?

 ### 摰⊥䰻隞餃𦛚

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/review/tasks` | GET | 审查任务列表 | ✅ |
-| `/api/v1/review/tasks` | POST | 创建审查任务 | ✅ |
-| `/api/v1/review/tasks/:id` | GET | 任务详情 | ✅ |
-| `/api/v1/review/tasks/:id/execute` | POST | 执行审查 | ✅ |
-| `/api/v1/review/tasks/:id/report` | GET | 生成报告（PDF） | ✅ |
+| `/api/v1/review/tasks` | GET | 摰⊥䰻隞餃𦛚<EFBFBD>𡑒” | <EFBFBD>?|
+| `/api/v1/review/tasks` | POST | <EFBFBD>𥕦遣摰⊥䰻隞餃𦛚 | <EFBFBD>?|
+| `/api/v1/review/tasks/:id` | GET | 隞餃𦛚霂行<EFBFBD> | <EFBFBD>?|
+| `/api/v1/review/tasks/:id/execute` | POST | <EFBFBD>扯<EFBFBD>摰⊥䰻 | <EFBFBD>?|
+| `/api/v1/review/tasks/:id/report` | GET | <EFBFBD><EFBFBD><EFBFBD><EFBFBD>亙<EFBFBD>嚗㇊DF嚗?| <20>?|

 ---

-## 🛠️ 运营管理端（/api/v1/admin）
+## <EFBFBD><EFBFBD>儭?餈鞱𨯫蝞∠<E89D9E>蝡荔<E89DA1>/api/v1/admin嚗?

-**状态：** ⏳ 规划中（P1优先级）  
-**详细设计：** [ADMIN/02-API设计](../03-业务模块/ADMIN-运营管理端/02-API设计.md)
+**<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?閫<><E996AB>銝哨<E98A9D>P1隡睃<E99AA1>蝥改<E89DA5>  
+**霂衣<EFBFBD>霈曇恣嚗?* [ADMIN/02-API霈曇恣](../03-銝𡁜𦛚璅∪<EFBFBD>/ADMIN-餈鞱𨯫蝞∠<EFBFBD>蝡?02-API霈曇恣.md)

-### 用户管理 ⭐
+### <EFBFBD>冽<EFBFBD>蝞∠<EFBFBD> 潃?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/users` | GET | 用户列表 | ✅ ADMIN |
-| `/api/v1/admin/users/:id` | GET | 用户详情 | ✅ ADMIN |
-| `/api/v1/admin/users/:id` | PUT | 更新用户 | ✅ ADMIN |
-| `/api/v1/admin/users/:id/plan` | PUT | 修改套餐 | ✅ ADMIN |
-| `/api/v1/admin/users/:id/disable` | POST | 禁用用户 | ✅ ADMIN |
+| `/api/v1/admin/users` | GET | <EFBFBD>冽<EFBFBD><EFBFBD>𡑒” | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id` | GET | <EFBFBD>冽<EFBFBD>霂行<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id` | PUT | <EFBFBD>湔鰵<EFBFBD>冽<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id/plan` | PUT | 靽格㺿憟烾<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id/disable` | POST | 蝳<EFBFBD>鍂<EFBFBD>冽<EFBFBD> | <EFBFBD>?ADMIN |

-### Feature Flag管理 ⭐
+### Feature Flag蝞∠<EFBFBD> 潃?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/feature-flags` | GET | Flag列表 | ✅ ADMIN |
-| `/api/v1/admin/feature-flags` | POST | 创建Flag | ✅ ADMIN |
-| `/api/v1/admin/feature-flags/:id` | PUT | 更新Flag | ✅ ADMIN |
-| `/api/v1/admin/users/:id/flags` | GET | 用户Flag | ✅ ADMIN |
-| `/api/v1/admin/users/:id/flags` | PUT | 更新用户Flag | ✅ ADMIN |
+| `/api/v1/admin/feature-flags` | GET | Flag<EFBFBD>𡑒” | <EFBFBD>?ADMIN |
+| `/api/v1/admin/feature-flags` | POST | <EFBFBD>𥕦遣Flag | <EFBFBD>?ADMIN |
+| `/api/v1/admin/feature-flags/:id` | PUT | <EFBFBD>湔鰵Flag | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id/flags` | GET | <EFBFBD>冽<EFBFBD>Flag | <EFBFBD>?ADMIN |
+| `/api/v1/admin/users/:id/flags` | PUT | <EFBFBD>湔鰵<EFBFBD>冽<EFBFBD>Flag | <EFBFBD>?ADMIN |

-### LLM模型管理 ⭐
+### LLM璅∪<EFBFBD>蝞∠<EFBFBD> 潃?

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/llm/models` | GET | 模型列表 | ✅ ADMIN |
-| `/api/v1/admin/llm/models` | POST | 添加模型 | ✅ ADMIN |
-| `/api/v1/admin/llm/models/:id` | PUT | 更新模型 | ✅ ADMIN |
-| `/api/v1/admin/llm/usage` | GET | LLM使用统计 | ✅ ADMIN |
-| `/api/v1/admin/llm/cost-analysis` | GET | 成本分析 | ✅ ADMIN |
+| `/api/v1/admin/llm/models` | GET | 璅∪<EFBFBD><EFBFBD>𡑒” | <EFBFBD>?ADMIN |
+| `/api/v1/admin/llm/models` | POST | 瘛餃<EFBFBD>璅∪<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/llm/models/:id` | PUT | <EFBFBD>湔鰵璅∪<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/llm/usage` | GET | LLM雿輻鍂蝏蠘恣 | <EFBFBD>?ADMIN |
+| `/api/v1/admin/llm/cost-analysis` | GET | <EFBFBD>鞉𧋦<EFBFBD><EFBFBD><EFBFBD> | <EFBFBD>?ADMIN |

 ### Prompt蝞∠<E89D9E>

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/prompts` | GET | Prompt列表 | ✅ ADMIN |
-| `/api/v1/admin/prompts` | POST | 创建Prompt | ✅ ADMIN |
-| `/api/v1/admin/prompts/:id` | PUT | 更新Prompt | ✅ ADMIN |
+| `/api/v1/admin/prompts` | GET | Prompt<EFBFBD>𡑒” | <EFBFBD>?ADMIN |
+| `/api/v1/admin/prompts` | POST | <EFBFBD>𥕦遣Prompt | <EFBFBD>?ADMIN |
+| `/api/v1/admin/prompts/:id` | PUT | <EFBFBD>湔鰵Prompt | <EFBFBD>?ADMIN |

 ### <20>亙<EFBFBD><E4BA99>亥砭

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/logs` | GET | 日志列表 | ✅ ADMIN |
-| `/api/v1/admin/logs/errors` | GET | 错误日志 | ✅ ADMIN |
-| `/api/v1/admin/logs/operations` | GET | 操作日志 | ✅ ADMIN |
+| `/api/v1/admin/logs` | GET | <EFBFBD>亙<EFBFBD><EFBFBD>𡑒” | <EFBFBD>?ADMIN |
+| `/api/v1/admin/logs/errors` | GET | <EFBFBD>躰秤<EFBFBD>亙<EFBFBD> | <EFBFBD>?ADMIN |
+| `/api/v1/admin/logs/operations` | GET | <EFBFBD>滢<EFBFBD><EFBFBD>亙<EFBFBD> | <EFBFBD>?ADMIN |

 ### <20>唳旿<E594B3>亥”

 | 蝡舐<E89DA1> | <20>寞<EFBFBD> | 霂湔<E99C82> | 霈方<E99C88> |
 |------|------|------|------|
-| `/api/v1/admin/reports/overview` | GET | 总览数据 | ✅ ADMIN |
-| `/api/v1/admin/reports/users` | GET | 用户活跃度 | ✅ ADMIN |
-| `/api/v1/admin/reports/features` | GET | 功能使用率 | ✅ ADMIN |
-| `/api/v1/admin/reports/llm` | GET | LLM统计 | ✅ ADMIN |
+| `/api/v1/admin/reports/overview` | GET | <EFBFBD>餉<EFBFBD><EFBFBD>唳旿 | <EFBFBD>?ADMIN |
+| `/api/v1/admin/reports/users` | GET | <EFBFBD>冽<EFBFBD>瘣餉<EFBFBD>摨?| <20>?ADMIN |
+| `/api/v1/admin/reports/features` | GET | <EFBFBD>蠘<EFBFBD>雿輻鍂<EFBFBD>?| <20>?ADMIN |
+| `/api/v1/admin/reports/llm` | GET | LLM蝏蠘恣 | <EFBFBD>?ADMIN |

 ---

 ## <20><> 頝舐眏蝏蠘恣

-### 按模块统计
+### <EFBFBD>㗇芋<EFBFBD>㛖<EFBFBD>霈?

-| 模块 | 端点数量 | 状态 |
+| 璅∪<EFBFBD> | 蝡舐<E89DA1><E88890>圈<EFBFBD> | <20>嗆<EFBFBD>?|
 |------|---------|------|
-| 认证与用户 | 10 | ✅ 已实现 |
-| LLM网关 | 5 | ❌ 待实现 |
-| AI智能问答 | 8 | ✅ 已实现 |
-| AI智能文献 | 15 | ⏳ 设计中 |
-| 个人知识库 | 10 | ✅ 已实现 |
-| 数据清洗 | 5 | ⏳ 规划中 |
-| 智能统计分析 | 3 | ⏳ 规划中 |
-| 统计工具 | 3 | ⏳ 规划中 |
-| 稿件审查 | 5 | ✅ 已实现 |
-| 运营管理端 | 20 | ⏳ 规划中 |
+| 霈方<EFBFBD>銝𡒊鍂<EFBFBD>?| 10 | <20>?撌脣<E6928C><E884A3>?|
+| LLM蝵穃<EFBFBD> | 5 | <EFBFBD>?敺<><E695BA><EFBFBD>?|
+| AI<EFBFBD>箄<EFBFBD><EFBFBD>桃<EFBFBD> | 8 | <EFBFBD>?撌脣<E6928C><E884A3>?|
+| AI<EFBFBD>箄<EFBFBD><EFBFBD><EFBFBD>讃 | 15 | <EFBFBD>?霈曇恣銝?|
+| 銝芯犖<EFBFBD>亥<EFBFBD>摨?| 10 | <20>?撌脣<E6928C><E884A3>?|
+| <EFBFBD>唳旿皜<EFBFBD><EFBFBD> | 5 | <EFBFBD>?閫<><E996AB>銝?|
+| <EFBFBD>箄<EFBFBD>蝏蠘恣<EFBFBD><EFBFBD><EFBFBD> | 3 | <20>?閫<><E996AB>銝?|
+| 蝏蠘恣撌亙<EFBFBD> | 3 | <EFBFBD>?閫<><E996AB>銝?|
+| 蝔蹂辣摰⊥䰻 | 5 | <EFBFBD>?撌脣<E6928C><E884A3>?|
+| 餈鞱𨯫蝞∠<EFBFBD>蝡?| 20 | <20>?閫<><E996AB>銝?|
 | **<EFBFBD>餉恣** | **~85** | - |

 ---

-## ⚠️ 路由冲突检查
+## <EFBFBD>𩤃<EFBFBD> 頝舐眏<E88890>脩<EFBFBD>璉<EFBFBD><E79289>?

 ### 瞏𨅯銁<F0A885AF>脩<EFBFBD>

-**❌ 避免冲突：**
+**<EFBFBD>?<3F>踹<EFBFBD><E8B8B9>脩<EFBFBD>嚗?*
 ```
-# 错误：模块名称冲突
+# <EFBFBD>躰秤嚗𡁏芋<EFBFBD>堒<EFBFBD>蝘啣<EFBFBD>蝒?
 /api/v1/admin/users    # 蝞∠<E89D9E>蝡舐<E89DA1><E88890>冽<EFBFBD>蝞∠<E89D9E>
 /api/v1/users          # 撟喳蝱撅<E89DB1><E69285><EFBFBD>冽<EFBFBD>蝞∠<E89D9E>

-# 正确：明确区分
+# 甇<EFBFBD>＆嚗𡁏<EFBFBD>蝖桀躹<EFBFBD>?
 /api/v1/auth/profile   # 敶枏<E695B6><E69E8F>冽<EFBFBD>靽⊥<E99DBD>
 /api/v1/admin/users    # 蝞∠<E89D9E>蝡舐鍂<E88890>嵩RUD
 ```

 ---

-## 🔍 快速查找指南
+## <EFBFBD><EFBFBD> 敹恍<E695B9><E6818D>䰻<EFBFBD>暹<EFBFBD><E69AB9>?

 ### <20>箸艶1嚗𡁏䰻<F0A1818F>暹<EFBFBD>銝芣芋<E88AA3>㛖<EFBFBD><E39B96><EFBFBD><EFBFBD>𡅅PI
-1. 在上面的表格中找到对应模块
+1. <EFBFBD>其<EFBFBD><EFBFBD>Ｙ<EFBFBD>銵冽聢銝剜𪄳<EFBFBD>啣笆摨娍芋<EFBFBD>?
 2. <20>孵稬"霂衣<E99C82>霈曇恣"<22>暹𦻖
 3. <20>亦<EFBFBD>霂交芋<E4BAA4>㛖<EFBFBD>摰峕㟲API<50><49>﹝

 ### <20>箸艶2嚗朞挽霈⊥鰵API蝡舐<E89DA1>
-1. 查看本文档，确保路由不冲突
+1. <EFBFBD>亦<EFBFBD><EFBFBD>祆<EFBFBD>獢<EFBFBD><EFBFBD>蝖桐<EFBFBD>頝舐眏銝滚<EFBFBD>蝒?
 2. <20><><EFBFBD><EFBFBD>API霈曇恣閫<E681A3><E996AB>](./02-API霈曇恣閫<E681A3><E996AB>.md)
 3. 雿輻鍂[API霈曇恣璅⊥踎](../_templates/API霈曇恣-璅⊥踎.md)

 ### <20>箸艶3嚗𡁏䰻<F0A1818F>见<EFBFBD>撅<EFBFBD>API<50>嗆<EFBFBD>
 1. <20><>粉<EFBFBD>祆<EFBFBD>獢<EFBFBD><E78DA2>敹恍<E695B9>煺<EFBFBD>閫<EFBFBD><E996AB><EFBFBD>厩垢<E58EA9>對<EFBFBD>
-2. 查看[架构设计全景图](../00-系统总体设计/08-架构设计全景图.md)
+2. <EFBFBD>亦<EFBFBD>[<5B>嗆<EFBFBD>霈曇恣<E69B87>冽艶<E586BD>霄(../00-蝟餌<E89D9F><E9A48C>颱<EFBFBD>霈曇恣/08-<2D>嗆<EFBFBD>霈曇恣<E69B87>冽艶<E586BD>?md)

 ---

 ## <20><> <20>詨<EFBFBD><E8A9A8><EFBFBD>﹝

-**规范：**
- [API设计规范](./02-API设计规范.md) ⭐ 必读
- [认证与授权规范](./02-API设计规范.md#认证与授权)
+**閫<EFBFBD><EFBFBD>嚗?*
+- [API霈曇恣閫<EFBFBD><EFBFBD>](./02-API霈曇恣閫<EFBFBD><EFBFBD>.md) 潃?敹<>粉
+- [霈方<EFBFBD>銝擧<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>(./02-API霈曇恣閫<E681A3><E996AB>.md#霈方<EFBFBD>銝擧<EFBFBD><EFBFBD>?

-**模板：**
+**璅⊥踎嚗?*
 - [API霈曇恣璅⊥踎](../_templates/API霈曇恣-璅⊥踎.md)

 **<EFBFBD>唳旿摨橒<EFBFBD>**
@@ -376,7 +376,7 @@

 **<EFBFBD><EFBFBD><EFBFBD>擧凒<EFBFBD>堆<EFBFBD>** 2025-11-06  
 **蝏湔擪鈭綽<E988AD>** <20><><EFBFBD>舀沲<E88880><E6B2B2><EFBFBD>  
-**版本：** v1.0
+**<EFBFBD><EFBFBD>𧋦嚗?* v1.0