使用 CLI
透過本機 API 檢查和編輯執行中的應用程式，或直接匯出 G-code。
beambench-cli 二進位檔會隨桌面應用程式一同發佈。大多數專案、設計、機器、設定檔和狀態命令都是應用程式本機 API 的用戶端。這些命令要求應用程式正在執行，且已啟用 Settings > General > Local API。
在同一臺電腦上執行的指令碼中，請關閉 Allow network devices to connect。CLI 會從應用程式設定讀取已設定的 API 連接埠；預設值為 5900。
尋找可用命令
beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json不開啟應用程式也能使用說明。功能和即時狀態會使用 API。使用 --help 執行子命令，即可查看已安裝版本的參數。
開啟和檢查專案
beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json開啟專案會變更桌面應用程式中的專案。執行會取代或編輯專案的指令碼前，請先儲存工作內容。
beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj轉譯與匯出
beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg這些命令會透過 API 使用執行中應用程式的專案。設計轉譯不需要顯示畫布，但仍需要伺服器。
beambench-cli camera overlay render --output /tmp/overlay.png --view fit相機疊加轉譯也需要應用程式的前端處理轉譯要求。這不是相機工作流程的無頭替代方案。
不需要應用程式即可執行的命令
列出序列埠、說明及位置式 G-code 匯出可直接在本機執行：
beambench-cli ports
beambench-cli export gcode /abs/path/project.lzrproj /abs/path/out.gcode獨立 G-code 匯出會使用本機儲存的機器設定檔，以及桌面應用程式的規劃和輸出檢查。它無法讀取即時機器位置。請閱讀 G-code 輸出，了解設定檔和定位要求。
自動化與衝突
設計交易會使用目前的專案修訂版本。如果其他編輯、專案切換或關閉操作使擷取的專案失效，交易會遭拒。重新整理狀態並重新評估操作後再重試；請勿使用舊快照覆寫使用者同時進行的編輯內容。
可能移動機器、啟動雷射、傳送原始 G-code 或變更氣體輔助的命令，都需要其對應的確認旗標。提供這些旗標前，請先檢查命令說明和預定動作。
CLI 不會選取畫布工具、重新排列面板或觸發快速鍵。這些都是桌面 UI 操作。