프로젝트에 `.bobignore` 파일을 만들어 Bob이 액세스할 수 있는 파일을 제어합니다.

`.bobignore`란 무엇인가요?

목적: 민감한 정보를 보호하고, 빌드 아티팩트나 대용량 자산에 대한 실수로 인한 변경을 방지하며, 일반적으로 워크스페이스 내에서 Bob의 작동 범위를 정의합니다.

사용법: 워크스페이스 디렉토리에 .bobignore라는 파일을 만듭니다. 이 파일에 패턴을 나열하여 Bob에게 무시할 파일과 디렉토리를 알려줍니다.

Bob은 .bobignore 파일을 적극적으로 모니터링합니다. 변경한 내용은 자동으로 다시 로드되므로 Bob은 항상 최신 규칙을 사용합니다. .bobignore 파일 자체는 항상 암시적으로 무시되므로 Bob이 자체 액세스 규칙을 수정할 수 없습니다.

패턴 구문

.bobignore의 구문은 .gitignore와 동일합니다. 다음은 일반적인 예입니다:

예제	설명
`node_modules/`	전체 `node_modules` 디렉토리를 무시합니다
`*.log`	`.log`로 끝나는 모든 파일을 무시합니다
`config/secrets.json`	특정 파일을 무시합니다
`!important.log`	예외; `.log`와 같은 더 넓은 패턴이 있더라도 Bob은 이 특정 파일을 무시하지 않습니다*
`build/`	`build` 디렉토리를 무시합니다
`docs/*/.md`	`docs` 디렉토리 및 하위 디렉토리의 모든 Markdown 파일을 무시합니다

구문에 대한 자세한 내용은 .gitignore에 대한 공식 Git 문서를 참조하세요.

Bob 도구가 `.bobignore`와 상호 작용하는 방법

.bobignore 규칙은 다양한 Bob 도구에 걸쳐 적용됩니다:

엄격한 적용(읽기 및 쓰기)

이러한 도구는 각 파일 작업 전에 .bobignore를 직접 확인합니다. 파일이 무시되면 작업이 차단됩니다:

read_file: 무시된 파일을 읽지 않습니다.

write_file: 무시된 파일에 쓰거나 새로운 무시된 파일을 만들지 않습니다.

apply_diff: 무시된 파일에 diff를 적용하지 않습니다.

GetSymbolsOverview: 무시된 파일을 코드 기호로 구문 분석하지 않습니다.

파일 편집 도구(잠재적 쓰기 우회)

insert_content 및 search_and_replace 도구는 변경 사항을 관리하기 위해 내부 구성 요소를 사용합니다. 중요: 현재 이러한 도구에서 수행하는 최종 쓰기 작업은 .bobignore 규칙을 우회할 수 있습니다. 초기 읽기 시도가 차단될 수 있지만 저장 작업 자체에는 명시적 확인이 없습니다.

파일 검색 및 나열

list_files 도구: Bob이 파일을 나열할 때 무시된 파일은 일반적으로 생략되거나 🔒 기호로 표시됩니다(아래 "사용자 경험" 참조).

환경 세부 정보: Bob에 제공되는 워크스페이스에 대한 정보(예: 열린 탭 및 프로젝트 구조)는 무시된 항목을 제외하거나 표시하도록 필터링됩니다.

명령 실행

execute_command 도구: 이 도구는 명령(미리 정의된 목록에서 cat 또는 grep와 같은)이 무시된 파일을 대상으로 하는지 확인합니다. 그렇다면 명령 실행이 차단됩니다.

중요한 제한 사항 및 범위

워크스페이스 중심: .bobignore 규칙은 현재 Bob 워크스페이스 루트 내의 파일 및 디렉토리에만 적용됩니다. 이 범위 밖의 파일은 영향을 받지 않습니다.

execute_command 특이성: execute_command에 대한 보호는 미리 정의된 파일 읽기 명령 목록으로 제한됩니다. 사용자 정의 스크립트나 특이한 유틸리티는 포착되지 않을 수 있습니다.

insert_content 및 search_and_replace를 통한 쓰기 작업: 언급했듯이 이러한 도구는 저장 메커니즘의 현재 제한으로 인해 무시된 파일에 쓸 수 있습니다.

완전한 샌드박스 아님: .bobignore는 도구를 통해 Bob의 파일 액세스를 제어하는 강력한 도구이지만 시스템 수준 샌드박스를 만들지는 않습니다.

사용자 경험 및 알림

시각적 표시(🔒): 파일 목록에서 .bobignore에 의해 무시된 파일은 showbobignoredFiles 설정(기본값은 true)에 따라 잠금 기호(🔒)로 표시될 수 있습니다.

오류 메시지: 도구 작업이 차단되면 Bob은 오류를 받습니다:

"[file_path]에 대한 액세스가 .bobignore 파일 설정에 의해 차단되었습니다. 이 파일을 사용하지 않고 작업을 계속하거나 사용자에게 .bobignore 파일을 업데이트하도록 요청해야 합니다."

채팅 알림: .bobignore로 인해 작업이 차단되면 일반적으로 Bob 채팅 인터페이스에 알림이 표시됩니다.

이 가이드는 .bobignore 기능, 기능 및 현재 제한 사항을 이해하여 코드베이스와 Bob의 상호 작용을 효과적으로 관리하는 데 도움이 됩니다.

파일 무시