fix(packaging): 修复 Windows 安装与固件打包并完善客户端文案
- fix(installer): 修复低完整性产物无法写入临时目录的问题，并在 CI 打包前后检查完整性标签 - fix(firmware): 从本次 Cargo ELF 打包并同步配套镜像，修正短目录说明与 LLVM 搜索顺序 - fix(installer): 修复中文完成页和页眉遮挡，侧栏使用等比缩放的原始 Logo - style(client): 应用图标增加圆角，统一“裁判系统客户端”命名 - fix(config): 安装提示改用可选本地热点配置，排除 Wi-Fi 凭据 - docs: 润色项目说明并统一裁判系统术语 - test(packaging): 补充 Windows 完整性和固件打包回归，覆盖外部输出目录、旧镜像与重复生成 验证：Windows NSIS 构建及原生页面预览；通用与本地安装配置编译；固件 release 构建、重复打包和客户端离线校验；6 项固件打包回归与 Windows 权限回归；git diff --check。未执行实机烧录。
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
|
||||
**黑龙江大学 602 实验室 · Simba Robotics**
|
||||
|
||||
面向机器人对抗赛的局域网图传与装甲板系统。ESP32-S3 采集 OV5640 的硬件 JPEG，经 UDP 发送到桌面端；ESP32-C3 上报装甲板血量，桌面端提供操作手视野、裁判双路监看、截图录制和 USB 固件维护。
|
||||
本项目面向机器人对抗赛，提供局域网图传与装甲板系统。ESP32-S3 采集 OV5640 的硬件 JPEG，经 UDP 发送到桌面端；ESP32-C3 上报装甲板血量。桌面端提供操作手视野、裁判双路监看、截图录制和 USB 固件维护。
|
||||
|
||||
[](docs/setup/firmware.md)
|
||||
[](docs/hardware/armor.md)
|
||||
@@ -59,7 +59,7 @@ flowchart LR
|
||||
|
||||
| 网络项 | 配置 | 说明 |
|
||||
| :--- | :--- | :--- |
|
||||
| 图传板 Wi-Fi | 2.4 GHz | 板卡与客户端需处于可互通的局域网 |
|
||||
| 图传板 Wi-Fi | 2.4 GHz | 裁判系统与客户端需处于可互通的局域网 |
|
||||
| 视频与发现 | UDP `5600` | Hello、Subscribe 与 JPEG 分片 |
|
||||
| 装甲板上报 | UDP `5601` | 每 200 ms 广播四路血量 |
|
||||
| 本地界面通道 | 回环 WebSocket + Tauri IPC | JPEG 由 WebView 解码，网络接收线程不做视频解码 |
|
||||
@@ -71,13 +71,13 @@ flowchart LR
|
||||
|
||||
| 模块 | 已有功能 | 使用条件与边界 |
|
||||
| :--- | :--- | :--- |
|
||||
| 图传固件 | VGA 彩色 JPEG、UDP 分片、多端订阅、Wi-Fi 重连、过期帧放弃 | 当前记录约 30 fps；不同网络、板卡与画质下需复测[^performance] |
|
||||
| 图传固件 | VGA 彩色 JPEG、UDP 分片、多端订阅、Wi-Fi 重连、过期帧放弃 | 当前记录约 30 fps；不同网络、裁判系统与画质下需复测[^performance] |
|
||||
| 用户端 | 本队画面、双方装甲条、瞄准器、偏移校准、命中反馈 | 先绑定图传板与装甲板；改绑、切换模式和退出受密码限制 |
|
||||
| 裁判端 | 双路画面、队名编辑、装甲板发现、槽位分配、截图、录制与回放 | 录制需要 ffmpeg；图传槽位可手动指定 |
|
||||
| 装甲板 | 四路受击检测与灯带、整车血量、UDP 上报 | 初始 100 血，每次受击扣 3 点；队伍号在编译期选择 |
|
||||
| 固件维护 | USB 读取设备、检查固件包、选择候选槽位、备份和写后回读 | App 写入与回读已有实机记录；完整分区切换尚未验证 |
|
||||
|
||||
发送端在有限预算内提交当前帧，超时后转向新帧；本地视频通道与 WebView 会放弃滞留超过 100 ms 的旧帧。这个期限约束的是本机积压，**不代表相机到屏幕的端到端延迟**。
|
||||
发送端在限定时间内提交当前帧，超时后转向新帧；本地视频通道与 WebView 会放弃滞留超过 100 ms 的旧帧。这个期限只约束本机积压，**不代表相机到屏幕的端到端延迟**。
|
||||
|
||||
> [!WARNING]
|
||||
> 固件维护会写入设备 Flash。使用前核对芯片、分区和备份，并阅读[已验证与未验证范围](docs/maintenance/firmware.md#已验证--未验证)。ESP32-S3 与 ESP32-C3 的固件不能混用。
|
||||
@@ -86,7 +86,7 @@ flowchart LR
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 无板卡：先看界面
|
||||
### 1. 无裁判系统：先看界面
|
||||
|
||||
安装 Node.js 和 pnpm 后，在仓库根目录执行：
|
||||
|
||||
@@ -96,12 +96,12 @@ pnpm install --frozen-lockfile
|
||||
pnpm dev
|
||||
```
|
||||
|
||||
打开 [用户端预览](http://127.0.0.1:1420/) 或 [裁判端预览](http://127.0.0.1:1420/?preview=referee)。预览由浏览器合成状态和画面，无需 Rust 后端或板卡。
|
||||
打开 [用户端预览](http://127.0.0.1:1420/) 或 [裁判端预览](http://127.0.0.1:1420/?preview=referee)。预览由浏览器合成状态和画面，无需 Rust 后端或裁判系统。
|
||||
|
||||
> [!TIP]
|
||||
> 检查首次启动流程时，可使用 `?preview=first-run` 和 `?preview=password`。需要测试实际接收、重组和录制路径时，使用原生客户端的 `--demo` 模式；两种方式显示的都是合成数据。
|
||||
|
||||
### 2. 连接板卡：运行桌面端
|
||||
### 2. 连接裁判系统：运行桌面端
|
||||
|
||||
先按[客户端说明](docs/desktop/client.md#快速开始)安装宿主平台依赖。Windows x64 需要 Rust stable MSVC、Visual Studio C++ Build Tools、Windows SDK 和 WebView2；录制另需 ffmpeg。
|
||||
|
||||
@@ -141,7 +141,7 @@ pnpm app --target x86_64-unknown-linux-gnu -- --locked --config 'unstable.build-
|
||||
|
||||
</details>
|
||||
|
||||
首次启动选择用户端或裁判端。用户端需要设置现场密码并绑定本车板卡；裁判端自动分配图传槽位，装甲板按上报队伍分配。对应关系不符时，在设置中手动指定。
|
||||
首次启动时选择用户端或裁判端。用户端需要设置现场密码并绑定本车裁判系统；裁判端自动分配图传槽位，并按装甲板上报的队伍分配装甲槽位。对应关系不符时，可在设置中手动指定。
|
||||
|
||||
### 3. 编译图传或装甲固件
|
||||
|
||||
@@ -162,9 +162,12 @@ if (-not (Test-Path -LiteralPath .env)) {
|
||||
Copy-Item -LiteralPath .env.example -Destination .env
|
||||
}
|
||||
# 用编辑器填写 .env 中的 Wi-Fi 配置后再构建。
|
||||
$env:CARGO_TARGET_DIR = 'C:\s3vt'
|
||||
.\scripts\build.ps1 -Package
|
||||
```
|
||||
|
||||
Windows 必须使用可写的短输出目录，且不要与其他项目共用。`esp-idf-sys` 检查完整的构建输出路径，超过 88 字符会报 `Too long output directory`；仓库位于用户目录时，默认的 `target/` 通常会超限。这里将构建缓存放到 `C:\s3vt`，无需移动源码；`subst` 不能绕过该限制。固件 ZIP 仍输出到仓库的 `target/firmware/`。该环境变量仅供固件构建使用，切回桌面端前执行 `Remove-Item Env:CARGO_TARGET_DIR`。
|
||||
|
||||
Linux / macOS（Bash）：
|
||||
|
||||
```bash
|
||||
@@ -246,7 +249,7 @@ cargo +stable test --locked --manifest-path desktop/core/Cargo.toml --target x86
|
||||
cargo +stable check --locked --manifest-path desktop/src-tauri/Cargo.toml --target x86_64-pc-windows-msvc --config 'unstable.build-std=[]'
|
||||
```
|
||||
|
||||
录制相关测试会调用 ffmpeg / ffprobe。主机测试、前端构建通过后，仍需按变更范围检查真实 WebView、板卡与网络行为。
|
||||
录制相关测试会调用 ffmpeg / ffprobe。主机测试、前端构建通过后，仍需按变更范围检查真实 WebView、裁判系统与网络行为。
|
||||
|
||||
</details>
|
||||
|
||||
@@ -261,7 +264,7 @@ node scripts/version.mjs --check
|
||||
|
||||
## 文档与后续工作
|
||||
|
||||
文档沿用 Firefox 仓库的分类与索引思路：根目录保留项目入口和协作约定，详细说明集中到 [`docs/index.md`](docs/index.md)。
|
||||
文档参照 Firefox 仓库的分类与索引方式组织。根目录保留项目入口和协作约定，详细说明从 [`docs/index.md`](docs/index.md) 查阅。
|
||||
|
||||
| 要做什么 | 从哪里开始 |
|
||||
| :--- | :--- |
|
||||
|
||||
Reference in New Issue
Block a user