实验方法

M: (Sₜ, θ, C, R) → (Sₜ₊₁, E, D)

用户实验需求
研究对象和当前状态
容器与样品状态
合格设备技能库
函数式技能签名
参数和状态约束

{
  "requirement": {
    "name": "两份样品加液并进行紫外可见光谱表征",
    "goal": "分别制备试剂A和试剂B样品，获得200至800nm光谱"
  },
  "research_objects": [
    {
      "object_id": "sample-1",
      "container_type": "离心瓶",
      "container_id": 1,
      "container_status": "有盖",
      "sample_status": "空"
    },
    {
      "object_id": "sample-2",
      "container_type": "离心瓶",
      "container_id": 2,
      "container_status": "有盖",
      "sample_status": "空"
    }
  ],
  "required_functions": [
    "open_caps",
    "add_liquid_with_material",
    "close_caps",
    "uv_vis_spectrum_test"
  ],
  "constraints": {
    "container_count": 2,
    "single_transfer_max_mL": 1.0,
    "single_solution_total_max_mL": 3.0
  },
  "capability_revisions": {
    "2002186824385539": "12",
    "1664783667397632": "5"
  }
}

实验目标与初始状态
  → 查询已准入函数
  → 参数实例化与约束检查
  → 用状态前后关系连接调用
  → 冻结版本快照
  → 候选方法

def generate_recipe():
    Liquid_Handling_Station_1ml_V2.open_caps(
        container_type="离心瓶",
        container_count=2,
        container_ids=[1, 2],
        open_cap_bottle_ids=[
            OpenCapBottle(bottle_id=1),
            OpenCapBottle(bottle_id=2),
        ],
        keep_cap=1,
    )

    Liquid_Handling_Station_1ml_V2.add_liquid_with_material(
        container_type="离心瓶",
        container_count=2,
        container_ids=[1],
        dispensing_plan=[
            DispensingPlan(
                sample_bottle_id=1,
                source_bottle=SourceBottle(
                    ingredient_name="试剂A",
                    source_volume_mL=0.5,
                    source_bottle_id=1,
                ),
            )
        ],
    )

设备标识与命名空间
函数名称与 command_id
请求分类 request_class
对象、控制和系统三个完整维度
参数名称、类型、单位、范围、枚举、默认值和嵌套结构
前置容器、样品和系统状态
强制约束与注意事项
成功后的状态变化
返回字段与诊断
同步或异步执行模式

def open_caps(
    container_type: Literal["离心瓶", "50ml耐热瓶"],
    container_count: int,
    container_ids: list[int],
    open_cap_bottle_ids: list[OpenCapBottle],
    keep_cap: int = 1,
) -> StepResult:
    """要求容器有盖；成功后容器状态变为无盖。"""
    ...

def add_liquid_with_material(
    container_type: Literal["离心瓶", "50ml耐热瓶"],
    container_count: int,
    container_ids: list[int],
    dispensing_plan: list[DispensingPlan],
) -> StepResult:
    """要求容器无盖；校验瓶号、液量和总体积后更新样品状态。"""
    ...

def close_caps(
    container_type: Literal["离心瓶", "50ml耐热瓶"],
    container_count: int,
    container_ids: list[int],
    close_cap_bottle_ids: list[CloseCapBottle],
) -> StepResult:
    """要求容器无盖；成功后容器状态变为有盖。"""
    ...

实验名称
plan_name
实验流程
涉及设备
path
steps
unknown_steps

step_number
id
device_name
command_id
request_class
operation
parameters