Dropstone CLI

トラブルシューティング

よくある問題とその解決方法。

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。

macOS で何も出力されずに即座に終了する場合は、別の障害です — macOS で起動時に強制終了される を参照してください。

macOS で起動時に強制終了される

Apple Silicon では、Dropstone 1.0.50 は何も出力する前に macOS によって強制終了されたため、すべてのコマンドが次のようになりました：

dropstone --version
# zsh: killed     dropstone --version

読み取るログも検索するエラーもありません。プロセスは起動前に停止されるため、--print-logs や dropstone upgrade も同様に強制終了されます。macOS は実行前にバイナリの署名を検証しますが、そのビルドに刻印された署名が一致しませんでした。macOS 26 までは許容されていましたが、macOS 27 では許容されません。Windows と Linux は影響を受けませんでした。

再インストール前に確認するには：

codesign --verify --verbose=4 "$(readlink -f "$(which dropstone)")"
# /opt/homebrew/bin/dropstone: invalid signature (code or signature have been modified)

その後、バイナリを置き換えます。Homebrew とインストーラーの両方が、インストール済みのコピーを実行せずに動作します：

# Homebrew
brew update && brew upgrade dropstone

# ワンラインインストーラー
curl -fsSL https://dropstone.io/install.sh | bash

再インストールせずに既存のコピーをブロック解除するには：

codesign --force --sign - "$(readlink -f "$(which dropstone)")"

1.0.51 以降は macOS が受け入れる方法で署名されており、すべてのリリースは公開前にその署名を検証します。

認証の問題

サインインまたはトークン検証が失敗する場合：

  1. dropstone を再実行し、ブラウザフローで再度サインインします。
  2. ヘッドレス環境の場合は、dropstone.io/account で発行されたトークンから DROPSTONE_API_KEY を設定します。
  3. ネットワークが dropstone.io への送信 HTTPS を許可していることを確認します。企業プロキシの背後にいる場合は、ネットワーク を参照してください。

モデルが見つからない

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