メインコンテンツまでスキップ

トラブルシューティング

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

プロバイダーの問題​

"Error: 401 Unauthorized"​

  • 原因: API キーが無効です。
  • 対処法: Settings > Providers に移動します。API キーを再入力してください。余分なスペースや改行が入っていないことを確認してください。

"Error: 403 Forbidden"​

  • 原因: お使いの API キーには、リクエストされたモデルへのアクセス権がありません。
  • 対処法:
    • OpenAI の場合: 一部のモデルは有料プランが必要です。platform.openai.com でアクセス権を確認してください。
    • Anthropic の場合: リクエストしている Claude モデルへのアクセス権がアカウントにあることを確認してください。

"Error: 429 Too Many Requests"​

  • 原因: レート制限に達したか、credit を使い切っています。
  • 対処法:
    • 数分待ってから再試行してください（レート制限の場合）。
    • 請求状況を確認し、プロバイダーの Web サイトで credit を追加してください。
    • 一時的に別のプロバイダーに切り替えることを検討してください。

"Error: 500 Internal Server Error"​

  • 原因: プロバイダーのサーバーで問題が発生しています。
  • 対処法: 数分待ってから再試行してください。プロバイダーのステータスページを確認してください。

"Connection Refused" (Ollama)​

  • 原因: Rephlo がローカルの AI サーバーと通信できません。
  • 対処法:
    1. ターミナルを開き、ollama serve を実行します。
    2. 正常に動作しているか確認します。ブラウザで http://localhost:11434 にアクセスしてください。
    3. ポート 11434 を別のアプリケーションが使用していないか確認してください。

"Model Not Found" (Ollama)​

  • 原因: リクエストされたモデルがダウンロードされていません。
  • 対処法: ターミナルで ollama pull [model-name] を実行してください（例: ollama pull llama3）。

UI の問題​

"Hotkeys are not working"​

  • 原因（Windows/Linux）: 別のアプリケーション（PowerToys やゲームなど）がそのホットキーを奪っている可能性があります。
  • 対処法: Settings > Hotkeys に移動し、トリガーを別の組み合わせに変更してください（例: Ctrl + Shift + Alt + Z）。

macOS をお使いの方へ: macOS でのホットキーのトラブルシューティングについては、下記のmacOS 固有の問題をご覧ください。

"Tray Icon is Missing"​

  • 原因: Windows がシステムトレイの「オーバーフロー」メニュー内にアイコンを隠している可能性があります。
  • 対処法: 時計の近くにある ^ 矢印をクリックします。Rephlo のアイコンをメインのタスクバー領域までドラッグしてください。

機能の問題​

"Vision/Screenshot not working"​

  • 原因（Windows）: Windows のプライバシー設定で画面録画の権限が拒否されている可能性があります。
  • 対処法（Windows）: Rephlo を管理者として実行するか、Windows のプライバシー設定 > カメラ / 画面キャプチャを確認してください。
  • 原因（macOS）: Rephlo には Screen Recording の権限が必要です。
  • 対処法（macOS）: 詳しい手順については、下記のmacOS 固有の問題をご覧ください。

"Space is not answering questions"​

  • 原因: Space が空であるか、データの取り込み（ingestion）に失敗している可能性があります。
  • 対処法: Space の詳細を確認してください。ファイルが一覧に表示され、ステータスが「Ready」になっていることを確認します。Advanced Settings でキャッシュのクリアを試してください。

"Variable not found in Space"​

  • 原因: {{filename}} 変数を使用していますが、そのファイルがアクティブな Space に含まれていません。
  • 対処法:
    1. 参照しているファイルが Space に含まれているか確認します。
    2. 変数名がファイル名（snake_case に変換したもの、例: "Style Guide.pdf" -> {{style_guide_pdf}}）と一致しているか確認します。
    3. 正しい Space がアクティブになっていることを確認します。

macOS 固有の問題​

"Hotkeys are not working" (macOS)​

  • 原因: Rephlo がグローバルなキーボードショートカットを検出するには、Accessibility の権限が必要です。
  • 対処法:
    1. System Settings > Privacy & Security > Accessibility を開きます。
    2. 一覧から Rephlo を見つけて ON に切り替えます。
    3. Rephlo が一覧にない場合は、アプリを終了して再起動してください。
    4. 権限を付与した後、Rephlo を再起動してください。

重要: グローバルホットキーは、署名済みの .app バンドルとして Rephlo を実行している場合にのみ動作します。開発者としてターミナルから dotnet run を実行している場合、ホットキーが機能しないことがあります。.app バンドルのビルドと実行方法については、macOS セットアップチュートリアルをご覧ください。

"Screenshot / Vision not working" (macOS)​

  • 原因: Rephlo が画面の内容をキャプチャするには、Screen Recording の権限が必要です。
  • 対処法:
    1. System Settings > Privacy & Security > Screen Recording を開きます。
    2. 一覧から Rephlo を見つけて ON に切り替えます。
    3. Rephlo を再起動してください。

"Permission dialog keeps appearing"​

  • 原因: Rephlo が安定したコード署名なしで実行されていました。リビルドするたびにバイナリのハッシュ値が変わるため、macOS がこれを新しいアプリとして扱い、権限がリセットされてしまいます。
  • 対処法: 公式配布元から入手した、署名済みのリリースビルドの Rephlo を使用してください。署名済みアプリに一度権限を付与すれば、以降のアップデートをまたいでその権限が保持されます。

"Overlay doesn't appear even after granting permissions"​

  • 対処法:
    1. Rephlo を完全に終了します（トレイアイコンを右クリック > Exit）。
    2. .app バンドルから再起動します。
    3. Accessibility と Screen Recording の両方の権限が付与されていることを確認します。
    4. Settings > Hotkeys の Test Overlay ボタンを試してください。

パフォーマンスの問題​

"Responses are very slow"​

  • 原因: さまざまな要因が応答速度の低下を引き起こす可能性があります。
  • 対処法:
    • Space のコンテキストが大きい場合: Space の圧縮（compact）を検討してください。
    • プロバイダーの応答が遅い場合: GPT-5.4 Mini や Gemini 3.5 Flash のような高速なモデルに切り替えると、より速い応答が得られます。
    • ローカルモデル（Ollama）の場合: GPU が使用されているか確認してください。Ollama のログを確認してください。

"App feels sluggish on startup"​

  • 原因: 大きな Space や多数のコマンドを読み込んでいます。
  • 対処法: 使っていないコマンドをアーカイブしてください。不要になった古い Space を削除してください。

Chat の問題​

"Chat history is missing"​

  • 原因: 会話はローカルに保存されており、消去された可能性があります。
  • 対処法: 履歴保持設定については Settings > Privacy を確認してください。「Immediate」に設定されている場合、履歴は保持されません。

"Chat keeps forgetting context"​

  • 原因: プロバイダーのコンテキストウィンドウの上限を超えています。
  • 対処法: 新しい会話を開始するか、より大きなコンテキストウィンドウを持つプロバイダーを使用してください。具体的なコンテキストウィンドウのサイズについては、各プロバイダーのドキュメントをご確認ください。

変数と Template の問題​

"Variable not found" or "Invalid variable"​

  • 原因: 変数名が、有効なシステム変数、またはお使いの Space 内のファイルのいずれとも一致していません。
  • 対処法:
    • 正しい構文を使用してください: {{input_content}}、{{space_data_all}}、または {{filename}}。
    • ファイル変数の場合: ファイル名を snake_case に変換してください（例: "Style Guide.pdf" -> {{style_guide_pdf}}）。
    • ファイルがアクティブな Space に存在することを確認してください。
    • 誤字がないか確認してください。変数名は大文字・小文字を区別しませんが、正しいつづりである必要があります。

"Space variables ignored in Standalone mode"​

  • 原因: Standalone コマンドは Space のデータを自動的に挿入しません。
  • 説明: Standalone モードでは、手動で完全に制御できます。{{space_data_all}} のような変数は自動的には置き換えられません。
  • 対処法: Space データを自動的に挿入するには Combination モード に切り替えるか、Space データを手動でプロンプトに貼り付けてください。

Space の問題​

"Space full" or "Token budget exceeded"​

  • 原因: お使いの Space が、設定されたトークン上限を超えています。
  • 対処法:
    1. Space のデータビューを開き、現在の使用量を確認します。
    2. Space から重要度の低いファイルを削除するか、トークン予算を増やしてください（最大 1,000,000 トークン）。これらはいずれも、保存済み予算を超えている Space に対して直接効果があります。
    3. データモードを 🗜️ Compact に切り替えて、全文の代わりに AI が生成した要約を保存します。これにより Space のカウント対象トークン数が減ります（credit のコストは確認してください）。続いて、次のいずれかの圧縮レベルを選択します。
      • Conservative: 最小限の要約（詳細を保持）。
      • Balanced: 中程度の要約（デフォルト、推奨）。
      • Aggressive: 大幅な要約（非常に大きな Space に最適）。
      • 注: 非常に大きな Space（≈128,000 トークン以上）では、仕様上 Compact は無効になります — 代わりにファイルを削除するか、予算を増やしてください。
    4. 注: 🔍 Smart Search は、関連する部分のみを送信することで各リクエストを小さく抑えますが、Space の予算にはカウントされる元の全文がそのまま計上されます。つまり、これはリクエストごとのコストを抑える機能であり、保存済み上限を超えている Space の問題を解決するものではありません。

"Space ingestion failed" (PDF/document error)​

  • 原因: ファイルを処理できませんでした。破損している、パスワードで保護されている、またはサポートされていない形式である可能性があります。
  • 対処法:
    • PDF がパスワードで保護されていないことを確認してください。
    • 元のアプリケーションからドキュメントを再エクスポートしてみてください。
    • スキャンした PDF の場合: Rephlo はテキストのみを抽出します — PDF 内の画像は読み取られません。
    • まず別のアプリケーションで開いてみて、ファイルが破損していないことを確認してください。

画像生成に関する問題​

"This prompt was blocked by our content policy"​

  • 原因: 画像生成のプロンプトがコンテンツモデレーションによってフラグされ、生成が実行される前に拒否されました。
  • 対処法: 許可されていない内容を取り除くようプロンプトを書き直し、再試行してください。許可されていない内容については、コンテンツポリシー ページを参照してください。

"Content moderation is temporarily unavailable"​

  • 原因: コンテンツモデレーションサービスが一時的にダウンしており（一時的な障害）、プロンプトを確認できませんでした。
  • 対処法: しばらく待ってから再試行してください。

サポートを受ける​

有害または不適切な AI の出力を報告するにはどうすればよいですか？​

  • 対処法:
    • サインイン済みの場合: サイドバー下部のアバターをクリック > Help > Report inappropriate content。
    • いつでも: Settings > About > Contact & Support > Report inappropriate content を開きます。
    • この操作を行うと、報告カテゴリがあらかじめ選択された状態で、ブラウザに rephlo.app/contact が開きます。