diff --git a/desktop/src/main.rs b/desktop/src/main.rs index b58643f..71eba7c 100644 --- a/desktop/src/main.rs +++ b/desktop/src/main.rs @@ -604,6 +604,15 @@ impl QftApp { ui.vertical_centered(|ui| { let side = snap_to_physical(side, ui.ctx().pixels_per_point()); ui.image((texture.id(), egui::vec2(side, side))); }); } + // 把二维码实际广播的地址摊开显示。手机报"找不到电脑"时, + // 第一件要确认的就是码里到底有没有它能到达的那个地址—— + // 在这里一眼可见,不必等手机端的诊断。 + ui.collapsing("二维码广播的地址", |ui| { + for endpoint in pairing::qr_endpoints(listen_port, self.receive.direct_ap.is_some()).iter().take(4) { + ui.monospace(endpoint); + } + ui.small("手机连上后会依次尝试这些地址;其中必须有一个与手机同网段。"); + }); if let Some(ap) = &self.receive.direct_ap { ui.label(format!("临时网络:{}", ap.ssid)); ui.small("网络身份会在这台电脑上复用以减少重复确认;每次接收仍会生成新的会话 Token。"); @@ -1014,7 +1023,7 @@ impl QftApp { pc_name: self.local_device.clone(), transport: "http-parallel-v2".into(), port: server.port, - endpoints: pairing::local_ipv4_endpoints(server.port), + endpoints: pairing::qr_endpoints(server.port, self.receive.direct_ap.is_some()), wifi, direction: PairingDirection::Upload, file_name: None, @@ -1094,7 +1103,7 @@ impl QftApp { pc_name: self.local_device.clone(), transport: "http-download-v2".into(), port: server.port, - endpoints: pairing::local_ipv4_endpoints(server.port), + endpoints: pairing::qr_endpoints(server.port, self.send.direct_ap.is_some()), wifi, direction: PairingDirection::Download, file_name: Some(file_name), diff --git a/desktop/src/pairing.rs b/desktop/src/pairing.rs index adffd6f..0a2276e 100644 --- a/desktop/src/pairing.rs +++ b/desktop/src/pairing.rs @@ -61,10 +61,12 @@ impl PairingPayload { // 现在无论是否开 Direct AP,都把常规局域网地址一并带上, // 手机可以先在当前网络直连,连不上再切 AP。多两个短地址对 // 二维码密度的影响可以忽略。 + // 取 4 个:Direct AP 场景要同时容纳 AP 网关地址与常规局域网地址, + // 只取 3 个时前者会被挤掉——手机于是连上了 AP 却找不到电脑。 let endpoints: Vec<&str> = self .endpoints .iter() - .take(3) + .take(4) .map(String::as_str) .collect(); let wifi = self.wifi.as_ref().map(|w| json!([w.ssid, w.passphrase])); @@ -203,6 +205,27 @@ pub fn local_ipv4_addresses() -> Vec { ips } +/// 供二维码使用的端点列表。 +/// +/// `direct_ap_active` 为真时,把 ICS/Wi-Fi Direct 的固定网关地址放在最前。 +/// 这一步不能省:二维码是在启动接收的瞬间生成的,而那块虚拟网卡往往 +/// **还没拿到 IP**,因此它不会出现在 get_if_addrs 的结果里。可手机连上 +/// AP 之后,网关恰恰就是这个地址——漏掉它,手机就会连上了 Wi-Fi 却 +/// 找不到电脑。 +pub fn qr_endpoints(port: u16, direct_ap_active: bool) -> Vec { + let mut endpoints = local_ipv4_endpoints(port); + if direct_ap_active { + for ap in [ + format!("http://192.168.137.1:{port}"), + format!("http://192.168.49.1:{port}"), + ].into_iter().rev() { + endpoints.retain(|e| *e != ap); + endpoints.insert(0, ap); + } + } + endpoints +} + pub fn local_ipv4_endpoints(port: u16) -> Vec { let mut ips = Vec::::new(); if let Ok(addrs) = if_addrs::get_if_addrs() { @@ -327,3 +350,70 @@ mod endpoint_order_tests { assert!(json.contains("192.168.137.1"), "Direct AP 地址也应保留:{json}"); } } + +#[cfg(test)] +mod qr_endpoint_tests { + use super::*; + + /// Direct AP 的网关地址必须出现在二维码里,且排在最前。 + /// + /// 这是一个真实发生过的回退:把"猜测性兜底地址"挪到列表末尾后, + /// 二维码只取前 3 个,192.168.137.1 被挤了出去。手机连上了 AP、 + /// 拿到了 192.168.137.200/24,却在二维码里找不到 192.168.137.1, + /// 表现为"Wi-Fi 已连接但找不到电脑"——从现象几乎无法反推到这里。 + #[test] + fn direct_ap_gateway_is_always_advertised_first() { + let endpoints = qr_endpoints(39393, true); + assert_eq!( + endpoints.first().map(String::as_str), + Some("http://192.168.137.1:39393"), + "Direct AP 网关必须排第一:{endpoints:?}" + ); + assert!( + endpoints.iter().any(|e| e == "http://192.168.49.1:39393"), + "Wi-Fi Direct 的另一个常用网段也应保留:{endpoints:?}" + ); + } + + #[test] + fn direct_ap_addresses_survive_the_qr_length_cap() { + // 即使本机有很多张网卡,AP 地址也不能被截断掉 + let payload = PairingPayload { + v: 2, + session: "abcdefghijklmnopqrstuvwxyz012345".into(), + pc_name: "PC".into(), + transport: "http-parallel-v2".into(), + port: 39393, + endpoints: qr_endpoints(39393, true), + wifi: Some(WifiCredentials { + ssid: "QFT-PC-abc".into(), + passphrase: "0123456789ab".into(), + security: "WPA2".into(), + }), + direction: PairingDirection::Upload, + file_name: None, + file_size: None, + sha256: None, + }; + let text = payload.encode_text().unwrap(); + let json = String::from_utf8( + base64::engine::general_purpose::URL_SAFE_NO_PAD + .decode(text.trim_start_matches(PAIR_PREFIX)) + .unwrap(), + ).unwrap(); + assert!(json.contains("192.168.137.1"), "AP 网关必须进二维码:{json}"); + } + + #[test] + fn without_direct_ap_the_guessed_addresses_stay_at_the_back() { + let endpoints = qr_endpoints(39393, false); + // 没开 AP 时不该把两个猜测地址顶到前面去占位 + if endpoints.len() > 2 { + assert_ne!( + endpoints.first().map(String::as_str), + Some("http://192.168.137.1:39393"), + "未开 Direct AP 时不应优先猜测地址:{endpoints:?}" + ); + } + } +}