目录元数据
公开可获得按机械臂、双足、无人机、人形、四足、轮式等类别组织的命名描述模块。
采用前核验记录加载器发布版、描述名称、上游 URL、格式、标示许可证、标签与最近验证状态。
仿真与数字资产技术档案 · 03
robot_descriptions.py：让自动模型访问具备可复现性与权利意识
使用统一 Python 接口发现和加载异构 URDF、Xacro 与 MJCF 描述，同时把每个上游仓库、生成变体、提交与许可证作为独立证据保留。
证据状态便捷跨框架访问层 · 上游资产仍然异构 · 自动下载不等于验证或权利核验资料核对日期：2026 年 8 月 4 日
先确认资产身份
目录名称不能代替准确格式、上游提交、生成参数、运行环境与许可证。
robot_descriptions.py 是开放目录与加载器，把 185 个以上机器人描述作为 Python 模块提供，并支持 MuJoCo、Pinocchio、iDynTree、PyBullet、RoboMeshCat 与 yourdfpy 等框架。它会下载并缓存上游描述，但不拥有、统一或验证所有底层模型。
数字资产地图
把描述格式、几何、动力学、场景、加载器、版本与来源放回同一张依赖地图。
下载与缓存层
公开可获得首次使用自动下载并在本地缓存上游机器人描述仓库。
采用前核验记录解析到的上游提交、缓存路径、校验和、更新行为与离线重建方法。
生成式描述
公开可获得URDF_PATH、MJCF_PATH 与包路径；必要时支持 Xacro 渲染及参数。
采用前核验归档生成 URDF、Xacro 参数、环境、网格解析、资源映射与任何加载器转换。
框架加载器
公开可获得面向多个动力学、可视化与仿真框架的直接加载器。
采用前核验比较解析器语义、固定关节处理、传动、mimic 关节、材质、碰撞几何与不支持标签。
许可证分层
加载器、模型 XML、网格、纹理、品牌与生成输出，可能属于完全不同的权利层。
资产层已知状态采用决策
加载器代码
robot_descriptions.py 项目为自身代码标示 Apache-2.0。
保留声明并固定实验使用的安装发布版或提交。
下载的机器人描述
每个上游机器人描述保留自身仓库与许可证。
建立逐描述许可证清单；加载器的 Apache 许可证不会向下覆盖缓存资产。
网格、纹理与品牌
第三方几何与商标可能采用不同于描述代码的条款。
再分发、发布或商业使用前，检查文件级声明与上游历史。
本表是资料导航与工程判断框架，不构成法律意见。实际使用前应以原始许可证文本和合资格专业意见为准。
模型与资产验证门槛
从身份冻结、结构检查到行为校准与实验复现，逐级证明模型可以支持什么。
- 01
解析结果清单
应保留证据加载器版本、模块名称、上游 URL／提交、格式、变体、Xacro 参数、缓存校验和与许可证。
停止条件自动更新或浮动分支导致无法重建相同文件时，应停止。
- 02
解析与结构检查
应保留证据警告、连杆／关节树、单位、限制、mimic／传动行为、惯性、碰撞与资源解析。
停止条件不得仅因一个框架能够显示描述就投入使用。
- 03
跨加载器比较
应保留证据跨目标框架匹配连杆姿态、自由度、质量、质心、关节限制与碰撞几何。
停止条件加载器产生实质不同机器人模型时，不得比较算法。
- 04
用途验证
应保留证据明确任务、所需属性、校准来源、可接受误差、回归基准与保留失败案例。
停止条件进入目录不能支持超出已测试模型属性的实物、安全或性能主张。
FUURAA 分析
数字资产真正有价值，是因为团队能够说明它从哪里来、如何变化，以及哪些行为已经被证明。
最适合用途
在多个成熟机器人框架中快速发现模型并开展可重复加载实验。
主要风险
一条 import 语句会隐藏远程仓库、可变版本、生成文件、框架解析器与独立许可证链。
FUURAA 判断
用加载器完成发现，然后固化包含解析源、生成模型、许可证与验证结果的不可变证据包。
适用边界
仿真资产可以加速研究、训练与集成，但不能自动成为制造图纸、实体数字孪生或安全证明。
可以支持
- 跨框架机器人描述发现
- 加载器与解析器回归测试
- 研究用带版本模型目录
本页不能替代
- 上游资产来源与权利审查
- 实物几何、动力学与校准证据
- 经认证的产品特定数字孪生