Dropstone Docs

문제 해결

일반적인 문제 및 해결 방법.

Dropstone의 문제를 디버깅하려면 먼저 로그와 디스크에 저장된 로컬 데이터를 확인하세요.

로그

로그 파일은 다음 위치에 기록됩니다:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: WIN+R을 누르고 %USERPROFILE%\.local\share\dropstone\log를 붙여넣기

로그 파일은 타임스탬프로 이름이 지정되며(예: 2026-05-23T123456.log) 최근 10개의 로그 파일이 유지됩니다.

더 자세한 디버그 출력을 위해 --log-level 명령줄 옵션으로 로그 수준을 설정할 수 있습니다:

dropstone --log-level DEBUG

--print-logs는 또한 실시간으로 로그를 stderr로 스트리밍합니다:

dropstone --print-logs

저장소

Dropstone은 세션 데이터 및 기타 애플리케이션 데이터를 디스크의 다음 위치에 저장합니다:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: WIN+R을 누르고 %USERPROFILE%\.local\share\dropstone를 붙여넣기

이 디렉토리에는 다음이 포함됩니다:

  • auth.json: 인증 자격증명
  • log/: 애플리케이션 로그
  • project/: 세션 기록 같은 프로젝트별 데이터
    • 프로젝트가 Git 저장소 내에 있으면 ./<project-slug>/storage/에 저장됩니다
    • 그렇지 않으면 ./global/storage/에 저장됩니다

일반적인 문제

Dropstone이 시작되지 않음

  1. 로그에서 오류 메시지를 확인하세요.
  2. --print-logs로 실행하여 로그를 stderr로 스트리밍해 보세요.
  3. 최신 버전을 사용 중인지 확인하세요: dropstone update.

인증 문제

로그인 또는 토큰 검증이 실패하는 경우:

  1. dropstone을 다시 실행하고 브라우저 흐름을 통해 다시 로그인하세요.
  2. 헤드리스 환경에 있는 경우 dropstone.io/account에서 발급된 토큰으로 DROPSTONE_API_KEY를 설정하세요.
  3. 네트워크가 dropstone.io로의 아웃바운드 HTTPS를 허용하는지 확인하세요. 기업 프록시 뒤에 있는 경우 Network를 참조하세요.

모델을 찾을 수 없음

ModelNotFoundError가 표시되면 존재하지 않는 모델 ID를 참조하고 있을 가능성이 있습니다. 다음 중 하나를 사용하세요:

  • dropstone/dropstone-fast
  • dropstone/dropstone-pro
  • dropstone/dropstone-heavy

dropstone models를 실행하여 계정에서 사용 가능한 항목을 확인하세요.

초기화 오류

시작 시 InitError가 표시되면 저장된 자격증명이 유효하지 않거나 손상되었을 수 있습니다.

  1. 저장된 데이터를 지우세요:

    rm -rf ~/.local/share/dropstone

    Windows의 경우: WIN+R을 누르고 %USERPROFILE%\.local\share\dropstone을 삭제하세요.

  2. dropstone을 다시 실행하고 다시 로그인하세요.

API 호출 오류

세션 중에 API 호출 오류가 표시되면 디스크의 캐시가 오래되었을 수 있습니다.

  1. 캐시를 지우세요:

    rm -rf ~/.cache/dropstone

    Windows의 경우: WIN+R을 누르고 %USERPROFILE%\.cache\dropstone을 삭제하세요.

  2. Dropstone을 다시 시작하세요.

Linux에서 복사/붙여넣기가 작동하지 않음

Linux 사용자는 복사/붙여넣기가 작동하려면 다음 클립보드 유틸리티 중 하나를 설치해야 합니다:

X11

apt install -y xclip
# or
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

apt install -y xvfb
# then
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

Dropstone은 Wayland에서 wl-clipboard를 선호하고 X11에서 xclip으로 폴백한 후 xsel로 폴백합니다.

Windows: 일반적인 성능 문제

기본 Windows에서 느린 성능, 파일 액세스 문제 또는 터미널 결함이 발생하는 경우 WSL로 전환하세요. WSL은 Dropstone을 기본 파일시스템 속도와 완전한 터미널 지원으로 실행하는 Linux 환경을 제공합니다.

도움말 받기

Ctrl+I