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
# または
apt install -y xsel

Wayland

apt install -y wl-clipboard

ヘッドレス

apt install -y xvfb
# その後
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