VSCode 매뉴얼

설치와 진단 워크플로

입력 파일 준비부터 diagnostics 탐색까지 재현 가능한 순서를 제공합니다.

핵심 개념

입력 계약

회로 렌더링에는 schematic 파일이 필수입니다.
diagnostics 파일은 선택이며 이슈 overlay를 제공합니다.

탐색 루프

산출물 갱신 후 refresh로 오래된 이슈 표시를 정리합니다.
next/previous issue 명령으로 점검 순서를 고정합니다.

역량 스냅샷

가능

`schematic.json` 기반 회로 그래프를 렌더링하고 `Ranvier Circuit Nodes` 패널과 동기화할 수 있습니다.
매핑 정보가 있을 때 선택한 회로 노드에서 소스 위치로 점프할 수 있습니다.
현재 편집 파일/라인 문맥에서 매핑된 회로 노드를 하이라이트할 수 있습니다.
`diagnostics.json` 결과를 웹뷰/사이드바/VSCode Problems에 투영할 수 있습니다.
명령 팔레트에서 현재 줄 기준 매핑된 회로 노드를 바로 찾을 수 있습니다.
명령과 기본 단축키로 다음/이전 노드 이슈를 이동할 수 있습니다.
팀 도입을 위해 EN/KO 로캘 UX와 단축키 오버라이드 템플릿을 제공합니다.
Inspector 서버에 자동 연결하고 실시간 히트맵(트래픽/레이턴시/에러/없음)으로 노드 메트릭을 시각화할 수 있습니다.
이벤트 스트림 패널에서 노드/타입/텍스트 필터로 Inspector 생애주기 이벤트를 실시간 모니터링할 수 있습니다.
임계값을 초과한 정체 노드를 pulsing glow 애니메이션으로 시각적 경고 표시할 수 있습니다.
6종 Rust 코드 스니펫(rvtransition, rvroute, rvaxon, rvbus, rvtest)을 삽입하여 빠른 Ranvier 개발을 지원합니다.
catalog.json의 예제를 통합 터미널에서 탐색 및 실행할 수 있습니다 (`ranvier.runExample` 명령어).
Circuit-Aware API Explorer 사이드바에서 API 엔드포인트를 테스트할 수 있습니다 — Inspector에서 라우트 자동 발견, 헤더/파라미터/본문/인증 탭으로 요청 구성, 상태/시간/회로 트레이스와 함께 응답 표시, 캐시된 스키마로 오프라인 사용 가능.
`.ranvier/collections/`에서 요청 컬렉션을 관리할 수 있습니다 — 저장, 복제, 이름변경, 삭제, 필터, 정렬, 그룹 기능. 실행 이력 자동 저장 및 보관 정책 설정 가능.
JSON Schema 기반 빈 본문 템플릿 및 faker 자동 채움 데이터를 생성할 수 있습니다 (Inspector 서버 우선, 클라이언트 측 폴백). 요청별 프리셋 저장, `.ranvier/environments/` 파일의 `{{변수}}` 보간 지원.
컬렉션을 `.ranvier-bundle.json` 또는 단일 요청을 `.ranvier-request.json`으로 내보낼 수 있습니다 — 민감 패턴 자동 감지 비밀 수정 포함. 충돌 감지 및 해결 다이얼로그와 함께 가져오기 지원.
일괄 요청 실행(순차 진행 추적), 어설션 평가(10개 연산자, JSON 경로 대상), JSON Schema 기반 본문 검증, JUnit 호환 결과 요약을 제공합니다. 키보드 코드 단축키(Ctrl+R 접두사)로 전송, 템플릿, faker 작업 지원.
WebSocket 엔드포인트를 양방향 메시지 로그, 연결/해제 라이프사이클, 자동 재연결, 서브프로토콜 헤더, 메시지 필터링(text/JSON, 키워드 검색)으로 테스트할 수 있습니다.
SSE 엔드포인트를 이벤트 스트림 로그(type, data, id, retry), 이벤트 타입 필터, Last-Event-ID 재연결, 세션 히스토리로 테스트할 수 있습니다.
Svelte 5 기반의 통합된 탭 방식 사이드바로 확장 내 각종 보조 도구(Circuit, Toolbox, Features, API)를 단일 뷰에서 쉽고 빠르게 전환 사용할 수 있습니다.
API Explorer, Toolbox, Feature Hub 패널 등에서 Vite/Svelte 5 렌더링 초기화 시 발생할 수 있는 잠재적 런타임/CSP 충돌을 방지하고 안정적인 렌더링을 보장합니다.

제한

빠른 시작

ranvier schematic hello-world --output schematic.json
code --install-extension cellaxon.ranvier-vscode

필수 파일

필수: <workspace-root>/schematic.json
선택: <workspace-root>/diagnostics.json

주요 워크플로

명령 팔레트에서 Circuit View를 엽니다.
산출물(artifact) 갱신 후 diagnostics overlay를 갱신합니다.
Next/Previous Node Issue 명령으로 이슈를 순회합니다.

검증 명령

회로 뷰 열기 확인 Command Palette > Ranvier: Open Circuit View
진단 오버레이 반영 확인 Command Palette > Ranvier: Refresh Diagnostics
노드 이슈 이동 확인 Command Palette > Ranvier: Go To Next Node Issue / Ranvier: Go To Previous Node Issue
서버 연결 + 히트맵 모드 전환 확인 Connect to Inspector server > Toggle heatmap modes in Circuit View
이벤트 스트림 패널 필터링 확인 Circuit View > Events panel > Filter by node/type/text
정체 노드 시각적 경고 확인 Stall threshold exceeded > Node shows pulsing glow

샘플 재현 페이지

재현 절차는 /ko/manual/samples/vscode에서 확인하세요.
최신 capability 상태와 버전 산출물은 /ko/status에서 확인하세요.