와이어프레임 저장소(bizui-cbs-wireframe)를 git clone 해 그 폴더를 연다(설치 가이드 3단계). 확장은 프로젝트를 만들지 않는다 -
규칙·스킬·요소 카탈로그(catalog/bxui.catalog.json)·검사 도구는 전부 그 저장소가 갖고 있다.
BX-UI: 프리뷰 열기 - 화면을 보면서 요소를 고르고, 고치고, 오른쪽 채팅에 요청한다.
BX-UI: 새 화면 으로 화면을 추가한다. AI 는 저장소의 $wf-mockup-build 스킬로 목업을 그리고 dashboard.tsx 에 등록한다.
주요 명령
명령
하는 일
BX-UI: 프리뷰 열기
와이어프레임 프리뷰 패널
BX-UI: Select 모드 전환
프리뷰에서 요소를 찍어 대화에 붙인다
BX-UI: Edit 모드 전환 (Ctrl+Alt+E)
요소를 직접 고친다 · 툴바의 되돌리기 단추로 되돌린다
BX-UI: Comment 모드 전환
화면에 Comment를 남긴다
BX-UI: 첨부 추가
이미지·문서를 요청에 붙인다
BX-UI: 마지막 요청 되돌리기
AI 가 바꾼 파일을 되돌린다
BX-UI: 정합 검사
저장소의 tools/spec-check.mjs(spec 없는 이미지 목업은 tools/mockup-lint.mjs)를 돌려 결과를 보인다
BX-UI: 로그 보기
확장 로그
BX-UI: 버그 신고
우측 패널 머리 오른쪽 끝의 버그 신고 아이콘과 같다 - 폼을 채워 개발팀 스프레드시트로 보낸다
BX-UI: 보내지 못한 버그 리포트 다시 보내기
네트워크 문제 등으로 저장만 해 둔 리포트를 다시 보낸다
BX-UI: 보내지 못한 버그 리포트 관리
저장해 둔 리포트 목록에서 골라 다시 보내기 · 삭제 · 폴더 열기
BX-UI: 시작하기
기능을 단계별로 안내하는 워크스루를 연다 - 처음 설치했을 때는 저절로 한 번 열린다
Edit 모드는 저장소의 catalog/bxui.catalog.json 을 읽는다. 없으면 저장소에서 node tools/build-catalog.mjs 를 돌린다(최신 저장소면 git pull).
설정
bxui.ai.default(claude · codex), bxui.ai.claude.model · effort · maxTurns, bxui.preview.port 등 - 설정 화면에서 BX-UI Design 을 찾는다.
버그 신고
우측 패널 머리(BXUI Design) 오른쪽 끝의 버그 신고 아이콘으로 확장의 문제를 개발팀에 알린다. 우측 패널을 닫아 두었으면 명령 BX-UI: 버그 신고 를 쓴다(패널을 연다고 안내한다). 제목·이름·상세 설명(필수)과 재현 절차·기대/실제 결과, 캡처 이미지 최대 3장
(Ctrl+V 붙여넣기 · 끌어놓기 · 파일 선택)을 적어 보내면 팀 Google 스프레드시트의 맨 위(최신순)에 한 행으로 쌓인다.
함께 보내는 정보는 제품명(열린 프로젝트의 package.json name, 없으면 폴더명) · 확장 버전 · VS Code 버전 · OS · 제출 시각이다. 고객정보·개인정보가 보이는 화면은 캡처해 올리지 않는다.
PC 정보 포함(기본 켜짐)을 두면 PC명 · 사내 IP(가상 어댑터 제외) · 공인 IP 도 함께 보낸다. 보낼 값은 체크박스에 마우스를 올리면 툴팁으로 보이고, 마지막 선택을 기억한다.
공인 IP 는 api.ipify.org 에 물어 알아낸다 - 막혀 있으면 "조회 실패" 로 두고 나머지는 그대로 보낸다.
이미지는 긴 변을 bxui.attachments.maxImageEdge(기본 2000px)로 줄여 올린다.
썸네일을 누르면 캡처 위에 빨간 사각형(R) · 화살표(A)로 문제 위치를 표시할 수 있다. Ctrl+Z 로 되돌리고, 다시 열면 그린 표시를 고칠 수 있다(표시를 모두 지우고 적용하면 원본으로 돌아간다).
폼은 제목 줄(버그 신고)을 잡고 끌어 옮길 수 있다. 열 때마다 가운데에서 시작하고, 제목 줄을 두 번 누르면 가운데로 돌아간다.
취소(취소 단추 · X · Esc)하면 이름 · 이메일(마지막 제출 때 저장된 값)만 남기고 적던 내용 · 이미지 · 표시를 모두 지운다.
보내지 못하면 리포트를 이 PC(확장 전역 저장소의 reports/)에 저장해 두고, 알림의 다시 보내기 또는 명령 BX-UI: 보내지 못한 버그 리포트 다시 보내기 로 보낸다.
VS Code 를 다시 열 때도 남은 리포트가 있으면 한 번 묻는다(다시 보내기 · 삭제 · 나중에). 삭제는 확인 창을 거친다.
다시 보내도 받지 않을 실패(토큰 불일치 · 서버가 내용을 거절)는 켤 때 묻지 않고 BX-UI: 보내지 못한 버그 리포트 관리 목록에만 남는다.
확장을 업데이트하면 한 번 더 묻는다(새 빌드에서는 받을 수 있으므로).
접수 서버(Apps Script 웹 앱) 주소·토큰은 빌드에 들어간다. 설치·배포 절차는 저장소의 tools/bug-report-apps-script/README.md,
주소·토큰은 저장소 루트의 report.config.json 에 있다. 설정이 빠진 빌드에서는 단추가 "설정되어 있지 않다" 고 알린다.
