146 lines
4.6 KiB
Rust
146 lines
4.6 KiB
Rust
//! df-relay 广播消息骨架
|
|
//!
|
|
//! 设计依据:设计文档「Layer2」—— 云后端纯转发,无业务逻辑。
|
|
//! 中继消息骨架定义「谁发给谁」的路由语义:
|
|
//! - `Event`:桌面端事件 → 广播给该 device 绑定的小程序
|
|
//! - `Command`:小程序指令 → 转发给该 device 绑定的桌面端
|
|
//! - `Control`:控制面消息(配对/心跳/在线状态)
|
|
//!
|
|
//! 与 df-tunnel::TunnelMessage 区分:
|
|
//! - TunnelMessage 是隧道两端(桌面↔云)的传输单元
|
|
//! - BroadcastMessage 是云后端内部的路由单元(标识来源/去向/广播范围)
|
|
//!
|
|
//! AiChatEvent JSON 透传:relay 不解析 AiChatEvent(类型在 src-tauri/df-types,
|
|
//! relay 不依赖避跨 crate 强耦合),payload 用 serde_json::Value 透传。
|
|
|
|
use serde::{Deserialize, Serialize};
|
|
|
|
use crate::conn::ConnId;
|
|
|
|
/// 客户端类型(用于路由判断)
|
|
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Hash)]
|
|
#[serde(rename_all = "snake_case")]
|
|
pub enum ClientKind {
|
|
/// 桌面端(出站长连接,事件真相源)
|
|
Device,
|
|
/// 小程序(远程操作发起方)
|
|
Miniapp,
|
|
}
|
|
|
|
/// 中继路由消息语义分类
|
|
///
|
|
/// - `Event`:桌面端 → 小程序(渲染事件,AiChatEvent 透传)
|
|
/// - `Command`:小程序 → 桌面端(操作指令,触发 Tauri command)
|
|
/// - `Control`:控制面(配对/心跳/Ping-Pong,不进业务流)
|
|
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Hash)]
|
|
#[serde(rename_all = "snake_case")]
|
|
pub enum MessageKind {
|
|
Event,
|
|
Command,
|
|
Control,
|
|
}
|
|
|
|
/// 中继路由消息骨架(云后端内部的路由单元)
|
|
///
|
|
/// 每条消息携带 `device_id`(配对绑定键),云后端按 device_id
|
|
/// 找到绑定的对端连接进行转发/广播。payload 为原始 JSON,转发时不解析业务字段,
|
|
/// 保持轻量。
|
|
#[derive(Debug, Clone, Serialize, Deserialize)]
|
|
pub struct BroadcastMessage {
|
|
/// 配对绑定的设备 ID(桌面端首次配置时生成)
|
|
pub device_id: String,
|
|
/// 消息语义(Event / Command / Control)
|
|
pub kind: MessageKind,
|
|
/// 消息来源连接(用于鉴权校验:device 不能发 Command)
|
|
pub source: ConnId,
|
|
/// 来源客户端类型
|
|
pub from: ClientKind,
|
|
/// 消息载荷(原始 JSON,透传不解析)
|
|
pub payload: serde_json::Value,
|
|
/// 时间戳(毫秒,用于冲突判断 —— 桌面端为真相源,但保留时间戳辅助)
|
|
pub ts: i64,
|
|
}
|
|
|
|
impl BroadcastMessage {
|
|
/// 便捷构造:device 发出的事件
|
|
pub fn from_device(
|
|
device_id: impl Into<String>,
|
|
source: ConnId,
|
|
payload: serde_json::Value,
|
|
ts: i64,
|
|
) -> Self {
|
|
Self {
|
|
device_id: device_id.into(),
|
|
kind: MessageKind::Event,
|
|
source,
|
|
from: ClientKind::Device,
|
|
payload,
|
|
ts,
|
|
}
|
|
}
|
|
|
|
/// 便捷构造:小程序发出的指令
|
|
pub fn from_miniapp(
|
|
device_id: impl Into<String>,
|
|
source: ConnId,
|
|
payload: serde_json::Value,
|
|
ts: i64,
|
|
) -> Self {
|
|
Self {
|
|
device_id: device_id.into(),
|
|
kind: MessageKind::Command,
|
|
source,
|
|
from: ClientKind::Miniapp,
|
|
payload,
|
|
ts,
|
|
}
|
|
}
|
|
|
|
/// 便捷构造:控制面消息
|
|
pub fn control(
|
|
device_id: impl Into<String>,
|
|
source: ConnId,
|
|
from: ClientKind,
|
|
payload: serde_json::Value,
|
|
ts: i64,
|
|
) -> Self {
|
|
Self {
|
|
device_id: device_id.into(),
|
|
kind: MessageKind::Control,
|
|
source,
|
|
from,
|
|
payload,
|
|
ts,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// 客户端在线状态(用于离线降级提示)
|
|
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
|
|
#[serde(rename_all = "snake_case")]
|
|
pub enum PresenceState {
|
|
/// 在线
|
|
Online,
|
|
/// 离线(对端可缓存指令待重连)
|
|
Offline,
|
|
}
|
|
|
|
/// 控制面消息(配对绑定 / 心跳 / 在线状态广播)
|
|
///
|
|
/// 仅作为 payload 的语义约定,relay 对 Control 消息同样透传;部分控制语义
|
|
/// (如 Ping/Pong 心跳)由 WS 连接层直接处理,不进 BroadcastMessage 流。
|
|
#[derive(Debug, Clone, Serialize, Deserialize)]
|
|
#[serde(tag = "control_kind", rename_all = "snake_case")]
|
|
pub enum ControlMessage {
|
|
/// 配对绑定请求(小程序持 token 申请绑定 device_id)
|
|
Pair { device_id: String, token: String },
|
|
/// 心跳(保活 + 在线确认)
|
|
Heartbeat { device_id: String },
|
|
/// 在线状态变更通知
|
|
Presence { device_id: String, state: PresenceState },
|
|
/// 心跳 Ping(WS 应用层心跳,与协议层 Ping 区分)
|
|
Ping,
|
|
/// 心跳 Pong
|
|
Pong,
|
|
}
|