Aller au contenu principal

Importation et exportation globales

L'importation/exportation globale regroupe l'intégralité de votre configuration Rephlo dans une seule archive, en une seule opération. Contrairement aux exports par entité (voir Importation et exportation), celle-ci réunit tous les types de données dans un seul fichier ZIP complet.

Ce qui est exporté​

L'exportation globale peut inclure toutes vos données Rephlo. Chaque type correspond à une case à cocher indépendante :

Type de donnéeDescriptionPar défaut
CommandsToutes les commandes, tous les groupes et favorisSélectionné
SpacesLes Spaces avec tous leurs fichiers et contenusSélectionné
HistoryHistorique d'utilisation avec les entrées/sortiesSélectionné
ProvidersConfigurations des fournisseurs LLM (clés API chiffrées)Sélectionné
ConversationsSessions de chat avec l'historique complet des messagesSélectionné
SettingsPréférences de l'applicationSélectionné

Les clés API et les secrets restent chiffrés pour la machine ayant créé l'export. Ils ne peuvent être déchiffrés que sur cette même machine — voir Importation entre machines.

Exporter vos données​

Étape 1 : Ouvrir l'exportation globale​

  1. Accédez au menu File.
  2. Cliquez sur Export All Data…

Étape 2 : Sélectionner les éléments à exporter​

La boîte de dialogue d'exportation globale affiche une case à cocher par type de donnée, chacune avec son décompte actuel (par exemple « 45 commandes, 5 groupes » ; « 28 conversations, 412 messages »). Cochez les types que vous souhaitez inclure.

Le panneau Export Everything — choisissez les éléments à inclure (clés API exclues) et enregistrez une sauvegarde complète

La boîte de dialogue Export All Data liste Commands, Spaces, History, Providers, Conversations et Settings — chacun avec un décompte du nombre d'éléments qu'il contient et une case à cocher. Une ligne récapitulative affiche le total sélectionné, et les boutons Cancel / Export… se trouvent en bas.

Étape 3 : Choisir l'emplacement et exporter​

  1. Cliquez sur Export….
  2. Choisissez un emplacement et un nom de fichier. Le nom par défaut inclut la date, par exemple rephlo-backup-2026-01-20.zip.
  3. Cliquez sur Save.

Étape 4 : Attendre la fin de l'opération​

Une boîte de dialogue de progression indique chaque phase au fur et à mesure — préparation des commandes, empaquetage des Spaces, exportation de l'historique, des fournisseurs, des conversations et des paramètres, puis enfin création de l'archive. Une fois terminé, un récapitulatif de ce qui a été exporté s'affiche. Vous pouvez annuler en cours d'exportation si besoin.

Importer vos données​

Étape 1 : Ouvrir l'importation globale​

  1. Accédez au menu File.
  2. Cliquez sur Import All Data…
  3. Sélectionnez votre fichier d'export .zip.

Étape 2 : Vérifier l'aperçu de l'importation​

Rephlo valide l'archive et lit son manifeste, puis affiche ce qui sera importé : la date de création de l'archive, la version de l'application qui l'a créée, le décompte par type de donnée, et les éventuels conflits. Si l'export provient d'une machine différente, un avertissement indique que les clés API des fournisseurs devront être ressaisies.

Le panneau Import Backup — déposez un fichier de sauvegarde, prévisualisez son contenu, et fusionnez ou remplacez

La boîte de dialogue Import All Data affiche le nom de l'archive, sa date de création et sa version en haut. En dessous, chaque type de donnée liste son nombre d'éléments, le nombre de conflits détectés, et un menu déroulant de résolution (Skip / Replace / Duplicate). History est ajouté plutôt que soumis à une résolution de conflit. Une bannière d'avertissement apparaît lorsque l'export a été créé sur une machine différente.

Étape 3 : Configurer la résolution des conflits​

Pour chaque type de donnée présentant des conflits, choisissez comment les traiter :

OptionComportement
SkipConserve vos données existantes ; n'importe pas les éléments en conflit
ReplaceÉcrase les données existantes avec les versions importées
DuplicateImporte sous forme de nouveaux éléments avec des noms modifiés (par exemple « Command (Imported) »)

Astuce : Utilisez Skip lors d'une fusion dans une installation déjà en place. Utilisez Replace lors de la restauration d'une sauvegarde sur une installation neuve. Les enregistrements d'History sont ajoutés, et non fusionnés par conflit.

Étape 4 : Importer​

  1. Cliquez sur Import.
  2. Une boîte de dialogue de progression indique chaque phase (commandes, Spaces, conversations, …).
  3. Consultez le récapitulatif une fois l'opération terminée.

Explication de la résolution des conflits​

Un conflit survient lorsqu'un élément importé porte le même nom ou identifiant qu'un élément existant.

Quand utiliser chaque option​

ScénarioOption recommandée
Restaurer une sauvegarde sur une installation neuveReplace
Fusionner des données provenant d'un collègueSkip ou Duplicate
Mettre à jour à partir d'une ancienne sauvegardeReplace
Essayer des commandes partagéesDuplicate

Structure du fichier ZIP​

Comprendre la structure de l'archive facilite le dépannage ou l'inspection manuelle :

Le fichier manifeste​

manifest.json enregistre :

  • La version du schéma (pour la compatibilité ascendante) et la version de l'application qui a créé l'export.
  • L'horodatage UTC de l'export.
  • Un identifiant machine haché, utilisé pour détecter les imports entre machines.
  • Les décomptes par type (commandes, Spaces, enregistrements d'historique, fournisseurs, conversations, messages, ainsi que le nombre de commandes/Spaces archivées) et la taille totale de l'archive.

Remarque sur les fournisseurs et les paramètres : les secrets des fournisseurs résident dans le dossier providers/ (chiffré), c'est pourquoi les clés liées aux fournisseurs sont volontairement exclues de l'export settings/ afin d'éviter les doublons.

Importation entre machines​

Lors de l'importation d'une archive créée sur un ordinateur différent :

Ce qui fonctionne normalement​

  • Commands (instructions, groupes, réglages)
  • Spaces (fichiers et contenu)
  • History (enregistrements d'utilisation)
  • Conversations (sessions de chat)
  • Settings (préférences)

Ce qui nécessite une attention particulière​

  • Clés API des fournisseurs — le chiffrement est spécifique à la machine. Après une importation entre machines, les fournisseurs concernés arrivent avec leurs clés effacées, et vous devez ressaisir chaque clé.

Pourquoi c'est intentionnel : les clés ne sont jamais exportées en texte brut, de sorte que vos identifiants restent protégés même si un fichier de sauvegarde est partagé par accident. Les fournisseurs Gateway (Dedicated API) ne sont pas exportés du tout — ils sont restaurés automatiquement lors de votre connexion.

Cas d'usage courants​

Sauvegarde complète avant réinstallation​

  1. File > Export All Data…
  2. Sélectionnez tous les types de données.
  3. Enregistrez sur un disque externe ou un espace de stockage cloud.
  4. Notez vos clés API séparément (elles ne peuvent pas être déchiffrées après une réinstallation).
  5. Après la réinstallation, utilisez File > Import All Data…
  6. Ressaisissez les clés API dans Paramètres.

Configurer un nouvel ordinateur​

  1. Sur l'ancien ordinateur, exportez toutes les données.
  2. Transférez le fichier ZIP vers le nouvel ordinateur.
  3. Installez Rephlo et importez le fichier ZIP.
  4. Ressaisissez les clés API pour chaque fournisseur.

Partager une configuration avec une équipe​

  1. Exportez avec Commands et Spaces sélectionnés.
  2. Désélectionnez History, Providers, Conversations et Settings (données personnelles).
  3. Partagez le fichier ZIP.
  4. Vos coéquipiers importent en utilisant Duplicate pour éviter d'écraser leurs propres commandes.

Une sauvegarde propre, respectueuse de la confidentialité​

Si vous souhaitez une sauvegarde sans données sensibles :

  1. Désélectionnez Providers (clés chiffrées), History (texte traité) et Conversations (messages de chat).
  2. Exportez uniquement Commands et Spaces.

Bonnes pratiques​

  1. Sauvegardes régulières — exportez chaque semaine ou avant des changements majeurs.
  2. Noms de fichiers explicites — incluez la date, par exemple rephlo-backup-2026-01-20.zip.
  3. Stockage sécurisé — conservez les sauvegardes dans un espace cloud chiffré ou sur un disque externe.
  4. Testez les restaurations — vérifiez de temps en temps qu'une sauvegarde s'importe correctement.
  5. Documentez vos clés API — conservez-les dans un gestionnaire de mots de passe ; elles ne peuvent pas être récupérées à partir d'une sauvegarde entre machines.
  6. Versionnez vos sauvegardes — conservez plus que la dernière en date.

Dépannage​

Erreur « Invalid archive » lors de l'importation

  • Le fichier ZIP est peut-être corrompu — retéléchargez-le ou recopiez-le.
  • Assurez-vous qu'il a été créé par l'exportation globale de Rephlo (il doit contenir manifest.json).

Données manquantes après l'importation

  • Vérifiez que le type de donnée a été sélectionné pour l'importation.
  • Vérifiez la résolution des conflits — des éléments ont peut-être été Skipped.

Le fournisseur affiche « API key required » après l'importation

  • C'est normal lors d'une importation depuis une machine différente. Ressaisissez la clé dans Settings > Providers.

L'importation semble lente

  • Les fichiers d'historique volumineux prennent plus de temps à traiter.
  • Les Spaces contenant de nombreux documents sont traités individuellement.
  • Envisagez d'exclure History pour accélérer l'importation.

Section suivante : Configurez Rephlo selon vos préférences dans Paramètres.