# 脚本 Convert 或验证不通过

- 网址:https://unchainedlabs.help/troubleshoot/stuntman-convert

CONVERT 有三个页签：Stunt-to-Python、Python-to-Stunt、Validate Stunt。先确定在哪个页签、弹的哪句话。

## 脚本有语法错误

Python-to-Stunt 页点 Validate Script 弹出 Validation Failed，列出出错位置

1. 按列出的行改掉语法错误
2. 或把报错原文贴给 Stuntman AI，让它修脚本，例如「this script fails with … can you fix it?」
3. 改完先 Validate Script，通过后再 Run Script

出处:官方手册 Stuntman AI & CONVERT User Guide p.12;官方手册 Stuntman AI & CONVERT User Guide p.23;官方手册 Stuntman AI & CONVERT User Guide p.32

## 脚本能解析，但试运行出错

弹出 Validation Error 或 Error running script: …。常见原因（名称缺失或重复、map 数据不匹配、输出文件被占用）会翻译成一句话说明

1. 按弹窗里的说明改脚本，或把原文交给 Stuntman AI 修
2. 提示输出文件被占用时，先关掉正打开这个 .stunt 文件的程序
3. 仍是看不懂的 HDF5 原始报错，说明是别的原因，把报错原文和脚本发给 support@unchainedlabs.com

出处:官方手册 Stuntman AI & CONVERT User Guide p.27;官方手册 Stuntman AI & CONVERT User Guide p.33

## Run Script 前有输入项没填

提示 Please select a valid Python script file.、Please select a valid destination folder. 或 Please enter a file name.

1. 选一个存在的 .py 文件
2. 选一个已存在的目标文件夹
3. 填 .stunt 文件名后再点 Run Script

出处:官方手册 Stuntman AI & CONVERT User Guide p.23;官方手册 Stuntman AI & CONVERT User Guide p.32

## .stunt 文件读不出，或生成的脚本有警告

Error loading designs from file: … 表示文件损坏、被占用或不是有效 .stunt；Validation Warning 表示 .py 已写出但语法检查发现问题

1. 读不出时，先关掉正打开这个文件的程序再试
2. 有 Validation Warning 时，按列出的问题检查生成的 .py
3. 提示 Error generating script 时，确认目标路径可写

出处:官方手册 Stuntman AI & CONVERT User Guide p.22;官方手册 Stuntman AI & CONVERT User Guide p.32

## 对照了别台仪器的系统配置

Validate Stunt 按选定的 SystemConfiguration.xml 检查，选错了也会判不通过

1. Select SystemConfiguration.xml 一栏改选这台设计对应的配置
2. 或清空这一栏，让 CONVERT 按设计里保存的 System Name 自动查找 C:\Stuntman\Run\Configuration 和 C:\Stuntman\Plan\Configurations 下的配置
3. 再点 Validate Design

出处:官方手册 Stuntman AI & CONVERT User Guide p.24;官方手册 Stuntman AI & CONVERT User Guide p.27

## 化学品或样品库定义不合规

粉色结果框 === Chemicals and Libraries === 下有报错，例如 Library … has invalid row count (0). Rows must be between 1 and 16.

1. 化学品名、条码、库名、库条码各自不能重复（不分大小写）
2. 库的行列数要和系统配置里同名标准库一致，并放得进台面上的载具
3. 浓度、分子量、密度填了就必须大于 0
4. 在 PLAN 第 2 步改，或让 Stuntman AI 改脚本后重新 Convert

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.25;[Save 和 Next 检查的内容不同](https://unchainedlabs.help/product/stuntman/resources/plan-guide)

## 台面位置没指定完整或有冲突

=== Chemical and Library Source Mappings === 下有报错，例如 Library Substrate Type must be selected. This field is mandatory for all libraries.

1. 每块库都要有 Substrate Type、Substrate Position 和 Initial State
2. 每个台面化学品还要有 Row/Column；填了 Amount 必须填 Unit
3. 粉末化学品必须放在 Hopper 类载具
4. Initial State 选 Capped 或 Uncapped 时必须指定盖架位置，且不能和自身位置相同
5. 同一台面位置只能放一块库或一种化学品
6. 在 PLAN 第 4 步 Configure Deck 里改

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.39;官方手册 Stuntman PLAN User Guide p.40;[位置不能重复](https://unchainedlabs.help/product/stuntman/resources/plan-guide)

## 流程步骤参数缺失或和硬件对不上

=== Recipe === 下按步骤号报错，例如 Step 19: Parameter 'Pause': Value is required for all selected wells.

1. 按步骤号找到对应步骤，给选中的孔都填上参数值
2. 步骤显示 unresolved（多在换系统之后），删掉重建
3. 分液步骤的工具、吸头、类别或 Tag 与系统配置对不上，逐个改
4. 同一化学品在几步里的单位类别或 Backsolvent/Inventory Tag 要一致

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.49;官方手册 Stuntman PLAN User Guide p.50;[常见提示和处理办法](https://unchainedlabs.help/product/stuntman/resources/plan-guide)
