1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
7.1 KiB
モバイルと PWA
スマートフォンやタブレットのブラウザー UI から、バックエンドホスト上の作業を続けられます。PWA のインストールで変わるのは UI の開き方であり、プロジェクト、認証情報、エージェント実行の場所ではありません。
スマートフォンやタブレットから接続する
- ホストで 設定 → リモートアクセス → リモートコントロール を開き、リモートコントロールを開始 を選びます。
- モバイル端末でペアリング QR コードを読み取り、今後も使う予定のブラウザーでリンクを開きます。
- または、直接アクセスを設定し、ホストの到達可能な信頼済み HTTPS URL を開き、サーバーパスワードでログインします。
リモートコントロールには端末のペアリングが、直接接続には経路、到達可能なリスナー、認証が必要です。スマートフォンからワークステーションに接続するために localhost を使わないでください。サイトデータの消失やブラウザープロファイルの変更では、再ログインや再ペアリングが必要になる場合があります。リモートコントロールを参照してください。
PWA をインストールする
- インストールに対応したブラウザーで、動作する CodeNomad URL を信頼された HTTPS で開きます。
- Chrome/Edge などでは、アドレスバーのインストール操作や、表示された場合はブラウザーの Install CodeNomad を使用します。iPhone/iPad の Safari では Share → Add to Home Screen を使用します。正確な表記は OS／ブラウザーによって異なります。
- 新しいランチャーを開き、ブラウザーストレージが別の場合は、そこでログインやペアリングを完了します。
インストールは、端末／ブラウザーとオリジンごとです。スマートフォンに Node、Git、OpenCode をインストールしたり、バックエンドを起動したり、ネイティブデスクトップ連携を許可したりはしません。ランチャーを削除してもホストの会話は削除されません。アクセスを解除するときは、別途ペアリング済み端末を取り消してください。
安全なコンテキストと証明書
リモートの PWA インストールとマイクアクセスには、ブラウザーが認める安全なコンテキストが必要です。正確なホスト名／IP に合う、信頼された HTTPS 証明書を使用してください。生成されたローカル証明書は、クライアント端末／ブラウザーで明示的に信頼する必要があります。警告ページやその回避は、確実なインストール環境ではありません。ブラウザーの localhost 例外はその端末に適用され、別ホストの HTTP LAN アドレスには適用されません。
インストール操作が見つからない場合は、まず HTTPS の信頼とブラウザーの対応を確認し、QR／アプリ内の埋め込みブラウザーではなく、通常のブラウザーで開き直します。マイクの失敗では、ブラウザー／OS のサイト権限と音声を確認します。インストールを直すために認証や TLS 検証をオフにしないでください。
タッチ向けレイアウトで作業する
左パネル と 右パネル のコントロールで、ナビゲーションとツールを開きます。狭いレイアウトでは、デスクトップ幅のキャンバスを強制せず、パネルは会話の上に重なります。一方のフローティングパネルを開くと、他方は閉じます。会話ヘッダーの操作は、領域が限られるとオーバーフローメニューに移ります。
入力欄ではエージェント、モデル、思考をフッターに保ちます。フィールドは画面キーボードを含む可視の会話領域に合わせてサイズが変わり、長い下書きはスクロールできます。タッチ操作のみの端末では、送信しても画面キーボードは再表示されないため、応答を読めます。続けるには入力欄をタップします。セッションの実行中は、入力欄の その他の操作 メニューに、通常の送信とは異なる方の メッセージをキューに追加 または 今すぐ割り込む が表示され、ハードウェアキーボードのショートカットは不要です。割り込みを開くと、保存した高さや下書きを変えずに入力欄を一時的に縮めます。その上のドックで権限／質問に回答し、ドックの操作フッターに届くようにしてください。会話と権限を参照してください。
機能と接続の制限
| 機能 | モバイルブラウザー／PWA |
|---|---|
| プロジェクト、会話、ファイル、権限 | 接続先バックエンドホスト上で、そのアクセス制御に従って操作します。端末添付はスマートフォンからアップロードし、プロジェクト参照はホストで解決します。 |
| ネイティブデスクトップウィンドウ、OS メニュー、ホストのネイティブ自動操作 | PWA をインストールしても提供されません。 |
| ブラウザープレビュー | ネイティブのゲストブラウザー機能は獲得しません。代替描画はブラウザーの制限を受けます。 |
| SideCar のコンテンツと WebSocket | 接続経路に依存します。リモートコントロールは SideCar コンテンツプロキシ、プレビュー内容、WebSocket アップグレードをブロックします。正確な制限を参照してください。 |
| マイク、クリップボード、通知、インストール案内 | ブラウザー／OS の対応、安全なコンテキスト、ユーザー権限に依存します。 |
| オフライン作業 | オフラインのバックエンドや API 履歴キャッシュはありません。静的 UI 資産はキャッシュされる場合がありますが、文書と API 応答はオフラインのワークスペースではありません。 |
バックエンドを到達可能に保ってください。モバイル OS の一時停止やネットワーク切り替えは、イベントストリームを切断する場合があります。戻ると再接続して現在の状態を取得しますが、イベントの再生は保証されません。再試行前に操作が完了したか確認してください。PWA を閉じてもスタンドアロンバックエンドは停止しません。ホストのデスクトップアプリとバックエンドを終了すると、次の起動までリモートコントロールは利用できなくなります。