LogLike
LogLike는 VS Code 터미널에서 발생한 오류와 해결 과정을 자동으로 수집해 시각적인 디버깅 지식 그래프로 보여주는 익스텐션입니다.
주요 기능
- VS Code Shell Integration을 이용한 터미널 명령 종료 및 오류 감지
- 오류 로그와 현재 소스 코드를 이용한 AI 원인 분석
- 오류, AI 가설, 해결 결과를 연결한 Node View와 List View
- 과거 디버깅 기록 검색과 유사 사례 조회
- Ollama 로컬 모델 및 Gemini, OpenAI, Claude 지원
요구 사항
- VS Code 1.93 이상
- 실행 중인 LogLike FastAPI 백엔드
- 로컬 AI를 사용할 경우 호스트에 설치한 Ollama와 모델
- 클라우드 AI를 사용할 경우 해당 제공자의 API 키
LogLike 익스텐션은 백엔드를 내장하지 않습니다. 백엔드와 데이터베이스는 사용자의 로컬 환경에서 별도로 실행됩니다.
설치
VSIX로 설치
- 릴리스 페이지에서
.vsix 파일을 내려받습니다.
- VS Code에서
Extensions: Install from VSIX... 명령을 실행합니다.
- 내려받은 파일을 선택하고 VS Code를 다시 로드합니다.
Marketplace에서 설치
Marketplace 공개 이후 VS Code 확장 보기에서 LogLike를 검색해 설치할 수 있습니다.
백엔드 실행
리포지토리를 복제한 뒤 Docker로 API 서버를 실행할 수 있습니다.
git clone https://github.com/KNU-CapstoneDesignOrg/Log_Like.git
cd Log_Like
docker compose up --build -d api-server
기본 백엔드 주소는 http://localhost:8000입니다. 다른 주소를 사용한다면 VS Code 설정의 LogLike: Backend Base URL 값을 변경하세요.
Command Palette에서 LogLike: Check Backend Connection을 실행하면 연결 상태를 확인할 수 있습니다.
AI 모델 설정
Ollama 로컬 모델
Ollama는 Docker Compose에 포함되지 않습니다. 운영체제에 맞게 Ollama를 직접 설치한 다음 모델을 준비하세요.
ollama pull qwen2.5-coder:1.5b
ollama serve
Docker의 API 서버는 기본적으로 호스트의 http://host.docker.internal:11434에 연결합니다. 모델을 변경할 때는 API 서버의 OLLAMA_MODEL 환경변수와 Ollama에 설치한 모델명을 동일하게 설정해야 합니다.
클라우드 모델
LogLike 설정 화면에서 Gemini, OpenAI 또는 Claude를 선택하고 모델명과 API 키를 입력합니다. API 키는 로컬 백엔드 데이터베이스에 저장되므로, 신뢰할 수 없는 공유 백엔드에는 키를 입력하지 마세요.
사용 방법
- 백엔드 연결을 확인합니다.
- VS Code 통합 터미널에서 프로젝트 명령을 실행합니다.
- 명령이 오류로 종료되면 표시되는 알림에서
시작을 선택합니다.
- LogLike가 터미널 출력과 활성 소스 파일을 분석하고 그래프를 엽니다.
- 해결 명령이 정상 종료되면 성공 기록이 세션에 추가됩니다.
사용 가능한 명령:
LogLike: Open Debug GraphLogLike: Check Backend ConnectionLogLike: Analyze SelectionLogLike: Show Diagnostics
Analyze Selection은 자동 감지가 어려울 때 사용하는 수동 분석 명령입니다.
자동 감지 제한 사항
자동 수집은 VS Code Shell Integration에 의존합니다. 다음 경우에는 수동 분석이 필요할 수 있습니다.
- 셸 또는 실행 방식이 명령 출력 스트림을 제공하지 않는 경우
- 개발 서버가 종료되지 않고 브라우저에서만 오류가 발생한 경우
- 명령 종료 코드는 0이지만 애플리케이션 내부 오류가 발생한 경우
문제 해결
- 백엔드 연결 실패:
LogLike: Check Backend Connection을 실행하고 loglike.backendBaseUrl을 확인합니다.
- 로컬 AI 연결 실패:
ollama serve가 실행 중인지와 설치 모델명을 확인합니다.
- 자동 오류 감지 실패: VS Code Shell Integration을 활성화하거나
LogLike: Analyze Selection을 사용합니다.
- 상세 진단 확인:
LogLike: Show Diagnostics를 실행합니다.
개발 및 패키징
npm --prefix frontend ci
npm --prefix extension ci
npm --prefix extension run build
npm --prefix extension run package
프로젝트 소스와 이슈는 GitHub 리포지토리에서 확인할 수 있습니다.
라이선스
MIT License
