AIclinicalresearch/Phase2-快速测试清单.md

# ⚡ Phase 2 快速测试清单（30分钟版）

**目标**：快速验证Phase 2核心功能是否正常工作  
**适用场景**：开发后的快速验收  
**详细版本**：[Phase2-测试指南.md](./Phase2-测试指南.md)

---

## 🚀 立即开始（3步）

### Step 1: 启动服务（2分钟）

```bash
cd D:\MyCursor\AIclinicalresearch
.\一键启动.bat
```

**等待**：30秒，看到3个窗口打开  
**验证**：自动打开 http://localhost:3000

---

### Step 2: 准备测试数据（10分钟）

1. **访问知识库**：http://localhost:3000/knowledge

2. **创建知识库**
   - 名称：`快速测试库`
   - 点击确定

3. **上传5个文档**
   - 2个PDF（1个中文、1个英文）
   - 1个Docx
   - 2个Txt
   
4. **等待处理**：每个约30秒
   - ✅ 确认全部显示"已就绪"

---

### Step 3: 核心功能测试（15分钟）

#### ✅ 测试A：全文阅读模式（5分钟）

1. 访问：http://localhost:3000/chat
2. 选择：`知识库模式` → `快速测试库` → `全文阅读`
3. **验证**：看到容量指示器（5/50篇，XXK/980K）
4. **提问**："请总结这些文献的主要内容"
5. **验证**：
   - [ ] AI能提到多篇文献
   - [ ] 有引用标记`[来源1]`等
   - [ ] 点击引用能跳转

---

#### ✅ 测试B：逐篇精读模式（10分钟）

1. 切换模式：`逐篇精读`
2. **验证**：弹出文献选择器
3. 选择3篇文献 → 确认
4. **验证**：看到文献切换器（3个标签）

**精读测试**：
```
问题1: 这篇文献的主要内容是什么？
问题2（追问）: 研究方法是什么？
```
- [ ] 回答详细准确
- [ ] 记住上下文

**切换测试**：
- 切换到第2篇文献
- [ ] 对话历史清空（新文献）
- 再切回第1篇
- [ ] 能看到之前的对话历史

---

## ✅ 快速验收清单

### 核心功能（10项）

- [ ] 1. Python微服务正常启动（8000端口）
- [ ] 2. Backend正常启动（3001端口）
- [ ] 3. Frontend正常访问（3000端口）
- [ ] 4. 文档上传成功
- [ ] 5. 文档处理完成（显示已就绪）
- [ ] 6. 容量指示器显示正确
- [ ] 7. 全文阅读模式可用
- [ ] 8. 文献选择器弹出
- [ ] 9. 逐篇精读模式可用
- [ ] 10. 文献切换正常

### 关键指标（5项）

- [ ] AI回答包含多篇文献（全文模式）
- [ ] 有清晰的引用标记
- [ ] 逐篇精读回答详细
- [ ] 对话历史正确保存
- [ ] 文献切换流畅（<1秒）

---

## 🐛 快速问题排查

### 问题1：服务启动失败

**检查**：
```bash
# 检查Docker
docker ps

# 检查端口占用
netstat -ano | findstr "3000"
netstat -ano | findstr "3001"
netstat -ano | findstr "8000"
```

**解决**：
- 重启Docker Desktop
- 关闭占用端口的进程
- 手动启动各服务

---

### 问题2：文档一直"处理中"

**检查**：
```bash
# 检查Python微服务
http://localhost:8000/api/health

# 应该返回：
{
  "status": "healthy",
  "nougat_available": true,
  "pymupdf_version": "1.23.8"
}
```

**解决**：
- 重启Python微服务
- 检查extraction_service日志
- 删除文档重新上传

---

### 问题3：容量显示不对

**解决**：
- 刷新页面
- 检查Backend API：
  ```bash
  http://localhost:3001/api/v1/knowledge-bases/{kbId}/document-selection
  ```
- 查看返回数据是否正确

---

### 问题4：文献选择器空白

**检查**：
- F12打开Console，查看错误
- 确认知识库中有"已就绪"的文档
- 刷新页面重试

---

### 问题5：文献切换历史丢失

**临时解决**：
- 刷新页面
- 重新进入精读模式

**永久解决**：
- 查看Console错误
- 检查React状态管理

---

## 📊 测试结果记录

### 服务状态
- Python微服务：✅ 正常 / ❌ 异常
- Backend：✅ 正常 / ❌ 异常
- Frontend：✅ 正常 / ❌ 异常

### 功能测试
- 全文阅读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败
- 逐篇精读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败

### 发现的问题
1. _____________________________________________
2. _____________________________________________
3. _____________________________________________

### 最终结论
- [ ] ✅ **验收通过** - 可以进入下一阶段
- [ ] ⚠️ **有条件通过** - 修复小问题后可继续
- [ ] ❌ **需要返工** - 有重大问题需要修复

---

## 🎯 下一步

### 如果验收通过 ✅
1. **选择开发方向**：
   - 方向A：Phase 3（批处理模式，1-2天）
   - 方向B：里程碑2（11个智能体，2-3周）

2. **准备工作**：
   - 备份当前代码
   - 创建新分支
   - 更新任务清单

### 如果有问题需要修复 ⚠️
1. 记录所有问题到 `Phase2-问题清单.md`
2. 按优先级排序
3. 逐个修复并重新测试

---

**测试时间**：______  
**测试人员**：______  
**测试结果**：✅ / ⚠️ / ❌

---

**需要详细测试？** 查看 [Phase2-测试指南.md](./Phase2-测试指南.md)（90分钟完整版）