真实案例、当前边界与后续路线 / Validated Cases, Current Boundaries, and the Development Roadmap

📅 创建时间：2026-07-23
🏷️ 标签：#SAM #案例 #1338 #路线图 #复盘
📚 前置知识：07-api-validation-workflow
📖 系列导航：总目录 · 上一篇：07-api-validation-workflow

---

第11部分：当前已验证成果

11.1 1338_repaired_v01.sam

这是当前人工确认度最高的修复模型。成功过程包括：

修正 84 个右舷 B31 梁的 Section/n1/offset
镜像补齐 180 个底部壳单元
删除破碎孔边壳与临时引导梁
创建 474 个左舷孔边四边形壳
镜像创建 474 个右舷孔边壳
合并节点、删除重复单元、清理自由节点

结果：

INITIAL nodes=11815 elements=10972
FINAL   nodes=12721 elements=11840

11.2 未分配单元修复

S3/S4R：49398 个 → 普通 12 mm 壳 Section
B31：     484 个 → 普通 10×10 梁 Section
剩余未分配：0

11.3 尚未完成的端到端项目

总纵分析：Moment 对象可保存，但装配参考节点 Nset 未正确写入 INP
自由边：完成拓扑诊断，尚未得到不会恶化网格的自动修复算法
胶囊孔：几何与自由边仍需要基于闭合边环的定向重构
肘板：已有 C++ 参数化建模框架，但尚需按图纸形成专用工具

---

核心总结

┌────────────────────────────────────────────────────────────────────┐
│                        SAM 二次开发核心结论                         │
├────────────────────────────────────────────────────────────────────┤
│ Python 2：SAM 对象、Section、Set、分析步、保存与导出                │
│ C++ PYD：几何、网格、拓扑、ODB、高性能算法                           │
│ Qt DLL：菜单、对话框、视口交互、参数收集                             │
│ Agent：理解意图并调用白名单工具，不直接任意执行代码                   │
│                                                                    │
│ 新建完整 Part：bmeElementClass + omeMesh + mesSetMesh               │
│ 修改现有模型：优先 SAMReMesh 增量写入                               │
│                                                                    │
│ API 判定：官方源码/实测证据优先，绝不按 Abaqus 同名接口推断           │
│ 修改策略：先审计、再修改、另存、重开、导出、求解验证                  │
└────────────────────────────────────────────────────────────────────┘

---

章节测试

测试1：为什么一个 SAM 插件通常同时包含 DLL 和 PYD？

测试2：ptsKPartFragment 与普通 pyoModule 方法有什么区别？

测试3：为什么 mesSetMesh 不适合直接修补 5000t 现有模型？

测试4：为什么 assembly.Set(referencePoints=...) 不能使用？

测试5：Agent 为什么不应获得任意 Python 执行权限？

---

参考答案

测试1答案

DLL 负责 Qt/SAM GUI 注册，PYD 负责向 Python 2 与 Model/Part 对象暴露 C++ 功能；两者通过 omuMethodCall 和 SAM 命令系统连接。

测试2答案

普通 pyoModule 方法通过 Example1.calcArea() 调用；ptsKPartFragment 方法会挂到具体 Part 上，通过 mdb.models[...].parts[...].method() 调用，并能直接取得当前 ptoKPart。

测试3答案

mesSetMesh 设置的是完整 Part 网格，可能替换原节点单元并破坏既有 Set、Section Assignment 和连接关系。局部构件应优先使用 SAMReMesh::createNewElement2 增量写入。

测试4答案

因为 SAM V2026 的 Assembly.Set 绑定不接受 referencePoints/referencePoint/features 这些 Abaqus 风格关键字，实际探针全部失败。必须找到 SAM 自己的装配节点集合路径并完成 INP 验证。

测试5答案

任意执行会绕过参数校验、备份、确认和结果审计。Agent 应只选择经过验证的工具，由工具执行器控制模型修改范围。

---

证据来源

D:\wx702\OpenOLTranSim-main\README.md
D:\wx702\OpenOLTranSim-main\7231\SAM二次开发手册.doc
D:\wx702\OpenOLTranSim-main\7231\src\P0原始 ... P5
D:\wx702\OpenOLTranSim-main\Example\Example1.zip ... Example4.zip
D:\wx702\OpenOLTranSim-main\VTKIO-Source
D:\wx702\OpenOLTranSim-main\LiftingLug
D:\wx702\1338\repair_1338_v01_fixed.py
D:\wx702\1338\assign_5000t_3_unassigned_shell_t12_v01.py
D:\wx702\1338\assign_5000t_3_unassigned_b31_generic_v01.py
D:\wx702\1338\diagnose_reference_set_keyword_v01.py / v02.py
D:\Temp\sam.rpy.16
D:\wx702\SAM\SAM V2026 User Manual20260717.pdf

---

相关笔记

• Plugin/05-cpp-abi-compatibility - C++ ABI 兼容性
• Plugin/08-cmake-plugin-project - CMake 插件工程
• Plugin/09-plugin-architecture-patterns - 插件架构模式
• Plugin/13-industrial-plugin-case-study - 工业软件插件案例
• Plugin/14-full-plugin-project - 完整插件项目

下一步学习

• [ ] 获取老师发布的完整 SAMSDK（含 include、libs、ThridPartys）
• [ ] 编译 P5 最小插件并验证 getNodeInfo
• [ ] 建立 Python 2 API 探针仓库与失败接口清单
• [ ] 为肘板建立独立的参数 Schema 和局部坐标生成器
• [ ] 实现 Agent 只读工具：当前模型、选择节点、Section 审计
• [ ] 完成装配级节点 Set 的 INP 端到端验证

---

学习状态：🟡 已建立框架，进入接口验证与 Agent 工具化阶段