feat(desktop): 跨平台桌面端 + 电脑↔电脑互传(v0.5.0-m1)
对应 V05_EXECUTION_PLAN 的 P1。核心改动是把「PC 只能当服务端」 这个写死的角色拆开——此前 TcpStream::connect 只出现在测试里, 桌面端根本无法主动连接另一台桌面端,PC↔PC 因此完全不可用。 跨平台 - windows/ → desktop/,crate 更名 qft-desktop - 新增 platform.rs 收敛全部平台差异:配置目录(LOCALAPPDATA / Application Support / XDG)、下载目录(含 Linux 本地化的 ~/下载)、 设备名、Direct AP 能力。约定:其余模块不得再出现 #[cfg(target_os)] - direct_ap.rs 的 Context 导入按平台条件化,非 Windows 上不再告警 - macOS 上已实测编译并链接出可执行文件(65 MB Mach-O arm64), 这是本仓库首次在非 Windows 平台构建成功 电脑 ↔ 电脑 - 新增 client.rs:桌面端发起侧。手写 HTTP,不引入客户端依赖—— 服务端本来就是手写的,两边同一套解析更容易与 Android/iOS 对齐。 含并发分块上传(自适应 4/8/16 MiB、最多 8 worker)与 Range 断点续传 - 新增 discovery.rs:UDP 广播 QFTBROWSE3 浏览局域网节点。 既有的 QFTDISC2 是「已知令牌找机器」,用于扫码之后; PC 没有摄像头,必须先能列出附近有谁 - receiver.rs 新增 POST /qft/pair:用 6 位配对码换会话令牌。 这是唯一不校验令牌的端点。6 位仅约 20 bit 熵,配严格失败计数兜底—— 错 5 次即作废,需重启接收;比较用定长实现,不做短路返回 - 新增「电脑 ↔ 电脑」界面:接收方显示配对码与本机地址; 发送方搜索/手动输入地址 → 输码连接 → 多选文件 → 带进度发送 验证(macOS,Rust 1.97.1) - cargo check 0 错误,cargo test 17/17 通过 - 新增端到端用例:真实起接收服务 → 配对(含错误码必须被拒)→ 9 MB 跨多分块并发上传 → 校验落盘内容逐字节一致且 SHA-256 与 接收端返回值相同。这就是 PC↔PC 的完整链路 - 11 项 Python 自检全部通过 顺带修复 - single_channel_guard_selftest 长期为红:它断言 DEFAULT_CHUNK_SIZE = 450,而代码早已改为 320。改名前即存在, 已用 git stash 验证与本次无关。改为范围检查(128~4096)并在 PASS 信息里打印实际值,既挡住"退回多通道小块"又不会因调参误报 已知限制 - UDP 广播只覆盖同一广播域。跨网段或 AP 隔离的 Wi-Fi 上搜索不到, 需手动输入对方 IP(界面已说明)。mDNS 留待后续 - 本阶段仍走 v2 明文 HTTP,加密随 QFT-Stream v3 一起做(见 P2)
This commit is contained in:
@@ -0,0 +1,238 @@
|
||||
//! 平台差异的唯一收敛点。
|
||||
//!
|
||||
//! 约定:除本文件与 `direct_ap.rs` 外,其余模块不得出现 `#[cfg(target_os = ...)]`。
|
||||
//! 新增平台差异时先在这里补一个函数,不要就地 cfg —— 否则跨平台移植会重新变成
|
||||
//! 满仓库找 cfg 的考古工作。
|
||||
|
||||
use std::path::{Path, PathBuf};
|
||||
|
||||
/// QFT 的持久化配置目录(Direct AP 身份、信任库等)。
|
||||
///
|
||||
/// - Windows: `%LOCALAPPDATA%\QFT`
|
||||
/// - macOS: `~/Library/Application Support/QFT`
|
||||
/// - Linux: `$XDG_CONFIG_HOME/qft`,未设置时 `~/.config/qft`
|
||||
pub fn config_dir() -> PathBuf {
|
||||
#[cfg(target_os = "windows")]
|
||||
{
|
||||
if let Some(root) = non_empty_env("LOCALAPPDATA") {
|
||||
return PathBuf::from(root).join("QFT");
|
||||
}
|
||||
}
|
||||
#[cfg(target_os = "macos")]
|
||||
{
|
||||
if let Some(home) = home_dir() {
|
||||
return home.join("Library").join("Application Support").join("QFT");
|
||||
}
|
||||
}
|
||||
#[cfg(all(unix, not(target_os = "macos")))]
|
||||
{
|
||||
if let Some(root) = non_empty_env("XDG_CONFIG_HOME") {
|
||||
return PathBuf::from(root).join("qft");
|
||||
}
|
||||
if let Some(home) = home_dir() {
|
||||
return home.join(".config").join("qft");
|
||||
}
|
||||
}
|
||||
// 环境变量全都拿不到时退回当前目录下的隐藏目录,保证功能不中断
|
||||
PathBuf::from(".qft")
|
||||
}
|
||||
|
||||
/// 接收文件的默认保存目录。
|
||||
pub fn default_download_dir() -> PathBuf {
|
||||
#[cfg(all(unix, not(target_os = "macos")))]
|
||||
{
|
||||
// Linux 桌面环境会把"下载"本地化(中文系统是 ~/下载),
|
||||
// 目录名记录在 user-dirs.dirs 里,直接拼 "Downloads" 会建出一个用户看不见的目录。
|
||||
if let Some(dir) = xdg_user_dir("XDG_DOWNLOAD_DIR") {
|
||||
return dir;
|
||||
}
|
||||
}
|
||||
if let Some(home) = home_dir() {
|
||||
let downloads = home.join("Downloads");
|
||||
if downloads.is_dir() {
|
||||
return downloads;
|
||||
}
|
||||
return home;
|
||||
}
|
||||
PathBuf::from(".")
|
||||
}
|
||||
|
||||
/// 展示给对端的本机名称。
|
||||
pub fn device_name() -> String {
|
||||
let raw = whoami::fallible::hostname().unwrap_or_else(|_| whoami::devicename());
|
||||
sanitize_device_name(&raw)
|
||||
}
|
||||
|
||||
/// 设备名会进入配对二维码与 mDNS TXT,必须去掉控制字符并限长。
|
||||
pub fn sanitize_device_name(raw: &str) -> String {
|
||||
let cleaned: String = raw
|
||||
.chars()
|
||||
.filter(|ch| !ch.is_control())
|
||||
.take(64)
|
||||
.collect();
|
||||
let trimmed = cleaned.trim();
|
||||
if trimmed.is_empty() {
|
||||
default_device_name().to_owned()
|
||||
} else {
|
||||
trimmed.to_owned()
|
||||
}
|
||||
}
|
||||
|
||||
const fn default_device_name() -> &'static str {
|
||||
#[cfg(target_os = "windows")]
|
||||
{
|
||||
"Windows-PC"
|
||||
}
|
||||
#[cfg(target_os = "macos")]
|
||||
{
|
||||
"Mac"
|
||||
}
|
||||
#[cfg(all(unix, not(target_os = "macos")))]
|
||||
{
|
||||
"Linux-PC"
|
||||
}
|
||||
}
|
||||
|
||||
/// 本机所属平台,用于 mDNS TXT 与 UI 图标。
|
||||
pub const fn platform_tag() -> &'static str {
|
||||
#[cfg(target_os = "windows")]
|
||||
{
|
||||
"windows"
|
||||
}
|
||||
#[cfg(target_os = "macos")]
|
||||
{
|
||||
"macos"
|
||||
}
|
||||
#[cfg(all(unix, not(target_os = "macos")))]
|
||||
{
|
||||
"linux"
|
||||
}
|
||||
}
|
||||
|
||||
/// 本机能否开启 QFT Direct 临时热点。
|
||||
///
|
||||
/// 只有 Windows 走 WiFi Direct;macOS 无公开 API,Linux 各发行版
|
||||
/// NetworkManager 行为差异过大,都不做——UI 据此隐藏入口,
|
||||
/// 而不是让用户点进去再失败。
|
||||
pub enum DirectApSupport {
|
||||
Supported,
|
||||
Unsupported(&'static str),
|
||||
}
|
||||
|
||||
pub const fn direct_ap_support() -> DirectApSupport {
|
||||
#[cfg(target_os = "windows")]
|
||||
{
|
||||
DirectApSupport::Supported
|
||||
}
|
||||
#[cfg(not(target_os = "windows"))]
|
||||
{
|
||||
DirectApSupport::Unsupported("本平台不支持 QFT Direct 热点,请让两台设备连接同一个 Wi-Fi")
|
||||
}
|
||||
}
|
||||
|
||||
impl DirectApSupport {
|
||||
pub const fn is_supported(&self) -> bool {
|
||||
matches!(self, DirectApSupport::Supported)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 内部工具
|
||||
|
||||
fn non_empty_env(key: &str) -> Option<String> {
|
||||
std::env::var(key).ok().filter(|v| !v.trim().is_empty())
|
||||
}
|
||||
|
||||
fn home_dir() -> Option<PathBuf> {
|
||||
#[cfg(target_os = "windows")]
|
||||
{
|
||||
if let Some(profile) = non_empty_env("USERPROFILE") {
|
||||
return Some(PathBuf::from(profile));
|
||||
}
|
||||
let drive = non_empty_env("HOMEDRIVE")?;
|
||||
let path = non_empty_env("HOMEPATH")?;
|
||||
return Some(PathBuf::from(format!("{drive}{path}")));
|
||||
}
|
||||
#[cfg(unix)]
|
||||
{
|
||||
non_empty_env("HOME").map(PathBuf::from)
|
||||
}
|
||||
}
|
||||
|
||||
/// 解析 `~/.config/user-dirs.dirs` 里形如
|
||||
/// `XDG_DOWNLOAD_DIR="$HOME/下载"` 的一行。
|
||||
#[cfg(all(unix, not(target_os = "macos")))]
|
||||
fn xdg_user_dir(key: &str) -> Option<PathBuf> {
|
||||
let home = home_dir()?;
|
||||
let config = non_empty_env("XDG_CONFIG_HOME")
|
||||
.map(PathBuf::from)
|
||||
.unwrap_or_else(|| home.join(".config"));
|
||||
let text = std::fs::read_to_string(config.join("user-dirs.dirs")).ok()?;
|
||||
for line in text.lines() {
|
||||
let line = line.trim();
|
||||
if line.starts_with('#') {
|
||||
continue;
|
||||
}
|
||||
let (name, value) = line.split_once('=')?;
|
||||
if name.trim() != key {
|
||||
continue;
|
||||
}
|
||||
let value = value.trim().trim_matches('"');
|
||||
let expanded = if let Some(rest) = value.strip_prefix("$HOME/") {
|
||||
home.join(rest)
|
||||
} else if value == "$HOME" {
|
||||
home.clone()
|
||||
} else {
|
||||
PathBuf::from(value)
|
||||
};
|
||||
if expanded.is_dir() {
|
||||
return Some(expanded);
|
||||
}
|
||||
}
|
||||
None
|
||||
}
|
||||
|
||||
/// 确保目录存在,返回其路径。调用方负责处理失败。
|
||||
pub fn ensure_dir(path: &Path) -> std::io::Result<()> {
|
||||
if path.is_dir() {
|
||||
return Ok(());
|
||||
}
|
||||
std::fs::create_dir_all(path)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn config_dir_is_absolute_or_local_fallback() {
|
||||
let dir = config_dir();
|
||||
// 要么是绝对路径(拿到了环境变量),要么是约定的本地兜底
|
||||
assert!(dir.is_absolute() || dir == PathBuf::from(".qft"), "{dir:?}");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn device_name_is_never_empty_and_bounded() {
|
||||
let name = device_name();
|
||||
assert!(!name.is_empty());
|
||||
assert!(name.chars().count() <= 64);
|
||||
assert!(!name.chars().any(char::is_control));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn sanitize_strips_control_chars_and_falls_back() {
|
||||
assert_eq!(sanitize_device_name(" ok-name \n"), "ok-name");
|
||||
assert_eq!(sanitize_device_name("a\u{0}b"), "ab");
|
||||
assert_eq!(sanitize_device_name(" "), default_device_name());
|
||||
assert_eq!(sanitize_device_name("\n\t"), default_device_name());
|
||||
assert_eq!(sanitize_device_name(&"x".repeat(200)).chars().count(), 64);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn platform_tag_matches_direct_ap_capability() {
|
||||
// Direct AP 目前只有 Windows 支持,两个常量必须保持一致
|
||||
assert_eq!(
|
||||
direct_ap_support().is_supported(),
|
||||
platform_tag() == "windows"
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user