HFSS PyAEDT 是做什么的？
概述
使用此技能通过本地 PyAEDT 执行脚本化 HFSS 工作，而不是手动驱动 HFSS GUI。优先用于可重复设置、小型几何自动化、环境诊断以及简单的仿真到导出工作流。
该技能目前提供一个稳定的入口点：scripts/hfss_workflow.py。从 doctor 开始，然后使用 new-box-project 或 analyze-project。
工作流程
- 在接触 HFSS 之前运行环境检查：
py -3.14 scripts/hfss_workflow.py doctor - 如果版本或 Python 路径发现很重要，请阅读 references/local-environment.md。
- 对于全新的自动化冒烟测试，使用
new-box-project创建一个最小项目。 - 对于现有的
.aedt项目，使用analyze-project设置变量、重新运行设置，并可选地导出 Touchstone。 - 当输出文件很大或包含大量二进制数据时，将它们保存到仓库外部。
命令指南
Doctor
首先使用此命令。它不会启动 HFSS。它报告 Python、PyAEDT 以及检测到的 AEDT 安装目录。
py -3.14 scripts/hfss_workflow.py doctor
当其他工具或脚本需要消费输出时，使用 --json。
创建最小项目
用于在机器上进行首次冒烟测试，或者当您需要一个微小的确定性 HFSS 项目时。
py -3.14 scripts/hfss_workflow.py new-box-project `
--project C:\temp\hfss\demo_box.aedt `
--design HFSSDesign1 `
--solution-type DrivenModal `
--origin 0mm,0mm,0mm `
--size 10mm,10mm,1mm `
--create-open-region `
--setup-name Setup1 `
--setup-frequency 10GHz `
--sweep-name Sweep1 `
--sweep-start 8 `
--sweep-stop 12 `
--sweep-count 401
注意：
--set-variable NAME=VALUE是可重复的。- 可以使用
--non-graphical，但建议在本地许可证明稳定之前使用图形模式。 - 初版只创建一个 box。扩展脚本，而不是即兴进行重复且脆弱的 GUI 操作。
分析现有项目
用于重新打开已保存的 .aedt 项目，更新变量，重新运行设置，并可选地导出 Touchstone。
py -3.14 scripts/hfss_workflow.py analyze-project `
--project C:\temp\hfss\demo_box.aedt `
--design HFSSDesign1 `
--setup-name Setup1 `
--sweep-name Sweep1 `
--set-variable L=12mm `
--export-touchstone C:\temp\hfss\demo_box.s2p
工作规则
- 优先为
.aedt输出和导出的.sNp文件使用显式文件路径。 - 将 PyAEDT API 行为视为版本敏感。如果某个方法失败，在修补前先检查当前方法签名。
- 保持首次自动化范围狭窄且可验证。一次只添加一个新的 HFSS 操作。
- 当用户要求超材料或天线专用流程时，扩展脚本或添加新脚本，而不是用未经检查的假设重载提示。
- 如果 HFSS 启动或求解失败，重新运行
doctor，确认已安装的 AEDT 路径，并捕获确切的错误。
参考资料
- references/workflow-recipes.md：命令示例和 Codex 提示模式
- references/local-environment.md：技能创建期间记录的本地 AEDT 和 Python 发现