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 个警告且全部是既有的。
This commit is contained in:
zhy200308
2026-08-11 18:28:43 +08:00
parent bdb822233f
commit 0f0dbaef47
6 changed files with 93 additions and 64 deletions
+29 -29
View File
@@ -1063,7 +1063,7 @@ impl QftApp {
})
.collect();
if self.pc.firewall.needs_action() || !self.pc.firewall_note.is_empty() {
{
ui.add_space(10.0);
ui.group(|ui| {
let blocked = self.pc.firewall.needs_action();
@@ -1078,16 +1078,21 @@ impl QftApp {
ui.label(&self.pc.firewall_note);
}
});
if blocked {
ui.horizontal_wrapped(|ui| {
if ui.button("放行防火墙").clicked() {
firewall::forget_declined();
self.ensure_firewall();
}
if ui.small_button("复制手动放行命令").clicked() {
ui.ctx().copy_text(firewall::manual_instructions(port));
}
});
ui.horizontal_wrapped(|ui| {
// 无论检测结果如何都保留入口:检测可能不准,
// 而用户遇到「对方连不上」时需要有地方可点。
if ui.button("放行防火墙(需要管理员授权)").clicked() {
self.request_firewall_grant();
}
if ui.small_button("复制手动放行命令").clicked() {
ui.ctx().copy_text(firewall::manual_instructions(port));
}
if ui.small_button("重新检测").clicked() {
self.refresh_firewall();
}
});
if !blocked {
ui.small("检测认为入站不会被拦。若对方仍连不上,可手动放行试试。");
}
});
}
@@ -1151,8 +1156,8 @@ impl QftApp {
&& ui.input(|i| i.key_pressed(egui::Key::Enter));
let parsed = connect_code::ConnectCode::decode(&self.pc.code_input);
let can_connect = !self.pc.busy && parsed.is_ok();
if (ui.add_enabled(can_connect, egui::Button::new("连接")).clicked()
|| (submitted && can_connect))
if ui.add_enabled(can_connect, egui::Button::new("连接")).clicked()
|| (submitted && can_connect)
{
self.pair_pc_peer();
}
@@ -1228,38 +1233,33 @@ impl QftApp {
});
}
/// 检测防火墙,必要时**自动**申请一次放行。
/// 只做**只读检测**,不申请任何权限。
///
/// 只在确实缺规则、且用户此前没拒绝过时才弹系统授权框——
/// 每次启动都弹 UAC 属于骚扰。用户点过「否」就记住,
/// 之后只在界面上留一个手动按钮。
fn ensure_firewall(&mut self) {
/// 早先版本会在启动接收时自动弹 UAC。实际用下来这太侵入:
/// 多数人只是想收个文件,却先被要求管理员授权。
/// 现在提权一律由用户点按钮触发(`request_firewall_grant`)。
fn refresh_firewall(&mut self) {
self.pc.firewall = firewall::status();
if !self.pc.firewall.needs_action() {
self.pc.firewall_note.clear();
return;
}
if firewall::was_declined() {
self.pc.firewall_note =
"此前拒绝过防火墙授权。若对方连不上,请点下方按钮重新放行。".into();
return;
}
}
/// 用户显式点击后才提权。
fn request_firewall_grant(&mut self) {
match firewall::grant() {
Ok(()) => {
self.pc.firewall = firewall::status();
self.pc.firewall_note = "已放行系统防火墙。".into();
}
Err(e) => {
firewall::remember_declined();
self.pc.firewall_note = format!("{e}。若对方连不上,可稍后手动放行。");
}
Err(e) => self.pc.firewall_note = format!("{e}"),
}
}
fn start_pc_receiver(&mut self) {
let Some(dir) = self.pc.save_dir.clone() else { return };
self.stop_pc();
self.ensure_firewall();
self.refresh_firewall();
let token = pairing::new_session_token();
let (tx, rx) = mpsc::channel();
match ReceiverServer::start(dir, token, tx) {