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:
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions

View File

@@ -1,27 +1,27 @@
# **Prompt管理系统快速参考**
# **Prompt蝞∠<EFBFBD>蝟餌<EFBFBD>敹恍<EFBFBD><EFBFBD><EFBFBD>?*
> **版本:** v1.0
> **优先级:** P0核心通用能力
> **状态:** 待开发
> **<EFBFBD><EFBFBD>𧋦嚗?* v1.0
> **隡睃<EFBFBD>蝥改<EFBFBD>** P0嚗<30>瓲敹<E793B2><E695B9>𡁶鍂<F0A181B6><EFBFBD>嚗?
> **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>** 敺<><E695BA><EFBFBD>?
---
## <20><> <20><EFBFBD><EFBFBD>
### 什么是Prompt管理系统?
### <EFBFBD><EFBFBD>Prompt蝞∠<EFBFBD>蝟餌<EFBFBD>嚗?
一个允许**专业人员在生产环境安全调试AI Prompt**的灰度预览系统。
<EFBFBD>銝芸<EFBFBD>霈?*銝㮖<E98A9D>鈭箏<E988AD><E7AE8F><EFBFBD>鈭抒㴓憓<E3B493><E68693><EFBFBD><EFBFBD>霂𧭈I Prompt**<2A><><EFBFBD>摨阡<E691A8><EFBFBD>頂蝏麄<E89D8F>?
### 为什么需要它?
### 銝箔<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>嚗?
- **痛点1** 测试环境无法模拟真实医学数据20篇文献、真实病历
- **痛点2** 每次调整Prompt需要改代码→部署→等待5分钟
- **痛点3** 临床专家无法参与调试(他们不会写代码)
- **解决:** 生产环境灰度预览 + 调试者角色 + DRAFT/ACTIVE版本隔离
- <EFBFBD>?**<2A>𤤿<EFBFBD>1嚗?* 瘚贝<E7989A><E8B49D><EFBFBD><E887AC><EFBFBD>璅⊥<E79285><E28AA5><EFBFBD><E7AC94>餃郎<E9A483>唳旿嚗?0蝭<30><E89DAD><EFBFBD><EFBFBD><E69FB4><EFBFBD>摰䂿<E691B0><E482BF><EFBFBD><EFBFBD>
- <EFBFBD>?**<2A>𤤿<EFBFBD>2嚗?* 瘥𤩺活靚<E6B4BB>㟲Prompt<70><74><EFBFBD>㺿隞<E3BABF><E99A9E><EFBFBD><EFBFBD>蝵聆<E89DB5>蝑匧<E89D91>嚗?<3F><><EFBFBD>嚗?
- <EFBFBD>?**<2A>𤤿<EFBFBD>3嚗?* 銝游<E98A9D>銝枏振<E69E8F><EFBFBD><E4ADBE><EFBFBD><EFBFBD><EFBFBD><E99D9A><EFBFBD><E59A97>隞砌<E99A9E>隡𡁜<E99AA1><EFBFBD><E99A9E>嚗?
- <EFBFBD>?**閫<><E996AB>嚗?* <20>煺漣<E785BA><EFBFBD><E887AC>啣漲憸<E6BCB2><E686B8> + 靚<><E99D9A><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?+ DRAFT/ACTIVE<EFBFBD><EFBFBD>𧋦<EFBFBD>𠉛氖
---
## 🗂️ 数据库Schema
## <EFBFBD><EFBFBD>儭?<3F>唳旿摨廍chema
### 雿滨蔭嚗䫤capability_schema`
@@ -31,7 +31,7 @@
model PromptTemplate {
id Int @id @default(autoincrement())
code String @unique // 'ASL_SCREENING_TitleAbstract'
name String // "ASL标题摘要筛选"
name String // "ASL<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑偦<EFBFBD>?
module String // ASL, DC, IIT, AIA, PKB, RVW
description String?
variables Json? // ["title", "abstract"]
@@ -48,11 +48,11 @@ model PromptTemplate {
model PromptVersion {
id Int @id @default(autoincrement())
templateId Int @map("template_id")
version Int // 版本号
version Int // <EFBFBD><EFBFBD>𧋦<EFBFBD>?
content String @db.Text // Prompt<70><74>
modelConfig Json? // {"temperature": 0.1}
status PromptStatus @default(DRAFT)
changelog String? // "增加了排除标准"
changelog String? // "憓𧼮<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
createdBy String? @map("created_by") // UserID嚗<44>恣霈∴<E99C88>
template PromptTemplate @relation(fields: [templateId], references: [id])
@@ -66,7 +66,7 @@ model PromptVersion {
}
enum PromptStatus {
DRAFT // 草稿仅Debug模式可见
DRAFT // <EFBFBD>厩阮嚗<EFBFBD><EFBFBD>Debug璅<EFBFBD><EFBFBD><EFBFBD>嚗?
ACTIVE // <20>煺漣<E785BA><E6BCA3>𧋦
ARCHIVED // 敶埝﹝
@@ -76,15 +76,15 @@ enum PromptStatus {
---
## 🔐 权限与角色
## <EFBFBD><EFBFBD> <20><><EFBFBD>銝舘<E98A9D><E88898>?
### <20><EFBFBD><E595A3><EFBFBD><EFBFBD>
| <20><><EFBFBD> Code | <20>讛膩 | <20><>鍂閫坿𠧧 |
|-----------|------|---------|
| `prompt:view` | 查看Prompt列表和历史 | SUPER_ADMIN, PROMPT_ENGINEER |
| `prompt:view` | <EFBFBD><EFBFBD>Prompt<EFBFBD>𡑒”<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| SUPER_ADMIN, PROMPT_ENGINEER |
| `prompt:edit` | <20>𥕦遣/靽格㺿DRAFT<46><54>𧋦 | SUPER_ADMIN, PROMPT_ENGINEER |
| `prompt:debug` | **开启调试模式** | SUPER_ADMIN, PROMPT_ENGINEER |
| `prompt:debug` | 潃?**撘<><E69298><EFBFBD>霂閙芋撘?* | SUPER_ADMIN, PROMPT_ENGINEER |
| `prompt:publish` | <20><EFBFBD>DRAFT<46>𡒶CTIVE | SUPER_ADMIN, PROMPT_ENGINEER |
### <20><EFBFBD>閫坿𠧧
@@ -103,15 +103,15 @@ enum UserRole {
## <20><> <20><EFBFBD>API
### 管理端接口
### 蝞∠<EFBFBD>蝡舀𦻖<EFBFBD>?
| <20><EFBFBD> | 頝臬<E9A09D> | <20><><EFBFBD> | <20>讛膩 |
|------|------|------|------|
| GET | `/api/admin/prompts` | prompt:view | 获取所有模板 |
| GET | `/api/admin/prompts` | prompt:view | <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>㗇芋<EFBFBD>?|
| GET | `/api/admin/prompts/:id` | prompt:view | <20><EFBFBD>霂行<E99C82>+<2B><><EFBFBD><E89FAE>𧋦 |
| POST | `/api/admin/prompts/draft` | prompt:edit | 靽嘥<E99DBD><E598A5>厩阮 |
| POST | `/api/admin/prompts/publish` | prompt:publish | <20><EFBFBD> |
| POST | `/api/admin/prompts/debug` | prompt:debug | **开关调试模式** |
| POST | `/api/admin/prompts/debug` | prompt:debug | **<EFBFBD><EFBFBD><EFBFBD>霂閙芋撘?* |
### 銝𡁜𦛚璅<E79285><E288AA><EFBFBD><EFBFBD>
@@ -126,7 +126,7 @@ export class ScreeningService {
const prompt = await promptService.get(
'ASL_SCREENING_TitleAbstract',
{ title: paper.title, abstract: paper.abstract },
userId // ⭐ 必须传入userId
userId // 潃?敹<>◆隡惩<E99AA1>userId
);
return await llmGateway.chat(prompt);
@@ -138,7 +138,7 @@ export class ScreeningService {
## <20><20>滨垢蝏<E59EA2>
### 全局调试开关
### <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```tsx
// frontend-v2/src/modules/admin/components/PromptDebugSwitch.tsx
@@ -175,18 +175,18 @@ export const PromptDebugSwitch = () => {
## <20><> 瘨匧<E798A8><E79285>
| 模块 | 核心场景 | 复杂度 | 优先级 |
| <EFBFBD> | <20><EFBFBD><E8A9A8>箸艶 | 憭齿<E686AD>摨?| 隡睃<E99AA1>蝥?|
|------|---------|-------|--------|
| **ASL** | 标题摘要初筛、全文复筛、证据合成 | ⭐⭐⭐⭐⭐ | P0 |
| **DC** | Tool B提取、Tool C清洗、冲突检测 | ⭐⭐⭐⭐⭐ | P0 |
| **IIT** | 质控检查、意图识别 | ⭐⭐⭐⭐⭐ | P1 |
| **ASL** | <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑䜘<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| P0 |
| **DC** | Tool B<EFBFBD>𣂼<EFBFBD><EFBFBD><EFBFBD>ool C皜<43><E79A9C><EFBFBD><EFBFBD><EFBFBD><EFBFBD><E89D92>瘚?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| P0 |
| **IIT** | 韐冽綉璉<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| 潃鐥<E6BD83>潃鐥<E6BD83>潃?| P1 |
| **PKB** | RAG<41><EFBFBD><E6A183><EFBFBD>鸌憭<E9B88C><E686AD><EFBFBD><EFBFBD>粉 | 潃鐥<E6BD83>潃鐥<E6BD83> | P1 |
| **AIA** | 10+智能体、意图识别 | ⭐⭐⭐ | P2 |
| **RVW** | 规范性检查 | ⭐⭐⭐ | P2 |
| **AIA** | 10+<EFBFBD><EFBFBD>雿瓐<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| 潃鐥<E6BD83>潃?| P2 |
| **RVW** | <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?| 潃鐥<E6BD83>潃?| P2 |
---
## ⚙️ 核心逻辑PromptService
## <EFBFBD><EFBFBD> <20><EFBFBD><E8A9A8><EFBFBD>嚗㇊romptService嚗?
```typescript
// backend/src/common/capabilities/prompt/prompt.service.ts
@@ -214,7 +214,7 @@ export class PromptService {
}
}
// 2. 普通用户获取ACTIVE版本带缓存
// 2. <EFBFBD><EFBFBD>𡁶鍂<EFBFBD>瑁繮<EFBFBD>䨝CTIVE<EFBFBD><EFBFBD>𧋦嚗<EFBFBD>蒂蝻枏<EFBFBD>嚗?
let active = this.activeCache.get(code);
if (!active) {
const version = await prisma.promptVersion.findFirst({
@@ -231,7 +231,7 @@ export class PromptService {
return this.render(active, variables);
}
// Postgres LISTEN/NOTIFY 热更新
// Postgres LISTEN/NOTIFY <EFBFBD>剜凒<EFBFBD>?
async initHotReload() {
const client = await pool.connect();
await client.query('LISTEN prompt_update');
@@ -245,19 +245,19 @@ export class PromptService {
---
## 📅 开发计划
## <EFBFBD><EFBFBD><><E69298>𤏸恣<F0A48FB8>?
### Phase 0: 基础设施2天
### Phase 0: <EFBFBD><EFBFBD>霈暹鴌嚗?憭抬<E686AD>
- [ ] 创建数据库表(`prompt_templates`, `prompt_versions`
- [ ] <EFBFBD>𥕦遣<EFBFBD>唳旿摨栞”嚗Ǒprompt_templates`, `prompt_versions`嚗?
- [ ] 瘛餃<E7989B>`prompt:*`<EFBFBD><EFBFBD><EFBFBD><EFBFBD>躬platform_schema.permissions`
- [ ] <20>𥕦遣`PROMPT_ENGINEER`閫坿𠧧
- [ ] 摰䂿緵`PromptService`<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
### Phase 1: 运营端MVP3天
### Phase 1: 餈鞱𨯫蝡烘VP嚗?憭抬<E686AD>
- [ ] <20>滨垢蝞∠<E89D9E><E288A0>屸𢒰嚗<F0A292B0><E59A97>銵具<E98AB5><E585B7><EFBFBD>颲穃膥<E7A983><E886A5><EFBFBD><EFBFBD><EFBFBD><E7A08D><EFBFBD>
- [ ] 全局调试开关组件
- [ ] <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞?
- [ ] <20>厩阮靽嘥<E99DBD>/<2F><EFBFBD><E7A983><EFBFBD>
### Phase 2: 銝𡁜𦛚璅<E79285><E288AA><EFBFBD><EFBFBD><E59A97>銝𡁜𦛚撘<F0A69B9A><E69298>𡢅<EFBFBD>
@@ -268,48 +268,48 @@ export class PromptService {
---
## 🔒 安全与风控
## <EFBFBD><EFBFBD> 摰匧<E691B0>銝𡡞<E98A9D><F0A1A19E>?
### <20><><EFBFBD><EFBFBD>𠉛氖
- ✅ 严格检查`prompt:debug`权限
- ✅ 调试模式状态存储在内存(登出自动失效)
- <EFBFBD>?銝交聢璉<E881A2><E79289>prompt:debug`<EFBFBD><EFBFBD><EFBFBD>
- <EFBFBD>?靚<><E99D9A><E79285><E288AA><EFBFBD><E59786><EFBFBD><EFBFBD>典銁<E585B8><E98A81><EFBFBD><EFBFBD><EFBFBD>箄䌊<E7AE84>典仃<E585B8><E4BB83><EFBFBD>
### 摰∟恣<E2889F><EFBFBD>
- `PromptVersion.createdBy`记录修改人
- `AdminOperationLog`记录发布行为module='prompt'
- <EFBFBD>?`PromptVersion.createdBy`霈啣<EFBFBD>靽格㺿鈭?
- <EFBFBD>?`AdminOperationLog`霈啣<EFBFBD><EFBFBD><EFBFBD>銵䔶蛹嚗éodule='prompt'嚗?
### <20>𨅯<EFBFBD><F0A885AF><EFBFBD>
- ✅ 代码中保留Hardcoded Prompt作为系统级兜底
- ✅ 数据库查询失败时返回默认版本
- <EFBFBD>?隞<><E99A9E>銝凋<E98A9D><E5878B>ardcoded Prompt雿靝蛹蝟餌<EFBFBD>蝥批<EFBFBD>摨?
- <EFBFBD>?<3F>唳旿摨𤘪䰻霂仃韐交𧒄餈𥪜<E9A488>暺䁅恕<E48185><E68195>𧋦
---
## 🎯 典型工作流
## <EFBFBD><20><EFBFBD>撌乩<E6928C>瘚?
1. **场景:** 临床专家Dr. Wang觉得ASL文献筛选准确率不够
1. **<EFBFBD>箸艶嚗?* 銝游<E98A9D>銝枏振Dr. Wang閫匧<E996AB>ASL<53><4C>讃蝑偦<E89D91><EFBFBD>蝖桃<E89D96>銝滚<E98A9D>
2. **修改:** Dr. Wang登录运营管理端,修改`ASL_SCREENING`的Prompt,增加排除标准,保存草稿
2. **靽格㺿嚗?* Dr. Wang<EFBFBD><EFBFBD>餈鞱𨯫蝞∠<EFBFBD>蝡荔<EFBFBD>靽格㺿`ASL_SCREENING`<EFBFBD><EFBFBD>rompt<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>靽嘥<EFBFBD><EFBFBD>厩阮
3. **调试:** Dr. Wang点击顶部的"开启调试模式"
3. **<EFBFBD><EFBFBD>嚗?* Dr. Wang<EFBFBD>孵稬憿園<EFBFBD><EFBFBD>?撘<><E69298><EFBFBD>霂閙芋撘?
4. **验证:** Dr. Wang切换到ASL业务页面上传几篇之前筛错的文献
*→ 系统后端检测到Dr. Wang在Debug列表中,加载DRAFT版Prompt*
4. **撉諹<EFBFBD>嚗?* Dr. Wang<EFBFBD><EFBFBD><EFBFBD>蚊SL銝𡁜𦛚憿菟𢒰嚗䔶<EFBFBD>隡惩<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
*<EFBFBD>?蝟餌<E89D9F><E9A48C>𡒊垢璉<E59EA2>瘚见<E7989A>Dr. Wang<EFBFBD>ebug<EFBFBD>𡑒”銝哨<EFBFBD><EFBFBD>㰘蝸DRAFT<EFBFBD>rompt*
5. **确认:** 发现结果正确了
5. **蝖株恕嚗?* <20>𤑳緵蝏𤘪<E89D8F><EFBFBD>鈭?
6. **发布:** Dr. Wang回到管理页点击"发布"
6. **<EFBFBD><EFBFBD>嚗?* Dr. Wang<6E>𧼮<EFBFBD>蝞∠<E89D9E>憿蛛<E686BF><E89B9B>孵稬"<22><EFBFBD>"
7. **结束:** Dr. Wang关闭调试模式
7. **蝏𤘪<EFBFBD>嚗?* Dr. Wang<EFBFBD>喲𡡒靚<EFBFBD><EFBFBD><EFBFBD>
---
## <20><> <20><EFBFBD><E8A9A8><EFBFBD>
- `02-通用能力层_07-运营与机构管理端PRD_v2.1.md` - 总体需求
- `02-通用能力层_03-Prompt管理系统与灰度预览设计方案.md` - 详细设计
- `02-<EFBFBD>𡁶鍂<EFBFBD><EFBFBD><EFBFBD>07-餈鞱𨯫銝擧㦤<E693A7><E3A6A4><EFBFBD><E681A3>PRD_v2.1.md` - <EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘙?
- `02-<EFBFBD>𡁶鍂<EFBFBD><EFBFBD><EFBFBD>03-Prompt蝞∠<EFBFBD>蝟餌<EFBFBD>銝𡒊<EFBFBD>摨阡<EFBFBD><EFBFBD>挽霈⊥䲮獢?md` - 霂衣<EFBFBD>霈曇恣
- `00-<2D><><EFBFBD>銝舘<E98A9D><E88898><EFBFBD>蝟餅<E9A485><EFBC94>𥁒<EFBFBD>𠽤v1.0.md` - <20><EFBFBD>璇喟<E79287>
---