---
title: "获取扫描进度"
method: GET
path: "/scan/progress"
tags: ["扫描管理"]
---

# 获取扫描进度

`GET /scan/progress`

获取当前扫描任务的进度信息

## Response `200`

扫描进度信息

- ServicesScanProgress
  - `cleaned_files` integer — 清理的过期文件数
  - `cue_split_sources` integer — splitting_cue 阶段已处理的 CUE 来源数
  - `current_file` string — 当前处理的文件
  - `discovered_files` integer — scanning 阶段已发现的音频文件数
  - `end_time` string — 结束时间
  - `error` string — 错误信息
  - `failed_files` integer — 失败的文件数
  - `imported_files` integer — 已导入文件数
  - `local_song_count` integer — 扫描完成后数据库中本地歌曲总数
  - `scanned_files` integer — 已扫描文件数
  - `skipped_files` integer — 跳过的文件数（已存在）
  - `start_time` string — 开始时间
  - `status` 'idle' | 'scanning' | 'importing' | 'splitting_cue' | 'creating_playlists' | 'completed' | 'failed' | 'cancelling' | 'cancelled'
  - `total_files` integer — 总文件数

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/ee41778dbf8f/schema)