# 全文复筛前端逻辑调整 - Settings页面优化

**日期**: 2025-01-23  
**调整原因**: 用户反馈逻辑错误，需要区�?文献列表导入"�?PDF上传"两个独立步骤  
**状�?*: �?已完�?

---

## 🔴 **问题发现**

### 原始错误设计�?

```
步骤1: 导入待复筛文�?
├── Tab1: 从标题摘要初筛导�?
├── Tab2: 手动上传Excel �?错误设计
�?  └── 上传包含文献信息的Excel（混淆了元信息和PDF�?
└── Tab3: 从知识库选择
```

**错误�?*�?
- Tab2暗示可以通过Excel导入PDF，但Excel不可能包含PDF文件
- 没有区分"文献元信�?�?PDF全文"两个概念
- 流程不清晰，用户容易混淆

---

## �?**调整后的正确逻辑**

### 三步流程�?

```
步骤1: 获取待复筛的文献列表（只获取元信息）
├── Tab1: 从标题摘要初筛导�?
�?  └── 导入上一环节"已纳�?的文献元信息
└── Tab2: 手动上传Excel
    └── 上传包含文献元信息的Excel（Title, Abstract, PMID等）
    └── 不包含PDF文件

步骤2: 上传全文文献（为每篇文献上传PDF�?
├── 显示文献列表表格
├── 每行显示PDF状态（待上�?上传�?已就�?失败�?
└── 操作列提供两种方式：
    ├── (1) 手动上传PDF（MVP当前方式�?
    └── (2) 从知识库选择（技术债务�?

步骤3: 启动全文复筛
└── 要求：至�?篇文献的PDF已就�?
```

---

## 📝 **详细修改内容**

### **1. 步骤1改名：获取待复筛的文献列�?*

**修改�?*�?
```
步骤1: 导入待复筛文�?
```

**修改�?*�?
```
步骤1: 获取待复筛的文献列表
说明：首先导入文献的基本信息（标题、摘要、作者等），PDF全文将在下一步上�?
```

**改动理由**�?
- 明确说明这一步只获取"文献列表"（元信息�?
- 不包含PDF文件

---

### **2. Tab2改名：手动上传Excel（只含元信息�?*

**修改�?*�?
```jsx
Tab2: 手动上传Excel
描述：上传包含文献列表的Excel文件（❌ 没有说明不含PDF�?
```

**修改�?*�?
```jsx
Tab2: 手动上传Excel
说明：上传包含文献元信息的Excel文件（标题、摘要、PMID等），不包含PDF文件。PDF全文将在下一步上传�?

Excel模板字段说明�?
必填字段�?
  �?Title（标题）
  �?Abstract（摘要）

可选字段：
  �?PMID、DOI、Authors（作者）、Journal（期刊）、Year（年份）
```

**改动理由**�?
- 明确说明"不包含PDF文件"
- 提供Excel模板字段说明
- 添加"下载Excel模板"按钮

---

### **3. 删除Tab3：从知识库选择**

**修改�?*�?
```
Tab3: 从知识库选择
```

**修改�?*�?
```
（删除Tab3，知识库功能移到步骤2�?
```

**改动理由**�?
- 知识库选择应该�?上传PDF"环节，而不�?获取文献列表"环节
- 简化Tab数量�?个Tab更清晰）

---

### **4. 步骤2重命名：上传全文文献**

**修改�?*�?
```
步骤2: 全文获取与管�?
```

**修改�?*�?
```
步骤2: 上传全文文献
说明：为每篇文献上传对应的PDF全文。您可以手动上传本地PDF文件，或从知识库选择已有PDF（开发中）�?
```

**改动理由**�?
- "上传全文文献"�?全文获取与管�?更明�?
- 明确说明这一步的目的�?上传PDF"

---

### **5. 操作列增强：支持两种上传方式**

**修改�?*�?
```jsx
操作列：
- 未上传：[上传PDF]按钮
- 已就绪：显示"已就�?
```

**修改�?*�?
```jsx
操作列：
- 未上�?失败�?
  ├── [上传PDF]按钮（手动上传本地PDF�?
  └── [知识库]按钮（从知识库选择，暂禁用�?

- 已就绪：
  ├── �?已完�?
  └── [重新上传]按钮（允许替换PDF�?
```

**改动理由**�?
- 提供两种上传方式选项
- 已就绪的文献也可以重新上�?

---

### **6. 批量操作工具�?*

**新增**�?
```jsx
步骤2顶部工具栏：
- 左侧：已选择 X �?| [批量删除]按钮
- 右侧：[从知识库批量导入]按钮（暂禁用�?
```

**改动理由**�?
- 支持批量操作
- 为未来的知识库批量导入预留入�?

---

### **7. 提示信息优化**

**修改�?*�?
```
提示：至少需�?篇文献的PDF已就绪才能启动复筛任务�?
```

**修改�?*�?
```
未上传任何PDF�?
  提示：至少需�?篇文献的PDF已就绪才能启动复筛任务。请点击表格中的【上传PDF】按钮为文献上传全文�?

部分PDF已就绪：
  提示：已�?X 篇文献的PDF就绪，还�?Y 篇待上传。您可以继续上传剩余PDF，或直接启动复筛（未上传PDF的文献将被跳过）�?

全部PDF已就绪：
  提示：已�?X 篇文献的PDF就绪，可以启动全文复筛任�?
```

**改动理由**�?
- 根据不同状态显示不同提�?
- 明确告知操作步骤

---

## 🎯 **核心改进�?*

### **概念分离**�?
```
文献元信息（步骤1�?
  �?
PDF全文文件（步�?�?
  �?
启动筛选（步骤3�?
```

### **流程清晰�?*�?
1. **步骤1**：获取文献列表（只要标题、摘要等元信息）
2. **步骤2**：为每篇文献上传PDF（一对一关联�?
3. **步骤3**：启动全文复筛（要求至少1篇PDF就绪�?

---

## 📊 **修改统计**

```
修改文件�?�?
- FulltextSettings.tsx (621�?

修改内容�?
- 删除代码：~50行（删除Tab3知识库选择�?
- 修改代码：~150行（重写步骤说明、提示信息）
- 新增代码：~30行（批量操作工具栏、重新上传按钮）

Linter错误�?�?
```

---

## �?**验收标准**

### **UI展示**�?
- �?步骤1�?个Tab（从初筛导入 / 手动上传Excel�?
- �?步骤1的Excel上传明确说明"不包含PDF"
- �?步骤2标题�?上传全文文献"
- �?步骤2每行�?上传PDF"�?知识�?按钮
- �?步骤2的提示根据PDF状态动态变�?

### **逻辑正确**�?
- �?Excel只导入文献元信息
- �?PDF通过表格中的"上传PDF"按钮逐个上传
- �?知识库功能在步骤2，不在步�?
- �?允许部分文献没有PDF也可以启动任�?

---

## 🚀 **后续工作**

### **优先级P1（必须）**�?
1. �?前端逻辑调整（已完成�?
2. �?实现Excel解析功能（解析文献元信息�?
3. �?实现PDF上传API对接

### **优先级P2（建议）**�?
1. PDF批量上传（拖拽多个PDF文件�?
2. 从知识库选择PDF功能
3. Excel模板下载功能

---

## 📝 **备注**

### **关键设计原则**�?
1. **概念分离**：文献元信息 �?PDF文件
2. **流程清晰**：三步流程，逐步推进
3. **灵活�?*：允许部分文献无PDF也可启动

### **用户体验优化**�?
- 每一步都有清晰的说明
- 不同状态有不同的提�?
- 支持重新上传PDF
- 预留知识库入�?

---

**文档版本**: v1.0  
**最后更�?*: 2025-01-23  
**相关文档**: [2025-01-23_全文复筛前端开发完�?md](./2025-01-23_全文复筛前端开发完�?md)