ponshu-room-lite/debug_steps.md

デバッグ手順

エラーが発生した場合

1. フィルタリングされたログを取得

# Gemini APIのエラーのみ表示
flutter logs | findstr /i "gemini api error"

# または、すべてのエラーを表示
flutter logs | findstr /i "error exception"

2. 詳細ログを取得

# Flutter Inspectorを有効化してログを詳細表示
flutter run --verbose > debug_log.txt 2>&1

3. APIキーの確認

# secrets.local.dart の内容を確認（APIキーは表示されません）
type lib\secrets.local.dart | findstr /i "geminiApiKey"

4. キャッシュのクリア

# Hiveキャッシュをクリア（アプリ内の開発者メニューから）
# または、アプリをアンインストールして再インストール
flutter clean
flutter pub get
flutter run

よくあるエラーと解決策

Error 1: "API key not valid"

原因: APIキーが無効、または設定されていない 解決策:

1. Google AI Studioで新しいキーを発行
2. lib/secrets.local.dart に正しく設定されているか確認
3. flutter run を再実行

Error 2: "Rate limit exceeded"

原因: 1日の制限（20回）に達した 解決策:

1. 開発者メニューでキャッシュサイズを確認
2. 同じ画像を再度選択（キャッシュヒットするはず）
3. 明日まで待つ、またはOllama統合を実装

Error 3: "Empty response from Gemini"

原因: Gemini APIが応答を返さなかった 解決策:

1. ネットワーク接続を確認
2. 画像サイズを確認（圧縮後100KB前後が推奨）
3. 再試行ボタンをタップ

Error 4: "Lost connection to device"

原因: USBケーブルの物理的な切断、またはデバイスのスリープ 解決策:

1. USBケーブルを再接続
2. デバイスのスリープ設定を「なし」に変更
3. flutter devices でデバイスが認識されているか確認
4. flutter run を再実行

問題が解決しない場合

以下の情報を提供してください：

1. flutter doctor -v の出力
2. flutter logs の最後の100行
3. エラーメッセージのスクリーンショット
4. 実行した操作の詳細（どの画面で、何をした時にエラーが出たか）