핵심 개념
입력 계약
회로 렌더링에는 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에서 확인하세요.