upfs/README.md

UPFS - Upload File to Server

一个用于向UPFS服务器上传文件的Rust命令行工具，现在支持实时进度跟踪和上传速度显示。

功能特性

• ✅ 文件上传到远程服务器
• ✅ 用户认证（用户名/密码）
• ✅ 新增: 实时上传进度跟踪
• ✅ 新增: 上传速度计算和显示
• ✅ 新增: 剩余时间估算
• ✅ 新增: 可视化进度条
• ✅ 新增: 灵活的进度回调API

安装

git clone <repository-url>
cd upfs
cargo build --release

使用方法

基本用法

./upfs -f <文件路径> -r <远程路径> -u <用户名> -p <密码>

示例

# 上传文件（默认显示进度）
./upfs -f ./large_file.zip -r /backup/large_file.zip -u admin -p mypassword

# 上传文件（不带密码参数，会交互式输入）
./upfs -f ./document.pdf -r /documents/doc.pdf -u admin

进度显示格式

默认情况下，所有上传都会显示实时的上传进度：

[=========>           ] 45.2% | 2.3 MB/s | 12s | 预计剩余 14s | 4.5 MB/10.0 MB

进度条包含以下信息：

• 进度条: 可视化显示上传进度
• 百分比: 当前的完成百分比
• 速度: 当前上传速度（B/s, KB/s, MB/s, GB/s）
• 已用时间: 从开始上传到现在的时间
• 剩余时间: 预计完成上传还需要的时间
• 已上传/总大小: 已上传的数据量和总文件大小

API 使用

基本上传

use upfs::update::upload_file;

// 直接上传，不显示进度
let result = upload_file(token, "file.txt", "/remote/path.txt").await?;

带进度回调的上传

use upfs::update::{upload_file_with_progress, UploadProgress};

// 带进度跟踪的上传
let result = upload_file_with_progress(
    token,
    "large_file.zip",
    "/remote/large_file.zip",
    |progress| {
        println!("进度: {:.1}%", progress.percentage);
        println!("速度: {}", progress.format_speed());
        println!("剩余时间: {}", progress.format_remaining_time());
    }
).await?;

UploadProgress 结构体

pub struct UploadProgress {
    pub bytes_uploaded: u64,    // 已上传字节数
    pub total_bytes: u64,       // 总字节数
    pub percentage: f64,        // 完成百分比 (0.0-100.0)
    pub speed_bps: f64,         // 上传速度（字节/秒）
    pub elapsed_time: Duration, // 已用时间
}

UploadProgress 方法

• format_speed(): 格式化速度显示（如 "2.3 MB/s"）
• format_bytes(): 格式化字节大小（如 "10.5 MB"）
• format_elapsed_time(): 格式化已用时间（如 "2m 15s"）
• format_remaining_time(): 格式化剩余时间（如 "预计剩余 1m 30s"）
• estimate_remaining_time(): 估算剩余时间

命令行参数

参数	简写	长参数	描述	默认值
文件路径	-f	--file	要上传的文件路径	必需
远程路径	-r	--remote-path	服务器上的远程路径	必需
用户名	-u	--username	认证用户名	"admin"
密码	-p	--password	认证密码	可选（交互式输入）

示例程序

查看 examples/progress_demo.rs 获取完整的使用示例：

cargo run --example progress_demo

开发和构建

# 检查代码
cargo check

# 运行测试
cargo test

# 构建发布版本
cargo build --release

# 运行示例
cargo run --example progress_demo

技术细节

• 使用 reqwest 进行HTTP请求
• 使用 multipart/form-data 上传文件
• 使用异步I/O和流式处理实现进度跟踪
• 支持大文件上传（分块读取）
• 实时计算上传速度和剩余时间

贡献

欢迎提交Issue和Pull Request来改进这个项目！