fix(installer): 保留现场固定热点约定并说明连接要求

安装完成页默认展示现场统一的 SSID 与密码，便于裁判系统连接和现场调试；本地覆盖配置继续用于其他部署。

- fix(installer): 使用共享热点默认值，并修正本地覆盖配置的包含路径
- docs(network): 明确设备按固件中的固定热点参数连接，客户端电脑需接入同一网络，更换热点后需重新编译烧录
- docs(agents): 区分现场统一热点约定与个人 Wi-Fi 配置，保留前者及对应安装说明

验证：无本地配置与带本地覆盖两种 NSIS 配置均编译通过；预处理检查确认热点名称和密码按预期显示；git diff --check。未连接或烧录设备。

docs/desktop/client.md

@@ -169,7 +169,11 @@ icacls .\src-tauri\target\x86_64-pc-windows-msvc\release\bundle\nsis\*-setup.exe
 
 NSIS 安装流程使用简体中文，包括欢迎、安装位置、安装完成、覆盖安装、卸载与 WebView2 错误提示。`src-tauri/installer/hooks.nsh` 定义页面提示和安装日志，`SimpChinese.nsh` 定义 Tauri 安装器的补充翻译；`tauri.windows.conf.json` 引用这些脚本和主题图片。沿用 Tauri 默认安装模板和当前用户安装方式；首次启动的模式选择与裁判系统绑定仍在客户端内完成。
 
-默认完成页提示客户端与裁判系统连接同一网络，不内置 Wi-Fi 凭据。现场安装包如需显示热点信息，可将 `src-tauri/installer/network.example.nsh` 复制为同目录的 `network.local.nsh`，填写后重新打包。该本地文件已被 Git 忽略；不要提交它，分发安装包时也需确认其中的热点信息允许分享。
+现场裁判系统采用固定热点约定：SSID 为 `SR-602-2G4`，密码为 `12345678`。热点需提供 2.4 GHz Wi-Fi；运行客户端的电脑也应接入同一网络，并允许设备间互访。固定这组参数是为了便于现场连接和调试，安装完成页会直接显示它们。
+
+裁判系统只会连接固件中配置的热点。`WIFI_SSID` 和 `WIFI_PASS` 在编译时写入固件，名称和密码必须匹配；设备不会自动改连其他热点。客户端中的模式选择和设备绑定不修改设备的 Wi-Fi 参数。更换热点时，需修改固件构建配置、重新编译并烧录。
+
+共享现场热点信息保存在 `src-tauri/installer/network.nsh`，随项目维护，普通构建和 CI 构建都会显示。其他部署如需更换安装提示，可将 `network.example.nsh` 复制为同目录的 `network.local.nsh` 并填写；本地覆盖文件已被 Git 忽略。这个覆盖只改变安装提示，不会改变设备固件的连接参数，两边需要同步核对。
 
 视频录制另需可从 `PATH` 找到的 `ffmpeg`，也可以在配置的 `[recording] ffmpeg` 中指定路径；基础图传显示不依赖它。
 

docs/releases/changelog.json

@@ -3,13 +3,23 @@
   "major": 0,
   "minor": 2,
   "patch": 2,
-  "build": 39,
+  "build": 40,
   "protocol": 1,
   "date": "2026-10-21",
   "baseline": "v0.2.1",
-  "commits": 4,
+  "commits": 5,
   "groups": {
     "fix": [
+      {
+        "scope": "installer",
+        "text": "保留现场固定热点约定并说明连接要求",
+        "breaking": false
+      },
+      {
+        "scope": "installer",
+        "text": "使用共享热点默认值，并修正本地覆盖配置的包含路径",
+        "breaking": false
+      },
       {
         "scope": "packaging",
         "text": "修复 Windows 安装与固件打包并完善客户端文案",
@@ -42,6 +52,16 @@
       }
     ],
     "docs": [
+      {
+        "scope": "network",
+        "text": "明确设备按固件中的固定热点参数连接，客户端电脑需接入同一网络，更换热点后需重新编译烧录",
+        "breaking": false
+      },
+      {
+        "scope": "agents",
+        "text": "区分现场统一热点约定与个人 Wi-Fi 配置，保留前者及对应安装说明",
+        "breaking": false
+      },
       {
         "scope": null,
         "text": "润色项目说明并统一裁判系统术语",

docs/releases/changelog.md

@@ -6,10 +6,12 @@
 
 ## v0.2.2 — 2026-10-21
 
-构建号 **39** · 线路协议 **1** · 4 个提交（v0.2.1 → v0.2.2）
+构建号 **40** · 线路协议 **1** · 5 个提交（v0.2.1 → v0.2.2）
 
 ### 修复
 
+- **installer** · 保留现场固定热点约定并说明连接要求
+- **installer** · 使用共享热点默认值，并修正本地覆盖配置的包含路径
 - **packaging** · 修复 Windows 安装与固件打包并完善客户端文案
 - **installer** · 修复低完整性产物无法写入临时目录的问题，并在 CI 打包前后检查完整性标签
 - **firmware** · 从本次 Cargo ELF 打包并同步配套镜像，修正短目录说明与 LLVM 搜索顺序
@@ -19,6 +21,8 @@
 
 ### 文档
 
+- **network** · 明确设备按固件中的固定热点参数连接，客户端电脑需接入同一网络，更换热点后需重新编译烧录
+- **agents** · 区分现场统一热点约定与个人 Wi-Fi 配置，保留前者及对应安装说明
 - 润色项目说明并统一裁判系统术语
 - 整理项目文档并统一界面表述
 - README 不写死构建号，改由 version.json 提供

docs/setup/firmware.md

@@ -141,6 +141,8 @@ WIFI_PASS='你的Wi-Fi密码'
 
 `.env` 使用简单的 `KEY=value`；值含空格、`#` 或 `$` 时用单引号包围，不使用变量展开或命令替换。脚本会加载 `.env`，直接 `cargo build` 不会自动读取它。上述参数在编译时写入固件，修改后需要重新编译和烧录。`.env` 已被 Git 忽略；固件也包含凭据，分享前应重新配置。
 
+现场使用的固定热点名称、密码和连接步骤见[客户端说明](../desktop/client.md#windows-x64-构建)。裁判系统只连接编译时配置的 SSID，并使用对应密码，不会在运行时改连任意热点；运行客户端的电脑也需接入同一网络。固定这组参数便于现场连接和调试。其他部署更换热点时，需同步修改固件构建参数和安装提示，再重新编译、烧录；仅修改安装提示或客户端绑定不会改变设备的连接目标。
+
 运行时断线恢复不重置摄像头、曝光或增益。首次尝试立即发起，失败后按 1、2、4、8、16、30 秒退避；关联与 DHCP 分别有 15 秒期限。恢复 IP 后丢弃旧采集帧、重建 socket 并重新广播，由客户端自动续订。启动时首次联网仍使用扫描与认证模式探测流程。实现依据 [ESP-IDF 断线事件处理说明](https://docs.espressif.com/projects/esp-idf/en/v5.5.5/esp32s3/api-guides/wifi.html#wifi-event-sta-disconnected)。
 
 ## 编译固件