项目要闻:11月9日至15日
- 来源: Open Source Robotics
- 发布日期: 2026-11-16
- 类别: upstream
mjlab 的全新安装会弄坏 MuJoCo,MuJoCo 4.0.1 修复了 4.0.0 的求解器缺陷,Rerun 0.43 和 Strands Robots 0.6.0 会破坏现有代码,uni-robot-agent 更改了协议。
mjlab
!mjlab
- 1.6.1 版修复了全新安装后 MuJoCo 损坏的问题。查看器包 mjviser 的新版本(0.0.17)改为依赖 mujoco-core 而不是 mujoco,因此 pip 和 uv 在固定的 mujoco 3.11 旁边又装上了 mujoco-core 4.0.1,两者写入同一个 mujoco/ 文件夹。 - 较早的 mjlab 版本只需在依赖中加入 "mjviser<0.0.17" 即可修复;1.6.1 也设置了同样的上限。发布说明 - 为何重要:如果你本周安装或重建了 mjlab 环境,而 MuJoCo 行为异常或无法导入,原因是这个冲突,而不是你的代码;请加上版本上限,或升级到 1.6.1,并在干净的环境中重新安装。
MuJoCo
!MuJoCo
- 4.0.1 版修复了 4.0.0 中引入的稀疏 Cholesky 分解缺陷。当约束雅可比矩阵稀疏时,牛顿求解器得到了错误的海森矩阵因子,表现为收敛缓慢、加速度错误和发散。 - 在 4.0.0 的 macOS 和 Linux 压缩包中,只要有一个动态库加载失败(USD 解码器插件),simulate 就会在启动时中止;现在会跳过它并给出警告。发布说明 - 为何重要:如果你在 MuJoCo 4.0.0 上运行过模型,并看到求解器发散或加速度看起来不对,请先更新到 4.0.1 并重新运行,再去相信这些结果或用它们训练。
Rerun
!Rerun
- 用 JavaScript 嵌入 Web 查看器,或在 Rerun Hub 上设置存储的代码,在 0.43 中会失效:JavaScript API 现在使用 camelCase,object_store_config 改名为 storage_location(Python 和 Rust 中为 StorageLocationAlias)。0.43.1 版重新接受 snake_case 的 Web 查看器选项。 - 0.43 的新功能:可以在查看器中编辑网格地图和体数据的平移量以及体素大小;内存限制现在遵守 Linux 的 cgroup 限制;0.43.2 修复了点云和深度云在 Safari 中不显示的问题。发布说明 - 为何重要:如果你用 JavaScript 嵌入 Rerun 的 Web 查看器,或在 Rerun Hub 上配置存储,请使用 0.43.1 或更高版本并按迁移指南操作;如果你在容器中运行 Rerun,它的内存上限现在跟随容器的限制,而不是整台机器的限制。
Strands Robots
!Strands Robots
- 0.6.0 版围绕三个类重写:Simulation(运行在 MuJoCo 或 GPU 引擎上的世界)、Robot 和 Policy。同一份代码现在可以驱动仿真机器人、真实机器人或另一台机器上的机器人,76 个机器人预设可按名称加载。 - 0.5.x 的 API 已被移除。来自智能体的超出范围的指令现在会报错并被拒绝,而不是被截断。发布说明 - 为何重要:如果你为 Strands Robots 0.5.x 写过代码,在迁移之前它无法在 0.6.0 上运行,所以请先固定在 0.5.x;如果由智能体驱动你的机器人,原来被悄悄截断的地方现在会出现拒绝。
uni-robot-agent
!uni-robot-agent
- 0.2.0 版新增了由四个工具(move、hold、capture_scene、finish)组成的“简洁模式”、一个可选的窗口(会丢弃观测历史中较旧的内嵌图像)、离线的 doctor 命令,以及针对 ARX ONE 的真实机器人集成。 - 它升级到环境协议 4、工具模式 8 和 actor HTTP 协议 v3;旧服务不再兼容。原生环境需要单独安装 uni-robot-agent-runtime 0.2.0,这两个包绝不能放在同一个 Python 环境里。发布说明 - 为何重要:如果你把 uni-robot-agent 的客户端和环境服务运行在不同的机器上,请一起升级,否则它们将无法通信;如果把两个包装进同一个环境,该环境会被破坏。
AI Worker
!AI Worker
- 2.3.3 版通过可配置的心跳超时检测主臂断开,在默认方式的遥操作停止时把控制权交还给外部控制,在开始遥操作之前等待初始姿态完成,并在关节模式和末端执行器模式下都发布夹爪动作。发布说明 - 2.3.3 之后,主分支把机器人 F1 和 F2 重命名为 W1 和 W2:启动文件、配置文件夹和 MoveIt 的 model:= 参数(w1、w2)都会改变。变更内容 - 为何重要:如果你对 AI Worker 做遥操作,断开的主臂现在会被检测到,超时可配置;另外,凡是写了 f1 或 f2 的脚本或启动命令,在你升级到包含这次重命名的版本后都会失败。
Microduck
!Microduck
- 0.21.0 版允许你用 NFC 标签碰一下机器人的头来切换模式:行走、轮滑、跟随激光、足球,以及一种自主模式——鸭子会四处闲逛、打盹、追逐激光点、玩球,并为房间建图。robotctl nfc-flash 用来写入标签。 - 0.21.1 版增加了通过网络进入机器人的方式:按住脸部按钮 5 秒,SSH 会通过 wifi 开放 30 分钟。协议从 API 55 升到 61,全部为新增。发布说明 - 为何重要:请把机器人上的所有守护进程一起更新,因为 v59 的 robotd 会按名称拒绝新的 hello {client} 和 robot.head {alpha} 调用;另请注意,维护者直接发布了 0.21.0 和 0.21.1,只经过 CI 验证,尚未在真实机器人上运行,所以请先在工作台上试用。
ORCA Hand
!ORCA Hand
- Orca Core 0.13.0 为 v2.1 手新增了引导式张紧(scripts/guided_tension.py):你让每个关节走完整个活动范围时,电机轻轻保持;脚本会评估每根肌腱的松紧,然后在你用棘轮拧紧偏松的肌腱时让电机保持。v2.0 的手仍使用 scripts/tension.py。 - 它还新增了手动校准(你用手把每个关节移到其限位)、用三位数字报告的硬件版本(v2.1.0 为 210),以及触觉传感器修复:此前程序繁忙时可能会丢失触觉,直到重新连接。变更内容 - 为何重要:如果你在组装 v2.1 的手,请用引导脚本张紧,最后再校准;电机保持时避免用力推手指,那样可能让肌腱松开。校准记录现在保存在你加载的配置旁边,所以同一型号有不止一只手时,请给每只手各自一份配置副本。
SO-ARM 102
!SO-ARM 102
- 装配指南现在遵循小册子 v0.8,并写明了每个关节的舵机:主臂的舵机全部是 STS3215;从臂上,ID 1 和 4 是 Feetech STS3235,ID 2 和 3 是 STS3250。 - 某一步中标注“servo kit”的螺丝来自舵机包装,而不是散装紧固件袋。电路板支架和盖子改编号为 SO102.02.101,相机支架这一步需要五颗 M3×10 螺丝,而不是四颗。变更内容 - 为何重要:如果你要为 SO-ARM 102 从臂购买舵机或打印零件,下单前请对照 v0.8 指南核对每个 ID 的舵机型号,并打印 v0.8 小册子而不是 v0.7,因为零件编号和螺丝数量不同。
pib
!pib
- 0.7.12 版让 imitate_hands 回到正确的方向:右前臂旋转的符号再次取反,手部追踪的裁剪也已修正。 - 0.7.14 版改变了 pib 的安装和更新方式:setup-pib.sh 现在检出最新的发布标签而不是某个分支,更新时从镜像仓库拉取预构建镜像(本地构建作为后备),并且在更新触碰 git 之前先检查剩余磁盘空间。0.7.17 版默认关闭相机的立体深度。发布说明 - 为何重要:模仿人手臂动作的 pib 在 0.7.12 之前右臂的运动方向是反的,所以演示前请先更新。升级到 0.7.17 后,请测试依赖深度的程序,因为除非你手动开启,否则深度不再默认启用。
为何重要
本周有四项变更可能让原本能运行的代码失效。本周安装或重建过 mjlab 环境的用户,MuJoCo 可能已损坏,需要给 mjviser 加上版本上限。Rerun 0.43 重命名了 JavaScript 选项和一项存储设置,Strands Robots 0.6.0 移除了 0.5.x 的 API,两者都需要先迁移代码再更新。uni-robot-agent 0.2.0 要求客户端和服务一起升级。使用 MuJoCo 4.0.0 的用户应升级到 4.0.1,并重新运行出现发散的模型。Microduck 的 0.21 版本尚未在真实机器人上运行过,请先在工作台上试用。