@neurocode-ai/web 1.18.8

package/src/content/docs/ja/tools.mdx

@@ -0,0 +1,341 @@
+---
+title: ツール
+description: LLM が使用できるツールを管理します。
+---
+
+ツールを使用すると、LLM がコードベースでアクションを実行できるようになります。 OpenCode には一連の組み込みツールが付属していますが、[カスタムツール](/docs/custom-tools) または [MCP サーバー](/docs/mcp-servers) を使用して拡張できます。
+
+デフォルトでは、すべてのツールは**有効**になっており、実行するための権限は必要ありません。 [権限](/docs/permissions).
+
+---
+
+## 設定
+
+`permission` フィールドを使用してツールの動作を制御します。各ツールを許可、拒否、または承認を要求することができます。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "deny",
+    "bash": "ask",
+    "webfetch": "allow"
+  }
+}
+```
+
+ワイルドカードを使用して複数のツールを一度に制御することもできます。たとえば、MCP サーバーからのすべてのツールの承認を要求するには、次のようにします。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "mymcp_*": "ask"
+  }
+}
+```
+
+[アクセス許可の構成について詳しくは、](/docs/permissions) をご覧ください。
+
+---
+
+## 組み込み
+
+OpenCode で利用可能なすべての組み込みツールを次に示します。
+
+---
+
+### bash
+
+プロジェクト環境でシェルコマンドを実行します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": "allow"
+  }
+}
+```
+
+このツールを使用すると、LLM は `npm install`、`git status`、またはその他のシェルコマンドなどのターミナルコマンドを実行できます。
+
+---
+
+### edit
+
+正確な文字列置換を使用して既存のファイルを変更します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+このツールは、完全に一致するテキストを置き換えることにより、ファイルを正確に編集します。これは、LLM がコードを変更する主な方法です。
+
+---
+
+### write
+
+新しいファイルを作成するか、既存のファイルを上書きします。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+これを使用して、LLM が新しいファイルを作成できるようにします。既存のファイルがすでに存在する場合は上書きされます。
+
+:::note
+`write` ツールは、すべてのファイル変更 (`edit`、`write`、`patch`) をカバーする `edit` 権限によって制御されます。
+:::
+
+---
+
+### read
+
+コードベースからファイルの内容を読み取ります。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "read": "allow"
+  }
+}
+```
+
+このツールはファイルを読み取り、その内容を返します。大きなファイルの特定の行範囲の読み取りをサポートします。
+
+---
+
+### grep
+
+正規表現を使用してファイルの内容を検索します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "grep": "allow"
+  }
+}
+```
+
+コードベース全体での高速コンテンツ検索。完全な正規表現構文とファイルパターンフィルタリングをサポートします。
+
+---
+
+### glob
+
+パターンマッチングによりファイルを検索します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "glob": "allow"
+  }
+}
+```
+
+`**/*.js` や `src/**/*.ts` などの glob パターンを使用してファイルを検索します。一致するファイルパスを変更時間順に並べて返します。
+
+---
+
+### lsp (実験的)
+
+構成された LSP サーバーと対話して、定義、参照、ホバー情報、呼び出し階層などのコードインテリジェンス機能を取得します。
+
+:::note
+このツールは、`OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (または `OPENCODE_EXPERIMENTAL=true`) の場合にのみ使用できます。
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "lsp": "allow"
+  }
+}
+```
+
+サポートされている操作には、`goToDefinition`、`findReferences`、`hover`、`documentSymbol`、`workspaceSymbol`、`goToImplementation`、`prepareCallHierarchy`、`incomingCalls`、および `outgoingCalls` が含まれます。
+
+プロジェクトで使用できる LSP サーバーを構成するには、「LSP Servers](/docs/lsp).
+
+---
+
+### patch
+
+ファイルにパッチを適用します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+このツールは、コードベースにパッチファイルを適用します。さまざまなソースからの差分やパッチを適用するのに役立ちます。
+
+:::note
+`patch` ツールは、すべてのファイル変更 (`edit`、`write`、`patch`) をカバーする `edit` 権限によって制御されます。
+:::
+
+---
+
+### skill
+
+[skill](/docs/skills) (`SKILL.md` ファイル) をロードし、会話でその内容を返します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "skill": "allow"
+  }
+}
+```
+
+---
+
+### todowrite
+
+コーディングセッション中に ToDo リストを管理します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "todowrite": "allow"
+  }
+}
+```
+
+タスクリストを作成および更新して、複雑な操作中の進行状況を追跡します。 LLM はこれを使用して、複数ステップのタスクを整理します。
+
+:::note
+このツールはデフォルトではサブエージェントに対して無効になっていますが、手動で有効にすることができます。 [詳細はこちら](/docs/agents/#permissions)
+:::
+
+---
+
+### webfetch
+
+Web コンテンツを取得します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "webfetch": "allow"
+  }
+}
+```
+
+LLM が Web ページをフェッチして読み取ることを許可します。ドキュメントの検索やオンラインリソースの調査に役立ちます。
+
+---
+
+### websearch
+
+ウェブで情報を検索してください。
+
+:::note
+このツールは、OpenCode プロバイダーを使用している場合、または `OPENCODE_ENABLE_EXA` 環境変数が真実の値 (`true` または `1` など) に設定されている場合にのみ使用できます。
+
+OpenCode の起動時に有効にするには:
+
+```bash
+OPENCODE_ENABLE_EXA=1 opencode
+```
+
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "websearch": "allow"
+  }
+}
+```
+
+Exa AI を使用して Web 検索を実行し、オンラインで関連情報を見つけます。トピックの調査、最新のイベントの検索、またはトレーニングデータのカットオフを超えた情報の収集に役立ちます。
+
+API キーは必要ありません。ツールは認証なしで Exa AI のホストされた MCP サービスに直接接続します。
+
+:::tip
+情報を見つける必要がある場合 (検出)、`websearch` を使用し、特定の URL からコンテンツを取得する必要がある場合 (取得) は `webfetch` を使用します。
+:::
+
+---
+
+### question
+
+実行中にユーザーに質問します。
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "question": "allow"
+  }
+}
+```
+
+このツールを使用すると、LLM はタスク中にユーザーに質問できるようになります。これは次の場合に役立ちます。
+
+- ユーザーの好みや要件を収集する
+- 曖昧な指示を明確にする
+- 実装の選択肢について決定を下す
+- どの方向に進むべきかについての選択肢を提供する
+
+各質問には、ヘッダー、質問テキスト、およびオプションのリストが含まれます。ユーザーは、提供されたオプションから選択するか、カスタムの回答を入力できます。複数の質問がある場合、ユーザーはすべての回答を送信する前に質問間を移動できます。
+
+---
+
+## カスタムツール
+
+カスタムツールを使用すると、LLM が呼び出すことができる独自の関数を定義できます。これらは設定ファイルで定義されており、任意のコードを実行できます。
+
+[カスタムツールの作成について詳しくは、](/docs/custom-tools) をご覧ください。
+
+---
+
+## MCPサーバー
+
+MCP (Model Context Protocol) サーバーを使用すると、外部ツールとサービスを統合できます。これには、データベースアクセス、API 統合、サードパーティサービスが含まれます。
+
+[MCP サーバーの設定について詳しくは、](/docs/mcp-servers) をご覧ください。
+
+---
+
+## 内部動作
+
+内部的には、`grep`、`glob` などのツールは内部で [ripgrep](https://github.com/BurntSushi/ripgrep) を使用します。デフォルトでは、ripgrep は `.gitignore` パターンを尊重します。つまり、`.gitignore` にリストされているファイルとディレクトリは検索とリストから除外されます。
+
+---
+
+### パターンを無視する
+
+通常は無視されるファイルを含めるには、プロジェクトのルートに `.ignore` ファイルを作成します。このファイルでは、特定のパスを明示的に許可できます。
+
+```text title=".ignore"
+!node_modules/
+!dist/
+!build/
+```
+
+たとえば、この `.ignore` ファイルを使用すると、ripgrep は、`node_modules/` にリストされている場合でも、`dist/`、`build/`、および `.gitignore` ディレクトリ内を検索できます。

package/src/content/docs/ja/troubleshooting.mdx

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