BeamBench: CLI kullanımı

Beam Bench'i terminalden yönetin. Projeleri açın, tuvalleri işleyin, durumu inceleyin ve dosyaları dışa aktarın.

beambench-cli ikili dosyası, Beam Bench uygulamasıyla birlikte oluşturulur. Betik oluşturma, toplu işlemler ve başsız işleme için kullanın.

Gerekenler

Beam Bench kurulmuş olmalı (veya kaynak koddan derliyorsanız depo kullanıma hazır olmalı).
Bir terminal (macOS'ta Terminal, Windows'ta PowerShell, Linux'ta herhangi bir kabuk).
Bazı komutlar için uygulamanın çalışıyor olması gerekir. Çoğu komut bunu gerektirmez.

Nerede bulunur?

İkili dosyanın adı beambench-cli'dir ve masaüstü uygulamasının yanına kurulur. Kesin yol, geçerli derlemenizin platforma özgü paket düzenine bağlıdır. Kurulum dizinini kontrol edin.

Kısalık için dosyayı PATH'inize eklemek veya bir takma ad tanımlamak isteyebilirsiniz:

alias bb=beambench-cli

Aşağıdaki örneklerde tam beambench-cli adı kullanılır.

Adımlar

1. CLI'ın çalıştığını doğrulayın

beambench-cli --help

Tüm alt komutları listeler. Her alt komutun kendine ait bir --help seçeneği vardır.

2. Aracı durumunu inceleyin

beambench-cli agent state --json

Geçerli proje, makine bağlantısı, seçim ve kamera durumunun JSON dökümünü döndürür. Betik oluşturma ve hata ayıklama için kullanışlıdır.

3. Tuvali PNG olarak işleyin (başsız)

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

Geçerli projenin tasarımını, kamera katmanı olmadan PNG olarak işler. GUI çalışmadan da kullanılabilir.

4. Kamera katmanıyla işleyin (GUI gerekir)

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

Tuvali, geçerli kamera katmanı çerçevesiyle yakalar. Masaüstü uygulamasının çalışıyor olması gerekir. CLI, uygulamaya bir reverse-RPC gönderir; uygulama işleme işlemini gerçekleştirip dosyayı yazar.

5. Proje açın

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

Yol konumsal bağımsız değişkendir. Geri kaydetmek için beambench-cli project save komutunu kullanın (bağımsız değişken almaz, açık dosyanın üzerine yazar) veya beambench-cli project save-as /abs/path/to/new.lzrproj komutunu kullanın.

6. Dosyaları dışa aktarın

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 ve AI dışa aktarımları --path alır. G-code iki konumsal bağımsız değişken alır: girdi .lzrproj ve çıktı .gcode.

7. Bağlantı noktalarını ve yetenekleri inceleyin

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

agent capabilities, CLI'ın yapabileceklerinin şemasını döndürür. agent guide, harici aracılar için başlangıç iş akışını döndürür.

CLI'ın yapamayacakları

Bir tuval aracı seçmek.
Bir paneli veya iletişim kutusunu açmak ya da kapatmak.
Bir kısayol tuşunu tetiklemek.
Tuval üzerinde sürükleyip bırakmak.

Bunlar için CLI yerine GUI'ı doğrudan yönetin (ör. computer-use veya AppleScript ile).

Örnekler

Bir klasördeki her projeyi toplu olarak işleyin

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

Makine durumunun her dakika anlık görüntüsünü alın

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

Çalıştığını doğrulayın

beambench-cli --help hatasız çalışır.
Bir design render işlemi, sıfırdan büyük boyutlu bir PNG üretir.
agent state geçerli JSON döndürür.

CLI kullanımı