refactor(asl): ASL frontend architecture refactoring with left navigation

- feat: Create ASLLayout component with 7-module left navigation
- feat: Implement Title Screening Settings page with optimized PICOS layout
- feat: Add placeholder pages for Workbench and Results
- fix: Fix nested routing structure for React Router v6
- fix: Resolve Spin component warning in MainLayout
- fix: Add QueryClientProvider to App.tsx
- style: Optimize PICOS form layout (P+I left, C+O+S right)
- style: Align Inclusion/Exclusion criteria side-by-side
- docs: Add architecture refactoring and routing fix reports

Ref: Week 2 Frontend Development
Scope: ASL module MVP - Title Abstract Screening
This commit is contained in:
2025-11-18 21:51:51 +08:00
parent e3e7e028e8
commit 3634933ece
213 changed files with 20054 additions and 442 deletions

View File

@@ -0,0 +1,147 @@
# ASL模块开发记录
本目录记录ASLAI智能文献筛选模块的完整开发历程。
---
## 📁 文档索引
### Week 1 完成报告2025-11-18
| 文档 | 内容 | 重要性 |
|------|------|--------|
| **今日工作总结.md** | 2025-11-18全天工作总结 | ⭐⭐⭐⭐⭐ |
| **两步测试完整报告.md** | 国内外模型对比 + 三种风格测试 | ⭐⭐⭐⭐⭐ |
| **卒中数据泛化测试报告.md** | 最初的泛化能力测试 | ⭐⭐⭐⭐ |
| **Prompt设计与测试完成报告.md** | Prompt v1.0.0测试 | ⭐⭐⭐ |
| **Week1完成报告.md** | Week 1开发完成总结 | ⭐⭐⭐⭐ |
---
## 🎯 核心发现
### 1. 根本问题确认
**准确率不高的根本原因** = AI与人类对边界情况的理解差异
**不是**:
- ❌ 模型智商不够
- ❌ Prompt设计不好
- ❌ 宽松/严格程度不对
**而是**:
- ✅ 纳排标准存在隐含规则
- ✅ 边界情况定义不明确
- ✅ AI无法猜测用户真实意图
---
### 2. 解决方案
#### 短期方案(已实现)✅
**三种筛选风格**:
- 宽松模式:初筛使用,宁可多纳入
- 标准模式:常规使用,平衡准确率
- 严格模式:精筛使用,宁可错杀
**状态**: 后端完成,前端待开发
---
#### 中期方案(推荐)⭐
**用户自定义边界情况**:
1. 用户输入PICOS + 纳排标准
2. LLM分析生成20种边界情况
3. 用户确认每种情况的处理方式
4. 系统生成定制化Prompt
**优点**: 消除AI与人类理解差异
---
#### 长期方案V1.0+)🔮
**Few-shot学习**:
- 从用户纠正中学习
- 持续优化准确率
- 个性化Prompt
---
## 📊 测试数据
### 模型性能对比
| 模型 | 准确率 | 一致率 | 速度 | JSON稳定性 |
|------|--------|--------|------|-----------|
| DeepSeek-V3 + Qwen-Max | 40% | 60% | 16秒 | ✅ 100% |
| GPT-4o + Claude-4.5 | 0%* | 80% | 10秒 | ❌ 20% |
*因JSON格式错误导致失败
### 筛选风格对比
| 风格 | 准确率 | 召回率 | 精确率 |
|------|--------|--------|--------|
| 标准模式 | 60% | 0% | 100% |
| 宽松模式 | 20% | 50% | 0% |
| 严格模式 | 未测试 | - | - |
---
## 🚀 下一步计划
### 本周任务
1. ⬜ 前端开发:筛选风格选择器
2. ⬜ API集成传递`style`参数
3. ⬜ 扩大测试20篇真实数据
4. ⬜ 用户培训:三种风格使用场景
### Week 2任务
1. ⬜ 设计边界情况确认UI
2. ⬜ 实现LLM边界情况生成
3. ⬜ 用户确认流程开发
4. ⬜ 定制化Prompt生成
---
## 📝 快速链接
### 测试脚本
- `backend/scripts/test-stroke-screening.ts` - 标准模式测试
- `backend/scripts/test-stroke-screening-lenient.ts` - 宽松模式测试
- `backend/scripts/test-stroke-screening-international-models.ts` - 模型对比
- `backend/scripts/test-json-parser.ts` - JSON解析器测试
### Prompt文件
- `backend/prompts/asl/screening/v1.1.0-lenient.txt` - 宽松Prompt
- `backend/prompts/asl/screening/v1.1.0-standard.txt` - 标准Prompt
- `backend/prompts/asl/screening/v1.1.0-strict.txt` - 严格Prompt
### 核心代码
- `backend/src/modules/asl/schemas/screening.schema.ts` - Prompt生成
- `backend/src/modules/asl/services/llmScreeningService.ts` - 筛选服务
- `backend/src/common/utils/jsonParser.ts` - JSON解析器
---
## 💡 重要提示
1. **JSON解析器已修复** - 支持中文引号自动转换
2. **三种风格已实现** - 后端完成,前端待开发
3. **根本问题已确认** - 需要用户自定义边界情况
---
**更新日期**: 2025-11-18
**维护人**: AI Assistant
**版本**: v1.0