# 用 RUN 运行实验、用 SHOW 看结果

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

**用 RUN 运行实验，用 SHOW 看结果 从载入设计到导出 Excel**

设计在 PLAN 或 AI 里建好、检查通过后，交给 RUN 在台面上执行。结果写回同一个 .stunt 文件，再用 SHOW 打开查看和导出。RUN 不能建设计，也不能改设计。

六个程序各管什么，见 Stuntman 软件概览；设计怎么建，见 PLAN 操作指南。内容依据原厂 RUN 和 SHOW 用户指南（Rev A）。

## 开始前先初始化系统，再对一遍台面

每次开始工作时，在左上角 ☰ 菜单里点一次 Initialize System。它在后台运行初始化脚本，把所有硬件带到已知的就绪状态。重启之后、硬件出现异常之后，也要再跑一次。

上机前逐项确认：

- **吸头和废料**：装好设计要用的 PDT、ADT 吸头架，需要时倒空废吸头桶和废液桶。
- **原料**：粉末、储液槽、板和样品瓶架放好。加了盖或封膜的，确认设计里有开盖、刺穿或去膜步骤。
- **目标耗材**：目标板、瓶架、过滤组件放在设计规定的位置。
- **溶剂**：背液、清洗液等够整个运行用。
- **预热**：天平称量单元和目检灯要先达到工作状态。目检灯用前预热 20 分钟。
- **实物**：台面上没有散落物品，耗材、工具、盖子和压板与设计一致。

RUN 会校验设计、发现配置上的不一致，但看不到台面上的每个实物。开始前要拿 Deck Layout 的图和台面实物对一遍。

## Run Experiment 分五步：载入、选项、选孔、提问、台面

在 Main 页点 Run experiment 打开向导。五步依次是 Load Design、Run Options、Design Options、System Options、Deck Layout。不适用的步骤会自动跳过。向导打开期间，Run Queue 不能用。

### 1. Load Design：选文件和设计

- 从最近文件里选，或浏览找文件。最近文件最多列 50 个。
- 选中设计后，Design Details 显示描述、System Name、创建人、创建时间和全部 map。点 Next 前看一眼，确认没选错。
- 每个设计都记着它所针对的 System Name。RUN 只列出和本机名称一致的设计。预期的设计没出现，先查名称是否一致。
- 点 Next 时，RUN 会按当前系统配置重新校验一次。系统配置改过，原来通过的设计也可能报 Invalid Design。
- RUN 以写模式打开文件。同一个文件在 PLAN 或 SHOW 里开着时，RUN 可能打不开，先在那边关掉。

### 2. Run Options：四个开关

*图:Run Options：Experiment type 选 Experiment；默认只勾选从设计载入台面配置。图取自原厂 RUN 用户指南。*

- **Experiment type**：跑设计选 Experiment。做校准时选对应的 Calibration 项，先看生成的脚本和台面要求。
- **Bypass all prompts?**：设计带提问时才出现。勾选后直接用上次保存的答案。试剂、位置或数量可能变了，就不要勾。
- **Load Deck Configuration from design?**：默认勾选，按设计里保存的位置摆化学品和样品库。只有本机 Configure Deck 已按别的方式摆好、不想被覆盖时才取消。
- **Force hardware initialization?**：默认不勾。没初始化的硬件运行时总会被初始化。手动动过台面、怀疑位置不对或排查问题时，才勾选强制全部重新初始化。
- **Select specific maps or wells?**：默认不勾，跑全部 map 和全部孔。只想重跑失败的 map 或可疑的孔时勾选，进入第 3 步。

### 3. Design Options：只跑一部分孔或 map

左边每个样品库一张板图，设计没用到的孔是灰的。点单孔切换，拖动框选一块，点行号或列号切换整行整列。右边是所有 map 的勾选表，至少留一个。

- 选的是目标孔。某个孔同时是别的库的来源时，取消它不能阻止取液；要阻止，得取消用它做来源的那个目标孔。
- 孔的列表和 map 的选择不联动。取消了部分 map 后，再核对一遍孔的选择。

*图:Design Options：左边按瓶架选目标孔，右边勾选要执行的 map（加水、加盖、开盖）。图取自原厂 RUN 用户指南。*

### 4. System Options：回答设计脚本的提问

设计脚本可以在运行前提问，形式有是 / 否、数字、文字、下拉选项和板孔位置选择。没有提问的设计会跳过这一步。

### 5. Deck Layout：核对三个页签

这一步确认样品库（Libraries）、化学品（Chemicals）和吸头架（Tip Racks）的位置。三个页签都要看，点 Next 时保存。

点 Save Prompts to File，提问答案和 Run Options 的选择会存成文件。下次勾 Bypass all prompts 时调用这些答案。设计的提问改过（数量或顺序不同），存下的答案就不能用，需要重新回答。

*图:Deck Layout：台面图上高亮样品库和盖架的位置，下方表格列出每个库的规格、位置和初始状态。图取自原厂 RUN 用户指南。*

点 Next 后弹出最后一次确认，点 OK 开始运行。仪器没开机或断开时，会提示 CAN 总线初始化失败。初始化时出现 Python 报错，会单独弹窗显示完整的 traceback，联系技术支持时整段复制。

## 新设计先手动跑一次，才能放进队列

Run Queue 把多个设计和 Python 脚本排成一串，无人值守地依次运行，适合过夜或连续几小时的实验。队列运行中没人回答提问，所以设计必须先在 Run Experiment 里手动跑过一次，并在 Deck Layout 页存好提问答案。否则加入时提示没有保存的提问答案。

- **Add design**：加入 .stunt 设计，加入时按系统配置校验，不通过就拒绝。
- **Add script**：加入 .py 脚本，加入时不校验。可以在两个实验之间插一个清洗脚本。
- **调整顺序**：用上下箭头移动，点 × 删除，Clear 清空整个队列。
- **Import / Export**：队列存成 .rql 文件。常跑的固定序列导出一次，以后直接导入。队列长时，开跑前先导出，中途停下后好重建。

*图:Run Queue：一个加盖设计前后各排一个脚本，每项都能上移、下移或删除。图取自原厂 RUN 用户指南。*

- 点 Run 时先校验队列里所有设计，有一项不通过，整个队列都不启动。按提示逐条修改后再点 Run。
- 想让队列平稳收尾，用 Discontinue Queue：当前这一项跑完后停止。紧急停止要在 Experiment Status 里 Abort。
- 队列里任何一项失败，整个队列停止，不会跳到下一项。没开始的项标为 Cancelled。

## 在 Experiment Status 里看进度、暂停或中止

运行开始后，Main 页的 Experiment status 按钮才能点。它有两个页签：Run Status 显示进度和控制按钮，Data 显示每个孔的实时数据。

Run Status 顶部的 Script Info 有四行。Design 是正在跑的文件和设计，Script Name 是脚本名。Script Status 是当前硬件动作，Current Step 显示执行到第几个 map。下方板图标出已完成的孔。

*图:Run Status：正在执行 5 个 map 中的第 2 个（加盖）。绿色孔已完成，蓝框是当前孔。图取自原厂 RUN 用户指南。*

Data 页签和 SHOW 用的是同一种数据表，只是数据随运行实时填入。能看到哪些字段，取决于设计测了什么，例如实际分液量、实际参数、pH、颜色、浊度、颗粒计数、图像和曲线。双击单元格可以弹出这个孔的原尺寸图像或曲线。

*图:Data 页签：每行一个孔，两组 Actual Parameter 分别记录加盖和开盖的时间。图取自原厂 RUN 用户指南。*

- **Pause / Resume**：不弹确认。短暂停下检查台面时用。
- **Skip**：只在延时步骤可用，确认静置、孵育或平衡已经够了时跳过剩余等待。
- **Abort**：先暂停再弹确认，选 Resume 可以退回。确认中止后会问是否复位硬件：选 Yes 机械臂回到安全位置；选 No 硬件停在原处，方便检查当前步骤。
- **Script log / App log**：打开日志文件夹。前者记录设计脚本做了什么，后者记录 RUN 程序本身。联系技术支持时从这里取日志。

设计脚本也可以在运行中暂停并提问，例如显示一条消息、让你选一项，或在无法自行恢复时让你选 Resume 或 Abort。选 Abort 的效果和手动中止相同。

吸头用完时，运行自动暂停。点提示框的 OK 打开 Tip Management，补好或重新指定吸头架后继续。

运行结束后，Script Status 变为 Complete，机械臂回到原位。确认机械臂停止后再伸手进台面。等 RUN 把数据写完，再关闭程序、移动 .stunt 文件或用其他程序打开它。

运行中途死机或断电，数据可能没来得及并入 .stunt 文件。下次打开 RUN 时，☰ 菜单里会出现 Recover Orphaned Data，点 OK 把数据合并回原文件。SHOW 只会提示有这类数据，恢复必须在 RUN 里做。

## 单个动作用 Run Action，Python 文件用 Run Script

这两个工具在 Utilities 页，用于维护、测试和一次性操作，不需要建完整的实验。

- **Run Action**：执行单个硬件动作，例如移动一次机械臂，或做一次处理、检测操作。动作按 Arm、Balance、Gripper、Syringe、Tip 等硬件分类列出，只显示本机有的硬件。双击动作打开对话框，填好输入后点 Execute；输出显示 Execution Completed 才算结束。Loop 可以按设定间隔重复执行。
- **Run Script**：对实际仪器运行一个 .py 文件，可以暂停、继续或中止。脚本里有 input() 时，窗口变成交互控制台，输入答案后按回车。

实验或队列运行时，这两个工具和 Substrate Management 的机械臂点动都还能用。RUN 不检查它们会不会和正在跑的实验冲突。不要对运行中实验正在用的机械臂发命令。运行中机械臂意外移动或卡住，先查是否有人开着这些窗口。

Utilities 页的 Data Monitor 实时画出仪器读数曲线，例如温度、压力、搅拌和 pH。从 Data Tree 里选数据项加入图表，设好采样间隔、单位和坐标轴。常看的一组数据项可以存成 .dms 配置文件；需要原始数字时，用 Stream to File 写成以制表符、逗号或竖线分隔的文本文件。

## 台面、吸头和位置在运行前设好

向导第 5 步会核对台面，也可以在 Main 页提前设好。

- **Configure Deck**：给化学品和样品库指定台面位置，分 Chemicals 和 Libraries 两个页签。用 Load from design 从 .stunt 文件导入，比手动输入少出错；导入是追加，名称、行数、列数都相同的库会跳过。大改之前先 Export Current State 留一份。
- **Tip Management**：设定每个吸头架装哪种吸头，一个架只能装一种规格。Tips Remaining 记录剩余吸头数，运行之间保留。换了新的满架，点 Reset as Full；架子用过一部分，用 Select 勾出还有吸头的位置。
- **Substrate Management**：列出仪器知道的每个台面位置和容器，查看训练好的坐标、Z 高度等属性。新系统交付时机械臂和位置已训练好，大批位置用 Stuntman TRAIN 训练；这里用于查看和微调单个位置。属性 Stuntman TRAIN 为 True 的位置由 TRAIN 管理，以后 TRAIN 刷新时可能被重新计算。

吸头规格、分液类别和液体参数的设置，见 Stuntman 分液设置指南。

☰ 菜单的 Import / Export 把系统配置、训练好的台面位置、脚本、模块界面和校准打包成一个 .ulsa 文件。训练位置、调好校准或改完脚本后导出一份，出问题时能恢复到已知可用的状态。导入前，RUN 会自动把当前整套系统备份到 C:\Stuntman\Backup；导入后建议重启 RUN。

原厂建议每周按规定的关机、开机流程重启一次 Stuntman，重启前确认没有实验、队列、动作、脚本或手动移动在运行。

## SHOW 只读：选文件、选库、选运行，再点 Load

SHOW 不改设计，也不改结果，随便点都不会动到文件。窗口分上下两部分：上面选数据，下面是数据表。

- **打开文件**：点文件夹图标选 .stunt 文件。RUN 还在写这个文件时，SHOW 会等到能读取为止，等它完成比反复取消重试快。一次只能开一个文件，打开新文件会清空之前的内容。
- **选样品库**：Libraries 列出文件里所有设计用过的库，可以按名称搜索。右边 Library Info 显示板型、描述、条码。
- **选运行**：Designs - Runs 只列出在这个库里写过数据的运行，每项显示为「设计名 — 运行时间」。同一设计跑几次就有几项。按住 Ctrl 或 Shift 可以多选。
- **点 Load**：只选不点 Load，数据表不会变。换了库或运行后，数据表仍显示上次 Load 的结果，这是最容易看错的地方。

*图:选中 Reactions 库后，Designs - Runs 里列出两次运行；选好后点 Load。图取自原厂 SHOW 用户指南。*

要对比多次运行，在 Designs - Runs 里一次选好再点 Load。同一设计的重复运行可以对比，用了同名库的不同设计也可以对比。不同库的数据不能放在一张表里，要分别选库、分别载入。

Export Logs 把选中运行的原始执行日志导出为 .7z 压缩包。同一运行再次导出会覆盖旧文件，要保留先改名。

## 数据表每行一个孔，每次运行一组列

点 Load 后，下方数据表每行是库里的一个孔，分液量、工艺参数和检测读数按实验步骤排成列。左侧 Well ID 列固定不动。载入了几次运行，就有几组列，每组标着「设计名 - 运行时间」，同一孔的结果在一行里横向对比。有图像或曲线的结果在单元格里显示缩略图。

*图:数据表：两组 Actual Dispense 分别是溶剂和化学品，每组列出时间、来源、目标体积和实际体积。图取自原厂 SHOW 用户指南。*

- **按孔筛选**：左侧小板图每个孔都能勾选。点孔切换，点行号或列号切换整行整列，拖动框选。点击后立即生效。
- **选字段**：板图下面的 Field Chooser 按「实验 → 步骤 → 字段」分层勾选。勾完要点下方的刷新图标才生效；Check All、Uncheck All 和表格下方的 Reset to Default 也一样。
- **保存视图**：Save Format 把当前勾选存成 .json 文件，默认放在 C:\Stuntman\Show\Formats。以后用 Load Format 调回，换文件、换运行都能用。只存勾选，不存列宽和列顺序。

单元格里显示不全的文字，鼠标悬停可以看到全文。

## 点有图像或曲线的单元格，上方显示细节

载入的数据里有图像或曲线时，窗口上半部分分成左右两块：左边是选择区，右边是 Record Data。点数据表里的单元格，Record Data 显示这个孔这一项结果的完整内容。纯数字或文字的单元格在表里已经完整，点了不会多显示什么。

*图:Record Data 显示 A1 孔的一张图像。上下箭头换孔，左右箭头换同一孔的其他结果，右侧三个小按钮用于导出 Excel、Snap 和复制。图取自原厂 SHOW 用户指南。*

- **换孔、换结果**：面板顶部和底部的大箭头换到别的孔，保持同类结果；图两侧的小箭头在同一孔的其他图像和曲线之间切换。数据表里用方向键移动，效果一样。
- **曲线**：在任一坐标轴上拖动可以放大这一段，双击恢复全图。
- **图像**：工具栏有原尺寸、适应高度或宽度、框选放大、放大镜、平移窗口、十字线和测量，测量单位可选像素或微米。滚轮缩放。

## 临时取图用 Snap，留存记录用 Export Results

Record Data 旁的三个按钮只作用于当前这一项结果：

- **Copy to clipboard**：复制当前图像或曲线，直接粘贴到文档。复制失败时不报错，粘贴不出来就改用 Snap。
- **Snap**：把当前画面存成 Snap [n].png，不弹窗，直接存到 Data 目录。
- **Export to Excel**：只对曲线（XY）结果可用，存成 Sheet [n].xlsx 并自动打开。

Snap 和 Sheet 每次都取下一个没用过的编号，不会覆盖旧文件。删掉旧文件，编号也不会回收。

数据表下方的 Export 按钮导出当前所有可见的数据，即孔筛选和 Field Chooser 之后剩下的内容。拿不准以后要不要某个字段，先放宽筛选再一次导出。

*图:Export Results：这次运行没有曲线，XY Data 不可选。图取自原厂 SHOW 用户指南。*

- **Numerical and text data**：写成 Data.xlsx。第一页是实验信息，包括文件名、库、设计、系统和运行时间；第二页以库命名，就是屏幕上的数据表，保留分组表头。图像和曲线在这里只写成文字占位。
- **XY Data**：写成 XY_data.xlsx，每个孔的曲线占一组列，表头带坐标轴名称和单位。数据超过 Excel 行数上限会被截断。
- **Images**：每张图存成一个 .png，放在 images 子文件夹。文件名含设计名、时间、孔号和字段，能和 Data.xlsx 里的占位文字对上。

导出的文件名是固定的。每个实验单独建一个文件夹再导出；目标文件夹里已有文件时，同名文件会被覆盖，SHOW 会先提醒。

SHOW 的 ☰ 菜单里，Default save locations 设两个默认目录。Data 目录放 Snap 和单项 Excel，默认 C:\Stuntman\Show\Data。Export 目录是 Export Results 预填的目录，默认 C:\Stuntman\Show\Export。RUN 里各个 Export 按钮默认存到 C:\Stuntman\Run\Import-Export，可在 RUN 的 Preferences 里改。

- show-open · SHOW 选数据
