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%)
This commit is contained in:
@@ -1,28 +1,19 @@
|
||||
# 🚀 给新AI助手的快速指南
|
||||
|
||||
> **更新时间:** 2026-01-12
|
||||
> **当前状态:** ✅ Phase 3.5.5 代码改造已完成,待端到端测试
|
||||
|
||||
# <EFBFBD><EFBFBD> 蝏蹱鰵AI<41>拇<EFBFBD><E68B87><EFBFBD>翰<EFBFBD><E7BFB0><EFBFBD><EFBFBD>?
|
||||
> **<2A>湔鰵<E6B994>園𡢿嚗?* 2026-01-12
|
||||
> **敶枏<EFBFBD><EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>** <20>?Phase 3.5.5 隞<><E99A9E><EFBFBD>寥<EFBFBD>惩歇摰峕<E691B0>嚗<EFBFBD><E59A97>蝡臬<E89DA1>蝡舀<E89DA1>霂?
|
||||
---
|
||||
|
||||
## ⚡ 30秒了解当前状态
|
||||
|
||||
## <EFBFBD>?30蝘雴<E89D98>閫<EFBFBD><E996AB><EFBFBD>滨𠶖<E6BBA8>?
|
||||
```
|
||||
✅ Phase 3.5.1-3.5.5 代码改造已完成(95%)
|
||||
⏳ 待完成:端到端测试验证
|
||||
|
||||
<EFBFBD>?Phase 3.5.1-3.5.5 隞<EFBFBD><EFBFBD><EFBFBD>寥<EFBFBD>惩歇摰峕<EFBFBD>嚗?5%嚗?<3F>?敺<><E695BA><EFBFBD>琜<EFBFBD>蝡臬<E89DA1>蝡舀<E89DA1>霂閖<E99C82>霂?
|
||||
撌脣<EFBFBD><EFBFBD>琜<EFBFBD>
|
||||
✅ 数据库:capability_schema + prompt_templates + prompt_versions
|
||||
✅ 后端:PromptService(596行)+ 8个API接口
|
||||
✅ 前端:管理端架构 + Prompt列表 + 编辑器(CodeMirror 6)
|
||||
✅ 测试:后端单元测试全部通过
|
||||
✅ RVW集成:editorialService + methodologyService 已改造(2026-01-12)
|
||||
|
||||
<EFBFBD>?<3F>唳旿摨橒<E691A8>capability_schema + prompt_templates + prompt_versions
|
||||
<EFBFBD>?<3F>𡒊垢嚗䥪romptService嚗?96銵䕘<E98AB5>+ 8銝服PI<50>亙藁
|
||||
<EFBFBD>?<3F>滨垢嚗𡁶恣<F0A181B6><E681A3>垢<EFBFBD>嗆<EFBFBD> + Prompt<70>𡑒” + 蝻𤥁<E89DBB><F0A4A581>剁<EFBFBD>CodeMirror 6嚗? <20>?瘚贝<E7989A>嚗𡁜<E59A97>蝡臬<E89DA1><E887AC><EFBFBD><EFBFBD>霂訫<E99C82><E8A8AB>券<EFBFBD>朞<EFBFBD>
|
||||
<EFBFBD>?RVW<56><57><EFBFBD>嚗塄ditorialService + methodologyService 撌脫㺿<E884AB>𩤃<EFBFBD>2026-01-12嚗?
|
||||
銝衤<EFBFBD>甇伐<EFBFBD>
|
||||
→ 启动后端服务测试
|
||||
→ 端到端测试灰度预览功能
|
||||
→ 更新完成度文档
|
||||
```
|
||||
<EFBFBD>?<3F>臬𢆡<E887AC>𡒊垢<F0A1928A>滚𦛚瘚贝<E7989A>
|
||||
<EFBFBD>?蝡臬<E89DA1>蝡舀<E89DA1>霂閧<E99C82>摨阡<E691A8>閫<EFBFBD><E996AB><EFBFBD>? <20>?<3F>湔鰵摰峕<E691B0>摨行<E691A8>獢?```
|
||||
|
||||
---
|
||||
|
||||
@@ -33,33 +24,30 @@
|
||||
| <20><>辣 | 霂湔<E99C82> | 銵峕㺭 |
|
||||
|------|------|------|
|
||||
| `backend/src/common/prompt/prompt.service.ts` | PromptService <20>詨<EFBFBD><E8A9A8>餉<EFBFBD> | 596 |
|
||||
| `backend/src/modules/rvw/services/editorialService.ts` | RVW 稿约评估服务 ✅ 已改造 | 83 |
|
||||
| `backend/src/modules/rvw/services/methodologyService.ts` | RVW 方法学评估服务 ✅ 已改造 | 83 |
|
||||
| `backend/src/modules/rvw/workers/reviewWorker.ts` | RVW Worker ✅ 已更新传递userId | 193 |
|
||||
| `frontend-v2/src/pages/admin/PromptEditorPage.tsx` | Prompt 编辑器页面 | 399 |
|
||||
| `backend/src/modules/rvw/services/editorialService.ts` | RVW 蝔輻漲霂<EFBFBD>摯<EFBFBD>滚𦛚 <20>?撌脫㺿<E884AB>?| 83 |
|
||||
| `backend/src/modules/rvw/services/methodologyService.ts` | RVW <EFBFBD>寞<EFBFBD>摮西<EFBFBD>隡唳<EFBFBD><EFBFBD>?<3F>?撌脫㺿<E884AB>?| 83 |
|
||||
| `backend/src/modules/rvw/workers/reviewWorker.ts` | RVW Worker <EFBFBD>?撌脫凒<E884AB>唬<EFBFBD><E594AC>𠌊serId | 193 |
|
||||
| `frontend-v2/src/pages/admin/PromptEditorPage.tsx` | Prompt 蝻𤥁<EFBFBD><EFBFBD>券△<EFBFBD>?| 399 |
|
||||
|
||||
### <20><>﹝嚗<EFB99D><E59A97>霂鳴<E99C82>
|
||||
|
||||
| <20><>﹝ | <20><>捆 |
|
||||
|------|------|
|
||||
| `04-开发计划/01-TODO清单(可追踪).md` | 详细任务清单(79/110 完成)|
|
||||
| `04-开发计划/02-Prompt管理系统开发计划.md` | 完整开发计划 |
|
||||
| `04-撘<EFBFBD><EFBFBD>𤏸恣<EFBFBD>?01-TODO皜<4F><E79A9C>嚗<EFBFBD>虾餈質葵嚗?md` | 霂衣<EFBFBD>隞餃𦛚皜<EFBFBD><EFBFBD>嚗?9/110 摰峕<EFBFBD>嚗车
|
||||
| `04-撘<EFBFBD><EFBFBD>𤏸恣<EFBFBD>?02-Prompt蝞∠<EFBFBD>蝟餌<EFBFBD>撘<EFBFBD><EFBFBD>𤏸恣<EFBFBD>?md` | 摰峕㟲撘<EFBFBD><EFBFBD>𤏸恣<EFBFBD>?|
|
||||
| `00-Phase3.5摰峕<EFBFBD><EFBFBD>餌<EFBFBD>.md` | 撌脣<E6928C><E884A3>𣂼極雿𨀣<E99BBF>餌<EFBFBD> |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Phase 3.5.5 任务详解(✅ 代码改造已完成 2026-01-12)
|
||||
|
||||
### ✅ 任务 1:改造 editorialService.ts - 已完成
|
||||
|
||||
## <EFBFBD>㴓 Phase 3.5.5 隞餃𦛚霂西圾嚗<EFBFBD><EFBFBD> 隞<><E99A9E><EFBFBD>寥<EFBFBD>惩歇摰峕<E691B0> 2026-01-12嚗?
|
||||
### <20>?隞餃𦛚 1嚗𡁏㺿<F0A1818F>?editorialService.ts - 撌脣<E6928C><E884A3>?
|
||||
**<2A>寥<EFBFBD>惩<EFBFBD>**嚗<><E59A97>隞嗉粉<E59789>吔<EFBFBD>
|
||||
```typescript
|
||||
const PROMPT_PATH = path.join(__dirname, '../../../../prompts/review_editorial_system.txt');
|
||||
const prompt = fs.readFileSync(PROMPT_PATH, 'utf-8');
|
||||
```
|
||||
|
||||
**改造后**(PromptService)
|
||||
```typescript
|
||||
**<EFBFBD>寥<EFBFBD>惩<EFBFBD>**嚗㇊romptService嚗?```typescript
|
||||
import { prisma } from '../../../config/database.js';
|
||||
import { getPromptService } from '../../../common/prompt/index.js';
|
||||
|
||||
@@ -71,34 +59,28 @@ if (isDraft) {
|
||||
}
|
||||
```
|
||||
|
||||
### ✅ 任务 2:改造 methodologyService.ts - 已完成
|
||||
|
||||
### <EFBFBD>?隞餃𦛚 2嚗𡁏㺿<F0A1818F>?methodologyService.ts - 撌脣<EFBFBD><EFBFBD>?
|
||||
**<2A>寥<EFBFBD>惩<EFBFBD>**
|
||||
```typescript
|
||||
const { content: systemPrompt, isDraft } = await promptService.get('RVW_METHODOLOGY', {}, { userId });
|
||||
```
|
||||
|
||||
### ✅ 任务 3:更新 reviewWorker.ts - 已完成
|
||||
|
||||
**改造后** - 传递 userId 支持灰度预览
|
||||
### <EFBFBD>?隞餃𦛚 3嚗𡁏凒<F0A1818F>?reviewWorker.ts - 撌脣<EFBFBD><EFBFBD>?
|
||||
**<2A>寥<EFBFBD>惩<EFBFBD>** - 隡𣳇<E99AA1>?userId <20>舀<EFBFBD><E88880>啣漲憸<E6BCB2><E686B8>
|
||||
```typescript
|
||||
// ✅ Phase 3.5.5: 传递 userId 支持灰度预览
|
||||
// <EFBFBD>?Phase 3.5.5: 隡𣳇<EFBFBD>?userId <EFBFBD>舀<EFBFBD><EFBFBD>啣漲憸<EFBFBD><EFBFBD>
|
||||
editorialResult = await reviewEditorialStandards(extractedText, modelType, userId);
|
||||
methodologyResult = await reviewMethodology(extractedText, modelType, userId);
|
||||
```
|
||||
|
||||
### ⏳ 任务 4:端到端测试 - 待验证
|
||||
|
||||
### <EFBFBD>?隞餃𦛚 4嚗𡁶垢<F0A181B6>啁垢瘚贝<E7989A> - 敺<><E695BA>霂?
|
||||
**瘚贝<E7989A>甇仿炊**
|
||||
1. 登录 Prompt工程师(`13800000002` / `123456`)
|
||||
2. 进入 `/admin/prompts`
|
||||
3. 编辑 `RVW_EDITORIAL`,修改一处内容(如添加"测试")
|
||||
4. 保存草稿
|
||||
1. <20>餃<EFBFBD> Prompt撌亦<EFBFBD>撣<EFBFBD><EFBFBD>`13800000002` / `123456`嚗?2. 餈𥕦<E9A488> `/admin/prompts`
|
||||
3. 蝻𤥁<E89DBB> `RVW_EDITORIAL`嚗䔶耨<E494B6>嫣<EFBFBD>憭<EFBFBD><E686AD>摰對<E691B0>憒<EFBFBD>溶<EFBFBD>?瘚贝<E7989A>"嚗?4. 靽嘥<E99DBD><E598A5>厩阮
|
||||
5. 撘<><E69298>航<EFBFBD>霂閙芋撘𧶏<E69298><F0A7B68F>㗇𥋘 RVW 璅∪<E79285>
|
||||
6. <20><>揢<EFBFBD>唬<EFBFBD><E594AC>∠垢 `/rvw`
|
||||
7. 上传一个文档,查看审查结果是否使用了修改后的 Prompt
|
||||
8. 验证普通用户仍使用旧版本
|
||||
|
||||
7. 銝𠹺<E98A9D>銝<EFBFBD>銝芣<E98A9D>獢<EFBFBD><E78DA2><EFBFBD>亦<EFBFBD>摰⊥䰻蝏𤘪<E89D8F><F0A498AA>臬炏雿輻鍂鈭<E98D82>耨<EFBFBD>孵<EFBFBD><E5ADB5>?Prompt
|
||||
8. 撉諹<E69289><E8ABB9>桅<EFBFBD>𡁶鍂<F0A181B6>瑚<EFBFBD>雿輻鍂<E8BCBB>抒<EFBFBD><E68A92>?
|
||||
---
|
||||
|
||||
## <20><> <20>喲睸隞<E79DB8><E99A9E>蝷箔<E89DB7>
|
||||
@@ -129,8 +111,7 @@ const llmResponse = await llm.chat(messages, {
|
||||
### 靚<><E99D9A>璅∪<E79285> API
|
||||
|
||||
```typescript
|
||||
// 开启调试(只调试 RVW)
|
||||
POST /api/admin/prompts/debug
|
||||
// 撘<><E69298>航<EFBFBD>霂𤏪<E99C82><F0A48FAA>芾<EFBFBD>霂?RVW嚗?POST /api/admin/prompts/debug
|
||||
{
|
||||
"modules": ["RVW"],
|
||||
"enabled": true
|
||||
@@ -146,10 +127,9 @@ POST /api/admin/prompts/debug
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 环境信息
|
||||
|
||||
### 数据库
|
||||
## <EFBFBD><EFBFBD>儭?<3F>臬<EFBFBD>靽⊥<E99DBD>
|
||||
|
||||
### <20>唳旿摨?
|
||||
```
|
||||
Host: localhost
|
||||
Port: 5432
|
||||
@@ -170,32 +150,30 @@ Password: postgres123
|
||||
```
|
||||
蝡臬藁: 3000
|
||||
<EFBFBD>臬𢆡: cd frontend-v2 && npm run dev
|
||||
代理: /api -> http://localhost:3001 (已配置)
|
||||
隞<EFBFBD><EFBFBD>: /api -> http://localhost:3001 (撌脤<EFBFBD>蝵?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## <20>𩤃<EFBFBD> 撣貉<E692A3><E8B289>桅<EFBFBD>
|
||||
|
||||
### 1. Prisma Client 找不到 prompt_templates
|
||||
### 1. Prisma Client <EFBFBD>曆<EFBFBD><EFBFBD>?prompt_templates
|
||||
|
||||
**解决**:运行 `npx prisma generate`
|
||||
**閫<EFBFBD><EFBFBD>**嚗朞<E59A97>銵?`npx prisma generate`
|
||||
|
||||
### 2. <20>滨垢靚<E59EA2>鍂 API 401
|
||||
|
||||
**閫<><E996AB>**嚗𡁏<E59A97><F0A1818F>交糓<E4BAA4>血歇<E8A180>餃<EFBFBD>嚗𥇍WT Token <20>臬炏<E887AC>㗇<EFBFBD>
|
||||
|
||||
### 3. CodeMirror 不显示
|
||||
|
||||
**解决**:检查是否安装了 `codemirror` 和 `@codemirror/*` 依赖
|
||||
### 3. CodeMirror 銝齿遬蝷?
|
||||
**閫<><E996AB>**嚗𡁏<E59A97><F0A1818F>交糓<E4BAA4>血<EFBFBD>鋆<EFBFBD><E98B86> `codemirror` <20>?`@codemirror/*` 靘肽<E99D98>
|
||||
|
||||
---
|
||||
|
||||
## <20><> <20>𠉛頂靽⊥<E99DBD>
|
||||
|
||||
如有疑问,请查阅:
|
||||
- 技术设计:`02-技术设计/03-Prompt管理系统快速参考.md`
|
||||
- 开发规范:`../../04-开发规范/`
|
||||
憒<EFBFBD><EFBFBD><EFBFBD>煾䔮嚗諹窈<EFBFBD>仿<EFBFBD>嚗?- <20><><EFBFBD>航挽霈∴<E99C88>`02-<2D><><EFBFBD>航挽霈?03-Prompt蝞∠<E89D9E>蝟餌<E89D9F>敹恍<E695B9>笔<EFBFBD><E7AC94>?md`
|
||||
- 撘<><E69298>𤏸<EFBFBD><F0A48FB8><EFBFBD><EFBFBD>`../../04-撘<><E69298>𤏸<EFBFBD><F0A48FB8>?`
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user