Stuntman 常见问题

Stuntman 常见问题 硬件、软件、接口、合规和安装

按主题整理用户常问的技术问题,每条附上讲得更细的文章。内容依据原厂 Stuntman FAQ,具体配置以 Unchained Labs 的方案为准。

硬件与配置

机械臂运动时,怎么保护操作人员?

有人挡住光幕时,安全系统触发 Safe Torque Off(STO),切断电机电源,平台减速停下。直线电机平台带直线编码器,运动受阻时能更快发现并停止。按安全指南,还可以接入通风罩门的联锁。各配置的联锁方式见 Stuntman 安装前的场地准备。

机械臂上的相机能用来实时看运行情况吗?

可以,相机能输出实时画面,用来监看运行。目前相机不参与自动判断,运行流程不会根据画面自动调整。

机械臂位置偏了,系统能自己纠正吗?

不能,Stuntman 没有自动纠正位置的功能。硬件用绝对编码器和两端支撑的 H 型龙门架,位置更稳定。每个机械臂上的相机可以用在自定义流程里做监看。

能同时跑两个设计吗?比如一个长时间加热搅拌,另一个同时称粉末。

软件本身不支持两个设计同时运行。需要的话可以定制开发,例如让运行中的脚本启动另一个设计。台面上能装哪些模块,见 Stuntman 生物药制剂常用模块。

每个月能跑多少实验,有没有上限?

软件对每月实验数没有固定上限。实际通量取决于硬件配置、每个实验的运行时间和排队方式。

能拿到 Stuntman 的 CAD 模型做仿真吗?

可以。签保密协议后,Unchained Labs 可以提供 CAD 模型,用于仿真、数字孪生或流程建模。

软件与数据

.stunt 文件是什么?能直接打开看吗?

.stunt 是 Stuntman 的设计和结果文件,格式是 HDF5。它是二进制文件,不能用文本编辑器打开,要用 Python、R、MATLAB 等的 HDF5 库读取。CONVERT 可以从 .stunt 文件自动生成 Python 脚本。文件结构见 Stuntman 软件。

为什么 Stuntman AI 先写 Python,而不是直接生成 .stunt?

Python 脚本人能读,用户可以先检查、修改、核对,再转成 .stunt 运行。用 Python 写的设计也便于做版本管理和接外部软件。写法见 用 Python 写 Stuntman 实验设计。

不用 AI,Stuntman 还能用吗?

能。AI 可以完全不用,也可以只在建设计这类步骤里用。不用 AI 时,PLAN 图形界面建设计、RUN 执行、自己写 Python 脚本都照常可用。各程序的分工见 Stuntman 软件。

AI 写出的设计超出了硬件能力,会怎样?

设计受当前系统的耗材定义、台面布局、分液范围等限制。超出限制的设计在 PLAN 里通不过验证,不能运行。改设计或改提示词后再验证即可。写法见 怎么给 Stuntman AI 写提示词。

运行中能看到进度吗?结果什么时候能拿到?

运行时软件界面实时显示正在处理哪个样品、哪一步和系统状态。运行一结束,完整的 HDF 数据就在本地,可以直接分析或导出。SHOW 显示数值、曲线和图像。

结果能导出成什么格式?

原生格式是 HDF,保存分液质量和体积、温度等过程参数、时间戳和样品编号。SHOW 可以把结果导出成 Excel;要 JSON 或 CSV,用通用的 HDF5 库写程序转换。数据结构见 Stuntman 软件。

软件升级后,旧的实验数据还能打开吗?

能。HDF 文件带版本号,软件按版本读取,升级不影响打开以前的数据。

设计文件有修改记录吗?

软件不记录设计文件的修改历史。.stunt 和脚本是普通文件,可以用共享盘、Git 或文档管理系统管版本。每次运行会记下所用的设计文件、脚本和软件版本。

不同地点、不同仪器之间怎么共享数据?

.stunt 文件和普通 Windows 文件一样,可以放在共享网络盘上,没有专用云存储。一台电脑给多台 Stuntman 做设计的设置,见 Stuntman 电脑要求与软件安装。

数据能自动同步到 AWS S3 这类云存储吗?

软件没有自动云同步。结果以 HDF 文件写在本地,可以用单位现有的文件同步工具,或写一个监控脚本把运行完的文件上传。

接口与集成

Stuntman 有 REST API 或 OPC UA 接口吗?

没有。RUN 对外只提供 SiLA 接口,也不开放固件级控制。需要接 REST 系统或 OPC UA 设备时,由一层调度程序分别和各方通信。接口细节见 Stuntman SiLA 2 接口。

多个人共用一台仪器,实验怎么排队?

RUN 有运行队列,设计按顺序执行,闭环运行时也能往队列里加设计。队列窗口显示已完成、进行中和待运行,待运行的可以上下调整或删除。队列开始后,API 只能查询当前进行到第几个,改队列要在界面上操作。见 Stuntman SiLA 2 接口。

能不能做底层控制,比如单独移动机械臂?

能。脚本可以调用硬件资源对象,做单步的移动和分液操作,也可以不开 RUN 界面、由外部 Python 程序驱动。无界面运行属于高级部署,方案要和 Unchained Labs 单独商定。这种方式下,步骤顺序和出错处理都由用户自己负责,软件不提供界面提示和恢复。

能直接用 JSON 文件提交实验设计吗?

不能,设计必须是 Stuntman 原生格式,并在软件里通过验证。外部系统输出的 JSON,可以用 Python 接口转成 Stuntman 设计。见 用 Python 写 Stuntman 实验设计。

能和我们的 ELN 直接对接吗?

目前没有基于 REST 的 ELN 对接。结果是 HDF 文件,可以转成 JSON 等格式上传 ELN。反方向需要一层调度程序,把 ELN 里的内容转成 Stuntman 设计,再通过 SiLA 提交。

HPLC 这类分析仪器能接进流程吗?

能,前提是仪器通过 SiLA 等支持的接口接入。接入后,分析结果可以进闭环,由优化算法决定下一轮条件。闭环的搭法见 Stuntman 闭环怎么搭。

没接在 Stuntman 上的仪器,数据能在 SHOW 里看吗?

SHOW 显示经 RUN 采集的数据,包括已接入仪器的结果。外部仪器的数据要先转成 Stuntman 的 HDF 格式,需要写数据导入程序或定制开发。

闭环里能用我们自己的优化算法吗?

能。可以用贝叶斯优化、实验设计(DoE)、scikit-learn 等开源库,或自己的模型。算法写在 Python 流程里,由用户选择和验证。见 Stuntman 闭环怎么搭。

API 是同步还是异步?升级后旧代码还能用吗?

配置、状态查询这类短操作是同步的,运行实验这类长操作是异步的,用户不能切换。API 通常保持向后兼容,极少数接口会停用,届时需要改代码。

安全与合规

软件有用户登录和权限管理吗?

软件本身没有登录。谁能用、能改哪些文件,由 Windows 账户和文件权限管理。配置文件也按操作系统权限保护。

Stuntman 算质量管理系统吗?能出 GLP 报告吗?

不算,Stuntman 是研发用自动化平台,不是 QMS。它生成带时间戳的 HDF 记录,含运行参数、样品编号和分析结果。这些记录可以放进单位的文档控制或质量系统,用于研究记录、申报或专利材料。

原料批号能一路追溯到结果吗?

能。每个样品有唯一编号,分液、过程参数、时间戳和分析结果都记在 HDF 文件里。批号可以写进设计的元数据,和运行数据存在一起。

运行中出了错,会怎样?

流程停下,记录出错的步骤、时间和系统状态,队列里剩下的实验保留,问题处理后才继续。软件不会自动诊断和恢复,可以在脚本里自己写处理逻辑。错误和警告都写进 HDF 文件,样品是否算失败由用户自定标准。

做供应商安全评估,能拿到软硬件 BOM 吗?

可以。签保密协议后,Unchained Labs 提供含版本信息的硬件和软件物料清单。

安装与服务

IQ/OQ 和 FAT/SAT 有什么区别?

IQ/OQ 由现场服务工程师在安装时执行,确认安装正确、运行符合规格,客户审核签字。FAT 一般在发货前做,SAT 在客户现场做,按客户自己的流程和验收标准演示性能。安装前的准备见 Stuntman 安装前的场地准备。

工作站用什么系统?能换成我们自己的电脑或 Windows 11 LTSC 吗?

标准配置是原厂验证过的工作站,系统为 Windows 11 Pro。LTSC 和客户自备电脑没有正式验证,要作为定制集成单独评估。有的单位加一台桥接电脑负责联网和传文件,仪器电脑仍做控制。规格见 Stuntman 电脑要求与软件安装。

网络带宽要多少?

共享网络文件夹、远程桌面等功能需要联网,100 Mbps 足够。