4173b53b1b
移除全量 Element Plus 与全局 VChart 注册，改为按需引入样式与组件内局部图表；Mock 适配器改为按 VITE_ENABLE_MOCK 环境变量懒加载，生产默认不拦截请求；ECharts 精简为看板所需图表，各视图与 stores 同步适配。
76 lines
2.2 KiB
Markdown
76 lines
2.2 KiB
Markdown
# 远光软件微调平台 - 前端（Vue 3）
|
||
|
||
> 由原 `web/` 静态多页面 HTML 项目改造而来。
|
||
|
||
## 技术栈
|
||
|
||
- **Vue 3** + **TypeScript** + **Vite**
|
||
- **Vue Router 4** - 路由
|
||
- **Pinia** - 状态管理
|
||
- **Element Plus** - UI 组件库（主色 `#1890ff`）
|
||
- **axios** - HTTP 请求
|
||
- **Chart.js** - 训练曲线图表
|
||
- **marked + DOMPurify** - Markdown 渲染
|
||
- **md-editor-v3** - Prompt 编辑器
|
||
- **@vueuse/core** - 组合式工具
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
开发服务器默认运行在 `http://localhost:6801`。
|
||
|
||
后端 API 默认通过 Vite 代理转发到 `http://localhost:7861`（见 `vite.config.ts`）。
|
||
|
||
开发环境默认启用前端 Mock。如需联调真实后端，使用：
|
||
|
||
```bash
|
||
VITE_ENABLE_MOCK=false npm run dev
|
||
```
|
||
|
||
生产构建默认不包含 Mock；仅在演示构建中可显式设置
|
||
`VITE_ENABLE_MOCK=true`。
|
||
|
||
## 构建
|
||
|
||
```bash
|
||
npm run build # 类型检查 + 生产构建，产物在 dist/
|
||
npm run preview # 本地预览构建产物
|
||
npm run type-check # 仅类型检查
|
||
```
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
src/
|
||
├── api/ # axios 封装 + 各业务模块 API
|
||
├── components/ # 公共组件（侧边栏、顶部栏、通用列表等）
|
||
├── composables/ # 组合式函数（流式对话、图表、轮询等）
|
||
├── constants/ # 常量与映射表
|
||
├── layouts/ # 主布局
|
||
├── router/ # 路由配置 + 登录守卫
|
||
├── stores/ # Pinia 状态（auth/system/models/tools）
|
||
├── styles/ # 全局样式与主题
|
||
├── types/ # TypeScript 类型定义
|
||
└── views/ # 页面视图
|
||
├── login/ # 登录
|
||
├── fine-tune/ # 模型调优
|
||
├── eval/ # 模型评测
|
||
├── inference/ # 模型推理
|
||
├── compare/ # 模型对比
|
||
├── model/ # 模型管理
|
||
├── dataset/ # 数据集
|
||
├── tools/ # 其他工具
|
||
└── system/ # 平台性能 / 日志
|
||
```
|
||
|
||
## 与原 web/ 项目的关系
|
||
|
||
- 原 `web/` 目录**保留不动**，作为功能对照参照。
|
||
- 新前端位于 `frontend/`，新旧可并存。
|
||
- 后端 API 端点完全不变，仅前端实现方式改为 Vue SPA。
|