技术，从这里连接。

机器人方案、技术参数与接口设计说明。

YUEXING / YX-01

岳行

人形自主作业机器人方向。重点探索工业视觉引导、双臂操作与工业动作数据采集。

YUEXUN / YQ-01

岳巡

四足智能巡检机器人方向。重点探索复杂环境感知、自主巡检与设备状态数据采集。

图片无法证明防爆、防护、负载或作业能力。具体应用范围需结合选型资料、现场条件和验证结果确定。

拟通过现场网关向上层业务系统提供 HTTP / JSON 接口。SDK 计划封装设备状态、巡检任务与数据访问能力；以下列出首版拟议接口，用于技术对接讨论。

巡检任务请求示例

route_id 指向预先验证的路线；本示例不提供直接关节或速度控制。

POST /v1/missions
Authorization: Bearer YOUR_ACCESS_TOKEN
Idempotency-Key: example-request-001
Content-Type: application/json

{
  "robot_id": "robot-001",
  "task_type": "inspection",
  "route_id": "validated-route-001"
}

# 拟议响应：202 Accepted
{
  "mission_id": "mission-001",
  "status": "queued"
}

无需安装假设存在的 SDK 软件包。以下使用 Python 标准库说明接口调用方式，域名为不可连接的示例占位地址。

# 接口设计草案：示例域名不可连接，SDK 尚未发布。
# 以下演示未来 HTTP 接口的调用方式，不控制真实机器人。
import json
from urllib.request import Request, urlopen

base_url = "https://robot-gateway.example.invalid"
token = "YOUR_ACCESS_TOKEN"  # 未来由现场网关签发
robot_id = "robot-001"       # 设备 ID，与方案型号不同

request = Request(
    f"{base_url}/v1/robots/{robot_id}/state",
    headers={"Authorization": f"Bearer {token}"},
    method="GET",
)
# 有实际网关并确认接口版本后，才可替换连接配置。
with urlopen(request, timeout=10) as response:
    state = json.load(response)
    print(state["robot_id"], state["mission_state"])

拟议响应结构

以下电量与位姿均为演示数据，不是机器人实测结果。

{
  "robot_id": "robot-001",
  "model": "YQ-01",
  "timestamp": "2026-09-18T02:00:00Z",
  "mission_state": "idle",
  "battery_percent": 80,
  "pose": {
    "frame_id": "map",
    "position_m": [0.0, 0.0, 0.0],
    "quaternion_xyzw": [0.0, 0.0, 0.0, 1.0]
  }
}

mission_state 拟支持 idle、queued、running、completed、failed、cancelled；state 接口中的位姿与电量字段仅在设备上报有效数据时返回，否则为 null。

拟统一采集视觉帧、机器人关节状态、动作轨迹、任务事件与设备运行状态，用于回放、标注、仿真验证和后续模型训练。

时间

UTC 时间戳；采样率与传感器同步误差待实际系统确认。

空间

每条位姿携带 frame_id；位置单位 m，角度单位 rad，四元数顺序 xyzw。坐标系变换须随采集记录保存。

任务

记录 robot_id、mission_id、任务状态与数据版本，保持一次任务的数据可追溯。

数据交付

数据格式、保留期限、脱敏和导出范围，在具体项目中约定。当前不提供在线数据下载服务。

1. 定义任务

   确认巡检或操作目标、环境限制、设备接口与验收方法。

2. 确认硬件

   完成底盘、机械臂、传感器与计算平台选型，补齐规格和适用资料。

3. 联调验证

   在仿真与受控环境中验证感知、任务编排和异常处理。

4. 推进 PoC

   在确定的工况和范围内试点，记录问题并迭代方案。

下载内容同样为设计草案，不包含可用 SDK、驱动或机器人控制软件。