From 6fd15a14e0768e03f8617d6c48b3f888b8216142 Mon Sep 17 00:00:00 2001
From: AI Clinical Dev Team <dev@ai-clinical.com>
Date: Fri, 10 Oct 2025 17:37:55 +0800
Subject: [PATCH] docs(frontend): improve README documentation with detailed
 description of 12 agents

---
 frontend/README.md | 110 ++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 95 insertions(+), 15 deletions(-)

diff --git a/frontend/README.md b/frontend/README.md
index 2ffefd70..85657f4d 100644
--- a/frontend/README.md
+++ b/frontend/README.md
@@ -120,23 +120,103 @@ proxy: {
 
 ## 🎯 智能体列表
 
-### 选题阶段
-1. 🎯 选题评价智能体 - 评估研究选题的价值和可行性
-2. 🔬 科学问题梳理智能体 - 提炼清晰的科学问题
+本平台提供12个AI智能体，覆盖临床研究全流程：
 
-### 研究设计阶段
-3. 📋 PICOS构建智能体 - 构建PICOS框架
-4. 📊 观察指标设计智能体 - 设计观察指标
-5. 📝 CRF制定智能体 - 制定病例报告表
-6. 🔢 样本量计算智能体 - 计算样本量
-7. 📄 临床研究方案撰写智能体 - 撰写研究方案
+### 🌱 选题阶段
 
-### 论文阶段
-8. ✨ 论文润色智能体 - 语言润色
-9. 🌐 论文翻译智能体 - 中英互译
-10. 🔍 方法学评审智能体 - 方法学评审
-11. 📑 期刊方法学评审智能体 - 模拟期刊审稿
-12. ✅ 期刊稿约评审智能体 - 检查投稿格式
+#### 1. 🎯 选题评价智能体
+- **路由ID**: `topic-evaluation`
+- **功能**: 从创新性、临床价值、科学性和可行性等维度评估研究选题
+- **输入**: 用户提供的临床问题描述
+- **输出**: 结构化评价报告，包含SWOT分析及综合建议
+
+#### 2. 🔬 科学问题梳理智能体
+- **路由ID**: `scientific-question`
+- **功能**: 将模糊的研究想法提炼成清晰、具体、可验证的科学问题
+- **输入**: 初步研究想法（如"研究肠道菌群与抑郁症的关系"）
+- **输出**: 多个精炼后的科学问题选项
+
+---
+
+### 🔬 研究设计阶段
+
+#### 3. 📋 PICOS构建智能体
+- **路由ID**: `picos-construction`
+- **功能**: 按照PICOS原则结构化定义临床研究的核心要素
+- **输入**: 引导式表单或自由文本描述的研究问题
+- **输出**: 标准化的PICOS表格（P-患者/人群、I-干预、C-对照、O-结局、S-研究设计）
+
+#### 4. 📊 观察指标设计智能体
+- **路由ID**: `observation-design`
+- **功能**: 基于研究设计推荐合适的观察指标集
+- **输入**: 已确定的PICOS框架或研究问题
+- **输出**: 包含主要、次要及安全性指标的详细清单
+
+#### 5. 📝 CRF制定智能体
+- **路由ID**: `crf-development`
+- **功能**: 自动生成结构化、符合规范的病例报告表（CRF）框架
+- **输入**: 研究方案、观察指标清单
+- **输出**: 可下载的CRF框架草稿（Word/Excel格式）
+
+#### 6. 🔢 样本量计算智能体
+- **路由ID**: `sample-size`
+- **功能**: 根据研究类型、检验水准、把握度、效应量等参数估算样本量
+- **输入**: 引导式表单（研究设计、α、β、效应量等）
+- **输出**: 详细的样本量计算结果，包含公式、参数说明和建议样本量
+
+#### 7. 📄 临床研究方案撰写智能体
+- **路由ID**: `protocol-writing`
+- **功能**: 基于科学问题、PICOS等信息，自动生成完整的临床研究设计方案
+- **输入**: 科学问题、PICOS、样本量等
+- **输出**: 包含研究背景、目的、设计、流程等章节的Word文档初稿
+
+---
+
+### 📝 论文阶段
+
+#### 8. ✨ 论文润色智能体
+- **路由ID**: `paper-polishing`
+- **功能**: 提供专业级的语言润色，修正语法、拼写和表达方式
+- **输入**: 上传的论文稿件（Word/Text），目标期刊名称（可选）
+- **输出**: 带修订标记的润色后文稿及修改摘要说明
+
+#### 9. 🌐 论文翻译智能体
+- **路由ID**: `paper-translation`
+- **功能**: 提供专业、精准的中英互译服务，优化医学科研术语
+- **输入**: 上传的论文稿件，选择源语言和目标语言
+- **输出**: 翻译完成的稿件，保留原格式
+
+#### 10. 🔍 方法学评审智能体
+- **路由ID**: `methodology-review`
+- **功能**: 从研究问题、方案设计、实施可行性和临床意义等维度进行方法学评审
+- **输入**: 上传的研究方案或论文稿件
+- **输出**: 评审报告，分点列出优点、潜在缺陷及改进建议
+
+#### 11. 📑 期刊方法学评审智能体
+- **路由ID**: `journal-methodology-review`
+- **功能**: 模拟期刊审稿人视角，针对统计学、方法学问题进行挑战
+- **输入**: 上传的论文稿件，目标期刊
+- **输出**: 模拟的"审稿意见"，列出可能被挑战的问题点
+
+#### 12. ✅ 期刊稿约评审智能体
+- **路由ID**: `journal-guidelines-review`
+- **功能**: 依据目标期刊的投稿要求，自动检查格式、字数、参考文献规范
+- **输入**: 上传的论文稿件，目标期刊的投稿指南
+- **输出**: 格式审查报告，清晰列出所有不符合项和修改建议
+
+---
+
+### 🔗 路由规则
+
+所有智能体页面遵循统一路由规则：
+```
+/agent/{路由ID}
+```
+
+**示例**：
+- `/agent/topic-evaluation` - 选题评价智能体
+- `/agent/picos-construction` - PICOS构建智能体
+- `/agent/paper-polishing` - 论文润色智能体
 
 ## 📞 技术支持