# 深岳智能技术说明

版本：0.1 / 2026-09-18 / 产品概念与接口设计草案。

两款机器人名称为概念方案命名。图片不构成实物、性能或认证证明；SDK 尚未发布，无可连接服务。

## 机器人参数

| 项目 | 岳行 YX-01 | 岳巡 YQ-01 |
|---|---|---|
| 方案命名 | 岳行 YX-01 | 岳巡 YQ-01 |
| 形态方向 | 人形 / 双臂操作 | 四足 / 移动巡检 |
| 优先场景 | 煤化工装置区、工业设备操作 | 选煤厂、矿区通道、能源设施巡检 |
| 任务方向 | 阀门等设备操作、视觉引导、动作数据采集 | 自主巡检、仪表视觉识别、设备状态采集 |
| 感知方案（拟议） | RGB / 深度视觉、关节状态与力觉反馈 | 激光雷达、RGB / 深度视觉、机器人状态 |
| 导航与操作（研发方向） | 空间感知、全身协同、机械臂操作策略 | 三维建图、自主导航、巡检任务编排 |
| 尺寸 / 整机重量 | 待硬件选型后确认 | 待硬件选型后确认 |
| 自由度 / 额定负载 | 待硬件选型与测试确认 | 待硬件选型与测试确认 |
| 运行速度 / 续航时间 | 待工况测试确认 | 待工况测试确认 |
| 定位精度 / 操作精度 | 待任务定义与测试确认 | 待任务定义与测试确认 |
| 工作温度 / 防护等级 | 待设备资料与测试确认 | 待设备资料与测试确认 |
| 防爆 / 行业准入资料 | 暂未提供，不作认证声明 | 暂未提供，不作认证声明 |
| 通信 / 计算平台 | 待现场网络与算力方案确定 | 待现场网络与算力方案确定 |
| 当前阶段 | 概念方案 / 产品方向验证 | 概念方案 / 产品方向验证 |

## 拟议接口

| 方法 | 路径 | 功能 | 说明 |
|---|---|---|---|
| GET | /v1/robots | 设备列表 | 返回设备标识、方案型号与在线状态 |
| GET | /v1/robots/{robot_id}/state | 状态查询 | 读取时间戳、任务状态、位姿和电量 |
| POST | /v1/missions | 创建任务 | 提交预先验证的巡检路线；拟要求请求幂等键 |
| GET | /v1/missions/{mission_id} | 任务查询 | 返回 queued / running / completed / failed / cancelled |
| POST | /v1/missions/{mission_id}/cancel | 取消任务 | 请求软件层任务取消；最终状态须再次查询 |

## Python 示例

```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"])
```

## 状态响应示例

以下为示例数据，不是实测结果。

```json
{
  "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]
  }
}
```

## 任务请求示例

```text
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"
}
```

任务接口须待现场安全策略与硬件接入完成后实施；软件取消不等于硬件急停。

## 数据约定（拟议）

UTC 时间戳；位置单位 m；角度单位 rad；四元数 xyzw；每条记录携带 frame_id。采集内容包括视觉帧、关节状态、动作轨迹、任务事件与设备状态。同步误差与采样率须以正式实现和测试结果为准。

## 联系

石先生：18810815295