Qwen3-4B模型在SolidWorks二次开发中的应用探索

1. 引言

想象一下这个场景：你是一位机械设计师，正对着SolidWorks软件，准备修改一个复杂装配体的几十个零件尺寸。按照传统方法，你需要打开每个零件的草图，找到对应的尺寸标注，手动输入新数值，然后重建模型。这个过程枯燥、重复，还容易出错。或者，你需要把上百张工程图导出为PDF，一张张点击“另存为”，一整个下午就这么过去了。

这些繁琐、重复的任务，几乎每个机械工程师都经历过。SolidWorks本身提供了强大的二次开发接口（API），理论上我们可以写一些宏（Macro）或者插件来自动化这些工作。但问题来了：不是每个工程师都是编程高手。VBA、C#这些语言，对于专注于设计本身的人来说，学习门槛不低。即使勉强学会，每次遇到新需求，都要从头研究API文档、调试代码，效率反而可能更低。

那么，有没有一种方法，能让工程师用最自然的方式——也就是说话或者打字——来告诉电脑自己想做什么，然后电脑就能自动生成可运行的SolidWorks操作代码呢？这就是我们今天要探索的主题：让AI大模型，特别是像Qwen3-4B这样的轻量级但能力不俗的模型，来充当机械工程师和SolidWorks API之间的“智能翻译官”。

简单来说，我们想试试看，能不能让工程师输入一句“把所有直径是10mm的孔改成12mm”，或者“把这个装配体里所有零件的材料都换成不锈钢”，然后由Qwen3-4B模型来理解这句话，并自动生成对应的、能直接在SolidWorks里执行的VBA宏代码。这听起来有点像“用自然语言编程”，目标是把工程师从重复的鼠标点击和复杂的代码编写中解放出来，让他们能更专注于创造性的设计工作本身。

接下来，我们就一起看看，这个想法具体该怎么落地，中间会遇到哪些挑战，以及实际用起来效果到底怎么样。

2. 为什么选择Qwen3-4B来做这件事？

在开始动手之前，我们得先聊聊为什么是Qwen3-4B。AI模型那么多，为什么偏偏选它来辅助SolidWorks二次开发呢？这主要基于几个很实际的考虑。

首先，是它的“轻量”与“够用”。 Qwen3-4B是一个拥有40亿参数的中等规模模型。这个规模意味着两件事：第一，它对硬件的要求相对友好。你不需要准备特别昂贵的专业显卡，在一些消费级的GPU甚至性能不错的CPU上，它都能跑起来。这对于很多设计部门或个人工程师来说，是个很大的优势，部署成本低，尝试的门槛也就低了。第二，虽然只有4B参数，但它在代码生成、逻辑推理和指令跟随方面的能力已经相当扎实。处理我们设想的“将自然语言描述转化为特定API调用”这类任务，它的理解力和生成质量是足够应对的。

其次，是它在代码方面的“天赋”。 Qwen系列模型在训练时就很注重代码数据，因此它在生成结构清晰、语法正确的代码方面表现不错。SolidWorks的二次开发主要使用VBA（Visual Basic for Applications）和C#，这两种语言在编程社区中都有丰富的资料，模型在学习时也接触过大量相关模式。让它来生成这些代码，比生成一些特别冷门语言的代码要靠谱得多。

再者，是它的“可控性”和“本地化潜力”。 相比于直接调用那些庞大的云端模型API，本地部署一个像Qwen3-4B这样的模型，数据可以不出内网，对于处理可能涉及企业产品设计数据的场景，在隐私和安全上更让人放心。同时，本地部署也意味着响应速度更快，不受网络波动影响，体验更流畅。

当然，我们也要清醒地认识到它的边界。它不是一个“魔法黑盒”，不能理解只有资深SolidWorks开发者才懂的极其冷门的API或复杂的设计逻辑。它的价值在于处理那些有明确模式、重复性高、可以通过标准API调用来完成的常见任务。比如参数化修改、批量操作、简单规则检查等。把它的能力用在这些“刀刃”上，才能最大化其价值。

3. 核心思路：让AI成为你的开发助手

那么，具体怎么让Qwen3-4B帮我们写SolidWorks代码呢？整个过程的核心思路，可以类比成让一个聪明的、刚入门的编程助手来帮你干活。

第一步，是“需求翻译”。 工程师用自然语言描述任务，比如“为当前活动零件中的所有圆柱面添加‘加工面’的标注”。这句话包含了几个关键信息：操作对象（当前活动零件、所有圆柱面）、操作动作（添加标注）、标注内容（“加工面”）。我们的目标就是让模型准确提取这些信息。

第二步，是“API匹配”。 模型需要知道，在SolidWorks的庞大API世界里，哪些对象（PartDoc, Face, Annotation等）和哪些方法（GetFaces, AddDisplayData等）能实现上述操作。这需要模型在训练时“学习”过类似的API知识，或者我们能通过一些方式（比如提供API文档片段作为参考）来引导它。

第三步，是“代码组装”。 将匹配到的API对象和方法，按照正确的语法（VBA或C#）组装成一段完整的、可运行的代码。这包括变量声明、循环遍历、错误处理等基本编程结构。

第四步，是“上下文理解”。 这是难点，也是关键。一段有用的SolidWorks宏代码，往往不是孤立的。它需要知道当前SolidWorks是打开了一个零件还是一个装配体？当前选择的图形是什么？模型里有哪些特征？理想情况下，我们应该能把当前SolidWorks的一些状态信息（比如活动文档类型、选中对象的ID等）也作为提示词的一部分传给模型，让它生成的代码能贴合当前的实际工作环境。

所以，我们构建的不仅仅是一个“文本到代码”的转换器，而是一个 “工程上下文+自然语言指令”到“可执行代码”的智能生成系统。Qwen3-4B在其中扮演的角色，就是理解工程师的意图，并结合对SolidWorks API的有限知识，拼装出正确的代码草稿。工程师拿到这段草稿后，可能还需要进行微调、调试，但绝大部分的基础框架和API调用已经由AI完成了，这能节省大量查文档和写样板代码的时间。

4. 实战演练：从想法到代码

光说不练假把式，我们直接来看几个具体的例子，感受一下这个过程。假设我们已经搭建好了一个能调用Qwen3-4B模型的服务，它接收我们的自然语言指令，然后返回VBA宏代码。

4.1 场景一：批量修改特征参数

工程师指令：“将零件中所有名为‘Dia’的草图尺寸，其值统一改为20mm。”

这是一个非常典型的参数化修改任务。我们把这个指令发送给Qwen3-4B模型。模型经过理解，可能会生成类似下面这样的VBA代码框架：

Sub BatchModifySketchDimensions()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSketch As SldWorks.Sketch
    Dim swDim As SldWorks.DisplayDimension
    Dim dimName As String
    Dim newValue As Double
    Dim i As Integer
    
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    
    If swModel Is Nothing Then
        MsgBox "请先打开一个零件或装配体文档。"
        Exit Sub
    End If
    
    newValue = 20 / 1000 ' 转换为米（SolidWorks内部单位）
    
    ' 遍历模型中的所有尺寸
    Dim vDims As Variant
    vDims = swModel.GetDimensions()
    
    If Not IsEmpty(vDims) Then
        For i = 0 To UBound(vDims)
            Set swDim = vDims(i)
            dimName = swDim.Name
            
            ' 检查尺寸名称是否包含“Dia”
            If InStr(1, dimName, "Dia", vbTextCompare) > 0 Then
                ' 这里需要根据尺寸类型进行更精确的设置，以下为简单示例
                On Error Resume Next ' 防止某些只读尺寸报错
                swDim.SetValue newValue
                On Error GoTo 0
            End If
        Next i
    End If
    
    swModel.EditRebuild3 ' 重建模型以应用更改
    MsgBox "尺寸修改完成！"
End Sub

我们来分析一下这段AI生成的代码：

1. 基础框架正确： 它正确地声明了SldWorks、ModelDoc2等核心对象，并获取了当前活动文档。
2. 逻辑流程清晰： 包含了必要的空文档检查、单位转换（毫米到米）、遍历所有尺寸的循环。
3. 意图匹配： 它通过 InStr 函数查找名称中包含“Dia”的尺寸，并尝试用 SetValue 方法修改其值。
4. 考虑了健壮性： 加入了简单的错误处理(On Error Resume Next)和最终的重建操作。

当然，这段代码并不完美。比如，GetDimensions方法获取的尺寸可能不完全是草图尺寸；SetValue方法的使用也需要更精确的上下文。但这已经是一个非常好的起点！ 工程师拿到这段代码，只需要在SolidWorks的宏编辑器里稍作修改和调试（比如确认正确的API来获取草图尺寸），就能得到一个可用的工具。这比自己从头开始写，要快得多。

4.2 场景二：自动导出工程图

工程师指令：“将当前文件夹下所有.SLDDRW文件，导出为同名的PDF文件，保存到‘D:\ExportedPDFs’目录。”

这个任务涉及文件系统操作和批量处理。AI生成的代码可能如下：

Sub ExportAllDrawingsToPDF()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim fileSys As Object
    Dim sourceFolder As String, targetFolder As String
    Dim fileName As String, drawingPath As String, pdfPath As String
    
    Set swApp = Application.SldWorks
    Set fileSys = CreateObject("Scripting.FileSystemObject")
    
    sourceFolder = swApp.GetCurrentWorkingDirectory() ' 获取SolidWorks当前目录
    targetFolder = "D:\ExportedPDFs"
    
    ' 检查目标文件夹是否存在，不存在则创建
    If Not fileSys.FolderExists(targetFolder) Then
        fileSys.CreateFolder targetFolder
    End If
    
    fileName = Dir(sourceFolder & "\*.SLDDRW") ' 查找第一个.drw文件
    
    Do While fileName <> ""
        drawingPath = sourceFolder & "\" & fileName
        pdfPath = targetFolder & "\" & fileSys.GetBaseName(fileName) & ".pdf"
        
        ' 打开工程图
        Set swModel = swApp.OpenDoc6(drawingPath, swDocumentTypes_e.swDocDRAWING, swOpenDocOptions_e.swOpenDocOptions_Silent, "", 0, 0)
        
        If Not swModel Is Nothing Then
            ' 导出为PDF
            swModel.SaveAs2 pdfPath, 0, True, False ' 最后一个参数为PDF格式选项
            swApp.CloseDoc drawingPath ' 关闭文档
            Debug.Print "已导出: " & pdfPath
        Else
            Debug.Print "无法打开: " & drawingPath
        End If
        
        fileName = Dir() ' 查找下一个文件
    Loop
    
    MsgBox "批量导出完成！请查看D:\ExportedPDFs文件夹。"
End Sub

这段代码展示了AI处理文件批量操作的能力：

1. 使用了文件系统对象来遍历文件夹和创建目录，这是VBA的常规操作。
2. 正确调用了SolidWorks API 来打开工程图 (OpenDoc6) 和另存为PDF (SaveAs2)。
3. 逻辑完整，包含了文件遍历循环、错误处理（打开失败时跳过）和用户反馈。

工程师可能需要对 SaveAs2 方法的参数（比如PDF导出质量设置）进行调整，但整个脚本的骨架已经非常完整，直接可用的概率很高。

4.3 场景三：简单设计检查

工程师指令：“检查当前装配体中，所有螺栓的长度是否都大于其穿过板的总厚度。”

这个任务需要一定的逻辑推理：遍历装配体中的螺栓零件，获取其长度参数，再找到其配合的板件并计算总厚度，最后进行比较。这对AI的挑战更大，生成的代码可能更偏向于提供思路和关键API调用：

Sub CheckBoltLength()
    Dim swApp As SldWorks.SldWorks
    Dim swAssy As SldWorks.AssemblyDoc
    Dim swComp As SldWorks.Component2
    Dim boltName As String, paramValue As Double
    Dim sheetThickness As Double
    Dim i As Integer
    Dim msg As String
    
    Set swApp = Application.SldWorks
    Set swAssy = swApp.ActiveDoc
    
    If swAssy Is Nothing Or swAssy.GetType <> swDocumentTypes_e.swDocASSEMBLY Then
        MsgBox "请在装配体环境中运行此宏。"
        Exit Sub
    End If
    
    msg = "螺栓检查报告：" & vbCrLf & vbCrLf
    
    ' 遍历装配体中的所有零部件（这是一个简化示例，实际需要更智能地识别螺栓）
    Dim vComps As Variant
    vComps = swAssy.GetComponents(False) ' 获取所有顶层组件
    
    For i = 0 To UBound(vComps)
        Set swComp = vComps(i)
        boltName = swComp.Name2
        
        ' 这里需要更复杂的逻辑来识别“螺栓”零件，例如通过零件名称、配置特定属性或自定义属性
        If InStr(1, boltName, "bolt", vbTextCompare) > 0 Or InStr(1, boltName, "螺钉", vbTextCompare) > 0 Then
            ' 假设螺栓长度存储在一个叫"Length"的自定义属性中
            paramValue = CDbl(swComp.CustomInfo2("", "Length"))
            
            ' 此处需要编写更复杂的逻辑来获取该螺栓所穿过板件的总厚度
            ' 这可能涉及获取配合关系、查找相邻零件、读取板厚参数等
            ' sheetThickness = ... (复杂的计算逻辑)
            
            ' 假设我们获取到了一个厚度值
            sheetThickness = 15 / 1000 ' 示例值
            
            If paramValue <= sheetThickness Then
                msg = msg & "警告: 零件 """ & boltName & """ 长度(" & paramValue * 1000 & "mm)可能不足。" & vbCrLf
            End If
        End If
    Next i
    
    MsgBox msg
End Sub

可以看到，对于复杂逻辑任务：

1. AI能生成正确的程序框架和API调用（如遍历组件、获取自定义属性）。
2. AI能通过注释清晰地指出难点和缺失的逻辑（如“需要更复杂的逻辑来识别螺栓”、“需要编写更复杂的逻辑来获取板厚”）。
3. 这相当于AI为你起草了一份详细的开发说明书和代码草稿。工程师可以基于这个草稿，去填充那些需要专业领域知识（如何精准识别螺栓、如何通过API计算配合板总厚度）的具体实现。

5. 如何构建你的AI辅助开发环境？

想让上面这些场景跑起来，你需要搭建一个简单的环境。这不是一个复杂的AI平台，而是一个能连接你的想法和SolidWorks的“桥梁”。

1. 模型部署： Qwen3-4B模型可以从其官方渠道获取。部署方式很灵活：

• 本地推理：如果你的电脑有一块不错的GPU（比如RTX 3060 12GB或以上），可以使用Ollama、LM Studio或者vLLM等工具在本地运行模型，速度最快，隐私性最好。
• API调用：如果本地资源有限，也可以使用一些云服务提供的API（需注意数据安全）。本地部署一个轻量级的调用客户端，将你的指令发送到云端模型，再接收返回的代码。

2. 构建提示词（Prompt）模板： 这是让模型好好干活的关键。你不能只扔给它一句“改尺寸”，而要给它足够的上下文。一个有效的提示词可能长这样：

你是一个SolidWorks二次开发专家，擅长编写VBA宏代码。请根据以下用户需求生成代码。

**任务描述**：
[用户输入的自然语言指令，例如：将当前零件所有拉伸特征的深度增加5mm]

**附加上下文与约束**：
- 目标软件：SolidWorks。
- 编程语言：VBA。
- 代码要求：包含必要的错误处理（如检查活动文档是否存在）。
- 请使用标准的SolidWorks API对象，如SldWorks, ModelDoc2, Feature等。
- 生成的代码应是一个完整的Sub过程，可以直接复制到SolidWorks宏编辑器中使用。
- 如果任务描述模糊，请基于常识做出合理假设，并在代码注释中说明。

**请生成对应的VBA宏代码：**

通过这样的模板，你告诉了模型它的角色、任务格式、技术栈和代码规范，它能生成质量高得多的代码。

3. 搭建交互界面（可选但推荐）： 为了提高效率，你可以做一个简单的界面。比如，一个用Python和Tkinter/PyQt写的小窗口，或者一个SolidWorks插件形式的对话框。你在里面输入自然语言指令，点击按钮，它就去调用模型服务，然后把生成的代码直接显示在SolidWorks的宏编辑器中，甚至尝试自动运行。这样就把整个流程串起来了，体验更顺畅。

4. 迭代与优化： 一开始模型生成的代码可能不会100%正确。你需要扮演“导师”的角色：运行代码，看哪里报错了，把错误信息和修正后的正确代码片段，作为一种反馈，补充到你的提示词库或者给模型做微调（如果条件允许）。经过多次这样的迭代，模型对于SolidWorks API的理解会越来越准。

6. 优势、挑战与未来展望

尝试将Qwen3-4B这样的AI模型引入SolidWorks二次开发，带来的好处是实实在在的。

最明显的优势是大幅降低自动化门槛。很多重复性工作现在有了自动化的可能，即使是不懂编程的工程师，也能通过描述需求来获得可用的工具脚本，这相当于为整个设计团队赋能。其次是提升开发效率，即使是熟练的开发人员，在编写一些模式固定的代码时，也可以让AI打草稿，自己专注于逻辑校验和边界情况处理，事半功倍。最后，它还能减少人为错误，由AI生成的代码如果逻辑正确，那么在执行批量操作时，其准确性和一致性会比手动操作高得多。

当然，这条路也充满挑战。最大的挑战是领域知识的缺乏。SolidWorks API非常庞大和复杂，包含大量专业概念。通用模型没有专门学习过这些，生成代码时可能会用错对象或方法。这就需要我们通过精心设计的提示词、提供API文档片段、或者对模型进行特定领域的微调（Domain-specific Fine-tuning）来弥补。其次是逻辑理解的局限。对于需要复杂空间推理、依赖严格设计规范的任务（如“检查所有干涉”并给出优化建议），目前的模型还难以独立完成。它更适合做“翻译”和“组装”，而不是“设计决策”。最后是调试与集成。生成的代码仍需人工检查和调试，如何将其无缝集成到工程师现有的工作流（如PDM系统、设计检查清单）中，也是一个需要思考的工程问题。

展望未来，这个方向充满了可能性。我们可以想象，未来的CAD软件或许会内置这样的AI助手。工程师在软件里直接说出“在这个位置开一个减轻孔，直径20，深度10”，AI助手不仅能生成特征代码，还能直接预览效果。或者，结合更强大的多模态模型，直接对着草图或三维模型说“我觉得这里强度不够，加个筋板”，AI就能理解你的意图并完成建模。AI辅助设计，正在从概念走向现实，而利用类似Qwen3-4B的模型进行二次开发自动化，正是迈向那个未来坚实的一步。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。