YG_FT/frontend/README.md

# 远光软件微调平台 - 前端（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:16801`。

后端 API 默认通过 Vite 代理转发到 `http://localhost:17861`（见 `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。