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
This commit is contained in:
2025-11-16 15:44:55 +08:00
parent 1992232fda
commit 855d142fec
32 changed files with 9125 additions and 113 deletions

View File

@@ -0,0 +1,205 @@
# 🧪 智能引用功能 - 快速测试指南
**功能名称**:智能文献引用与出处显示
**测试时间**约10分钟
**测试环境**:需要重启后端
---
## 🚀 Step 1: 重启后端1分钟
```bash
# 停止当前后端Ctrl+C然后
cd D:\MyCursor\AIclinicalresearch\backend
npm run dev
```
**等待看到**
```
✓ Server running on http://localhost:5000
```
---
## 🧪 Step 2: 测试智能问答5分钟
### 操作步骤
1. **访问**http://localhost:3000/chat
2. **选择知识库**:点击"@"图标 → 选择 `阿尔兹海默知识库(优化版)`
3. **提问1**`这个知识库有几个文件?请列出所有文件`
4. **观察AI回答**
### ✅ 预期效果
AI应该这样回答
```markdown
根据检索结果,这个知识库包含以下文件[来源1][来源2][来源3]...
AI的正常回答内容
---
📚 **参考文献**
[1] 📄 **阿尔兹海默综述2023.pdf** - 第3段 (相关度95%)
"阿尔兹海默病是一种神经退行性疾病,主要表现为记忆力减退、认知..."
[2] 📄 **临床试验报告.pdf** - 第7段 (相关度87%)
"研究表明β-淀粉样蛋白在病理过程中起关键作用,是导致神经元损伤..."
[3] 📄 **药物治疗进展.pdf** - 第12段 (相关度82%)
"当前主要的治疗方法包括胆碱酯酶抑制剂和NMDA受体拮抗剂这些药物..."
... (最多15个引用)
```
### 关键检查点
- ✅ AI回答中是否使用 `[来源1]``[来源2]` 等编号标记?
- ✅ 回答结束后是否显示 `---` 分隔线?
- ✅ 是否显示 `📚 **参考文献**` 标题?
- ✅ 每个引用是否包含:
- ✅ 编号 `[1]`
- ✅ 图标 📄
-**文件名**(加粗)
- ✅ 段落位置(如"第3段"
- ✅ 相关度分数(如"相关度95%"
- ✅ 缩进的上下文预览(带引号)
---
### 🧪 更多测试问题
**提问2**`请总结这7篇文献的核心观点`
**提问3**`比较不同文献的研究方法`
**提问4**`哪些文献讨论了药物治疗?`
---
## 🧪 Step 3: 测试对话功能可选3分钟
1. **访问**http://localhost:3000/projects
2. **选择**:任意项目 → 任意对话
3. **在对话中**@知识库 + 提问
4. **验证**:是否同样显示引用清单
---
## 📊 效果评估标准
### ✅ 成功标准
| 检查项 | 是否通过 |
|--------|---------|
| AI使用[来源N]标记 | ☐ |
| 显示分隔线和标题 | ☐ |
| 文件名正确显示 | ☐ |
| 段落位置显示 | ☐ |
| 相关度分数显示 | ☐ |
| 上下文预览100字以内 | ☐ |
| 引用数量合理1-15个 | ☐ |
**如果以上全部通过** ✅ → 功能成功!
---
## 🐛 常见问题
### Q1: 没有显示引用清单?
**原因**
- 可能没有选择知识库(@
- 或者知识库没有检索到相关内容
**解决**
1. 确认已经选择了知识库(输入框上方应显示知识库标签)
2. 尝试更具体的问题
---
### Q2: 引用格式不对?
**检查**
1. 后端是否重启?(必须重启才能应用新代码)
2. 浏览器控制台有错误吗F12查看
3. 后端日志中是否有 `📚 追加 X 个引用清单`
---
### Q3: AI没有使用[来源N]标记?
**原因**AI可能忽略了prompt指令
**不影响**引用清单仍然会正确显示只是AI没有在回答中明确标注
**改进方向**可以在prompt中加强指导已经做了
---
## 🎯 测试后的决策
### 如果效果满意 ✅
**说明**
- 引用功能完美运行
- 用户可以清楚看到AI引用的所有出处
- 40-50%的文献覆盖率足够使用
**下一步**
- ✅ 标记测试完成
- ✅ Phase 1.5 全部完成
- ✅ 进入里程碑2开发其他11个智能体
---
### 如果还需要改进 ⚠️
**可能的问题**
1. 引用数量太多15个太多→ 可调整top_k
2. 上下文预览太短100字不够→ 可调整maxLength
3. 还是想看完整文献 → 启动Phase 2全文精读模式
**请告诉我具体问题**,我会立即调整!
---
## 📸 截图建议
建议截图以下内容供记录:
1. **AI回答部分**:显示[来源N]标记的使用
2. **引用清单部分**:完整的参考文献列表
3. **浏览器控制台**无错误F12 → Console标签
4. **后端日志**:显示 `📚 追加 X 个引用清单`
---
## 📞 反馈格式
测试完成后,请告诉我:
**简单反馈**
> 效果很好 ✅ / 有问题 ❌
**详细反馈**(如果有问题):
> - 问题描述___
> - 测试问题___
> - 实际看到的___
> - 期望看到的___
---
## 🎉 测试完成
测试通过后,我们可以:
1. 更新里程碑文档
2. 标记Phase 1.5完成
3. 开始里程碑2的开发
**现在就开始测试吧!** 🚀