문제 해결

로그 파일

VMark는 문제 진단을 돕기 위해 로그 파일을 기록합니다. 로그에는 Rust 백엔드와 프론트엔드의 경고 및 오류가 포함됩니다.

로그 파일 위치

플랫폼	경로
macOS	~/Library/Logs/app.vmark/
Windows	%APPDATA%\app.vmark\logs\
Linux	~/.local/share/app.vmark/logs/

로그 수준

수준	기록 내용	프로덕션	개발
Error	실패, 충돌	예	예
Warn	복구 가능한 문제, 대체 처리	예	예
Info	주요 이벤트, 상태 변경	예	예
Debug	상세 추적 정보	아니요	예

로그 순환

• 최대 파일 크기: 5 MB
• 순환: 이전 로그 파일 1개 유지
• 오래된 로그는 자동으로 교체됩니다

버그 신고

버그를 신고할 때 다음 정보를 포함해 주세요:

1. VMark 버전 — 내비게이션 바 배지 또는 정보 대화상자에 표시됩니다
2. 운영 체제 — macOS 버전, Windows 빌드 또는 Linux 배포판
3. 재현 절차 — 문제가 발생하기 전에 수행한 작업
4. 로그 파일 — 관련 로그 항목을 첨부하거나 붙여넣으세요

로그 항목에는 타임스탬프가 찍혀 있고 모듈별로 태그가 지정됩니다(예: [HotExit], [MCP Bridge], [Export]). 이를 통해 관련 부분을 쉽게 찾을 수 있습니다.

관련 로그 찾기

1. 위 표를 참고하여 로그 디렉터리를 엽니다
2. 가장 최근의 .log 파일을 엽니다
3. 문제가 발생한 시간 부근의 ERROR 또는 WARN 항목을 검색합니다
4. 관련 행을 복사하여 버그 신고에 포함합니다

자주 발생하는 문제

Windows에서 앱 시작이 느림

VMark는 macOS에 최적화되어 있습니다. Windows에서는 WebView2 초기화로 인해 시작이 느릴 수 있습니다. 다음을 확인하세요:

• WebView2 Runtime이 최신 버전으로 업데이트되어 있는지
• 바이러스 백신 소프트웨어가 앱 데이터 디렉터리를 실시간 검사하고 있지 않은지

언어 변경 후 메뉴 바가 영어로 표시됨

설정에서 언어를 변경한 후에도 메뉴 바가 영어로 표시되면 VMark를 다시 시작하세요. 다음 실행 시 저장된 언어 설정으로 메뉴가 다시 구성됩니다.

터미널에서 CJK 문장 부호가 입력되지 않음

v0.6.5 이상에서 수정되었습니다. 최신 버전으로 업데이트하세요.