# Stuntman 常见问题

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

**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 足够。
