HaHafeng
e52020409c
- System architecture and design documentation - Business module docs (ASL/AIA/PKB/RVW/DC/SSA/ST) - ASL module complete design (quality assurance, tech selection) - Platform layer and common capabilities docs - Development standards and API specifications - Deployment and operations guides - Project management and milestone tracking - Architecture implementation reports - Documentation templates and guides
7.6 KiB
7.6 KiB
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上午的核心任务
需要决策的问题：
-
技术栈确认
- UI组件库：Ant Design? Material-UI?
- 路由方案：React Router配置
- 状态管理：Redux? Zustand? 不用？
- 当前Vite构建工具是否需要调整？
-
统一布局设计
- 顶部导航栏（Logo、模块切换、用户信息）
- 侧边菜单（收缩/展开、多级菜单）
- 主内容区
- 面包屑导航
-
模块插件化机制
- 模块如何注册？
- 路由如何动态加载？
- 权限如何控制？
- 样式如何隔离？
-
导航结构
- 一级导航：模块级（AIA、PKB、ASL等）
- 二级导航：功能级（项目、对话、筛选等）
- 响应式适配
设计原则：
- 简单易维护（单人开发）
- 模块化清晰（支持独立开发）
- 扩展性好（新模块快速接入）
- 用户体验佳（统一交互风格）
说明： 这些问题在Week 2 Day 6上午集中讨论决策，不在计划中详细展开。
🚀 4个LLM配置（新增）
V2.1版：只提到DeepSeek和Qwen
V2.2版：4个LLM完整配置 ⭐
已完成配置（CloseAI）：
-
DeepSeek-V3 (直连)
- 用途：快速初筛，成本低
- 价格：¥0.001/1K tokens
-
GPT-5-Pro (CloseAI代理) ⭐ 新增
- 用途：精准筛选，质量高
- 价格：¥0.10/1K tokens
- Model ID:
gpt-5-pro
-
Claude-4.5-Sonnet (CloseAI代理) ⭐ 新增
- 用途：冲突仲裁，结构化输出
- 价格：¥0.021/1K tokens
- Model ID:
claude-sonnet-4-5-20250929
-
Qwen-Max (备选)
- 用途：长文本处理，性价比高
- 价格：¥0.004/1K tokens
筛选策略：
- 双模型对比（DeepSeek + GPT-5）- 推荐 ⭐
- 三模型仲裁（+Claude）- 冲突时启用
- 成本优化（80% DeepSeek，20% GPT-5）
配置文档：
02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md⭐07-运维文档/01-环境配置指南.mdbackend/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
- 按V2.2版执行
- Week 1重点：Schema隔离（3详细+7空）
- Week 2重点：前端架构优先 ⭐⭐⭐
如果Week 1已完成
- 立即启动Week 2前端架构设计
- Day 6上午：前端架构设计会议 ⭐
- Day 6下午-7：实施前端统一架构
- Day 8-9：后端代码分层
如果已经在开发ASL
- 暂停ASL开发
- 补做前端统一架构
- 将ASL重构到统一框架下
- 虽然会有一点返工，但长远更好
📚 相关文档
V2.2版完整计划：
前端架构参考：
LLM配置参考：
V2.1版对比：
更新日期： 2025-11-09
制定人： AI助手
核心理念： 架构先行 + Just-in-time + 聚焦核心 = 高效务实！ ⭐⭐⭐