# V2.2版本变化说明

> **版本�?* V2.2（前端架构优先版�? 
> **发布日期�?* 2025-11-09  
> **核心变化�?* 前端统一架构提前到Week 2 ⭐⭐�?

---

## 📊 V2.2 vs V2.1 核心差异

| 维度 | V2.1�?| V2.2�?�?| 为什么调整？ |
|------|-------|---------|------------|
| **Week 2核心任务** | 后端分层 + LLM网关 | **前端统一架构 + 后端分层** | 架构先行，避免ASL开发后返工 ⭐⭐�?|
| **前端架构时机** | 未明�?| **Week 2上半周完�?* | ASL在统一框架下开�?|
| **LLM网关开�?* | Week 2完成 | **推迟到Week 5** | 现有调用已work，避免过度设�?|
| **ASL开发环�?* | 独立开�?| **统一架构下开�?* | 不需要后期重�?|
| **CloseAI配置** | 未提�?| **已完�?* | 4个LLM可用（含GPT-5、Claude-4.5）|

---

## 🎯 V2.2版核心理�?

### 1. 架构先行 ⭐⭐�?

**问题�?* V2.1版中，前端架构时机不明确
- Week 3开发ASL时，前端还是散乱�?
- 开发完后再重构 �?大量返工

**解决�?* V2.2版将前端架构提前到Week 2
- �?Week 2先建立统一布局和导�?
- �?所有模块（AIA、PKB、审稿）插件化接�?
- �?Week 3开发ASL时，直接在统一框架�?
- �?不需要后期重�?

### 2. Just-in-time开�?⭐⭐

**问题�?* V2.1版Week 2就要开发LLM网关
- 还没有实际使用场�?
- 容易过度设计

**解决�?* V2.2版推迟到Week 5
- �?Week 3-4 ASL开发时，有了实际使用场�?
- �?Week 5抽取LLM网关更合�?
- �?现有CloseAI配置已够�?

### 3. 聚焦核心价�?⭐⭐

**原则�?*
- Week 1: 数据架构基础 �?
- Week 2: **前端+后端架构统一** �?
- Week 3-4: ASL核心功能 �?
- Week 5+: 优化和扩�?

---

## 📋 Week 2详细对比

### V2.1版Week 2

```
Day 6-7: 后端代码分层
Day 8-9: LLM网关开�?
Day 10: 验收

问题：前端架构未涉及
```

### V2.2版Week 2 �?

```
Day 6-7（上半周�? 前端统一架构 ⭐⭐�?
  - Day 6上午: 前端架构设计（技术栈、模块化、导航）
  - Day 6下午-7: 实施（Layout、模块注册、整合现有模块）

Day 8-9（下半周�? 后端代码分层
  - 三层目录结构
  - 保留简单LLM调用（够用）

Day 10: 验收 + Week 3准备

优势：前端架构一次到�?
```

---

## 🎨 前端架构设计要点

### Week 2 Day 6上午的核心任�?

**需要决策的问题�?*

1. **技术栈确认**
   - UI组件库：Ant Design? Material-UI?
   - 路由方案：React Router配置
   - 状态管理：Redux? Zustand? 不用�?
   - 当前Vite构建工具是否需要调整？

2. **统一布局设计**
   - 顶部导航栏（Logo、模块切换、用户信息）
   - 侧边菜单（收�?展开、多级菜单）
   - 主内容区
   - 面包屑导�?

3. **模块插件化机�?*
   - 模块如何注册�?
   - 路由如何动态加载？
   - 权限如何控制�?
   - 样式如何隔离�?

4. **导航结构**
   - 一级导航：模块级（AIA、PKB、ASL等）
   - 二级导航：功能级（项目、对话、筛选等�?
   - 响应式适配

**设计原则�?*
- 简单易维护（单人开发）
- 模块化清晰（支持独立开发）
- 扩展性好（新模块快速接入）
- 用户体验佳（统一交互风格�?

**说明�?* 这些问题在Week 2 Day 6上午集中讨论决策，不在计划中详细展开�?

---

## 🚀 4个LLM配置（新增）

### V2.1版：只提到DeepSeek和Qwen

### V2.2版：4个LLM完整配置 �?

**已完成配置（CloseAI）：**

1. **DeepSeek-V3** (直连)
   - 用途：快速初筛，成本�?
   - 价格：�?.001/1K tokens

2. **GPT-5-Pro** (CloseAI代理) �?新增
   - 用途：精准筛选，质量�?
   - 价格：�?.10/1K tokens
   - Model ID: `gpt-5-pro`

3. **Claude-4.5-Sonnet** (CloseAI代理) �?新增
   - 用途：冲突仲裁，结构化输出
   - 价格：�?.021/1K tokens
   - Model ID: `claude-sonnet-4-5-20250929`

4. **Qwen-Max** (备�?
   - 用途：长文本处理，性价比高
   - 价格：�?.004/1K tokens

**筛选策略：**
- **双模型对�?*（DeepSeek + GPT-5�? 推荐 �?
- **三模型仲�?*�?Claude�? 冲突时启�?
- **成本优化**�?0% DeepSeek�?0% GPT-5�?

**配置文档�?*
- `02-通用能力�?01-LLM大模型网�?03-CloseAI集成指南.md` �?
- `07-运维文档/01-环境配置指南.md`
- `backend/CLOSEAI-CONFIG.md`

---

## �?V2.2版优势总结

### 核心优势 ⭐⭐�?

**1. 避免返工（最大价值）**
```
V2.1版流程：
Week 2: 后端分层
Week 3-4: ASL开发（前端散乱�?
Week 5: 发现需要重构前�?�?返工 �?

V2.2版流程：
Week 2: 前端架构先完�?
Week 3-4: ASL直接在统一框架下开�?
Week 5: 继续扩展，不需要重�?�?
```

**2. 开发效率提�?*
- Week 3开发ASL时，前端框架已就�?
- 只需关注业务逻辑，不用考虑架构
- 模块插件化，代码结构清晰

**3. 质量保证**
- 4个LLM已配置好（含GPT-5和Claude-4.5�?
- 统一的用户体�?
- 便于测试和维�?

**4. 灵活扩展**
- 新模块直接插入统一框架
- 不影响现有模�?
- 前端架构稳定

---

## 📝 关键决策记录

### 决策1：前端架构提前到Week 2

**背景�?*
- 用户反馈：前端各模块独立散乱，需要统一
- ASL是重点模块，不应该在散乱架构下开�?

**决策�?*
- Week 2上半周优先完成前端统一架构
- 建立模块插件化机�?
- ASL在统一框架下开�?

**收益�?*
- 避免ASL开发后重构
- 提升开发效�?
- 保证用户体验一致�?

---

### 决策2：LLM网关推迟到Week 5

**背景�?*
- 现有DeepSeek和Qwen调用已work
- CloseAI配置已完成（GPT-5、Claude-4.5可用�?
- Week 2时间有限，需要聚焦前端架�?

**决策�?*
- Week 2只保留简单LLM调用
- Week 3-4 ASL开发时使用现有调用
- Week 5有了实践经验，再统一抽取LLM网关

**收益�?*
- 避免过度设计
- 聚焦核心价�?
- Just-in-time开�?

---

### 决策3：集成CloseAI（GPT-5和Claude-4.5�?

**背景�?*
- AI智能文献需要高质量的LLM
- DeepSeek虽快但准确率85%
- GPT-5和Claude-4.5准确�?5%+

**决策�?*
- 配置CloseAI代理（已完成�?
- 4个LLM组合使用
- 双模型对�?+ 三模型仲�?

**收益�?*
- 文献筛选质量大幅提�?
- 成本可控（灵活策略）
- 国内稳定访问

---

## 🎯 执行建议

### 如果还没开始Week 1

1. 按V2.2版执�?
2. Week 1重点：Schema隔离�?详细+7空）
3. Week 2重点�?*前端架构优先** ⭐⭐�?

### 如果Week 1已完�?

1. **立即启动Week 2前端架构设计**
2. Day 6上午：前端架构设计会�?�?
3. Day 6下午-7：实施前端统一架构
4. Day 8-9：后端代码分�?

### 如果已经在开发ASL

1. **暂停ASL开�?*
2. **补做前端统一架构**
3. 将ASL重构到统一框架�?
4. 虽然会有一点返工，但长远更�?

---

## 📚 相关文档

**V2.2版完整计划：**
- [下一阶段行动计划-V2.2-前端架构优先�?md](./下一阶段行动计划-V2.2-前端架构优先�?md) ⭐⭐�?

**前端架构参考：**
- [前端总体架构设计](../01-平台基础�?06-前端架构/01-前端总体架构设计.md)
- [导航结构设计](../01-平台基础�?06-前端架构/02-导航结构设计.md)

**LLM配置参考：**
- [CloseAI集成指南](../02-通用能力�?01-LLM大模型网�?03-CloseAI集成指南.md) �?
- [环境配置指南](../07-运维文档/01-环境配置指南.md)

**V2.1版对比：**
- [下一阶段行动计划-V2.1-务实�?md](./下一阶段行动计划-V2.1-务实�?md)

---

**更新日期�?* 2025-11-09  
**制定人：** AI助手  
**核心理念�?* 架构先行 + Just-in-time + 聚焦核心 = 高效务实�?⭐⭐�?