cciwon-code-review-cli

AI 기반 코드 리뷰 CLI 도구 (Qwen3-Coder-30B DPO 파인튜닝 모델 사용)

특징

• 🔒 폐쇄망 지원: IP 화이트리스트 기반 (192.168.10.152)
• 📁 폴더 전체 리뷰: 프로젝트 전체를 한 번에 분석
• 📄 파일 단위 리뷰: 개별 파일 심층 분석
• 🛡️ 보안 중심: SQL Injection, XSS 등 보안 취약점 탐지
• ⚡ 빠른 응답: vLLM 기반 고성능 추론

설치

1. 서버 설정

먼저 vLLM 서버를 시작해야 합니다:

# 필수 패키지 설치
pip install vllm fastapi uvicorn

# 서버 실행
cd /home/cwk317/codereivew
python vllm_server.py

서버가 192.168.10.152:8000에서 실행됩니다.

2. CLI 설치

cd code-review-cli
npm install
npm link  # 전역 설치

또는 로컬에서 직접 사용:

node bin/code-review.js <command>

사용법

서버 상태 확인

code-review health

출력 예시:

✅ 서버 정상 작동 중

서버 정보:
  - 상태: healthy
  - 모델 로드: 완료
  - 서버 URL: http://192.168.10.152:8000

폴더 전체 리뷰

code-review folder /path/to/project

옵션:

• -i, --include <patterns>: 포함할 파일 패턴 (기본: *.py,*.js,*.ts,*.java,*.cpp,*.go)
• -e, --exclude <patterns>: 제외할 패턴 (기본: node_modules,__pycache__,.git,*.pyc)
• -m, --max-files <number>: 최대 파일 수 (기본: 50)

예시:

# Python 프로젝트 리뷰
code-review folder ./my-python-project -i "*.py" -e "__pycache__,*.pyc,venv"

# JavaScript 프로젝트 리뷰
code-review folder ./my-js-project -i "*.js,*.jsx" -e "node_modules,dist,build"

# 모든 코드 파일 리뷰 (최대 100개)
code-review folder ./my-project -m 100

단일 파일 리뷰

code-review file /path/to/file.py

옵션:

• -l, --language <lang>: 프로그래밍 언어 (기본: python)
• -c, --checklist <path>: 체크리스트 파일 경로

예시:

# Python 파일 리뷰
code-review file ./app.py -l python

# TypeScript 파일 + 체크리스트
code-review file ./api.ts -l typescript -c ./checklist.txt

# Java 파일 리뷰
code-review file ./Main.java -l java

VSCode 통합

방법 1: Tasks 사용

.vscode/tasks.json 파일 생성:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Code Review: Current Folder",
      "type": "shell",
      "command": "code-review folder ${workspaceFolder}",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    },
    {
      "label": "Code Review: Current File",
      "type": "shell",
      "command": "code-review file ${file}",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    }
  ]
}

사용법:

1. Ctrl+Shift+P → Tasks: Run Task
2. Code Review: Current Folder 또는 Code Review: Current File 선택

방법 2: 터미널에서 직접 사용

VSCode 내장 터미널에서:

# 현재 워크스페이스 리뷰
code-review folder .

# 특정 파일 리뷰
code-review file src/main.py

환경 변수

서버 URL을 변경하려면 환경 변수 설정:

export CODE_REVIEW_SERVER=http://192.168.10.152:8000
code-review health

IP 화이트리스트

현재 허용된 IP:

• 192.168.10.152 (서버 IP)
• 127.0.0.1 (로컬 테스트용)

다른 IP에서 접근 시:

❌ 허용된 아이피가 아닙니다
현재 IP: 192.168.10.xxx
허용된 IP: 192.168.10.152, 127.0.0.1

IP 추가하려면 vllm_server.py의 ALLOWED_IPS 수정:

ALLOWED_IPS = ["192.168.10.152", "127.0.0.1", "192.168.10.100"]  # 새 IP 추가

트러블슈팅

서버 연결 실패

❌ 서버 연결 실패
서버 연결 실패: http://192.168.10.152:8000
서버가 실행 중인지 확인하세요.

해결:

1. vLLM 서버가 실행 중인지 확인: ps aux | grep vllm_server
2. 서버 로그 확인: tail -f /path/to/server.log
3. 방화벽 확인: sudo ufw status

IP 차단

❌ 허용된 아이피가 아닙니다

해결:

1. 현재 IP 확인: curl ifconfig.me
2. vllm_server.py의 ALLOWED_IPS에 추가
3. 서버 재시작

메모리 부족

vLLM 서버가 OOM으로 죽는 경우:

vllm_server.py 수정:

llm = LLM(
    model=OUTPUT_DIR,
    tensor_parallel_size=2,
    gpu_memory_utilization=0.7,  # 0.9 → 0.7로 감소
    max_model_len=1024,  # 2048 → 1024로 감소
)

성능

• 평균 응답 시간: ~5초 (폴더 리뷰, 10개 파일 기준)
• 동시 처리: vLLM 배치 처리로 여러 요청 동시 처리 가능
• GPU 사용량: 2x RTX 5090 (50-60GB)

라이선스

MIT