# luolangaga/tubatools architecture

> Architecture diagram of the GitHub repository luolangaga/tubatools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luolangaga/tubatools
- Repository: https://github.com/luolangaga/tubatools
- Video tour (about a minute): https://gitdiagram.com/luolangaga/tubatools/video

## Overview

TubaWinUI3 is a Windows desktop toolbox for hardware inspection, benchmarking, system maintenance, networking, conversion, and gaming utilities. The main workflow is to browse or search the shared tool catalog, open a tool, and view results or perform an operation. Distinct branches cover AI-assisted computer operations, hardware and game monitoring, system/security maintenance, and conversion/network utilities. The graph uses README-described capabilities and paths in the supplied tree; sampled source excerpts are incomplete, so uncertain internal wiring is omitted.

Main entry points: [`TubaWinUi3.WinUI3/MainWindow.xaml.cs`](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/MainWindow.xaml.cs) (Main window), [`TubaWinUi3.WinUI3/Services/Agent/AgentRuntime.cs`](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/Agent/AgentRuntime.cs) (Agent runtime), [`TubaWinUi3.WinUI3/Pages/RogueCleanerPage.xaml.cs`](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/RogueCleanerPage.xaml.cs) (Maintenance pages), [`TubaWinUi3.WinUI3/Pages/AiAgentPage.xaml.cs`](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/AiAgentPage.xaml.cs) (AI assistant UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Toolbox experience"]
  node_main["Main window<br/>[MainWindow.xaml.cs]"]
  node_catalog["Tool catalog<br/>[ToolCatalog.cs]"]
  node_toolpages["Tool pages<br/>[Pages]"]
end

subgraph group_assistant["AI assistant"]
  node_agentpage["AI assistant UI"]
  node_agentruntime["Agent runtime<br/>[AgentRuntime.cs]"]
  node_agenttools["Agent tools<br/>[Tools]"]
  node_aiproviders["AI providers<br/>[Ai]"]
end

subgraph group_hardware["Hardware and gaming"]
  node_hardwareui["Hardware pages"]
  node_hardwareinfo["Hardware service"]
  node_benchmarks["Benchmark services"]
  node_gameui["Game monitor UI"]
  node_gamemonitor["Game monitor"]
  node_gamedata["Game records"]
end

subgraph group_maintenance["System and security"]
  node_maintui["Maintenance pages"]
  node_roguescan["Rogue cleaner scan<br/>[ScannerEngine.cs]"]
  node_rogueclean["Cleanup and restore<br/>[CleanerEngine.cs]"]
end

subgraph group_utilities["Utilities and network"]
  node_convertui["Converter page"]
  node_docengine["Document engine"]
  node_networkui["Network pages"]
  node_speedengine["Speed test engine<br/>[SpeedTestEngine.cs]"]
end

node_user(("User"))
node_aiendpoint{{"AI service"}}
node_windowsstate{{"Windows system"}}
node_network{{"Test endpoints"}}

node_user -->|"uses"| node_main
node_main -->|"browses"| node_catalog
node_main -->|"opens"| node_toolpages
node_user -->|"asks"| node_agentpage
node_agentpage -->|"sends prompt"| node_agentruntime
node_agentruntime -->|"requests completion"| node_aiproviders
node_aiproviders -->|"sends request"| node_aiendpoint
node_agentruntime -->|"dispatches calls"| node_agenttools
node_agenttools -->|"operates on"| node_windowsstate
node_user -->|"inspects"| node_hardwareui
node_hardwareui -->|"reads metrics"| node_hardwareinfo
node_user -->|"runs tests"| node_benchmarks
node_user -->|"configures overlay"| node_gameui
node_gameui -->|"records metrics"| node_gamemonitor
node_gamemonitor -->|"writes records"| node_gamedata
node_user -->|"maintains system"| node_maintui
node_maintui -->|"scans system"| node_roguescan
node_maintui -->|"cleans or restores"| node_rogueclean
node_roguescan -->|"inspects"| node_windowsstate
node_rogueclean -->|"changes state"| node_windowsstate
node_user -->|"converts files"| node_convertui
node_convertui -->|"converts documents"| node_docengine
node_user -->|"tests network"| node_networkui
node_networkui -->|"measures throughput"| node_speedengine
node_speedengine -->|"exchanges traffic"| node_network

click node_main "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/MainWindow.xaml.cs"
click node_catalog "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/ToolCatalog.cs"
click node_toolpages "https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Pages"
click node_agentpage "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/AiAgentPage.xaml.cs"
click node_agentruntime "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/Agent/AgentRuntime.cs"
click node_agenttools "https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Services/Agent/Tools"
click node_aiproviders "https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Services/Ai"
click node_hardwareui "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/HardwarePage.xaml.cs"
click node_hardwareinfo "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/HardwareInfoService.cs"
click node_benchmarks "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/PerformanceBenchmarkService.cs"
click node_gameui "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/GameOverlayPage.xaml.cs"
click node_gamemonitor "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/GameMonitorRecorder.cs"
click node_gamedata "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/GameMonitorRecordReader.cs"
click node_maintui "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/RogueCleanerPage.xaml.cs"
click node_roguescan "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/RogueCleaner/ScannerEngine.cs"
click node_rogueclean "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/RogueCleaner/CleanerEngine.cs"
click node_convertui "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/FormatConverterPage.xaml.cs"
click node_docengine "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/DocumentEngineService.cs"
click node_networkui "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/SpeedTestPage.xaml.cs"
click node_speedengine "https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/SpeedTestEngine.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_catalog,node_toolpages,node_user toneBlue
class node_agentpage,node_agentruntime,node_agenttools,node_aiproviders toneAmber
class node_hardwareui,node_hardwareinfo,node_benchmarks,node_gameui,node_gamemonitor,node_gamedata toneMint
class node_maintui,node_roguescan,node_rogueclean toneRose
class node_convertui,node_docengine,node_networkui,node_speedengine,node_aiendpoint,node_windowsstate,node_network toneIndigo
```

## Components

### Toolbox experience

- [Main window](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/MainWindow.xaml.cs): `TubaWinUi3.WinUI3/MainWindow.xaml.cs`
- [Tool catalog](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/ToolCatalog.cs): `TubaWinUi3.WinUI3/Services/ToolCatalog.cs`
- [Tool pages](https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Pages): `TubaWinUi3.WinUI3/Pages`

### AI assistant

- [AI assistant UI](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/AiAgentPage.xaml.cs): `TubaWinUi3.WinUI3/Pages/AiAgentPage.xaml.cs`
- [Agent runtime](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/Agent/AgentRuntime.cs): `TubaWinUi3.WinUI3/Services/Agent/AgentRuntime.cs`
- [Agent tools](https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Services/Agent/Tools): `TubaWinUi3.WinUI3/Services/Agent/Tools`
- [AI providers](https://github.com/luolangaga/tubatools/tree/master/TubaWinUi3.WinUI3/Services/Ai): `TubaWinUi3.WinUI3/Services/Ai`

### Hardware and gaming

- [Hardware pages](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/HardwarePage.xaml.cs): `TubaWinUi3.WinUI3/Pages/HardwarePage.xaml.cs`
- [Hardware service](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/HardwareInfoService.cs): `TubaWinUi3.WinUI3/Services/HardwareInfoService.cs`
- [Benchmark services](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/PerformanceBenchmarkService.cs): `TubaWinUi3.WinUI3/Services/PerformanceBenchmarkService.cs`
- [Game monitor UI](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/GameOverlayPage.xaml.cs): `TubaWinUi3.WinUI3/Pages/GameOverlayPage.xaml.cs`
- [Game monitor](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/GameMonitorRecorder.cs): `TubaWinUi3.WinUI3/Services/GameMonitorRecorder.cs`
- [Game records](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/GameMonitorRecordReader.cs): `TubaWinUi3.WinUI3/Services/GameMonitorRecordReader.cs`

### System and security

- [Maintenance pages](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/RogueCleanerPage.xaml.cs): `TubaWinUi3.WinUI3/Pages/RogueCleanerPage.xaml.cs`
- [Rogue cleaner scan](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/RogueCleaner/ScannerEngine.cs): `TubaWinUi3.WinUI3/Services/RogueCleaner/ScannerEngine.cs`
- [Cleanup and restore](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/RogueCleaner/CleanerEngine.cs): `TubaWinUi3.WinUI3/Services/RogueCleaner/CleanerEngine.cs`

### Utilities and network

- [Converter page](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/FormatConverterPage.xaml.cs): `TubaWinUi3.WinUI3/Pages/FormatConverterPage.xaml.cs`
- [Document engine](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/DocumentEngineService.cs): `TubaWinUi3.WinUI3/Services/DocumentEngineService.cs`
- [Network pages](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Pages/SpeedTestPage.xaml.cs): `TubaWinUi3.WinUI3/Pages/SpeedTestPage.xaml.cs`
- [Speed test engine](https://github.com/luolangaga/tubatools/blob/master/TubaWinUi3.WinUI3/Services/SpeedTestEngine.cs): `TubaWinUi3.WinUI3/Services/SpeedTestEngine.cs`

### Other components

- **User**
- **AI service**
- **Windows system**
- **Test endpoints**

## Connections

- User → Main window: uses
- Main window → Tool catalog: browses
- Main window → Tool pages: opens
- User → AI assistant UI: asks
- AI assistant UI → Agent runtime: sends prompt
- Agent runtime → AI providers: requests completion
- AI providers → AI service: sends request
- Agent runtime → Agent tools: dispatches calls
- Agent tools → Windows system: operates on
- User → Hardware pages: inspects
- Hardware pages → Hardware service: reads metrics
- User → Benchmark services: runs tests
- User → Game monitor UI: configures overlay
- Game monitor UI → Game monitor: records metrics
- Game monitor → Game records: writes records
- User → Maintenance pages: maintains system
- Maintenance pages → Rogue cleaner scan: scans system
- Maintenance pages → Cleanup and restore: cleans or restores
- Rogue cleaner scan → Windows system: inspects
- Cleanup and restore → Windows system: changes state
- User → Converter page: converts files
- Converter page → Document engine: converts documents
- User → Network pages: tests network
- Network pages → Speed test engine: measures throughput
- Speed test engine → Test endpoints: exchanges traffic