initial

2025-11-14 16:09:58 +08:00
commit af65c2425d
74 changed files with 14650 additions and 0 deletions
--- a/docs/guides/CUSTOM_PATH_README.md
+++ b/docs/guides/CUSTOM_PATH_README.md
@@ -0,0 +1,110 @@
+# 自定义路径功能 - 快速导航
+
+## 📍 文档位置
+
+所有自定义路径功能的文档已整理到：
+
+```
+docs/custom_path/
+```
+
+## 🚀 快速开始
+
+### 1. 查看文档目录
+```bash
+cd docs/custom_path
+cat README.md
+```
+
+### 2. 推荐阅读顺序
+
+**新手入门（5分钟）：**
+```
+docs/custom_path/FINAL_SUMMARY.md          # 功能总览 ⭐
+docs/custom_path/QUICKSTART_CUSTOM_PATH.md # 快速上手
+```
+
+**QT界面集成（10分钟）：**
+```
+docs/custom_path/apply_qt_modifications.md      # 修改步骤 ⭐
+docs/custom_path/qt_gui_custom_code_snippet.cpp # 代码示例
+```
+
+**深入学习（30分钟）：**
+```
+docs/custom_path/CUSTOM_PATH_GUIDE.md     # 完整教程
+```
+
+## 📦 核心功能
+
+1. **CSV文件加载** - 从外部文件加载任意路径
+2. **样条插值** - 从关键点生成平滑曲线
+3. **路径保存** - 导出路径为CSV格式
+4. **QT界面集成** - 图形化操作
+
+## 🔧 安装
+
+### 自动安装（推荐）
+```bash
+bash docs/custom_path/install_custom_path.sh
+```
+
+### 手动安装
+参考文档：`docs/custom_path/CUSTOM_PATH_GUIDE.md`
+
+## 📖 完整文档列表
+
+访问 `docs/custom_path/README.md` 查看所有文档的详细说明。
+
+## 📁 文件结构
+
+```
+agv_path_tracking/
+├── src/
+│   └── path_curve_custom.cpp       # 核心实现
+├── include/
+│   └── path_curve.h                # 需要添加方法声明
+├── examples/
+│   ├── custom_path.csv             # 示例路径
+│   └── warehouse_path.csv          # 仓库路径
+├── docs/
+│   └── custom_path/                # 📚 所有文档在这里！
+│       ├── README.md               # 文档导航
+│       ├── FINAL_SUMMARY.md        # 功能总览 ⭐
+│       ├── QUICKSTART_CUSTOM_PATH.md
+│       ├── CUSTOM_PATH_GUIDE.md
+│       ├── apply_qt_modifications.md ⭐
+│       ├── QT_GUI_CUSTOM_PATH_GUIDE.md
+│       ├── qt_gui_custom_code_snippet.cpp
+│       ├── install_custom_path.sh
+│       ├── path_curve.h.patch
+│       └── CUSTOM_PATH_IMPLEMENTATION_SUMMARY.txt
+└── CUSTOM_PATH_README.md           # 本文件（快速导航）
+```
+
+## ✨ 快速示例
+
+```cpp
+// 1. 加载自定义路径
+PathCurve path;
+path.loadFromCSV("examples/custom_path.csv");
+
+// 2. 使用路径
+PathTracker tracker(agv);
+tracker.setReferencePath(path);
+tracker.generateControlSequence("pure_pursuit", 0.1, 20.0);
+```
+
+## 🎯 使用场景
+
+| 场景 | 查看文档 |
+|-----|---------|
+| 快速试用 | `docs/custom_path/QUICKSTART_CUSTOM_PATH.md` |
+| QT界面 | `docs/custom_path/apply_qt_modifications.md` |
+| 深入学习 | `docs/custom_path/CUSTOM_PATH_GUIDE.md` |
+| 安装配置 | `docs/custom_path/install_custom_path.sh` |
+| 完整总览 | `docs/custom_path/FINAL_SUMMARY.md` ⭐ |
+
+---
+
+**开始使用**: `cd docs/custom_path && cat README.md`