┌─────────────────┐
│   cpp_tools     │  GitHub 仓库
│   (本仓库)      │  https://github.com/wangyendt/cpp_tools
└────────┬────────┘
         │
         │ git clone --sparse
         │
         ▼
┌─────────────────┐
│   gettool.py    │  下载和编译工具
│                 │  位于 wayne_algorithm_lib/bin/
└────────┬────────┘
         │
         │ 1. sparse checkout 指定工具
         │ 2. 可选运行 cmake && make
         │ 3. 复制源码或 lib/ 到目标目录
         │
         ▼
┌─────────────────┐
│  pywayne/*/lib  │  Python 包装类的本地扩展目录
│  或用户指定路径 │  import butterworth_filter
└─────────────────┘

your_tool_name/
├── CMakeLists.txt              # CMake 配置（自包含版本）
├── your_tool_pybind.cpp        # pybind11 绑定代码
├── example.py                  # 示例和测试代码（必须包含自动编译）
└── src/                        # C++ 源代码（必须在此目录）
    ├── YourClass.h             # 头文件
    └── YourClass.cpp           # 实现文件

我想在 cpp_tools 仓库中创建一个新的 C++ 工具，并通过 pybind11 提供 Python 接口。

**工具信息：**
- 工具名：<your_tool_name>
- 分类：<dsp/cv/optimization/utils>
- 功能：<简要描述功能>
- 核心算法：<关键算法或公式>

**必须满足的要求：**

1. **目录结构**（必须遵循）：

<category>/<your_tool_name>/
├── CMakeLists.txt
├── <your_tool_name>_pybind.cpp
├── example.py
└── src/
    ├── YourClass.h
    └── YourClass.cpp

2. **CMakeLists.txt 配置**：
   - 从 `cmake/CMakeLists_standalone.txt` 复制模板
   - 修改项目名为 `<category>_<your_tool_name>`
   - 修改静态库名为 `<category>_<your_tool_name>`
   - 修改 Python 模块名为 `<your_tool_name>`
   - 源文件必须在 `src/` 目录下
   - 完成后运行 `python cmake/cmake_manager.py check` 验证

3. **C++ 代码**（必须在 src/ 目录）：
   - 实现高性能算法
   - 提供清晰的接口
   - 使用 std::vector 或 Eigen 处理数据

4. **pybind11 绑定**：
   - 文件名：`<your_tool_name>_pybind.cpp`
   - 模块名：`PYBIND11_MODULE(<your_tool_name>, m)`
   - 包含必要的 pybind11 头文件（stl.h, eigen.h 等）
   - 绑定所有公共接口

5. **example.py**（必须包含以下部分）：

   - 自动编译逻辑：`def build()` + `subprocess.run(["cmake", ...])`
   - 导入模块：sys.path.append('lib') + import
   - 功能测试
   - 性能对比（与 Python/NumPy/SciPy 等价实现对比）
   - 输出结果

6. **注册工具**：
   - 在 `name_to_path_map.yaml` 中添加 `path/buildable/installable` 对象配置

**参考示例：**
请参考 `dsp/butterworth_filter/` 的完整实现，它是一个标准的工具示例。

开始实现吧！

我有一个现有的 C++ 类/库，想集成到 cpp_tools 仓库并提供 Python 接口。

**现有代码：**
<粘贴你的 C++ 代码或描述>

**目标：**
1. 将代码整合到 cpp_tools 的标准结构中
2. 创建 pybind11 绑定
3. 编写 example.py 展示功能
4. 与 Python 等价实现进行性能对比

**必须遵循的规范：**
- 源代码放在 `src/` 目录
- 使用 `cmake/CMakeLists_standalone.txt` 模板
- example.py 包含自动编译逻辑
- 完成后用 `python cmake/cmake_manager.py check` 验证

**参考示例：**
- 完整实现：dsp/butterworth_filter/
- CMakeLists.txt：cmake/CMakeLists_standalone.txt
- pybind11 绑定：butterworth_filter_pybind.cpp
- example.py：包含自动编译、测试、性能对比

开始移植吧！

我想为 cpp_tools 中的现有工具添加新功能。

**工具路径：** `<category>/<tool_name>/`

**新功能：**
<描述要添加的功能>

**任务：**
1. 修改 `src/` 下的 C++ 代码
2. 更新 pybind11 绑定
3. 在 example.py 中添加新功能的测试
4. 确保向后兼容

**验证流程：**
1. cd <category>/<tool_name>/
2. python example.py
3. 确保所有功能测试通过

开始修改吧！

我想优化 cpp_tools 中某个工具的性能。

**工具：** `<category>/<tool_name>/`

**当前性能：** <描述当前性能指标>

**优化目标：**
- [ ] 减少内存分配
- [ ] 使用 SIMD 指令
- [ ] 并行化计算
- [ ] 算法优化

**要求：**
1. 修改 C++ 实现
2. 在 example.py 中添加性能对比
3. 确保正确性（精度测试）
4. 文档化性能提升

开始优化吧！

cpp_tools/
├── cmake/                              # CMake 工具和模板
│   ├── CMakeLists_standalone.txt      # 新项目模板（必须使用）
│   ├── cmake_manager.py               # 自动化管理工具
│   └── README.md                      # CMake 详细文档
│
├── dsp/                               # 信号处理工具
│   ├── butterworth_filter/            # 标准示例 ✨
│   │   ├── CMakeLists.txt            # 自包含配置
│   │   ├── butterworth_filter_pybind.cpp
│   │   ├── example.py                # 自动编译 + 测试
│   │   ├── src/
│   │   │   ├── butterworth_filter.h
│   │   │   └── butterworth_filter.cpp
│   │   └── lib/                      # 编译输出（自动生成）
│   │       └── butterworth_filter.cpython-*.so
│   │
│   └── sliding_window/               # 另一个示例
│       ├── CMakeLists.txt
│       ├── sliding_window_dsp_pybind.cpp
│       ├── example.py
│       └── src/
│           ├── MKAverage.h
│           ├── MKAverage.cpp
│           ├── WelfordStd.h
│           └── WelfordStd.cpp
│
├── cv/                               # 计算机视觉工具
│   ├── apriltag_detection/
│   └── camera_models/
│
├── visualization/                    # 可视化工具
│   └── pangolin_viewer/
│
├── install_scripts/                  # 依赖安装脚本
│   ├── install_pybind11.sh
│   ├── install_eigen.sh
│   └── ...
│
├── name_to_path_map.yaml            # gettool.py 配置（必须更新）
├── generate_name_to_path_map.py     # 旧版生成脚本，升级前不要覆盖正式 YAML
├── README.md                        # 本文件
└── LICENSE

CMake Error: Could not find Python

ImportError: dlopen(...): symbol not found

Tool 'your_tool' not found

fatal error: 'YourClass.h' file not found