AIclinicalresearch/docs/03-业务模块/ASL-AI智能文献/04-开发计划/02-标题摘要初筛开发计划.md

标题摘è¦<EFBFBD>åˆ<EFBFBD>筛模å<EFBFBD>— - 详细开å<E282AC>‘计划（MVP阶段ï¼?

*文档版本� V3.0
*创建日期� 2025-11-16
å¼€å<EFBFBD>‘周期： 4 å‘? *负责团队ï¼? ASL å¼€å<E282AC>‘组
最å<EFBFBD>Žæ›´æ–°ï¼š 2025-11-16
*â­?é‡<C3A9>è¦<C3A8>：基于真实架构（Frontend-v2 + Backend增é‡<C3A9>演进 + asl_schemaï¼?

---

📋 模å<C2A1>—概述

标题摘è¦<EFBFBD>åˆ<EFBFBD>ç­›æ˜?ASL 模å<C2A1>—的第一个核心功能，也是 MVP 阶段的唯一交付功能ã€?

功能范围

1. **设置与å<C5BD>¯åŠ¨è§†å›?*：PICO 标准展示ã€<C3A3>Excel 文献导入ã€<C3A3>å<EFBFBD>¯åŠ¨ç­›é€‰ä»»åŠ?2. **审核工作å<C593>°è§†å›?*：å<C5A1>Œæ¨¡åž‹åˆ¤æ–­å¯¹æ¯”ã€<C3A3>冲çª<C3A7>标记ã€<C3A3>人工å¤<C3A5>æ ?3. åˆ<EFBFBD>筛结果视图：统计概览ã€<EFBFBD>PRISMA 排除总结ã€<C3A3>结果导å‡?

技术栈

层级	技�	说明
å‰<EFBFBD>端	React 19 + TypeScript + Ant Design 5 + xlsx	Frontend-v2架构
å<EFBFBD>Žç«¯	Node.js + Fastify + TypeScript + Prisma	Backend/modules/asl/
LLM	DeepSeek-V3 + Qwen3-72B	å¤<EFBFBD>用 common/llm/adapters/
*æ•°æ<EFBFBD>®åº?	PostgreSQL 15 (asl_schema)	Schema隔离

---

ðŸ<EFBFBD>—ï¸?架构å‰<C3A5>æ<EFBFBD><C3A6>（已完æˆ<C3A6>ï¼?

âœ?Frontend-v2 架构（Week 2 Day 6-7 完æˆ<C3A6>ï¼?```

frontend-v2/src/ ├── framework/layout/ â”? ├── MainLayout.tsx # âœ?顶部导航布局 â”? └── TopNavigation.tsx # âœ?6个模å<C2A1>—导èˆ?├── framework/modules/ â”? ├── moduleRegistry.ts # âœ?模å<C2A1>—注册中心 â”? └── types.ts # âœ?ModuleDefinition接å<C2A5>£ └── modules/asl/ └── index.tsx # 🚧 å<> ä½<C3A4>页é<C2B5>¢ï¼ˆå¾…替æ<C2BF>¢ï¼?```

âœ?Backend 架构（Week 2 Day 8-9 完æˆ<C3A6>ï¼?```

backend/src/ ├── common/llm/adapters/ # âœ?LLMFactoryå<79>¯å¤<C3A5>ç”?├── common/utils/jsonParser.js # âœ?JSON解æž<C3A6>å<EFBFBD>¯å¤<C3A5>ç”?└── modules/ └── asl/ # 🚧 空目录（待创建）

### âœ?Database Schema（Week 1 完æˆ<C3A6>ï¼?```prisma
// backend/prisma/schema.prisma
datasource db {
  schemas = [
    "asl_schema",  # �已预留，待定义表结构
    // ...其他9个Schema
  ]
}

---

🌥ï¸?云原生开å<E282AC>‘注æ„<C3A6>事项（2025-11-16 新增ï¼?

**â­?é‡<C3A9>è¦<C3A8>æ›´æ–°**：本模å<C2A1>—å¼€å<E282AC>‘需é<E282AC>µå¾ªé˜¿é‡Œäº?Serverless 部署架构è¦<C3A8>求
详细规范：云原生开å<EFBFBD>‘规范
**部署指å<E280A1>—**：云原生部署架构指å<EFBFBD>—

🎯 本地开å<E282AC>?+ 云端部署å<C2B2>Œå…¼å®¹ç­–ç•?

环境	存储方å¼<EFBFBD>	é…<EFBFBD>ç½®	说明
*本地开å<EFBFBD>?	LocalAdapter	STORAGE_TYPE=local	文件存储åˆ?./uploads/
生产环境	OSSAdapter	STORAGE_TYPE=oss	文件存储到阿里云 OSS

**核心原则**ï¼?- âœ?**Excel导入**：内存解æž<C3A6>（xlsx.read(buffer)），ä¸<EFBFBD>è<EFBFBD>½ç›?- âœ?**PDF上传**（V1.0）：使用 StorageFactory，本åœ?OSS自动切æ<E280A1>¢

• âœ?**异步任务**：LLM筛选任务必须异步处ç<E2809E>†ï¼ˆ> 10秒任务）
• âœ?**环境å<C692>˜é‡<C3A9>**：所有é…<C3A9>置从 .env 读å<C2BB>–
• âœ?**æ•°æ<C2B0>®åº“连接池**：使用全局 prisma 实例，ä¸<C3A4>新建连接

â<EFBFBD>?ç¦<C3A7>止的å<E2809E>šæ³?

ç¦<EFBFBD>æ­¢æ“<EFBFBD>作	正确å<EFBFBD>šæ³•	原å›
fs.writeFileSync('./temp.xlsx')	xlsx.read(buffer) 内存解æž<C3A6>	Serverless容器é‡<EFBFBD>å<EFBFBD>¯ä¸¢å¤±æ–‡ä»¶
new PrismaClient() æ¯<C3A6>次新建连接	使用全局 prisma 实例	é<EFBFBD>¿å…<EFBFBD>连接数暴å¢?
硬编ç ?apiKey = 'sk-xxx'	process.env.LLM_API_KEY	é…<EFBFBD>置管ç<EFBFBD>†æ··ä¹±
å<EFBFBD>Œæ­¥å¤„ç<EFBFBD>†1000æ<EFBFBD>¡æ–‡çŒ®ç­›é€?	异步任务 + 进度轮询	超过30秒超时é™<EFBFBD>åˆ?

âœ?MVP阶段开å<E282AC>‘检查清å<E280A6>?

在æ<EFBFBD><EFBFBD>交代ç <EFBFBD>å‰<EFBFBD>，请确认ï¼?

• Excel导入是å<EFBFBD>¦ä½¿ç”¨å†…存解æž<EFBFBD>（xlsx.read(buffer)）？
• 是å<EFBFBD>¦ä½¿ç”¨å…¨å±€ prisma 实例（import { prisma } from '@/config/database'）？
• 是å<EFBFBD>¦æ‰€æœ‰é…<EFBFBD>置都从环境å<EFBFBD>˜é‡<EFBFBD>读å<EFBFBD>–？
• LLM筛选任务是å<EFBFBD>¦å¼‚步处ç<EFBFBD>†ï¼ˆPOST /screening/start ç«‹å<E280B9>³è¿”回taskId）？
• 是å<EFBFBD>¦é¢„ç•™äº?OSS 字段（pdfUrl, pdfOssKey, pdfFileSize）？
• 是å<EFBFBD>¦ä½¿ç”¨å­˜å‚¨æŠ½è±¡å±‚（StorageFactory.create()）？

预留字段说明ï¼?- MVP阶段仅å<E280A6>šæ ‡é¢˜æ‘˜è¦<C3A8>筛选，ä¸<C3A4>处ç<E2809E>†PDF

• V1.0阶段实现全文PDF筛选时，使用预留的OSS字段

---

📅 四周开å<E282AC>‘计åˆ?

Week 1: æ•°æ<C2B0>®åº“Schema + å<>Žç«¯API框架 + 存储抽象å±?Week 2: LLM筛选核å¿?+ 异步批处ç<E2809E>†é€»è¾‘
Week 3: å‰<C3A5>端模å<C2A1>—å¼€å<E282AC>?+ 审核工作å<C593>°ï¼ˆå†…存解æž<C3A6>Excelï¼?Week 4: 结果展示 + 导出 + 集æˆ<C3A6>测试

---

🗓ï¸?Week 1: æ•°æ<C2B0>®åº“Schema与å<C5BD>Žç«¯API框架

Day 1: Prisma Schema 设计

任务1: 设计 asl_schema 表结�

åœ?backend/prisma/schema.prisma 中添加：

// ==================== ASL 筛选项目表 ====================
model AslScreeningProject {
  id              String   @id @default(uuid())
  userId          String   @map("user_id")
  user            User     @relation("AslProjects", fields: [userId], references: [id], onDelete: Cascade)
  
  projectName     String   @map("project_name")
  
  // PICO标准
  picoCriteria    Json     @map("pico_criteria") // { population, intervention, comparison, outcome, studyDesign }
  
  // 筛选标�  inclusionCriteria String @map("inclusion_criteria") @db.Text
  exclusionCriteria String @map("exclusion_criteria") @db.Text
  
  // 状�  status          String   @default("draft") // draft, screening, completed
  
  // 筛选é…<C3A9>ç½?  screeningConfig Json?    @map("screening_config") // { models: ["deepseek", "qwen"], temperature: 0 }
  
  // å…³è<C2B3>”
  literatures     AslLiterature[]
  screeningTasks  AslScreeningTask[]
  screeningResults AslScreeningResult[]
  
  createdAt       DateTime @default(now()) @map("created_at")
  updatedAt       DateTime @updatedAt @map("updated_at")
  
  @@map("screening_projects")
  @@schema("asl_schema")
  @@index([userId])
  @@index([status])
}

// ==================== ASL 文献æ<C2AE>¡ç›®è¡?====================
model AslLiterature {
  id              String   @id @default(uuid())
  projectId       String   @map("project_id")
  project         AslScreeningProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
  
  // 文献基本信æ<C2A1>¯
  pmid            String?
  title           String   @db.Text
  abstract        String   @db.Text
  authors         String?
  journal         String?
  publicationYear Int?     @map("publication_year")
  doi             String?
  
  // 云原生存储字段（V1.0 阶段使用，MVP阶段预留�  pdfUrl          String?  @map("pdf_url")        // PDF访问URL
  pdfOssKey       String?  @map("pdf_oss_key")    // OSS存储Key（用于删除）
  pdfFileSize     Int?     @map("pdf_file_size")  // 文件大å°<C3A5>（字节）
  
  // å…³è<C2B3>”
  screeningResults AslScreeningResult[]
  
  createdAt       DateTime @default(now()) @map("created_at")
  updatedAt       DateTime @updatedAt @map("updated_at")
  
  @@map("literatures")
  @@schema("asl_schema")
  @@index([projectId])
  @@index([doi])
  @@unique([projectId, pmid])
}

// ==================== ASL 筛选结果表 ====================
model AslScreeningResult {
  id              String   @id @default(uuid())
  projectId       String   @map("project_id")
  project         AslScreeningProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
  literatureId    String   @map("literature_id")
  literature      AslLiterature @relation(fields: [literatureId], references: [id], onDelete: Cascade)
  
  // DeepSeek模型判断
  dsModelName     String   @map("ds_model_name") // "deepseek-chat"
  dsPJudgment     String?  @map("ds_p_judgment") // "match" | "partial" | "mismatch"
  dsIJudgment     String?  @map("ds_i_judgment")
  dsCJudgment     String?  @map("ds_c_judgment")
  dsSJudgment     String?  @map("ds_s_judgment")
  dsConclusion    String?  @map("ds_conclusion") // "include" | "exclude" | "uncertain"
  dsConfidence    Float?   @map("ds_confidence") // 0-1
  
  // DeepSeek模型è¯<C3A8>æ<EFBFBD>®
  dsPEvidence     String?  @map("ds_p_evidence") @db.Text
  dsIEvidence     String?  @map("ds_i_evidence") @db.Text
  dsCEvidence     String?  @map("ds_c_evidence") @db.Text
  dsSEvidence     String?  @map("ds_s_evidence") @db.Text
  dsReason        String?  @map("ds_reason") @db.Text
  
  // Qwen模型判断
  qwenModelName   String   @map("qwen_model_name") // "qwen-max"
  qwenPJudgment   String?  @map("qwen_p_judgment")
  qwenIJudgment   String?  @map("qwen_i_judgment")
  qwenCJudgment   String?  @map("qwen_c_judgment")
  qwenSJudgment   String?  @map("qwen_s_judgment")
  qwenConclusion  String?  @map("qwen_conclusion")
  qwenConfidence  Float?   @map("qwen_confidence")
  
  // Qwen模型è¯<C3A8>æ<EFBFBD>®
  qwenPEvidence   String?  @map("qwen_p_evidence") @db.Text
  qwenIEvidence   String?  @map("qwen_i_evidence") @db.Text
  qwenCEvidence   String?  @map("qwen_c_evidence") @db.Text
  qwenSEvidence   String?  @map("qwen_s_evidence") @db.Text
  qwenReason      String?  @map("qwen_reason") @db.Text
  
  // 冲çª<C3A7>状æ€?  conflictStatus  String   @default("none") @map("conflict_status") // "none" | "conflict" | "resolved"
  conflictFields  Json?    @map("conflict_fields") // ["P", "I", "conclusion"]
  
  // 最终决�  finalDecision   String?  @map("final_decision") // "include" | "exclude" | "pending"
  finalDecisionBy String?  @map("final_decision_by") // userId
  finalDecisionAt DateTime? @map("final_decision_at")
  exclusionReason String?  @map("exclusion_reason") @db.Text
  
  // AI处ç<E2809E>†çŠ¶æ€?  aiProcessingStatus String @default("pending") @map("ai_processing_status") // "pending" | "processing" | "completed" | "failed"
  aiProcessedAt   DateTime? @map("ai_processed_at")
  aiErrorMessage  String?  @map("ai_error_message") @db.Text
  
  // å<>¯è¿½æº¯ä¿¡æ<C2A1>?  promptVersion   String   @default("v1.0.0") @map("prompt_version")
  rawOutput       Json?    @map("raw_output") // 原始LLM输出（备份）
  
  createdAt       DateTime @default(now()) @map("created_at")
  updatedAt       DateTime @updatedAt @map("updated_at")
  
  @@map("screening_results")
  @@schema("asl_schema")
  @@index([projectId])
  @@index([literatureId])
  @@index([conflictStatus])
  @@index([finalDecision])
  @@unique([projectId, literatureId])
}

// ==================== ASL 筛选任务表 ====================
model AslScreeningTask {
  id              String   @id @default(uuid())
  projectId       String   @map("project_id")
  project         AslScreeningProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
  
  taskType        String   @map("task_type") // "title_abstract" | "full_text"
  status          String   @default("pending") // "pending" | "running" | "completed" | "failed"
  
  // 进度统计
  totalItems      Int      @map("total_items")
  processedItems  Int      @default(0) @map("processed_items")
  successItems    Int      @default(0) @map("success_items")
  failedItems     Int      @default(0) @map("failed_items")
  conflictItems   Int      @default(0) @map("conflict_items")
  
  // 时间信æ<C2A1>¯
  startedAt       DateTime? @map("started_at")
  completedAt     DateTime? @map("completed_at")
  estimatedEndAt  DateTime? @map("estimated_end_at")
  
  // 错误信æ<C2A1>¯
  errorMessage    String?  @map("error_message") @db.Text
  
  createdAt       DateTime @default(now()) @map("created_at")
  updatedAt       DateTime @updatedAt @map("updated_at")
  
  @@map("screening_tasks")
  @@schema("asl_schema")
  @@index([projectId])
  @@index([status])
}

// ==================== 用户表关è<C2B3>”（添加到User模型ï¼?===================
// �platform_schema �User 模型中添加：
// aslProjects AslScreeningProject[] @relation("AslProjects")

*执行è¿<EFBFBD>移ï¼?

cd backend
npx prisma migrate dev --name add_asl_screening_tables
npx prisma generate

**验收标准**ï¼?- âœ?æ•°æ<C2B0>®åº“表创建æˆ<C3A6>功ï¼?张表ï¼?- âœ?Prisma Client 生æˆ<C3A6>æˆ<C3A6>功

• âœ?å<>¯æŸ¥è¯?asl_schema è¡?

---

Day 2: å<>Žç«¯ç›®å½•ç»“构创建

**â­?å‰<C3A5>ç½®æ<C2AE>¡ä»¶ï¼?025-11-17 æ›´æ–°ï¼?*：平å<C2B3>°åŸºç¡€è®¾æ–½å·²å®Œæˆ<C3A6>实æ–?âœ? **完æˆ<C3A6>状æ€?*ï¼?个核心模å<C2A1>—，100%测试通过
完æˆ<EFBFBD>报告：平å<EFBFBD>°åŸºç¡€è®¾æ–½å®žæ–½å®Œæˆ<EFBFBD>报告
**使用指å<E280A1>—**：backend/src/common/README.md

å¹³å<EFBFBD>°å·²æ<EFBFBD><EFBFBD>供的8个核心模å<EFBFBD>—（无需ASL模å<EFBFBD>—实现ï¼?

**å¹³å<C2B3>°åŸºç¡€è®¾æ–½è·¯å¾„**：backend/src/common/

#	模å<EFBFBD>—	使用方å¼<EFBFBD>	功能说明
1	存储æœ<EFBFBD>务	import { storage } from '@/common/storage'	文件上传下载（本åœ?OSS切æ<E280A1>¢ï¼?
2	日志系统	import { logger } from '@/common/logging'	结构化JSON日志
3	缓存æœ<EFBFBD>务	import { cache } from '@/common/cache'	内存/Redis缓存
4	异步任务	import { jobQueue } from '@/common/jobs'	长时间任务处ç<EFBFBD>?
5	*å<EFBFBD>¥åº·æ£€æŸ?	import { registerHealthRoutes } from '@/common/health'	SAEå<EFBFBD>¥åº·æ£€æŸ?
6	监控指标	import { Metrics } from '@/common/monitoring'	性能监控和告�
7	**æ•°æ<C2B0>®åº“连接池**	import { prisma } from '@/config/database'	全局Prisma实例
8	环境é…<EFBFBD>ç½®	import { env } from '@/config/env'	统一é…<EFBFBD>置管ç<EFBFBD>†

**存储æœ<C3A6>务使用示例**ï¼?```typescript // ASL模å<C2A1>—直接使用（一行代ç <C3A7>） import { storage } from '@/common/storage'

// 上传文件（ä¸<C3A4>关心本地还是OSSï¼?const url = await storage.upload('asl/literature/123.pdf', pdfBuffer)

// 下载文件 const buffer = await storage.download('asl/literature/123.pdf')

// 删除文件 await storage.delete('asl/literature/123.pdf')

**支æŒ<C3A6>的部署环å¢?*ï¼?- âœ?本地开å<E282AC>‘：LocalAdapter（文件存储到 `./uploads/`ï¼?- âœ?云端SaaS：OSSAdapter（文件存储到阿里云OSSï¼?- âœ?ç§<C3A7>有化部署：LocalAdapter（文件存储到æœ<C3A6>务器）
- âœ?å<>•æœºç‰ˆï¼šLocalAdapter（文件存储到用户本地ï¼?
**环境切æ<E280A1>¢**：修改一个环境å<C692>˜é‡<C3A9>å<EFBFBD>³å<C2B3>?```bash
# 本地开å<E282AC>?STORAGE_TYPE=local

# 生产环境
STORAGE_TYPE=oss

**核心优势**ï¼?- âœ?ASL模å<C2A1>—无需关心基础设施实现细节

• âœ?代ç <C3A7>零改动切æ<E280A1>¢çŽ¯å¢ƒï¼ˆæœ¬åœ° â†?云端ï¼?- âœ?所有业务模å<C2A1>—（AIA/PKB/DC等）å¤<C3A5>用å<C2A8>Œä¸€å¥—基础设施
• âœ?统一维护ã€<C3A3>统一å<E282AC>‡çº§ã€<C3A3>统一监控

---

任务1: 创建 backend/src/modules/asl/ 目录

cd backend/src/modules/asl
mkdir routes controllers services schemas types utils
touch routes/index.ts
touch controllers/projectController.ts
touch controllers/literatureController.ts
touch controllers/screeningController.ts
touch services/projectService.ts
touch services/literatureService.ts
touch services/llmScreeningService.ts
touch schemas/screening.schema.ts
touch types/screening.types.ts

任务2: 创建路由文件

*backend/src/modules/asl/routes/index.tsï¼?

import { FastifyInstance } from 'fastify'
import * as projectController from '../controllers/projectController.js'
import * as literatureController from '../controllers/literatureController.js'
import * as screeningController from '../controllers/screeningController.js'

/**
 * ASL 模å<C2A1>—路由注册
 * 
 * @description
 * - 注册åˆ?/api/v1/asl å‰<C3A5>ç¼€
 * - å<>‚è€?legacy/routes/ 的风æ ? * 
 * @version Week 3 Day 2
 */
export async function aslRoutes(fastify: FastifyInstance) {
  // 项目管ç<C2A1>†
  fastify.post('/projects', projectController.createProject)
  fastify.get('/projects', projectController.listProjects)
  fastify.get('/projects/:projectId', projectController.getProject)
  fastify.put('/projects/:projectId', projectController.updateProject)
  fastify.delete('/projects/:projectId', projectController.deleteProject)
  
  // 文献管ç<C2A1>†
  fastify.post('/projects/:projectId/literatures/import', literatureController.importLiteratures)
  fastify.get('/projects/:projectId/literatures', literatureController.listLiteratures)
  
  // 筛选管ç<C2A1>?  fastify.post('/projects/:projectId/screening/start', screeningController.startScreening)
  fastify.get('/projects/:projectId/screening/results', screeningController.getScreeningResults)
  fastify.put('/screening/results/:resultId', screeningController.updateScreeningResult)
  fastify.post('/screening/results/batch-update', screeningController.batchUpdateResults)
  fastify.get('/screening/tasks/:taskId', screeningController.getTaskStatus)
  fastify.get('/screening/tasks/:taskId/progress', screeningController.getTaskProgress)
}

**验收标准**�- �目录结构清晰

• âœ?路由文件创建完æˆ<C3A6>
• âœ?**å<>¯æ­£å¸¸ä½¿ç”¨å¹³å<C2B3>°æœ<C3A6>åŠ?*ï¼? - âœ?import { storage } from '@/common/storage' å<>¯ç”¨
  • âœ?import { logger } from '@/common/logging' å<>¯ç”¨
  • âœ?import { prisma } from '@/config/database' å<>¯ç”¨
  • âœ?import { jobQueue } from '@/common/jobs' å<>¯ç”¨
  • âœ?import { cache } from '@/common/cache' å<>¯ç”¨

---

Day 3: �index.ts 中注册ASL路由

*backend/src/index.ts（修改）ï¼?

// ============================================
// ã€<C3A3>新架构】ASL 模å<C2A1>— - Week 3 新增
// ============================================
import { aslRoutes } from './modules/asl/routes/index.js';

// ... 其他代ç <C3A7>

// 注册 ASL 模å<C2A1>—路由
await fastify.register(aslRoutes, { prefix: '/api/v1/asl' });

console.log('�ASL 路由已注册到 /api/v1/asl/*');

**验收标准**ï¼?- âœ?å<>Žç«¯å<C2AF>¯åŠ¨æˆ<C3A6>功

• âœ?访问 http://localhost:3001/api/v1/asl/projects 返回 200（å<CB86>³ä½¿æ˜¯ç©ºåˆ—表）

---

🗓�Week 2: LLM筛选核�

Day 4-5: LLM筛选æœ<C3A6>务实çŽ?

任务1: 定义 JSON Schema

*backend/src/modules/asl/schemas/screening.schema.tsï¼?

export const screeningOutputSchema = {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["decision", "reason", "confidence", "pico"],
  "properties": {
    "decision": {
      "type": "string",
      "enum": ["include", "exclude", "uncertain"]
    },
    "reason": {
      "type": "string",
      "minLength": 10,
      "maxLength": 500
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "pico": {
      "type": "object",
      "required": ["population", "intervention", "comparison", "outcome"],
      "properties": {
        "population": {
          "type": "string",
          "enum": ["match", "partial", "mismatch"]
        },
        "intervention": {
          "type": "string",
          "enum": ["match", "partial", "mismatch"]
        },
        "comparison": {
          "type": "string",
          "enum": ["match", "partial", "mismatch", "not_applicable"]
        },
        "outcome": {
          "type": "string",
          "enum": ["match", "partial", "mismatch"]
        }
      }
    },
    "studyDesign": {
      "type": "string",
      "enum": ["RCT", "cohort", "case-control", "cross-sectional", "review", "other"]
    },
    "evidences": {
      "type": "object",
      "properties": {
        "population": { "type": "string" },
        "intervention": { "type": "string" },
        "comparison": { "type": "string" },
        "outcome": { "type": "string" }
      }
    }
  }
};

任务2: 创建æ<C2BA><C3A6>示è¯<C3A8>模æ<C2A1>?

*backend/prompts/asl/screening/v1.0.0-basic.txtï¼?

你是一ä½<EFBFBD>医学文献筛选专家。请根æ<EFBFBD>®ä»¥ä¸‹ PICO 标准判断这篇文献是å<C2AF>¦åº”该纳入系统评价ã€?
# PICO 标准
- **Population (研究对象)**: {{population}}
- **Intervention (干预措施)**: {{intervention}}
- **Comparison (对照措施)**: {{comparison}}
- **Outcome (结局指标)**: {{outcome}}
- **Study Design (研究设计)**: {{studyDesign}}

# 纳入标准
{{inclusionCriteria}}

# 排除标准
{{exclusionCriteria}}

# 待筛选文�**标题**: {{title}}

**摘è¦<C3A8>**: {{abstract}}

# 输出è¦<C3A8>求

请严格按照以ä¸?JSON Schema 输出结果，输出纯JSON（ä¸<C3A4>è¦<C3A8>包å<E280A6>«ä»»ä½•å…¶ä»–文字）ï¼?
{
  "decision": "include/exclude/uncertain",
  "reason": "判断ç<C2AD>†ç”±ï¼?0-500字）",
  "confidence": 0.95,
  "pico": {
    "population": "match/partial/mismatch",
    "intervention": "match/partial/mismatch",
    "comparison": "match/partial/mismatch/not_applicable",
    "outcome": "match/partial/mismatch"
  },
  "studyDesign": "RCT/cohort/case-control/cross-sectional/review/other",
  "evidences": {
    "population": "原文中的关键è¯<C3A8>æ<EFBFBD>®çŸ­è¯­",
    "intervention": "原文中的关键è¯<C3A8>æ<EFBFBD>®çŸ­è¯­",
    "comparison": "原文中的关键è¯<C3A8>æ<EFBFBD>®çŸ­è¯­",
    "outcome": "原文中的关键è¯<C3A8>æ<EFBFBD>®çŸ­è¯­"
  }
}

# 注æ„<C3A6>事项
1. decision å<>ªèƒ½æ˜?"include"（纳入）ã€?exclude"（排除）æˆ?"uncertain"（ä¸<C3A4>确定ï¼?2. reason 必须具体说明判断ä¾<C3A4>æ<EFBFBD>®
3. confidence ä¸?0-1 之间的数å€?4. pico 字段é€<C3A9>项评估匹é…<C3A9>程度
5. evidences 字段æ<C2B5><C3A6>å<EFBFBD>–原文中的关键短语作为è¯<C3A8>æ<EFBFBD>®

任务3: 实现 LLM 筛选æœ<C3A6>åŠ?

*backend/src/modules/asl/services/llmScreeningService.tsï¼?

import { LLMFactory } from '../../../common/llm/adapters/LLMFactory.js';
import { parseJSON } from '../../../common/utils/jsonParser.js';
import Ajv from 'ajv';
import { screeningOutputSchema } from '../schemas/screening.schema.js';
import fs from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

const ajv = new Ajv();
const validateSchema = ajv.compile(screeningOutputSchema);

/**
 * LLM 筛选æœ<C3A6>åŠ? * 
 * @description
 * - å¤<C3A5>用 common/llm/adapters/LLMFactory.ts
 * - å<>Œæ¨¡åž‹å¹¶è¡Œè°ƒç”¨ï¼ˆDeepSeek + Qwenï¼? * - JSON Schema 验è¯<C3A8>
 * - 冲çª<C3A7>检æµ? * 
 * @version Week 3 Day 4-5
 */
class LLMScreeningService {
  /**
   * å<>Œæ¨¡åž‹å¹¶è¡Œç­›é€?   */
  async dualModelScreening(literature: any, protocol: any) {
    // 构建æ<C2BA><C3A6>示è¯?    const prompt = this.buildPrompt(literature, protocol);

    // 并行调用两个模型
    const [resultA, resultB] = await Promise.all([
      this.callModel('deepseek', prompt),
      this.callModel('qwen', prompt)
    ]);

    // 解æž<C3A6>JSON结果
    const decisionA = await this.parseModelOutput(resultA.content, 'deepseek');
    const decisionB = await this.parseModelOutput(resultB.content, 'qwen');

    // 一致性判�    const { consensus, conflictFields } = this.compareDecisions(decisionA, decisionB);

    // 自动分æµ<C3A6>
    const needReview = this.shouldReview(consensus, decisionA, decisionB);

    return {
      consensus,
      finalDecision: consensus === 'high' ? decisionA.decision : 'uncertain',
      needReview,
      conflictFields,
      modelA: decisionA,
      modelB: decisionB
    };
  }

  /**
   * 调用LLM模型（å¤<C3A5>用common/llmï¼?   */
  private async callModel(modelName: string, prompt: string) {
    const llm = LLMFactory.createLLM(modelName);
    
    const response = await llm.chat({
      messages: [
        { role: 'user', content: prompt }
      ],
      temperature: 0,  // 确定性输�      max_tokens: 1000
    });

    return response;
  }

  /**
   * 构建æ<C2BA><C3A6>示è¯?   */
  private buildPrompt(literature: any, protocol: any): string {
    // 读å<C2BB>–æ<E28093><C3A6>示è¯<C3A8>模æ<C2A1>?    const templatePath = path.resolve(__dirname, '../../../../prompts/asl/screening/v1.0.0-basic.txt');
    let template = fs.readFileSync(templatePath, 'utf-8');

    // 替æ<C2BF>¢å<C2A2>˜é‡<C3A9>
    template = template.replace('{{population}}', protocol.picoCriteria.population);
    template = template.replace('{{intervention}}', protocol.picoCriteria.intervention);
    template = template.replace('{{comparison}}', protocol.picoCriteria.comparison);
    template = template.replace('{{outcome}}', protocol.picoCriteria.outcome);
    template = template.replace('{{studyDesign}}', protocol.picoCriteria.studyDesign);
    template = template.replace('{{inclusionCriteria}}', protocol.inclusionCriteria);
    template = template.replace('{{exclusionCriteria}}', protocol.exclusionCriteria);
    template = template.replace('{{title}}', literature.title);
    template = template.replace('{{abstract}}', literature.abstract);

    return template;
  }

  /**
   * 解æž<C3A6>模型输出
   */
  private async parseModelOutput(content: string, modelName: string) {
    // 使用JSON解æž<C3A6>器（å¤<C3A5>用common/utilsï¼?    const parsed = parseJSON(content);

    // JSON Schema 验è¯<C3A8>
    const valid = validateSchema(parsed);
    if (!valid) {
      console.error('JSON Schema验è¯<C3A8>失败ï¼?, validateSchema.errors);
      throw new Error(`模型${modelName}输出格å¼<C3A5>ä¸<C3A4>符å<C2A6>ˆSchema`);
    }

    return {
      modelName,
      decision: parsed.decision,
      reason: parsed.reason,
      confidence: parsed.confidence,
      pico: parsed.pico,
      evidences: parsed.evidences,
      studyDesign: parsed.studyDesign
    };
  }

  /**
   * 对比两个模型的决�   */
  private compareDecisions(decisionA: any, decisionB: any) {
    const conflicts: string[] = [];

    // 比较最终决�    if (decisionA.decision !== decisionB.decision) {
      conflicts.push('decision');
    }

    // 比较PICOå<4F>„ç»´åº?    if (decisionA.pico.population !== decisionB.pico.population) conflicts.push('P');
    if (decisionA.pico.intervention !== decisionB.pico.intervention) conflicts.push('I');
    if (decisionA.pico.comparison !== decisionB.pico.comparison) conflicts.push('C');
    if (decisionA.pico.outcome !== decisionB.pico.outcome) conflicts.push('O');

    const consensus = conflicts.length === 0 ? 'high' : 'conflict';

    return { consensus, conflictFields: conflicts };
  }

  /**
   * 自动分æµ<C3A6>规则
   */
  private shouldReview(consensus: string, decisionA: any, decisionB: any): boolean {
    // 规则1：冲çª?â†?å¿…é¡»å¤<C3A5>æ ¸
    if (consensus === 'conflict') {
      return true;
    }

    // 规则2：低置信åº?â†?需è¦<C3A8>å¤<C3A5>æ ?    const avgConfidence = (decisionA.confidence + decisionB.confidence) / 2;
    if (avgConfidence < 0.7) {
      return true;
    }

    // 规则3：高置信�+ 一��自动通过
    return false;
  }

  /**
   * 批é‡<C3A9>ç­›é€?   */
  async batchScreening(literatures: any[], protocol: any, progressCallback?: (progress: number) => void) {
    const batchSize = 15;  // æ¯<C3A6>批15ç¯?    const results = [];

    for (let i = 0; i < literatures.length; i += batchSize) {
      const batch = literatures.slice(i, i + batchSize);

      // 并行处ç<E2809E>†å½“å‰<C3A5>批次
      const batchResults = await Promise.all(
        batch.map(lit => this.dualModelScreening(lit, protocol))
      );

      results.push(...batchResults);

      // 推é€<C3A9>è¿›åº?      const progress = Math.round(((i + batch.length) / literatures.length) * 100);
      progressCallback?.(progress);
    }

    return results;
  }
}

export const llmScreeningService = new LLMScreeningService();

**验收标准**ï¼?- âœ?LLMå<4D>Œæ¨¡åž‹è°ƒç”¨æˆ<C3A6>åŠ?- âœ?JSON Schema验è¯<C3A8>通过çŽ?> 95%

• âœ?冲çª<C3A7>检测准ç¡?

---

🗓ï¸?Week 3: å‰<C3A5>端模å<C2A1>—å¼€å<E282AC>?

Day 6-7: å‰<C3A5>端模å<C2A1>—结构创建

任务1: 更新模å<C2A1>—定义

*frontend-v2/src/modules/asl/index.tsx（修改）ï¼?

import { lazy } from 'react'
import { ModuleDefinition } from '@/framework/modules/types'
import { FileSearchOutlined } from '@ant-design/icons'

/**
 * ASL 模å<C2A1>—定义
 * 
 * @description
 * - 移除å<C2A4> ä½<C3A4>标记
 * - 实现真实模å<C2A1>—路由
 * 
 * @version Week 3 Day 6
 */
const ASLModule: ModuleDefinition = {
  id: 'literature-platform',
  name: 'AI智能文献',
  path: '/literature',
  icon: FileSearchOutlined,
  component: lazy(() => import('./routes')),
  placeholder: false,  // �改为 false
  requiredVersion: 'advanced',
  description: 'AI驱动的文献筛选和分æž<C3A6>系统',
}

export default ASLModule

任务2: 创建目录结构

cd frontend-v2/src/modules/asl
mkdir pages components api hooks types utils
touch routes.tsx
touch pages/ProjectList.tsx
touch pages/ScreeningSettings.tsx
touch pages/ScreeningWorkbench.tsx
touch pages/ScreeningResults.tsx
touch api/index.ts

任务3: 实现路由é…<C3A9>ç½®

*frontend-v2/src/modules/asl/routes.tsxï¼?

import { lazy } from 'react'
import { Routes, Route, Navigate } from 'react-router-dom'

const ProjectList = lazy(() => import('./pages/ProjectList'))
const ScreeningSettings = lazy(() => import('./pages/ScreeningSettings'))
const ScreeningWorkbench = lazy(() => import('./pages/ScreeningWorkbench'))
const ScreeningResults = lazy(() => import('./pages/ScreeningResults'))

/**
 * ASL 模å<C2A1>—路由
 * 
 * @description
 * - /literature - 项目列表
 * - /literature/project/:id/settings - 设置与å<C5BD>¯åŠ? * - /literature/project/:id/workbench - 审核工作å<C593>? * - /literature/project/:id/results - åˆ<C3A5>筛结果
 * 
 * @version Week 3 Day 6
 */
export default function ASLRoutes() {
  return (
    <Routes>
      <Route index element={<ProjectList />} />
      <Route path="project/:projectId">
        <Route path="settings" element={<ScreeningSettings />} />
        <Route path="workbench" element={<ScreeningWorkbench />} />
        <Route path="results" element={<ScreeningResults />} />
      </Route>
    </Routes>
  )
}

**验收标准**ï¼?- âœ?顶部导航显示"AI智能文献"（ä¸<C3A4>å†<C3A5>是å<C2AF> ä½<C3A4>ï¼?- âœ?点击å<C2BB>Žè¿›å…¥é¡¹ç›®åˆ—表页（å<CB86>³ä½¿æ˜¯ç©ºåˆ—表）

---

Day 8-10: 实现核心页é<C2B5>¢

（由于篇幅é™<EFBFBD>制，核心实现代ç <EFBFBD>请å<EFBFBD>‚考任务分解文档）

**验收标准**�- �Excel上传功能正常

• âœ?审核工作å<C593>°å<C2B0>¯å±•ç¤ºç­›é€‰ç»“æž?- âœ?å<>Œè§†å›¾æ¨¡æ€<C3A6>框å<E280A0>¯å¼¹å‡?

---

🗓ï¸?Week 4: 集æˆ<C3A6>测试与验æ”?

Day 11-14: 端到端测�

（详细测试计划è§<EFBFBD>任务分解文档ï¼? **验收标准**ï¼?- âœ?完整æµ<C3A6>程：上ä¼?â†?ç­›é€?â†?å¤<C3A5>æ ¸ â†?导出

• âœ?准确çŽ?â‰?85%
• âœ?性能达标ï¼?00ç¯?< 10分钟ï¼?

---

📚 相关文档

• å¼€å<EFBFBD>‘里程碑
• 任务分解（Todo List）
• è´¨é‡<EFBFBD>ä¿<EFBFBD>障策略
• 技术选型
• API设计规范
• å‰<EFBFBD>å<EFBFBD>Žç«¯æ¨¡å<EFBFBD>—化架构设计-V2

---

**更新日志**ï¼?- 2025-11-18: V3.1 更新，补充平å<C2B3>°åŸºç¡€è®¾æ–½å®Œæˆ<C3A6>状æ€<C3A6>（8个核心模å<C2A1>—）

• 2025-11-16: V3.0 é‡<C3A9>写，基于真实架构（Frontend-v2 + Backend + asl_schemaï¼?- 2025-11-16: V2.0 é‡<C3A9>写，详细到æ¯<C3A6>天的任务和代ç <C3A7>示例
• 2025-10-29: V1.0 创建，åˆ<C3A5>始版æœ?