Lunatic 自动化整合指南(系列索引)

系列指南 · 7 篇 · 约 85 分钟

Lunatic 自动化整合指南

把 Lunatic 接进 NGS 工作流、液体工作站、协作机械臂、LIMS 或自有调度平台，需要做的事按官方 Lunatic API Manual（Rev D，2026-04 发布）拆成 6 篇。这 6 篇按 4 个阶段排开：判断（#01）、准备（#02-#03）、写脚本（#04-#05）、交付（#06）。另有一份快速操作指南（QSG），把首次接通最少要做的激活、验证、切换放在一页里。

系列结构

按角色挑入口

全部内容

• Lunatic API 快速操作指南 · lunatic-api-07-quick-start · 先认 5 个名词，再按 7 步激活、2 步验证（单机和远端各验通一次），最后处理单机与 API 模式的切换。照着做完这一页，仪器就能被脚本调用。 · 想最快跑通流程的所有人 · quickstart
• 什么是 Lunatic 自动化整合 · lunatic-api-01-intro · 读完能判断实验室要不要接入自动化。内容包括单机与集成模式的差别、需要整合的场景（NGS、LIMS、机械臂）和整合前要备的 5 件事。最后给出一次测量的命令大致顺序，以及 Beam Therapeutics + GSK 的真实案例。 · 实验室科学家、项目立项阶段的判断者 · decide
• Lunatic 装上工作台：板、销、坐标 · lunatic-api-02-physical-integration · 机械臂要找准 Lunatic，靠的是这篇给出的精确坐标、SBS 标准 96 板尺寸、12 mm 定位销规格和 CODE128 整板条码扫描位。加样还有两条要求：针不碰孔壁，液滴要碰孔壁。 · 负责机械臂集成、工作台开孔、机柜布置的工程师 · prepare
• Lunatic Client 一次性配置：让脚本能调用仪器 · lunatic-api-03-software-setup · 这几项配齐，脚本才能调用仪器。它们都在 Lunatic & Stunner Client 软件的 Automation 页面：激活 API License、Transfer Apps、配 Network Settings 网络共享目录、设 DHCP/固定 IP、存空白。USB 和 TCP 不可同时启用。 · 现场调试工程师、IT 配合人员 · prepare
• Lunatic API 19 个命令：分类、流程、细节 · lunatic-api-04-commands · 19 个 API 命令按职责分四组：会话控制 / 仪器信息 / 测量动作 / 辅助命令。DQ_Measure 是异步执行的，单独拆开讲。另含标准测量流程表、完整命令一览、容易写错的细节和状态码体系。 · 写脚本调度的开发，以及想理解 Lunatic 远程控制原理的人 · build
• Lunatic API 三段字符串：实验、样品、结果 · lunatic-api-05-interface-strings · 脚本和仪器之间靠三段字符串传数据：实验定义、样品定义和结果定义。这篇逐段拆字段，讲列号映射（-1 跳过）和 blanking_information 五种用法，附单 group / 多 group 完整示例。 · 写脚本的开发、做应用集成调参的应用科学家 · build
• Lunatic 自动化交付：验证、速查、示例与清单 · lunatic-api-06-validation · 湿跑验证由简到繁跑四轮，出错时对照完整中文状态码速查表和 8 种常见错误的应对策略。另附 Lunatic 仪器与 Lunatic Plate 尺寸图和端到端 C# 示例。合规部分给出 Lunatic IQ/OQ/PV 材料指引和项目交付清单。 · 负责验收、维护、交付的工程师 · deliver
• 想最快接通仪器 · 读快速操作指南（QSG，8 分钟），照着做完激活、验通和 USB ↔ TCP 切换，仪器就能被脚本调用。
• 实验室科学家 / 项目负责人 · 读第 1 篇判断要不要接入自动化，再看第 6 篇的交付清单，中间四篇按需查。
• 机械臂 / 物理集成工程师 · 以第 2 篇为主线，第 6 篇的图纸速查放在案头，第 4 篇说明脚本会驱动仪器做哪些动作。
• 脚本 / 软件开发 · 先用 QSG 跑通，再依次读第 3 篇配置 → 第 4 篇命令体系 → 第 5 篇字符串字段 → 第 6 篇状态码处理。
• 应用 / 现场支持 · 现场配置回第 3 篇，选 blanking 方式查第 5 篇，解释负数状态码查第 6 篇。
• structure · 系列结构
• roles · 按角色挑入口
• articles · 全部内容