# 算子的机器人描述文件：自定义评测流程
#### 输入说明：评测配置文件以及机器人描述文件，支持自定义评测
从界面上选择的机器人描述文件夹需包含：
```
├── robot.urdf
├── robots.yaml
```
yaml配置文件名称必须为robots.yaml, urdf的名称非固定。
#### 机器人描述文件（URDF）
URDF文件（如星海图的）描述机器人的运动学结构，包括所有link与joint的定义。评测工具从URDF中解析左右臂的运动链结构。
URDF 文件需包含关键Link如[表1]。
一份适用内置青龙（SH）robot.yml示例如下：
This site uses XSLT; that functionality is being removed from this browser very soon. When that happens, this page will likely no longer display correctly. You might be able to install a browser extension that allows you to continue viewing it. Otherwise, you should contact the maintainer of the site for further information.
```
# 统一机器人注册表
#
# 本文件定义所有已知机器人类型的完整配置。
# 用户可通过 ROBOT_CONFIG 环境变量指定自定义 robots.yaml，
# 系统会将用户配置与本文件深度合并（用户字段覆盖内置字段）。
#
# 每个机器人类型必须定义所有字段，即使某些评测模式不使用。
#
# 字段分层：
#   - 通用字段：robot_name, robot_type, urdf_path, base_frame
#   - 手臂定义：arms 列表（支持单臂和双臂，含 camera_link）
#   - 多样性评测字段：state_layout, chains, fk_chains, angles_in_degrees 等
#
# 注意：质量评测的 gripper 阈值可通过 robots.yaml 中的 gripper_* 字段配置，
#       未定义时使用 interface_init_cli.py 的 CLI 默认值（mm 单位）。
robots:
  # ==================== R1 双臂机器人 ====================
  r1:
    robot_name: "Galaxea R1"
    robot_type: "R1"
    urdf_path: "config/robot_urdf/galaxea_r1.urdf"
    base_frame: "base_link"
    arms:
      - name: "left_arm"
        base_link: "left_arm_base_link"
        tip_link: "left_tool_link"
        hand_parent_link: "left_tool_link"
        camera_link: "left_camera_link"
      - name: "right_arm"
        base_link: "right_arm_base_link"
        tip_link: "right_tool_link"
        hand_parent_link: "right_tool_link"
        camera_link: "right_camera_link"
    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    desktop_axes: "xy"
    angles_in_degrees: false
    fk_chains: ["left_arm", "right_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
        right_arm_joint1: 7
        right_arm_joint2: 8
        right_arm_joint3: 9
        right_arm_joint4: 10
        right_arm_joint5: 11
        right_arm_joint6: 12
        right_gripper: 13
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6
      right_arm:
        joints: [right_arm_joint1, right_arm_joint2, right_arm_joint3, right_arm_joint4, right_arm_joint5, right_arm_joint6]
        end_effector: right_gripper_link
        gripper_index: 13
  # ==================== SO101 单臂机器人 ====================
  so101:
    robot_name: "SO101"
    robot_type: "SO101"
    urdf_path: "config/robot_urdf/so101_new_calib.urdf"
    base_frame: "base_link"
    arms:
      - name: "arm"
        base_link: "base_link"
        tip_link: "gripper_frame_link"
        hand_parent_link: "gripper_frame_link"
        camera_link: "gripper_frame_link"
    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    angles_in_degrees: true
    fk_chains: ["arm"]
    state_layout:
      state_size: 6
      mapping:
        shoulder_pan: 0
        shoulder_lift: 1
        elbow_flex: 2
        wrist_flex: 3
        wrist_roll: 4
        gripper: 5
    chains:
      arm:
        joints: [shoulder_pan, shoulder_lift, elbow_flex, wrist_flex, wrist_roll]
        end_effector: gripper_frame_link
        gripper_index: -1
# ==================== SH（青龙）双臂机器人 ====================
 sh:
   robot_name: "SH"
   robot_type: "SH"
   urdf_path: "config/robot_urdf/AzureLoong_v2.5_ctag.urdf"
   base_frame: "base_link"
   arms:
     - name: "left_arm"
      base_link: "base_link"
      tip_link: "Link_arm_l_07"
      hand_parent_link: "Link_arm_l_07"
      camera_link: "Link_arm_l_07"
     - name: "right_arm"
      base_link: "base_link"
      tip_link: "Link_arm_r_07"
      hand_parent_link: "Link_arm_r_07"
      camera_link: "Link_arm_r_07"
  # ── 多样性评测字段 ──
   high_value_is_open: false
   vertical_axis: "z"
   desktop_axes: "xy"
   angles_in_degrees: false
   fk_chains: ["left_arm", "right_arm"]
  # ── 离线评测字段 ──
  # 显式观测通道顺序（95 列，与数据集 observation.state 一一对应）。
  # 手臂位置列（0-13）用 URDF 链关节名（J_arm_l/r_01..07，去掉 _pos 后缀）；
  # 夹爪列（42-43）含 gripper 关键字；其余列（vel/eff/head/hip/waist）保持数据集通道名。
   observation_order:
    - J_arm_l_01
    - J_arm_l_02
    - J_arm_l_03
    - J_arm_l_04
    - J_arm_l_05
    - J_arm_l_06
    - J_arm_l_07
    - J_arm_r_01
    - J_arm_r_02
    - J_arm_r_03
    - J_arm_r_04
    - J_arm_r_05
    - J_arm_r_06
    - J_arm_r_07
    - J_arm_l_01_vel
    - J_arm_l_02_vel
    - J_arm_l_03_vel
    - J_arm_l_04_vel
    - J_arm_l_05_vel
    - J_arm_l_06_vel
    - J_arm_l_07_vel
    - J_arm_r_01_vel
    - J_arm_r_02_vel
    - J_arm_r_03_vel
    - J_arm_r_04_vel
    - J_arm_r_05_vel
    - J_arm_r_06_vel
    - J_arm_r_07_vel
    - J_arm_l_01_eff
    - J_arm_l_02_eff
    - J_arm_l_03_eff
    - J_arm_l_04_eff
    - J_arm_l_05_eff
    - J_arm_l_06_eff
    - J_arm_l_07_eff
    - J_arm_r_01_eff
    - J_arm_r_02_eff
    - J_arm_r_03_eff
    - J_arm_r_04_eff
    - J_arm_r_05_eff
    - J_arm_r_06_eff
    - J_arm_r_07_eff
    - left_gripper
    - right_gripper
    - J_head_yaw_pos
    - J_head_pitch_pos
    - J_head_yaw_vel
    - J_head_pitch_vel
    - J_head_yaw_eff
    - J_head_pitch_eff
    - J_hip_l_roll_pos
    - J_hip_l_yaw_pos
    - J_hip_l_pitch_pos
    - J_knee_l_pitch_pos
    - J_ankle_l_pitch_pos
    - J_ankle_l_roll_pos
    - J_hip_r_roll_pos
    - J_hip_r_yaw_pos
    - J_hip_r_pitch_pos
    - J_knee_r_pitch_pos
    - J_ankle_r_pitch_pos
    - J_ankle_r_roll_pos
    - J_hip_l_roll_vel
    - J_hip_l_yaw_vel
    - J_hip_l_pitch_vel
    - J_knee_l_pitch_vel
    - J_ankle_l_pitch_vel
    - J_ankle_l_roll_vel
    - J_hip_r_roll_vel
    - J_hip_r_yaw_vel
    - J_hip_r_pitch_vel
    - J_knee_r_pitch_vel
    - J_ankle_r_pitch_vel
    - J_ankle_r_roll_vel
    - J_hip_l_roll_eff
    - J_hip_l_yaw_eff
    - J_hip_l_pitch_eff
    - J_knee_l_pitch_eff
    - J_ankle_l_pitch_eff
    - J_ankle_l_roll_eff
    - J_hip_r_roll_eff
    - J_hip_r_yaw_eff
    - J_hip_r_pitch_eff
    - J_knee_r_pitch_eff
    - J_ankle_r_pitch_eff
    - J_ankle_r_roll_eff
    - J_waist_pitch_pos
    - J_waist_roll_pos
    - J_waist_yaw_pos
    - J_waist_pitch_vel
    - J_waist_roll_vel
    - J_waist_yaw_vel
    - J_waist_pitch_eff
    - J_waist_roll_eff
    - J_waist_yaw_eff
  # 显式动作通道顺序（33 列，与数据集 action 一一对应）。
  # 手臂列（0-13）即 URDF 链关节名；夹爪列（14-15）为 _command 指令名；
  # 其余列（head/hip/knee/waist）保持数据集通道名。
   action_order:
    - J_arm_l_01
    - J_arm_l_02
    - J_arm_l_03
    - J_arm_l_04
    - J_arm_l_05
    - J_arm_l_06
    - J_arm_l_07
    - J_arm_r_01
    - J_arm_r_02
    - J_arm_r_03
    - J_arm_r_04
    - J_arm_r_05
    - J_arm_r_06
    - J_arm_r_07
    - left_gripper_command
    - right_gripper_command
    - J_head_yaw
    - J_head_pitch
    - J_hip_l_roll
    - J_hip_l_yaw
    - J_hip_l_pitch
    - J_knee_l_pitch
    - J_ankle_l_pitch
    - J_ankle_l_roll
    - J_hip_r_roll
    - J_hip_r_yaw
    - J_hip_r_pitch
    - J_knee_r_pitch
    - J_ankle_r_pitch
    - J_ankle_r_roll
    - J_waist_pitch
    - J_waist_roll
    - J_waist_yaw
   state_layout:
     state_size: 95
     mapping:
      J_arm_l_01: 0
      J_arm_l_02: 1
      J_arm_l_03: 2
      J_arm_l_04: 3
      J_arm_l_05: 4
      J_arm_l_06: 5
      J_arm_l_07: 6
      J_arm_r_01: 7
      J_arm_r_02: 8
      J_arm_r_03: 9
      J_arm_r_04: 10
      J_arm_r_05: 11
      J_arm_r_06: 12
      J_arm_r_07: 13
      left_gripper: 42
      right_gripper: 43
   chains:
     left_arm:
      joints: [J_arm_l_01, J_arm_l_02, J_arm_l_03, J_arm_l_04, J_arm_l_05, J_arm_l_06, J_arm_l_07]
      end_effector: Link_arm_l_07
      gripper_index: 42
     right_arm:
      joints: [J_arm_r_01, J_arm_r_02, J_arm_r_03, J_arm_r_04, J_arm_r_05, J_arm_r_06, J_arm_r_07]
      end_effector: Link_arm_r_07
      gripper_index: 43
```
 表1Link说明 
| Link 名称            | 说明                   |
|:---|:---|
| base_link          | 机器人整体基座坐标系。          |
| left_arm_base_link  | 左臂运动链起点。             |
| right_arm_base_link | 右臂运动链起点。              |
| left_tool_link    | 左臂末端工具坐标，代表左手在任务空间中的位置。 |
| right_tool_link   | 右臂末端工具坐标。              |
   
表2字段说明 
| 字段                   | 类型     | 必填  | 说明                                                |
|:---|:---|:---|:---|
| robot_name          | string | 是   | 机器人名称，用于报告展示。                                      |
| robot_type          | string  | 是    | 机器人类型，目前仅支持R1。                                     |
| base_frame          | string  | 否 | 基座坐标系，默认base_link，作为模型元数据保存，实际FK链路不直接使用此字段。        |
| left_arm_base_link     | string | 是   | 左臂运动链起点，代码从left_tool_link 往父节点回溯至此link，解析出左臂所有关节。 |
| right_arm_base_link | string  | 是    | 右臂运动链起点，同理用于解析右臂链路。                                |
| left_tip_link        | string | 是     | 左臂末端工具坐标link，位于左夹爪后面，代表任务空间中的左手/末端执行器位置。           |
| right_tip_link       | string | 是  | 右臂末端工具坐标link。                                      |
   
![](https://support.huaweicloud.com/usermanual-cloudrobo/public_sys-resources/note_3.0-zh-cn.png)
left_arm_base_link、right_arm_base_link、left_tip_link、right_tip_link的值必须与 URDF 文件中定义的 link 名称完全一致。
配置文件robots.yaml主要分为三块地方。按照上面的完整的内置配置样例来说明用户进行自定义配置的时候，需要进行自定义配置。
#### 质量评测
如果用户涉及修改质量评测的配置文件，用户主要修改robots中机器人下的arms值。
```
# ==================== SO101 单臂机器人 ====================
robots:
  ...
  so101:
    robot_name: "SO101"
    robot_type: "SO101"
    urdf_path: "config/robot_urdf/so101_new_calib.urdf"
    base_frame: "base_link"
    arms:
      - name: "arm"
        base_link: "base_link"
        tip_link: "gripper_frame_link"
        hand_parent_link: "gripper_frame_link"
        camera_link: "gripper_frame_link"
    
    observation_order:
         -shoulder_pan.pos
         -shoulder_lift.pos
         -elbow_flex.pos
         -wrist_flex.pos
         -wrist_roll.pos
         -gripper.pos
     action_order:
         -shoulder_pan.pos
         -shoulder_lift.pos
         -elbow_flex.pos
         -wrist_flex.pos
         -wrist_roll.pos
         -gripper.pos
```
base_frame: "base_link" #这是机器人整体基座坐标系, 作为模型元数据保存；当前核心任务空间计算没有直接用它做 FK 链路起点。默认值base_link，无需修改。实际左右臂 FK 用的是下面两个 arm base link。
tip_link: "gripper_frame_link" #臂末端点。这里的tip不是"夹爪某个关节"，而是URDF里定义的工具坐标link，位于左夹爪后面，用来代表任务空间里的左手/末端执行器位置。
hand_parent_link与camera_link是预填充的配置，算子评测流程中实际不使用这俩配置进行评测。不需要修改。
observation_order显式观测通道顺序与数据集observation.state一一对应 （可选，没写依赖自动推算）
action_order显式动作，与数据集action--对应（可选，没写依赖自动推算）
#### 多样性评测
如果用户涉及修改多样性评测，用户主要修改robots.中机器人名称下的
```
robots:
   ...
   r1:
    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    desktop_axes: "xy"
    angles_in_degrees: false
    fk_chains: ["left_arm", "right_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
        right_arm_joint1: 7
        right_arm_joint2: 8
        right_arm_joint3: 9
        right_arm_joint4: 10
        right_arm_joint5: 11
        right_arm_joint6: 12
        right_gripper: 13
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6
      right_arm:
        joints: [right_arm_joint1, right_arm_joint2, right_arm_joint3, right_arm_joint4, right_arm_joint5, right_arm_joint6]
        end_effector: right_gripper_link
        gripper_index: 13
```
这里按照星海图R1机器人进行字段说明。基本上分为两块配置（机器人的数据通道映射以及手臂链接）
星海图是两条手臂的人形机器人，示例中提供了完整的两条手臂的链路，如果是只想计算单臂的，可以修改fk_chain以及chains中的手臂链路。例如以下配置
```
robots:
   ...
   r1:
    # ── 多样性评测字段 ──
    fk_chains: ["left_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6
```
mapping中的是URDF中关节的名称在lerobot数据集observation.state中的映射关系，上面的例子中，left_arm_joint1：0对应的是数据集observation.state数组中的位置是第一个。
