ホワイトペーパー

このドキュメントでは、WSL Dashboard のアーキテクチャ設計、技術選択、および主要機能の基盤となる実装ロジックについて深く探り、開発者や高度なユーザーに技術的な深みのある視点を提供します。

1. アーキテクチャ概要

WSL Dashboard は、反応型 UI + 非同期バックエンドタスク の古典的なアーキテクチャを採用しています。Rust 言語の型システムと所有権モデルを活用し、メモリーセキュリティと高い並行パフォーマンスを保証しています。

コアコンポーネント

• フロントエンド (UI): Slint の宣言型インターフェースに基づいています。UI スレッドはレンダリングとユーザーインタラクションを担当します。
• バックエンド (Runtime): Tokio 非同期ランタイムに基づいています。システムコマンド (CLI) の分散と実行、ファイル I/O、ネットワークリスニングを担当します。
• 通信: UI スレッドと非同期タスクは、チャネル (MPSC) と 共有状態 (Arc/Mutex/RwLock) を通じて効率的かつスレッドセーフに通信します。

2. 技術選択の理由

なぜ Rust を選んだのか？

• パフォーマンス: ゼロコスト抽象化、ネイティブマシンコードへのコンパイル、GC ジッターなし。
• メモリーセキュリティ: コンパイル時にバッファーオーバーフローとデータ競合を排除します。これは、ディスク移行、ネットワーク設定などのシステム低レベル操作を伴うツールにとって非常に重要です。
• バイナリサイズ: すべての依存関係を静的にリンクし、単一ファイルのポータブル実行可能ファイルを生成します。

なぜ Slint + Skia を選んだのか？

• 宣言型構文: インターフェースの記述とロジックを分離し、コードの保守性を高めます。
• Skia レンダリング: GPU アクセラレーションを直接利用し（Skia エンジンを介して）、サブピクセル精度のテキストと滑らかなアニメーション効果を提供します。
• 低オーバーヘッド: Electron や WPF と比較して、Slint の実行時オーバーヘッドは最小限です。

3. 主要な技術的実装

3.1 WSL インスタンスの検出と解析

アプリケーションは、wsl.exe --list --verbose を呼び出し、その出力を解析することで（UTF-16 エンコーディングの処理を含む）、インスタンスの状態をリアルタイムで取得します。

• 基盤のデコード: 内部的に開発された効率的なエンコーディングデコーダーにより、異なる地域設定の Windows 環境でも出力が正しく解析されることを保証します。
• 状態の同期: スケジュールされたポーリング + 操作トリガーの二重同期メカニズムを採用しています。

3.2 ディスクイメージの移行 (VHDX Move)

移行機能は WSL のインポート/エクスポートメカニズムを利用していますが、高度に抽象化された原子的な処理を行います。

• トランザクション保障: 移行を開始する前に、アプリケーションは Mutex でターゲットディストリビューションをロックし、並行操作によるデータ損失を防止します。
• 自動登録: 移行が完了すると、アプリケーションは自動的に VHDX パスをリダイレクトし、ディストリビューションを再登録します。ユーザーの手動操作は不要です。

3.3 ポート転送とファイアウォールの自動化

ネットワーク機能は単なる netsh interface portproxy の呼び出しではありません。

• ルールのライフサイクル管理: アプリケーションは既存のファイアウォールルールを自動的に検出します。ユーザーが転送を作成すると、アプリケーションは Windows API または CLI を使用して受信例外ルールを同期的に作成します。
• IP の自動取得: wsl hostname -I の結果を解析することで、ホストとインスタンス間の仮想ネットワーク IP を自動的にマッピングします。

3.4 USBIP 統合

usbipd-win のコマンドラインインターフェースを利用しています。

• 権限昇格の処理: バインド操作には管理者権限が必要で、バックエンドロジックは UAC 昇格要求のエレガントな転送を実装しています。
• 状態マシン: 内部的に USB デバイス接続の状態マシンを維持し、Attach/Detach プロセスの追跡可能性を確保します。

3.5 リソースの監視と軽量化

アプリケーションは、Windows のネイティブ API（GetProcessMemoryInfo など）を呼び出して、自身のリソース使用量を監視します。

• 極限の軽量化: トレイのサイレントモードでは、アプリケーションは不要な UI リソースを積極的に解放します。英語などの標準文字セットの場合、メモリ使用量は 10MB 以下に抑えることができます。中国語、日本語、韓国語などの複雑な文字セットの場合は、より大きなフォントレンダリングキャッシュをロードする必要があるため、使用量は約 38MB 程度になります。

4. パフォーマンス最適化のメトリクス

メトリクス	目標/実測	最適化方法
起動速度	< 500ms	Slint インターフェースの事前コンパイル、実行時解析の削減。
ベースメモリ (トレイ)	~10MB	バックグラウンドポーリングの頻度を最小化、必要に応じてレンダリングキャッシュを解放。
CPU 使用量 (静止時)	< 0.1%	Windows のイベント駆動モデルを使用、空のループポーリングを回避。
レンダリング FPS	60 FPS	Skia GPU アクセラレーション、サブピクセルアンチエイリアスレンダリング。

5. バックエンドタスクの分散ロジック

UI の滑らかさを保証するため、すべての時間のかかる操作（VHDX のエクスポートなど）は非同期タスクを介して分散されます：

1. 要求のカプセル化: UI スレッドはユーザー操作を Command メッセージとしてカプセル化します。
2. メッセージチャネル: tokio::sync::mpsc を介してバックエンドのタスクプロセッサに送信されます。
3. 状態の返送: バックエンドタスクが完了すると、コールバックまたは状態共有を介して UI が更新されます。この設計により、数 GB のバックアップタスクを処理している場合でも、インターフェースはユーザーのクリックにリアルタイムで応答し続けることができます。

6. セキュリティの考慮事項

• 原子操作: 重要なインスタンスのアンインストールと移行には、事前チェックが実装されています。
• UAC 昇格の管理: 必要な場合（USB デバイスのバインドなど）にのみ権限を要求し、最小権限の原則に従います。
• ローカルストレージ: 設定は ~\.wsldashboard にのみローカルに保存され、クラウド同期は行われず、ユーザーのプライバシーが保護されます。