fix(docs): locale translations for nav elements and headings
This commit is contained in:
@@ -3,26 +3,26 @@ title: トラブルシューティング
|
||||
description: よくある問題とその解決方法。
|
||||
---
|
||||
|
||||
OpenCode の問題をデバッグするには、まず、ディスク上に保存されているログとローカル データを確認します。
|
||||
OpenCode の問題をデバッグするには、まず、ディスク上に保存されているログとローカルデータを確認します。
|
||||
|
||||
---
|
||||
|
||||
## ログ
|
||||
|
||||
ログ ファイルは次の場所に書き込まれます。
|
||||
ログファイルは次の場所に書き込まれます。
|
||||
|
||||
- **macOS/Linux**: `~/.local/share/opencode/log/`
|
||||
- **Windows**: `WIN+R` を押して `%USERPROFILE%\.local\share\opencode\log` を貼り付けます
|
||||
|
||||
ログ ファイルにはタイムスタンプ付きの名前が付けられ (例: `2025-01-09T123456.log`)、最新の 10 個のログ ファイルが保存されます。
|
||||
ログファイルにはタイムスタンプ付きの名前が付けられ (例: `2025-01-09T123456.log`)、最新の 10 個のログファイルが保存されます。
|
||||
|
||||
`--log-level` コマンドライン オプションを使用してログ レベルを設定すると、より詳細なデバッグ情報を取得できます。たとえば、`opencode --log-level DEBUG`。
|
||||
`--log-level` コマンドラインオプションを使用してログレベルを設定すると、より詳細なデバッグ情報を取得できます。たとえば、`opencode --log-level DEBUG`。
|
||||
|
||||
---
|
||||
|
||||
## ストレージ
|
||||
|
||||
opencode は、セッション データとその他のアプリケーション データをディスク上の次の場所に保存します。
|
||||
OpenCode は、セッションデータとその他のアプリケーションデータをディスク上の次の場所に保存します。
|
||||
|
||||
- **macOS/Linux**: `~/.local/share/opencode/`
|
||||
- **Windows**: `WIN+R` を押して `%USERPROFILE%\.local\share\opencode` を貼り付けます
|
||||
@@ -31,7 +31,7 @@ opencode は、セッション データとその他のアプリケーション
|
||||
|
||||
- `auth.json` - API キー、OAuth トークンなどの認証データ
|
||||
- `log/` - アプリケーションログ
|
||||
- `project/` - セッション データやメッセージ データなどのプロジェクト固有のデータ
|
||||
- `project/` - セッションデータやメッセージデータなどのプロジェクト固有のデータ
|
||||
- プロジェクトが Git リポジトリ内にある場合は、`./<project-slug>/storage/` に保存されます
|
||||
- Git リポジトリではない場合は、`./global/storage/` に保存されます
|
||||
|
||||
@@ -39,21 +39,21 @@ opencode は、セッション データとその他のアプリケーション
|
||||
|
||||
## デスクトップアプリ
|
||||
|
||||
OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイドカー) をバックグラウンドで実行します。ほとんどの問題は、誤動作するプラグイン、破損したキャッシュ、または不正なサーバー設定によって発生します。
|
||||
OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイドカー) をバックグラウンドで実行します。ほとんどの問題は、誤動作しているプラグイン、破損したキャッシュ、または不正なサーバー設定によって発生します。
|
||||
|
||||
### クイックチェック
|
||||
|
||||
- アプリを完全に終了して再起動します。
|
||||
- アプリにエラー画面が表示された場合は、**再起動** をクリックしてエラーの詳細をコピーします。
|
||||
- macOS のみ: `OpenCode` メニュー -> **Webview を再ロード** (UI が空白またはフリーズしている場合に役立ちます)。
|
||||
- macOS のみ: `OpenCode` メニュー -> **Webview をリロード** (UI が空白またはフリーズしている場合に役立ちます)。
|
||||
|
||||
---
|
||||
|
||||
### プラグインを無効にする
|
||||
|
||||
デスクトップ アプリが起動時にクラッシュしたり、ハングしたり、異常な動作をしたりする場合は、まずプラグインを無効にしてください。
|
||||
デスクトップアプリが起動時にクラッシュしたり、ハングしたり、異常な動作をしたりする場合は、まずプラグインを無効にしてください。
|
||||
|
||||
#### グローバル設定を確認してください
|
||||
#### グローバル設定の確認
|
||||
|
||||
グローバル設定ファイルを開き、`plugin` キーを探します。
|
||||
|
||||
@@ -70,14 +70,14 @@ OpenCode Desktop は、ローカル OpenCode サーバー (`opencode-cli` サイ
|
||||
}
|
||||
```
|
||||
|
||||
#### プラグインのディレクトリを確認する
|
||||
#### プラグインディレクトリの確認
|
||||
|
||||
OpenCode はディスクからローカル プラグインをロードすることもできます。これらを一時的に邪魔にならない場所に移動し (またはフォルダーの名前を変更し)、デスクトップ アプリを再起動します。
|
||||
OpenCode はディスクからローカルプラグインをロードすることもできます。これらを一時的に邪魔にならない場所に移動し (またはフォルダーの名前を変更し)、デスクトップアプリを再起動します。
|
||||
|
||||
- **グローバル プラグイン**
|
||||
- **グローバルプラグイン**
|
||||
- **macOS/Linux**: `~/.config/opencode/plugins/`
|
||||
- **Windows**: `WIN+R` を押して `%USERPROFILE%\.config\opencode\plugins` を貼り付けます
|
||||
- **プロジェクト プラグイン** (プロジェクトごとの構成を使用する場合のみ)
|
||||
- **プロジェクトプラグイン** (プロジェクトごとの構成を使用する場合のみ)
|
||||
- `<your-project>/.opencode/plugins/`
|
||||
|
||||
アプリが再び動作し始めた場合は、プラグインを 1 つずつ再度有効にして、問題の原因となっているプラグインを特定します。
|
||||
@@ -89,7 +89,7 @@ OpenCode はディスクからローカル プラグインをロードするこ
|
||||
プラグインを無効にしても解決しない場合 (またはプラグインのインストールが停止した場合)、OpenCode がキャッシュを再構築できるようにキャッシュをクリアします。
|
||||
|
||||
1. OpenCode Desktop を完全に終了します。
|
||||
2. キャッシュ ディレクトリを削除します。
|
||||
2. キャッシュディレクトリを削除します。
|
||||
|
||||
- **macOS**: Finder -> `Cmd+Shift+G` -> `~/.cache/opencode` を貼り付け
|
||||
- **Linux**: `~/.cache/opencode` を削除します (または `rm -rf ~/.cache/opencode` を実行します)。
|
||||
@@ -99,23 +99,23 @@ OpenCode はディスクからローカル プラグインをロードするこ
|
||||
|
||||
---
|
||||
|
||||
### サーバー接続の問題を修正する
|
||||
### サーバー接続の問題の修正
|
||||
|
||||
OpenCode Desktop は、独自のローカル サーバー (デフォルト) を起動することも、構成したサーバー URL に接続することもできます。
|
||||
OpenCode Desktop は、独自のローカルサーバー (デフォルト) を起動することも、構成したサーバー URL に接続することもできます。
|
||||
|
||||
**「接続に失敗しました」** ダイアログが表示された場合 (またはアプリがスプラッシュ画面を通過できない場合)、カスタム サーバー URL を確認してください。
|
||||
**「接続に失敗しました」** ダイアログが表示された場合 (またはアプリがスプラッシュ画面を通過できない場合)、カスタムサーバー URL を確認してください。
|
||||
|
||||
#### デスクトップのデフォルトのサーバー URL をクリアします
|
||||
|
||||
ホーム画面でサーバー名 (ステータス ドット付き) をクリックしてサーバー ピッカーを開きます。 [**デフォルト サーバー**] セクションで、[**クリア**] をクリックします。
|
||||
ホーム画面でサーバー名 (ステータスドット付き) をクリックしてサーバーピッカーを開きます。 [**デフォルトサーバー**] セクションで、[**クリア**] をクリックします。
|
||||
|
||||
#### 設定から `server.port` / `server.hostname` を削除します
|
||||
|
||||
`opencode.json(c)` に `server` セクションが含まれている場合は、それを一時的に削除し、デスクトップ アプリを再起動します。
|
||||
`opencode.json(c)` に `server` セクションが含まれている場合は、それを一時的に削除し、デスクトップアプリを再起動します。
|
||||
|
||||
#### 環境変数を確認する
|
||||
|
||||
環境に `OPENCODE_PORT` が設定されている場合、デスクトップ アプリはローカル サーバーにそのポートを使用しようとします。
|
||||
環境に `OPENCODE_PORT` が設定されている場合、デスクトップアプリはローカルサーバーにそのポートを使用しようとします。
|
||||
|
||||
- `OPENCODE_PORT` の設定を解除して (または空きポートを選択して)、再起動します。
|
||||
|
||||
@@ -123,7 +123,7 @@ OpenCode Desktop は、独自のローカル サーバー (デフォルト) を
|
||||
|
||||
### Linux: Wayland / X11 の問題
|
||||
|
||||
Linux では、一部の Wayland セットアップにより、空白のウィンドウやコンポジター エラーが発生する可能性があります。
|
||||
Linux では、一部の Wayland セットアップにより、空白のウィンドウやコンポジターエラーが発生する可能性があります。
|
||||
|
||||
- Wayland を使用していて、アプリが空白またはクラッシュしている場合は、`OC_ALLOW_WAYLAND=1` で起動してみてください。
|
||||
- これにより状況が悪化する場合は、それを削除し、代わりに X11 セッションで起動してみてください。
|
||||
@@ -138,7 +138,7 @@ Windows では、OpenCode Desktop には Microsoft Edge **WebView2 ランタイ
|
||||
|
||||
### Windows: 一般的なパフォーマンスの問題
|
||||
|
||||
Windows でパフォーマンスの低下、ファイル アクセスの問題、またはterminal の問題が発生している場合は、[WSL (Windows Subsystem for Linux)](/docs/windows-wsl) を使用してみてください。 WSL は、OpenCode の機能とよりシームレスに連携する Linux 環境を提供します。
|
||||
Windows でパフォーマンスの低下、ファイルアクセスの問題、またはターミナルの問題が発生している場合は、[WSL (Windows Subsystem for Linux)](/docs/windows-wsl) を使用してみてください。 WSL は、OpenCode の機能とよりシームレスに連携する Linux 環境を提供します。
|
||||
|
||||
---
|
||||
|
||||
@@ -151,12 +151,12 @@ OpenCode Desktop では、次の場合にのみシステム通知が表示され
|
||||
|
||||
---
|
||||
|
||||
### デスクトップ アプリのストレージをリセットする (最後の手段)
|
||||
### デスクトップアプリのストレージのリセット (最後の手段)
|
||||
|
||||
アプリが起動せず、UI 内から設定をクリアできない場合は、デスクトップ アプリの保存された状態をリセットします。
|
||||
アプリが起動せず、UI 内から設定をクリアできない場合は、デスクトップアプリの保存された状態をリセットします。
|
||||
|
||||
1. OpenCode デスクトップを終了します。
|
||||
2. これらのファイルを見つけて削除します (これらのファイルは OpenCode デスクトップ アプリのデータ ディレクトリにあります)。
|
||||
2. これらのファイルを見つけて削除します (これらのファイルは OpenCode デスクトップアプリのデータディレクトリにあります)。
|
||||
|
||||
- `opencode.settings.dat` (デスクトップのデフォルトサーバー URL)
|
||||
- `opencode.global.dat` および `opencode.workspace.*.dat` (最近のサーバー/プロジェクトなどの UI 状態)
|
||||
@@ -169,7 +169,7 @@ OpenCode Desktop では、次の場合にのみシステム通知が表示され
|
||||
|
||||
---
|
||||
|
||||
## 助けを求める
|
||||
## ヘルプを求める
|
||||
|
||||
OpenCode で問題が発生している場合:
|
||||
|
||||
@@ -181,7 +181,7 @@ OpenCode で問題が発生している場合:
|
||||
|
||||
新しい問題を作成する前に、既存の問題を検索して、問題がすでに報告されているかどうかを確認してください。
|
||||
|
||||
2. **Discord に参加してください**
|
||||
2. **Discord への参加**
|
||||
|
||||
リアルタイムのヘルプやコミュニティのディスカッションについては、Discord サーバーに参加してください。
|
||||
|
||||
@@ -195,10 +195,10 @@ OpenCode で問題が発生している場合:
|
||||
|
||||
---
|
||||
|
||||
### OpenCodeが起動しない
|
||||
### OpenCode が起動しない
|
||||
|
||||
1. ログでエラー メッセージを確認する
|
||||
2. `--print-logs` で実行して、terminal に出力を確認してください。
|
||||
1. ログでエラーメッセージを確認する
|
||||
2. `--print-logs` で実行して、ターミナルに出力を確認してください。
|
||||
3. `opencode upgrade` を含む最新バージョンを使用していることを確認してください
|
||||
|
||||
---
|
||||
@@ -211,7 +211,7 @@ OpenCode で問題が発生している場合:
|
||||
|
||||
---
|
||||
|
||||
### モデルがありません
|
||||
### モデルが見つからない
|
||||
|
||||
1. プロバイダーで認証されていることを確認してください
|
||||
2. 構成内のモデル名が正しいことを確認してください
|
||||
@@ -237,42 +237,42 @@ ProviderInitError が発生した場合は、構成が無効または破損し
|
||||
|
||||
これを解決するには:
|
||||
|
||||
1. まず、[プロバイダー ガイド](/docs/providers) に従って、プロバイダーが正しく設定されていることを確認します。
|
||||
1. まず、[プロバイダーガイド](/docs/providers) に従って、プロバイダーが正しく設定されていることを確認します。
|
||||
2. 問題が解決しない場合は、保存されている構成をクリアしてみてください。
|
||||
|
||||
```bash
|
||||
rm -rf ~/.local/share/opencode
|
||||
```
|
||||
|
||||
Windows では、`WIN+R` を押して、`%USERPROFILE%\.local\share\opencode` を削除します。
|
||||
Windows では、`WIN+R` を押して、`%USERPROFILE%\.local\share\opencode` を削除します。
|
||||
|
||||
3. TUI の `/connect` コマンドを使用して、プロバイダーで再認証します。
|
||||
|
||||
---
|
||||
|
||||
### AI_APICallError とプロバイダー パッケージの問題
|
||||
### AI_APICallError とプロバイダーパッケージの問題
|
||||
|
||||
API 呼び出しエラーが発生した場合は、プロバイダー パッケージが古いことが原因である可能性があります。 opencode は、必要に応じてプロバイダー パッケージ (OpenAI、Anthropic、Google など) を動的にインストールし、ローカルにキャッシュします。
|
||||
API 呼び出しエラーが発生した場合は、プロバイダーパッケージが古いことが原因である可能性があります。 OpenCode は、必要に応じてプロバイダーパッケージ (OpenAI、Anthropic、Google など) を動的にインストールし、ローカルにキャッシュします。
|
||||
|
||||
プロバイダー パッケージの問題を解決するには:
|
||||
プロバイダーパッケージの問題を解決するには:
|
||||
|
||||
1. プロバイダー パッケージのキャッシュをクリアします。
|
||||
1. プロバイダーパッケージのキャッシュをクリアします。
|
||||
|
||||
```bash
|
||||
rm -rf ~/.cache/opencode
|
||||
```
|
||||
|
||||
Windows では、`WIN+R` を押して、`%USERPROFILE%\.cache\opencode` を削除します。
|
||||
Windows では、`WIN+R` を押して、`%USERPROFILE%\.cache\opencode` を削除します。
|
||||
|
||||
2. opencodeを再起動して最新のプロバイダー パッケージを再インストールします
|
||||
2. OpenCode を再起動して最新のプロバイダーパッケージを再インストールします
|
||||
|
||||
これにより、opencodeはプロバイダー パッケージの最新バージョンを強制的にダウンロードすることになり、多くの場合、モデル パラメーターや API の変更に関する互換性の問題が解決されます。
|
||||
これにより、OpenCode はプロバイダーパッケージの最新バージョンを強制的にダウンロードすることになり、多くの場合、モデルパラメーターや API の変更に関する互換性の問題が解決されます。
|
||||
|
||||
---
|
||||
|
||||
### Linux ではコピー/ペーストが機能しない
|
||||
|
||||
Linux ユーザーがコピー/ペースト機能を動作させるには、次のクリップボード ユーティリティのいずれかがインストールされている必要があります。
|
||||
Linux ユーザーがコピー/ペースト機能を動作させるには、次のクリップボードユーティリティのいずれかがインストールされている必要があります。
|
||||
|
||||
**X11 システムの場合:**
|
||||
|
||||
@@ -297,4 +297,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
|
||||
export DISPLAY=:99.0
|
||||
```
|
||||
|
||||
opencode は、Wayland を使用していて `wl-clipboard` を優先しているかどうかを検出します。そうでない場合は、`xclip` および `xsel` の順序でクリップボード ツールを検索しようとします。
|
||||
OpenCode は、Wayland を使用していて `wl-clipboard` を優先しているかどうかを検出します。そうでない場合は、`xclip` および `xsel` の順序でクリップボードツールを検索しようとします。
|
||||
|
||||
Reference in New Issue
Block a user