# 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** (直连)
   - 用途：快速初筛，成本低
   - 价格：¥0.001/1K tokens

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

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

4. **Qwen-Max** (备选)
   - 用途：长文本处理，性价比高
   - 价格：¥0.004/1K tokens

**筛选策略：**
- **双模型对比**（DeepSeek + GPT-5）- 推荐 ⭐
- **三模型仲裁**（+Claude）- 冲突时启用
- **成本优化**（80% DeepSeek，20% 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准确率95%+

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

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

---

## 🎯 执行建议

### 如果还没开始Week 1

1. 按V2.2版执行
2. Week 1重点：Schema隔离（3详细+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 + 聚焦核心 = 高效务实！ ⭐⭐⭐