How htmnsrc/syscleanx works
SysCleanX is a Windows PC-cleaning desktop app. Users choose a tool in the GUI, inspect results, then confirm cleanup or another action; the clean path is orchestrated by the core engine, which resolves targets and performs guarded filesystem work. Other branches cover uninstall and leftovers, startup management, debloating, repair, disk usage, duplicates, and settings. GUI-to-core links beyond the sampled clean engine are documented capabilities, not verified calls; those links are dashed. The available excerpts do not establish every feature’s internal wiring.
Main entry points: app.rs App shell · engine.rs Scan and clean · fsops.rs Filesystem walker · broken.rs Broken-item repair
Components 31
Desktop interface
- App shell
crates/gui/src/app.rs - Background jobs
crates/gui/src/job.rs - Clean page
crates/gui/src/pages/cleaner.rs - Programs page
crates/gui/src/pages/uninstaller.rs - Startup page
crates/gui/src/pages/startup.rs - Debloat page
crates/gui/src/pages/debloat.rs - Repair page
crates/gui/src/pages/repair.rs - Disk explorer
crates/gui/src/pages/disk.rs - Duplicate finder
crates/gui/src/pages/duplicates.rs - Settings page
crates/gui/src/pages/settings.rs - Shared UI state
crates/gui/src/shared.rs - Theme system
crates/gui/src/theme.rs
Cleaning core
- Scan and clean
crates/core/src/engine.rs - Cleaning targets
crates/core/src/targets.rs - Target resolution
crates/core/src/resolve.rs - Filesystem walker
crates/core/src/fsops.rs - Safety guard
crates/core/src/guard.rs - Path resolution
crates/core/src/paths.rs
PC maintenance
- Program removal
crates/core/src/uninstall.rs - Startup entries
crates/core/src/startup.rs - Store app removal
crates/core/src/bloat.rs - Broken-item repair
crates/core/src/broken.rs - Disk usage scan
crates/core/src/diskusage.rs - Duplicate scan
crates/core/src/duplicates.rs - Special cleanups
crates/core/src/special.rs
Windows and state
- Windows API layer
crates/core/src/sys/mod.rs - Registry access
crates/core/src/reg.rs - Persistent settings
crates/core/src/settings.rs - Progress and cancel
crates/core/src/progress.rs - Deletion logs
crates/core/src/log.rs
Other components
- PC user
Connections 38
- PC user → App shell: opens
README.md - App shell → Clean page: shows
crates/gui/src/app.rs - App shell → Programs page: shows
crates/gui/src/app.rs - App shell → Startup page: shows
crates/gui/src/app.rs - App shell → Debloat page: shows
crates/gui/src/app.rs - App shell → Repair page: shows
crates/gui/src/app.rs - App shell → Disk explorer: shows
crates/gui/src/app.rs - App shell → Duplicate finder: shows
crates/gui/src/app.rs - App shell → Settings page: shows
crates/gui/src/app.rs - Clean page → Scan and clean: requests scans
- Programs page → Program removal: manages programs
- Startup page → Startup entries: manages entries
- Debloat page → Store app removal: removes apps
- Repair page → Broken-item repair: repairs leftovers
- Disk explorer → Disk usage scan: scans drives
- Duplicate finder → Duplicate scan: finds copies
- Settings page → Persistent settings: configures
- App shell → Shared UI state: creates state
crates/gui/src/app.rs - Scan and clean → Target resolution: resolves targets
crates/core/src/engine.rs - Scan and clean → Cleaning targets: uses definitions
crates/core/src/engine.rs - Scan and clean → Filesystem walker: scans and purges
crates/core/src/engine.rs - Scan and clean → Safety guard: checks paths
crates/core/src/engine.rs - Scan and clean → Progress and cancel: updates progress
crates/core/src/engine.rs - Scan and clean → Deletion logs: records deletions
crates/core/src/engine.rs - Filesystem walker → Safety guard: checks deletion
crates/core/src/fsops.rs - Filesystem walker → Deletion logs: records results
crates/core/src/fsops.rs - Target resolution → Path resolution: expands paths
crates/core/src/resolve.rs - Program removal → Registry access: reads registry
crates/core/src/uninstall.rs - Program removal → Filesystem walker: removes files
crates/core/src/uninstall.rs - Startup entries → Registry access: accesses entries
crates/core/src/startup.rs - Broken-item repair → Startup entries: checks startup
crates/core/src/broken.rs - Broken-item repair → Program removal: checks leftovers
crates/core/src/broken.rs - Broken-item repair → Filesystem walker: removes files
crates/core/src/broken.rs - Store app removal → Windows API layer: uses system APIs
crates/core/src/bloat.rs - Special cleanups → Windows API layer: uses Windows tools
crates/core/src/special.rs - Special cleanups → Registry access: accesses registry
crates/core/src/special.rs - Disk usage scan → Path resolution: uses path helpers
crates/core/src/diskusage.rs - Duplicate scan → Path resolution: uses path helpers
crates/core/src/duplicates.rs