动物行为实验装置 CAD 设计指南行为学围栏、迷宫与头部固定装置工程规范lab-hardware-cad 技能实战【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills导读本文围绕scientific-agent-skills仓库中 lab-hardware-cad 技能的 behavior-rigs 参考文档系统讲解动物行为实验装置行为学围栏、迷宫、头部固定硬件、饮水嘴/接口与承载它们的 T 型槽铝型材框架的工程化建模规范。你将掌握为什么行为装置尺寸必须来自协议而非行业标准、IACUC 法规与动物福利对 CAD 设计的约束、材料与清洁方案的取舍逻辑、视频追踪对几何的要求、T 型槽型材框架的选型要点以及如何在 lab-hardware-cad 的gen.py/check.py/snapshot.py脚本流水线中落地这些要求并完成交付前的验证。一、设计前提尺寸来自协议不来自参考文件行为学装置behavioral apparatus的几何尺寸不存在标准化。这是 behavior-rigs.md 反复强调的第一原则装置尺寸由实验所复现的已发表协议决定并随物种、品系、年龄和实验室不同而变化为大鼠设计的高架十字迷宫elevated plus maze对小鼠是错误的依据某篇论文做的旷场open field换一篇论文可能无法复现其结果。因此建模的第一步不是画图而是询问该实验装置复现的是哪份协议或论文并从其中取得尺寸。如果用户没有对应协议必须明确说明几何尺寸属于影响实验结果可比性的设计选择并在建模前取得用户对具体数值的确认。文档特别警告不要凭记忆提供标准迷宫尺寸——不存在这样的标准。一个看起来合理但错误的数字比坦诚承认缺失更糟糕因为它会静默地破坏与既往工作的比较。这份参考文档覆盖的是跨装置通用的工程问题材料、清洁、追踪、型材框架、头部固定、给水接口而不是具体尺寸。尺寸相关的部分必须以协议和实物如植入件为准。二、法规与动物福利上下文CAD 建模前的前置检查任何与动物接触的装置都处于机构批准的实验方案管辖之下。在制造之前模型必须满足以下约束behavior-rigs.md 原文要求主动提出这些问题而不是等被问到与已批准的 IACUC或当地等效机构方案一致。任何几何变更——更窄的臂、不同的头板、新的束缚装置——都可能需要方案修订。建模者应当标记这一点而不是自行决定。材料必须无毒、无刺激性包括在反复清洁之后依然如此。无夹持或挤压几何不能有能卡住肢体、尾巴或头部的缝隙不能有逐渐变窄、最终形成陷阱的楔形缝隙。动物能够触达的所有边缘都要倒圆角/去锐边。任何悬于动物上方的承重部件必须留有真实的安全余量不能按最小壁厚打印。这些约束直接进入 fabrication-limits.md 的材料与工艺章节FDM 的 ±0.3 mm 公差与 1.2 mm 最小壁厚3 × 0.4 mm 喷嘴、SLA 的 ±0.1 mm 公差与 0.8 mm 最小壁厚等都决定了承重部件能否成立。三、材料与清洁决定材料选择的头号约束清洁方案支配材料选择并排除了大多数显而易见的选项清洁/消毒手段对材料的影响70% 乙醇使多种塑料产生银纹crazing丙烯酸PMMA尤其严重见 fabrication-limits.md 化学部分季铵盐类、二氧化氯类消毒剂侵蚀其他塑料高压灭菌autoclave121 ℃使任何低玻璃化转变温度的材料变形PLA 在远低于灭菌温度时就已软化应视为一次性使用其他关键点孔隙度携带气味。FDM 部件因工艺而天然多孔会在动物之间保留气味线索且无法可靠消毒。气味是行为学实验中真实的混杂因素confound。优先选择非多孔工艺或密封表面或将 FDM 部件当作耗材、按队列per-cohort使用。抗啃咬。啮齿类动物会啃咬一切可触达的东西。暴露边缘的打印聚合物会被破坏更糟的是被吞食。在动物可能咬到的位置使用金属、玻璃或硬质牺牲边缘并尽可能让打印材料远离动物可及范围。未固化的树脂具有细胞毒性并具刺激性。与动物接触的 SLA 部件需要完全后固化post-cure和彻底清洗。详见 fabrication-limits.md 的生物相容性章节——生物相容标签针对的是特定认证工艺与应用不能迁移到你的打印机、你的固化日程或你的实验。与之呼应validation.md 的制造前检查清单第 6 项要求材料必须与清洁剂兼容而不仅是与样品兼容灭菌方法必须明确说明且材料确实能承受接触细胞/组织/动物的部件必须有合理的材料依据或设计成不接触。四、视频追踪与光学几何要么帮助追踪要么对抗追踪大多数行为学装置都会被录像几何会直接影响追踪器tracker的表现对比度表面颜色应与动物毛色匹配以便追踪器分割。深色动物用哑光白或浅灰地板白化动物用哑光深色地板。必须哑光不能亮面——镜面高光会被追踪器当作对象。避免在地面附近产生投影的几何。低机位下深壁会造成阴影带追踪器会将其分割为动物。红外照明许多不透明的黑色塑料会透射红外光红外透明地板会改变表观图像。必须用实际相机验证不能凭假设。为整个实验区域保留清晰无遮挡的相机视线并将相机支架作为装置的一部分建模这样视场field of view能在制造前被检查而不是制造后才发现问题。五、T 型槽铝型材框架槽宽不由型材规格决定大多数行为装置建在铝型材上。最关键的事实是槽宽不由型材截面规格决定。型材常见槽宽典型紧固件20 × 20 mm视系列不同为 5 mm 或 6 mmM4 或 M5 T 型螺母30 × 30 mm通常 8 mmM6 T 型螺母40 × 40 mm视系列不同为 8 mm 或 10 mmM6 或 M8 T 型螺母一家供应商的 20 mm 型材配 6 mm 槽螺母另一家的则配 5 mm。测量槽宽或取得零件号。为错误槽宽建模的支架就是废件。设计要点支架的安装特征应沿型材轴线开长槽slot。这正是型材的意义——位置连续可调一个固定孔就丢弃了这个优势。这与 validation.md 第 4 项刚性多孔安装模式至少有一个槽相呼应避免四孔螺栓模式在累积公差上卡死。型材面是基准。支架应设计为紧贴一个面并尽可能卡入槽内使部件在负载下不会旋转。承载相机或重型部件的打印支架应视为原型。聚合物在持续负载下会蠕变相机将缓慢下垂而失去对准。六、头部固定本文件后果最严重的几何头部固定head fixation是行为装置中后果最严重的几何且完全依赖实验室头板或头柱接口必须来自实验室实际使用的植入件以图纸或测量值形式提供。没有标准。必须拿到实物数据。运动学要求是可重复、无间隙地约束植入件夹持力不能使头板偏转。间隙会直接转化为成像或记录中的运动伪影motion artefact。固定硬件必须快速释放既为常规操作也为紧急情况。打印夹具会弯曲。任何承受头部固定负载的部件应推荐机加工金属件打印版本仅作为装配校验原型。必须明确说明这一点——这既是福利问题也是数据质量问题。七、饮水嘴、接口与奖励输送饮水嘴材料必须无毒且可清洁通常选择不锈钢管由打印载体固定且载体本身绝不接触动物口腔。位置是被校准的实验变量。饮水嘴位置必须可调且可读数并记录在 manifest 中以便跨实验会话和动物复现。这正是 gen.py 生成的*.manifest.json的用途——记录解析后的参数、声明接口、库版本与测量几何作为溯源记录。对奖励管线reward line的死体积建模——阀到饮水嘴之间的延迟是实验参数。死体积公式见 microfluidics.mdV π·r²·L圆管/孔或V w·h·L矩形通道并应报告每条连接孔道与通道网络的体积。若舔舐检测为电容式则让导电材料远离传感元件并在模型中为导线定义明确的、带应力释放的走线路径。八、在 lab-hardware-cad 流水线中落地从模型到验证behavior-rigs 文档给出了针对行为装置的验证命令序列它们是 SKILL.md 第 5、6 步生成并运行检查快照并真正查看在行为装置上的具体化python scripts/gen.py arena_model.py --outdir out/ python scripts/check.py facts out/arena.step python scripts/check.py clearance out/arena.step out/camera_mount.step --min 1.0 python scripts/snapshot.py out/arena.step --out out/arena.png各命令的作用与底层实现gen.py导入arena_model.py并调用其build()导出 STEP权威产物、STL网格预览与打印与arena.manifest.json溯源记录源哈希、解析后参数、声明接口、库版本、测量包围盒/体积/有效性。从 gen.py 源码 可以看到gen.py还会对刚构建的实体评估模型声明的checks()量规逐条打印 PASS/FAIL 并写入 manifest任一失败即非零退出——违反自身声明几何的部件永远不会静默变成产物。check.py facts报告is_valid、包围盒、体积、表面积、质心与实体数量。is_valid: false即破碎几何先修源码再继续。check.py clearance a b --min MM计算两个实体间的最小距离检测干涉。从 check.py 源码 的cmd_clearance可以看到它先计算交集体积 1e-6 mm³ 判为干涉无干涉时再求最小间距与--min比较给出 PASS/FAIL。示例中--min 1.0即要求相机支架与围栏之间至少 1.0 mm 间隙。snapshot.py渲染六视图正投影与等轴测图供强制目视审查。从 snapshot.py 源码 可以看到视图是真实正投影orthographic轮廓线是模型的真实 BREP 边、不做隐藏线消除——所以透过材料看到的圆是远侧孔不是窗口部件并不透明。在快照中必须确认behavior-rigs.md 的检查清单没有任何动物能伸入肢体、尾巴或头部的缝隙所有动物可触达的边缘均已倒角无尖锐拐角相机对整个地面有畅通视野型材安装特征是开槽的且位于你实际能用工具够到的面上没有任何打印件处于会被啃咬的位置。其中第 1、2 项还可进一步用check.py geometry对导出的 STEP 复跑模型的checks()量规和check.py probe临时问该区域是否无材料/有材料做数值化支撑——文档明确指出这些正是is_valid与包围盒看不到的错误类型。九、行为装置的接口声明与制造前报告行为装置通常不匹配 standards.json 中捆绑的标准SLAS 微孔板、光学面包板、30 mm cage 系统等此时模型的interfaces()返回空列表是正确的。但按 SKILL.md 与 validation.md 的要求每个接口尺寸必须有书面来源标准 ID、厂商图纸或用户测量任何一项都不来自记忆未覆盖任何捆绑标准的接口厂商图纸、用户测量、无标准可查的迷宫尺寸必须在报告中明确标注为未校验unchecked并给出数值与来源严禁为填补空白而对无关标准做虚假声明——伪造的声明比诚实的无人校验过更糟。这也正是 behavior-rigs 文档的核心理念在流水线中的体现行为装置的尺寸必须来自被复现的协议或实物植入件而不是来自通用参考。材料、清洁、追踪与型材方面的指导属于通用工程实践可以直接采用而任何具体的迷宫、围栏与头部固定几何都必须回到协议与实物。十、来源说明文档 behavior-rigs.md 的Sources一节明确指出尺寸方面有意不提供任何通用来源。迷宫、围栏与头部固定几何必须来自被复现的协议或实物植入件。材料、清洁、追踪与型材指导属于通用工程实践。本文所有命令、参数与脚本行为均以仓库实际源码gen.py、check.py、snapshot.py与测试tests/lab-hardware-cad/test_scripts.py为准。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 动物行为实验装置 CAD 设计指南：行为学围栏、迷宫与头部固定装置工程规范（lab-hardware-cad 技能实战）
动物行为实验装置 CAD 设计指南行为学围栏、迷宫与头部固定装置工程规范lab-hardware-cad 技能实战【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills导读本文围绕scientific-agent-skills仓库中 lab-hardware-cad 技能的 behavior-rigs 参考文档系统讲解动物行为实验装置行为学围栏、迷宫、头部固定硬件、饮水嘴/接口与承载它们的 T 型槽铝型材框架的工程化建模规范。你将掌握为什么行为装置尺寸必须来自协议而非行业标准、IACUC 法规与动物福利对 CAD 设计的约束、材料与清洁方案的取舍逻辑、视频追踪对几何的要求、T 型槽型材框架的选型要点以及如何在 lab-hardware-cad 的gen.py/check.py/snapshot.py脚本流水线中落地这些要求并完成交付前的验证。一、设计前提尺寸来自协议不来自参考文件行为学装置behavioral apparatus的几何尺寸不存在标准化。这是 behavior-rigs.md 反复强调的第一原则装置尺寸由实验所复现的已发表协议决定并随物种、品系、年龄和实验室不同而变化为大鼠设计的高架十字迷宫elevated plus maze对小鼠是错误的依据某篇论文做的旷场open field换一篇论文可能无法复现其结果。因此建模的第一步不是画图而是询问该实验装置复现的是哪份协议或论文并从其中取得尺寸。如果用户没有对应协议必须明确说明几何尺寸属于影响实验结果可比性的设计选择并在建模前取得用户对具体数值的确认。文档特别警告不要凭记忆提供标准迷宫尺寸——不存在这样的标准。一个看起来合理但错误的数字比坦诚承认缺失更糟糕因为它会静默地破坏与既往工作的比较。这份参考文档覆盖的是跨装置通用的工程问题材料、清洁、追踪、型材框架、头部固定、给水接口而不是具体尺寸。尺寸相关的部分必须以协议和实物如植入件为准。二、法规与动物福利上下文CAD 建模前的前置检查任何与动物接触的装置都处于机构批准的实验方案管辖之下。在制造之前模型必须满足以下约束behavior-rigs.md 原文要求主动提出这些问题而不是等被问到与已批准的 IACUC或当地等效机构方案一致。任何几何变更——更窄的臂、不同的头板、新的束缚装置——都可能需要方案修订。建模者应当标记这一点而不是自行决定。材料必须无毒、无刺激性包括在反复清洁之后依然如此。无夹持或挤压几何不能有能卡住肢体、尾巴或头部的缝隙不能有逐渐变窄、最终形成陷阱的楔形缝隙。动物能够触达的所有边缘都要倒圆角/去锐边。任何悬于动物上方的承重部件必须留有真实的安全余量不能按最小壁厚打印。这些约束直接进入 fabrication-limits.md 的材料与工艺章节FDM 的 ±0.3 mm 公差与 1.2 mm 最小壁厚3 × 0.4 mm 喷嘴、SLA 的 ±0.1 mm 公差与 0.8 mm 最小壁厚等都决定了承重部件能否成立。三、材料与清洁决定材料选择的头号约束清洁方案支配材料选择并排除了大多数显而易见的选项清洁/消毒手段对材料的影响70% 乙醇使多种塑料产生银纹crazing丙烯酸PMMA尤其严重见 fabrication-limits.md 化学部分季铵盐类、二氧化氯类消毒剂侵蚀其他塑料高压灭菌autoclave121 ℃使任何低玻璃化转变温度的材料变形PLA 在远低于灭菌温度时就已软化应视为一次性使用其他关键点孔隙度携带气味。FDM 部件因工艺而天然多孔会在动物之间保留气味线索且无法可靠消毒。气味是行为学实验中真实的混杂因素confound。优先选择非多孔工艺或密封表面或将 FDM 部件当作耗材、按队列per-cohort使用。抗啃咬。啮齿类动物会啃咬一切可触达的东西。暴露边缘的打印聚合物会被破坏更糟的是被吞食。在动物可能咬到的位置使用金属、玻璃或硬质牺牲边缘并尽可能让打印材料远离动物可及范围。未固化的树脂具有细胞毒性并具刺激性。与动物接触的 SLA 部件需要完全后固化post-cure和彻底清洗。详见 fabrication-limits.md 的生物相容性章节——生物相容标签针对的是特定认证工艺与应用不能迁移到你的打印机、你的固化日程或你的实验。与之呼应validation.md 的制造前检查清单第 6 项要求材料必须与清洁剂兼容而不仅是与样品兼容灭菌方法必须明确说明且材料确实能承受接触细胞/组织/动物的部件必须有合理的材料依据或设计成不接触。四、视频追踪与光学几何要么帮助追踪要么对抗追踪大多数行为学装置都会被录像几何会直接影响追踪器tracker的表现对比度表面颜色应与动物毛色匹配以便追踪器分割。深色动物用哑光白或浅灰地板白化动物用哑光深色地板。必须哑光不能亮面——镜面高光会被追踪器当作对象。避免在地面附近产生投影的几何。低机位下深壁会造成阴影带追踪器会将其分割为动物。红外照明许多不透明的黑色塑料会透射红外光红外透明地板会改变表观图像。必须用实际相机验证不能凭假设。为整个实验区域保留清晰无遮挡的相机视线并将相机支架作为装置的一部分建模这样视场field of view能在制造前被检查而不是制造后才发现问题。五、T 型槽铝型材框架槽宽不由型材规格决定大多数行为装置建在铝型材上。最关键的事实是槽宽不由型材截面规格决定。型材常见槽宽典型紧固件20 × 20 mm视系列不同为 5 mm 或 6 mmM4 或 M5 T 型螺母30 × 30 mm通常 8 mmM6 T 型螺母40 × 40 mm视系列不同为 8 mm 或 10 mmM6 或 M8 T 型螺母一家供应商的 20 mm 型材配 6 mm 槽螺母另一家的则配 5 mm。测量槽宽或取得零件号。为错误槽宽建模的支架就是废件。设计要点支架的安装特征应沿型材轴线开长槽slot。这正是型材的意义——位置连续可调一个固定孔就丢弃了这个优势。这与 validation.md 第 4 项刚性多孔安装模式至少有一个槽相呼应避免四孔螺栓模式在累积公差上卡死。型材面是基准。支架应设计为紧贴一个面并尽可能卡入槽内使部件在负载下不会旋转。承载相机或重型部件的打印支架应视为原型。聚合物在持续负载下会蠕变相机将缓慢下垂而失去对准。六、头部固定本文件后果最严重的几何头部固定head fixation是行为装置中后果最严重的几何且完全依赖实验室头板或头柱接口必须来自实验室实际使用的植入件以图纸或测量值形式提供。没有标准。必须拿到实物数据。运动学要求是可重复、无间隙地约束植入件夹持力不能使头板偏转。间隙会直接转化为成像或记录中的运动伪影motion artefact。固定硬件必须快速释放既为常规操作也为紧急情况。打印夹具会弯曲。任何承受头部固定负载的部件应推荐机加工金属件打印版本仅作为装配校验原型。必须明确说明这一点——这既是福利问题也是数据质量问题。七、饮水嘴、接口与奖励输送饮水嘴材料必须无毒且可清洁通常选择不锈钢管由打印载体固定且载体本身绝不接触动物口腔。位置是被校准的实验变量。饮水嘴位置必须可调且可读数并记录在 manifest 中以便跨实验会话和动物复现。这正是 gen.py 生成的*.manifest.json的用途——记录解析后的参数、声明接口、库版本与测量几何作为溯源记录。对奖励管线reward line的死体积建模——阀到饮水嘴之间的延迟是实验参数。死体积公式见 microfluidics.mdV π·r²·L圆管/孔或V w·h·L矩形通道并应报告每条连接孔道与通道网络的体积。若舔舐检测为电容式则让导电材料远离传感元件并在模型中为导线定义明确的、带应力释放的走线路径。八、在 lab-hardware-cad 流水线中落地从模型到验证behavior-rigs 文档给出了针对行为装置的验证命令序列它们是 SKILL.md 第 5、6 步生成并运行检查快照并真正查看在行为装置上的具体化python scripts/gen.py arena_model.py --outdir out/ python scripts/check.py facts out/arena.step python scripts/check.py clearance out/arena.step out/camera_mount.step --min 1.0 python scripts/snapshot.py out/arena.step --out out/arena.png各命令的作用与底层实现gen.py导入arena_model.py并调用其build()导出 STEP权威产物、STL网格预览与打印与arena.manifest.json溯源记录源哈希、解析后参数、声明接口、库版本、测量包围盒/体积/有效性。从 gen.py 源码 可以看到gen.py还会对刚构建的实体评估模型声明的checks()量规逐条打印 PASS/FAIL 并写入 manifest任一失败即非零退出——违反自身声明几何的部件永远不会静默变成产物。check.py facts报告is_valid、包围盒、体积、表面积、质心与实体数量。is_valid: false即破碎几何先修源码再继续。check.py clearance a b --min MM计算两个实体间的最小距离检测干涉。从 check.py 源码 的cmd_clearance可以看到它先计算交集体积 1e-6 mm³ 判为干涉无干涉时再求最小间距与--min比较给出 PASS/FAIL。示例中--min 1.0即要求相机支架与围栏之间至少 1.0 mm 间隙。snapshot.py渲染六视图正投影与等轴测图供强制目视审查。从 snapshot.py 源码 可以看到视图是真实正投影orthographic轮廓线是模型的真实 BREP 边、不做隐藏线消除——所以透过材料看到的圆是远侧孔不是窗口部件并不透明。在快照中必须确认behavior-rigs.md 的检查清单没有任何动物能伸入肢体、尾巴或头部的缝隙所有动物可触达的边缘均已倒角无尖锐拐角相机对整个地面有畅通视野型材安装特征是开槽的且位于你实际能用工具够到的面上没有任何打印件处于会被啃咬的位置。其中第 1、2 项还可进一步用check.py geometry对导出的 STEP 复跑模型的checks()量规和check.py probe临时问该区域是否无材料/有材料做数值化支撑——文档明确指出这些正是is_valid与包围盒看不到的错误类型。九、行为装置的接口声明与制造前报告行为装置通常不匹配 standards.json 中捆绑的标准SLAS 微孔板、光学面包板、30 mm cage 系统等此时模型的interfaces()返回空列表是正确的。但按 SKILL.md 与 validation.md 的要求每个接口尺寸必须有书面来源标准 ID、厂商图纸或用户测量任何一项都不来自记忆未覆盖任何捆绑标准的接口厂商图纸、用户测量、无标准可查的迷宫尺寸必须在报告中明确标注为未校验unchecked并给出数值与来源严禁为填补空白而对无关标准做虚假声明——伪造的声明比诚实的无人校验过更糟。这也正是 behavior-rigs 文档的核心理念在流水线中的体现行为装置的尺寸必须来自被复现的协议或实物植入件而不是来自通用参考。材料、清洁、追踪与型材方面的指导属于通用工程实践可以直接采用而任何具体的迷宫、围栏与头部固定几何都必须回到协议与实物。十、来源说明文档 behavior-rigs.md 的Sources一节明确指出尺寸方面有意不提供任何通用来源。迷宫、围栏与头部固定几何必须来自被复现的协议或实物植入件。材料、清洁、追踪与型材指导属于通用工程实践。本文所有命令、参数与脚本行为均以仓库实际源码gen.py、check.py、snapshot.py与测试tests/lab-hardware-cad/test_scripts.py为准。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考