Whitepaper

Detta dokument ger en fördjupad inblick i den arkitektoniska designen, teknologivalen och den underliggende implementationslogiken för nyckelfunktioner i WSL Dashboard, avsett för utvecklare och avancerade användare som söker ett tekniskt perspektiv.

1. Arkitektu­röversikt

WSL Dashboard antar en klassisk reaktiv UI-driven + asynkron backend-uppgift-arkitektur, som utnyttjar Rusts typsystem och ägandemodell för att garantera minnessäkerhet och hög prestanda vid samtidighet.

Kärnkomponenter

• Frontend (UI): Byggt på Slint deklarativt gränssnitt. UI-tråden är ansvarig för rendering och användarinteraktion.
• Backend (Runtime): Byggt på Tokio asynkron runtime. Ansvarig för att skicka och utföra systemkommandon (CLI), fil-I/O och nätverkslyssnare.
• Kommunikation: UI-tråden och asynkrona uppgifter kommunicerar effektivt och trådsäkert via Kanaler (MPSC) och Delat tillstånd (Arc/Mutex/RwLock).

2. Teknologisk motivering

Varför Rust?

• Prestanda: Nollkostnadsabstraktioner, kompilerad till maskinkod, inga GC-pauser.
• Minnessäkerhet: Eliminerar buffertöverflöden och datalopp vid kompilering — kritiskt för ett verktyg som opererar på systemnivå (diskmigrering, nätverkskonfiguration).
• Binärstorlek: Statiskt länkar alla beroenden för att producera en enskild portabel körbar fil.

Varför Slint + Skia?

• Deklarativ syntax: Åtskild UI-beskrivning från logik, håller kodbasen ren och underhållbar.
• Skia-rendering: Utökar GPU-acceleration direkt (via Skia-motorn), ger sub-pixel textklarhet och smidiga animationer.
• Låg overhead: Jämfört med Electron eller WPF är Slints runtime-avtryck minimalt.

3. Viktiga tekniska implementationer

3.1 WSL-instansdetektering och -parsing

Appen hämtar realtidsinstansstatus genom att anropa wsl.exe --list --verbose och analysera dess utdata (hantering av UTF-16-kodning).

• Lågnivå-avkodning: En specialbyggd, effektiv encoder/decoder säkerställer korrekt utdataparsing i olika Windows-miljöer med olika regionala inställningar.
• Tillståndssynkronisering: Använder en dubbel synkroniseringsmekanism av tidsbestämd polling kombinerad med operationsutlösta uppdateringar.

3.2 Diskbildsmigrering (VHDX-förflyttning)

Migreringsfunktionen utnyttjar WSL:s import/export-mekanism, men med en hög abstraktionsnivå och atomitet.

• Transaktionsgaranti: Innan migreringen påbörjas låser appen måldistributionen via en Mutex för att förhindra att samtidiga operationer orsakar datakorruption.
• Automatisk registrering: När migreringen är slutförd omdirigerar appen automatiskt VHDX-sökvägen och registrerar om distributionen — ingen manuell åtgärd krävs.

3.3 Vidarebefordring av portar och brandväggsautomatisering

Nätverksfunktionen går utöver ett enkelt netsh interface portproxy-anrop.

• Regler för livscykelhantering: Appen upptäcker automatiskt befintliga brandväggsregler. När en användare skapar en vidarebefordringsregel skapar den samtidigt ett inkommande undantag via Windows API eller CLI.
• Automatisk IP-upplösning: Genom att analysera utdata från wsl hostname -I mappar den automatiskt virtuella nätverks-IP:er mellan värd och instans.

3.4 USBIP-integration

Utnyttjar usbipd-win kommandoradsgränssnitt.

• Upphöjningshantering: Bind-operationer kräver administratörsrättigheter. Backend implementerar elegant UAC-upphöjningsförfråganvidarebefordran.
• Tillståndsmaskin: Upprätthåller en intern USB-enhetstillståndsmaskin för att säkerställa fullständig spårbarhet av Attach/Detach-operationer.

3.5 Resursövervakning och minimalt avtryck

Appen övervakar sin egen resursanvändning genom att anropa inbyggda Windows API:er (t.ex. GetProcessMemoryInfo).

• Extrem effektivitet: I tysta lägsta-läge frigör appen proaktivt onödiga UI-resurser. För standard teckenuppsättningar (t.ex. engelska) kan minnesanvändningen vara så låg som 10MB; för komplexa teckenuppsättningar (t.ex. CJK) är det ungefär 38MB på grund av den större typsnittscachen.

4. Prestationsmätningar

Mätning	Mål / Mätt	Optimeringsansats
Starttid	< 500ms	Förkompilerat Slint-gränssnitt, minimering av runtime-parsing.
Grundminne (låda)	~10MB	Minimerad bakgrundspollingfrekvens, on-demand frigöring av rendercache.
CPU-användning (inaktiv)	< 0.1%	Windows händelsedriven modell, ingen busy-loop polling.
Renderingsbildfrekvens	60 FPS	Skia GPU-acceleration, sub-pixel antialiasing rendering.

5. Backend-uppgiftsdispatchlogik

För att säkerställa UI-responsivitet skickas alla tidskrävande operationer (t.ex. VHDX-export) som asynkrona uppgifter:

1. Förfrågans inkapsling: UI-tråden inkapslar användaråtgärder i Command-meddelanden.
2. Meddelandekanal: Skickar dem till bakgrundsuppgiftshanteraren via tokio::sync::mpsc.
3. Tillståndscallback: När bakgrundsuppgiften är slutförd uppdaterar den UI via en callback eller delat tillstånd. Denna design säkerställer att även under bearbetning av en flera gigabyte stor säkerhetskopieringsuppgift förblir gränssnittet helt responsivt mot användarinmatning.

6. Säkerhetsöverväganden

• Atomaire operationer: Förvalidering är implementerad för kritiska instansavregistrerings- och migreringsoperationer.
• UAC-upphöjningshantering: Upphöjda rättigheter begärs bara vid behov (t.ex. vid bindning av en USB-enhet), i enlighet med principen om minimala privilegier.
• Lokal lagring: Konfiguration sparas bara i den lokala ~\.wsldashboard-mappen utan någon form av molnsynkronisering, vilket skyddar användarens integritet.