CodeNomad/docs/help/ja/settings.md
Ledracarnos 091361d116
fix(ui): capture pointer while resizing side panels (#1233)
Resizing a docked side panel listened for mouse and touch moves on the
whole document, so a drag that left the handle's narrow hit area could
reach controls under the pointer and the handle lost its highlight.

The handles now use local Pointer Events with pointer capture, like the
composer's resize handle: the initiating primary pointer is captured on
the handle, which keeps an .is-resizing highlight until release,
cancellation, capture loss or its own removal; secondary buttons never
start a drag, and touch-action: none keeps touch drags from scrolling.
Each handle's cleanup stops only its own side's drag, so closing the
opposite panel mid-drag does not interrupt it. The document-wide drag
helper is removed. Width calculation, clamping, RTL, persistence and
resize scheduling are unchanged. The help pages in all ten locales
mention dragging a panel's inner edge to resize it.

panel-resize.test.ts drives the real shell for both panels in LTR and
RTL: capture and highlight outside the handle, release, cancellation,
capture loss, handle removal, closing the opposite panel mid-drag, touch
and a held secondary button. drawer-width, the help tests and the UI
typecheck pass.
2026-10-31 21:13:51 +01:00

84 lines
14 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 設定とレイアウト
## 設定を開き、範囲を確認する {#open-settings}
1. タブバー(macOS のデスクトップアプリではタイトルバー)またはホームページの **設定を開く** の歯車で **設定** を開きます。モデルセレクターの **プロバイダーを管理**、ミッションパネルの歯車、通知履歴の **設定** の歯車などのショートカットは、該当するセクションを直接開きます。
2. セクションを選びます。ローカルの Electron/Tauri ウィンドウは、単一のネイティブ設定ウィンドウを開くかフォーカスします。ブラウザー/リモート表示は埋め込み設定画面を使います。
3. 離れる前に、設定の範囲と **保存** 操作の有無を確認します。
ほとんどの選択は直ちに適用されます。ミッション設定も、変更するたびにその変更を保存します。音声、パレットのカスタム色、設定ファイルには、明示的な **保存** があります。保存失敗は変更が反映された確認ではありません。再試行前に該当セクションを開き直すか更新してください。説明は設定のタイトル横の **i** にあります。カーソルを合わせるかフォーカスするか、タッチ画面ではタップしてください。**設定 → 情報** には **CodeNomad を支援する** カードもあり、**スポンサーになる・貢献する** で [CodeNomad を支援する](sponsor.md) ページを開きます。
| 状態 | 制御するもの |
| --- | --- |
| CodeNomad 設定 | その設定を使用するクライアントの UI 設定、音声、SideCar、サーバー設定。バッジのない設定も端末ごとには保存されません。**サーバー設定** は、音声、SideCar、リモートコントロール、環境変数などのサーバー側の設定を示します。 |
| ウィンドウ/プロジェクトタブのレイアウト | 開いているパネル、選択タブ、リーダー状態、復元可能な下書き/レイアウト。OpenCode 設定ではありません。 |
| グローバル/プロジェクトの OpenCode 設定 | 表示範囲のネイティブなプラグイン/設定変更。プロジェクト操作にはアクティブなプロジェクト/Location が必要です。 |
| デスクトップデータプロファイル | 設定ファイルや共有 OpenCode サービスとは独立した、ネイティブウィンドウ、復元状態、ブラウザーストレージ。[デスクトップのウィンドウとデータ](desktop.md)を参照してください。 |
**統計** は、開いたフォルダーだけでなく、接続先の OpenCode サービス全体(すべてのプロジェクト、独立したクローン、サブセッション)を対象とし、過去 7、30、90、365 日を集計します。開いているプロジェクトが必要で、表示するのは OpenCode が記録したトークンとコストであり、プロバイダーの請求書やサブスクリプションの利用枠ではありません。更新中は、以前に保存した合計が表示される場合があります。プランの割り当て量は、ステータスの **使用量** セクションで確認します。
表示設定を変更しても、OpenCode の再起動やプロンプトの再実行は行いません。ネイティブ設定、サービス保守、認証情報の影響は別です。[OpenCode のセットアップ](opencode.md)、[プロバイダー](providers.md)、[連携](integrations.md)を参照してください。
## 言語と外観 {#language-appearance}
1. **一般** の **言語** で、英語、スペイン語、フランス語、ロシア語、日本語、簡体字中国語、ヘブライ語、ドイツ語、ネパール語、トルコ語を選びます。
2. **カラースキーム** で、**モード** に **自動**、**ダーク**、**ライト** を選びます。自動は OS に従います。
3. 表示中の外観のパレットを選びます。ライトとダークの選択は独立して保存され、自動では対応するものを使います。
4. 色をカスタマイズするには、色見本と **保存** を使います。**リセット** は組み込みパレットの色を復元します。別のパレットに名前を付けるには **新規**、自分で作成したパレットを削除するには **削除** を使用します。
UI は会話を再起動せずに更新されます。ヘブライ語では右から左のレイアウトを使い、コードや技術値はそれぞれの方向で読みやすく保ちます。言語選択はインターフェースのテキストを変えますが、既存メッセージやエージェント指示の言語は変えません。デスクトップのネイティブメニューは、CodeNomad のウィンドウが読み込まれるとインターフェースの言語に切り替わります。
色が読みにくくなったら、組み込みパレットを選ぶか編集したものをリセットします。パレットを切り替えると未保存の色編集を破棄するか確認する場合がありますが、会話の下書きは破棄しません。
## パネルとステータスのセクション {#panels-status}
固定されたパネルの内側の端をドラッグすると、サイズを変更できます。ポインターが端から外れても、ドラッグ中はハンドルの強調表示とポインターのキャプチャが維持されます。離すと終了します。
1. 外側のヘッダー隅の **左パネル** と **右パネル**、または **表示** メニュー内の項目で、それぞれを表示/非表示にします。
2. 右パネルの **右パネルをカスタマイズ** を開きます。チェックボックスで組み込みタブとステータスのセクションを選びます。ステータスの最低 1 セクションは表示されます。これらのチェックボックスの上をドラッグすると、まとめて設定できます。
3. 右パネルのタブをドラッグして並べ替えます。**リセット** で組み込みレイアウトの選択を復元します。
ステータスには、トークン情報、Yolo モード、プロバイダーの使用量、バックグラウンドシェル、MCP、プラグインがあります。会話に[目標](conversations.md#goal)がある間は、これらのセクションの上に目標の行が表示されます。この行はセクションではないため、非表示にも移動もできません。セクションを隠しても、サービスの無効化や権限の取り消しはしません。狭いレイアウトでは、会話を圧迫せず、収まらなくなったパネルを閉じます。そこで開いたパネルは会話の上に浮かび、一方のフローティングパネルを開くと他方は閉じます。
組み込みレイアウトはウィンドウのレイアウトであり、プロジェクトの変更操作ではありません。拡張機能のチェックボックスは異なり、その設定を使う全プロジェクトでコードを有効化します。**リセット** は拡張機能の同意を変更しません。[パネル拡張機能](extensions.md)を参照してください。
## 会話表示の詳細と入力欄のサイズ {#transcript-composer}
1. **チャット** を開いて会話表示の詳細の既定値を選びます。プリセットは **なし**、**最小**、**バランス**、**すべて** です。個別変更では **カスタム** になります。
2. 思考、診断、ツール入力、トークン、システムメッセージ、各ツールの種類について、行ごとの **既定の状態**(**非表示**、**折りたたみ**、**展開**)を設定するか、これらの選択を共有する会話の **メッセージの内容** ポップアップを使います。
3. **一般** で、必要に応じて **メッセージのタイムラインを表示**、**ツール呼び出しの差分を分割表示**、**送信したプロンプトをキューに入れる**(セッションの作業中に送信したプロンプトを、割り込ませずにキューに入れる)をオンにします。
4. サイズ変更コントロールで入力欄を調整します。長い下書きはフィールド内でスクロールします。
タイムラインには、会話に表示される返答・推論・ツール・コンパクト化・システムコンテキストごとに 1 つのマーカーが同じ順序で並びます。マーカーは **メッセージの内容** に従います。そこでツールの種類、推論、システムメッセージを非表示にするとそのマーカーも非表示になり(保留中の権限があるツールを除く)、**なし** ではすべてのツールマーカーが非表示になります。表示と展開の設定は、見せ方だけを変えます。保存済みのツール/推論の削除や、モデルコンテキストのコンパクト化はしません。破壊的な操作は、[履歴とクリーンアップ](history.md)を参照してください。
入力欄の高さは、ソフトウェアキーボードを含む可視の会話領域に従います。最小 8%(下限 44 px)、最大 60% です。手動の高さは比率として記憶され、狭い幅や長いテキストでも上限は上がりません。権限/質問を展開すると、保存した高さや下書きを変えずに入力欄を一時的に最小化します。リクエストを折りたたむか処理すると、サイズ変更を再開できます。
## 通知とバッジ {#notifications}
1. **通知** を開きます。通知の種類ごとに、表示先をチェックします。**画面**(一時的なバブル)、**履歴**(タブバー、macOS のデスクトップアプリではタイトルバーにあるベルの通知履歴に保持)、**システム**(OS の通知)です。ボックスの行または列の上をドラッグすると、まとめて設定できます。
2. **システム** のチェックボックスをオンにすると、必要に応じて許可を求めます。許可がない間は、**システム通知** の **リクエスト** で再度求められます。
3. このウィンドウにフォーカスがある間もシステム通知を受け取るには、**アプリにフォーカスがあるときも通知** を有効にします。無効のときは、ウィンドウが画面に開いたままでも、フォーカスがなければ通知が表示されます。
既定では、**セッションが応答を待っています** と **セッションが終了しました** はシステムにのみ送られるため、一時的なセッション状態が履歴にたまりません。これらはサブエージェントではなくメインセッションが対象で、自分で停止したセッションは通知されません。エラーは表の設定にかかわらず常に画面と履歴に表示され、短い進捗メッセージは画面にだけ表示されます。
ブラウザー/OS の権限は端末とアプリのオリジンに属し、保存した設定で拒否を上書きすることはできません。ブロックされている場合はブラウザーまたは OS の設定で通知を許可し、ここに戻ってください。未対応環境ではシステムの列は無効のままです。
ベル/履歴の未読件数(履歴に送られた通知だけを数えます)が、ブラウザーのファビコンの点とネイティブアプリのバッジに反映されます。ネイティブバッジは稼働中のメインウィンドウを集計します。実行中セッションの件数でも、OS 通知が配信された証拠でもありません。この機能は PWA ランチャーのバッジを提供しません。
## 詳細オプション {#advanced}
1. **詳細設定** を開きます。
2. 必要なオプションだけをオンまたはオフにします。各変更は CodeNomad 設定に保存されます。セッション実行環境を変える場合は、末尾の折りたたまれた **環境変数** グループを展開します。
3. 推測で共有サービスを再起動せず、表示結果や次の送信を確認します。
| オプション | 効果と注意 |
| --- | --- |
| 空のセッションを自動クリーンアップ | 新しいセッションの作成時に空のセッションを整理します。残したい場合はオフにします。 |
| サブエージェントの idle マーカーを保持 | 未確認の待機マーカーを 5 秒で隠さず、確認するまで保持します。 |
| 2 回目の起動で既存ウィンドウをフォーカス | ネイティブデスクトップのみ。アプリが起動中に再度起動したときのウィンドウ動作を変え、タブ作成は変えません。 |
| プロバイダーのクレジット残高 | 使用量に補足残高を表示します。クレジット購入やアカウント切り替えはしません。 |
| 空白のみの変更を非表示 | 空白/改行のみの未ステージファイルを変更一覧と一括操作から除外します。ステージ済みファイルは表示します。[ファイル](files.md)を参照してください。 |
| 長いアシスタント応答を保持 | ストリーミング返信が表示領域を超えると、自動追従を止めます。 |
| 環境変数 | 各プロンプトやセッションコマンドの前にサーバー側で適用します。読み取りだけで実行中の処理を更新しません。[OpenCode のセットアップ](opencode.md)を参照してください。 |
キーボード設定は[キーボードショートカット](shortcuts.md)、音声操作は[音声入力と再生](voice.md)を参照してください。起動時復元とデスクトップデータプロファイルは、[デスクトップのウィンドウとデータ](desktop.md)で説明しています。