← 返回项目库

ROSView 机器人数据可视化工具

在浏览器本地查看 MCAP、ROS bag、ROS 2 db3、HDF5 与 BVH 机器人数据的中文可视化工具。

ROSView 是一套无需把数据上传云端的机器人与具身智能数据可视化应用。它在浏览器内通过 Web Worker 解析 MCAP、ROS1 bag、ROS2 db3、HDF5 和 BVH 文件,提供话题浏览、图像面板、三维场景、时间序列、姿态与骨骼显示、播放控制和可保存布局。收录包保留完整源码、锁定依赖和 MIT 许可证,并附带可离线复现的微型测试数据,适合社群学习、数据格式研究与前端可视化二次开发。

真实界面

项目截图

共 4 张

中文数据导入首页
MCAP 话题与三维数据面板
可导入导出的工作区布局
机器人数据时间轴播放

Capabilities

核心功能

MCAP、ROS1 bag、ROS2 db3、HDF5 与 BVH 多格式导入
浏览器本地解析,记录文件无需上传云端
ROS 话题、消息类型、频率与数量浏览
图像、三维场景、姿态、骨骼与时间序列面板
播放、暂停、拖动、倍率、帧率与循环控制
工作区布局导入、导出、保存和重置
中文、英文和日文界面切换
可嵌入其他 React 应用的组件库构建

适用场景

在社群课程中演示 ROS 记录文件结构和话题数据
离线检查机器人实验、相机、关节与姿态数据
研究 MCAP、bag、db3、HDF5 与 BVH 的浏览器解析方案
为具身智能平台二次开发数据回放与三维面板

适合谁

机器人开发者、ROS 学习者、具身智能研究人员、数据工程师和可视化前端开发者。

商业化思路

用于技术社群学习、机器人数据研究、实验记录查看、格式兼容性验证和可视化组件二次开发。

你会拿到什么

  • 固定提交的完整 TypeScript / React 源码与 package-lock.json
  • 可直接加载的 MCAP、HDF5、BVH 微型测试数据
  • 四张真实中文运行界面截图
  • MIT 许可证、NOTICE、构建与生产依赖安全验收记录

部署流程

  1. 1解压源码,在 Node.js 22+ 环境执行 npm ci 安装锁定依赖。
  2. 2执行 npm run build 生成 dist 生产目录。
  3. 3用任意静态 Web 服务器托管 dist,并访问 /?lang=zh 打开中文界面。
  4. 4可访问 /?url=/examples/test_5s.mcap&lang=zh 直接复现示例数据面板。

真实验证结果

Node.js 22.23.1 环境下 npm ci 成功安装 507 个依赖,TypeScript 与 Vite 生产构建成功;npm audit --omit=dev 为 0 个生产依赖漏洞。使用真实 Chromium 加载中文首页与随包 MCAP 数据,话题列表、三维面板、布局菜单和播放时间轴均可见且可交互;四张 1440×960 截图经人工视觉检查,没有 404、登录页、坏图、横向溢出或重复画面。

部署前须知

首次安装的开发工具链审计显示 9 项告警(2 low、1 moderate、6 high),均不属于生产依赖,生产依赖审计为 0;首页远程样例卡片标题为英文,可切换的核心操作界面已提供中文。

部署难度

简单

最低配置

运行成品只需现代 Chromium、Firefox 或 Safari 浏览器与静态 Web 服务器;源码构建需要 Node.js 22+。

开源许可证

MIT License

最后验证

2026-08-21

技术栈

React 19TypeScriptVite 8Three.js / React Three FiberMCAP / ROS bag / SQLite WASM / HDF5 WASMWeb Workers

授权说明

上游源码提供 MIT LICENSE 与 NOTICE;源码包原样保留。项目依赖及解析器分别适用其各自许可证。