AIclinicalresearch/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-01-23_全文复筛前端逻辑调整.md

全文复筛前端逻辑调整 - 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: 启动全文复筛
└── 要求：至少1篇文献的PDF已就绪

---

📝 详细修改内容

1. 步骤1改名：获取待复筛的文献列表

修改前：

步骤1: 导入待复筛文献

修改后：

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

改动理由：

• 明确说明这一步只获取"文献列表"（元信息）
• 不包含PDF文件

---

2. Tab2改名：手动上传Excel（只含元信息）

修改前：

Tab2: 手动上传Excel
描述：上传包含文献列表的Excel文件（❌ 没有说明不含PDF）

修改后：

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

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

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

改动理由：

• 明确说明"不包含PDF文件"
• 提供Excel模板字段说明
• 添加"下载Excel模板"按钮

---

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

修改前：

Tab3: 从知识库选择

修改后：

（删除Tab3，知识库功能移到步骤2）

改动理由：

• 知识库选择应该在"上传PDF"环节，而不是"获取文献列表"环节
• 简化Tab数量（2个Tab更清晰）

---

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

修改前：

步骤2: 全文获取与管理

修改后：

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

改动理由：

• "上传全文文献"比"全文获取与管理"更明确
• 明确说明这一步的目的是"上传PDF"

---

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

修改前：

操作列：
- 未上传：[上传PDF]按钮
- 已就绪：显示"已就绪"

修改后：

操作列：
- 未上传/失败：
  ├── [上传PDF]按钮（手动上传本地PDF）
  └── [知识库]按钮（从知识库选择，暂禁用）

- 已就绪：
  ├── ✓ 已完成
  └── [重新上传]按钮（允许替换PDF）

改动理由：

• 提供两种上传方式选项
• 已就绪的文献也可以重新上传

---

6. 批量操作工具栏

新增：

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

改动理由：

• 支持批量操作
• 为未来的知识库批量导入预留入口

---

7. 提示信息优化

修改前：

提示：至少需要1篇文献的PDF已就绪才能启动复筛任务。

修改后：

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

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

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

改动理由：

• 根据不同状态显示不同提示
• 明确告知操作步骤

---

🎯 核心改进点

概念分离：

文献元信息（步骤1）
  ↓
PDF全文文件（步骤2）
  ↓
启动筛选（步骤3）

流程清晰化：

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

---

📊 修改统计

修改文件：1个
- FulltextSettings.tsx (621行)

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

Linter错误：0个

---

✅ 验收标准

UI展示：

• ✅ 步骤1有2个Tab（从初筛导入 / 手动上传Excel）
• ✅ 步骤1的Excel上传明确说明"不包含PDF"
• ✅ 步骤2标题为"上传全文文献"
• ✅ 步骤2每行有"上传PDF"和"知识库"按钮
• ✅ 步骤2的提示根据PDF状态动态变化

逻辑正确：

• ✅ Excel只导入文献元信息
• ✅ PDF通过表格中的"上传PDF"按钮逐个上传
• ✅ 知识库功能在步骤2，不在步骤1
• ✅ 允许部分文献没有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