[docs] 全面校准项目说明与跨平台资源边界

2026-07-27 19:17:19 +08:00
parent 117b02bec7
commit fbb396708c
37 changed files with 131 additions and 103 deletions
@@ -1,6 +1,6 @@
-# ROS2 C++ Sim2Real 运动控制栈 - 部署指南
+# ROS 2/C++ Sim2Real v3 比赛部署指南

-本工作区提供了一个自包含、独立的 C++ ROS2 Humble 实现，用于在 Jetson Orin 目标机上部署轮腿四足机器人控制策略。
+本工作区保存最终比赛 ROS 2 Humble/C++ 部署主体。比赛使用的 Odin `1hao.bin` 未随备份归档，TensorRT engine 也与比赛机环境绑定，因此默认 `relocal` 闭环不是开箱即用；缺少真实地图时应按主 README 使用纯里程计模式。

 ---

@@ -2,9 +2,9 @@

 本目录由原始 `sim2real_ros2_v2(last_not_slalom_1050)` 整理而来，正式作为 ROS 2/C++ 第三版（v3），对应 RC_WheelLeg 在 RoboCon 仿生足式障碍赛使用的最终部署栈。`1050` 是比赛得分，不是模型编号；比赛 Rough 策略为 `model_6800.onnx`。

-该里程碑对应重排主线的 `v1.0.0`，是 1050 分比赛最终版本。训练架构和策略来源见 `v0.6.0`，比赛 Rough 模型首次归档见 `v0.8.0`，导航打点与路线演进见 `v0.8.1`，ROS 2 迁移过程见 `v0.10.0`～`v0.12.0`。
+比赛代码快照首次归档于 `v1.0.0`，当时暂存于无后缀目录；`v1.1.0` 恢复无后缀初版并将本工程规范为 v3。训练架构和策略来源见 `v0.6.0`，比赛 Rough 模型首次归档见 `v0.8.0`，导航打点与路线演进见 `v0.8.1`，ROS 2 迁移过程见 `v0.10.0`～`v0.12.0`。

-当前 `main` 的 `v1.0.1` 只是在 `v1.0.0` 基础上补充比赛机器人图片和比赛视频，本目录代码仍以 `v1.0.0` 为比赛部署基线。
+`v1.0.1` 只在比赛代码快照基础上补充机器人图片和比赛视频，没有改变本目录运行逻辑。

 ## 系统闭环

@@ -1,5 +1,7 @@
 # 迁移计划

+> 版本范围：最终比赛 ROS 2 v3。本文继承自迁移阶段，用于解释架构来源，不是比赛部署资产完整性或新环境复现证明。
+
 ## Phase 1: 硬件核心迁移 ✅ 已完成

 将当前高频热路径从 Python 迁出。
@@ -39,11 +41,7 @@

 ## Phase 3: ROS 2 系统集成 ✅ 已完成

-参考的源项目：
-
- `00_ reference/odin_ros_driver`
- `00_ reference/EDULITE_A3/el_a3_ros`
- `00_ reference/rl_sar`
+参考过的外部项目包括 Odin ROS 驱动、EDULITE A3 ROS 工程和 RL-SAR；外部参考目录不属于本仓库公开内容。

 交付物：

@@ -77,4 +75,4 @@
 | 里程计中继 | `odom_relay_node` | /odin1/odometry → /odom + odom→base_link TF |
 | 导航栈 | Nav2 全套节点 | AMCL + costmap + DWB + Navfn + BT + lifecycle |
 | 传感器驱动 | `odin_ros_driver` | IMU + 点云 + 里程计原始发布 |
-| 点云转换 | `pointcloud_to_laserscan` | /odin1/cloud_slam → /scan (供 AMCL 使用) |
+| 点云转换 | `pointcloud_to_laserscan` | 外部 ROS 包；/odin1/cloud_slam → /scan（供 AMCL 使用） |
@@ -4,6 +4,8 @@

 `1hao.pcd` 是 `v0.8.1` 导航工具中同一份抽样点云，包含 199,215 点、大小 9,876,010 字节，SHA-256 为 `48B231C52BECA51316F352300C8B2046133E92359E0855227D93DEB0D927AD34`。它用于本地规划和路线显示，不替代原始高密度点云。

+上述大小和 SHA-256 按 Git 中保存的 LF 字节计算；根目录 `.gitattributes` 禁止对 `*.pcd` 做跨平台换行转换。
+
 ## 缺失的 Odin 重定位地图

 比赛配置需要 Odin 专用二进制地图 `1hao.bin`，但源备份没有该文件。源目录中另有两个名称和时间不同的 `.bin`，无法证明它们就是比赛使用地图，因此没有复制或重命名。