FileSniffer QT
Vyhledávání souborů podle přípon. Scan disků, exclude patterns, export CSV.
Co projekt řeší
FileSniffer QT je nástroj pro audit a řízené vytěžení souborů z velkých stromů adresářů. Kombinuje scan podle přípon, pravidla cest, capture do odděleného výstupu, hash deduplikaci a volitelný cleanup s podrobným session logem.
Jak aplikace funguje a k čemu slouží
Přehled a účel
FileSniffer_QT je robustní desktopový analytický a údržbový nástroj určený pro rekurzivní prohledávání souborových systémů, selektivní capture (záchyt) dat podle definovaných přípon a řízený cleanup (čištění) nepotřebného balastu. Nástroj je navržen pro forenzní i systémovou práci, kde je kladen důraz na determinismus, auditovatelnost a bezpečnost.
Klíčové provozní pilíře:
- Deterministický běh: Kombinace path rules, prefixových limitů a hash deduplikace zajišťuje, že pro identický vstup a konfiguraci získáte identický výstup.
- Bezpečnost cleanupu: Vrstvený systém guardů (Ignored Basenames, Ignore Patterns, Path-Too-Long skips) znemožňuje neautorizované smazání kritických systémových komponent.
- Auditovatelnost: Každá operace generuje telemetrický event, který je agregován do a následně exportován do strukturovaného JSON/CSV balíčku.
Export kontrakty (Struktura dat)
08.1 Package Metadata (JSON)
Každý capture balíček obsahuje s těmito klíči (Appendix N):
- : root path, start_time, end_time, duration v sekundách.
- : whitelists, blacklists, active_extensions (pro audit).
- : throughput (MB/s), file_frequency, error_ratio.
- : Kompletní dump objektu se všemi čítači.
08.2 Metric Summary (CSV)
Tabulkový export pro analytické nástroje:
- : Sumace velikostí a počtů nalezených/kopírovaných souborů podle přípon.
- : Detailní seznam všech smazaných souborů s časovým razítkem a použitou metodou (RECYCLE/FORCE).
Operations-first runbooky (Provozní scénáře)
9.1 Baseline Audit (Jen čtení)
Cíl: Zjistit stav bez modifikace disku.
- Nastavit scan-root adresář.
- V Path Rules dialogu vypnout Cleanup i Copy files (Checkbox "Audit only").
- Spustit Scan.
- Výsledek: Kompletní inventura souborů v logu a hlavní tabulce bez zásahu do FS.
9.2 Bezpečné čištění (Safe Cleanup)
Cíl: Odstranit známý balast do koše Windows.
- Nastavit Whitelist na cílovou pracovní oblast.
- Aktivovat "Enable Cleanup" v Rules.
- Ujistit se, že "Force delete" je VYPNUTO (zůstane v Recycle Bin).
- Spustit Scan.
- Zkontrolovat Recycle Bin po dokončení pro případnou obnovu.
9.3 Forenzní Capture (Deduplikovaný)
Cíl: Sebrat všechny dokumenty, vynechat duplicity pro úsporu místa.
- Nastavit Formats (nalezitelná v extension dialogu přes "Select All Documents").
- Aktivovat Hash Deduplication (SHA-256).
- Aktivovat Copy Files.
- Spustit Scan.
- Výsledek: Unikátní set souborů v jednom balíčku.
Scénářová matice (Kódové větve)
| Větev (Scenario) | Stav v kódu / Plynulost | Důsledek / Akce |
|---|---|---|
| Init: Missing Config | v config manageru | Vytvoří default config s fallback jazykem (EN). |
| Scan: Path Too Long | v loopu | Navýší , soubor není smazán (safety). |
| Copy: Hash Hit | repository | Přeskočí kopírování, inkrementuje . |
| Cleanup: Permission Denied | v mazací fázi | Loguje v log panelu, pokračuje na další soubor. |
| UI: Close while running | interrupt | Vyvolá , čeká na signál před zavřením. |
| Finalize: No matching files | na konci | Dopíše session log, vytvoří prázdný manifest, přeskočí zipování. |