首页/文章/ 详情

做Ansys二次开发这条路，有了AI这个新工具，我们能走得更快一点

仿真圈

42分钟前浏览2

点击文尾阅读原文报名

作者 | 小郭老师仿真秀专栏作者

首发 | 仿真秀App

导读：大家好，我是小郭老师，中科院硕士，在企业担任研发工程师，长期从事 ANSYS 二次开发、有限元仿真和仿真流程自动化。今天想跟大家聊聊我最近做的一个小项目——把 AI 接入了 SpaceClaim 的官方 API 文档。

一、做这个项目的起因，说起来挺有意思的

我在仿真秀官网上讲 ANSYS 二次开发的课也有一段时间了，平时答疑的时候，发现学员问得最多的一类问题不是"Python 语法怎么写"，也不是"逻辑怎么实现"，而是——"这个功能在 SpaceClaim 里对应的 API 到底在哪？"

比如有个学员说，他手动操作界面做圆周阵列、共享拓扑、几何体命名都很溜，但一到写 Python 脚本就懵了——知道要做什么，不知道从哪个对象开始写。还有的学员打开了官方 CHM 文档，翻来翻去全是 C#/.NET 的页面，找了半天也找不到自己要的那个方法。

说实话，这个问题我自己也碰到过。当年刚开始做 SpaceClaim 二次开发的时候，我也经常对着 CHM 文档发呆——明明知道软件里有这个功能，可就是搜不到对应的 API，有时候一个命令要找半小时，特别挫败。

那时候我就想：能不能有个东西，我跟它说"我要做圆周阵列"，它直接告诉我对应的 API 在哪、参数怎么传、跟哪些对象配合？以前这个想法实现起来挺难的。但这两年 AI 发展太快了，尤其是 MCP（模型上下文协议）出来之后，我突然觉得：这事好像可以搞一搞。

于是就有了这个项目：ansys-scdmdoc-mcp——把你本机上的 SpaceClaim 官方 API CHM 文档，通过 MCP 接入 AI，让 AI 帮你找命令、读文档、串流程。下面就跟大家聊聊这个项目是怎么做的、能解决什么问题、以及怎么用在你自己的建模工作里。

二、AI 正在重新定义 SpaceClaim Python 的学习方式

传统的查命令方式，往往是先猜关键词，再翻文档，接着对照录制脚本，最后手工拼出一段可能可用的代码。对于刚接触 SpaceClaim 二次开发的人来说，最难的并不是 Python 语法，而是面对一个庞大的 API 世界，不知道从哪里进入。

AI 的优势就在这里：它可以先理解你的建模目标，再把目标拆成“需要查什么、对象如何关联、步骤如何排列、结果如何检查”。你描述的是工程问题，AI 帮你转换成检索问题；你拿到的是零散 API，AI 帮你组织成建模流程；你担心代码是否靠谱，AI 还可以根据实体数量、角度、尺寸、名称和输出文件等验收条件，帮助你建立复核清单。

过去，学习 SpaceClaim Python 往往意味着记忆大量命令、反复翻阅帮助文档、不断试错。现在，AI 可以成为你的 API 导航员、建模方案整理器和代码解释助手：它不只告诉你“某个命令叫什么”，还可以继续追问“这个命令和谁配合、参数怎么传、下一步应该做什么、最后如何确认结果”。这就是 AI 对工程软件二次开发带来的真正变化——把原本依赖个人经验的查找过程，变成可以对话、可以追踪、可以复核的开发过程。

但要让 AI 在 SpaceClaim 场景中真正发挥作用，不能只依赖通用训练记忆生成代码。SpaceClaim 的 API 检索需要有可靠的资料来源，因此我开发了 ansys-scdmdoc-mcp：把用户电脑上的 ANSYS SpaceClaim/SCDM 官方 API CHM 接入 MCP，让 AI 能够基于本机官方文档完成检索和组织。

项目地址：HaydenGuo/ansys-scdmdoc-mcp

三、如何把 AI 接入 SpaceClaim API？

MCP 是 Model Context Protocol，中文通常译为模型上下文协议。它提供了一种标准方式，让 AI 应用在获得明确授权的前提下调用外部工具和数据源，例如本地文档、代码库或业务接口。

在这个项目中，MCP 连接的不是一个脱离安装环境的通用代码库，而是用户电脑上的 SpaceClaim/SCDM 官方 API CHM。AI 的工作链路可以概括为：

根据自然语言目标，在本机官方文档中搜索类、方法、属性和几何关键词；
打开对应的官方 API 页面，查看签名、参数和说明；
把相关 API 按建模目标整理成有顺序的候选步骤；
返回可供 SCDM Python/IronPython 继续试跑和调整的候选代码。

这让 AI 可以从一个自然语言建模目标出发，完成从“理解需求”到“检索 API”、从“解释参数”到“组织建模步骤”的连续工作。过去需要开发者打开多个页面、尝试多个关键词、手工拼接对象关系的过程，现在可以先交给 AI 建立一套清晰的检索路径。AI 甚至可以继续围绕同一个任务进行追问和迭代：补充参数后重新收窄范围，加入图片后理解几何意图，给出验收条件后整理检查项。

它解决的是“命令在哪里、对象怎么关联、参数应该从哪里确认”的问题。更重要的是，它把 AI 从“代码生成器”提升成了“SpaceClaim 建模开发助手”：既能帮你找命令，也能帮你读文档、拆任务、串流程、解释代码和准备验证条件。

AI 负责把探索成本降下来，工程验证负责把结果落下来。能够追溯到官方 API 页面，知道哪些内容来自文档、哪些内容是根据建模目标整理出的候选，比得到一段无法解释来源的代码更适合工程使用。

四、三种方式，把 AI 用到具体建模任务中

1、从一个功能名称找到 API

可以直接从目标功能开始提问：

这类问题的重点不是让 AI 凭记忆猜命令，而是先缩小官方文档范围，再确认类、方法、属性和参数之间的关系。

2、从一个目标整理建模顺序

例如，圆周阵列通常不是一个孤立命令。一个完整任务可能还涉及阵列数据、旋转中心、实例数量、角度间隔，以及后续的合并操作。可以这样描述：

检索结果可能会进一步关联到：

这些名称只是继续核查的入口，最终仍应结合官方页面、当前版本和实际运行结果确认。相比在 CHM 中反复猜页面名称，这种提问方式更容易把“功能”拆成一条可复核的建模链路。

3、让参数、图片和验收标准一起参与检索

如果任务来自具体项目，不必只问一个命令。可以一次性提供输入条件，让检索围绕完整建模目标展开：

建议同时写清楚：

几何尺寸、单位和坐标系；
点、线、面、轴、基准面等参考对象；
阵列数量、角度间隔、旋转方向和阵列中心；
拉伸、旋转、圆角、倒角和布尔操作的先后顺序；
几何体名称、命名选择、共享拓扑或装配关系要求；
可检查的验收条件，例如实体数量、角度、尺寸和输出文件。

图片负责提供形状信息，参数负责限定建模条件，验收标准负责判断结果是否符合预期。三者同时给出，返回的方案才更容易从“看起来合理”走向“能够实际复核”。

五、为什么仍然要使用本机官方 CHM？

SpaceClaim API 的检索不能只依赖一份脱离安装环境的通用知识库。不同电脑上的 ANSYS 安装位置和版本环境可能不同，官方 CHM 也通常随本机安装一起提供。

这个工具不把任何用户电脑的 ANSYS 安装目录写死在代码中。首次配置时，用户可以选择自动检测，也可以手动输入 SpaceClaim 应用程序路径。

自动检测会扫描当前电脑上的版本化环境变量，例如 AWP_ROOT241、AWP_ROOT251、AWP_ROOT261，识别可用版本，并在用户确认后验证对应的 SpaceClaim 文档路径。如果自动检测无法确定有效路径，配置页面会提示：

此时切换到手动模式，输入 SpaceClaim 的应用程序路径即可。工具默认检索用户本机的官方 API CHM，不依赖 SCDM_PYTHON_KB，也不会要求把某台机器的安装路径写进项目。

六、对 SpaceClaim二次开发的实际帮助

它带来的价值，不只是“搜索更快”，而是让 AI 参与到 SpaceClaim Python 开发的多个环节：

从“我记得有这个功能”定位到官方 API 页面；
从单个命令继续追踪相关的数据对象和操作对象；
根据自然语言目标整理创建、变换、布尔和检查步骤；
将图片、参数、操作顺序和验收条件放入同一个建模描述；
为已有录制脚本提供 API 解释、结构整理和排错线索；
在代码真正投入批量建模前，先明确需要验证的对象和结果。

对于初学者，AI 可以降低进入 SpaceClaim API 世界的门槛；对于有经验的开发者，AI 可以承担资料定位、对象关系梳理和方案初稿整理；对于正在做仿真自动化的人，它还可以把“几何目标—建模命令—脚本步骤—结果检查”串成一条更清晰的工作链路。

七、结语：先把命令查清楚，再把模型跑通

SpaceClaim Python 二次开发的难点，通常不在于记住多少命令，而在于能否把一个界面功能拆成正确的 API 对象、参数和执行顺序。

ansys-scdmdoc-mcp 做的事情，就是把本机官方 CHM 接入 AI，让 AI 从一个会回答问题的工具，进一步变成能够查文档、读说明、整理候选代码、规划建模步骤的 SpaceClaim Python 智能助手。得到结果后，再回到目标 SpaceClaim 版本中试跑，检查实体、角度、名称、拓扑和文件输出，才完成一次真正有证据的建模验证。

如果你正在处理几何体命名、共享拓扑、圆周阵列，或者已经有参数和图片但不知道如何组织脚本，可以从一个具体问题开始。欢迎在评论区留下你最难查的 SpaceClaim 命令、建模目标或报错信息，一起把它拆成可检索、可试跑、可复核的 Python 建模步骤。

点击阅读原文，立即学习《ANSYS Workbench & Mechanical企业级二次开发程序与Python应用入门进阶》，掌握ANSYS Workbench & Mechanical的脚本自动化开发能力。

限时特价（限10名）

秒杀：1499 元（售价：1699元）

可回放/开发票/奖学金/加餐

提供vip群答疑和模型下载

【研发仿真好课】Workbench & Mechanical二次开发程序与Python应用入门进阶_ACT-仿真秀视频课程

以下是课程大纲及主要内容：

本课程从基础脚本开发到多工况批量计算的自动化实现，手把手教你用Python打通「仿真流程自动化 - 多工况批量计算」全链路，让「重复仿真工作自动化、复杂工况高效计算」从想法变成日常。后续内容我也结合我AI驱动仿真实践来丰富课程大纲和加餐。

我还为付费用户提供VIP群进行交流、答疑服务、持续加餐内容、提供定制化培训和咨询服务、仿真人才库高薪内推就业、仿真秀还提供奖学金、学完此课程，推荐学习者报名参加工程仿真技术（CAE分析职业能力等级评价证书）。

2026研发仿真开学季来啦

2026研发仿真开学季是仿真秀面向研发工程师推出的主题活动月，9月1日至10月31日以"从工具到智能——让AI接入仿真研发"为主线，覆盖结构、流体、电磁、多物理场和AI驱动仿真五个方向。仿真秀力邀企业资深研发工程师，围绕LS-DYNA、Workbench、Abaqus、Star-CCM+、HyperWorks、Maxwell、Fluent、CST、Flotherm、SolidWorks、ANSYS等主流软件，演示如何用LLM、Agent、Codex、Claude、DeepSeek等大模型能力打通建模、求解、后处理与优化全流程，让仿真从"手工操作"升级为"AI驱动"；

此外仿真秀精选100余门研发仿真精品视频课限时秒杀1元起售，并叠加专属券，秒杀课程覆盖从基础到前沿的完整学习路径；活动期间，仿真秀还发起案例征集，以"我的研发仿真故事——从工具到智能的进阶之路"为题，面向工程师征集攻坚实录、工具进化、AI接入、成长与团队四类真实故事，图文或视频，通过即获“满意现金稿酬和百人千万"内容扶持计划，优秀作品还将在仿真秀APP、官网、公众号、视频号四端专题展示并邀请连麦直播。整个主题月既是一场系统化的技术充电，也是工程师用AI重塑研发工作流的一次集中练兵。