> ## Documentation Index
> Fetch the complete documentation index at: https://all.mimedal.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 用一个最小流程了解如何定义设备接口、验证方法并执行操作。

ALL 的最小闭环由接口定义、编译、仿真和执行组成。FSP 不限定设备接口使用 HTTP、CLI、MCP、RPC 还是 SDK，但所有参与执行的接口都必须具备对象、操作和系统三段描述。

## 1. 定义设备接口

为每项设备操作声明目标容器、操作参数、设备条件和结果结构。以加液为例：对象描述目标容器的无盖状态与剩余容量；操作部分说明液体来源和加液量；系统描述设备空闲状态与安全围栏。

```json theme={null}
{
  "operation_id": "add_liquid",
  "object": {"required_container_state": "无盖"},
  "operation": {"parameters": {"volume_mL": {"type": "number", "minimum": 0.05, "maximum": 0.8}}},
  "system": {"required_device_state": "idle", "safety_fences": ["容器容量足够"]}
}
```

## 2. 编译和仿真

编译/解释器把研究目标和实际容器状态转换为类型化中间程序；仿真器在隔离状态中检查参数范围、容器容量、状态变化和安全围栏。只有仿真通过的步骤才能交给执行器。

## 3. 执行并核验

执行器将每一步的对象、操作、系统输入提交给设备现有接口或适配层，并取得同样三段的实际响应：对象给出容器变化，操作给出执行结果，系统给出设备状态、安全检查和任务信息。

异步操作在系统段返回任务信息。任务查询、取消和结果获取由实际承载方式提供等价能力；FSP 只要求每次结果返回都保持三段结构。

更多字段和示例见[接口契约](/specification/base-protocol)、[操作](/specification/fsp/operations)和[接口定义](/specification/device-integration/overview)。