pyaedt-hfss-antenna

A Claude Code / Codex CLI skill for driving Ansys HFSS antenna & RF simulations through PyAEDT.

让 AI agent 用 PyAEDT 驱动 Ansys HFSS 跑天线/RF 仿真。装上之后,只要你跟 agent 说"用 HFSS 仿真这个天线"、“扫频 2-6 GHz 提 S 参数”、“画方向图”,它就会按这个 skill 给的标准工作流来做。

---

What’s inside

pyaedt-hfss-antenna/
├── SKILL.md                          # 主入口:何时触发 + 9 步标准工作流
├── references/
│   ├── environment-setup.md          # 版本对照、安装、gRPC/COM、license
│   ├── antenna-workflow.md           # 主线 9 步的 API 详解
│   └── common-pitfalls.md            # 高频报错速查
├── templates/
│   ├── sparam_extraction.py          # S 参数 + 谐振点 + -10 dB 带宽
│   ├── far_field_pattern.py          # 远场方向图 + 增益 + 辐射效率
│   └── parametric_sweep.py           # 变量参扫(native + Python loop)
├── scripts/
│   └── check_env.py                  # 探测本机 AEDT/Python/pyaedt
└── .claude-plugin/plugin.json        # Claude Code 插件清单

设计原则:进度式披露(progressive disclosure)。SKILL.md 给主线,具体步骤需要时再去 references / templates 里查,不会一次性把所有内容塞进 agent 上下文。

---

Compatibility

AEDT 在 macOS 上无原生支持,Mac 用户需远程到 Windows/Linux 服务器,本地 PyAEDT 走 gRPC 连接。详见 references/environment-setup.md。

---

Installation

Option 1 · Claude Code

把这个仓库直接克隆到 Claude Code 的全局 skills 目录:

# macOS / Linux
git clone [email protected]:WishingCat/pyaedt-hfss-antenna.git \
    ~/.claude/skills/pyaedt-hfss-antenna

# Windows (PowerShell)
git clone [email protected]:WishingCat/pyaedt-hfss-antenna.git `
    "$env:USERPROFILE\.claude\skills\pyaedt-hfss-antenna"

之后在任何 Claude Code 会话里,只要你的请求与 HFSS / 天线仿真 / pyaedt 相关,这个 skill 就会自动出现在可用列表里被触发。

也可以装成 Claude Code 插件(支持 marketplace 风格):

# 仓库根带 .claude-plugin/plugin.json,可被 Claude Code plugin 系统识别
# 通过 /plugin install 或将仓库加为 marketplace 后选择安装

仅在某个项目里启用

不想全局生效,只想在某个项目目录里启用:

cd /path/to/your/project
git clone [email protected]:WishingCat/pyaedt-hfss-antenna.git \
    .claude/skills/pyaedt-hfss-antenna

Option 2 · Codex CLI(OpenAI Codex)

git clone [email protected]:WishingCat/pyaedt-hfss-antenna.git \
    ~/.codex/skills/pyaedt-hfss-antenna

Codex 与 Claude Code 都遵循 SKILL.md 的 frontmatter 约定(name + description),仓库结构通用。

Option 3 · Manual / 不安装,只让 agent 临时读

如果你不想往全局目录里装,可以把仓库克隆到任意位置,然后在会话里告诉 agent:

Please read the skill at /path/to/pyaedt-hfss-antenna/SKILL.md
and follow its workflow for any HFSS / antenna simulation task.

---

Verify install

在装完之后,跑一下环境检测:

python ~/.claude/skills/pyaedt-hfss-antenna/scripts/check_env.py

期望输出:

============================================================
 PyAEDT environment check
============================================================

[OS]      Windows ...
[Python]  3.11.x
[pyaedt]  0.18.x

--- AEDT installations ---
  v252 (2025 R2)
      path : C:\Program Files\AnsysEM\v252\Win64
      pyaedt 推荐版本:>=0.18

如果 [pyaedt] NOT INSTALLED,装一下:

pip install "pyaedt[all]"

---

Usage examples

装好后随便起一段对话:

“我有一个 2.45 GHz 的微带贴片天线工程在 D:\sim\patch.aedt,帮我扫频 2-3 GHz 提取 S11、谐振频率和 -10 dB 带宽。”

agent 会:

1. 先读 SKILL.md 找到对应模板 → templates/sparam_extraction.py
2. 复制模板,改顶部 PROJECT_PATH / DESIGN_NAME / FREQ_* 参数
3. 必要时查 references/antenna-workflow.md 了解 API 细节
4. 报错时查 references/common-pitfalls.md

更多触发短语:

• “用 HFSS 仿真这个天线”
• “画方向图 / 看增益 / 提辐射效率”
• “扫一下 patch_w 从 28mm 到 32mm 的 S11”
• “为什么 pyaedt 连不上 AEDT?”
• “AEDT 2022 R1 怎么用 pyaedt”

---

Tips

• 第一次跑任何脚本先用粗网格(MaximumPasses=3, num_of_freq_points=21)走通流水线,再加密。
• 永远 release_desktop(),否则 license 会泄漏。模板里都已经用 try/finally 包好。
• 中文路径会让 PyAEDT 跨进程通信不稳定,项目路径用英文。
• 远程 gRPC 连接需要在远端用 ansysedt.exe -grpcsrv 启动 server。

详见 references/common-pitfalls.md。

---

Updating

cd ~/.claude/skills/pyaedt-hfss-antenna
git pull

---

Contributing

发现模板在你机器的 PyAEDT 版本上签名不对、或踩到 common-pitfalls.md 没覆盖的坑,欢迎开 issue 或 PR。

特别欢迎:

• 新结构模板(horn / dipole / array / 超表面 / 雷达散射 …)
• 不同 AEDT 版本的兼容性补丁
• "从零建模 X 天线"端到端 demo 脚本

---

License

MIT

Acknowledgments

• Ansys PyAEDT — 没有这个库就没有这个 skill
• Anthropic Claude Code — skill 系统