75 lines
2.3 KiB
Markdown
75 lines
2.3 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
|
||
```
|
||
|
||
通过根目录 `scripts/start-dev.sh` 启动时，开发服务器端口和后端代理端口来自
|
||
`backend/config.yaml` 的 `server` 配置。单独运行 `npm run dev` 时默认使用前端
|
||
`16801` 和后端 `17861`；可用 `FRONTEND_PORT`、`BACKEND_PORT` 环境变量覆盖。
|
||
|
||
开发环境默认联调真实后端接口。如需进行隔离前端开发，可显式启用 Mock：
|
||
|
||
```bash
|
||
VITE_ENABLE_MOCK=true npm run dev
|
||
```
|
||
|
||
真实联调、测试环境和生产环境不应启用 Mock。
|
||
|
||
## 构建
|
||
|
||
```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。
|