アーキテクチャ — デュアルプレーン通信

OxideTerm はターミナルデータとコントロールコマンドを 2 つの独立したプレーンに分離しています：

┌─────────────────────────────────────┐
│        Frontend (React 19)          │
│  xterm.js 6 (WebGL) + 19 stores     │
└──────────┬──────────────┬───────────┘
           │ Tauri IPC    │ WebSocket (binary)
           │ (JSON)       │ per-session port
┌──────────▼──────────────▼───────────┐
│         Backend (Rust)              │
│  NodeRouter → SshConnectionRegistry │
│  Wire Protocol v1                   │
│  [Type:1][Length:4][Payload:n]      │
└─────────────────────────────────────┘

• データプレーン（WebSocket）：各 SSH セッションが専用の WebSocket ポートを持ちます。ターミナルバイトは Type-Length-Payload ヘッダー付きのバイナリフレームとして転送されます — JSON シリアライズなし、Base64 エンコードなし、ホットパスのオーバーヘッドはゼロです。
• コントロールプレーン（Tauri IPC）：接続管理、SFTP 操作、フォワーディング、設定 — 構造化 JSON ですがクリティカルパスの外にあります。
• ノードファーストアドレッシング：フロントエンドは sessionId や connectionId を直接操作しません。すべてが nodeId で指定され、サーバーサイドの NodeRouter がアトミックに解決します。SSH 再接続で内部の connectionId が変わっても、SFTP、IDE、フォワードは一切影響を受けません。

🔩 純粋な Rust SSH — russh 0.59

SSH スタック全体が ring 暗号バックエンドでコンパイルされた russh 0.59 で構成されています：

• C/OpenSSL 依存ゼロ — 暗号スタック全体が Rust 実装。「どのバージョンの OpenSSL？」というデバッグが不要。
• 完全な SSH2 プロトコル：鍵交換、チャネル、SFTP サブシステム、ポートフォワーディング
• ChaCha20-Poly1305 および AES-GCM 暗号スイート、Ed25519/RSA/ECDSA キー
• カスタム AgentSigner：システム SSH Agent をラップし、russh の Signer トレイトを実装。.await をまたぐ際の RPITIT Send バウンド問題を、&AgentIdentity を所有値にクローンして解決

pub struct AgentSigner { /* wraps system SSH Agent */ }
impl Signer for AgentSigner { /* challenge-response via Agent IPC */ }

• プラットフォーム対応：Unix（SSH_AUTH_SOCK）、Windows（\\.\pipe\openssh-ssh-agent）
• プロキシチェーン：各ホップが独立して Agent 認証を使用
• 再接続：AuthMethod::Agent が自動的にリプレイ

🔄 Grace Period 付きスマート再接続

多くの SSH クライアントは切断時にすべてを終了して最初からやり直します。OxideTerm の再接続オーケストレーターは根本的に異なるアプローチを取ります：

1. 検出 WebSocket ハートビートタイムアウト（300 秒、macOS App Nap と JS タイマースロットリングに最適化）
2. スナップショット 完全な状態を取得：ターミナルペイン、転送中の SFTP、アクティブなポートフォワード、開いている IDE ファイル
3. インテリジェントプローブ：visibilitychange + online イベントがプロアクティブな SSH keepalive をトリガー（受動的な 15〜30 秒のタイムアウトに対し約 2 秒で検出）
4. Grace Period（30 秒）：旧 SSH 接続を keepalive でプローブ — 回復すれば（例：WiFi AP 切替）、TUI アプリ（vim、htop、yazi）は完全に無傷のまま生存
5. 回復に失敗した場合 → 新規 SSH 接続 → フォワードを自動復元 → SFTP 転送を再開 → IDE ファイルを再オープン

パイプライン：queued → snapshot → grace-period → ssh-connect → await-terminal → restore-forwards → resume-transfers → restore-ide → verify → done

すべてのロジックは専用の ReconnectOrchestratorStore を通じて実行されます — フックやコンポーネントに再接続コードは一切散在しません。

🛡️ SSH 接続プール

DashMap をバックエンドとした参照カウント方式の SshConnectionRegistry でロックフリーな並行アクセスを実現：

• 1 接続、複数コンシューマー：ターミナル、SFTP、ポートフォワード、IDE が 1 本の物理 SSH 接続を共有 — 冗長な TCP ハンドシェイク不要
• 接続ごとのステートマシン：connecting → active → idle → link_down → reconnecting
• ライフサイクル管理：設定可能なアイドルタイムアウト（5 分 / 15 分 / 30 分 / 1 時間 / 無制限）、15 秒の keepalive 間隔、ハートビート障害検出
• WsBridge ハートビート：30 秒間隔、5 分タイムアウト — macOS App Nap とブラウザの JS スロットリングに対応
• カスケード伝播：ジャンプホスト障害 → すべての下流ノードが自動的に link_down に、ステータス同期
• アイドル切断：フロントエンドに connection_status_changed を発行（内部の node:state だけではない）、UI の非同期を防止

🤖 OxideSens AI

プライバシーファーストの AI アシスタント、デュアルインタラクションモード：

• インラインパネル（⌘I）：素早いターミナルコマンド、出力はブラケットペーストで挿入
• サイドバーチャット：完全な履歴付きの永続的な会話
• Target-first ワークスペースコンテキスト：保存済み接続、ライブ SSH セッション、ターミナルバッファ、SFTP パス、設定、ナレッジベース項目をワークスペース対象として扱います
• 承認済みアクション：OxideTerm アカウントなしで、リモート出力の診断、承認済みコマンドの実行、ファイル確認、障害説明ができます
• MCP サポート：外部 Model Context Protocol サーバー（stdio & SSE）を接続してサードパーティツールを統合
• RAG ナレッジベース（v0.20）：Markdown/TXT ドキュメントをスコープ付きコレクション（グローバルまたは接続単位）にインポート。Reciprocal Rank Fusion で BM25 キーワードインデックス + ベクトルコサイン類似度のハイブリッド検索を融合。Markdown 対応のチャンキングで見出し階層を保持。CJK バイグラムトークナイザーで中国語/日本語/韓国語に対応。
• プロバイダー：OpenAI、Ollama、DeepSeek、OneAPI、または任意の /v1/chat/completions エンドポイント
• セキュリティ：API キーは OS キーチェーンに保存、macOS ではキー読み取りは LAContext 経由の Touch ID で認証ゲート — エンタイトルメントやコード署名は不要、セッションごとに初回認証後キャッシュ

ポートフォワーディング — ロックフリー I/O

完全な Local (-L)、Remote (-R)、Dynamic SOCKS5 (-D) フォワーディング：

• メッセージパッシングアーキテクチャ：SSH Channel は単一の ssh_io タスクが所有 — Arc<Mutex<Channel>> なし、ミューテックス競合を完全に排除
• 停止報告：フォワードタスクが終了理由（SSH 切断、リモートポートクローズ、タイムアウト）を能動的に報告し、明確な診断を提供
• 自動復元：Suspended 状態のフォワードは再接続時にユーザー操作なしで自動再開
• アイドルタイムアウト：FORWARD_IDLE_TIMEOUT（300 秒）でゾンビ接続の蓄積を防止

📦 trzsz — 帯域内ファイル転送

SFTP 接続不要で、SSH ターミナルセッションを通じて直接ファイルをアップロード・ダウンロード：

• 帯域内プロトコル：ファイルは既存のターミナルストリーム内で Base64 エンコードフレームとして転送——追加ポートやエージェント不要で ProxyJump チェインや tmux を透過的に通過
• 双方向転送：サーバーが tsz <file> を実行してクライアントへ送信；trz でクライアントアップロードを開始；ドラッグ&ドロップ対応
• ディレクトリ対応：trz -d / tsz -d による再帰的ディレクトリ転送
• 転送制限：セッションごとにチャンクサイズ、ファイル数、総バイト数の上限を設定可能
• ネイティブ Tauri I/O：ファイルの読み書きは Tauri ネイティブファイルダイアログと Rust I/O を使用——ブラウザのメモリ制限なし
• リアルタイム通知：転送開始・完了・キャンセル・エラーの Toast 通知——trzsz を検出したが機能が無効の場合もヒントを表示
• 設定 → ターミナル → 帯域内転送 で有効化

🔌 ランタイムプラグインシステム

セキュリティ強化された凍結 API サーフェスを持つ動的 ESM ローディング：

• PluginContext API：18 の名前空間 — terminal、ui、commands、settings、lifecycle、events、storage、system
• 24 の UI Kit コンポーネント：プラグインサンドボックスに window.__OXIDE__ 経由で注入されるビルド済み React コンポーネント（ボタン、入力、ダイアログ、テーブル…）
• セキュリティメンブレン：すべてのコンテキストオブジェクトに Object.freeze、Proxy ベースの ACL、IPC ホワイトリスト、繰り返しエラー時の自動無効化付きサーキットブレーカー
• 共有モジュール：React、ReactDOM、zustand、lucide-react がプラグイン用に公開され、重複バンドルを回避

⚡ アダプティブレンダリング

固定の requestAnimationFrame バッチ処理を置き換える 3 段階レンダースケジューラー：

遷移は完全に自動 — データ量、ユーザー入力、Page Visibility API に基づいて駆動。バックグラウンドタブは RAF を起動せずアイドルタイマーでデータをフラッシュし続けます。

🔐 .oxide 暗号化エクスポート

ポータブルで改ざん防止の接続バックアップ：

• ChaCha20-Poly1305 AEAD 認証付き暗号化
• Argon2id KDF：メモリコスト 256 MB、4 イテレーション — GPU ブルートフォース耐性
• SHA-256 整合性チェックサム
• オプションの鍵埋め込み：秘密鍵を Base64 エンコードして暗号化ペイロードに含める
• プリフライト分析：認証タイプの内訳、エクスポート前の不足キー検出

📡 ProxyJump — トポロジー対応マルチホップ

• 無制限のチェーン深度：Client → Jump A → Jump B → … → Target
• ~/.ssh/config を自動解析、トポロジーグラフを構築、Dijkstra 経路探索で最適ルートを決定
• ジャンプノードを独立セッションとして再利用可能
• カスケード障害伝播：ジャンプホストのダウン → すべての下流ノードを自動的に link_down に設定

⚙️ ローカルターミナル — スレッドセーフ PTY

portable-pty 0.8 によるクロスプラットフォームローカルシェル、local-terminal フィーチャーゲート：

• MasterPty は std::sync::Mutex でラップ — 専用 I/O スレッドでブロッキング PTY 読み取りを Tokio イベントループから分離
• シェル自動検出：zsh、bash、fish、pwsh、Git Bash、WSL2
• cargo build --no-default-features で PTY を除外し、モバイル/軽量ビルドに対応

🪟 Windows 最適化

• ネイティブ ConPTY：Windows Pseudo Console API を直接呼び出し — フル TrueColor と ANSI サポート、レガシー WinPTY 不要
• シェルスキャナー：レジストリと PATH から PowerShell 7、Git Bash、WSL2、CMD を自動検出

その他の機能

• IDE モード：SFTP 経由の CodeMirror 6、24 言語、Git ステータス付きファイルツリー、マルチタブ、競合解決——Linux では機能強化のためオプションのリモートエージェント（~1 MB）が利用可能
• リソースプロファイラー：永続 SSH チャネルで /proc/stat を読み取り、デルタベース計算でリアルタイム CPU/メモリ/ネットワーク監視、非 Linux では RTT のみに自動縮退
• カスタムテーマエンジン：30 以上の内蔵テーマ、ライブプレビュー付きビジュアルエディター、20 の xterm.js フィールド + 24 の UI カラー変数、ターミナルパレットから UI カラーを自動導出
• セッション録画：asciicast v2 形式、完全な録画と再生
• ブロードキャスト入力：一度入力するとすべての分割ペインに送信 — バッチサーバー操作
• 背景ギャラリー：タブごとの背景画像、16 のタブタイプ、不透明度/ぼかし/フィットコントロール
• CLI コンパニオン（oxt）：約 1 MB のバイナリ、JSON-RPC 2.0 over Unix Socket / Named Pipe、status/health/list/forward/config/connect/focus/attach/SFTP/import/AI をヒューマンまたは --json 出力
• WSL Graphics ⚠️ 実験的：内蔵 VNC ビューア — 9 つのデスクトップ環境 + 単一アプリモード、WSLg 検出、Xtigervnc + noVNC