> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warmcore-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 头部、眼球与嘴部

> X3 SDK 的实体控制状态

> **开发者预览版／硬件尚未验证：** X3 硬件与已部署的机器人运行环境尚未完成验证。本机测试不能证明设备兼容性、物理行为或操作安全性。

## 离线数据准备与观察

`MouthController.prepare(ratio)` 会验证介于 `0` 与 `1` 之间的有限范式比例，并离线准备数据。`HeadController.prepare_rpy(roll, pitch, yaw)` 会验证以弧度表示的有限数值，并离线准备数据。这些检查不能证明机械行程限制或姿态安全。

控制器的 `inspect(node)` 方法使用调用者拥有的 ROS Node 检查节点图，不会发送动作指令。`EyeController.inspect(node)` 回报候选图形观察信息，而非眼球位置。

## 实体控制

手动嘴部及头部写入会抛出 `MotionUnavailableError`；眼球动作则没有手动 SDK 接口。未来如需激活实体控制，须先创建设备专属限制、控制仲裁、停止机制及受监督的硬件验收。不能因为没有观察到竞争节点，就推论操作安全。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.