SuperAPI AI 工具集

lab-hardware-cad

设计与创作

查看项目

更新于 10-21 16:19

技能介绍

Lab Hardware CAD 是一个面向实验室物理硬件设计的技能,核心思路是把硬件设计写成参数化 Python 源码,以 STEP 作为权威产物,并在制造前同时进行数值和视觉验证。

用途

该技能用于设计、建模或制造实验室物理零件,包括芯片、模具、安装件、适配器、支架、夹具、外壳、行为装置或迷宫等。也可用于检查或修改已有的 STEP 文件。它不适用于有限元分析、计算流体力学、分子结构或科学绘图,这些属于其他技能。

主要能力

技能强调接口尺寸的正确性。实验室硬件的难点通常不在几何形状,而在于零件必须与尺寸由公开标准或厂商图纸固定的设备配合。因此技能要求:在写代码前先记录每个接口的尺寸来源(公开标准、厂商图纸或用户测量)、标称值与公差、以及预期的间隙或过盈及其原因。接口尺寸必须从 assets/standards.json 或对应族参考中查找,不能凭记忆填写。

技能内置的标准 ID 包括:slas-microplate-footprint、slas-microplate-height、slas-microplate-flange、slas-well-positions-96、slas-well-positions-384、slas-well-positions-1536、cuvette-standard-10mm、optical-breadboard-metric、optical-breadboard-imperial、cage-system-30mm、sm1-lens-tube-thread。

技能按设备族路由,只加载一个族参考:微流控(芯片、模具、通道网络、流动池、垫片、流体端口)、光机(安装件、立柱、面包板适配器、笼式系统零件、光路中的滤光片或样品架)、实验室器皿适配器(板、比色皿、管、载玻片、培养皿的适配器、插件、架或支架)、行为装置(动物实验的场地、迷宫、头部固定件、出水口、系绳、挤压型材安装外壳)。

使用方式

安装命令: uv venv --python 3.12 .venv-labcad uv pip install --python .venv-labcad/bin/python "build123d==0.11.1" "matplotlib>=3.8"

build123d 0.11.1 要求 Python >=3.10,<3.15,并通过 cadquery-ocp-novtk 引入 OpenCascade 内核。所有捆绑脚本都支持 --help。check.py standards 无需安装 build123d 即可运行。

模型文件是被执行而非解析的。gen.py、check.py 和 snapshot.py 会导入 *_model.py 并调用其 build(),这会在当前环境中运行任意 Python 代码。这是参数化 CAD 的固有特性——源码即设计。只应运行本次会话编写的模型文件,或用户从可信位置提供的文件。如果模型来自互联网、共享驱动器或不可信的同事,应先阅读再运行,并说明已这样做。

必需工作流按顺序执行:

  1. 路由到设备族:读取请求、分类,只加载一个族参考。如果零件确实跨越两个族,加载拥有关键接口的族,再只读第二个族的接口部分,并在回复中说明路由到哪个族。

  2. 在几何之前确定接口尺寸:每个零件至少有一个配合接口。写代码前,为每个接口写下尺寸来源、标称值与公差、预期间隙或过盈及原因。必须接收标准化组件的特征应按该组件的最大实体条件(标称加正公差)确定尺寸,然后再给间隙。

  3. 先选工艺再选几何:阅读 references/fabrication-limits.md。工艺决定最小壁厚、最小特征、可达公差,以及零件能否经受高压灭菌或接触溶剂。FDM 无法保持 ±0.05 mm;SLA 树脂通常未经后固化和测试不适合接触细胞。在模型 docstring 中记录工艺和材料。

  4. 编写参数化模型:写 <part>_model.py。源码是权威产物——绝不手工编辑导出的 STEP 文件,也绝不从网格重新生成。要求包括:每个用户可能更改的尺寸都是模块级命名常量,名称带单位(如 bore_d_mm、wall_t_mm、post_h_mm);除 0、1、2 外,主体中不得出现裸数字;暴露 build() -> Part;参数分为 INTERFACE 块(由标准固定,标注标准 ID)和 DESIGN 块(自由选择);所有计算尺寸在函数内派生,而非模块级,以便 --param 覆盖生效;声明 interfaces() 函数返回零件必须适配的尺寸,每个带标准 ID 和 intent;声明 checks() 函数,包含从构建实体测量的通止规;在模块 docstring 中写明工艺、材料和每个接口来源。

  5. 生成并运行检查: python scripts/gen.py carrier_model.py --outdir out/ python scripts/check.py facts out/carrier.step python scripts/check.py interfaces out/carrier.manifest.json python scripts/check.py geometry out/carrier.step --model carrier_model.py

gen.py 还会针对刚构建的实体评估模型的 checks() 规,打印每个 PASS/FAIL,记录到 manifest,失败时以非零退出。check.py geometry 对导出的 STEP 重新运行相同规。gen.py 写出 carrier.step(权威)、carrier.stl(网格预览和打印)和 carrier.manifest.json,记录源码哈希、解析参数、声明的接口、库版本以及测量的包围盒、体积和有效性。manifest 是溯源记录,应与产物一起保留。check.py facts 报告 is_valid、包围盒、体积、表面积、质心和实体数量。check.py interfaces 针对标准数据库评估模型声明的每个条目,失败时以非零退出;它检查声明的数字,但从不测量构建的几何。对于装配体,可用 check.py clearance 检查零件是否干涉。

  1. 快照并实际查看: python scripts/snapshot.py out/carrier.step --out out/carrier.png 然后读取 PNG。每次生成和修改后都必须执行此步骤。确定性检查通过不是跳过它的理由。六视图是真正的正交投影,轮廓是模型的真实边,未做隐藏线消除,因此“透过”材料可见的圆是远侧的孔,而非窗口。对于图像无法分辨的微小特征,可用 check.py bores 打印每个圆柱面,或用 check.py probe 回答一次性的“此区域是否畅通/此处是否有材料”。

  2. 通过源码修复:如果任何检查失败,编辑参数或模型代码,重新运行 gen.py,并重新运行步骤 5 和 6。绝不修补 STEP。

  3. 制造前报告:参考 references/validation.md,向用户提供工艺和材料、每个接口尺寸及其来源和公差、所选间隙、快照显示的内容,以及任何未通过的检查。明确标记自动检查无法覆盖的每个接口。

适用场景

适用于需要与标准或厂商设备配合的实验室硬件设计,如微流控芯片与模具、光学安装件、实验室器皿适配器、动物行为装置等。

限制

不适用于有限元分析、计算流体力学、分子结构或科学绘图。模型文件会被执行,存在运行任意代码的风险,只应运行可信来源的模型。check.py interfaces 只检查声明的数字,不测量几何,不能作为几何正确的证据。快照有分辨率限制,微小特征可能无法从视图中判断。公差表中的间隙值是首件起点而非保证,建议在制造完整零件前先打印关键接口的测试样件。单位方面,build123d 内部无单位,本技能全部使用毫米和度,export_step 以 Unit.MM 调用。英制硬件在光机中常见,应在定义点用单个命名常量转换为毫米,绝不在表达式内混用单位。1 英寸恰好为 25.4 mm,25 mm 公制光学网格与 1 英寸英制网格不可互换,四个孔上误差会累积到 1.6 mm。