Enum TransferEvent 

pub enum TransferEvent {
    Started {
        role: Role,
    },
    Progress {
        role: Role,
        processed: u64,
        total: u64,
        speed: f64,
    },
    Completed {
        role: Role,
    },
    Failed {
        role: Role,
        message: String,
    },
    FileNames {
        role: Role,
        file_names: Vec<String>,
    },
}

传输过程中对外发送的统一事件模型。

该枚举用于描述一次传输在某个角色（发送端 / 接收端）下的 生命周期状态变化。

⚠️ 注意：

• 这是通知型事件，不参与错误控制流
• 不用于 Result / anyhow
• payload 直接体现在枚举字段中

Variants

Started

传输开始

Fields

role: Role

Progress

传输进度更新

Fields

role: Role

processed: u64

已处理字节数

total: u64

总字节数

speed: f64

当前速度（字节 / 秒）

Completed

传输完成

Fields

role: Role

Failed

传输失败

Fields

role: Role

message: String

用于展示的错误信息

FileNames

特殊事件：文件名列表

Fields

role: Role

file_names: Vec<String>

Implementations

impl TransferEvent

pub const fn state(&self) -> &'static str

返回事件状态字符串（started / progress / completed / failed）

pub const fn role(&self) -> Role

返回事件所属角色

pub fn event_name(&self) -> String

返回发送给 Tauri 前端的最终事件名

事件格式： transfer:<role>:<state>

示例：

• transfer:sender:started
• transfer:receiver:progress

Trait Implementations

impl Clone for TransferEvent

fn clone(&self) -> TransferEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TransferEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.