어제 만든 블로그 학습 AI(RAG)를 오늘은 VS Code 확장 안으로 가져왔어요. 코드 리뷰 확장에 기능 하나를 더 얹은 거예요. 그 과정에서 겪은 에러 두 개랑, 그걸 고치면서 자연스럽게 추가된 기능들을 정리합니다.
오늘 한 일: 확장 하나에 기능 두 개
Cmd+Shift+P -> "Kodex: 블로그에 질문하기" 를 누르면 입력창이 뜨고, 질문을 입력하면 오른쪽 패널에 답변과 참고한 글 목록이 떠요 내부 동작은 어제 만든 ask.py와 똑같아요 - 질문을 임베딩하고, 저장해둔 글 조각들과 코사인 유사도를 비교해서, 가장 관련 있는 내용을 근거로 Gemini가 답해요. 다만 이번엔 TypeScript로 같은 로직을 다시 구현해서 바로 되게 했어요.
이제 이 확장 하나로 코드 리뷰랑 블로그 QnA를 둘 다 쓸 수 있어요
오늘의 삽질 1: 워크스페이스가 없대요
F5로 확장을 실행했더니 "열려있는 워크스페이스 폴더가 없어요"라는 에러가 떴어요. 확인 해보니 launch.json이 확장 코드가 어디 있는지는 알려주는데, 새로 뜨는 창에서 어떤 폴더를 열지는 지정을 안 해놨더라고요. 그래서 빈 창이 뜬 거였어요.
"args": [
"--extensionDevelopmentPath=${workspaceFolder}",
"${workspaceFolder}/../kodex-code-review-agent"
]두번째 인자를 추가해서, 디버그를 실행할 때마다 embeddings.json이 있는 폴더가 자동으로 열리게 고쳤어요.
오늘의 삽질 2: 서버가 혼잡하대요
Gemini API 오류 (503): This model is currently experiencing high demand...이건 제 코드 문제가 아니라 Gemini 서버가 일시적으로 과부하 상태여서 생긴 에러였어요. 무료 티어 모델 특성상 가끔 겪을 수 있는 일이라, 사람이 매번 재시도하는 대신 자동으로 처리하게 만들었어요. 429(과호출)·503(과부하) 에러가 뜨면 1초->2초->4초 간격으로 최대 3번 재시도하고, 그래도 안 되면 그때 에러를 보여줘요.
기능도 하나 더: 결과 저장 버튼
리뷰 결과랑 블로그 QnA 답변 패널 아래에 "💾 결과를 파일로 저장" 버튼을 추가했어요. 누르면 저장 위치를 고르는 창이 뜨고, 마크다운 파일로 저장돼요.
다음 계획
다음은 이 확장을 VS Code 마켓플레이스에 정식으로 배포하는 거예요. 퍼블리셔 계정, 아이콘, 라이선스는 이미 준비해뒀으니 실제 배포 과정만 남았어요.
아래는 질문 했을 때 결과 사진이에요!
