mvsep-rs

MVSep 音乐分离工具的 Rust 后端实现，提供算法缓存、任务管理、流式上传下载、断点续传等核心能力。

功能特性

• 三数据库架构：算法缓存、任务追踪、用户配置独立管理
• 流式上传：基于 tokio 的异步文件上传，支持进度回调和取消
• 断点续传：基于 Range 请求和 .part 文件的下载恢复机制
• 任务持久化：完整的任务生命周期管理和历史记录
• 代理支持：手动代理、系统代理、无代理三种模式

安装

核心库

cargo add mvsep-api-tester

CLI 工具

cd test-api
cargo run --release

Tauri 桌面应用

npm install
npm run tauri dev

快速开始

数据库操作

use mvsep_api_tester::db;

// 打开主数据库（算法缓存）
let db = db::Database::new(None)?;

// 读取所有算法
let algorithms = db.with_conn(|conn| {
    db::repositories::get_all_algorithms(conn)
})?;

// 打开任务数据库
let tasks_db = db::tasks_db::TasksDatabase::new(None)?;

// 读取用户配置
let config_db = db::user_config::UserConfigDB::default()?;
let token = config_db.get_string("api_token")?;

文件上传

use mvsep_api_tester::file_transfer::{self, TransferProgress};

let client = reqwest::Client::new();
let hash = file_transfer::upload_file_async(
    &client,
    "https://api.mvsep.com/upload",
    std::path::Path::new("./song.mp3"),
    vec![("api_token", "your-token".to_string())],
    None,
    |progress: TransferProgress| {
        println!("上传: {:.1}%", progress.percent);
    },
).await?;

文件下载

use mvsep_api_tester::file_transfer::{self, TransferProgress};

let client = reqwest::Client::new();
file_transfer::download_file_async(
    &client,
    "https://api.mvsep.com/download/file.wav",
    std::path::Path::new("./output/vocals.wav"),
    "remote_file_name.wav",
    None,
    |progress: TransferProgress| {
        println!("下载: {:.1}%", progress.percent);
    },
).await?;

项目结构

mvsep-rs/
├── src/                      # TypeScript + Vite 前端
├── src-tauri/                # Tauri 桌面后端
│   └── src/lib.rs            # AppBackend facade
├── test-api/                 # Rust 核心库 (crates.io: mvsep-api-tester)
│   ├── src/lib.rs            # Crate 入口和公共 API
│   ├── src/db/               # 数据库层
│   │   ├── mod.rs            # 主数据库（算法缓存）
│   │   ├── tasks_db.rs       # 任务数据库
│   │   ├── user_config.rs    # 用户配置存储
│   │   └── repositories.rs   # 数据访问层
│   ├── src/file_transfer.rs  # 文件传输（上传/下载）
│   └── src/utils/            # 工具函数
├── docs/                     # 架构文档和 ADR
└── manifest/                 # 迁移批次状态

API 参考

详细文档请访问 docs.rs。

数据库模块

• db::Database - 主数据库连接（算法缓存）
• db::tasks_db::TasksDatabase - 任务数据库
• db::user_config::UserConfigDB - 用户配置存储

文件传输模块

• file_transfer::upload_file_async - 异步文件上传
• file_transfer::download_file_async - 异步文件下载（支持断点续传）
• file_transfer::TransferProgress - 传输进度信息

许可证

Apache License 2.0