路径排错实验库

本章配合 examples/docs_path_lab 使用，帮助用户在每个阶段快速确认路径是否正确。

实验库位置

仓库内位置：

roplat/
└─ examples/
   └─ docs_path_lab/
      ├─ Cargo.toml
      ├─ README.md
      └─ src/main.rs

运行方式

在你的业务项目根目录执行：

cargo run --manifest-path <roplat>/examples/docs_path_lab/Cargo.toml

它会检查当前目录关键路径，输出 OK 或 MISSING。

会检查什么

1. Rust 基础阶段路径：src/msg.rs、src/nodes.rs
2. C++ 扩展阶段路径：build.rs、cpp/roplat_gen
3. Python 扩展阶段路径：py/roplat_gen、py/py_planner.py

常见困境与对应策略

1. 输出大量 MISSING

说明你通常不在项目根目录执行命令。先切换目录再跑。

1. 只有 C++ 路径缺失

先确认是否已执行 cargo build 触发生成流程。

1. 只有 Python 路径缺失

先确认是否已添加 Python 节点镜像定义并再次构建。

建议流程

每完成一章快速开始内容，就运行一次该实验库，避免问题累计到最后。