Uni-Lab-OS/.cursor/skills/yibin-electrolyte-submit/action-index.md

Action 索引

Action JSON 文件需运行提取命令生成，详见 SKILL.md 中「生成 Action Schema」。 以下描述和参数信息基于源码分析。

---

配液分液工站 (bioyond_cell_workstation)

源码：unilabos/devices/workstation/bioyond_studio/bioyond_cell/bioyond_cell_workstation.py

调度控制

scheduler_start

启动 Bioyond LIMS 调度系统

• 核心参数: 无（仅需 apiKey/requestTime，由设备内部处理）
• 返回: LIMS 响应 {code, message, data}

scheduler_stop

停止调度

• 核心参数: 无

scheduler_continue

继续调度（从暂停状态恢复）

• 核心参数: 无

scheduler_reset

复位调度

• 核心参数: 无

scheduler_start_and_auto_feeding

组合操作：启动调度 + 自动化上料（4号→3号手套箱）

• 核心参数: xlsx_path（Excel 物料模板路径，可选）
• 可选参数: WH4 加样头面 12 个点位（materialName + quantity）、WH4 原液瓶面 9 个点位（materialName + quantity + materialType + targetWH）、WH3 人工堆栈 15 个点位（materialType + materialId + quantity）
• 流程: 先 scheduler_start()，成功后执行 auto_feeding4to3()
• 备注: 支持 Excel 模式和手动参数模式，Excel 路径存在时优先使用 Excel

物料上料/下料

auto_feeding4to3

自动化上料：从 4 号手套箱转运物料到 3 号手套箱

• 核心参数: xlsx_path（Excel 物料模板路径）
• 可选参数: 同 scheduler_start_and_auto_feeding 的 WH4/WH3 点位参数
• 返回: 等待上料任务完成后返回结果

auto_batch_outbound_from_xlsx

自动化下料（从 Excel 读取下料信息）

• 核心参数: xlsx_path（Excel 下料模板）
• Excel 列: locationId, warehouseId, 数量, x, y, z

物料管理

create_and_inbound_materials

批量创建固体物料并入库

• 核心参数: material_names（物料名称列表，默认 ["LiPF6", "LiDFOB", "DTD", "LiFSI", "LiPO2F2"]）
• 可选参数: type_id（物料类型ID）, warehouse_name（目标仓库，默认 "粉末加样头堆栈"）
• 流程: 创建物料 → 批量入库 → 同步

create_material

创建单个物料并可选入库

• 核心参数: material_name, type_id, warehouse_name
• 可选参数: location_name_or_id（库位编号如 "A01" 或 UUID）

create_sample

创建配液板物料（含子瓶）并入库

• 核心参数: name, board_type（如 "5ml分液瓶板"）, bottle_type（如 "5ml分液瓶"）, location_code（如 "A01"）
• 可选参数: warehouse_name（默认 "手动堆栈"）
• 备注: 自动创建 2x4=8 个子瓶

storage_inbound

单个物料入库

• 核心参数: material_id, location_id

storage_batch_inbound

批量物料入库

• 核心参数: items（[{materialId, locationId}, ...]）

配液实验

create_orders

从 Excel 文件创建配液实验订单

• 核心参数: xlsx_path（Excel 文件路径）
• Excel 列: 配方ID, 创建日期, 配液瓶类型, 混匀时间(s), 扣电组装分液体积, 软包组装分液体积, 电导测试分液体积, 电导测试分液瓶数, 以及所有以 (g) 结尾的物料列
• 流程: 解析 Excel → 提交订单 → 等待全部完成 → 计算质量比 → 提取分液瓶板 → 创建资源树对象
• 返回: {status, total_orders, bottle_count, reports, mass_ratios, vial_plates}

create_orders_formulation

从配方列表创建配液实验订单（前端/API 输入版本）

• 核心参数: formulation（配方数组）
• 可选参数: batch_id, bottle_type（默认 "配液小瓶"）, mix_time（秒，列表）, coin_cell_volume, pouch_cell_volume, conductivity_volume, conductivity_bottle_count
• formulation 格式:

  [
    {
      "order_name": "配方A",
      "materials": [
        {"name": "LiPF6", "mass": 12.5},
        {"name": "EC", "mass": 50.0},
        {"name": "DMC", "mass": 37.5}
      ]
    }
  ]
  

• 返回: 同 create_orders

物料转运

transfer_3_to_2_to_1_auto

自动转运：从 create_orders 结果中自动定位分液瓶板并转运到目标设备

• 核心参数: vial_plates（分液瓶板列表，来自 create_orders 返回的 vial_plates）
• 可选参数: target_device（默认 "BatteryStation"）, target_location（默认 "bottle_rack_6x2"）, mass_ratios（配方信息）
• 流程: 遍历瓶板 → 解析 locationId → 调用 LIMS 转运 API → 更新资源树
• 返回: {total, success, failed, results}

transfer_3_to_2_to_1

3→2→1 物料转运（手动指定坐标）

• 核心参数: source_wh_id, source_x, source_y, source_z

transfer_3_to_2

3→2 物料转运

• 核心参数: source_wh_id, source_x, source_y, source_z

transfer_1_to_2

1→2 物料转运

• 核心参数: 无

查询

order_list_v2

批量查询实验报告

• 可选参数: timeType, beginTime, endTime, status（60=运行中, 80=完成, 90=失败）, filter, skipCount, pageCount, sorting

---

扣电组装站 (BatteryStation)

源码：unilabos/devices/workstation/coin_cell_assembly/coin_cell_assembly.py

设备控制（组合操作）

func_pack_device_init_auto_start_combined

组合操作：设备初始化 → 物料搜寻确认 → 切换自动模式 → 启动

• 核心参数: material_search_enable（是否启用物料搜寻，默认 False）
• 前置检查: REG_UNILAB_INTERACT=False, COIL_GB_L_IGNORE_CMD=False, 所有握手寄存器无残留
• 流程: 手动模式 → 初始化命令 → 监测物料搜寻弹窗并自动处理 → 自动模式 → 启动
• 返回: True/False
• 备注: 第一次运行必须调用此函数；后续批次调用 func_sendbottle_allpack_multi

批量组装

func_sendbottle_allpack_multi

发送瓶数 + 批量组装（适用于第二批次及后续批次）

• 核心参数: elec_num（电解液瓶数）, elec_use_num（每瓶组装电池数）, elec_vol（电解液吸液量 μL，默认 50）
• 可选参数:
  • 双滴模式：dual_drop_mode(bool), dual_drop_first_volume(μL), dual_drop_suction_timing(bool), dual_drop_start_timing(bool)
  • 组装参数：assembly_type(7=不用铝箔垫/8=用), assembly_pressure(N，默认 4200)
  • 物料参数：fujipian_panshu, fujipian_juzhendianwei, gemopanshu, gemo_juzhendianwei, qiangtou_juzhendianwei
  • 开关：lvbodian(铝箔垫片), battery_pressure_mode(压力模式), battery_clean_ignore(忽略清洁)
  • 其他：file_path(CSV保存路径), formulations(配方信息，用于CSV追溯)
• 流程: 发送瓶数触发物料搬运 → 设置PLC参数 → 循环（等待PLC请求→下发参数→读取电池数据→写入CSV→更新资源树）→ 完成握手
• 返回: {success, total_batteries, batteries, summary}
• 备注: 设备已初始化后直接调用；formulations 来自 create_orders 的 mass_ratios

func_allpack_cmd

全套组装（基础版本，含断点续传）

• 核心参数: elec_num, elec_use_num, elec_vol, assembly_type, assembly_pressure, file_path
• 返回: {success, total_batteries, batteries, summary}

func_allpack_cmd_simp

增强版组装（含双滴模式 + 负极片/隔膜/枪头参数）

• 核心参数: 同 func_sendbottle_allpack_multi
• 备注: 被 func_sendbottle_allpack_multi 内部调用

设备控制（单步操作）

func_pack_device_init

设备初始化（手动模式 → 初始化 → 复位标志）

func_pack_device_auto

切换自动模式

func_pack_device_start

启动设备

func_pack_device_stop

设备停止

func_pack_send_bottle_num

发送电解液瓶数（触发物料搬运）

• 核心参数: bottle_num（瓶数）

PLC 参数设置

qiming_coin_cell_code

设置组装物料参数

• 核心参数: fujipian_panshu（负极片盘数）
• 可选参数: fujipian_juzhendianwei, gemopanshu, gemo_juzhendianwei, lvbodian, battery_pressure_mode, battery_pressure, battery_clean_ignore

数据采集

func_read_data_and_output

持续数据采集并导出 CSV（后台循环运行）

• 核心参数: file_path（CSV 保存目录）
• 采集字段: 开路电压, 极片质量, 组装时间, 压制力, 电解液加注量, 电池类型, 电解液二维码, 电池二维码

func_stop_read_data

停止 CSV 数据采集

设备状态属性（只读）

属性	类型	说明
sys_status	str	设备状态（启动中/停止中/复位中/初始化中）
sys_mode	str	设备模式（手动/自动）
data_assembly_coin_cell_num	int	已完成电池数量
data_assembly_time	float	单颗电池组装时间(秒)
data_open_circuit_voltage	float	开路电压(V)
data_pole_weight	float	正极片称重(g)
data_glove_box_pressure	float	手套箱压力(mbar)
data_glove_box_o2_content	float	手套箱氧含量(ppm)
data_glove_box_water_content	float	手套箱水含量(ppm)
data_coin_cell_code	str	电池二维码
data_electrolyte_code	str	电解液二维码

---

配置参考

设备图文件 yibin_electrolyte_config.json 中的仓库映射（warehouse_mapping）：

仓库名称	说明	典型操作
粉末加样头堆栈	20 个点位 (A01-T01)	create_and_inbound_materials 入库目标
配液站内试剂仓库	9 个点位 (A01-C03)	试剂存储
自动堆栈-左	4 个点位	分液瓶板存放，transfer_3_to_2_to_1_auto 的源位置
自动堆栈-右	4 个点位	分液瓶板存放
手动传递窗左/右	各 15 个点位	人工上料/下料
4号手套箱内部堆栈	12 个点位	auto_feeding4to3 的源位置