# Stuntman 集成与扩展：能接哪些设备

- 网址:https://unchainedlabs.help/product/stuntman/resources/integrations

**Stuntman 能接哪些设备 集成方式、系统布局和软件接口**

Stuntman 台面上装模块，台面外还能接封板机、贴标机、板库、培养箱和分析仪器。本页写给规划自动化工作站的生物药实验室。

内容依据原厂集成幻灯片、生物药彩页和 SiLA API 参考手册。具体能接哪台设备、用哪种方式接，以 Unchained Labs 的方案为准。

## 台面内加模块，台面外接设备

台面上可以加过滤、稀释、脱气等模块，在机内完成样品准备。台面上的模块和规格见 Stuntman 生物药制剂常用模块。

台面外的设备，彩页列出的有封板机、揭膜机、样品瓶贴标机、板库和培养箱。分析仪器可以直接连 UV/Vis、DLS 和 HPLC。也可以只让 Stuntman 做样品准备，再把数据交给台面外的系统。

*图:样品经机械臂工具、独立机械臂或转移导轨在 Stuntman 和周边设备之间传递。图中周边设备有贴标、封板、板库、离心 / 蒸发、混合、Raman、DLS 和 UV-Vis、HPLC。图取自原厂幻灯片。*

## 集成分三种：原厂集成、用户自己集成、经 API 集成

> | 方式 | 谁来做 | 做法 |
> | --- | --- | --- |
> | 原厂集成 | Unchained Labs | 提供所需的硬件和软件。按仪器不同，用 API 或 I/O 信号控制设备，数据写进输出文件。 |
> | 用户集成 | 用户 | 灵活性最大。Stuntman 只负责把样品送到交接位置并发出触发信号，设备由用户自己编程。 |
> | 经 API 集成 | 第三方集成商或用户软件 | 外部软件通过接口调用 Stuntman，见本页「软件接口」一节。 |

用户自己集成时，一个循环分五步：

- Stuntman 把样品瓶或样品架送到交接位置。
- 系统发出自动触发信号，例如感应到样品到位，或一路数字 I/O 信号。
- 用户编好程序的设备开始运行。
- 设备把数据存到用户指定的位置。
- 样品送回 Stuntman，继续后面的流程。

分析仪器的接法，原厂幻灯片列了物理集成、虚拟集成和数据加载器三种。物理集成由机器人直接给仪器上样。数据加载器方式下，仪器离线测量，结果以数据形式接入。例如 Horiba LA-960 激光粒度仪，由机器人稀释样品，再离线分析。

## 设备放在台面上、挂在侧面，或由中央机械臂串联

物理集成的核心是自动转移样品，把准备、处理、分析三段连起来。原厂幻灯片里有三种布局。

- 台面内：小型仪器直接放进 Stuntman 罩内。原厂给出过 Lunatic、Stunner 和读板仪放在台面上的方案。
- 侧挂：在 Stuntman 一侧或两侧贴着放独立的工作单元，各自带罩和机架。
- 中央机械臂：多套系统围绕一台多轴移板机械臂排开，由 Unchained Labs 软件统一管理。

*图:一台用于成药性评估的 Stuntman：Aunty、Stunner 和 Lil' Tuna 都放在罩内台面上。图取自原厂幻灯片。*

*图:侧挂布局：Stuntman 右侧接一个独立工作单元，单元有自己的罩和机架。图取自原厂幻灯片。*

*图:Stuntman 两侧各接一个工作单元，组成一条更长的自动化线。图取自原厂幻灯片。*

*图:Stuntman 侧面外挂 Aunty 和封板机的设计图。图取自原厂幻灯片。*

液相方面，原厂幻灯片列有 Waters 和 Shimadzu 两种方案。Waters LC 通过 Waters automation portal 集成，用 VPG 直接转板。另一种做法是在台面上装在线 HPLC 进样口。

## 生物药实验室常接的设备

下面三张表只收和生物药相关的设备，按准备、处理、分析分组。型号是原厂幻灯片上的实例，不是唯一选择。

### 准备

> | 设备 | 原厂列出的要点 |
> | --- | --- |
> | 开关盖机 FluidX IntelliXcap | 一次处理 24 支管，约 40 秒；兼容 Matrix 管；温控 4–35 °C。 |
> | 喷墨打印 | 可打 1D / 2D 条码和文字；墨水循环防堵。占地小，显示面板可放罩外。耐溶剂性不如纸标签。 |
> | 纸标签打印 Scinomix SciPrint SOLO | 标签贴在 0.5–50 mL 的瓶、管、罐上，易读、更耐溶剂。打印机整台要放进罩内，占地更大。 |
> | 读码器 Ziath DP5 | 读板上的 1D 条码和 SBS 架里管底的 2D 条码，标签要对比度高。Unchained Labs 曾在 Junior 和 Big Kahuna 上集成过它。 |
> | 管架读码 Azenta Perception HD | 用相机读 SBS 架里的条码管。 |
> | 封板机 Azenta a4S | 自动热封微孔板。 |
> | 揭膜机 Brooks XPeel | 自动揭去板上的封膜。 |
> | 声波移液 Beckman Echo 650T | 声波液体处理器。 |

### 处理

> | 设备 | 原厂列出的要点 |
> | --- | --- |
> | 离心机 Hettich Rotanta Robotic | 最大 6446 × g；兼容板和管；可选氮气吹扫和 −20 至 +40 °C 温控。 |
> | 预充针排空系统 | 自动识别针筒并扫码、去针帽、推出药液，收进板或瓶。它是独立工作站，板要人工送到机器人系统。 |
> | 液位检测 | 检测溶剂瓶和废液瓶的液位。 |
> | 废液管理 | 清洗站的废液按类别分到不同废液瓶，在设计时选定去向，并检测废液瓶液位。 |

### 分析

> | 设备 | 原厂列出的要点 |
> | --- | --- |
> | Lunatic | 物理集成。每样 2 µL，96 个样品约 5 分钟，SBS 板格式；可自动稀释到目标浓度。 |
> | Halo Labs Aura | Stuntman 负责样品准备，并整合数据。 |
> | 渗透压仪 OsmoTECH HT | 96 孔板格式，样品量小，冰点下降法。 |
> | 表面张力仪 Kibron Delta-8 | 每样 50 µL，96 个样品约 3 分钟。原厂建议用数据加载器方式，也可选物理集成。 |
> | HPLC / UPLC | 物理或虚拟集成；也可用台面上的在线进样口。 |

## Liconic 气候箱从顶部进出板

Liconic 气候箱物理集成在系统上，板从顶部放入和取出。选型主要看两点：要不要控湿，箱体多大。每个箱体只能设一个温度。

> | 型号 | 容量（微孔板） | 温控 | 原厂建议 |
> | --- | --- | --- | --- |
> | STR44-HR | 44 块 | 5–50 °C，选配 70 °C | — |
> | STR240-HR | 240 块 | 5–50 °C，选配 70 °C | 长期样品多，做 5 °C 稳定性时选它 |

表中容量按标准微孔板计。放样品瓶或更高的板时，实际能放的数量会减少。

*图:一款 Liconic 冷藏库的容量随板高变化：17 mm 的微孔板放 110 块，44 mm 的深孔板放 50 块。幻灯片未写这款的型号。图取自原厂幻灯片。*

## 集成层经 SiLA 2 控制 Stuntman，用 Python 扩展

外部调度软件通过 SiLA 2 连接 Stuntman。软件装好后有两个 SiLA 服务器。Stuntman Launcher 默认用 TCP 50253 端口，负责启动和关闭 RUN。Stuntman RUN 默认用 50052 端口。多数命令返回 JSON 字符串，含 Status、Content、Error、StatusCode 四个字段。

RUN 在 SiLA 模式下提供四个 feature，规划集成时分别对应四件事：

- QueueRunService：载入运行队列，开始、暂停、停止运行。
- ExperimentStatusService：报告运行状态，回答运行中的提示。
- ManagerStateService：用 XML 读写资源管理器状态，包括台面、吸头、板库、Liconic 和转盘。Liconic 里的板有变动时，可以用 SetLiconicState 上传新状态。
- SystemScriptService：在仪器上运行独立的 Python 脚本，传入脚本完整路径和命令行参数。

数据方面，原厂集成的设备把结果写进输出文件；用户自己集成的设备把数据存到用户指定的位置。两种情况都要在规划时定好文件放在哪、由哪个系统读取。

接口命令和调用顺序见 Stuntman SiLA 2 接口；用脚本生成实验设计见 用 Python 写实验设计。
