Files
Geniusia_v2/archive/old_docs/GUIDE_RAPIDE_MODE_ASSISTE.txt
2026-03-05 00:20:25 +01:00

178 lines
10 KiB
Plaintext

╔══════════════════════════════════════════════════════════════════════════╗
║ MODE ASSISTÉ - GUIDE RAPIDE ║
╚══════════════════════════════════════════════════════════════════════════╝
┌──────────────────────────────────────────────────────────────────────────┐
│ QU'EST-CE QUE C'EST ? │
└──────────────────────────────────────────────────────────────────────────┘
Le Mode Assisté suggère automatiquement des actions basées sur ce que tu as
déjà fait. C'est comme un assistant qui te dit : "Tu veux que je fasse ça ?"
┌──────────────────────────────────────────────────────────────────────────┐
│ COMMENT ÇA MARCHE ? │
└──────────────────────────────────────────────────────────────────────────┘
PHASE 1 : APPRENTISSAGE (Mode Shadow)
1. Lance l'application : cd geniusia2 && ./run.sh
2. Clique sur "Start"
3. Effectue 3 fois la même action (ex: 3 clics sur "Enregistrer")
4. Le système détecte le pattern et crée une tâche
5. Tu vois une notification : "Tâche apprise"
PHASE 2 : SUGGESTIONS (Mode Assisté)
1. Refais une action similaire (1 seul clic sur "Enregistrer")
2. Un overlay apparaît avec la suggestion
3. Tu choisis :
- [Entrée] : Accepter → Le système exécute automatiquement
- [Échap] : Refuser → Rien ne se passe
- [Alt+C] : Corriger → (À venir)
┌──────────────────────────────────────────────────────────────────────────┐
│ EXEMPLE VISUEL │
└──────────────────────────────────────────────────────────────────────────┘
Tu fais 3x : [Clic] → [Clic] → [Clic]
Le système : "Pattern détecté ! Tâche créée : 'Clic sur Enregistrer'"
Tu refais : [Clic]
Le système : ┌─────────────────────────────────────┐
│ 🤝 Suggestion d'Action │
│ │
│ Tâche : Clic sur Enregistrer │
│ Confiance : 89% │
│ │
│ [Entrée] Accepter │
│ [Échap] Refuser │
│ [Alt+C] Corriger │
└─────────────────────────────────────┘
Tu appuies : [Entrée]
Le système : ✅ Action exécutée automatiquement !
┌──────────────────────────────────────────────────────────────────────────┐
│ TESTER LE MODE ASSISTÉ │
└──────────────────────────────────────────────────────────────────────────┘
Option 1 : Test Automatisé
$ geniusia2/venv/bin/python test_mode_assiste_complet.py
Résultat : 4/4 tests réussis ✅
Option 2 : Test Manuel
$ geniusia2/venv/bin/python test_mode_assiste_manuel.py
Résultat : Liste les tâches et simule une suggestion
Option 3 : Application Complète
$ cd geniusia2 && ./run.sh
Résultat : Interface graphique avec Mode Assisté actif
┌──────────────────────────────────────────────────────────────────────────┐
│ CONFIGURATION │
└──────────────────────────────────────────────────────────────────────────┘
Fichier : geniusia2/core/config.py
assist:
similarity_threshold: 0.75 # Seuil pour afficher suggestion (75%)
suggestion_timeout: 10.0 # Timeout en secondes
Tu peux baisser le seuil à 0.65 si tu veux plus de suggestions.
┌──────────────────────────────────────────────────────────────────────────┐
│ ÉTAT ACTUEL │
└──────────────────────────────────────────────────────────────────────────┘
✅ FONCTIONNEL (90%)
• SuggestionManager : Recherche de suggestions
• Orchestrator : Intégration complète
• GUI : Overlay visuel
• Callbacks : Tous les événements
• Exécution : Automatique sur acceptation
⚠️ À AMÉLIORER (10%)
• Dialogue de correction (Alt+C)
• Historique des suggestions
• Statistiques en temps réel
┌──────────────────────────────────────────────────────────────────────────┐
│ PROBLÈMES COURANTS │
└──────────────────────────────────────────────────────────────────────────┘
Problème : Aucune suggestion n'apparaît
Causes :
- Pas de tâche similaire apprise
- Similarité < 75%
- Contexte trop différent
Solutions :
1. Vérifier les tâches : python3 read_pkl.py --list
2. Baisser le seuil dans config.py : similarity_threshold: 0.65
3. Refaire l'apprentissage avec plus d'exemples
Problème : L'exécution échoue
Causes :
- Élément non trouvé
- Interface a changé
- Permissions insuffisantes
Solutions :
1. Vérifier les logs : cat geniusia2/data/logs/logs_*.json
2. Refaire l'apprentissage
3. Vérifier les permissions X11/Wayland
Problème : L'overlay ne disparaît pas
Causes :
- Bug dans la GUI
- Callback non appelé
Solutions :
1. Appuyer sur Échap
2. Redémarrer l'application
3. Vérifier les logs
┌──────────────────────────────────────────────────────────────────────────┐
│ DOCUMENTATION │
└──────────────────────────────────────────────────────────────────────────┘
Complète :
• MODE_ASSISTE_FINAL.md
• GUIDE_TEST_MODE_ASSISTE.md
• ETAT_PROJET_19_11.md
Technique :
• geniusia2/core/suggestion_manager.py
• test_mode_assiste_complet.py
• test_mode_assiste_manuel.py
┌──────────────────────────────────────────────────────────────────────────┐
│ COMMANDES UTILES │
└──────────────────────────────────────────────────────────────────────────┘
# Lancer l'application
cd geniusia2 && ./run.sh
# Tests automatisés
geniusia2/venv/bin/python test_mode_assiste_complet.py
# Test manuel
geniusia2/venv/bin/python test_mode_assiste_manuel.py
# Voir les tâches
geniusia2/venv/bin/python read_pkl.py --list
# Diagnostic
geniusia2/venv/bin/python diagnostic_data.py
# Reconstruire l'index FAISS
./rebuild_index.sh
╔══════════════════════════════════════════════════════════════════════════╗
║ LE MODE ASSISTÉ EST PRÊT ! 🚀 ║
╚══════════════════════════════════════════════════════════════════════════╝