トラブルシューティング

アプリがインストールされない、または開かない

Windows

SmartScreen がインストーラーをブロックする場合は、詳細 → とにかく実行 を選択します。デスクトップ ビルドはコード署名されているため、通常は表示されません。

アプリがインストールされても起動しない場合は、直接インストーラーではなく、Microsoft Store からインストールしてみてください。ストア ビルドは独自の依存関係を処理します。

macOS

macOS がアプリを開くことを拒否した場合は、システム設定 → プライバシーとセキュリティ を開いて許可し、再度起動します。

9xchat を、マウントされたディスク イメージから実行するのではなく、アプリケーション にドラッグしたことを確認してください。

Linux

ダウンロードしたファイルが実行可能としてマークされていることを確認します。そうでない場合は、実行可能ビットを設定して、再度実行します。

携帯

Google PlayまたはApp Storeを通じてインストールすると、アップデートが自動的に届きます。アプリが起動しない場合は、アプリを更新してからデバイスを再起動してください。

応答が失敗するか途中で停止する

これらを順番に実行してください。

1. 接続を確認してください。 クラウド モデルにはインターネット アクセスが必要です。ローカルモデルはそうする そうではありません — クラウド リクエストが失敗してもローカル リクエストは機能する場合、問題は 9xchat ではなく、ネットワークまたはプロバイダーにあります。

2. クレジット残高を確認してください。 9xchat クレジットを使用していて、そのクレジットに なくなるとリクエストが停止します。追加するか、独自の API キーに切り替えてください。

3. API キーを確認してください。 自分のキーを持ち込んだ場合は、それがまだ残っていることを確認してください。 有効であり、そのプロバイダーに割り当てが残っています。

4. 別のモデルを試してください。 あるモデルが失敗し、別のモデルが成功すると、問題が発生します。 その特定のモデルまたはプロバイダーに対応しています。

モデルが見つからないか、ロードされません

• クラウド モデルには、クレジットまたはそのモデル用に構成された API キーが必要です プロバイダー。 ライブラリ → モデルでは、キーを追加するまでプロバイダーは非アクティブ としてマークされます。このラベルは、ルートがないものを確認する最も速い方法です。

• ローカル モデル では、9xchat が到達する前にローカル ランナーを開始する必要があります。 まずそれを開始してから、モデルリストを再度開きます。

API キーが拒否されました

障害はプロバイダーにあるため、修正もそこにあります。

1. 先頭または末尾にスペースを入れずに、キーを再度貼り付けます。
2. キーが追加したプロバイダーに属していることを確認します。
3. キーがまだ存在し、取り消されたりローテーションされたりしていないことを確認してください。
4. 請求が設定されていることと、そのプロバイダーとの割り当てが残っていることを確認します。 残高のない有効なキーは、不正なキーと同じように失敗します。
5. 選択したモデルがアカウントで使用を許可されているモデルであることを確認してください。一部 モデルにはプロバイダーとの別の層が必要です。

キーはマシン上に暗号化されて保存されます。どこでもキーが機能しなくなった場合は、9xchat を再インストールするのではなく、プロバイダーでキーを交換してください。

ローカルモデルは接続できません

1. ローカル ランナーを起動し、9xchat の外で応答することを確認します。
2. 9xchat が予期するアドレスとポートでリッスンしていることを確認します。
3. ランナーが走っているだけでなく、モデル自体が引っ張られてロードされていることを確認します。
4. [ライブラリ] → [モデル] を再度開くと、リストが更新されます。

ローカル モデルにはキーもクレジットも必要ありません。ローカル モデルが機能し、クラウド モデルが機能しない場合、問題はキー、残高、またはネットワークにあります。

ツールまたは MCP サーバーが動作していません

1. ツールが有効になっていることを確認してください。 すべてのツールの下に [有効] スイッチがあります。 ライブラリ → ツール。

2. プランを確認してください。 エージェント ツールとライブ Web 検索には Pro が必要です。「」を参照してください。 クレジット、プロ、および使用量。

3. 安全ラインをお読みください。 ツールに必要な権限が記載されています。ツール 必要なものに到達できないものは、求めるのではなく失敗します。

4. MCP サーバーの場合、必要なシークレットが提供されていることを確認します (エントリ) 「構成が必要」とマークされたままですが、セットアップされていません。構成プレビューには、実行される正確なコマンドが表示されます。これは、サーバーが起動しない場合に再読する価値があります。

5. 隔離します。 ツールを無効にし、同じ質問をして、問題が解決されているかどうかを確認します。 行動が変わります。これにより、ツールが関与しているかどうかがわかります。

知識検索では何も見つかりません

コレクションを検索するには、その前にコレクションにインデックスを付ける必要があります。

• ファイルがチャットに添付されただけでなく、コレクションに追加されたことを確認します。
• ナレッジの検索 ツールが有効になっていることを確認します。
• ファイルを追加したときに埋め込みプロバイダーに到達できなかった場合は、 検索はキーワード一致にフォールバックするため、インデックスが必要なものはすべて見逃されます。プロバイダーにアクセスできるようになったら、ファイルを再度追加します。

「知識と記憶」を参照してください。

添付ファイルは処理されません

• 選択したモデルがそのファイル タイプを受け入れることを確認してください。テキストのみのモデル 画像を読み取ることができず、モデルリストには視覚を扱うマークが付いています。
• 非常に大きなファイルはモデルのコンテキストを超える可能性があります。より小さい抽出を試すか、 より大きなコンテキスト ウィンドウを備えたモデル。
• ファイルが他の場所では正しく開くのに、ここでは失敗する場合は、ファイルを次の形式に変換してみてください。 まずは共通フォーマット。

画像生成に失敗する

• 画像生成には Pro が必要です。
• イメージ モデルが選択されていることを確認します。これは、イメージ モデルとは別に選択されます。 チャットモデル。
• 9xchat クレジットを通じて生成している場合は、クレジット残高を確認してください。
• 一部のプロンプトは、9xchat ではなくプロバイダーによって拒否されます。言い換えというのは 通常は再試行するよりも高速です。

ディクテーションまたは読み上げが失敗する

どちらも動作するオーディオプロバイダーを必要とし、どちらにもローカルオプションはありません。

• 文字起こしプロバイダが設定 → デフォルトで設定されていることを確認します モデル。
• オペレーティング システムのプライバシーで 9xchat マイクのアクセス許可を付与します 設定 — macOS の場合、システム設定 → プライバシーとセキュリティ → マイク。
• チャット モデルがローカルの場合でも、両方とも接続が必要です。

マイク入力には Pro が必要です。声に出して読み上げません。

クレジットが予想よりも早くなくなります

すべてのメッセージには独自のコスト、遅延、トークンの内訳が表示され、セッションには累計が表示されます。合計が間違っていると思われる場合は、メッセージごとの数値を開いて、どの交換がその数値を占めているかを確認してください。長いコンテキスト、推論トークン、および大きな添付ファイルはすべて、1 回のコストを増加させます。

モデル設定で最大完了トークンとコンテキスト制限を下げることで、チャットごとにこの上限を設定できます。また、コンテキスト シールドにより、各メッセージで再送信される履歴の量が削減されます。

クレジットの使用を完全に停止するには、独自の API キーを追加するか、ローカル モデルを使用します。

機能がグレー表示されているか、表示されていません

複数のタブ、フローティング ウィンドウ、ミニ チャット、クイック アシスタント、エージェント ツール、ライブ Web 検索、画像プレイグラウンド、マイク入力、メモリ システムなど、いくつかの機能には Pro が必要です。 クレジット、プロ、および使用量 には完全な分割がリストされています。

すでに支払いを行っている場合は、このデバイスがサブスクリプションを保持する UID でサインインしていること、およびデバイス制限 (無料では 1 台、Pro では 3 台) を超えていないことを確認してください。 3 つのデバイス ](/9xchat/guides/uid-and-devices) で [UID に従って、デバイスを接続、切り替え、または削除します。

別のデバイスに何かが足りない

ワークスペースは各デバイスにローカルに保存されるため、同じ UID でサインインした 2 台目のマシンはチャット、メモ、または思い出を継承しません**。それは故障ではなく想定内のことです。

• メモリはデバイスごとにあります。 新規インストールは何もない状態から開始されます。
• ハンドオフ は 1 つの会話に対して 2 つのデバイスをペアリングします。残りはコピーされません ワークスペースの。
• 素材を自分で移動するには、設定 → データとエクスポート を使用します。

サブスクリプションは UID に従っているため、コンテンツが送信されない場合でも、UID で認証されたデバイスは Pro を受け取ります。

ここでは何も役に立ちませんでした

support を通じて次のように連絡してください。

• オペレーティング システムと 9xchat のバージョン、
• 使用していたモデルとプロバイダー、
• クレジットを使用していても、自分のキーを使用していても、ローカル モデルを使用していても、
• あなたが何をしたか、そして目に見える正確なエラー。