sloray
054379dc64
- 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。未执行实机烧录。
45 lines
3.1 KiB
Markdown
45 lines
3.1 KiB
Markdown
# RMIC::2026 文档
|
||
|
||
首次使用可从入门文档开始，遇到问题时再查阅硬件、实现说明和测试记录。命令默认从仓库根目录执行；需要切换目录时会另行注明。
|
||
|
||
项目概览与架构图见 [README](../README.md)，工具链、验证命令和仓库协作约定见 [AGENTS](../AGENTS.md)。
|
||
|
||
## 入门与使用
|
||
|
||
- [图传固件入门](setup/firmware.md)：硬件要求、Rust / ESP-IDF 环境、参数、编译与烧录。
|
||
- [桌面客户端](desktop/client.md)：用户端与裁判端、配置、密码、录制、演示与浏览器预览。
|
||
- [固件维护](maintenance/firmware.md)：USB 更新、固件包、候选槽位、备份与校验。
|
||
- [故障排查](testing/troubleshooting.md)：工具链、网络、相机与图传问题。
|
||
|
||
## 开发与源码说明
|
||
|
||
- [开发与验证](development/firmware.md)：镜像导出、主机测试、构建缓存与探测脚本。
|
||
- [版本维护](development/versioning.md)：Conventional Commits、版本计算与生成文件。
|
||
- [图传板硬件](hardware/camera.md)：引脚、PSRAM、分区、故障 Flash 与驱动补丁。
|
||
- [装甲板](hardware/armor.md)：接线、受击规则、上报、构建与实现要点。
|
||
- [UDP 协议](protocol/udp.md)：线路格式、版本通告、帧重组与拒收条件。
|
||
|
||
## 测试与排查记录
|
||
|
||
以下记录各自对应特定配置、裁判系统和观察时段，不能把不同轮次的数字当作同一配置下的结果。
|
||
|
||
- [最新帧与阻塞恢复](testing/realtime.md)：发送期限、本地积压清理及五分钟观察。
|
||
- [功率、距离与拥塞](testing/power.md)：15 dBm 回退及先前功率对照。
|
||
- [帧率与延迟](testing/latency.md)：约 30 fps 配置、Wi-Fi 重连和标记回显测量。
|
||
- [持续运行](testing/stability.md)：彩色、曝光、调度及历史长测。
|
||
- [早期性能排查](testing/performance.md)：保留 TUN 的短时对照与参数选择。
|
||
|
||
## 发布记录与提案
|
||
|
||
- [改动记录](releases/changelog.md)：由 Git 历史生成；[JSON](releases/changelog.json)供程序读取。
|
||
- [早期人工记录](releases/changelog-legacy.md)：自动版本机制建立前的记录。
|
||
- [比赛控制与直播提案](design/match-and-broadcast.md)：尚未实现、仍需确认的需求。
|
||
|
||
## 文档维护
|
||
|
||
本仓库参考 [Firefox 文档首页](https://github.com/mozilla-firefox/firefox/blob/main/docs/index.md)，按入门、开发、源码、测试和发布分类，通过索引连接各主题。文档统一使用 Markdown，不引入 Firefox 的整套文档构建工具。
|
||
|
||
除 `README.md` 和 `AGENTS.md`（或 `Agents.md`）外，项目说明集中放在 `docs/`。根目录 README 介绍项目并链接到文档；子项目 README 保留简短入口。第三方组件的 README、许可证、构建文件、运行时配置和测试数据保留各自位置。
|
||
|
||
新增文档时，先选择对应的主题目录，再补充本页链接。迁移文档时，同步修改相对链接、标题锚点与生成脚本。已被实现取代或已放弃的方案可以删除，历史仍可从 Git 查阅。保留实验记录时需写明条件、日期与验证范围，提案需标注状态。
|