前言¶

COMSOL 的桌面端适合在界面上点选建模，但一旦任务变成批量建模、参数化扫参、自动求解和自动出报告，界面操作就不够用：重复点选特征、手动改参数、逐个保存结果，既慢又容易漏。更麻烦的是跨版本——同一个物理场接口，在 6.0 和 6.2 上属性名或特征名可能不同，脚本跑到某一版直接失效，或者结果不对但一声不吭。

下面介绍的这个 Skill 就是针对这两类问题：用 Python 自动化驱动 COMSOL Multiphysics，并自带一套跨版本兼容层和真机冒烟测试。

这是什么¶

一句话定位：一个面向 COMSOL 仿真自动化的 Agent Skill，用 Python 调用和控制 COMSOL Multiphysics，底层基于 MPh + JPype 桥接 Java API。

它由 user_6eed38f8 发布并维护，托管在 SkillHub 上，坐标 @user_6eed38f8/comsol-automation，当前版本 3.2.0，来源 community，分类 professional。资料显示 requires_api_key=false，使用不需要额外申请 API Key。

它解决的问题分三块：一是把 COMSOL 的操作接进 Python 流程，支持批量建模、参数化仿真、自动求解与后处理；二是覆盖常见的物理场类型，让不同领域的脚本有统一的调用方式；三是处理跨 COMSOL 版本的兼容问题。

核心能力¶

1. Python 调用与控制 COMSOL¶

通过 MPh + JPype 桥接 COMSOL 的 Java API，把建模、求解、后处理写进 Python 脚本，而不是在桌面端手动操作。适用于需要批量建模、参数化仿真、自动求解与后处理的场景。

2. 物理场覆盖¶

简介中列出的覆盖范围包括：流体流动（spf 层流/湍流/多相）、传热（ht 导热/对流/共轭传热）、结构力学、静电/电流/磁场/电磁波、浓/稀物质传递（化工传质）、压力声学、多孔介质流、化学反应工程（蒸汽重整等多孔催化反应器）、数学 PDE、变形网格、多物理场耦合。

3. 跨版本兼容¶

面向 COMSOL 6.0 / 6.2 等版本的差异，处理三类典型故障：某属性或特征在某版本不存在、模型打不开、结果不对但不报错。

4. 自带可运行代码库与测试¶

Skill 内含可直接运行的 comsol_toolkit 代码库、版本兼容层 compat、15 项真机冒烟测试（覆盖 12 类物理场，含解析解定量对比）与权威命名手册。

其中命名手册的作用是把 COMSOL 各物理场的特征和属性名集中整理，配合兼容层一起用，能减少”名字写错但 COMSOL 不报错”的情况。

安装与启用¶

这一步说明资料能核实到的部分。Skill 以 SKILL.md 通用格式组织，官方入口有两个：

https://api.skillhub.cn/user_6eed38f8/comsol-automation
https://www.skillhub.cn/skills/user_6eed38f8/comsol-automation

启用时按坐标引用：

@user_6eed38f8/comsol-automation

需要说明的是：抓取到的资料里没有给出命令行安装命令，也没有 Cursor / Codex CLI / Claude Code 各自的安装差异说明。因此安装步骤以官方页面为准，不要按通用 Skill 的习惯去猜命令。使用前不需要配置 API Key（requires_api_key=false）。

典型用法¶

资料没有提供完整的端到端示例，以下是按 Skill 自带组件组织的工作流，具体接口名以命名手册为准。

1、准备环境。确认本机可运行 COMSOL，并且 Python 侧能通过 MPh + JPype 建立连接。从桥接方式看，运行环境需要 JPype 可用（依赖 Java 运行时），这一点资料未展开，实际使用时需先验证。

2、先跑冒烟测试。用 Skill 内含的 15 项真机冒烟测试确认环境可用，这 15 项覆盖 12 类物理场，并做解析解定量对比，能在一开始就区分”脚本写错”和”环境不对”。

3、引入工具库与兼容层。建模脚本从 comsol_toolkit 取基础封装，属性和特征名的跨版本差异交给 compat 处理。

4、建模、求解、后处理。把批量建模和参数化仿真写成脚本，求解与后处理自动执行，避免在桌面端逐个操作。

5、用命名手册核对。出现某属性或特征在某版本不存在、模型打不开、结果不对但不报错的情况时，先用命名手册核对名字，再改 compat 层。

适用场景与注意¶

适合的人：需要把 COMSOL 仿真放进自动化流程的开发者，涉及批量建模、参数化扫参、自动求解与后处理的人；以及在 COMSOL 6.0 / 6.2 之间迁移脚本、遇到兼容问题的人。

需要注意的点：

• 需要本机具备可用的 COMSOL 环境。Skill 是驱动层，不是替代求解器。
• JPype 桥接 Java API，意味着 Python 侧依赖 JPype/Java 运行条件，跨平台部署前要先验证。
• 物理场相关属性名随 COMSOL 版本变化，升级版本后应重跑冒烟测试，再核对命名手册。
• 简介中列出的 15 项冒烟测试覆盖 12 类物理场，超出这 12 类的物理场需要自行补充验证。

结尾¶

这个 Skill 的价值在于把 COMSOL 的仿真流程接到 Python 里，并顺手解决了跨版本脚本失效这个长期痛点：工具库、兼容层、冒烟测试和命名手册四件套都在包内，不是空的说明书。

官方地址：https://api.skillhub.cn/user_6eed38f8/comsol-automation