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.
6.8 KiB
サポートとソースビルド
不具合報告、最新リリース、貢献にはリポジトリを使用します。問題を報告する前の安全な復旧方法は、トラブルシューティングガイドを参照してください。
不具合を報告する
- 設定 → 情報 → 診断 を開きます。
- バグを報告 を選んで GitHub の Issue フォームを開きます。
- 事前入力されたバージョン／クライアント情報を確認します。最小の再現手順、期待する動作、実際の結果を追加し、GitHub から送信します。
この操作は、CodeNomad と OpenCode のバージョン（インストール済みと異なる場合は稼働中の OpenCode サービスのバージョンを含む）、お使いの OS、クライアントの種類（ウェブブラウザーではブラウザーのユーザーエージェントを含む）、サーバーの OS を事前入力します。リスナーアドレス、ワークスペースパス、認証情報、会話テキストは事前入力しません。フォームを開くことは、Issue の送信ではありません。
より詳しい診断が必要なら、クリップボードにコピー または .txt をダウンロード で別のレポートを作れます。詳細レポートはローカルパスとネットワークアドレスを含む場合があるため、添付前に確認して伏せ字にしてください。自動診断レポートが認証の秘密情報を除いていても、スクリーンショットやログ抜粋には秘密が含まれる場合があります。
GitHub フォームに互換性のないフィールドがある場合は、同じレポート情報を付けた通常の Issue を開きます。フォーム読み取りの一時的な失敗は、フォームを開く妨げにはなりません。いつでも手動で Issue 一覧を使用できます。
コミュニティとリリース
| リソース | 用途 |
|---|---|
| CodeNomad リポジトリ | ソース、プロジェクトの活動、ドキュメント。 |
| Issue | 再現可能な不具合や機能要望を投稿する前に、既存の報告を検索します。 |
| プルリクエスト | 提案された変更のレビューや、貢献の調整。 |
| 最新リリース | 安定版のダウンロード資産。 |
| 全リリース | 公開済みプレビューとリリースノート。 |
| Neural Nomads | プロジェクト組織。 |
| MIT ライセンス | ライセンス条項。 |
CodeNomad の操作ではなく、OpenCode ネイティブ設定の問題は、OpenCode ドキュメントと上流リリースを参照してください。
ソースからビルドする
.node-version に固定された Node.js 24.20.0、npm、Git、互換性のある OpenCode CLI を使用します。開発用チェックアウトから実行します。
git clone --branch dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev
npm run dev は Electron 開発ホストを起動します。Tauri を使う場合は、まず Rust ツールチェーンを含むプラットフォームのビルド前提条件をインストールし、次を実行します。
npm run dev:tauri
開発上の変更は開発ホストに影響しますが、独立して動く OpenCode デーモンのインストール済みバージョンには影響しません。ネイティブのパッケージ化には対象に合ったツールが必要です。対象 OS 上のビルドを優先してください。
ビルドと検証
| リポジトリルートから実行するコマンド | 目的 |
|---|---|
npm run build |
Electron アプリケーションのリソースをビルド。 |
npm run build:tauri |
ネイティブの前提条件を使用して Tauri アプリをビルド。 |
npm run build:ui |
ブラウザー UI をビルド。 |
npm run build --workspace @neuralnomads/codenomad |
スタンドアロンサーバーと同梱資産をビルド。 |
npm run build:linux --workspace @neuralnomads/codenomad-electron-app |
Electron の Debian リリースをパッケージ化。 |
npm exec --workspace @codenomad/tauri-app -- tauri build --bundles appimage |
Linux Tauri AppImage をパッケージ化。 |
npm run typecheck |
ルートで設定された TypeScript ワークスペースをチェック。 |
npm run test:help |
公開ヘルプの全言語とリンクを検証。 |
npm run build:help |
スタンドアロンの公開ヘルプを dist/help にビルド。 |
ヘルプのビルドに、稼働中の CodeNomad や OpenCode サービスは不要です。パッケージ化の詳細は BUILD.md、対象を絞った検証と PR の規約は CONTRIBUTING.md を参照してください。対象パッケージに実際に存在するスクリプトを使用します。
パッケージ構成と貢献
| パッケージ | 役割 |
|---|---|
packages/server |
ワークスペース／API／Git の制御、OpenCode 接続、認証、イベント、音声。 |
packages/ui |
SolidJS のワークスペース、操作 UI、翻訳、ブラウザーヘルプの入口。 |
packages/electron-app |
Electron のウィンドウ、ネイティブ連携、パッケージ化。 |
packages/tauri-app |
Tauri のウィンドウ、プラットフォーム連携、パッケージ化。 |
packages/remote-tunnel |
バックエンド側の OpenTunnel 通信ランタイム。 |
- 重複する作業を実装する前に、関連 Issue で範囲を相談します。
devからブランチを作り、変更を絞ります。- 影響範囲のチェックを実行し、動作とともにユーザーヘルプも更新し、PR の宛先を
devにします。
公開ヘルプのソースは docs/help/<locale>/ にあります。各言語で英語見出しの明示的な ID、レベル、順序を保持してください。見出しの翻訳でディープリンクを壊してはいけません。厳格な完全性チェックと静的公開パイプラインは、ヘルプ保守の契約で説明しています。