Guide Utilisateur

Guide & Tutoriel

Tout ce qu'il faut savoir pour installer, configurer et maîtriser Coclico — du premier lancement jusqu'aux automatisations avancées.

Installation

Configuration requise

Coclico est une application Windows native construite sur .NET 10 et WPF. Avant d'installer, vérifiez que votre système répond aux exigences minimales :

  • Système d'exploitation : Windows 10 21H2 ou Windows 11 (64 bits)
  • RAM : 4 Go minimum — 8 Go recommandés pour le module IA
  • Espace disque : 500 Mo pour l'application + espace pour le modèle GGUF (~4 Go)
  • Droits : Compte administrateur obligatoire (élévation UAC au démarrage)
  • GPU (optionnel) : Carte compatible Vulkan pour l'accélération du modèle IA
  • Runtime : .NET 10 Runtime inclus dans l'installeur

Étapes d'installation

  1. Téléchargez le dernier installeur Coclico-Setup-x64.exe depuis la page de téléchargement.
  2. Double-cliquez sur l'installeur — Windows peut afficher un avertissement SmartScreen la première fois. Cliquez sur "Informations complémentaires" → "Exécuter quand même".
  3. Acceptez l'élévation UAC. L'installeur installe Coclico dans %ProgramFiles%\Coclico\.
  4. Au premier lancement, la fenêtre LauncherWindow vous demande de choisir le mode de démarrage : manuel, avec Windows, ou minimisé dans la barre des tâches.
  5. Si vous souhaitez utiliser le module IA, placez votre modèle GGUF dans %APPDATA%\Coclico\resource\model\ et nommez-le IA-support-chat.gguf.
Coclico nécessite des droits administrateur pour accéder aux APIs système (WMI, registre, mémoire kernel). L'élévation est demandée une seule fois au démarrage via UAC.

Première utilisation

Lors de votre premier lancement, Coclico effectue une analyse initiale de votre système et affiche un écran de démarrage (SplashWindow) pendant que les services s'initialisent. Ce processus dure généralement 3 à 8 secondes.

La fenêtre LauncherWindow apparaît ensuite pour configurer :

  • Mode de lancement : Manuel / Au démarrage de Windows / Minimisé dans le tray
  • Thème : Clair, Sombre, ou Système (suit la préférence Windows)
  • Langue : Français, English, Deutsch, Español
  • Profil utilisateur : Nom et avatar (optionnel)

Ces paramètres sont modifiables à tout moment dans le module Paramètres.

Interface principale

Coclico utilise une interface WPF-UI 4.x avec une barre de navigation verticale sur la gauche. Chaque icône correspond à un module. La barre de titre est personnalisée avec des boutons de contrôle de fenêtre intégrés.

  • Navigation : Clic sur une icône ou utilisez les raccourcis clavier
  • Tray : Fermer la fenêtre minimise dans la barre des tâches système (double-clic pour rouvrir)
  • Thème : Bouton soleil/lune en haut à droite pour basculer clair/sombre
  • Notifications : Les toasts apparaissent en bas à droite pour les actions importantes

Les 8 modules

Dashboard

Le Dashboard est la page d'accueil de Coclico. Il affiche en temps réel :

  • CPU : Utilisation instantanée et moyenne sur 60 secondes
  • RAM : Mémoire utilisée / disponible / totale avec graphique historique
  • Disque : Espace occupé par lecteur avec alertes si < 10% libre
  • Réseau : Débit entrant/sortant et adresse IP locale
  • Score de santé système : Indicateur global calculé par StartupHealthService
  • Actions rapides : Boutons de nettoyage rapide, vidage RAM, scan direct

Les données sont rafraîchies via Dispatcher.InvokeAsync toutes les secondes pour ne jamais bloquer le thread UI.

Nettoyage (Deep Clean)

Le module Nettoyage analyse et supprime les fichiers inutiles sur votre système. Il couvre 10 catégories de nettoyage :

  1. Fichiers temporaires Windows — dossier %TEMP% et C:\Windows\Temp
  2. Cache des navigateurs — Chrome, Edge, Firefox, Opera (profils détectés automatiquement)
  3. Logs système — journaux d'événements Windows, logs IIS, logs Update
  4. Corbeille — vidage de la corbeille sur tous les lecteurs
  5. Fichiers temp utilisateur — dossier AppData\Local\Temp par utilisateur
  6. Cache des miniatures — base de données thumbs.db et icônes Windows
  7. Rapports d'erreur Windows — dossier WER (Windows Error Reporting)
  8. Anciens installeurs — fichiers .msi/.exe en attente dans Windows Installer
  9. Cache DNS — vide le cache DNS via DnsFlushResolverCache (iphlpapi.dll)
  10. Prefetch — fichiers de préchargement Windows (C:\Windows\Prefetch)

Chaque catégorie peut être activée ou désactivée individuellement avant d'exécuter le nettoyage.

RAM Cleaner

Le RAM Cleaner libère la mémoire physique en forçant Windows à écrêter les working sets des processus et à vider les standby lists du kernel. Il utilise directement les APIs Win32 via P/Invoke :

  • kernel32.dll — SetProcessWorkingSetSize, GetCurrentProcess
  • ntdll.dll — NtSetSystemInformation (SystemMemoryListInformation)
  • advapi32.dll — AdjustTokenPrivileges, LookupPrivilegeValue
  • dnsapi.dll — DnsFlushResolverCache
  • iphlpapi.dll — FlushIpNetTable

L'opération nécessite le privilège SeIncreaseQuotaPrivilege (obtenu via advapi32). La progression est affichée en temps réel. Typiquement, 200 à 800 Mo sont libérés selon l'état du système.

App Scanner

L'App Scanner analyse vos applications installées et identifie :

  • Applications non utilisées — pas de lancement depuis plus de 90 jours
  • Grandes applications — taille supérieure à un seuil configurable
  • Applications dupliquées — même nom, versions différentes
  • Logiciels en fin de vie — versions connues vulnérables ou abandonnées

Les résultats s'affichent dans une liste triable avec filtres. Chaque application peut être désinstallée directement ou ajoutée à une Flow Chain pour automatisation.

Installeur Rapide

L'Installeur Rapide permet de déployer des applications courantes en un clic via InstallerService. Il s'appuie sur des manifestes JSON décrivant les sources de téléchargement, les checksums SHA256 et les arguments silencieux d'installation.

  • Téléchargement avec barre de progression et vérification d'intégrité
  • Installation silencieuse sans popups
  • Support des installations en lot (plusieurs applications simultanément)
  • Rollback automatique si une installation échoue

Applications

La vue Applications liste toutes les applications installées sur votre machine depuis 8 sources différentes :

  • Registre Windows HKLM — SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
  • Registre Windows HKCU — applications installées par l'utilisateur courant
  • Steam — bibliothèque via libraryfolders.vdf
  • Epic Games — manifestes dans %ProgramData%\Epic\EpicGamesLauncher
  • GOG Galaxy — base de données SQLite locale
  • Ubisoft Connect — registre et dossier d'installation
  • EA App — manifestes XML dans le dossier EA
  • Rockstar Games Launcher — dossier de données Rockstar
  • Microsoft Store — packages AppX via Get-AppxPackage (PowerShell)

La vue propose une recherche instantanée, un tri par nom/taille/date et un filtre par source.

Flow Chains

Les Flow Chains sont le système d'automatisation visuel de Coclico. Vous créez des chaînes de nœuds qui s'exécutent en séquence, avec branchements conditionnels. Voir la section Flow Chains étape par étape pour le détail complet.

Paramètres

Le module Paramètres permet de configurer tous les aspects de Coclico :

  • Général : Langue, thème, mode de démarrage, minimisation dans le tray
  • Apparence : Couleur d'accent (défaut : #6366F1 Indigo), densité de l'interface
  • Nettoyage : Catégories activées par défaut, fréquence de nettoyage automatique
  • IA & Audit : Activation du mode audit AutoPatcher, rétention des logs d'audit
  • Sécurité : Chargement de la politique de sécurité (security-policy.json)
  • Notifications : Préférences de toasts et alertes système

Flow Chains — Étape par étape

Les Flow Chains permettent de créer des automatisations complexes sans code. Voici comment créer votre première chaîne :

Étape 1 — Créer une nouvelle chaîne

Dans le module Flow Chains, cliquez sur "Nouvelle chaîne". Donnez-lui un nom et une description. Chaque chaîne contient une liste ordonnée de nœuds (FlowItem).

Étape 2 — Ajouter des nœuds

Cliquez sur "+ Ajouter un nœud" pour ouvrir le sélecteur de type. Les 28 types de nœuds disponibles (enum NodeType) sont organisés en catégories :

  • Actions système : KillProcess, LaunchProcess, RestartService, StopService, StartService, SetRegistryValue, DeleteRegistryKey, CreateDirectory, DeleteFile, MoveFile, CopyFile, RunScript
  • Nettoyage : CleanTemp, EmptyRecycleBin, FlushDns, ClearBrowserCache, ClearEventLogs, ClearPrefetch, ClearThumbnailCache, ClearWindowsErrorReports
  • Mémoire : FreeRam, SetWorkingSet
  • Réseau : PingHost, DisableNetworkAdapter, EnableNetworkAdapter
  • Contrôle : Wait, Condition, Log, Notification

Étape 3 — Configurer les conditions

Chaque nœud peut avoir une condition d'exécution avec 10 opérateurs disponibles (enum ConditionOperator) :

  • Equals, NotEquals — comparaison exacte
  • GreaterThan, LessThan, GreaterOrEqual, LessOrEqual — comparaison numérique
  • Contains, NotContains — présence dans une chaîne
  • IsEmpty, IsNotEmpty — vérification de valeur vide

Étape 4 — Configurer OnErrorAction

Pour chaque nœud, définissez le comportement en cas d'erreur :

  • ContinueNext (défaut) — ignore l'erreur et passe au nœud suivant
  • StopChain — arrête immédiatement l'exécution de la chaîne
  • SkipToEnd — saute tous les nœuds restants et exécute uniquement le dernier nœud (utile pour les nœuds de "nettoyage final")

Étape 5 — Exécuter et surveiller

Cliquez sur "Exécuter". La progression s'affiche en temps réel avec le statut de chaque nœud (En attente / En cours / Succès / Erreur). Le journal d'exécution est disponible dans le panneau latéral. Vous pouvez également planifier l'exécution automatique via le menu "Planifier".

Coclico AI

Coclico embarque un assistant IA entièrement local basé sur LLamaSharp 0.26. Aucune donnée ne quitte votre machine.

Accéder au chat IA

Cliquez sur l'icône IA dans la barre de navigation. Le chat s'ouvre dans une vue dédiée (AiChatView). L'IA peut répondre à vos questions sur le système, suggérer des optimisations et créer des Flow Chains à votre place.

Dual-executor

Coclico utilise deux contextes LLM isolés :

  • Contexte Chat (_chatCtx) — dédié au chat utilisateur dans AiChatView
  • Contexte Engine (_engineCtx) — dédié aux tâches d'optimisation automatique en arrière-plan (OptimizationEngineService, toutes les 30 secondes)

Cette isolation garantit que les tâches de fond ne ralentissent jamais votre chat interactif.

Accélération matérielle

Si votre carte graphique supporte Vulkan, l'inférence du modèle est accélérée automatiquement. Sinon, Coclico bascule sur le CPU (plus lent). Configurez le backend dans Paramètres → IA & Audit.

Raccourcis clavier

Coclico propose des raccourcis globaux configurables via KeyboardShortcutsService :

  • Ctrl + 1 — Dashboard
  • Ctrl + 2 — Nettoyage
  • Ctrl + 3 — RAM Cleaner
  • Ctrl + 4 — App Scanner
  • Ctrl + 5 — Installeur Rapide
  • Ctrl + 6 — Applications
  • Ctrl + 7 — Flow Chains
  • Ctrl + 8 — Paramètres
  • Ctrl + Shift + C — Nettoyage rapide (depuis n'importe où)
  • Ctrl + Shift + R — Libération RAM rapide
  • Ctrl + Shift + A — Ouvrir le chat IA
  • Escape — Fermer le panneau/dialogue actif

Fichiers & Données

Coclico stocke toutes ses données dans le dossier utilisateur Windows :

  • %APPDATA%\Coclico\ — racine de configuration
  • %APPDATA%\Coclico\settings.json — paramètres de l'application (géré par SettingsService)
  • %APPDATA%\Coclico\flow-chains\ — définitions JSON des Flow Chains
  • %APPDATA%\Coclico\audit\ — journal d'audit NDJSON append-only (AuditLogService)
  • %APPDATA%\Coclico\logs\ — logs Serilog rotatifs (rotation quotidienne, rétention 14 jours)
  • %APPDATA%\Coclico\resource\model\ — modèle IA GGUF (IA-support-chat.gguf)
  • %APPDATA%\Coclico\security-policy.json — politique de sécurité personnalisée
  • %APPDATA%\Coclico\rollback\ — snapshots pour rollback des patches IA

Aucune donnée n'est envoyée vers des serveurs externes. Toute l'intelligence artificielle fonctionne 100% en local (Zero Cloud).