使用CLI

從終端驅動Beam Bench。開啟專案、渲染畫布、檢查狀態、匯出文件。

beambench-cli二進位制檔案與Beam Bench應用一同構建。可將其用於指令碼編寫、批次操作和無頭渲染。

所需條件

已安裝Beam Bench（如果從原始碼構建，也可以檢出倉庫）。
終端（macOS上的Terminal、Windows上的PowerShell或Linux上的任意shell）。
某些命令需要應用正在執行，大多數命令不需要。

查詢位置

二進位制檔名為beambench-cli，與桌面應用安裝在一起。確切路徑取決於當前構建的平臺程式包佈局；請檢查安裝目錄。

你可以將其新增到PATH，或為簡便起見為其建立別名：

alias bb=beambench-cli

以下示例使用完整的beambench-cli名稱。

步驟

1. 驗證CLI是否正常工作

beambench-cli --help

列出所有子命令。每個子命令都有自己的--help。

2. 檢查代理狀態

beambench-cli agent state --json

返回當前專案、機器連線、選區和相機狀態的JSON轉儲。適用於指令碼編寫和除錯。

3. 將畫布渲染為PNG（無頭模式）

beambench-cli design render --png /tmp/out.png --pixels-per-mm 4

將當前專案的設計（不含相機疊加層）渲染為PNG。無需執行GUI即可工作。

4. 使用相機疊加層渲染（需要GUI）

beambench-cli camera overlay render --output /tmp/overlay.png --view fit

捕獲帶有當前相機疊加層畫面的畫布。需要桌面應用正在執行；CLI嚮應用傳送反向RPC，由應用執行渲染並寫入檔案。

5. 開啟專案

beambench-cli project open /abs/path/to/project.lzrproj

路徑作為位置引數傳入。要儲存回原檔案，請使用beambench-cli project save（無引數，會覆蓋開啟的檔案），或使用beambench-cli project save-as /abs/path/to/new.lzrproj。

6. 匯出文件

beambench-cli export svg --path /abs/path/out.svg
beambench-cli export gcode /abs/path/to/project.lzrproj /abs/path/out.gcode

SVG、DXF、PDF、EPS和AI匯出使用--path。G-code使用兩個位置引數：輸入.lzrproj和輸出.gcode。

7. 檢查埠/功能

beambench-cli ports
beambench-cli agent capabilities --json
beambench-cli agent guide --json

agent capabilities返回CLI可執行操作的架構。agent guide返回供外部代理使用的引導工作流。

CLI無法執行的操作

選擇畫布工具。
開啟或關閉面板/對話方塊。
觸發快捷鍵。
在畫布上拖放。

對於這些操作，請直接驅動GUI（例如通過computer-use或AppleScript），不要使用CLI。

示例

批次渲染資料夾中的每個專案

for f in /path/to/projects/*.lzrproj; do
  beambench-cli project open "$f"
  beambench-cli design render --png "${f%.lzrproj}.png" --pixels-per-mm 4
done

每分鐘獲取一次機器狀態快照

while true; do
  beambench-cli agent state --json > "/tmp/state-$(date +%s).json"
  sleep 60
done

驗證是否成功

beambench-cli --help無錯誤執行。
design render生成非零大小的PNG。
agent state返回有效的JSON。