zhy200308
|
3e4d5861aa
|
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 触发超时路径,用刚释放的本地端口
触发拒绝路径,分别断言提示里包含对应的排查方向。
|
2026-08-11 17:39:53 +08:00 |
|
zhy200308
|
376ffba96e
|
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)
|
2026-08-11 16:36:33 +08:00 |
|
zhy
|
a960ad91d8
|
合并 0.4.7 双向并发传输封版
# Conflicts:
# README.md
# android/app/src/main/java/com/qft/optical/DownloadClient.kt
# android/app/src/main/java/com/qft/optical/UploadClient.kt
# docs/PROTOCOL.md
# windows/src/sender.rs
|
2026-08-11 14:27:30 +08:00 |
|
zhy
|
20ac4dc6c7
|
发布 0.4.7 双向并发传输封版
|
2026-08-11 13:49:27 +08:00 |
|
zhy200308
|
cb92397300
|
修正为仅打包Rust桌面端
|
2026-08-11 11:48:09 +08:00 |
|
zhy200308
|
a4edf734b6
|
优化大文件稳定并发传输与打包流程
|
2026-08-11 11:27:40 +08:00 |
|
zhy
|
e326611c82
|
发布 0.4.6 封版
|
2026-08-11 10:53:59 +08:00 |
|
zhy
|
241e22abea
|
V0.4.0加入锁定二维码
|
2026-08-10 17:09:30 +08:00 |
|
zhy
|
d885259e2b
|
V0.3.0版本优化传输速度和提示
|
2026-08-10 15:45:04 +08:00 |
|