321 lines
6.3 KiB
Markdown
321 lines
6.3 KiB
Markdown
# 🛠️ Scripts Disponibles - RPA Vision V2
|
|
|
|
## 🚀 Scripts de Lancement
|
|
|
|
### LANCER_APPLICATION.sh ⭐ (Recommandé)
|
|
**Emplacement** : Racine du projet
|
|
**Usage** : `./LANCER_APPLICATION.sh`
|
|
|
|
Script principal pour lancer l'application depuis n'importe où dans le projet.
|
|
|
|
**Fonctionnalités** :
|
|
- ✅ Vérification de l'existence des répertoires
|
|
- ✅ Vérification de l'existence de run.sh
|
|
- ✅ Ajout automatique des permissions d'exécution
|
|
- ✅ Messages d'erreur clairs
|
|
- ✅ Lancement de l'application
|
|
|
|
**Quand l'utiliser** : Toujours ! C'est la méthode recommandée.
|
|
|
|
---
|
|
|
|
### geniusia2/run.sh
|
|
**Emplacement** : `geniusia2/`
|
|
**Usage** : `cd geniusia2 && ./run.sh`
|
|
|
|
Script de lancement depuis le dossier geniusia2.
|
|
|
|
**Fonctionnalités** :
|
|
- ✅ Activation de l'environnement virtuel
|
|
- ✅ Lancement de main.py
|
|
- ✅ Gestion des erreurs
|
|
|
|
**Quand l'utiliser** : Si vous êtes déjà dans le dossier geniusia2.
|
|
|
|
---
|
|
|
|
## 🔧 Scripts d'Installation
|
|
|
|
### geniusia2/setup.sh ⭐
|
|
**Emplacement** : `geniusia2/`
|
|
**Usage** : `cd geniusia2 && ./setup.sh`
|
|
|
|
Script d'installation automatique complet.
|
|
|
|
**Fonctionnalités** :
|
|
- ✅ Création de l'environnement virtuel
|
|
- ✅ Installation de toutes les dépendances Python (~3.5 GB)
|
|
- ✅ Installation d'Ollama (si nécessaire)
|
|
- ✅ Téléchargement du modèle Qwen 2.5-VL
|
|
- ✅ Création des répertoires de données
|
|
- ✅ Génération des clés de chiffrement
|
|
- ✅ Configuration complète
|
|
|
|
**Durée** : ~10-15 minutes (selon la connexion internet)
|
|
|
|
**Quand l'utiliser** :
|
|
- Première installation
|
|
- Après suppression de venv/
|
|
- Pour réinstaller complètement
|
|
|
|
---
|
|
|
|
## 🔍 Scripts de Vérification
|
|
|
|
### VERIFIER_INSTALLATION.sh ⭐
|
|
**Emplacement** : Racine du projet
|
|
**Usage** : `./VERIFIER_INSTALLATION.sh`
|
|
|
|
Script de vérification complète de l'installation.
|
|
|
|
**Vérifications effectuées** :
|
|
1. ✅ Structure des répertoires
|
|
2. ✅ Scripts de lancement
|
|
3. ✅ Documentation
|
|
4. ✅ Environnement virtuel
|
|
5. ✅ Dépendances Python (PyTorch, PyQt5, Transformers, FAISS)
|
|
6. ✅ Ollama et modèle Qwen 2.5-VL
|
|
7. ✅ Fichiers de configuration
|
|
8. ✅ Répertoires de données
|
|
|
|
**Résultat** :
|
|
- Affiche un résumé avec compteurs (✅/❌/⚠️)
|
|
- Code de sortie 0 si tout est OK
|
|
- Code de sortie 1 si problèmes détectés
|
|
|
|
**Quand l'utiliser** :
|
|
- Après l'installation
|
|
- Avant de lancer l'application
|
|
- Pour diagnostiquer des problèmes
|
|
|
|
---
|
|
|
|
## 🧪 Scripts de Test
|
|
|
|
### test_learning_manager_simple.py
|
|
**Usage** : `python3 test_learning_manager_simple.py`
|
|
|
|
Test du gestionnaire d'apprentissage sans dépendances lourdes.
|
|
|
|
**Tests** :
|
|
- Initialisation
|
|
- Observation d'actions
|
|
- Transitions de mode
|
|
- Calcul de confiance
|
|
- Confirmations et corrections
|
|
- Sauvegarde/chargement
|
|
|
|
---
|
|
|
|
### test_orchestrator_simple.py
|
|
**Usage** : `python3 test_orchestrator_simple.py`
|
|
|
|
Test de l'orchestrateur (boucle cognitive).
|
|
|
|
**Tests** :
|
|
- Initialisation
|
|
- Capture de contexte
|
|
- Liste blanche
|
|
- Métriques
|
|
- Statut
|
|
|
|
---
|
|
|
|
### test_whitelist_simple.py
|
|
**Usage** : `python3 test_whitelist_simple.py`
|
|
|
|
Test du gestionnaire de liste blanche.
|
|
|
|
**Tests** :
|
|
- Ajout/suppression d'applications
|
|
- Vérification d'autorisation
|
|
- Patterns avec wildcards
|
|
- Sauvegarde/chargement
|
|
|
|
---
|
|
|
|
### test_whitelist_integration.py
|
|
**Usage** : `python3 test_whitelist_integration.py`
|
|
|
|
Test d'intégration de la liste blanche avec l'orchestrateur.
|
|
|
|
---
|
|
|
|
### test_input_utils_simple.py
|
|
**Usage** : `python3 test_input_utils_simple.py`
|
|
|
|
Test des utilitaires d'entrée (actions UI).
|
|
|
|
**Tests** :
|
|
- Exécution d'actions (click, type, scroll)
|
|
- Historique d'actions
|
|
- Actions inverses
|
|
- Rollback
|
|
|
|
---
|
|
|
|
### test_input_utils_integration.py
|
|
**Usage** : `python3 test_input_utils_integration.py`
|
|
|
|
Test d'intégration des utilitaires d'entrée.
|
|
|
|
---
|
|
|
|
### test_ui_change_detector_simple.py
|
|
**Usage** : `python3 test_ui_change_detector_simple.py`
|
|
|
|
Test du détecteur de changements UI.
|
|
|
|
---
|
|
|
|
### test_summary_dashboard.py
|
|
**Usage** : `python3 test_summary_dashboard.py`
|
|
|
|
Test du tableau de bord des métriques.
|
|
|
|
---
|
|
|
|
## 📊 Tableau Récapitulatif
|
|
|
|
| Script | Type | Emplacement | Durée | Priorité |
|
|
|--------|------|-------------|-------|----------|
|
|
| **LANCER_APPLICATION.sh** | Lancement | Racine | <1s | ⭐⭐⭐ |
|
|
| **run.sh** | Lancement | geniusia2/ | <1s | ⭐⭐ |
|
|
| **setup.sh** | Installation | geniusia2/ | ~10min | ⭐⭐⭐ |
|
|
| **VERIFIER_INSTALLATION.sh** | Vérification | Racine | ~5s | ⭐⭐⭐ |
|
|
| **test_*.py** | Tests | Racine | ~1-5s | ⭐ |
|
|
|
|
---
|
|
|
|
## 🎯 Workflow Recommandé
|
|
|
|
### Première Installation
|
|
|
|
```bash
|
|
# 1. Vérifier l'état initial
|
|
./VERIFIER_INSTALLATION.sh
|
|
|
|
# 2. Installer
|
|
cd geniusia2
|
|
./setup.sh
|
|
|
|
# 3. Vérifier l'installation
|
|
cd ..
|
|
./VERIFIER_INSTALLATION.sh
|
|
|
|
# 4. Lancer l'application
|
|
./LANCER_APPLICATION.sh
|
|
```
|
|
|
|
---
|
|
|
|
### Utilisation Quotidienne
|
|
|
|
```bash
|
|
# Lancer l'application
|
|
./LANCER_APPLICATION.sh
|
|
```
|
|
|
|
C'est tout ! 🎉
|
|
|
|
---
|
|
|
|
### Après Mise à Jour du Code
|
|
|
|
```bash
|
|
# 1. Vérifier l'installation
|
|
./VERIFIER_INSTALLATION.sh
|
|
|
|
# 2. Réinstaller si nécessaire
|
|
cd geniusia2
|
|
rm -rf venv
|
|
./setup.sh
|
|
|
|
# 3. Tester
|
|
cd ..
|
|
python3 test_learning_manager_simple.py
|
|
python3 test_orchestrator_simple.py
|
|
|
|
# 4. Lancer
|
|
./LANCER_APPLICATION.sh
|
|
```
|
|
|
|
---
|
|
|
|
### Diagnostic de Problèmes
|
|
|
|
```bash
|
|
# 1. Vérifier l'installation
|
|
./VERIFIER_INSTALLATION.sh
|
|
|
|
# 2. Tester les composants
|
|
python3 test_learning_manager_simple.py
|
|
python3 test_orchestrator_simple.py
|
|
python3 test_whitelist_simple.py
|
|
|
|
# 3. Consulter les logs
|
|
cat geniusia2/data/logs/logs_$(date +%Y-%m-%d).enc
|
|
|
|
# 4. Réinstaller si nécessaire
|
|
cd geniusia2
|
|
rm -rf venv
|
|
./setup.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Conseils
|
|
|
|
### Rendre un Script Exécutable
|
|
|
|
```bash
|
|
chmod +x nom_du_script.sh
|
|
```
|
|
|
|
### Exécuter un Script Python avec le venv
|
|
|
|
```bash
|
|
geniusia2/venv/bin/python3 script.py
|
|
```
|
|
|
|
### Vérifier la Version de Python
|
|
|
|
```bash
|
|
geniusia2/venv/bin/python3 --version
|
|
```
|
|
|
|
### Lister les Packages Installés
|
|
|
|
```bash
|
|
geniusia2/venv/bin/pip list
|
|
```
|
|
|
|
---
|
|
|
|
## 🆘 En Cas de Problème
|
|
|
|
1. **Script ne se lance pas** :
|
|
```bash
|
|
chmod +x nom_du_script.sh
|
|
```
|
|
|
|
2. **Erreur "command not found"** :
|
|
```bash
|
|
./nom_du_script.sh # Avec ./
|
|
```
|
|
|
|
3. **Erreur "Permission denied"** :
|
|
```bash
|
|
chmod +x nom_du_script.sh
|
|
```
|
|
|
|
4. **Script Python ne trouve pas les modules** :
|
|
```bash
|
|
# Utiliser le Python du venv
|
|
geniusia2/venv/bin/python3 script.py
|
|
```
|
|
|
|
---
|
|
|
|
**Tous les scripts sont prêts à l'emploi ! 🚀**
|