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可用，但在本機授權穩定之前，建議使用圖形模式。- 第一個版本只會建立一個盒子。請擴充指令碼，而不是臨時重複執行易碎的 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 發現