zhy200308
d7a29e035f
fix Wi-Fi Direct legacy connection acceptance
2026-08-12 12:41:59 +08:00
zhy
144b7d1a8e
fix(android): enable BuildConfig generation
2026-08-12 12:27:24 +08:00
zhy200308
c1a4dbbd7a
fix Windows Direct service reachability
2026-08-12 12:11:15 +08:00
zhy200308
65223dafe4
enforce dedicated Wi-Fi for direct QR pairing
2026-08-12 11:46:59 +08:00
zhy200308
eccd93266e
fix direct pairing probe timeout and speed up QR scanning
2026-08-12 11:26:59 +08:00
zhy200308
f9e25819ee
fix: improve QR direct connection reliability and speed
2026-08-12 11:14:34 +08:00
zhy200308
9c16cc1690
fix(desktop): 提权脚本用了 bash 的 \ 续行导致放行必然失败,且失败被误报为成功
...
用户的终端输出把我上一版的 bug 直接暴露了出来:手动放行命令里
`New-NetFirewallRule ... -Direction Inbound \` 后面接换行——`\` 是 bash 的
续行语法,PowerShell 用反引号,于是命令被拆成两条,两条都报错。
同一个 `\` 也写在了 grant() 生成的提权脚本里,所以「放行防火墙」按钮在
Windows 上是**必然失败**的。更糟的是它还误报成功:Start-Process -Wait
返回的是启动器的退出码,不是被提权进程的,脚本语法错误照样得到 0。
用户看到的「已提交放行规则,正在复检…」+ 复检仍显示缺少规则,就是这么来的。
三处修复:
1. 脚本一律一条命令一行,绝不使用任何续行。新增测试逐行断言不以 `\` 结尾。
2. 提权脚本跑完必须写一个成功标记文件,grant() 以标记存在与否判定成败,
不再相信外层退出码。拿不到标记时给出明确提示而不是假装成功。
3. 「复制手动放行命令」现在只放命令,不再夹杂中文说明。用户是整段粘进
PowerShell 的,混在里面的散文会被逐行当成 cmdlet 报错,把真正的错误
淹没掉——用户的终端输出里满屏都是这个。加测试断言每一行都是命令或注释。
另外 APP_VERSION 是 main.rs 里的手写常量,上一版我只改了 Cargo.toml,
界面仍显示 v0.4.9,用户无法判断自己跑的是不是新构建。改为
env!("CARGO_PKG_VERSION"),从此只有一个版本号来源。
用户机器上的诊断结果排除了另外两种成因:三个配置文件的 AllowInboundRules
都是 NotConfigured(没有开启「阻止所有传入连接」),按程序路径也查不到任何
阻止规则。所以剩下的就是放行规则本身没建成——正是本次修复的这个 bug。
版本号 0.4.10 → 0.4.11。
2026-08-12 10:54:05 +08:00
zhy200308
2bb6ce63ae
fix(desktop): 修复防火墙面板在「电脑→Android」页面是死代码,并重做 Windows 检测
...
上一版我说"两个页面都加了",但用户在 v0.4.9 上依然看不到。这次不猜了,
把程序真跑起来截图,看到面板确实没画出来,才找到原因:
pc_to_phone_ui 在 running 时于函数中段就 return 进了 resizable/focus 分支,
我加的那 37 行写在函数尾部,永远执行不到——代码在、grep 得到、但一个像素
都不会画。前两次自查只 grep 了"firewall_panel 在不在",没确认它在不在活的
分支上。面板已移到 pc_to_phone_running_controls(真正渲染的运行态控制区)。
为防同类缺陷复发,加了两个**真渲染**测试:在无窗口 egui 上下文里跑一帧,
把 galley 里的文字抓出来断言。grep 源码挡不住死代码,只有画一遍才行。
另外把 pc_receive_ui 里内联复制的第三份面板也收敛到 firewall_panel。
Windows 防火墙检测重做(这才是"点了放行还是连不上"的根因方向):
1. 改用 PowerShell 而非 netsh。netsh 输出的**值**会本地化(中文系统上是
「允许/阻止/任何/是」),原先按 "Any"/"Yes" 匹配在中文 Windows 上必然
误判;Get-NetFirewallRule 返回的枚举在任何语言下都是 Allow/Block/Any。
2. 按**程序路径**查询,不再只按规则显示名。用户在「安全警报」弹窗上点了
取消时,Windows 会自建一条针对该 exe 的阻止规则,名字是程序名而不是
QFT Desktop。只按显示名查完全看不见它,而 Block 在 Windows 里永远压过
Allow——症状正是"点了放行、界面显示已放行、手机依然连不上"。
grant() 现在会先清掉这类阻止规则再重建放行规则。
3. 检测「阻止所有传入连接,包括位于允许应用列表中的应用」
(AllowInboundRules=False)。这项打开时加多少规则都没用,单独报为
BlockedByPolicy,按钮相应置灰并说明要去哪里关——它属于用户的安全设置,
程序不代劳。
4. manual_instructions 里的 -Profile Private,Domain 是个真 bug,与本模块
自己的注释矛盾:照抄的用户会重建出一条在 Direct AP 虚拟网卡(被判为
公用网络)上根本不适用的规则。改为 -Profile Any 并补上排查步骤。
5. grant() 成功后不再直接断言"已放行",改为触发复检——规则加上了不等于
入站真的通了。
检测要起 PowerShell 进程(1~2 秒),移到后台线程,避免在"启动接收"的瞬间
卡住界面。解析逻辑抽成纯函数 classify_probe,配 10 个用例覆盖中文系统、
自动阻止规则、系统级封禁、防火墙整体关闭等场景——Windows 专有代码最容易
烂在没人跑的地方。已用 cargo check --target x86_64-pc-windows-gnu 验证
Windows 分支能编过。
版本号 0.4.9 → 0.4.10,便于确认拿到的是新构建。
2026-08-12 09:55:12 +08:00
zhy200308
4c294d4270
feat: Direct AP 直连提速 + 剔除虚拟网卡 + 版本号提到 0.4.9 便于确认构建
...
三项一起处理。
1. 所有 PC→手机的二维码页面都有防火墙放行
「Android → 电脑」页在 dec132c 已加,「电脑 → Android」页在 7b18c6a
补上,两处都是「防火墙面板 + 二维码广播的地址」并在启动时自动检测。
本次把版本号从 0.4.8 提到 0.4.9:此前用户反馈"看不到防火墙功能",
实为未拉取新提交,而界面上没有任何可据以判断构建新旧的标识。
2. Direct AP 下先直连网关,UDP 发现退为兜底
Direct AP 场景里网关必然就是那台电脑——手机的 IP 正是它的 DHCP 发的。
此前却把阻塞式 UDP 发现排在最前,白白等掉一两秒才开始真正能成功的
那一步。现在配网一就绪立刻并发探测「网关 + 二维码携带的地址」
(400ms 连接 / 600ms 读取),不通才回落到 UDP 广播与子网扫描。
3. Direct AP 下彻底剔除虚拟网卡地址
二维码只放得下 4 个地址,而实测机器上有 192.168.30.1、192.168.31.1、
172.21.96.1 三个 VMware/Hyper-V/WSL 地址。上一版只做降权,名额紧张时
救不了场。Direct AP 启用时改为直接剔除——此刻手机连的是 AP 网段,
这些地址永远到不了,占着名额纯属浪费。
新增 is_virtual_endpoint(),对解析不了的字符串一律不判为虚拟,
避免误删真实地址。
cargo test 51/51。Kotlin 侧本机无法编译,仅结构检查。
2026-08-12 09:22:24 +08:00
zhy200308
7b18c6a661
fix(desktop): 电脑→Android 页也加防火墙面板与地址列表
...
二维码端点的修复已经验证生效:手机端诊断显示码里第一个地址就是
192.168.137.1,49.1 紧随其后,虚拟网卡 192.168.30.1 被压到末尾,
顺序完全符合预期。
但连接仍然失败,且手机明确探测过 192.168.137.1:39393 无应答——
问题彻底收敛到「Windows 没有在 Wi-Fi Direct 虚拟网卡上接受连接」,
也就是防火墙规则没有覆盖该网卡的网络类型(通常被归类为公用网络)。
而我上一版只把防火墙面板加到了接收页,本页(电脑→Android)没有,
用户在这里遇到问题时界面上无处可点。补上:
- 面板 + 「二维码广播的地址」折叠项,与接收页一致
- 启动直传时自动重新检测(AP 网卡类型与主网卡往往不同,缓存会误导)
cargo test 49/49。
2026-08-12 09:08:20 +08:00
zhy200308
b2edb3048a
fix(desktop): 非 Windows 平台禁用 Direct AP 选项,不再把做不到的事列为「推荐」
...
Direct AP 只有 Windows 有实现(direct_ap.rs 在其余平台直接 bail),
但两个页面的「连接方式」都把它写成「QFT Direct(推荐)」并默认选中。
macOS/Linux 用户点了之后才发现失败,白白浪费一次尝试。
platform::direct_ap_support() 早就写好了,只是一直没接线(还挂着
allow(dead_code))。现在:
- 两个页面的 Direct AP 单选项在不支持的平台上禁用,并在下方说明原因
- 默认值改为随平台决定,非 Windows 上直接落在「当前局域网」
- 移除 platform.rs 里相应的 allow(dead_code)
cargo test 49/49。
2026-08-12 09:03:09 +08:00
zhy200308
13624d9747
fix(pairing): Direct AP 网关地址被挤出二维码,修复我上一版引入的回退
...
上一版号称把 AP 网关置顶,实测二维码里依然没有 192.168.137.1,
而手机连上 AP 后网关正是它。两个独立原因叠在一起:
1. 判断条件读了还没赋值的字段
start_receiver 里 direct_ap 是局部变量,要到函数末尾才写回
self.receive.direct_ap;而生成二维码那行读的正是 self.receive.direct_ap,
此刻永远是 None,于是 direct_ap_active 恒为 false,置顶逻辑从未触发。
改为直接用局部变量。发送端同一处问题一并修正。
2. 虚拟网卡把名额占满了
实测机器上有 192.168.30.1、192.168.31.1、172.21.96.1 三个
VMware / Hyper-V / WSL 的地址。它们是真实网卡、排序里与普通局域网
同级,正好填满二维码仅有的 4 个名额,把 AP 网关顶了出去。手机
永远到不了这些地址,却要为它们付出探测时间。
新增 is_likely_virtual():按各家虚拟化产品的默认网段 + 以 .1 结尾
(宿主机在虚拟网络里通常是网关)判断,只降权不丢弃——万一某台机器
真用这些网段做局域网,仍能兜底。
新增三项用例:实测遇到的三个虚拟地址必须被识别;192.168.0.1 /
192.168.1.1 / 192.168.8.1 / 10.0.0.1 这些家用网关不得误伤;
只有 .1 结尾才参与判断,普通主机地址一律不降权。
cargo test 49/49。
2026-08-12 08:59:07 +08:00
zhy200308
6abd932872
fix(desktop): 配对二维码按窗口自适应 + 接收页加专注模式;修复 Direct AP 地址被挤出二维码
...
两个问题,后者是我上一版引入的真实回退。
一、二维码显示不全
接收页与发送页的配对码此前只按 available_width() 计算边长,并硬性保底
260 点,完全不看可用高度。窗口一矮,码就溢出到可视区外——用户看到的是
被截掉下半截、根本扫不了的码。
- 新增 fit_qr_side():同时受宽高约束,宁可让码变小也不越界;
并对退化输入(布局初帧可能给出 0 或负的可用空间)保证边长为正
- 接收页(QFTPAIR2)新增专注模式与占比滑条。扫码时用户会把手机凑近
屏幕,界面上的按钮和状态此刻毫无用处,反而在小窗口里抢走空间。
发送页原本就有专注模式,本次统一了两页的行为
- 退出接收/返回首页时重置专注状态
二、Direct AP 网关地址被挤出二维码
实测诊断显示二维码给出的是 192.168.8.68、192.168.30.1、192.168.31.1,
唯独没有 192.168.137.1——而手机连上 AP 后网关恰恰是它。
根因是上一版把「猜测性兜底地址」挪到列表末尾后,二维码只取前 3 个,
192.168.137.1 被截断了。它在生成二维码的瞬间往往还不是真实网卡地址
(ICS 虚拟网卡尚未分配 IP),因此不会出现在 get_if_addrs 结果里。
表现为「手机连上了临时 Wi-Fi、拿到了 IP 和网关,却找不到电脑」——
从现象几乎无法反推到这里。
- 新增 pairing::qr_endpoints(port, direct_ap_active):Direct AP 启用时
把两个 ICS 网关地址置顶
- 二维码端点数从 3 提到 4,容纳 AP 地址与常规局域网地址
- Windows 界面新增「二维码广播的地址」折叠项,把码里的地址摊开显示,
不必等手机端报错就能确认
cargo test 46/46,含二维码尺寸的三项回归(不越界、缩放夹取、退化输入)
与 Direct AP 地址置顶的三项。
2026-08-11 22:08:44 +08:00
zhy200308
f62fe8d23b
fix(pairing): Direct AP 网关地址被挤出二维码,修复我上一版引入的回退
...
手机端诊断给出了决定性证据。二维码广播的三个地址是:
192.168.8.68、192.168.30.1、192.168.31.1
而手机连上 Direct AP 后拿到的是 192.168.137.200/24、网关 192.168.137.1
——**码里根本没有它能到达的那个地址**。
回退是我造成的。上一版为了让真实网卡优先,把 192.168.137.1 / 192.168.49.1
这两个猜测性兜底地址挪到了列表末尾;而二维码只取前 3 个。二维码是在
点「启动接收」的瞬间生成的,此时 ICS 虚拟网卡往往还没拿到 IP,因此
不会出现在 get_if_addrs 里,只能靠那两个兜底地址补位——一挪到末尾就被
截断掉了。表现是"Wi-Fi 已连接但找不到电脑",从现象几乎无法反推到这里。
改动
- 新增 pairing::qr_endpoints(port, direct_ap_active):Direct AP 启用时
把 ICS 网关地址强制放到最前,未启用时维持真实网卡优先
- 二维码端点上限 3 → 4,以便同时容纳 AP 网关与常规局域网地址
- Windows 接收页新增可展开的「二维码广播的地址」列表。手机报"找不到
电脑"时,第一件要确认的就是码里有没有它能到达的地址——现在一眼可见,
不必等手机端诊断
测试:新增三项,分别锁住「AP 网关必须排第一」「即使网卡很多也不能被
长度上限截断」「未开 AP 时不该让猜测地址占位」。cargo test 43/43。
注意:本次修复的是"地址没进二维码"。手机此前也直接探测过网关
192.168.137.1:39393 并且失败,说明 Windows 在 ICS 虚拟网卡上仍未接受
连接——那是防火墙配置文件的问题,需要在接收页点「放行防火墙」
(规则会以 profile=any 重建,覆盖该网卡的网络类型)。
2026-08-11 22:03:19 +08:00
zhy200308
ae2c36fa54
perf(android): 传输期间持 Wi-Fi 高性能锁;汇总带上链路协商速率
...
实测 1.01 GB 的分段数据推翻了此前的判断:
接收 1分1秒 · 17.06 MB/s ← 97% 的时间
校验 1秒 · 1.05 GB/s
保存 2秒 · 731 MB/s
合计 1分3秒 · 16.44 MB/s
保存只花 2 秒,此前估计的 15 秒完全错误——那次 MediaStore 拷贝根本不值得
优化,也不构成 10 GB 的阻塞(按此速率 10 GB 约 14 秒)。全部瓶颈都在
网络传输本身。
改动
1. Wi-Fi 高性能锁
Android 默认让 Wi-Fi 芯片在包间隙进入省电休眠,代价是额外唤醒延迟,
对持续大流量传输会明显压低吞吐。这是 Android 上最常见也最容易被忽略的
一项限速。传输期间持锁(API 29+ 用 WIFI_MODE_FULL_LOW_LATENCY,
以下用 WIFI_MODE_FULL_HIGH_PERF),下载与上传两条路径都覆盖,
并在 finally 与返回首页时释放——否则 Wi-Fi 会一直停在高功耗模式。
Manifest 补 WAKE_LOCK 权限。
2. 汇总带上链路协商速率
新增 WifiConnector.describeLink(),在完成汇总里附上
「链路 x Mbps · 频段 · 信号 y dBm」。判断"传输慢"到底是软件问题还是
链路本身的上限,这两个数字是唯一依据:协商 866 Mbps 却只跑到
136 Mbps 说明有优化空间;协商本来就只有 150 Mbps 则已接近满速,
再改代码也没有意义。下一步该往哪走,取决于这个数。
Kotlin 本机无法编译,仅做结构检查。
2026-08-11 21:52:52 +08:00
zhy200308
dec132cf3e
fix(desktop): 手机接收页也显示防火墙检测,Direct AP 才是最需要它的地方
...
防火墙面板此前只在「电脑 ↔ 电脑」页有,而 Direct AP 恰恰是最容易被
拦住的路径:它会新建一块 ICS 虚拟网卡,Windows 通常把这块网卡归类为
「公用网络」,与主网卡的类型不同。只覆盖专用/域网络的规则在它上面
完全不生效——表现就是手机连上了临时 Wi-Fi、拿到了 IP 和网关、
二维码地址也正确,却怎么都找不到电脑。用户不可能自己想到这一层。
改动
- 把面板抽成 firewall_panel(ui, port) 供两处共用
- 放在手机接收页的二维码旁边:用户在这里停留最久,也正是在这一步失败
- 被拦时额外解释「Direct AP 是独立网卡、可能被归类为公用网络」这一因果
- 启动接收时自动重新检测,而不是沿用上次结果——AP 网卡的类型与主网卡
往往不同,缓存的结论会误导
cargo test 40/40。
2026-08-11 21:42:12 +08:00
zhy200308
22c7d7f22d
fix: 扫码后先在当前网络直连,不再无条件切 Direct AP
...
实测诊断给出了决定性信息:手机成功连上 Direct AP、拿到
192.168.137.200/24、网关 192.168.137.1,二维码也正确指向
192.168.137.1:39393,但那个地址上的 39393 不应答,整个 /24 扫了
253 个地址也没有。也就是说手机侧全对,是 Windows 没有在 ICS 虚拟
网卡上接受连接。
而这次切换本来就没有必要——两台设备当时已经在同一个 192.168.8.0/24
局域网里,且实测 192.168.8.68:39393 是通的。切到 Direct AP 反而引入了
ICS 虚拟网卡、该网卡独立的防火墙配置,以及实测一两分钟的配网等待。
改动
1. 二维码始终携带局域网地址(pairing.rs)
此前开 Direct AP 时只放一个 AP 地址,手机因此**必须**切网才能连。
现在无论是否开 AP 都带上常规局域网地址,多两个短地址对二维码密度
的影响可以忽略。
2. 端点顺序修正(pairing.rs)
此前无条件把 192.168.137.1 / 192.168.49.1 排在最前,即使本机根本
没有这两块网卡——手机于是先去探测两个不存在的地址,真正可用的
局域网地址被挤到后面。改为真实网卡优先、猜测性兜底地址殿后。
3. 先试当前网络(MainActivity)
扫到带 Wi-Fi 凭据的码时,先用系统默认网络并发探测二维码里的地址
(700ms 连接 / 900ms 读取)。通了就直接开始传输,完全跳过配网弹窗
与虚拟网卡;不通才切 Direct AP。新增 UploadClient.probeEndpoints。
4. 配网请求复用加时间上限(WifiConnector)
上一版为了避免「系统选网弹窗还开着就 unregister」而改成复用挂起的
请求,但没有上限。系统偶尔会让请求既不回 onAvailable 也不回
onUnavailable 地一直挂着,于是每次「重试连接」都只是再等一次那个
死掉的请求——这正是本次「配网越来越慢、至少两分钟」的由来。
超过 20 秒即推倒重来。
5. 网关探测过滤 0.0.0.0(WifiConnector)
诊断截图里出现了 http://0.0.0.0:39393,来自默认路由的空网关 ,
永远连不上却占着探测预算。回环与组播地址一并过滤。
Rust 侧 cargo test 40/40,含两项新用例:端点顺序、以及开 Direct AP 时
二维码仍携带局域网地址。Kotlin 侧本机无法编译,仅做结构检查。
2026-08-11 21:39:46 +08:00
zhy200308
b5d124abe5
fix(android): 网关探测过滤 0.0.0.0 等无效地址
...
实测诊断截图里出现了 http://0.0.0.0:39393 这个候选。它来自默认路由的
空网关(直连链路无下一跳),永远不可能连上,白白占用探测预算并把真正
的候选挤到后面。回环与组播地址同理,一并过滤。
2026-08-11 21:26:06 +08:00
zhy200308
0281382c39
feat(android): 分阶段速率记账 + 连接失败时输出网络诊断
...
两件都是为了让"到底哪里慢/哪里断"能被看见,而不是继续靠猜。
分阶段速率
下载分传输、校验、保存三段,三者速率含义完全不同,混在一起平均出来的
数字毫无意义——这也是"传输不到 10 MB/s"这个观察难以定位的原因:
1 GB 若传输 50 s、校验 5 s、保存 15 s,看起来就成了 14 MB/s。
现在逐段记账,完成后一并列出:
接收完成:已保存到 Downloads/QFT/xxx
接收 52.3s · 19.6 MB/s
校验 6.1s · 168 MB/s
保存 14.8s · 69 MB/s
合计 73.2s · 14.0 MB/s
并行下载的进度回调来自多个 worker 线程(DownloadClient 里 pool.submit
的闭包),因此记账用 AtomicLong 与 synchronizedList,不能用普通 var。
连接失败的诊断
"未找到 QFT 接收服务"这句话无法区分:手机在别的网段?没拿到网关?
还是对端根本没开。现在报错里直接带上手机侧的实际网络状况——
本机地址/掩码、网关、SSID——以及二维码给出的地址、探测过的网关、
子网扫描范围,并列出三条对照检查项。
新增 WifiConnector.describeNetwork()。
注意:Kotlin 在本机无法编译,以上改动仅做过结构检查,需要实测编译。
2026-08-11 21:14:22 +08:00
zhy200308
ae41267221
perf(sender): 下载服务支持 HTTP keep-alive,消除每分块重建 TCP
...
Android 的并行下载在每个 Range 请求里都写了 Connection: keep-alive,
但服务端每个响应都写死 Connection: close —— 复用是单方面的,实际上
每个 16 MiB 分块都要新建一条 TCP。1 GB 是 64 次,10 GB 是 640 次。
这正是"短连接不稳定、很快断开"的直接来源。
改动
- handle_client 拆出 serve_one,在同一条连接上循环处理请求
- 按 HTTP/1.1 语义决定是否复用:客户端显式 Connection: close 或
使用 HTTP/1.0 时才断开,否则响应回 Connection: keep-alive
- 读到 0 字节视为对端正常关闭,这是 keep-alive 下的常态而非错误,
不再当作 "连接在请求头前关闭" 报错
测试
新增 serves_multiple_ranges_on_one_connection:在同一条 TCP 上连发三段
互不重叠的 Range,逐段校验状态行、Content-Length、Connection 头与内容
字节,最后再用一个显式 Connection: close 的请求确认服务端会正常收尾。
两个既有用例同步补上 Connection: close —— 它们只发一个请求就读到 EOF,
在 keep-alive 下会一直等下一个请求直到读超时。
cargo test 38/38。
2026-08-11 21:02:01 +08:00
zhy
90800b9a21
Merge branch 'main' of https://git.xskjhy.top/kmcc/QFT
2026-08-11 20:52:54 +08:00
zhy
32b58d121a
优化UI,电脑传手机二维码配网可拖动区域大小
2026-08-11 20:44:43 +08:00
zhy200308
99be46acf7
release: v0.4.8 跨端 PC 互传封版;修复发送端进度直到结束才更新
...
实测 1.01 GB / 23.11 MB/s 传输成功,但发送端进度条全程 0%、
最后才跳到 100%,接收端却是实时的。两处原因,都已修复。
1. 请求体一次性写出
16 MiB 的分块用单次 write_all 送出,中途没有任何可上报的点。
改为 256 KiB 一片:足够小让进度看起来连续,又足够大不拖慢吞吐。
put_chunk 逐片累加共享计数;失败重试时把本次尝试已计的字节扣回去,
否则重试会让进度虚高甚至越过 100%。
2. on_progress 只在所有 worker 结束后调用一次
主线程改为在 worker 运行期间轮询上报(40 ms 一次,对 UI 足够,
代价可忽略),而不是等 thread::scope 返回。
测试拆成两层
- 确定性单测 body_progress_is_reported_incrementally:5 片请求体必须
上报 5 次、总量吻合。回环速度太快时集成测试采样不到中间进度,
只有这一层能稳定拦住回归
- 集成测试改为断言稳健性质:进度单调不减、且不超过文件总长
(后者正是重试重复计数会破坏的)
- 配套的 mock 服务端按 Content-Length 精确读取。此前用 read_to_end
会一直等客户端关闭写端,而客户端在等响应,两边互等直接死锁
封版
- 版本 0.5.0-m1 → 0.4.8,接续既有编号
- 界面与 README 里残留的「6 位配对码」文案更新为连接码
本版可用范围:mac / win / linux 桌面端互传,连接码内含地址,
不要求同一网段,只要 IP 层可路由到达即可。
v0.4.8
2026-08-11 19:37:21 +08:00
zhy200308
375ae8a956
fix(desktop): 选择文件不再让程序崩溃;新增拖拽;macOS 产出 .app
...
macOS 上点「选择文件」直接退出:
panicked at objc2-app-kit-0.3.2/.../NSOpenPanel.rs:127:
unexpected NULL returned from +[NSOpenPanel openPanel]
rfd 在 openPanel 返回 NULL 时直接 panic,整个进程随之结束——用户只是
想选个文件,窗口就没了。三层处理,从"不该崩"到"不该发生":
1. 不该崩:pick_files/pick_folder/pick_file 全部包进 catch_unwind。
文件对话框失败是可以恢复的情况,不该终止程序;失败时在状态栏说明
并提示改用拖拽。
2. 提供不依赖对话框的路径:支持把文件直接拖进窗口。拖拽不经过
NSOpenPanel,对话框失效时照样能用,而且本来就是桌面端更顺手的交互。
悬停时给出"松手即可加入待发送列表"的提示。
3. 消除诱因:package.sh 在 macOS 上额外产出 QFT.app。AppKit 的若干行为
依赖应用被正确注册为 GUI 程序,直接跑裸二进制正是这个 NULL 的高发场景。
Info.plist 含 NSHighResolutionCapable,Retina 下不会被拉伸。
顺带修复 package.sh 的校验和步骤:此前 `sha256sum ./*` 会把 .app 目录
一起喂进去并报错,改为 find -type f 只处理普通文件。
验证:cargo test 35/35;package.sh 完整跑通并实际 open 了生成的 .app,
确认能启动存活;plutil 校验 Info.plist 通过。
2026-08-11 18:56:17 +08:00
zhy200308
bcadcf0b53
fix(firewall): 规则必须用 profile=any,否则在公用网络下完全不生效
...
实测发现的真 bug。用户机器上的规则列表:
qft-windows Allow Inbound Public (旧版,能用)
QFT Desktop Allow Inbound Domain, Private (新加,不生效)
Windows 对没见过的 Wi-Fi 默认归类为「公用网络」。规则只覆盖
Private,Domain 时,Get-NetFirewallRule 照样显示 Enabled: True,
但对当前网络根本不适用,连接依旧被拦——这种「配置看起来是对的却没有
效果」的失败最难排查。旧版之所以一直能用,是因为当初点系统安全警报的
「允许」时,Windows 按当时的 Public 配置自动建了规则。
改动
- grant() 生成的 netsh 规则改为 profile=any
- status() 不再只看「有没有同名规则」,还要求它是 any profile,
否则同样报 Missing。避免出现「检测说已放行、实际仍被拦」
- README 补充排查步骤:先看 NetworkCategory 与规则的 Profile 两列,
以及 Block 规则优先于 Allow 这个常见坑
关于收窄 profile 的取舍:限定到 private 并不能带来实际安全收益。
QFT 的入站真正靠的是连接码里的秘密加失败计数,没有秘密的连接一律被拒;
而按 profile 收窄只会在最常见的家用/公共 Wi-Fi 场景下静默失效。
验证:cargo test 35/35。Windows 分支仍无法在本机执行,
netsh 与 UAC 那条路径需要在 Windows 上实测。
2026-08-11 18:48:41 +08:00
zhy200308
0f0dbaef47
fix(desktop): 防火墙提权改为手动触发;构建前检测占用;清理警告
...
三个问题一起处理。
1. 提权改为手动
上一版会在点「启动接收」时自动弹 UAC。实际用下来太侵入——多数人
只是想收个文件,却先被要求管理员授权。现在:
- 检测保持自动,但**只读**,无任何副作用
- 提权只在用户点「放行防火墙(需要管理员授权)」时发生
- 按钮无条件保留,不再只在"检测到被拦"时出现:检测可能不准,
而用户遇到「对方连不上」时需要有地方可点
- 同时移除了拒绝标记的持久化——提权已不自动发生,无需记忆
2. Windows 构建报 os error 5
error: failed to remove file `...\target\release\qft-desktop.exe`
Caused by: 拒绝访问。 (os error 5)
原因是 QFT 窗口还开着,运行中的 exe 锁住了产物文件,而 cargo 的报错
完全看不出这一层。VERIFY_WINDOWS_HOST.ps1 现在会在构建前检测
qft-desktop 进程,列出 PID 并询问是否结束;README 也补了说明
(含 Defender 扫描导致的偶发同类报错)。
3. 构建警告 15 → 5
长期堆积的警告会训练人忽略所有警告,所以逐条处理:
- 真实问题:if 条件多余的括号,已修
- 为后续里程碑准备但尚未接线的 API(client::ping、download_file、
platform::direct_ap_support/ensure_dir),加 #[allow(dead_code)]
并注明将在哪个阶段使用
- 仅特定平台构造的项(firewall::RULE_NAME 只用于 Windows,
FirewallStatus::Unsupported 只在 Linux 返回),改用
#[cfg_attr(not(...), allow(dead_code))],避免无条件放行
剩余 5 个均为本次改动之前既有(cache_mib、v/transport、security、
path),不属本次范围,未改动。
验证:cargo test 35/35,release 构建 5 个警告且全部是既有的。
2026-08-11 18:28:43 +08:00
zhy200308
bdb822233f
feat(desktop): 启动接收时自动检测并申请防火墙放行
...
上一次实测卡在「连接码解析正确但连不上」,根因是对端 Windows 防火墙
拦截入站,而用户几乎不可能自己联想到这一层。新增 firewall.rs,
在点「启动接收」时自动检测,缺规则就申请一次放行。
三条设计约束
1. 只在确实缺规则时申请。每次启动都弹 UAC 属于骚扰。
2. 被拒绝就记住。写标记文件到配置目录,之后只在界面留一个手动按钮,
不再自动弹窗;用户点「放行防火墙」会清除标记重新申请。
3. 规则尽量窄。只放行本程序、只放行专用/域网络,不碰公用网络,
更不整体关闭防火墙。
提权全部交给操作系统的标准机制(Windows UAC、macOS 授权对话框),
程序不接触也不存储任何凭据。
各平台
- Windows:netsh 查规则;添加时把命令写进临时批处理再用
Start-Process -Verb RunAs 提权执行。不把参数塞进 PowerShell 的
-ArgumentList —— 程序路径含空格时会被二次分词,引号层层嵌套极易出错,
批处理里的引号由我们自己写死,不再被重新解析
- macOS:先查 socketfilterfw 全局状态,防火墙没开就直接判定无需处理;
否则查本程序是否被拦,需要时用 osascript 的管理员授权添加。
路径含引号或反斜杠时拒绝拼接命令,改为提示手动操作
- Linux:只检测与给出 ufw / firewalld 的命令,不自动改规则。
各发行版防火墙前端差异过大,自动修改风险高于收益
界面
接收页在检测到可能被拦时显示橙色提示,附「放行防火墙」与
「复制手动放行命令」两个按钮。已放行或防火墙未开启时不显示任何东西。
验证:cargo test 35/35。防火墙相关 3 项均为只读,不改动任何系统设置:
状态查询不 panic 且分类正确、手动说明包含可操作信息、拒绝标记可持久化
往返。本机实测返回 Allowed(防火墙未开启),符合预期。
未验证:Windows 与 Linux 分支在这台 Mac 上无法执行,
netsh/UAC 那条路径需要在 Windows 上实测。
2026-08-11 18:07:53 +08:00
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
84643bff5e
feat(desktop): PC↔PC 改用连接码,一串搞定,不再单独输 IP
...
此前发送方要分别念/输三样东西:IP、端口、6 位配对码。现在合成一串
可口述的连接码,**地址就编在码里**,所以拿到码即可直连——不需要广播、
不需要在同一网段,只要 IP 层路由可达即可(同一路由器下的不同 VLAN /
网段正属于这种情况)。
新增 connect_code.rs
- 编码:version(3) | kind(3) | 默认端口位 | 地址 | [端口] | 24bit 秘密 | CRC-8
- 按网段压缩地址:192.168.a.b 只需 2 字节,10./172.16-31. 三字节,
其余四字节,IPv6 十六字节
- Crockford Base32(去掉易混的 I/L/O/U),分组显示
- 典型 192.168.a.b:39393 → **12 个字符**,如 4849-3WT1-3ZS0
- 输入容错:大小写、分隔符、空格随意;I/L 归一为 1、O 归一为 0
接收侧
- 6 位配对码 → 3 字节秘密;UI 为**每个网卡各生成一个连接码**,
对方在哪个网段就用哪一串(虚拟网卡排后面)
- 新增 pairing::local_ipv4_addresses(),按「最可能被对方看到」排序
发送侧
- 三个输入框(设备列表 / 手动 IP / 配对码)合并为**一个连接码输入框**
- 边打边校验:CRC 在连接之前就能发现输错,并实时显示「将连接 http://x.x.x.x:port」
- 广播搜索降级为可选的折叠项——同网段免输码是锦上添花,不再是主路径
一个被测试抓出来的真问题
最初单字符输错的拦截率只有 96%。原因是 12 个 Base32 字符携带 60 bit
而实际只用 56 bit,末尾 4 个填充位被解码器直接丢弃,改动最后一个字符
有 1/16 概率解出完全相同的字节,CRC 根本没机会发现。加上填充位必须为 0
的校验后拦截率 >99%。
必须说清的边界
连接码解决的是「找不到对方」和「输入太繁琐」,不能凭空制造可达性。
若两台机器在 IP 层互不可达(Wi-Fi 客户端隔离、各自在不同物理网络),
任何客户端侧协议都无法建立连接,只能换链路或引入第三方中转——
后者与 QFT「不经过外网」的定位冲突,本版不做。
验证:cargo test 30/30,含连接码往返(全部地址类型)、容错输入、
单字符输错拦截率统计、以及走完整连接码链路的端到端传输
(编码 → 解码 → 换令牌 → 9MB 并发上传 → SHA-256 比对)。
2026-08-11 17:29:00 +08:00
zhy200308
d2669fb2e4
fix(desktop): 修复 macOS/Linux 上的中文豆腐块与 HiDPI 缩放
...
macOS 首次构建暴露的两个独立问题。
中文全是豆腐块
- is_ttf_file 只按 `.ttf` 扩展名筛选,而 macOS 的中文字体清一色是
.ttc 字体集合(PingFang/Hiragino/STHeiti),Linux 的 NotoSansCJK
与新版 Windows 的 msyh 也是 .ttc —— 全部被拒。改为按文件魔数识别
(ttcf / OTTO / 0x00010000 / true),同时支持 ttf、otf、ttc
- 候选路径此前只有三条 Windows 的,非 Windows 平台根本没有兜底。
新增 platform::system_font_candidates(),三平台各自列出系统中文字体
- 报错信息里的 windows/assets 路径跟进为 desktop/assets
HiDPI 下整个界面缩成一半
- set_pixels_per_point(1.0) 写死了缩放。Retina 屏 ppp=2.0,
强制 1.0 会让所有控件和文字按一半尺寸渲染,界面挤在窗口左上角。
改为交给 eframe 从系统取
- 原先写死 1.0 应是为了让二维码纹理与物理像素 1:1。改用
snap_to_physical() 在绘制时把尺寸吸附到物理像素整数上达到同样目的:
NEAREST 采样下若落在半个物理像素,相邻模块占的像素数会一宽一窄,
边缘产生锯齿,反而更难被手机解码
顺带
- 设备名去掉 mDNS 的 .local/.lan 后缀。这个名字会出现在对方的设备
列表里,zdeMacBook-Air.local 既长又没有信息量
验证(macOS,Retina 2880x1864)
- cargo test 21/21,其中新增 4 项:
* 系统字体候选中存在的文件必须被 is_font_file 接受
* 本平台至少能找到一个中文字体
* **把找到的字体真正装进 egui 并渲染 '中'**,断言字形宽度非零且
宽于 'A' —— 只检查文件存在是不够的,.ttc 解析失败时宽度会是 0
* snap_to_physical 在 ppp=1/1.5/2/3 下都落在整数物理像素上
- release 构建后实际启动截图确认:中文正常显示(Hiragino Sans GB),
界面按 Retina 正确缩放
2026-08-11 16:51:50 +08:00
zhy200308
92237ff76f
fix(package): package.sh 跟进 desktop/ 改名,并在 keg-only 安装下自动找到 cargo
...
上一个提交把 windows/ 改成 desktop/ 时漏掉了 package.sh —— 当时的
grep 只覆盖 .md/.py/.ps1/.toml/.yml,没有扫 .sh,导致打包脚本仍然
cd windows 并寻找 qft-windows 二进制。
- 路径与二进制名跟进 desktop/ 与 qft-desktop
- cargo 检测增加兜底:brew 的 rustup 是 keg-only,
/opt/homebrew/opt/rustup/bin 不会自动进 PATH,此前会出现
"明明装了工具链却报 cargo 未找到"。现在先在常见位置探一次,
仍找不到时给出可直接执行的修复命令而不是一句干巴巴的报错
- .gitignore 忽略 /dist 打包产物(release 二进制 14 MB,不应入库)
已在 macOS 上完整跑通 ./package.sh:cargo test 17/17 通过、
release 构建成功、产出 QFT-Rust-0.5.0-m1-<时间戳>-darwin 目录与
tar.gz,内含 14 MB 的 Mach-O arm64 可执行文件与 SHA256SUMS.txt。
2026-08-11 16:43:55 +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
v0.4.7
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
dffee5365d
Merge remote-tracking branch 'origin/main'
2026-08-11 11:31:44 +08:00
zhy200308
a4edf734b6
优化大文件稳定并发传输与打包流程
2026-08-11 11:27:40 +08:00
zhy
e326611c82
发布 0.4.6 封版
v0.4.6
2026-08-11 10:53:59 +08:00
kmcc
f260ff4266
Merge pull request 'New test' ( #1 ) from new-test into main
...
Reviewed-on: #1
2026-08-11 10:44:48 +08:00
zhy
34b8fdf050
合并直传接收与文件选择优化
2026-08-11 10:21:45 +08:00
zhy
e9e51a4941
修复直传接收并优化文件选择提示
2026-08-11 10:21:37 +08:00
zhy200308
b444a39a63
修复传输问题
2026-08-11 09:44:26 +08:00
zhy200308
4d77ba6c91
feat: 新增 iPhone 客户端,含隔空投送式点对点互传
...
三条链路:
- 电脑 → iPhone:扫 QFTSEND2 码下载,流式落盘 + 增量 SHA-256,
支持 Range 断点续传
- iPhone → 电脑:扫 QFTPAIR2 码后 init/chunk/finish 并行分块上传
- iPhone ↔ iPhone:QFTP2P1 扫码握手,Network.framework 开启
includePeerToPeer(AirDrop 同款 BLE 发现 + AWDL 点对点 Wi-Fi),
两台设备不需要连同一个 Wi-Fi,也不需要路由器
P2P 用 TLS-PSK 握手:32 字节预共享密钥由发送端随机生成并写进二维码,
扫码这个动作本身完成带外密钥交换与双向认证,无需证书体系与配对弹窗。
未扫到码的第三方连上来过不了握手。
核心层刻意不 import UIKit,可直接以 macOS 为目标编译测试,
不需要 Xcode 也不需要模拟器,已接入主自检套件,72 项全部通过:
- 端点白名单 11 种拒绝用例(域名、公网、172.32 边界、
非规范八位组、IPv6、带凭据/路径/query)
- CoreTests/MockPCServer.py 严格复刻 receiver.rs / sender.rs 的线上语义
(路径、header 名、JSON 字段、Range 行为、chunk 长度校验),
构成 Swift 与 Rust 两端的线格式契约测试,任一端改协议即会失败
- 真实 TLS-PSK 握手下的 P2P 端到端传输,含错误密钥必须被拒
iOS 平台限制(已在 ios/README.md 说明):
NEHotspotConfiguration 需要付费账号 entitlement,故不实现 Direct AP
流程,与电脑互传要求同一局域网;AWDL 是苹果私有链路,Windows 无法参与。
上传块固定 4 MiB 而非 Android 的 4/8/16 MiB,因为 iOS 上
worker 数 × 块大小即内存峰值。
未验证部分:本机只有 Command Line Tools,无 Xcode 与 iOS SDK,
UI 层(SwiftUI/UIKit/AVFoundation)未经编译;.xcodeproj 已通过
plutil 解析与引用完整性校验(42 个对象无悬空引用),
但未在 Xcode 中实际打开过。
2026-08-11 09:08:37 +08:00
zhy200308
ea7b678b37
feat: 新增 QFT5 光学链路方案与分辨率楔形标定工具
...
当前光学链路传 3MB 需要 1 小时,瓶颈不是解码慢而是无反馈重传浪费:
按 320B 分片、45FPS 反推,每轮约捕获 44%,收齐需 16.5 轮,
约 86% 的信道被已收到的重复分片占用。
docs/OPTICAL_V5_PLAN.md 给出完整改造方案:
- 条带级喷泉码消除重传浪费,撕裂只损失 1/12 而非整帧
- MANIFEST 每 32~64 帧插播,消除平均 109 秒的启动空转
- 相机帧率三级锁定 + 手动短曝光(3px/模块下 33ms 自动曝光
会产生 8.7px 运动模糊,等于抹掉近 3 个模块,必然解不出)
- 陀螺仪前馈跟踪四角单应,解决手持抖动丢锁
- 位阵列替代 QR,突破 v40 的 177 模块上限
scripts/wedge_*.py 是配套标定工具。方案里所有吞吐数字都建立在
「px/模块 的真实下限」这一未实测假设上,而合成实验显示该值仅因
对焦质量不同就能在 3.1~5.7 之间摆动,必须先实测:
- wedge_gen.py 生成 7 档 pitch 的伪随机标定图 + 1:1 全屏查看器
- wedge_analyze.py 照片 → 实测 px/模块 → 对比度 → 误码率曲线
- wedge_selftest.py 合成相机模型端到端自检,无需真实硬件
标定同时暴露了方案的一个缺口:条带只有 CRC 没有内码,1750B 条带
约 14000 bit,1 bit 错即整条报废,要求原始 BER 低于 1e-5。
故需改为「内码纠错 + 外层喷泉码纠删」的级联结构,已记入文档。
2026-08-11 09:08:04 +08:00
zhy
0b7ffd2dab
feat: 提交0.4加速版二维码直传与自动配网优化
2026-08-10 20:29:01 +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