【开源】Groot2风格行为树可视化监控软件,能展示20个节点以上

前言

项目地址:https://github.com/riyuexingchennnn/BehaviorTreeMonitor

在ROS2机器人项目里,行为树是非常常见的任务组织方式。实际调试时,我们经常需要实时看到每个节点的状态变化,尤其是 subtree 内部节点。

我这次开源了一个基于 BehaviorTree.CPP Groot2 协议的监控工具,目标很直接:

  • 实时可视化行为树状态
  • 能稳定展示 20 个以上节点
  • 对 subtree 内部节点也能完整显示

项目效果


核心能力

1. Groot2 协议兼容

项目通过 BT.CPP 的 Groot2Publisher 对接,能够直接接入已有行为树执行器,不需要改动太多业务代码。

2. 大节点量可视化

实际可展示 20+ 节点状态,包含 subtree 内部节点,适合中等复杂度以上的行为树调试。

3. 桌面应用 + Web 前端的混合架构

使用 Python 负责协议桥接和桌面承载,使用 Vue 3 + TypeScript 负责交互可视化,兼顾开发效率与可维护性。

架构设计

text 复制代码
Python (PySide6 + aiohttp)          Vue 3 + TypeScript
┌─────────────────────┐           ┌──────────────────┐
│  Qt WebEngineView   │──HTTP──►  │  前端 (dist/)     │
│  aiohttp Server     │◄─WS───►   │  WebSocket 客户端 │
│  ZMQ Bridge         │◄─ZMQ──►   │                  │
└─────────────────────┘           └──────────────────┘
						    ▲
						    │ ZMQ REQ/REP
						    ▼
					    BT.CPP 执行器
					    (Groot2Publisher)

数据流可以理解为三层:

  • BT.CPP 执行器通过 ZMQ 与 Python 桥接层通信
  • Python 侧通过 aiohttp 提供 WebSocket,将状态推给前端
  • Qt WebEngineView 加载前端页面,形成完整桌面体验

项目结构

text 复制代码
BehaviorTreeMonitor/
├── main.py                 # 入口
├── bt_monitor/
│   ├── protocol.py         # BT.CPP Groot2 协议
│   ├── server.py           # aiohttp WebSocket/ZMQ 桥接
│   └── app.py              # Qt WebEngine 窗口
├── frontend/               # Vue 3 + TypeScript
│   ├── src/
│   │   ├── App.vue
│   │   ├── components/
│   │   ├── composables/
│   │   ├── stores/
│   │   ├── types/
│   │   └── styles/
│   └── ...
└── bt_monitor.spec         # PyInstaller 配置

快速开始

环境

  • uv(Python 包管理)
  • Node.js 18+
  • pnpm

安装依赖

bash 复制代码
# Python 依赖
uv sync

# 前端依赖
cd frontend && pnpm install

本地运行

bash 复制代码
# 先构建前端
cd frontend
pnpm build

# 回到项目根目录后启动
uv run python main.py

构建发布

bash 复制代码
# 1. 构建前端
cd frontend && pnpm install && pnpm build

# 2. PyInstaller 打包
uv run --group dev pyinstaller --clean --noconfirm bt_monitor.spec

输出文件位于:dist/BehaviorTreeMonitor

下载使用

如果你不想自己构建,可以直接在 Release 页面下载编译版本:

https://github.com/riyuexingchennnn/BehaviorTreeMonitor/releases

Ubuntu 下首次运行需要先给可执行文件增加权限。

bash 复制代码
sudo chmod +x BehaviorTreeMonitor.behaviortreemonitor

结语

这个项目的初衷是解决Groot2监控行为树超过20个节点需要license的问题。如果本项目对你有用,欢迎在 GitHub 上点个 Star,或者在评论区留言交流!

相关推荐
奥列格1 天前
ARTCRAFT系列软件简单试用手记1
开源软件
wangxiaoxuan2171 天前
机器人软件系统全景:感知、定位、规划、控制与决策如何协作
机器人·科沃斯八界
wangxiaoxuan2171 天前
理解 MoveIt:机器人状态、规划场景和规划流水线
机器人·科沃斯八界·机械臂控制
蓝天居士1 天前
ROS2从入门到精通(10)
机器人·ros·ros 2
svyee1 天前
Win11 砍掉的磁贴,我用一个周末写了回来(1.3MB 开源了)
开源软件·个人开发·ai编程
wangxiaoxuan2172 天前
SLAM 的基本结构:前端、后端、回环与地图优化
前端·机器人·科沃斯八界
鲁邦通物联网2 天前
机器人梯控状态模型与反馈可靠性验证方法
机器人·巡检机器人·机器人梯控·agv梯控·非侵入式采集·机器人乘梯·机器人自主乘梯
wangxiaoxuan2172 天前
地图表示怎么选:栅格、点云、体素、TSDF 与 ESDF
机器人·slam·机器人导航·科沃斯八界
鲁邦通物联网3 天前
既有电梯机器人梯控选型:现场可行性评估方法
机器人·巡检机器人·机器人梯控·agv梯控·非侵入式采集·机器人乘梯·机器人自主乘梯
wangxiaoxuan2173 天前
TF2 的原理与使用:把坐标、运动和观测时间一起算清楚
计算机视觉·机器人·科沃斯八界