docs(nav): 阅读路径导航 + 数字统一

This commit is contained in:
xs
2026-08-04 16:10:27 +08:00
parent 549d6b337e
commit 6338f3d36a
95 changed files with 3838 additions and 1260 deletions
+33 -16
View File
@@ -51,9 +51,9 @@
## Level 1: ROS2 基础机制 (Foundation)
> **核心目标**: 完整理解 ROS2 的 12 大基础机制,能独立写节点 + launch 文件 + 自定义接口 + 生命周期管理。
> **核心目标**: 完整理解 ROS2 的 15 大基础机制,能独立写节点 + launch 文件 + 自定义接口 + 生命周期管理。
### 12 大机制清单
### 15 大机制清单
| # | 机制 | 当前包 | 文档 |
|---|---|---|---|
@@ -93,20 +93,23 @@
### Level 1 测试覆盖
```
py_pubsub 4 pytest
cpp_pubsub 2 gtest
py_srv 1 pytest
py_action_demo 1 pytest
cpp_robot_tf2 2 gtest
py_vision_demo 2 pytest
bringup 6 launch
py_params 3 pytest ⭐(新增)
cpp_custom_interface 3 gtest ⭐(新增)
py_lifecycle_composable 3 pytest ⭐(新增)
cpp_qos_demo 3 gtest ⭐(新增)
py_overlay_dds 2 pytest ⭐(新增)
py_pubsub 11 pytest ✅
cpp_pubsub 3 gtest ✅
py_srv 7 pytest ✅
py_action_demo 5 pytest ✅
cpp_robot_tf2 4 gtest ✅
py_vision_demo 13 pytest ✅
bringup (launch 聚合,无单测)
py_params 16 pytest ⭐(新增)
cpp_custom_interface 3 gtest ⭐(新增)
py_lifecycle_composable 6 pytest ⭐(新增)
cpp_qos_demo 4 gtest ⭐(新增)
py_overlay_dds 6 pytest ⭐(新增)
总计: 32 用例, 目标 100% 通过
总计: **78 用例**(pytest 65 + gtest 13),目标 100% 通过
> 注:78 用例是当前仓库实测数(`colcon test` 结果),与 README/AGENTS 一致。
> 上述表格列是"实测用例数"(非"测试文件数")。
```
---
@@ -340,4 +343,18 @@ py_overlay_dds 2 pytest ⭐(新增)
---
**继续**: 看 `doc/01-quickstart.md` 跑通第一个 demo → `doc/10-concepts.md` 理解 ROS2 概念 → `doc/15-params.md` Level 1 深度内容。
**继续**: 看 `doc/01-quickstart.md` 跑通第一个 demo → `doc/10-concepts.md` 理解 ROS2 概念 → `doc/15-params.md` Level 1 深度内容。
---
---
## 📖 阅读路径导航
> 💡 这是仓库 `doc/` 下所有文档的推荐阅读顺序。[返回 README 总导航](../README.md#-23-篇文档怎么读)
>
> ⏱ **本文预计阅读时间**: 15 分钟
> 📍 **当前位置**: 第 2 / 24 篇
-**上一篇**: [项目架构 + 设计取舍](../00-overview.md)
-**下一篇**: [5 分钟跑通 Hello World](../01-quickstart.md)