Files

HaHafeng 855d142fec chore: add remaining test docs, scripts and temp files

- Add Git commit preparation checklist
- Add Phase testing guides and issue tracking
- Add utility scripts (env setup, test data initialization)
- Add temp migration SQL files (for reference)
- Update startup scripts and README
- Remove obsolete scripts

2025-11-16 15:44:55 +08:00

4.9 KiB

Raw Blame History

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

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

🚀 立即开始（3步）

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

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

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

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

访问知识库：http://localhost:3000/knowledge
创建知识库
- 名称：快速测试库
- 点击确定
上传5个文档
- 2个PDF（1个中文、1个英文）
- 1个Docx
- 2个Txt
等待处理：每个约30秒
- ✅ 确认全部显示"已就绪"

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

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

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

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

切换模式：逐篇精读
验证：弹出文献选择器
选择3篇文献 → 确认
验证：看到文献切换器（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：服务启动失败

检查：

# 检查Docker
docker ps

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

解决：

重启Docker Desktop
关闭占用端口的进程
手动启动各服务

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

检查：

# 检查Python微服务
http://localhost:8000/api/health

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

解决：

重启Python微服务
检查extraction_service日志
删除文档重新上传

问题3：容量显示不对

解决：

刷新页面

检查Backend API：

http://localhost:3001/api/v1/knowledge-bases/{kbId}/document-selection

查看返回数据是否正确

问题4：文献选择器空白

检查：

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

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

临时解决：

刷新页面
重新进入精读模式

永久解决：

查看Console错误
检查React状态管理

📊 测试结果记录

服务状态

Python微服务：✅ 正常 / ❌ 异常
Backend：✅ 正常 / ❌ 异常
Frontend：✅ 正常 / ❌ 异常

功能测试

全文阅读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败
逐篇精读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败

发现的问题

最终结论

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

🎯 下一步

如果验收通过 ✅

选择开发方向：
- 方向A：Phase 3（批处理模式，1-2天）
- 方向B：里程碑2（11个智能体，2-3周）
准备工作：
- 备份当前代码
- 创建新分支
- 更新任务清单

如果有问题需要修复 ⚠️

记录所有问题到 Phase2-问题清单.md
按优先级排序
逐个修复并重新测试

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

需要详细测试？ 查看 Phase2-测试指南.md（90分钟完整版）

4.9 KiB Raw Blame History Unescape Escape