建模与反馈小闭环

目标不是把一串命令发送给 SOLIDWORKS 就结束，而是完成：

定位目标 → 执行动作 → 重建 → 读取状态/几何量 → 获取图像 → 根据结果判断下一步。

完整可运行示例

打开 closed-loop.aardio。它只创建新零件，不使用已有活动模型；默认输出到当前用户的本地应用数据目录下，每次运行使用新目录。

也可以指定模板与输出目录调用：

var result = loadcodex("~/docs/library/com/sldWorks/closed-loop.aardio",{
    version=2025;
    template="%ProgramData%\SOLIDWORKS\SOLIDWORKS 2025\templates\gb_part.prtdot";
    outputDir=io.fullpath("/output/sw-loop");
});
print(result);

示例模板路径适用于本次验证的中文 SOLIDWORKS 2025 安装。其他安装请显式提供自己的空白零件模板。指定固定输出目录时，后续运行可能覆盖该目录中的示例文件。

示例执行过程：

1. 只连接运行中的 2025 实例。
2. 从显式模板创建空白零件。
3. 按 GetTypeName2()=="RefPlane" 取得第一个基准面，不依赖中文/英文名称。
4. 创建 100 × 60 mm 矩形草图，拉伸 20 mm。
5. 重建并确认体积为 0.00012 m³（120000 mm³）。
6. 导出 before.png。
7. 将自己命名的特征 AA_Block 的深度尺寸从 20 改为 40 mm。
8. 再次重建，确认体积为 0.00024 m³、实体数为 1，并检查有限特征扫描结果。
9. 以唯一文件名保存 block-时间标记.SLDPRT，导出 block.step、after.png、feedback.json。原生文件的基名也保持唯一，避免先前示例尚未关闭时的同名冲突。
10. 保留已保存模型供查看。失败会停止，可能留下用于诊断的未保存测试文档；不会自动回滚。

示例的修改后模型视图（通过本库 CaptureView 导出）

第二个示例：带孔零件（推荐的助手函数写法）

打开 plate-with-hole.aardio。它演示本库封装的建模助手，在 SOLIDWORKS 2025 实测通过：

1. NewSketch(doc,plane,draw,"AA_Profile")：选平面、进入草图、执行 draw 回调、退出草图，再用 ISldWorks::IsSame 找回对应的草图特征并命名。回调出错或返回 false 时也会退出草图。
2. 在回调内为矩形加两个尺寸并让角点与原点重合，GetSketchInfo 报告 fullyDefined=true。
3. Extrude(doc,"AA_Profile",{depth=0.020;name="AA_Block"}) 创建凸台。
4. GetFaces(doc) 按 normal=[0,0,1] 找到顶面，用其 point 作为 NewSketch 的目标画圆。
5. Extrude(doc,"AA_HoleProfile",{cut=true;endCondition="throughAll";name="AA_Hole"}) 切出通孔，体积等于长方体减圆柱。
6. GetMaterials() 读取本地化材料名后 SetMaterial，质量 = 体积 × 密度。
7. SetCustomProperty、GetDimensions("AA_Block")、SetDimension("D1@AA_Block",0.030)，再用体积验证。
8. CaptureView(path,doc,960,720,"isometric") 出图并保存。

var result = loadcodex("~/docs/library/com/sldWorks/plate-with-hole.aardio",{
    version=2025;
    template="%ProgramData%\SOLIDWORKS\SOLIDWORKS 2025\templates\gb_part.prtdot";
    outputDir=io.fullpath("/output/sw-plate");
    // material="1060 合金"; // 省略时选择名称以 1060 开头的材料
});
print(result.volumes,result.change);

草图尺寸与关系

AddDimension2 在 “输入尺寸值”选项（swInputDimValOnCreate，编号 10）为 true 时会弹出对话框并阻塞自动化。示例在添加尺寸前临时关闭并在之后恢复该选项：

import com.sldWorks;
var sw,err = com.sldWorks(false);
if(!sw){ print(err); return; }
var doc,findError = sw.FindDoc();
if(!doc){ print(findError); return; }

var profile,sketchError = sw.NewSketch(doc,"前视基准面",function(sketchManager,doc){
    var segments = sketchManager.CreateCornerRectangle(0,0,0,0.05,0.03,0);
    var previous = sw.GetUserPreferenceToggle(10/*_swInputDimValOnCreate*/);
    sw.SetUserPreferenceToggle(10,false);
    doc.ClearSelection2(true);
    segments[1].Select4(false,com.nothing());              // 草图线段用 IEntity::Select4
    var display = doc.AddDimension2(0.025,-0.01,0);         // 文本位置，米
    display.GetDimension2(0).SetSystemValue3(0.05,1,com.nothing());
    sw.SetUserPreferenceToggle(10,previous);
    doc.ClearSelection2(true);
    segments[1].GetStartPoint2().Select4(false,com.nothing());
    sw.SelectByPoint(doc,"EXTSKETCHPOINT",0,0,0,true);     // 原点按类型+坐标选择，不依赖名称
    doc.SketchAddConstraints("sgCOINCIDENT");
},"AA_Demo");
if(!profile){ print(sketchError); return; }
print(sw.GetSketchInfo(doc,profile));

上例用本地化名称 "前视基准面" 只为演示 NewSketch 接受特征名；跨语言脚本应像完整示例那样按 GetTypeName2()=="RefPlane" 取基准面对象。SketchAddConstraints 的关系名见官方 sgCOINCIDENT、sgHORIZONTAL、sgVERTICAL、sgFIXED 等。

Extrude 选项

返回 特征,错误码,isWarning。特征范围固定为“自动选择所有实体”，凸台/切除默认方向沿草图法向的原生规则不变；需要更复杂的终止条件（到面、到顶点、偏移）时直接调用原生接口。

单位与选择是关键前置条件

建模 API 的长度使用米，角度使用弧度，不跟随界面显示的 mm 自动转换：

var width = 100 / 1000;       // 100 mm → 0.1 m
var angle = 30 * math.pi / 180; // 30° → 弧度

每个阶段显式处理选择：选择基准面后进入草图；退出草图后清空旧选择，再选择草图特征进行拉伸。选择函数返回 false 是操作失败，不是可以忽略的通知。

InsertSketch(true) 是进入/退出的切换，不是“确保进入”的幂等命令。中断后先读取 GetDocInfo().editingSketch，不要盲目再次调用。NewSketch 在文档已处于草图编辑状态时直接拒绝执行。

选择面时优先用坐标而不是名称：GetFaces(doc) 返回每个面的 normal、area、box 以及面上实际点 point，SelectByPoint(doc,"FACE",x,y,z) 或 NewSketch(doc,{x=,y=,z=},...) 直接使用该点。实测坐标选择与草图进入都不要求文档处于活动状态。

ISketch 与 IFeature 不要混用

SketchManager.ActiveSketch 是草图接口，不提供 GetFeature()。NewSketch 在退出草图后用 sw.IsSame(feature.GetSpecificFeature2(),sketch)==1 找回草图特征；第一个示例则简单地取最后一个 ProfileFeature。

对已有复杂模型，不能把“最后一个草图”普遍当成目标。应记录自己创建的特征名称，或用原生 API 提供的更稳定引用方式；重建或关闭重开之后重新定位对象。

拉伸参数对照

完整示例调用 FeatureExtrusion3，其 23 个参数按以下顺序分组：

不要把全部参数的长串布尔值当成适用于任意拉伸的模板。更改终止条件、参考面、特征范围或多实体行为前，应查对应版本文档并增加验证。

修改后的独立验证

SetDimension(doc,"D1@AA_Block",0.03) 写入、重建并读回，返回 {before,after,status,statusName,rebuilt,scope}；状态码非 0（例如从动尺寸 3、无效值 2）返回 null,说明,状态码。不知道尺寸名时先用 GetDimensions(doc,"AA_Block") 列出。修改后仍应读取独立的几何量，而不是仅确认赋值语句执行完毕：

import com.sldWorks;
var sw,err = com.sldWorks(false);
if(!sw){ print(err); return; }
var doc,findError = sw.FindDoc();
if(!doc){ print(findError); return; }

// 本段仅用于已经运行完整示例创建的模型。
var depth = doc.Parameter("D1@AA_Block");
if(!depth){ print("没有目标尺寸，不修改其他模型"); return; }
var value = depth.SystemValue;
print("当前深度 mm：",value*1000);
var mass,massError = sw.GetMassProperties(doc);
if(!mass){ print(massError); return; }
print("当前体积 mm³：",mass.volume*1000000000);

体积、包围盒与截图分别回答不同问题。简单长方体可通过公式验证体积；复杂模型应选择与任务对应的不变量，例如实体数、孔径、材料去除量、组件数、配置或选定面的几何。近似包围盒不是精密测量工具。

中断和失败时

• 先保留原生返回码、目标文档路径和当前编辑状态。
• 检查特征创建是否返回对象，是否处于草图/特征编辑模式，选择是否正确。
• 不要因为上一次调用超时就直接重试创建特征：上一次可能已经生效。
• 本库不实现自动撤销事务。重要模型应先复制或另存，错误后重新读取模型再决定恢复方式。
• 对话框和命令管理器不包含在模型视图 PNG 中。需要诊断 UI 时应另外检查主窗口，而不是误判模型截图。

官方接口

• FeatureExtrusion3
• FeatureCut4
• AddDimension2
• ISketch 成员

模型反馈与图像 · 返回首页

Markdown 格式