@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,423 @@
+---
+title: TUI
+description: OpenCode ターミナルユーザーインターフェイスの使用。
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode は、LLM を使用してプロジェクトを作業するための対話型ターミナルインターフェイスまたは TUI を提供します。
+
+OpenCode を実行すると、現在のディレクトリの TUI が開始されます。
+
+```bash
+opencode
+```
+
+または、特定の作業ディレクトリに対して起動することもできます。
+
+```bash
+opencode /path/to/project
+```
+
+TUI に入ったら、メッセージを表示することができます。
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## ファイル参照
+
+`@` を使用してメッセージ内のファイルを参照できます。これにより、現在の作業ディレクトリ内であいまいなファイル検索が行われます。
+
+:::tip
+`@` を使用してメッセージ内のファイルを参照することもできます。
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+ファイルの内容は会話に自動的に追加されます。
+
+---
+
+## Bash コマンド
+
+メッセージを `!` で開始して、シェルコマンドを実行します。
+
+```bash frame="none"
+!ls -la
+```
+
+コマンドの出力は、ツールの結果として会話に追加されます。
+
+---
+
+## コマンド
+
+OpenCode TUI を使用する場合、「`/`」に続いてコマンド名を入力すると、アクションをすばやく実行できます。例えば：
+
+```bash frame="none"
+/help
+```
+
+ほとんどのコマンドには、`ctrl+x` をリーダーキーとして使用するキーバインドもあります。`ctrl+x` がデフォルトのリーダーキーです。 [詳細はこちら](/docs/keybinds)。
+
+利用可能なすべてのスラッシュコマンドは次のとおりです。
+
+---
+
+### 接続
+
+OpenCode にプロバイダーを追加します。利用可能なプロバイダーから選択し、その API キーを追加できます。
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### コンパクト
+
+現在のセッションを圧縮します。 _別名_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**キーバインド:** `ctrl+x c`
+
+---
+
+### 詳細
+
+ツール実行の詳細を切り替えます。
+
+```bash frame="none"
+/details
+```
+
+**キーバインド:** `ctrl+x d`
+
+---
+
+### エディタ
+
+メッセージを作成するために外部エディタを開きます。 `EDITOR` 環境変数に設定されたエディタを使用します。 [詳細はこちら](#editor-setup)。
+
+```bash frame="none"
+/editor
+```
+
+**キーバインド:** `ctrl+x e`
+
+---
+
+### 終了
+
+OpenCode を終了します。 _エイリアス_: `/quit`、`/q`
+
+```bash frame="none"
+/exit
+```
+
+**キーバインド:** `ctrl+x q`
+
+---
+
+### エクスポート
+
+現在の会話を Markdown にエクスポートし、デフォルトのエディターで開きます。 `EDITOR` 環境変数に設定されたエディタを使用します。 [詳細はこちら](#editor-setup)。
+
+```bash frame="none"
+/export
+```
+
+**キーバインド:** `ctrl+x x`
+
+---
+
+### ヘルプ
+
+ヘルプダイアログを表示します。
+
+```bash frame="none"
+/help
+```
+
+**キーバインド:** `ctrl+x h`
+
+---
+
+### 初期化
+
+`AGENTS.md` ファイルを作成または更新します。 [詳細はこちら](/docs/rules)。
+
+```bash frame="none"
+/init
+```
+
+**キーバインド:** `ctrl+x i`
+
+---
+
+### モデル
+
+利用可能なモデルをリストします。
+
+```bash frame="none"
+/models
+```
+
+**キーバインド:** `ctrl+x m`
+
+---
+
+### 新規セッション
+
+新しいセッションを開始します。 _別名_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**キーバインド:** `ctrl+x n`
+
+---
+
+### やり直し
+
+以前に取り消したメッセージをやり直します。 `/undo` を使用した後にのみ使用できます。
+
+:::tip
+ファイルの変更も復元されます。
+:::
+内部的には、`undo` を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは **Git リポジトリ** である必要があります。
+
+```bash frame="none"
+/redo
+```
+
+**キーバインド:** `ctrl+x r`
+
+---
+
+### セッション
+
+セッションを一覧表示して切り替えます。 _エイリアス_: `/resume`、`/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**キーバインド:** `ctrl+x l`
+
+---
+
+### 共有
+
+現在のセッションを共有します。 [詳細はこちら](/docs/share)。
+
+```bash frame="none"
+/share
+```
+
+**キーバインド:** `ctrl+x s`
+
+---
+
+### テーマ
+
+利用可能なテーマをリストします。
+
+```bash frame="none"
+/theme
+```
+
+**キーバインド:** `ctrl+x t`
+
+---
+
+### 思考
+
+会話内の思考/推論ブロックの表示を切り替えます。有効にすると、拡張思考をサポートするモデルの推論プロセスを確認できます。
+
+:::note
+このコマンドは、思考ブロックを**表示**するかどうかのみを制御します。モデルの推論機能を有効または無効にすることはありません。実際の推論機能を切り替えるには、`ctrl+t` を使用してモデルバリアントを循環させます。
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### 元に戻す
+
+会話の最後のメッセージを元に戻します。最新のユーザーメッセージ、その後のすべての応答、およびファイルの変更を削除します。
+
+:::tip
+加えられたファイルの変更も元に戻されます。
+:::
+内部的には、`undo` を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは **Git リポジトリ** である必要があります。
+
+```bash frame="none"
+/undo
+```
+
+**キーバインド:** `ctrl+x u`
+
+---
+
+### 共有の解除
+
+現在のセッションの共有を解除します。 [詳細はこちら](/docs/share#un-sharing)。
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## エディタのセットアップ
+
+`/editor` および `/export` コマンドはどちらも、`EDITOR` 環境変数で指定されたエディターを使用します。
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+これを永続的にするには、これをシェルプロファイルに追加します。
+`~/.bashrc`、`~/.zshrc`など
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+これを永続的にするには、**システムプロパティ** > **環境変数**を使用します。
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+これを永続的にするには、これを PowerShell プロファイルに追加します。
+
+  </TabItem>
+</Tabs>
+
+一般的なエディターオプションには次のものがあります。
+
+- `code` - VS Code
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Neovim エディター
+- `vim` - Vim エディター
+- `nano` - ナノエディター
+- `notepad` - Windows メモ帳
+- `subl` - Sublime Text
+
+:::note
+VS Code などの一部のエディターは、`--wait` フラグを使用して起動する必要があります。
+:::
+一部のモードでは実行にコマンドライン引数が必要です。`--wait` フラグを使うと、エディターが閉じるまでプロセスが待機します。
+
+---
+
+## 設定
+
+`tui.json` (または `tui.jsonc`) ファイルを通じて TUI の動作をカスタマイズできます。
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+これは、サーバー/ランタイムの動作を構成する `opencode.json` とは別です。
+
+`keybinds` は組み込みのデフォルトとマージされるため、変更したいショートカットだけを設定すれば十分です。
+
+### オプション
+
+- `theme` - UI テーマを設定します。[詳細はこちら](/docs/themes)。
+- `keybinds` - キーボードショートカットをカスタマイズします。[詳細はこちら](/docs/keybinds)。
+- `leader_timeout` - leader key を押したあと、OpenCode が次のキー入力を待つ時間を制御します。デフォルトは `2000` です。
+- `scroll_acceleration.enabled` - macOS スタイルのスクロールアクセラレーションを有効にして、スムーズで自然なスクロールを実現します。有効にすると、高速スクロールジェスチャではスクロール速度が向上し、ゆっくりとした動きでは正確なままになります。 **この設定は `scroll_speed` よりも優先され、有効になっている場合は上書きされます。**
+- `scroll_speed` - スクロールコマンドを使用するときに TUI がスクロールする速度を制御します (最小: `0.001`、小数をサポート)。デフォルトは `3` です。 **注: `scroll_acceleration.enabled` が `true` に設定されている場合、これは無視されます。**
+- `diff_style` - 差分レンダリングを制御します。 `"auto"` はターミナルの幅に適応し、`"stacked"` は常に 1 列のレイアウトを表示します。
+- `mouse` - TUI でのマウスキャプチャを有効または無効にします (デフォルト: `true`)。無効にすると、ターミナル本来のマウス選択/スクロール動作が維持されます。
+- `attention` - TUI のデスクトップ通知とサウンドを設定します。デフォルトでは無効です。
+
+カスタム TUI 設定パスをロードするには、`OPENCODE_TUI_CONFIG` を使用します。
+
+### Attention
+
+Attention を有効にすると、OpenCode が回答待ち、権限の承認待ち、セッションエラー、またはセッション完了を知らせたいときに、TUI がサウンドやデスクトップ通知で知らせます。`attention.enabled` で有効化します。組み込みイベントは発生時にサウンドを再生します。デスクトップ通知はターミナルウィンドウにフォーカスがない場合にのみ送信され、subagent イベントには使われません。
+
+- `enabled` - Attention のすべての通知とサウンドを有効にします。デフォルトは `false` です。
+- `notifications` - Attention が有効なとき、TUI がターミナル経由でデスクトップ通知を送信できるようにします。デフォルトは `true` です。
+- `sound` - Attention が有効なとき、通知音の再生を許可します。デフォルトは `true` です。
+- `volume` - 通知音のデフォルト音量を `0` から `1` で指定します。デフォルトは `0.4` です。
+- `sound_pack` - 使用する sound pack ID です。デフォルトは `opencode.default` です。
+- `sounds` - `default`、`question`、`permission`、`error`、`done`、または `subagent_done` に使うカスタムサウンドファイルを指定します。パスは絶対パス、`file://` URL、または `tui.json` からの相対パスにできます。
+
+---
+
+## カスタマイズ
+
+コマンドパレット (`ctrl+x h` または `/help`) を使用して、TUI ビューのさまざまな側面をカスタマイズできます。これらの設定は再起動後も維持されます。
+
+---
+
+#### ユーザー名の表示
+
+チャットメッセージにユーザー名を表示するかどうかを切り替えます。これには次の方法でアクセスします。
+
+- コマンドパレット:「ユーザー名」または「ユーザー名を隠す」を検索します。
+- 設定は自動的に保持され、TUI セッション全体で記憶されます。

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

@@ -0,0 +1,143 @@
+---
+title: ウェブ
+description: ブラウザで OpenCode を使用する。
+---
+
+OpenCode はブラウザで Web アプリケーションとして実行でき、ターミナルを必要とせずに同じ強力な AI コーディングエクスペリエンスを提供します。
+
+![OpenCode Web - 新しいセッション](../../../assets/web/web-homepage-new-session.png)
+
+---
+
+## はじめる
+
+以下を実行して Web インターフェースを開始します。
+
+```bash
+opencode web
+```
+
+これにより、利用可能なランダムなポートを使用して `127.0.0.1` でローカルサーバーが起動され、デフォルトのブラウザで OpenCode が自動的に開きます。
+
+:::caution
+`OPENCODE_SERVER_PASSWORD` が設定されていない場合、サーバーは保護されません。これはローカルで使用する場合には問題ありませんが、ネットワークアクセス用に設定する必要があります。
+:::
+:::tip[Windows ユーザー]
+最高のエクスペリエンスを得るには、PowerShell ではなく [WSL](/docs/windows-wsl) から `opencode web` を実行します。これにより、ファイルシステムへの適切なアクセスとターミナルの統合が保証されます。
+:::
+
+---
+
+## 設定
+
+コマンドラインフラグを使用するか、[設定ファイル](/docs/config)で Web サーバーを設定できます。
+
+### ポート
+
+デフォルトでは、OpenCode は使用可能なポートを選択します。ポートを指定できます。
+
+```bash
+opencode web --port 4096
+```
+
+### ホスト名
+
+デフォルトでは、サーバーは `127.0.0.1` (localhost のみ) にバインドされます。ネットワーク上で OpenCode にアクセスできるようにするには:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+`0.0.0.0` を使用すると、OpenCode はローカルアドレスとネットワークアドレスの両方を表示します。
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### mDNS 検出
+
+mDNS を有効にして、ローカルネットワーク上でサーバーを検出できるようにします。
+
+```bash
+opencode web --mdns
+```
+
+これにより、ホスト名が自動的に `0.0.0.0` に設定され、サーバーが `opencode.local` としてアドバタイズされます。
+
+mDNS ドメイン名をカスタマイズして、同じネットワーク上で複数のインスタンスを実行できます。
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+CORS の追加ドメインを許可するには (カスタムフロントエンドに便利):
+
+```bash
+opencode web --cors https://example.com
+```
+
+### 認証
+
+アクセスを保護するには、`OPENCODE_SERVER_PASSWORD` 環境変数を使用してパスワードを設定します。
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+ユーザー名のデフォルトは `opencode` ですが、`OPENCODE_SERVER_USERNAME` で変更できます。
+
+---
+
+## Web インターフェースの使用
+
+開始すると、Web インターフェイスから OpenCode セッションにアクセスできるようになります。
+
+### セッション
+
+ホームページからセッションを表示および管理します。アクティブなセッションを確認したり、新しいセッションを開始したりできます。
+
+![OpenCode Web - アクティブなセッション](../../../assets/web/web-homepage-active-session.png)
+
+### サーバーステータス
+
+「サーバーを表示」をクリックすると、接続されているサーバーとそのステータスが表示されます。
+
+![OpenCode Web - サーバー](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## ターミナルの接続
+
+実行中の Web サーバーにターミナル TUI を接続できます。
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode attach http://localhost:4096
+```
+
+これにより、Web インターフェイスとターミナルの両方を同時に使用し、同じセッションと状態を共有できるようになります。
+
+---
+
+## 設定ファイル
+
+`opencode.json` 設定ファイルでサーバー設定を構成することもできます。
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+コマンドラインフラグは、設定ファイルの設定よりも優先されます。

package/src/content/docs/ja/windows-wsl.mdx

@@ -0,0 +1,116 @@
+---
+title: Windows (WSL)
+description: WSL を使って Windows で OpenCode を使う。
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+OpenCode は Windows で直接実行できますが、より快適に使うには [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) の利用をおすすめします。WSL は OpenCode の機能とスムーズに連携する Linux 環境を提供します。
+
+:::tip[WSL を使う理由]
+WSL を使うと、ファイルシステム性能、ターミナルサポート、OpenCode が依存する開発ツールとの互換性が向上します。
+:::
+
+---
+
+## セットアップ
+
+<Steps>
+
+1. **WSL をインストールする**
+
+   まだの場合は、Microsoft 公式ガイドを使って [WSL をインストール](https://learn.microsoft.com/en-us/windows/wsl/install) します。
+
+2. **WSL で OpenCode をインストールする**
+
+   WSL の準備ができたら WSL のターミナルを開き、[インストール方法](/docs/) のいずれかで OpenCode をインストールします。
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **WSL から OpenCode を使う**
+
+   プロジェクトディレクトリに移動し（Windows ファイルは `/mnt/c/` や `/mnt/d/` などからアクセス）、OpenCode を実行します。
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## デスクトップアプリ + WSL サーバー
+
+OpenCode デスクトップアプリを使いつつ、サーバーは WSL で動かしたい場合は次の手順です。
+
+1. **WSL でサーバーを起動する**
+
+   外部接続を許可するため、`--hostname 0.0.0.0` を付けて起動します。
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **デスクトップアプリを接続する**
+
+   `http://localhost:4096` に接続します。
+
+:::note
+環境によって `localhost` が使えない場合は、WSL 側で `hostname -I` を実行して IP アドレスを確認し、`http://<wsl-ip>:4096` に接続してください。
+:::
+:::caution
+`--hostname 0.0.0.0` を使う場合は、`OPENCODE_SERVER_PASSWORD` を設定してサーバーを保護してください。
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+## Web クライアント + WSL
+
+Windows で Web 利用を快適にするには:
+
+1. **PowerShell ではなく WSL ターミナルで `opencode web` を実行する**
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Windows のブラウザからアクセスする**
+
+   `http://localhost:<port>` にアクセスします（URL は OpenCode が表示します）。
+
+WSL から `opencode web` を実行すると、適切なファイルシステムアクセスとターミナル統合を維持したまま、Windows ブラウザから利用できます。
+
+---
+
+## Windows ファイルへのアクセス
+
+WSL からは `/mnt/` ディレクトリ経由で Windows ファイルにアクセスできます。
+
+- `C:` drive → `/mnt/c/`
+- `D:` drive → `/mnt/d/`
+- そのほかのドライブも同様です
+
+例:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+よりスムーズに使うには、リポジトリを WSL のファイルシステム（例: `~/code/`）にクローンまたはコピーして、そこで OpenCode を実行することをおすすめします。
+:::
+
+---
+
+## ヒント
+
+- Windows ドライブ上のプロジェクトでも、OpenCode は WSL で実行するとファイルアクセスがスムーズです
+- OpenCode と一緒に VS Code の [WSL 拡張機能](https://code.visualstudio.com/docs/remote/wsl) を使うと統合的な開発フローを構築できます
+- OpenCode の設定とセッションは WSL 環境内の `~/.local/share/opencode/` に保存されます