技能介绍

要解决什么问题

电池团队在 COMSOL 里往往同时面对三类资产：现成的 .mph、从模型导出的 .java，以及需要从零搭完并交付指标与报告的新模型。日常痛点不是「会不会点 COMSOL」，而是审计与改参后如何重算、Java 体量过大 AI 读不全、以及谁该跑 sim-cli / comsolbatch、会话怎么管——若把这些决策丢给用户，很容易在 JSON 配置、session id 和工具选择上卡住。

技能如何工作

本技能由 Agent（Codex）选择最小执行路线、判断物理合理性并做验收；底层统一走 sim-cli、ModelUtil、COMSOL Desktop/MCP、comsolcompile 与 comsolbatch，不要求用户准备 JSON、选工具或手工跑命令。

典型路线包括：

MPH Direct：已有 .mph 时，经 run_mph_tool.py + ModelUtil 做审计、诊断、修改与重算；单一 launcher 复用健康会话，避免手工复制 .sim 或自行解析 session id。
Java Snippet：已有导出 .java 时，先用 analyze_java_size.py、strip_java_for_ai.py 生成定向视图，再按真实 tag/property 理解或局部修改，不发明 API。
Autonomous Java：从零构建并交付 .java/.mph/metrics/report，按 cycle_result.json 迭代，默认 comsolcompile.exe 编译、comsolbatch.exe 求解。

诊断按症状选 preset（如 voltage、capacity、heat_balance、solver、sweep），默认 summary；只读诊断会直接执行，用户仅要求诊断时不得自动改模型。修改须保留源文件并另存；完整建模或长计算前会确认验收条件与运行预算。

适用边界

MATLAB 调度或优化器集成应转交 comsol-livelink-matlab，本技能不重复实现。
MCP 不是主链：仅在标准多物理原型、结构化文档检索或当前路线缺操作时辅助；DLP 包装的 .mph 仍优先由 COMSOL 后端 ModelUtil.load() 加载。
验收要求保存后的 .mph 卸载重载并通过断言；改物理/求解表达式后跑最小 smoke，且 smoke 不能表述为完整扫描已完成。License 错误只报告一次并停止重试。

截图预览

使用场景

手头已有 `.mph`，充放电电压平台或起止电压异常，需要按 `voltage` preset 审计边界与研究步骤并重算验证。
同一电池模型容量或 SOC 与实验不一致，需走 `capacity` preset 对照材料体系 reference 排查并决定是否改参重算。
同事导出超大 `.java`，要在不整文件硬读的前提下理解 tag 依赖并做局部修改后重新编译求解。
从零搭电化学—热耦合模型，需按验收条件用 Autonomous Java 交付 `.mph`、metrics 与 smoke 报告。

适合人员

负责维护企业 COMSOL 锂离子 `.mph` 的仿真工程师，改材料或边界后需要标准化审计与重算闭环。
拿到历史导出 `.java` 却难以人工通读的电池建模研发，希望 Agent 按真实 API 做定向理解与补丁。
仿真负责人只想做只读诊断（收敛、产热守恒、扫描缺 case），明确要求诊断阶段不得自动改模型。
需要把 sim-cli、ModelUtil 会话与 comsolbatch 串起来、又不想自己维护 JSON 与 session id 的 CAE 集成维护者。