IBM Bob
문제 해결

Bob Shell 문제 해결

Bob Shell 사용 중 발생할 수 있는 문제에 대한 해결책을 찾아보세요.

인증

인증서 오류

오류: Unable to verify certificate

원인: SSL/TLS 트래픽을 가로채고 검사하는 방화벽이 있는 기업 네트워크에 있습니다. 이를 위해서는 Node.js가 신뢰하는 사용자 지정 루트 CA 인증서가 필요합니다.

해결 방법: NODE_EXTRA_CA_CERTS 환경 변수를 기업 루트 CA 인증서 파일의 절대 경로로 설정하세요:

 
export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt

IDE 통합

연결 실패

오류: Bob Shell이 IDE에 연결할 수 없습니다.

원인: Bob Shell Companion 확장 프로그램이 설치되지 않았거나 실행 중이지 않거나, Bob Shell이 워크스페이스 디렉토리 외부에서 실행 중일 수 있습니다.

해결 방법:
  1. IDE에 Bob Shell Companion 확장 프로그램을 설치하세요.
    2.
  2. 터미널에서 워크스페이스 디렉토리로 이동하세요.
    3.
  3. 워크스페이스 디렉토리에서 Bob Shell을 시작하세요.
    4.
  4. Bob Shell에서 /ide enable을 실행하세요.
    5.

개발 컨테이너에서 연결 실패

오류: 개발 컨테이너 내에서 실행할 때 Bob Shell이 IDE에 연결할 수 없습니다.

원인: Bob Shell 포트가 개발 컨테이너에서 호스트 머신으로 포워딩되지 않습니다.

해결 방법:
  1. 개발 컨테이너 내부의 터미널에서 Bob Shell 포트를 확인하세요: 
    echo $BOB_SHELL_CLI_IDE_SERVER_PORT
    출력 예시: 42991
    2.
  2. IDE에서 명령 팔레트를 열고 Forward a Port를 선택하세요.
    3.
  3. 1단계에서 확인한 포트를 추가하세요 (예: 42991).
    4.
  4. Bob Shell을 시작하세요: 
    bob
    5.
  5. IDE 통합을 활성화하세요: 
    /ide enable
    또는 연결 상태를 확인하세요: 
    /ide status
    6.

IDE Companion 확장 프로그램 연결 실패

오류: 🔴 Disconnected: Failed to connect to IDE companion extension

원인: Bob Shell Companion 확장 프로그램이 IDE에 설치되지 않았거나, 활성화되지 않았거나, 실행 중이지 않습니다.

해결 방법:
  1. IDE에 Bob Shell Companion 확장 프로그램이 설치되고 활성화되었는지 확인하세요.
    2.
  2. IDE에서 새 터미널을 여세요.
    3.
  3. Bob Shell에서 /ide enable을 실행하세요.
    4.

예기치 않은 연결 끊김

오류: 🔴 Disconnected: IDE connection error. The connection was lost unexpectedly

원인: 네트워크 문제 또는 IDE 재시작으로 인해 IDE 연결이 중단되었습니다.

해결 방법:
  1. /ide enable을 실행하여 재연결하세요.
    2.
  2. 문제가 지속되면 IDE를 재시작하세요.
    3.

디렉토리 불일치

오류: 🔴 Disconnected: Directory mismatch

원인: Bob Shell이 IDE에서 열려 있는 워크스페이스와 다른 디렉토리에서 실행 중입니다.

해결 방법:
  1. IDE에서 열려 있는 것과 동일한 디렉토리로 이동하세요.
    2.
  2. 해당 디렉토리에서 Bob Shell을 재시작하세요.
    3.

워크스페이스 폴더가 열려 있지 않음

오류: 🔴 Disconnected: To use this feature, please open a workspace folder

원인: IDE에서 폴더나 워크스페이스가 열려 있지 않습니다.

해결 방법:
  1. IDE에서 폴더 또는 워크스페이스를 여세요.
    2.
  2. Bob Shell을 재시작하세요.
    3.

IDE 통합이 지원되지 않음

오류: IDE integration is not supported in your current environment

원인: Bob Shell이 지원되는 IDE의 통합 터미널에서 실행 중이지 않습니다.

해결 방법: 지원되는 IDE의 통합 터미널에서 Bob Shell을 실행하세요.

구성 문제

.bobignore가 작동하지 않는 경우

오류: Bob Shell이 접근하기를 원하는 파일을 무시하거나, 무시하기를 원하는 파일에 접근합니다.

원인: .bobignore 파일에 충돌하는 패턴, 잘못된 패턴 순서, 또는 파일이 잘못된 위치에 있을 수 있습니다. 변경 사항이 아직 적용되지 않았을 수도 있습니다.

해결 방법:
  1. .bobignore 파일에서 충돌하는 패턴을 확인하세요.
    2.
  2. 더 구체적인 패턴 (!를 사용한 부정 등)이 일반 패턴 뒤에 오는지 확인하세요.
    3.
  3. .bobignore 변경 후 Bob Shell 세션을 재시작하세요.
    4.
  4. 상대 경로가 예상대로 작동하지 않으면 절대 경로를 사용하세요.
    5.
  5. .bobignore 파일이 프로젝트 루트 디렉토리에 있는지 확인하세요.
    6.

설정이 적용되지 않는 경우

오류: Bob Shell 설정 변경 사항이 적용되지 않습니다.

원인: 설정 파일이 잘못된 위치에 있거나, JSON 문법이 유효하지 않거나, 더 높은 우선순위의 구성 소스에 의해 재정의될 수 있습니다. 변경 사항이 아직 적용되지 않았을 수도 있습니다.

해결 방법:
  1. 설정 파일 위치를 확인하세요:
    • 프로젝트 설정: 프로젝트 디렉토리의 .bob/settings.json
    • 사용자 설정: 홈 디렉토리의 ~/.bob/settings.json
    2.
  2. JSON 문법이 유효한지 확인하세요 (JSON 검증기 사용).
    3.
  3. 구성 우선순위 순서를 기억하세요:
    • 명령줄 인수 (가장 높은 우선순위)
    • 환경 변수
    • 프로젝트 설정
    • 사용자 설정
    • 시스템 기본값 (가장 낮은 우선순위)
    4.
  4. 설정 파일을 변경한 후 Bob Shell을 재시작하세요.
    5.

사용자 지정 지시사항이 로드되지 않는 경우

오류: 사용자 지정 지시사항이 Bob Shell 세션에 적용되지 않습니다.

원인: 사용자 지정 지시사항 파일이 잘못된 위치에 있거나, 올바르지 않은 파일 확장자를 가지고 있거나, 현재 컨텍스트에 로드되지 않을 수 있습니다.

해결 방법:
  1. 파일이 올바른 위치에 있는지 확인하세요:
    • 워크스페이스 전체: 프로젝트 루트의 .bob/rules/
    • 모드별: 프로젝트 루트의 .bob/rules-{modeSlug}/
    2.
  2. 파일에 올바른 확장자 (.md, .txt, 또는 .xml)가 있는지 확인하세요.
    3.
  3. /memory refresh를 사용하여 모든 컨텍스트 파일을 다시 로드하세요.
    4.
  4. /memory show를 사용하여 현재 컨텍스트를 확인하세요.
    5.

명령 실행 문제

명령을 찾을 수 없는 경우

오류: command not found: bob

원인: Bob Shell이 올바르게 설치되지 않았거나 시스템의 PATH에 없습니다.

해결 방법:
  1. Bob Shell이 설치되어 있는지 확인하세요: 
    which bob
    2.
  2. 찾을 수 없으면 설치 지침을 사용하여 Bob Shell을 재설치하세요.
    3.
  3. 셸의 PATH에 Bob Shell 설치 디렉토리가 포함되어 있는지 확인하세요.
    4.

셸 모드가 작동하지 않는 경우

오류: 셸 모드 (! 명령)가 명령을 실행하지 않습니다.

원인: 빈 프롬프트에서 !를 입력하지 않았거나, 필요한 권한이 없거나, 명령 자체가 유효하지 않을 수 있습니다.

해결 방법:
  1. 빈 프롬프트에서 !를 입력하고 있는지 확인하세요.
    2.
  2. 셸 명령을 실행하는 데 필요한 권한이 있는지 확인하세요.
    3.
  3. 먼저 터미널에서 직접 명령을 실행하여 작동하는지 확인하세요.
    4.

성능 문제

응답 속도가 느린 경우

오류: Bob Shell이 요청에 느리게 응답합니다.

원인: 네트워크 연결 문제, 너무 많은 파일이 컨텍스트로 로드됨, 또는 컨텍스트에 대용량 바이너리 파일이 포함됨.

해결 방법:
  1. 네트워크 연결을 확인하세요.
    2.
  2. .bobignore를 사용하여 컨텍스트의 파일 수를 줄이세요.
    3.
  3. node_modules/와 같은 대용량 바이너리 파일이나 디렉토리를 포함하지 마세요.
    4.
  4. 모든 파일을 로드하는 대신 @를 사용하여 더 구체적인 파일 참조를 사용하는 것을 고려하세요.
    5.

메모리 사용량이 높은 경우

오류: Bob Shell이 과도한 메모리를 소비합니다.

원인: 너무 많은 파일이 컨텍스트로 로드됨, 제외되지 않은 대용량 디렉토리, 또는 메모리 파일의 순환 import.

해결 방법:
  1. 컨텍스트로 로드되는 파일 수를 제한하세요.
    2.
  2. .bobignore를 사용하여 대용량 디렉토리를 제외하세요.
    3.
  3. 긴 세션 중에 Bob Shell을 주기적으로 재시작하세요.
    4.
  4. 메모리 파일의 순환 import를 확인하세요.
    5.

Bob Shell 디버깅 팁

디버그 로깅 활성화

세션의 로그 상세도를 높이려면 --log-level 플래그 또는 BOB_LOG_LEVEL 환경 변수를 사용하세요:

 
bob run --log-level debug "Explain @app.js"
BOB_LOG_LEVEL=debug bob chat

설정 파일에서 영구적인 로그 레벨을 설정할 수도 있습니다:

 
{
  "logging": {
    "logLevel": "debug"
  }
}

Bob Shell 버전 확인

Bob Shell 버전을 확인하려면 다음 명령어를 실행하세요:

대화형 세션:

 
/about

비대화형 세션:

 
bob --version

로그 파일

Bob Shell은 ~/.bob/logs/shell/에 로그 파일을 작성합니다. 로그 파일은 자동으로 순환됩니다:
  • 최대 10개의 로그 파일이 보존됩니다
    •
  • 각 파일은 5 MB로 제한됩니다
    •

세션의 현재 로그 파일을 찾으려면:

 
ls -lt ~/.bob/logs/shell/ | head

문제를 신고할 때 관련 로그 발췌문을 공유하세요.

워크스페이스 루트 해석

Bob Shell은 현재 작업 디렉토리에서 위로 올라가면서 .git 디렉토리 또는 .bob 디렉토리를 찾을 때까지 탐색하여 워크스페이스 루트를 결정합니다. 첫 번째 매칭이 워크스페이스 루트가 됩니다.

.git 또는 .bob 디렉토리가 없으면 Bob Shell은 현재 작업 디렉토리를 워크스페이스 루트로 사용합니다.

이 주제는 어떤가요?

신뢰 폴더

신뢰 폴더 보안을 사용하여 Bob Shell의 전체 기능을 사용할 수 있는 프로젝트를 제어하세요.

프록시 설정 구성

네트워크 제한이 있는 엔터프라이즈 환경에서 Bob Shell의 프록시 설정 구성

이 페이지에서

인증인증서 오류IDE 통합연결 실패개발 컨테이너에서 연결 실패IDE Companion 확장 프로그램 연결 실패예기치 않은 연결 끊김디렉토리 불일치워크스페이스 폴더가 열려 있지 않음IDE 통합이 지원되지 않음구성 문제.bobignore가 작동하지 않는 경우설정이 적용되지 않는 경우사용자 지정 지시사항이 로드되지 않는 경우명령 실행 문제명령을 찾을 수 없는 경우셸 모드가 작동하지 않는 경우성능 문제응답 속도가 느린 경우메모리 사용량이 높은 경우Bob Shell 디버깅 팁디버그 로깅 활성화Bob Shell 버전 확인로그 파일워크스페이스 루트 해석