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.
8.9 KiB
ネイティブ連携
CodeNomad は、OpenCode ネイティブの MCP 接続、プラグイン有効化、スキル、カスタムコマンドを提供します。これらは実行ホスト上で動きます。サンドボックス化されたパネル拡張機能や SideCarとは別です。
適切なコントロールを選ぶ
| 連携 | 操作する場所 | 変更するもの |
|---|---|---|
| MCP サーバー | ステータス → MCP サーバー | 表示された Location のネイティブ接続。サーバーはインストールしません。 |
| ネイティブプラグイン | ステータス → プラグイン | 永続的な グローバル または プロジェクト の有効化ルール。パッケージプラグインでは、そのパッケージの明示的な更新確認または更新。パッケージのインストールや削除はしません。 |
| スキル | 入力欄の @ メニュー |
会話の Location で、次のプロンプトへの明示的な添付。 |
| カスタムコマンド | 入力欄の / メニュー |
その Location に対して OpenCode が公開するコマンドを実行。 |
まず OpenCode がサポートする設定と CLI を使用して、連携を設定／インストールしてください。パッケージのインストール、ソースの宣言、ルールの有効化、サービスの接続、ツールの利用可能化は別の手順です。ネイティブ連携は、OpenCode の権限に従ってホストプロセスの権限を持ち、サンドボックス化された HTML パネルではありません。
MCP を接続・切断する
- OpenCode MCP ドキュメントに従い、OpenCode 実行ホストで MCP サーバーを設定します。
- プロジェクトの ステータス → MCP サーバー を開きます。
- サーバー横のスイッチで接続／切断し、接続表示が確定するまで待ちます。
スイッチは、報告された Location のネイティブ接続 API を呼び出します。端末ローカルのインストーラーや、ウィンドウごとの表示設定ではありません。その Location を使う他のクライアントにも接続変更が見える場合があります。切断してもサーバー宣言や実行ファイルは削除されません。
サーバーが表示されない場合は、アクティブな Location とそのネイティブ設定を確認します。接続に失敗したら、サーバー設定、必要な環境、ネイティブ認証フローを確認してください。スイッチが OAuth を完了させるとは想定しないでください。再接続後に状態を再確認します。設定の明示的な再読み込みは必要な場合だけ行い、OpenCode のセットアップに記載された中断に注意してください。
グローバル／プロジェクト範囲でプラグインを有効にする
- OpenCode でネイティブプラグインをインストール／宣言し、ステータス → プラグイン を開きます。
- 名前にカーソルを合わせるかフォーカスし、ソース、ランタイムの失敗、設定対象の詳細を確認します。
- グローバル または プロジェクト を意図的に切り替えます。書き込みを待ち、状態が不明なら プラグインコントロールを更新 を使用します。
- パッケージからインストールしたプラグインでは、名前の横のアイコンを使用します。そのメニューには正確な操作が表示されます。パッケージの … の更新を確認、または新しいバージョンが見つかった後の … を更新 です。
グローバルは、接続先デーモンが検出したグローバル設定を対象とします。プロジェクトは、継承した上位ファイルではなく、アクティブな Location 内の設定を対象とします。後のプロジェクトルールはグローバルを上書きできますが、グローバルのスイッチは、最終的なプロジェクト状態を装わず、グローバルのルールを表示します。プロジェクトルールがなければ、解決済みのグローバル状態を継承します。
これらのスイッチは、ソース宣言と無関係な設定を保持しつつ、正確な有効化ルールを追記します。プラグインのオプション編集、パッケージのインストール、ファイル削除はしません。OpenCode 組み込みプラグインには、ユーザー用の有効化スイッチを提供しません。対象をグローバルから安全に分離できない、またはアクティブな Location の外に出る場合、プロジェクトは無効になります。
パッケージの更新は、ツールチップに記載のとおり、OpenCode の共有キャッシュ内のそのパッケージを、それを使う全 Location について変更します。有効化ルールの変更、OpenCode の再起動、設定の再読み込みは行いません。ローカル、組み込み、SDK 提供のプラグインにはパッケージ操作がありません。プラグイン ID を報告する前に失敗したパッケージは、パッケージ名で一覧に表示され、ツールチップに失敗内容があり、更新確認／更新の操作はありますが、有効化スイッチはありません。更新確認や更新の失敗は報告され、自動的に再試行されることはありません。
この画面は、非表示中も直近のスナップショットを保持し、表示時、ネイティブ変更／再接続時、明示的更新時に再検証します。保存済みルールと稼働中の利用可否は、一時的に異なる場合があります。プラグインがまだ利用できない場合は、ツールチップとネイティブ設定を確認してから OpenCode の設定を再読み込み を選んでください。この操作はプラグインだけでなく、読み込み済みの全 Location に影響します。不正な設定や同時編集を無断で上書きしません。解決して更新し、明示的に再試行してください。
スキルを添付する
- 入力欄に
@を入力し、Location の利用可能なスキルを検索して選びます。 - ファイル／エージェントと並ぶ削除可能な添付を確認し、意図しない場合は送信前に削除します。
- プロンプトを送信します。スキルのラベルは送信済みメッセージに残ります。
選択は、ネイティブのスキル ID を添付して @query トークンを取り除きます。表示中の下書きに指示を貼り付けません。送信は入力欄の選択をクリアしますが、OpenCode がそのメッセージとともに既に保存した指示は消しません。添付の削除で以前の送信を取り消すことはできません。
スキルの利用可否は、CodeNomad 全体のスキルカタログではなく、会話の Location から取得します。一覧を読み込めない場合は、ピッカーを閉じて開き直して再試行します。空の場合はネイティブの検出／設定を確認してください。OpenCode スキルドキュメントと会話を参照してください。
カスタムコマンドを実行する
- 入力欄に
/を入力し、利用可能なネイティブコマンドを選びます。 - 引数を指定し、そのコマンドに応じて送信前に エージェント、モデル、思考 を確認します。
- 受け付けが不明な場合は、何度も送信せず、結果の会話を確認します。
コマンドはアクティブな Location の OpenCode から検出します。実行動作は、それぞれのネイティブ定義で選べます。メニューはパッケージインストーラーでも無制限の設定エディターでもありません。CodeNomad は、ネイティブのカスタムコマンド送信前にプロファイルのセッション環境を適用します。環境更新に失敗すると送信をブロックします。/btw は CodeNomad 独自の一時的な質問フローであり、通常のカスタムコマンドではありません。
コマンド定義とネイティブ設定の継承は、OpenCode コマンドドキュメントを参照してください。設定変更後は、まず関連画面を更新／開き直します。ランタイムがまだ必要とする場合にのみ、明示的な設定再読み込みを使用してください。表示更新のためだけに、受け付け済みかもしれないコマンドを再実行しないでください。