船体设计这行干久了你会发现一个规律很多活儿都是重复性的一批同样的肘板、一组相似的加强筋、一连串要修改的零件属性仔细一看全是一个套路。Tribon M3里手工操作一遍能累得眼花而且出错率不低。所以早些年有经验的船体设计师都会偷偷学一点Vitesse把这套重复工作用脚本跑掉。这篇文章就写给那些想入门Tribon M3环境下Vitesse开发的同行不讲虚的直接把我的踩坑经历和代码思路拿出来拆。Vitesse本质上就是Tribon M3内置的一套脚本语言语法风格接近VB用来驱动Tribon的设计数据模型。它不像Python或C#那样要额外搭环境就寄生在Tribon系统里跟着设计环境走能直接读写当前船体模型里在用的那些平面、零件、组件信息。我一直觉得Tribon的自动化能力一大半都体现在Vitesse上学会它差不多等于拿到了船体建模的“半自动钥匙”。1. 认识Tribon Vitesse船体设计自动化脚本到底能干嘛1.1 为什么船体设计流程需要Vitesse先聊聊背景。Tribon M3这个软件在船厂用得极其广泛散货船、集装箱船、油轮的船体结构建模都靠它。但越是主流软件越会暴露一个问题标准操作路径覆盖不了所有个性化重复劳动。举个例子某个分段里有60档肋位每一档在同样位置都要建一块肘板。手工做法是什么选中基准面建板、选轮廓、定义板厚、填材料、指定名称、调整位置一档来一遍60遍下来人基本麻了。更麻烦的是如果后面某个尺寸改了你还得一个个去改漏掉一个就是现场返工。Vitesse就是来解决这种场景的。它把Tribon里的建模动作拆成一个个接口调用比如“创建一个板零件”“设置板厚”“读取某根型材的端点坐标”然后用For循环把60档肋位全部跑一遍。只要几何规则定清楚了改一个参数整批零件跟着更新。这节省下来的不只是时间更是把人的出错概率降下来了。另外Tribon里的命名规范也是个大工程。船体零件名字往往有严格的规则比如“S01-P02-T15”这种包含了分段号、零件类型、厚度信息。手工一个个敲名字既容易被罚款视力又容易拼错。Vitesse配合命名规则文件可以在创建零件的同时自动套用命名后缀、前缀、厚度分段全部自动生成这在后期出图和材料统计时省了大事。1.2 Vitesse与Tribon M3的版本关系很多人会混淆Vitesse和Tribon M3这两个概念。简单说Tribon M3是平台Vitesse是花在平台上的脚本语言。Tribon M3是我工作以来接触过的V版本里最稳定的一个也正因为如此至今还有大量船厂在用它。Tribon的后续版本比如AVEVA Marine系列虽然功能更强但底层的迁移成本很高不少老系统里的Vitesse脚本还在生产线扛着。这里要特别说一下Vitesse脚本开发在很多老船厂里是一门“传帮带”的手艺。你在船上任老师傅可能手里有一堆写好的.vso文件改改参数就能直接用。这些脚本中等规模的有几百行关系着生产设计的很多环节。所以新人学Vitesse不只是学语法更是在继承一套船厂自己的逻辑。这也是我坚持写这套教程的原因希望能帮你把底子打好遇到别人的脚本你能看得懂自己也能从零写出来。2. Vitesse开发环境与语法基础2.1 开发环境在哪Tribon里的Design环境要写Vitesse先得知道在哪儿写。打开Tribon M3后进入Design模块你会看到侧边栏有模型树、平面列表和各种功能菜单。Vitesse脚本不是在外部编辑器里写的它可以直接在Design环境里打开一个内置的Editor窗口新建一个宏Macro文件来编写。具体路径其实比较灵活我习惯是在Design的菜单栏里找“File”下的“New”选择宏文件.vso系统就会弹出一个带语法高亮的编辑界面。写完之后在Editor里点执行按钮脚本会直接从当前激活的平面上下文开始运行。这里有一件非常重要的事Vitesse脚本运行时很多操作是依赖“当前上下文”的具体来说就是当前激活的平面Plane和当前设计区域。你在界面上看到的是哪一层、哪块区域脚本运行时的很多查询和创建操作就会默认围绕这个上下文展开。所以我写脚本时第一步永远是显式指定平面或坐标系绝不依赖“当前正好激活在哪儿”这种不确定状态。后面会详细说。另外Tribon M3的帮助文档里自带Vitesse的函数说明和对象模型树路径一般在安装目录下的Help文件夹里。网上很多人问“怎么学Vitesse”我真心推荐先学会查这份离线帮助每个函数有哪些参数、返回值是什么全写得很清楚比任何二手教程都好用。2.2 语法基础跟VB类似的脚本结构Vitesse的语法跟Visual Basic非常接近如果你写过VBA上手几乎无压力。整个脚本结构通常包括变量声明、对象获取、循环判断、调用函数几个部分。一个最基础的结构大概长这样Dim objProject As Object Dim objItem As Object Dim strName As String Set objProject GetObject(Tribon.ProjectManager) strName InputBox(请输入分段名称) MsgBox 当前分段是 strName这段代码不复杂核心逻辑就是声明变量、获取项目管理对象、弹出输入框接收参数。写到这里你会发现Vitesse本质上就是用Basic语法去调用Tribon暴露出来的各种COM对象接口。变量命名我建议统一用小驼峰或前缀法比如obj前缀表示对象、str前缀表示字符串、int表示整数。Tribon的脚本大多数是几百行起步的命名清晰了自己三个月后再看还能一眼看懂。Vitesse对错误处理不像高级语言那么优雅常见的做法是用On Error Resume Next跳过非致命错误然后在关键步骤后用Err.Number做校验。但有一点必须提醒你虽然脚本看起来像VB但它对NULL值的处理、对象引用生命周期的管理有自己的脾气后文我会专门列几个容易踩的坑。3. 第一个Vitesse脚本从读取模型到批量修改属性3.1 核心对象模型Project、DesignManager、ModelObject要想让Vitesse干活你得先理解它的对象模型。Tribon在设计数据这块抽象出了几个核心对象。Project工程是顶层容器一个船型项目就是一套完整的模型数据库。脚本通常通过ProjectManager来定位当前打开的工程进而读取分段、平面等数据。DesignManager设计管理器是你和建模环境交互的核心入口负责管理平面、模型对象的选择以及各种操作请求的发送。比如你要在某个平面里遍历所有板零件就得通过DesignManager把平面设为当前再获取该平面的零件列表。ModelObject模型对象则是所有模型要素的统称板、型材、肘板、开孔都算。实际写脚本时你会频繁做一件事把拿到的ModelObject按类型判断成具体零件再调用对应的属性方法。判断的写法一般是检查对象的类型字符串比如“IsTypeOf(A, PLATE)”这种。我把三者关系总结成一句话Project是数据仓库DesignManager是操作台ModelObject是你要加工的对象。理解这三层Vitesse里80%的场景你都能套进去。3.2 实操示例遍历当前平面所有板并修改厚度下面这个例子是我在培训新人的时候最常讲的入门案例遍历某个平面里的所有板零件把板厚小于8毫米的板统一修改为8毫米。Dim objDM As Object Dim objPlane As Object Dim objPart As Object Dim strPlaneName As String Dim dblThickness As Double strPlaneName 201-C-01 Set objDM GetObject(Tribon.DesignManager) 1. 显式设置当前平面 objDM.SetActivePlane strPlaneName 2. 获取该平面下的所有零件 Set objPlane objDM.GetActivePlane() 3. 遍历零件集合 For Each objPart In objPlane.GetModelObjects() If objPart.IsTypeOf(PLATE) Then dblThickness objPart.GetThickness() If dblThickness 8# Then objPart.SetThickness 8# objPart.Update() End If End If Next MsgBox 批量修改完成这个脚本展示了几个关键动作设置当前平面、遍历模型对象、类型判断、读取属性、修改属性、更新模型。有几个细节我要单独拎出来讲。第一个是SetActivePlane和objPlane.GetActivePlane()这两行缺一不可。SetActivePlane改变了Tribon的当前工作上下文GetActivePlane则是把当前上下文的引用取出来放到变量里方便后面循环使用。如果你只用第一个而不用第二个后面For Each里的对象可能引用不到任何东西。第二个细节是Update()那一行。很多人写脚本改了属性但不刷新结果面板上看到的还是老属性就以为脚本没生效。实际上SetThickness只是改了内存里的属性值Update才会把改动写回Tribon的数据模型。第三个细节是厚度判断。航海设计里板厚小于8毫米的情况并不少但一般船体结构最小板厚都有规范卡着用8作为阈值是我这个示例里的假设。实际项目里这个阈值建议做成脚本开头的配置参数方便不同项目调整而不是写死在代码中间。3.3 运行方式三种启动渠道和适用场景Vitesse脚本的运行方式五花八门按使用场景可以分为三类。第一类是编辑器直接执行。写完宏文件后在Editor里点击Run脚本马上在当前设计环境跑一遍。这种适合调试阶段边改边看输出。第二类是菜单挂载。Tribon允许把脚本挂到Design界面的自定义菜单里点一下菜单就能调起对应的.Vso文件。这种方式适合高频使用、且需要重复执行的固定流程比如“一键生成全部分段重量报表”。第三类是批处理模式。脚本可以接收外部参数在命令行或通过任务计划调用。这种方式适合下班后跑一些耗时的批处理任务比如全船干涉检查的标准化处理第二天早上来看结果就行。我自己的习惯是第一类用来开发调试第二类用来日常使用第三类用来处理重活。三种方式对应的脚本头写法略有不同主要是参数获取这块批处理模式下通常会先读一个配置文件把分段号、材料等级、板厚阈值全部塞进去而不是靠InputBox弹窗等人输入。4. 批量建模与命名规则Vitesse真正的用武之地4.1 批量创建零件一个循环里把一档肋位的零件全部建齐修改属性只是开胃菜Vitesse更诱人的地方在于批量创建模型对象。咱们回到文章开头那个场景60档肋位每档都要一块同样的肘板。手工做想吐脚本其实也就几十行。大概逻辑是这样的先用一个数组或列表把每档肋位的X轴坐标算出来比如从第10号肋位到第70号肋位间距600毫米然后在一个For循环里对每个坐标位置调用创建肘板的函数指定轮廓类型、材质、板厚再用命名规则自动生成零件名。这里要特别注意坐标系的换算。Tribon里的平面和坐标系概念很重同样的零件放在不同的面上用的几何坐标系完全不一样。如果是平行于中线面的平面你得处理高度方向上的投影关系如果是垂直于船长的横剖面就得用肋位号换算成X坐标。这是新手最容易翻车的地方错误往往是“零件建出来了但位置跑到天上去”一看坐标系才知道搞错了。我的习惯是每写一个批量创建脚本先在屏幕上建立逻辑校验点。比如脚本开头输出一段“当前平面为XXX预计创建N个零件”的信息中间每隔10档输出一次当前坐标最后跑完再输出创建成功的零件总数。这样一旦数量不对中间日志能告诉你在哪一档开始跑偏。4.2 命名规则让零件自动拥有合规名字Tribon里零件的命名规则是联合设计标准里非常重要的一个环节。名字不光是给人看的也是后续出图、套料、材料表关联的索引。一个不规范的名字可能导致材料统计串行。Vitesse对命名规则的支持是我最看重的一点。你可以在Tribon的命名规则配置里定义好规则模板比如{ASSEMBLY_NAME}-{PART_TYPE}-{THICKNESS}然后在Vitesse里调用ApplyNamingRule函数让系统根据这个模板自动生成零件名。脚本里大概是这样objPart.ApplyNamingRule BRACKET_RULE_01 objPart.Update()这里有个细节命名规则的具体配置在Tribon的规则管理界面里维护Vitesse脚本只是负责调用。你在一个项目里第一次用某个规则前最好先手动建一个零件验证规则输出是否符合预期因为命名规则里可能会有条件分支、前缀补零等逻辑光看配置不一定能想象出真实输出。另外要提醒一点命名规则执行后脚本里最好把生成的零件名读出来再打印一遍日志。这样做的好处是后续如果发现模型里某个零件名字乱了你能直接根据日志定位是哪个批次、哪条规则生成的排查效率高很多。4.3 报表输出与模型检查让脚本帮你“盯着”质量批量创建之后更需要批量检查。Tribon模型数据量大靠人眼逐个检查零件厚度、材质、所属分段是否匹配基本不现实。Vitesse在这里又派上用场了。常见的做法是写一个遍历脚本把模型中所有零件的关键属性读出来写入一个CSV或TXT文件。我习惯输出的字段是装配体名、零件名、类型、板厚、材质、面积、重量、所在平面。然后拉到一个Excel里做透视表哪些分段零件多、哪些零件厚度超标、哪些材质用错一眼就能看出来。检查逻辑也可以直接写进脚本里不一定要导出来。比如你可以在遍历时做规则判断如果某块板属于某分段但板厚超出了设计规格就把到日志里标个“WARN”。我在项目里最常用的是重量复核脚本把全船所有板的重量汇总出来跟详细设计图纸对比偏差超过一定比例就直接报警。这类脚本的难点不在API而在业务规则。你得先把设计规范转换成代码里的判断条件比如“机舱区域所有板的材质等级不能低于AH36”这种写进脚本后它才真正有检查能力。这也是为什么我建议学Vitesse的船体设计师不要只盯着代码要多去理解船级社规范和船厂自己的一套设计原则。5. 常见问题与排查技巧实录5.1 高频报错与解决办法速查Vitesse开发中会遇到不少报错和诡异行为我整理了几个几乎每次培训都会讲的高频问题。症状常见原因解决办法运行时报“Object variable not set”对象引用没获取成功通常是平面或项目名写错检查字符串拼写先MsgBox输出对象名称确认零件创建了但不显示没有调用Update或模型树没刷新在创建操作后调用Update并检查是否切回了正确的平面属性改了但导出报表没变化改了内存对象但没有写入数据库SetXxx后必须Update必要时再触发一次Save遍历找不到任何零件当前平面没有任何模型对象或者上下文平面设错了用GetModelObjects之前先确认该平面下确实有模型脚本执行到一半崩溃对NULL或空对象调用方法每次取对象后判断IsObject是否为True再用On Error齐坐标位置完全不对坐标系或平面未切换用的还是上一个平面的坐标开头显式SetActivePlane确认坐标参考这张表里的前三个问题我自己刚学的时候全踩过。尤其是Update这件事我记忆特别深。有一回给一个分段批量改了将近200块板的材质跑完看界面啥变化没有我还以为是脚本逻辑错了后来把代码一行行过才发现是少了Update。那次之后我所有的写操作后面都会习惯性跟一个Update几乎成了肌肉记忆。5.2 开发调试中的几个关键习惯最后分享几个我多年写Vitesse脚本养成的调试习惯希望能帮你少走弯路。第一个习惯是“小步快跑”。不要一次性写几百行再执行而是每写几十行就先运行一次用什么变量就输出什么变量。Vitesse没有比如今IDE那种断点调试靠的就是这种朴素的日志法。第二个习惯是“备份先行”。任何批量修改类脚本执行前强烈建议先对当前设计做一次保存或备份。Tribon的撤销功能对脚本执行的批量操作不总是有效一旦大量属性写坏了想靠CtrlZ恢复会非常痛苦。我吃过一次大亏之后现在的规矩是正式跑批处理之前先保存数据库、导出相关模型区段作为备份。第三个习惯是“参数集中管理”。脚本开头集中定义所有可变参数比如分段名、板厚阈值、材质等级、命名规则名用常量或字典统一管理不散落在代码各处。这样换项目或者改规格的时候你只需要改开头那几行不用在几百行里找数字。第四个习惯是“日志留档”。每次运行时把关键步骤、参数、运行结果写到一个日志文件里。Tribon环境经常会因为各种原因重启如果不留日志重启后你根本不知道上次脚本跑到哪、改了哪些东西。这个习惯在长时间批处理任务里尤其重要。我在实际使用中还有一个体会Vitesse脚本写得好不好很多时候不取决于代码本身而取决于你对Tribon数据结构的理解。模型对象之间是什么关系、命名规则怎么组织、平面坐标系怎么转换这些业务层面的积累才是脚本质量的根基。代码反而只是把这些理解翻译成机器能执行的动作。所以建议你学Vitesse的时候多抽时间研究Tribon自身的数据组织方式看不懂的地方就翻模型树对照着看一定能反过来加深你对脚本的理解。写到这里第一期的内容基本覆盖了Vitesse开发的环境、语法、对象模型和入门实操。下一期我会重点拆解几个真实生产项目里的脚本案例。到时候咱们直接拿一个分段批量开孔的例子来讲手动操作需要一两天脚本可能十几分钟就跑完那种爽感值得等一等。