组合方案

组合方案（Recipe）是一组配合使用的插件，用 uBot Manager 的「应用 Recipe」对话框可以一次装好。

每个组合适合什么场景，见 选择组合；下文只讲在 uBot Manager 里怎么用。

步骤

1. 打开对话框

   点标题栏的「Recipe」，打开「应用 Recipe」。

2. 选组合

   在左侧的列表里选一个组合。窗口右侧显示它的名称、说明和包含的插件。

3. 选项目

   「项目」里是要应用到的 .uproject：直接输入路径，或点右边的文件夹按钮（「浏览…」）选择。「引擎」一行显示该项目使用的 UE 版本。

4. 调整插件

   在「Package」列表里勾选要包含的插件。UBotCore 固定勾选，标着「必需」；可以在组合之外多选别的插件，也可以去掉组合里的某一个。

5. 看环境要求

   「环境要求」检查 Visual Studio 2022 和 Git 是否存在，结果是「已找到」或「未找到」。

6. 查看更改

   点「查看更改…」，打开「应用更改」对话框，里面是普通的安装或启用计划，后面的步骤见 安装、更新、移除插件。所有插件都已安装并启用时，对话框提示「无需更改」。

图中是示例数据，组合的可用状态和插件版本不代表当前的索引。

关键属性

对话框里的项：

项	作用
左侧列表	索引里的组合，以及你自己保存的组合；含有规划中插件的组合显示为灰色，带「规划中」标记
「项目」	要应用到的项目；写的是另一个项目的路径时，先打开那个项目
「引擎」	该项目使用的 UE 版本
「Package」	组合包含的插件和它们的版本；规划中的插件不能勾选
「环境要求」	Visual Studio 2022 和 Git；组合声明了 ROS 桥接时，还会列出 ubot_ros_bridge，它在 ROS 端运行，这里不检查

索引里的组合如下，含有规划中插件的标着「规划中」：

组合	用途	包含
仅传感器	只在蓝图里使用传感器数据。	uBotCore、uBotSensor
ROS 2 传感器	把传感器、TF 和 /clock 发布到 ROS 2。	uBotCore、uBotSensor、uBotROS
ROS 地面机器人规划中	地面车辆接入 Nav2 和 SLAM。	uBotCore、uBotSensor、uBotROS、uBotVehicles规划中
大模型无人机规划中	大模型通过 MCP 控制无人机。	uBotCore、uBotSensor、uBotAerial、uBotMCP规划中
烟雾作战演示规划中	带烟雾干扰的作战场景。	uBotCore、uBotSensor、uBotEnvironment规划中、uBotCombat规划中
自定义	从 UBotCore 开始，其余自己挑。	uBotCore

输出与事件

应用 Recipe 只做两件事：

• 安装缺少的插件，装最新版本。
• 启用已安装但被禁用的插件。

已安装的版本不会被更新，别的插件也不会被禁用。任务出现在「任务」视图里，标题是「应用 Recipe … · 项目名」。

要把项目现在的插件组合存下来：在「应用更改」对话框里勾选「保存为 Recipe」，填「Recipe 名称」（默认是项目名）。任务成功后，项目里所有已启用的 uBot 插件会存成你自己的组合；同名的会替换原来的。它出现在左侧列表里，命令行的 ubot recipes 也会列出它。

注意事项

• 规划中的插件不能勾选，所以含有它们的组合只会处理其余的插件。命令行的 ubot recipe 会直接拒绝这样的组合。
• 从源码安装的插件要编译，需要 Visual Studio 2022；全部使用预编译包的安装不需要它。
• 组合只管安装和启用。要更新、禁用或卸载，用「Package」视图，见 安装、更新、移除插件。

相关参考

• 选择组合：各组合适合的场景。
• 安装、更新、移除插件：「应用更改」对话框和任务。
• 命令行 ubot：用 ubot recipes 和 ubot recipe 应用组合。