feat(rvw,asl): RVW V3.0 smart review + ASL deep research history + stability

RVW module (V3.0 Smart Review Enhancement): - Add LLM data validation via PromptService (RVW_DATA_VALIDATION) - Add ClinicalAssessmentSkill with FINER-based evaluation (RVW_CLINICAL) - Remove all numeric scores from UI (editorial, methodology, overall) - Implement partial_completed status with Promise.allSettled - Add error_details JSON field to ReviewTask for granular failure info - Fix overallStatus logic: warning status now counts as success - Restructure ForensicsReport: per-table LLM results, remove top-level block - Refactor ClinicalReport: structured collapsible sections - Increase all skill timeouts to 300s for long manuscripts (20+ pages) - Increase DataForensics LLM timeout to 180s, pg-boss to 15min - Executor default fallback timeout 30s -> 60s ASL module: - Add deep research history with sidebar accordion UI - Implement waterfall flow for historical task display - Upgrade Unifuncs DeepSearch API from S2 to S3 with fallback - Add ASL_SR module seed for admin configurability - Fix new search button inconsistency Docs: - Update RVW module status to V3.0 - Update deployment changelist - Add 0305 deployment summary DB Migration: - Add error_details JSONB column to rvw_schema.review_tasks Tested: All 4 review modules verified, partial completion working Made-with: Cursor
2026-03-07 19:24:21 +08:00
parent 91ae80888e
commit 87655ea7e6
46 changed files with 2929 additions and 511 deletions
--- a/docs/03-业务模块/RVW-稿件审查系统/00-模块当前状态与开发指南.md
+++ b/docs/03-业务模块/RVW-稿件审查系统/00-模块当前状态与开发指南.md
@@ -1,30 +1,25 @@
 # RVW稿件审查模块 - 当前状态与开发指南

-> **文档版本：** v5.1  
+> **文档版本：** v6.0  
 > **创建日期：** 2026-01-07  
-> **最后更新：** 2026-02-18  
+> **最后更新：** 2026-03-07  
 > **维护者：** 开发团队  
-> **当前状态：** 🚀 **V2.0 "数据侦探" Week 3 完成（统计验证扩展+用户体验优化）**  
+> **当前状态：** 🚀 **V3.0 "智能审稿增强" 完成（LLM数据核查 + 临床评估 + 稳定性增强）**  
 > **文档目的：** 快速了解RVW模块状态，为新AI助手提供上下文
 > 
-> **🎉 V2.0 进展（2026-02-18 Week 3）：**
-> - ✅ **负号归一化**：防止 float() 崩溃，覆盖 6 种负号变体
-> - ✅ **T 检验验证增强**：智能样本量提取 + subrow 精确高亮
-> - ✅ **SE 三角验证增强**：多行单元格 subrow 支持
-> - ✅ **CI vs P 值验证增强**：subrow 支持 + 灵活 P 值解析
-> - ✅ **前端翻译映射**：新增 6 种 IssueType 中文翻译
-> - ✅ **文件格式提示**：PDF/.doc 上传时提示无法数据验证
+> **🎉 V3.0 进展（2026-03-07）：**
+> - ✅ **LLM 数据核查**：DataForensicsSkill 增加 LLM 验证通道，规则验证兜底，独立 60s 超时
+> - ✅ **临床专业评估**：新增 ClinicalAssessmentSkill，基于 FINER 标准的研究选题系统评估
+> - ✅ **PromptService 集成**：RVW_DATA_VALIDATION + RVW_CLINICAL 两个 Prompt 可在运营管理端配置
+> - ✅ **稳定性增强**：SkillExecutor 使用 Promise.allSettled 实现并行故障隔离
+> - ✅ **部分完成支持**：新增 `partial_completed` 状态 + `errorDetails` 字段，部分模块失败仍展示成功结果
+> - ✅ **前端 4 Tab 报告**：稿约规范性 / 方法学 / 数据验证 / 临床评估，Word 导出全覆盖
 > 
-> **🎉 V2.0 进展（Week 1-2）：**
-> - ✅ **L1 算术验证器**：行列加总、百分比验证（Day 3）
-> - ✅ **L2 统计验证器**：CI↔P 值一致性、卡方检验逆向验证（Day 6）
-> - ✅ **L2.5 一致性取证**：SE三角验证、SD>Mean检查（Day 6 终审提权）
-> - ✅ **Word 文档解析**：python-docx 表格提取 + 特殊符号提取（Day 2）
-> - ✅ **Skills 核心框架**：types、registry、executor、profile、context（Day 7）
-> - ✅ **DataForensicsSkill**：OSS 集成、依赖注入、优雅降级（Day 8）
-> - ✅ **EditorialSkill + MethodologySkill**：封装现有服务（Day 9）
-> - ✅ **ReviewWorker 改造**：集成 SkillExecutor，支持 V1/V2 切换（Day 10）
-> - ✅ **前端数据验证 Tab**：ForensicsReport 组件、精确单元格高亮（Week 3）
+> **V2.0 进展回顾：**
+> - ✅ L1 算术验证 + L2 统计验证 + L2.5 一致性取证
+> - ✅ Skills 核心框架（types, registry, executor, profile）
+> - ✅ DataForensicsSkill + EditorialSkill + MethodologySkill
+> - ✅ ReviewWorker 改造 + 前端数据验证 Tab

 ---

@@ -39,13 +34,13 @@
 | **商业价值** | ⭐⭐⭐⭐⭐ 极高 |
 | **独立性** | ⭐⭐⭐⭐⭐ 极高（用户群完全不同） |
 | **目标用户** | 期刊初审编辑 |
-| **开发状态** | ✅ **核心功能100%完成，支持Word导出，已集成到 frontend-v2** |
+| **开发状态** | ✅ **V3.0 完成：4维审查（规范性+方法学+数据验证+临床评估）+ 稳定性增强 + Word导出** |

 ### 核心目标

-> 打造一个**"开箱即用"**的智能审稿工具。编辑上传稿件，系统自动运行双重检查（规范性+方法学），输出可供参考的审稿报告。
+> 打造一个**"开箱即用"**的智能审稿工具。编辑上传稿件，系统自动运行多维检查（规范性+方法学+数据验证+临床评估），输出可供参考的审稿报告。
 > 
-> **核心指标**：上传到出报告 < 2分钟；规范性问题检出率 > 80%
+> **核心指标**：上传到出报告 < 3分钟（4模块并行）；规范性问题检出率 > 80%

 ### 功能规格

@@ -60,7 +55,19 @@
   - 统计学方法描述评估（5个检查点）
   - 统计分析评估（6个检查点）

-3. **综合评分 + PICO提取**
+3. **数据验证**（V2.0 规则 + V3.0 LLM 双通道）
+   - L1 算术验证：行列加总、百分比计算
+   - L2 统计验证：CI↔P 一致性、T检验、卡方检验
+   - L2.5 一致性取证：SE三角验证、SD>Mean检查
+   - LLM 智能核查：批量表格发给 LLM 核查（独立 60s 超时，失败降级为纯规则验证）
+
+4. **临床专业评估**（V3.0 新增）
+   - 基于 FINER 标准（可行性/创新性/伦理性/相关性）
+   - 研究问题明确性评估（PICO 完整性）
+   - 创新性 + 临床价值 + 科学性 + 可行性多维分析
+   - Prompt 可在运营管理端配置（RVW_CLINICAL）
+
+5. **综合评分 + PICO提取**
   - 规范性分数（0-100）
   - 方法学状态（🔴错误 🟡存疑 🟢通过）
   - PICO结构化提取（P/I/C/O）
@@ -95,14 +102,15 @@ backend/src/modules/rvw/
 │   ├── reviewService.ts             # 核心服务（任务创建、执行）
 │   ├── editorialService.ts          # 稿约规范性评估
 │   ├── methodologyService.ts        # 方法学评估
+│   ├── clinicalService.ts           # 🆕 V3.0 临床专业评估服务
 │   └── utils.ts                     # 工具函数
 ├── workers/
-│   └── reviewWorker.ts              # pg-boss异步任务处理（V2.0 Skills集成）
-├── skills/                          # 🆕 V2.0 Skills 架构
-│   ├── core/                        # 核心框架（types, registry, executor等）
-│   ├── library/                     # Skill 实现（Forensics, Editorial, Methodology）
+│   └── reviewWorker.ts              # pg-boss异步任务处理（V2.0 Skills集成 + V3.0 partial_completed）
+├── skills/                          # V2.0 Skills 架构
+│   ├── core/                        # 核心框架（types, registry, executor[allSettled]等）
+│   ├── library/                     # Skill 实现（Forensics[+LLM], Editorial, Methodology, 🆕Clinical）
 │   └── index.ts                     # 模块入口
-├── types/index.ts                   # TypeScript类型定义
+├── types/index.ts                   # TypeScript类型定义（含 partial_completed 状态）
 └── __tests__/                       # API测试脚本

 前端（✅ 已完成）：
@@ -116,11 +124,13 @@ frontend-v2/src/modules/rvw/
 └── components/
    ├── Header.tsx                   # 页头（上传按钮）
    ├── Sidebar.tsx                  # 侧边栏导航
-    ├── TaskTable.tsx                # 任务列表表格
-    ├── TaskDetail.tsx               # 任务详情（进度条+报告+Word导出）
+    ├── TaskTable.tsx                # 任务列表表格（支持 partial_completed 状态）
+    ├── TaskDetail.tsx               # 任务详情（进度条+报告+Word导出+部分完成警告）
    ├── EditorialReport.tsx          # 稿约规范性报告
    ├── MethodologyReport.tsx        # 方法学评估报告
-    ├── AgentModal.tsx               # 智能体选择弹窗
+    ├── ForensicsReport.tsx          # 数据验证报告（含 LLM 核查结果）
+    ├── ClinicalReport.tsx           # 🆕 V3.0 临床专业评估报告
+    ├── AgentModal.tsx               # 智能体选择弹窗（4 个维度）
    └── ScoreRing.tsx                # 评分环组件

 旧版本（保留兼容）：
@@ -129,13 +139,17 @@ backend/src/legacy/
 ├── controllers/reviewController.ts
 └── services/reviewService.ts

-Prompt（保持不变）：
+Prompt（文件 + PromptService 数据库双通道）：
 backend/prompts/
 ├── review_editorial_system.txt      # 稿约评估（266行）
 └── review_methodology_system.txt    # 方法学评估（257行）
+数据库 prompt_templates 表（运营管理端可配置）：
+├── RVW_DATA_VALIDATION              # 🆕 V3.0 数据验证 LLM 核查 Prompt
+└── RVW_CLINICAL                     # 🆕 V3.0 临床专业评估 Prompt

 数据库（✅ 已完成）：
 - ReviewTask表已添加新字段：selectedAgents, editorialScore, methodologyScore, methodologyStatus, picoExtract, isArchived, archivedAt
+- 🆕 V3.0 新增 error_details JSONB 字段（Skill 级失败详情，支持 partial_completed 状态）
 - ✅ Schema已迁移到 rvw_schema（2026-01-10完成）
 ```

@@ -211,11 +225,12 @@ backend/prompts/

 | 能力 | 位置 | 用途 |
 |------|------|------|
-| **LLM网关** | `@/common/llm/LLMFactory` | AI评估 |
+| **LLM网关** | `@/common/llm/LLMFactory` | AI评估（稿约/方法学/数据核查/临床评估） |
+| **PromptService** | `@/common/prompt` | 🆕 V3.0 Prompt 管理（灰度预览、运营端配置） |
 | **文档处理** | `ExtractionClient` | Word/PDF文本提取 |
-| **存储** | `@/common/storage` | 文件存储 |
+| **存储** | `@/common/storage` | 文件存储（OSS/本地） |
 | **日志** | `@/common/logging` | 结构化日志 |
-| **任务队列** | `jobQueue` | 异步任务处理 |
+| **任务队列** | `jobQueue` | 异步任务处理（pg-boss） |

 ### LLM模型

@@ -326,11 +341,13 @@ Content-Type: multipart/form-data

 ### 对新AI助手

-1. ✅ **核心功能已完成**：前后端已迁移到新架构，可正常使用
+1. ✅ **V3.0 已完成**：4 维审查 + 稳定性增强 + partial_completed 支持
 2. ✅ **已集成到 frontend-v2**：通过顶部导航栏"预审稿"进入
 3. ✅ **v2 API 已就绪**：/api/v2/rvw/* 路由可用
 4. ✅ **遵循云原生规范**：使用 logger 服务替代 console.log
-5. ⚠️ **保留旧API**：v1路由保持兼容，支持旧前端
+5. ✅ **PromptService 集成**：RVW_DATA_VALIDATION + RVW_CLINICAL Prompt 可在运营管理端配置
+6. ✅ **并行故障隔离**：SkillExecutor 使用 Promise.allSettled，单个 Skill 崩溃不影响其他
+7. ⚠️ **保留旧API**：v1路由保持兼容，支持旧前端

 ### 已完成改造

@@ -414,9 +431,25 @@ Content-Type: multipart/form-data
 - ✅ 前端翻译映射更新（6 种新 IssueType）
 - ✅ 文件格式提示（Header、ReportDetail、TaskDetail）

-### 后续版本（V2.1+）
+### 🚀 V3.0 "智能审稿增强" 开发进度（2026-03-07）

- [ ] Week 4 功能测试和 Bug 修复
+| 任务 | 状态 | 说明 |
+|------|------|------|
+| LLM 数据核查通道 | ✅ 已完成 | DataForensicsSkill 增加 LLM 验证，独立 60s 超时，规则验证兜底 |
+| RVW_DATA_VALIDATION Prompt | ✅ 已完成 | PromptService 集成，运营管理端可配置 |
+| 临床专业评估 Skill | ✅ 已完成 | ClinicalAssessmentSkill，基于 FINER 标准 |
+| RVW_CLINICAL Prompt | ✅ 已完成 | PromptService 集成，运营管理端可配置 |
+| SkillExecutor Promise.allSettled | ✅ 已完成 | 并行 Skill 故障隔离，单个崩溃不影响其他 |
+| partial_completed 状态 | ✅ 已完成 | 新增任务状态 + error_details JSONB 字段 |
+| reviewWorker 写入 errorDetails | ✅ 已完成 | 记录每个失败/超时 Skill 的名称和原因 |
+| 前端 4 Tab 报告 | ✅ 已完成 | 稿约规范性/方法学/数据验证/临床评估 |
+| 前端 partial_completed UI | ✅ 已完成 | 琥珀色警告横幅 + 列表"部分完成"标签 |
+| Word 导出覆盖临床评估 | ✅ 已完成 | 导出报告包含临床专业评估章节 |
+
+### 后续版本（V3.1+）
+
+- [ ] 全面移除评分机制（只列问题，不打分）
+- [ ] 单模块重试机制（partial_completed → 重试失败模块）
 - [ ] ANOVA 验证（多组比较）
 - [ ] 配对 T 检验验证
 - [ ] 非参数检验（Mann-Whitney、Wilcoxon）
@@ -429,7 +462,7 @@ Content-Type: multipart/form-data

 ---

-**文档版本：** v5.1  
-**最后更新：** 2026-02-18  
-**当前状态：** 🚀 V2.0 "数据侦探" Week 3 完成，Skills 架构 + 统计验证 + 用户体验优化  
-**下一步：** Week 4 功能测试和 Bug 修复
+**文档版本：** v6.0  
+**最后更新：** 2026-03-07  
+**当前状态：** 🚀 V3.0 "智能审稿增强" 完成（LLM数据核查 + 临床评估 + 稳定性增强）  
+**下一步：** V3.1 移除评分机制 + 单模块重试