新增: 跨端WS隧道脚手架(df-tunnel客户端+df-relay云中继)
df-tunnel:桌面端出站WS客户端(TunnelClient trait+骨架,穿NAT连云后端) df-relay:axum WS中继服务(转发小程序↔桌面端,广播骨架) 双crate独立消息骨架,不依赖src-tauri/df-types避跨crate强耦合 workspace crates/* glob自动注册,Phase2填充WS握手/鉴权/重连/路由
This commit is contained in:
37
crates/df-relay/src/error.rs
Normal file
37
crates/df-relay/src/error.rs
Normal file
@@ -0,0 +1,37 @@
|
||||
//! df-relay 错误类型
|
||||
//!
|
||||
//! 设计:单一 RelayError 覆盖服务启动/客户端管理/广播/WS 协议四类失败,
|
||||
//! thiserror 派生保留错误链。脚手架阶段仅定义类型。
|
||||
|
||||
use thiserror::Error;
|
||||
|
||||
/// 中继服务运行期错误
|
||||
#[derive(Debug, Error)]
|
||||
pub enum RelayError {
|
||||
/// 服务启动失败(端口占用 / 绑定失败)
|
||||
#[error("中继服务启动失败: {0}")]
|
||||
Start(String),
|
||||
|
||||
/// 客户端管理错误(配对失败 / 重复连接 / 鉴权拒绝)
|
||||
#[error("客户端管理错误: {0}")]
|
||||
Client(String),
|
||||
|
||||
/// 广播失败(无可用连接 / 发送失败)
|
||||
#[error("广播失败: {0}")]
|
||||
Broadcast(String),
|
||||
|
||||
/// WS 协议层错误(底层 tungstenite)
|
||||
#[error("WS 协议错误: {0}")]
|
||||
WebSocket(String),
|
||||
|
||||
/// 序列化/反序列化失败
|
||||
#[error("消息序列化失败: {0}")]
|
||||
Serde(#[from] serde_json::Error),
|
||||
|
||||
/// 其他未归类错误(降级通道)
|
||||
#[error("中继内部错误: {0}")]
|
||||
Other(#[from] anyhow::Error),
|
||||
}
|
||||
|
||||
/// 模块级 Result 别名
|
||||
pub type Result<T> = std::result::Result<T, RelayError>;
|
||||
Reference in New Issue
Block a user