CLI 사용

로컬 API를 통해 실행 중인 앱을 검사하고 편집하거나 G-code를 직접 내보냅니다.

beambench-cli 바이너리는 데스크톱 앱과 함께 배포됩니다. 대부분의 프로젝트, 디자인, 장치, 프로필 및 상태 명령은 앱의 로컬 API 클라이언트입니다. 앱이 실행 중이고 설정 > 일반 > 로컬 API가 활성화되어 있어야 합니다.

같은 컴퓨터에서 실행되는 스크립트에서는 네트워크 장치의 연결 허용을 꺼 두십시오. 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 작업입니다.