# API 契约：训练数据导出与微调

*所有接口需要 ADMIN 权限*

---

## GET /api/training/samples

**描述**: 分页查询已审批、可导出的训练样本

**查询参数**: `page`、`pageSize`、`sampleType`（TEXT / IMAGE / VIDEO_FRAME，可选）、`exported`（true/false，可选）

**响应** `200`:
```json
{
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "id": 1001,
        "sampleType": "TEXT",
        "status": "APPROVED",
        "exportBatchId": null,
        "sourceId": 50,
        "createdAt": "2026-04-09T12:00:00"
      }
    ],
    "total": 500,
    "page": 1,
    "pageSize": 20
  }
}
```

---

## POST /api/export/batch

**描述**: 创建导出批次，合并选定样本为 JSONL 并上传 RustFS

**请求体**:
```json
{
  "sampleIds": [1001, 1002, 1003]
}
```

**成功响应** `201`:
```json
{
  "code": "SUCCESS",
  "data": {
    "id": 10,
    "batchUuid": "550e8400-e29b-41d4-a716-446655440000",
    "sampleCount": 3,
    "datasetFilePath": "export/550e8400.jsonl",
    "finetuneStatus": "NOT_STARTED"
  }
}
```

**失败**:
- `400` `INVALID_SAMPLES`: 部分样本不处于 APPROVED 状态
- `400` `EMPTY_SAMPLES`: sampleIds 为空

---

## POST /api/export/{batchId}/finetune

**描述**: 向 GLM AI 服务提交微调任务

**响应** `200`:
```json
{
  "code": "SUCCESS",
  "data": {
    "glmJobId": "glm-finetune-abc123",
    "finetuneStatus": "RUNNING"
  }
}
```

**失败**: `409` `FINETUNE_ALREADY_STARTED`: 微调任务已提交

---

## GET /api/export/{batchId}/status

**描述**: 查询微调任务状态（向 AI 服务实时查询）

**响应** `200`:
```json
{
  "code": "SUCCESS",
  "data": {
    "batchId": 10,
    "glmJobId": "glm-finetune-abc123",
    "finetuneStatus": "RUNNING",
    "progress": 45,
    "errorMessage": null
  }
}
```

---

## GET /api/export/list

**描述**: 分页查询所有导出批次

**查询参数**: `page`、`pageSize`

**响应** `200`: 批次列表（含 finetuneStatus、sampleCount、createdAt 等字段）