코드베이스 인덱싱

Kiro는 코드베이스와 문서를 자동으로 인덱싱하여 지능형 코드 제안, 탐색 및 컨텍스트 인식 지원을 제공합니다. 이 가이드에서는 인덱싱 작동 방식과 관리 방법을 설명합니다.

인덱싱이 발생하는 경우

자동 인덱싱

Kiro는 다음 시나리오에서 자동으로 인덱싱을 수행합니다:

1. 프로젝트 가져오기: Kiro에서 프로젝트를 처음 열면 작업 공간의 모든 파일을 자동으로 인덱싱하기 시작합니다
2. 파일 변경: 새 파일이 생성되거나 프로젝트에 추가되면 자동으로 인덱싱됩니다
3. 외부 변경: Kiro 외부에서 파일이 수정되면(예: git 작업을 통해) 다시 인덱싱됩니다

수동 인덱싱

필요할 때 명령 팔레트(macOS에서는 Cmd+Shift+P, Windows/Linux에서는 Ctrl+Shift+P)를 사용하여 수동으로 인덱싱을 트리거할 수 있습니다.

사용 가능한 인덱싱 명령

Kiro는 명령 팔레트를 통해 인덱싱을 관리하는 여러 명령을 제공합니다:

코드베이스 인덱싱

• Kiro: Codebase Force Re-Index: 전체 코드베이스를 강제로 완전히 다시 인덱싱합니다. 다음과 같은 경우에 사용합니다:

  • 인덱스가 손상되거나 불완전하다고 의심되는 경우
  • 프로젝트에 주요 구조적 변경이 있었던 경우
  • Kiro의 코드 제안이 오래된 것처럼 보이는 경우

  • Kiro: Rebuild codebase index: 코드베이스 인덱스를 처음부터 완전히 다시 빌드합니다. 이는 강제 재인덱싱보다 더 철저하며 다음과 같은 경우에 사용해야 합니다:

  • 인덱스가 심각하게 손상된 것으로 보이는 경우

  • 코드 탐색 또는 제안과 관련하여 지속적인 문제가 발생하는 경우

문서 인덱싱

• Kiro: Docs Index: 프로젝트의 문서 파일 인덱싱을 시작합니다
• Kiro: Docs Force Re-Index: 모든 문서 파일을 강제로 완전히 다시 인덱싱합니다

인덱싱 진행 상황 모니터링

Kiro Logs 패널을 통해 인덱싱 프로세스를 모니터링할 수 있습니다:

1. Kiro에서 Output 패널에 액세스합니다
2. 드롭다운 메뉴에서 "Kiro Logs"를 선택합니다
3. 실시간 인덱싱 진행 상황 및 상태 업데이트를 확인합니다

로그는 다음을 표시합니다:

• 인덱싱이 시작되고 완료되는 시기
• 찾고 처리된 파일 수
• 대형 코드베이스의 진행률 백분율
• 인덱싱 작업의 완료 시간

인덱싱된 콘텐츠

Kiro는 지능형 지원을 제공하기 위해 다양한 유형의 콘텐츠를 인덱싱합니다:

• 소스 코드: 작업 공간의 모든 프로그래밍 언어 파일
• 문서: Markdown, MDX 및 기타 문서 형식
• 구성: 프로젝트 구성 파일 및 매니페스트
• 종속성: 패키지 정의 및 종속성 정보

인덱싱된 데이터는 다음과 같은 기능을 활성화합니다:

• 지능형 코드 완성
• 파일 간 탐색
• 컨텍스트 인식 제안
• 문서 조회
• 코드 리팩토링 지원