# AIA - AI智能问答模块

> 覆盖临床研究全生命周期的智能助手系统

---

## 📚 文档导航

### 核心文档

| 文档 | 说明 | 重要性 |
|------|------|--------|
| [模块当前状态与开发指南](./00-模块当前状态与开发指南.md) | ⭐⭐⭐⭐⭐ 必读 | 了解模块真实状态 |
| [AIA模块PRD](./01-需求分析/AIA模块PRD.md) | ⭐⭐⭐⭐ | 产品需求文档 |
| [原型图V11](./01-需求分析/AI问答原型图V11.html) | ⭐⭐⭐⭐⭐ | AgentHub设计（精确还原） |
| [原型图V2](./01-需求分析/AI智能问答V2.html) | ⭐⭐⭐⭐ | ChatWorkspace设计 |

### 开发文档

| 文档 | 说明 |
|------|------|
| [开发计划](./04-开发计划/01-AIA-V2.1开发计划.md) | 实施路径 |
| [后端API设计](./04-开发计划/02-后端API设计.md) | 12个API端点 |
| [前端组件设计](./04-开发计划/03-前端组件设计.md) | 组件架构 |

---

## 🎯 快速开始

### 访问模块

```
前端：http://localhost:5173/aia
后端：http://localhost:3000/api/v1/aia
```

### 测试账号

需要先登录系统获取token

---

## ✨ 核心特性

### 12个智能体

| 阶段 | 智能体 | ID |
|------|--------|-----|
| **选题优化** | 科学问题梳理 | TOPIC_01 |
| **选题优化** | PICO梳理 | TOPIC_02 |
| **选题优化** | 选题评价 | TOPIC_03 |
| **方案设计** | 观察指标设计 | DESIGN_04 |
| **方案设计** | 病例报告表设计 | DESIGN_05 |
| **方案设计** | 样本量计算 | DESIGN_06 |
| **方案设计** | 临床研究方案撰写 | DESIGN_07 |
| **方案预评审** | 方法学评审智能体 | REVIEW_08 |
| **数据与统计** | 数据评价与预处理 | TOOL_09（工具类） |
| **数据与统计** | 智能统计分析 | TOOL_10（工具类） |
| **写作助手** | 论文润色 | WRITING_11 |
| **写作助手** | 论文翻译 | WRITING_12 |

### V2.0 新特性

- ✅ **OpenAI Compatible** - 标准流式格式
- ✅ **深度思考展示** - 可折叠展示AI推理过程
- ✅ **现代感UI** - 100%还原原型图设计
- ✅ **通用能力复用** - Chat组件可供其他模块使用
- ✅ **流式响应** - 逐字显示，打字机效果

---

## 🏗️ 技术架构

```
前端（React 19）
├── AgentHub（智能体大厅）
│   └── 12个AgentCard
└── ChatWorkspace（对话工作台）
    ├── Sidebar（会话列表）
    └── AIStreamChat（流式对话）
        ├── ThinkingBlock（深度思考）
        └── 输入区（附件+深度思考开关）

后端（Fastify）
├── agentService（智能体配置）
├── conversationService（对话管理）
└── StreamingService（流式响应）
    └── OpenAIStreamAdapter（SSE适配器）
```

---

## 📊 当前状态

- **版本：** V2.0
- **完成度：** 85%
- **测试状态：** 核心功能测试通过 ✅
- **部署状态：** 开发环境就绪

### 待完成功能

- 🔜 附件上传与处理
- 🔜 历史消息加载
- 🔜 知识库集成（RAG）
- 🔜 Prompt管理系统对接

---

## 🆘 获取帮助

1. 查看 [模块状态文档](./00-模块当前状态与开发指南.md)
2. 查看 [通用能力层清单](../../02-通用能力层/00-通用能力层清单.md)
3. 查看 [系统总体设计](../../00-系统总体设计/00-系统当前状态与开发指南.md)

---

**最后更新：** 2026-01-14