Klikneš SCAN — aplikacija nađe probleme, prevede ih u običan jezik, predloži plan popravki, ti odobriš, ona popravi, provjeri i vrati nazad ako nešto pođe po zlu.
Šta je MujoFix • Kako radi • Moduli • AI sloj • Sigurnost • Status
MujoFix je open-source desktop aplikacija koja običnom korisniku — bez ikakvog admin znanja — pomaže da održava Windows računar zdravim. Umjesto tehničkih poruka o greškama, korisnik dobija rečenice poput:
"Tvoj računar ima 7 problema.
🔴 2 ozbiljna 🟠 3 srednja 🟢 2 mala
Automatski se može popraviti: 4."
…i jedno dugme [ POPRAVI SVE ]. Ispod se nalazi proširiva lista s detaljima ("Prikaži tehničke detalje") za naprednije korisnike.
| Podržano | Detalj |
|---|---|
| 🖥️ Sistem | Windows 10 (22H2) i Windows 11 (23H2+), x64 |
| 👤 Korisnik | Bez admin znanja; radi i bez admin prava (čitanje + popravke u korisničkom profilu) |
| 🔐 UAC | Elevacija se traži samo kad je potrebno, uz objašnjenje zašto — prije nego iskoči Windows prozor |
| 🌐 Jezik | Bosanski/hrvatski/srpski (default), i18n struktura za engleski |
| 📶 Offline | Aplikacija ostaje potpuno upotrebljiva bez interneta i bez AI-ja (offline mod) |
- SCAN — moduli skeniranja (izvršavaju se redom) uz progres bar i mogućnost otkazivanja. Greška modula ne ruši aplikaciju — postaje skipped u izvještaju.
- ANALIZA — svaki nalaz ima ozbiljnost (
CRITICAL / MEDIUM / LOW), procjenu uticaja, rizik popravke i oznaku da li je popravka reverzibilna. - PRIKAZ — jednostavan sažetak običnim jezikom + proširiva lista detalja. Izgled: Fluent 2 / Windows 11 (Segoe UI, zaobljene kontrole, automatska svijetla/tamna tema) i Mica pozadina kad je DWM pruža (Win11; u suprotnom solidna boja). Izbor jezika (Bosanski / English, primjenjuje se pri sljedećem pokretanju) i zapamćena veličina/pozicija prozora. Dvojezično je sve što korisnik vidi: interfejs, nalazi skenera (naslov, zašto, uticaj, rizik), poruke akcija (precondition/apply/verify/rollback), nazivi i rizik akcija u katalogu, razlozi validacije AI plana, offline objašnjenja, izvještaj i CLI izlaz. (Tehničke poruke izuzetaka u platformskom sloju ostaju na bosanskom.)
- PLAN — AI predloži plan popravki (koraci + redoslijed), koji se prikaže uz objašnjenje; svaki predlog prolazi katalog akcija i validator prije nego se uopšte prikaže. Primjenjuju se akcije odabranih nalaza (deterministički, sa snapshot/rollback tačkom i verifikacijom) — korisnik odobrava: sve, pojedinačno ili ništa. Bez odobrenja se NIŠTA ne mijenja.
- IZVRŠENJE — prije svakog koraka snapshot/rollback tačka, pa izvršenje.
- VERIFIKACIJA — nakon svakog koraka ponovo se izmjeri isto što je nalaz detektovao i potvrdi da je problem stvarno riješen.
- ROLLBACK — ako verifikacija padne ili se stanje pogorša, korak se automatski vraća i korisnik se izvijesti.
- SAŽETAK — koliko je problema, po ozbiljnosti, i koliko ih se može automatski popraviti (nalazi bez akcije su preporuke).
- IZVJEŠTAJ — broj popravljenih / preskočenih / neuspjelih koraka, koliko je u karantinu i, poslije čišćenja, oslobođeni GB + opcija "Poništi sve" preko rollback tačaka. (Vrijeme boot-a se ne mjeri nigdje u kodu — vidi
scanners/startup.py.)
Zašto svaki nalaz mora imati dokaz?
AI smije govoriti samo o podacima koje je scanner stvarno prikupio (sirova mjerenja, ključevi registra, event ID-jevi, putanje). Bez dokaza nalaz se ne prikazuje. Kad je AI nesiguran, mora to izričito reći. Zabranjeno: izmišljeni procenti, brojke i tvrdnje o uzroku bez dokaza.
Fluent 2 / Windows 11: Segoe UI, zaobljene kontrole, automatska svijetla/tamna tema i Mica pozadina na Win11. Snimke su sa stvarne aplikacije (offscreen render na pravom Windows 11, bs jezik):
Svi moduli su pluginovi s istim interfejsom (scan() nikad ne ruši aplikaciju — greška postaje skipped izvještaj). Svaki modul provjerava verziju Windowsa i graceful se isključuje gdje nije podržan.
| Modul | Šta gleda | Faza |
|---|---|---|
| 🚀 Startup | Run/RunOnce ključevi, Startup folder, Taskovi, auto-servisi | 1 ✅ |
| 🔁 Servisi | Servisi koji se ruše (Event ID 7031/7034), neočekivana stanja | 1 ✅ |
| 💾 Disk | Slobodan prostor, temp, WU keš, recycle bin, Windows.old, SMART | 1 ✅ |
| 📁 Veliki fajlovi i duplikati | Veličina → djelimični hash → puni hash; duplikati se nikad ne brišu automatski | 5 |
| 🔧 Drajveri i paketi | Stari drajveri (pnputil), zaostali instaleri, nekorišteni programi | 5 |
| ⚙️ Konfiguracija | PATH, env varijable, hosts, power plan, SFC/DISM indikatori | 5 |
| 🌐 Mreža | DNS, proxy, adapteri, latencija, hosts hijack, Winsock | 5 |
| 🕵️ Sumnjivi procesi | Nepotpisani procesi na čudnim lokacijama, autostart iz Temp-a, Defender izuzeci (i isključena real-time zaštita). Ne tvrdi "virus" — kaže "sumnjivo, razlozi: …"; izuzeci su samo čitanje | 5 |
| ⏰ Zakazani zadaci | Zadaci koji se pokreću pri prijavi/boot-u, a program im je izvan sistemskih foldera (Task Scheduler) | 5 |
| 🛡️ Sigurnosna postavka (samo čitanje) | BitLocker na sistemskom disku, Secure Boot, TPM, Windows Update servis — samo prijavljuje, ništa ne mijenja | 5 |
| 🔒 Permisije | Preširoke ACL dozvole, svijet-zapisivi folderi u PATH-u, UAC, share-ovi | 5 |
Od 32 nalaza, 12 ima automatsku popravku (akcija iz kataloga, sa snapshot/verify/rollback); ostali su namjerno samo preporuke — sa razlogom:
| Nalaz | Popravka | Napomena |
|---|---|---|
config-path-writable |
❌ | samo POSIX (na Windowsu ACL nije mode); skidanje prava pisanja je rizično |
config-path-missing |
✅ remove_path_entry | |
config-temp-var |
✅ fix_temp_var | |
config-power-saver |
✅ disable_power_saver | |
config-sfc |
❌ | traži sfc /scannow (duga popravka sistema, van kataloga) |
disk-almost-full |
❌ | uzrok je širok — temp i WU keš imaju svoje nalaze |
disk-low |
❌ | uzrok je širok — temp i WU keš imaju svoje nalaze |
disk-temp |
✅ clean_temp | |
disk-wu-cache |
✅ clean_temp | |
disk-windows-old |
❌ | brisanje je NEPOVRATNO (nema povratka na staru verziju) |
drivers-old |
❌ | update drajvera traži proizvođački alat i restart (rizik plavog ekrana) |
duplicates-found |
✅ quarantine_duplicates | |
network-dns |
❌ | dijagnostika — uzrok je ruter/provajder, ne računar |
network-unreachable |
❌ | dijagnostika — uzrok je firewall/provajder |
network-slow |
❌ | dijagnostika — uzrok je mreža/provajder |
network-hosts |
✅ remove_hosts_entry | |
network-proxy |
✅ disable_proxy | |
network-winsock |
❌ | netsh winsock reset traži restart i mijenja mrežni stek |
permissions-uac-off |
❌ | uključivanje UAC-a traži restart (može zaključati zavisne programe) |
permissions-acl |
❌ | zatezanje ACL-a može slomiti pristup — rizično bez pregleda |
permissions-shares |
✅ remove_share | |
permissions-path-writable |
❌ | samo POSIX fallback; isto kao config-path-writable |
bitlocker-off |
❌ | mijenjanje zaštitnih politika je IZVAN politike app-a — samo prijavljujemo |
secureboot-off |
❌ | isto — boot politika se ne dira iz aplikacije |
tpm-absent |
❌ | hardverski nedostatak — nema šta da se popravi softverski |
wuauserv-disabled |
❌ | politika ažuriranja je izvan politike app-a — samo prijavljujemo |
services-auto-stopped |
✅ restart_service | |
startup-count |
✅ disable_startup_item | |
suspicious-process |
❌ | namjerno report-only — app ne gasi procese i ne tvrdi da je virus |
suspicious-defender-off |
❌ | app nikad ne dira antivirus/zaštitu (politika) |
defender-exclusions |
❌ | mijenjanje zaštitnih politika je IZVAN politike app-a — samo prijavljujemo |
tasks-autostart-untrusted |
✅ disable_task |
- Ne mjeri vrijeme boot-a. Startup nalaz broji stavke i to izričito kaže; stvarno vrijeme podizanja se ne mjeri nigdje u kodu.
- Ne pravi System Restore Point. Sigurnosna mreža je snapshot po akciji + rollback + karantin (traži admin/Checkpoint-Computer).
- Ne instalira drajvere ni Windows zakrpe. Zastarjeli drajveri i isključen Windows Update se prijavljuju, ne popravljaju.
- Ne mijenja zaštitne politike: Defender (izuzeci, real-time), UAC, BitLocker, Secure Boot, deljeni folderi, firewall — sve je samo čitanje + preporuka.
- Ne gasi procese i nikad ne tvrdi „virus" — sumnjivi nalazi kažu „sumnjivo, razlozi: …".
- Ne briše trajno bez tvoje potvrde. Fajlovi idu u karantin; trajno briše samo dugme „Očisti karantin" (uz potvrdu) i to se upiše u dnevnik.
- Karantin nema automatski rok. Ništa se ne briše samo — dok ti ne očistiš, fajlovi stoje u
%LOCALAPPDATA%\MujoFix\quarantine. - Nema telemetrije. Mreža se koristi samo za: provjeru ažuriranja (GitHub), AI objašnjenje (uz pristanak, anonimizirano) i mrežnu dijagnostiku (DNS/TCP probe ka javnom DNS-u).
- AI ništa ne izvršava. Model objašnjava i predlaže; izvršava samo deterministički katalog akcija, uz tvoje odobrenje. Ako besplatni model nije dostupan, lanac iskreno pada na offline.
- Radi samo na Windowsu (10 22H2+ / 11). Na drugim sistemima se scanneri iskreno preskaču (CLI se pokreće, ali nema šta da skenira).
- Build nije potpisan — SmartScreen upozorenje je očekivano, ne bug.
- Puna VM matrica (čist Win10/Win11) je otvorena. Sve što nije izvršeno na pravom Windowsu stoji označeno kao netestirano (docs/TESTING.md).
MujoFix koristi OpenCode (pinovana, testirana verzija, MIT licenca) kao AI motor — instalira se zajedno s aplikacijom, korisnik ne instalira ništa ručno (ni Node ni npm).
MujoFix UI → MujoFix Core (scanneri, katalog, executor, rollback)
│
└── OpenCode child proces (opencode run, bez servera/porta)
│
└── MujoFix MCP server (samo 5 alata, svi read-only + validator)
- Izvršenje je ISKLJUČIVO u Coreu. OpenCode objašnjava i predlaže, validator provjerava (JSON schema + allowlista), korisnik odobrava, deterministički executor izvršava. OpenCode nikad ne izvršava komande.
- Agent
mujofix: svi ugrađeni alati zabranjeni (bash, edit, write, web…), dozvoljeni samo MujoFix MCP alati, deny po defaultu. - Fallback lanac: model A → B → C → OFFLINE mod. Offline objašnjenje je dvojezično i gradi se isključivo iz podataka koje je scanner prikupio (zašto, uticaj, rizik, dokaz, tehnički detalji + koja akcija postoji) — bez ijedne pretpostavke i bez AI-ja.
- Živi model: uz pristanak MujoFix pokrene
opencode runkao child proces i koristi besplatan Zen model (npr.opencode/beam-free). Nema lokalnog backend-a: ne diže seopencode serve, nema porta ni lozinke, ništa se ne izlaže na mrežu — MujoFix je isključivo instalabilna Windows aplikacija. Ako binary ili besplatni model nisu dostupni — tiho nazad na offline, uz iskrenu poruku o razlogu (bez lažne tvrdnje da je AI radio). netestirano: živi put još nije pokrenut na Windows VM-u (Issue #1). - Privatnost: prije prvog korištenja AI-ja — ekran pristanka (koji podaci idu, kome, primjer payload-a). Anonimizacija prije slanja; default je offline dok korisnik ne pristane. Besplatni Zen modeli nisu privatni (potvrđeno iz ToS i Zen docs, 2026-10-18): provajderi su uglavnom zero-retention, ali za neplaćene račune sadržaj se smije koristiti za unapređenje usluge, pojedini besplatni modeli tokom promo perioda mogu koristiti poslane podatke za poboljšanje modela, dio zahtjeva (OpenAI/Anthropic) čuva se 30 dana.
- Zaštićene zone (hard-coded crna lista u validatoru AI plana): System32, WinSxS, Program Files, korisnički Dokumenti/Slike/Desktop/Download, boot konfiguracija (BCD), BitLocker, Defender. Namjerno NIJE na listi cijeli
C:\Windows—Windows\Tempi WU cache su legitimni ciljevi. Izvršni sloj ipak vrti samo akcije iz kataloga nad nalazima koje je korisnik odabrao. - Prije popravke: vlastiti manifest po akciji — snapshot vraća tačno stanje koje akcija mijenja (npr. prijašnja vrijednost registry unosa ili stanje servisa/taska) + karantin fajlova (ne trajno brisanje: u karantin idu fajlovi stariji od 30 dana). Dugme „Karantin" prikazuje šta je unutra i vraća pojedinačne fajlove (i one iz ranijih sesija — originalna putanja se čita iz manifesta; fajl bez manifesta se može samo obrisati). Dugme „Očisti karantin" jedino trajno briše — prikaže koliko fajlova i koliko GB, traži potvrdu i u izvještaj upiše oslobođeno. System Restore Point nije implementiran (traži admin/Checkpoint-Computer; vidi
docs/STATUS.md) — sigurnosna mreža je snapshot + rollback po akciji. - Svaka akcija: precondition → snapshot → apply → verify → rollback ako zatreba. Akcija bez
rollback()ne smije biti auto-fix. - Probni (dry-run) mod (checkbox u GUI-ju: ništa se ne mijenja) i čítljiv dnevnik svakog koraka u prozoru (precondition / snapshot / apply / verify / dry-run). Poslije svake popravke upisuje se i JSON dnevnik izvršavanja u
%LOCALAPPDATA%\MujoFix\audit\audit-<vrijeme>.json(sve faze koraka + sažetak; putanja se ispiše u dnevniku). - Nikad: gašenje antivirusa/firewalla/Windows Update-a, mijenjanje zaštitnih politika.
| Faza | Sadržaj | Stanje |
|---|---|---|
| 0 — SPIKE | Bundlovani OpenCode kao child, besplatni modeli, MCP alat, zabrana shell-a, offline | 🟢 kod + dokaz na hostu (1–2); 3–5 čekaju živi model |
| 1 | Skeleton + CLI scanner (startup, disk, servisi) + model nalaza | 🟢 gotovo (Linux + host dokazi) |
| 2 | Action katalog + runner (snapshot/verify/rollback) | 🟢 gotovo (katalog 10 akcija; 3 potvrđene host dokazom, ostale testovi — vidi TESTING) |
| 3 | GUI (sažetak, plan, odobravanje, progres, izvještaj) | 🟢 gotovo (GUI smoke na hostu) |
| 4 | Puni AI sloj (MCP, validator, fallback, pristanak, offline) | 🟢 kod gotov (offline default; Zen ToS neprovjeren) |
| 5 | Preostali moduli (mreža, drajveri, duplikati, procesi, permisije…) | 🟢 gotovo (10 scannera; 9 potvrđeno host dokazom 2026-10-14, `tasks` dodat 2026-10-22) |
| 6 | Installer, potpisivanje, auto-update, javni release | 🟡 kod gotov; build/release odluka otvorena (nepotpisan) |
Validacija na pravom Windows 11 (2026-10-23, laptop, Enterprise N sa WDAC enforced): scan 11/11 scannera bez skipova, host_proof 12/12 PASS (apply → verify → rollback, uključujući nove akcije hosts/share/power), pinovani opencode prihvata naš config (agent `mujofix`, svih 11 alata `deny`), CLI bs/en + JSON nalaza + živa provjera update-a — dokazi u lab/results-win11-laptop/. Ranije: host-direct na drugom Win11 računaru (scan 9/9 u tom runu, 3 akcije uz identičan rollback, GUI smoke, spike 1–2). Puna VM matrica (Win10 + Win11, čist sistem) ostaje kao opciona, produžena validacija — vidi docs/TESTING.md.
Detalji po sesiji: docs/STATUS.md • Pravila za kodere: AGENTS.md
Preuzmi sa Releases stranice:
MujoFix-Setup-<verzija>.exe— preporučeno (instalater), iliMujoFix-v<verzija>.zip— portabilna verzija (raspakuj i pokreniMujoFix.exe).- Provjeri hash (opciono, ali preporučeno) — uz release ide
SHA256SUMS.txt:# PowerShell, u folderu gdje si preuzeo fajlove: $a = (Get-FileHash .\MujoFix-Setup-0.4.1.exe -Algorithm SHA256).Hash.ToLower() $b = ((Select-String .\SHA256SUMS.txt -Pattern "MujoFix-Setup-0.4.1.exe").Line -split '\s+')[0] $a -eq $b # mora vratiti True
- Pokreni
MujoFix-Setup-0.4.1.exe. Instalira se u%LOCALAPPDATA%\MujoFix, bez administratorskih prava (samo za trenutnog korisnika). - SmartScreen upozorenje je očekivano — build još nije potpisan. Klikni More info → Run anyway.
- Prečica ide u Start meni; desktop ikona je opciona (kućica u instalaciji, isključena po defaultu).
- Tiha instalacija (npr. više računara):
MujoFix-Setup-0.4.1.exe /SILENT(ili/VERYSILENT). - Deinstalacija: Apps & features → MujoFix. Uklanja i ugrađenu OpenCode kopiju i podatke aplikacije (
%LOCALAPPDATA%\MujoFix).
Ažuriranje: MujoFixCLI.exe update provjeri ima li nova verzija; update --apply preuzme, provjeri sha256 i pokrene instalater. U GUI-ju isto radi dugme Provjeri ažuriranja.
Zahtjevi: Windows 10/11 (64-bit). Nema Node ni Python — OpenCode je ugrađen i pinovan na tačnu verziju.
netestirano: instalater se kompajlira u CI na svakom push-u, ali njegovo izvršavanje na čistom Win10/Win11 VM-u je još u toku (Issue #1).
# Skeniranje (engine radi i iz CLI-ja)
PYTHONPATH=mujofix python3 -m mujofix.cli scan --summary
# Provjera ažuriranja (--apply preuzme, provjeri sha256 i pokrene; Windows)
PYTHONPATH=mujofix python3 -m mujofix.cli update
# Faza 0 SPIKE (opciono, uz živi model)
python3 scripts/phase0_spike.py --model <provider/model>
# Dokaz akcija na pravom Windowsu (apply -> verify -> rollback)
python3 scripts/host_proof.pyOvaj alat mijenja sistemske postavke računara i dolazi BEZ IKAKVE GARANCIJE. Prije korištenja se preporučuje backup važnih podataka. Promjene se mogu poništiti samo u okviru ugrađenog rollback-a (snapshot po akciji + karantin 30 dana) — System Restore Point nije implementiran, a oporavak izvan rollback-a nije zagarantovan. Ništa u ovoj aplikaciji nije "100% sigurno".

