# Guide des Modes d'Exécution - GeniusIA v2

## 🎯 Les 3 Modes

GeniusIA v2 peut fonctionner en 3 modes différents :

### 1. Mode Shadow (Observation) 👀

**Par défaut avec `./run.sh`**

```bash
cd geniusia2
./run.sh
# ou explicitement:
./run.sh --mode shadow
```

**Comportement:**
- ✅ Observe tes actions
- ✅ Enregistre les patterns
- ✅ Apprend les workflows
- ❌ **Ne fait PAS de suggestions**
- ❌ N'exécute rien automatiquement

**Utilisation:** Phase d'apprentissage initiale

---

### 2. Mode Assist (Suggestions) 💡

**Avec `./run_assist.sh`** ⭐ **RECOMMANDÉ**

```bash
cd geniusia2
./run_assist.sh
# ou:
./run.sh --mode assist
```

**Comportement:**
- ✅ Observe tes actions
- ✅ Enregistre les patterns
- ✅ Apprend les workflows
- ✅ **Suggère des actions automatiquement**
- ✅ Affiche les suggestions dans la GUI
- ❌ N'exécute rien sans ton accord

**Utilisation:** Mode normal d'utilisation

**Comment ça marche:**
1. Tu fais une action répétitive (ex: calculatrice 9/9=)
2. Après 3+ répétitions, le système détecte le pattern
3. Après 20 répétitions, le workflow est "appris"
4. La prochaine fois, une **suggestion apparaît automatiquement**
5. Tu peux accepter (Entrée) ou rejeter (Échap)

---

### 3. Mode Auto (Automatique) 🤖

**Avec option `--mode auto`**

```bash
cd geniusia2
./run.sh --mode auto
```

**Comportement:**
- ✅ Observe tes actions
- ✅ Enregistre les patterns
- ✅ Apprend les workflows
- ✅ Suggère des actions
- ✅ **Exécute automatiquement** (avec liste blanche)

**⚠️ ATTENTION:** Mode avancé, nécessite configuration de la liste blanche

**Utilisation:** Automatisation complète (production)

---

## 🚀 Quick Start

### Pour tester les suggestions maintenant:

```bash
cd geniusia2
./run_assist.sh
```

Puis répète 3-4 fois la même action simple:
- Ouvrir calculatrice → 9/9= → Fermer
- Ouvrir Firefox → Aller sur google.com → Fermer
- Etc.

Après quelques répétitions, tu verras:
```
🎯 PATTERN DÉTECTÉ !
🎉 Tâche apprise !
```

Répète encore 15-20 fois, et la prochaine fois une **suggestion apparaîtra automatiquement** ! 🎯

---

## 📊 Vérifier l'État

```bash
# Voir ce qui a été appris
python check_learning_status.py

# Voir les logs en temps réel
tail -f geniusia2/logs/actions.log
```

---

## 🎨 Interface GUI

Les suggestions apparaissent dans la GUI:

```
┌─────────────────────────────────────┐
│  💡 Suggestion                      │
│                                     │
│  Workflow: Calculer 9/9             │
│  Confiance: 85%                     │
│                                     │
│  [Entrée] Accepter                  │
│  [Échap] Rejeter                    │
└─────────────────────────────────────┘
```

---

## 🔧 Options Avancées

### Lancer sans GUI (headless)

```bash
./run.sh --mode assist --headless
```

### Voir toutes les options

```bash
./run.sh --help
```

---

## 📝 Résumé

| Mode | Commande | Observe | Apprend | Suggère | Exécute |
|------|----------|---------|---------|---------|---------|
| **Shadow** | `./run.sh` | ✅ | ✅ | ❌ | ❌ |
| **Assist** | `./run_assist.sh` | ✅ | ✅ | ✅ | ❌ |
| **Auto** | `./run.sh --mode auto` | ✅ | ✅ | ✅ | ✅ |

**Pour avoir des suggestions: utilise `./run_assist.sh` !** 🎯

---

## ❓ FAQ

**Q: Pourquoi je n'ai pas de suggestions ?**
- Vérifie que tu es en mode **assist** (`./run_assist.sh`)
- Il faut répéter 20+ fois pour qu'un workflow soit appris
- Les suggestions apparaissent dans la GUI

**Q: Combien de fois dois-je répéter ?**
- 3+ fois pour détecter le pattern
- 20+ fois pour apprendre le workflow
- Ensuite, suggestions automatiques !

**Q: Les suggestions sont où ?**
- Dans la fenêtre GUI (popup)
- Accepter: touche Entrée
- Rejeter: touche Échap

**Q: Ça marche avec le système d'embeddings ?**
- Oui ! Le système d'embeddings fonctionne en arrière-plan
- Il indexe automatiquement dans FAISS
- Il collecte les exemples pour le fine-tuning
- Tout est transparent !

---

**Date:** 20 novembre 2024  
**Version:** GeniusIA v2.0
