feat: 添加文件上传进度跟踪功能，支持实时显示上传速度和剩余时间

README.md

@@ -0,0 +1,149 @@
+# UPFS - Upload File to Server
+
+一个用于向UPFS服务器上传文件的Rust命令行工具，现在支持实时进度跟踪和上传速度显示。
+
+## 功能特性
+
+- ✅ 文件上传到远程服务器
+- ✅ 用户认证（用户名/密码）
+- ✅ **新增**: 实时上传进度跟踪
+- ✅ **新增**: 上传速度计算和显示
+- ✅ **新增**: 剩余时间估算
+- ✅ **新增**: 可视化进度条
+- ✅ **新增**: 灵活的进度回调API
+
+## 安装
+
+```bash
+git clone <repository-url>
+cd upfs
+cargo build --release
+```
+
+## 使用方法
+
+### 基本用法
+
+```bash
+./upfs -f <文件路径> -r <远程路径> -u <用户名> -p <密码>
+```
+
+### 示例
+
+```bash
+# 上传文件（默认显示进度）
+./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 使用
+
+### 基本上传
+
+```rust
+use upfs::update::upload_file;
+
+// 直接上传，不显示进度
+let result = upload_file(token, "file.txt", "/remote/path.txt").await?;
+```
+
+### 带进度回调的上传
+
+```rust
+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 结构体
+
+```rust
+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` 获取完整的使用示例：
+
+```bash
+cargo run --example progress_demo
+```
+
+## 开发和构建
+
+```bash
+# 检查代码
+cargo check
+
+# 运行测试
+cargo test
+
+# 构建发布版本
+cargo build --release
+
+# 运行示例
+cargo run --example progress_demo
+```
+
+## 技术细节
+
+- 使用 `reqwest` 进行HTTP请求
+- 使用 `multipart/form-data` 上传文件
+- 使用异步I/O和流式处理实现进度跟踪
+- 支持大文件上传（分块读取）
+- 实时计算上传速度和剩余时间
+
+## 贡献
+
+欢迎提交Issue和Pull Request来改进这个项目！