fix(desktop): 连接失败给出可执行的排查方向,并分离配对与传输状态
实测中出现「连接码解析正确但连不上」。诊断结果不是代码问题:两台机器 同在 192.168.8.0/24,ARP 能解析对方 MAC(二层通),但 ICMP 100% 丢包、 TCP 39393 连接超时——典型的对端主机丢包,即 Windows 防火墙拦截入站。 顺带暴露的连带影响:二进制从 qft-windows.exe 改名为 qft-desktop.exe 后, 此前给旧名字放行的防火墙规则对新程序不生效,用户不会想到这一层。 README 已补充放行步骤与排查顺序。 代码侧的三个真实缺陷 1. 连接失败只说「失败」,等于什么都没说。现按 io::ErrorKind 分类: - TimedOut → 包发出去没回应:防火墙 / AP 客户端隔离 / 对方已关闭 - ConnectionRefused → 主机在线但端口没人监听:对方没点「启动接收」 - Host/NetworkUnreachable → 本机没有到该地址的路由 三者成因完全不同,给的建议也必须不同。 2. 配对超时从 10 秒缩到 4 秒。配对只是一次极小的请求,拖到 10 秒 只会让用户以为程序卡死。 3. 配对阶段就显示「正在发送 0%」。此前用 busy 兼作「正在传输」, 导致刚点连接就出现发送进度条。新增独立的 transferring 标志, 进度块只在真正推送文件时出现;配对期间改为显示 spinner 与 「正在建立连接…最多等 4 秒」。 验证:cargo test 32/32。新增两项针对错误分类的用例—— 用 RFC 5737 文档网段 192.0.2.1 触发超时路径,用刚释放的本地端口 触发拒绝路径,分别断言提示里包含对应的排查方向。
This commit is contained in:
@@ -18,6 +18,24 @@ v0.4.7 提供两套互不依赖的传输方式:
|
||||
|
||||
## v0.5-m1:电脑 ↔ 电脑互传(新增)
|
||||
|
||||
### Windows 首次运行必须放行防火墙
|
||||
|
||||
二进制已从 `qft-windows.exe` 改名为 `qft-desktop.exe`,**此前给旧名字放行的
|
||||
防火墙规则对新程序不生效**,接收方会表现为「对方能解析连接码但连不上」。
|
||||
|
||||
管理员 PowerShell:
|
||||
|
||||
```powershell
|
||||
New-NetFirewallRule -DisplayName "QFT Desktop" -Direction Inbound `
|
||||
-Program "<完整路径>\qft-desktop.exe" -Action Allow -Profile Private,Domain
|
||||
```
|
||||
|
||||
或在「允许应用通过 Windows Defender 防火墙」里勾选 `qft-desktop.exe` 的**专用网络**。
|
||||
|
||||
排查顺序:对端 `ping` 不通且 TCP 端口连不上,但 `arp -a` 能看到对方 MAC,
|
||||
基本可以判定是对端主机在丢包(防火墙),而不是网络不通。
|
||||
|
||||
|
||||
桌面端目录从 `windows/` 改名为 `desktop/`,crate 更名 `qft-desktop`,
|
||||
**现已可在 macOS / Linux / Windows 三平台编译运行**。平台差异全部收敛在
|
||||
`desktop/src/platform.rs`(配置目录、下载目录、设备名、Direct AP 能力),
|
||||
|
||||
Reference in New Issue
Block a user