📖 Guide d'utilisation ATBClone (Version française)¶

Démo de l'interface ATBClone

Bienvenue dans le Guide officiel d'utilisation d'ATBClone. Ce manuel vous accompagne pas à pas dans la création d'instances multiples et l'isolation en bac à sable (sandbox) d'applications macOS — des opérations de base pour débutants aux analyses architecturales avancées et diagnostics système.

🧭 Plan du guide¶

Chapitre	Titre	Public visé	Points clés
Chapitre 1	Opérations de base & Gestion des clones	👶 Débutants / Tous utilisateurs	Assistant en 7 étapes, lancement, ouverture directe du dossier de données, mises à jour synchronisées sans perte de données, vue tableau (mises à jour et suppressions par lot), suppression sécurisée.
Chapitre 2	Recettes personnalisées & Paramètres de base	⚡ Utilisateurs intermédiaires	Utilisation d'App Prober (Sonde intelligente) pour analyser des apps non répertoriées, éditeur visuel de recettes, paramètres essentiels (`bundle_id`, `strategy`, `strip_sandbox`, `proxy`).
Chapitre 3	Fonctionnement interne & Paramètres avancés	🔬 Experts / Développeurs	Mécanismes Soft vs Hard Clone, piliers du Hard Clone & détournement de wrapper binaire, architecture données-logique découplée, paramètres YAML avancés (`environment_injection`, `symlink_whitelist`, macros de chemin).
Chapitre 4	FAQ, Diagnostic système & Support	🩺 Tous utilisateurs	FAQ fréquentes (sécurité des données, chemins de stockage & migration, prévention des bannissements, fonctionnement sans droits root), diagnostic Doctor, copie des détails du clone & signalement d'issues GitHub.

🌟 Pourquoi choisir ATBClone ?¶

Sur macOS, les méthodes traditionnelles de clonage (comme une simple copie par cp -R ou des alias dans le Terminal) échouent fréquemment car les applications modernes partagent leurs préférences utilisateur, bases de données SQLite et trousseaux d'accès au niveau système.

ATBClone résout ce problème grâce à une quadruple isolation (Quadruple Isolation) native :

graph TD
    A[Moteur d'isolation ATBClone] --> B[1. Isolation des données & du cache]
    A --> C[2. Identité visuelle & Dock indépendante]
    A --> D[3. Permissions de sécurité macOS TCC]
    A --> E[4. Isolation du trafic réseau par proxy]

    B --> B1["$HOME et $TMPDIR indépendants, aucun verrouillage de base de données"]
    C --> C1["Icône de Dock dédiée, nom personnalisé, recherche Spotlight native"]
    D --> D1["Autorisations micro, caméra et disque gérées séparément"]
    E --> E1["Routage proxy HTTP/SOCKS5 dédié par clone (anti-fingerprinting)"]

📦 Isolation des données & du cache : Chaque clone dispose de son propre répertoire personnel isolé ($HOME) ou --user-data-dir. Plusieurs comptes peuvent s'exécuter en parallèle sans conflit de bases de données ou de cache.
🎨 Identité visuelle & Dock indépendante : Les clones possèdent leurs propres noms et icônes, et apparaissent de manière autonome dans Spotlight, le Launchpad et le Dock.
🛡️ Permissions de sécurité (TCC) isolées : Grâce à des identifiants CFBundleIdentifier uniques, macOS considère chaque clone comme une entité distincte avec ses propres autorisations système.
🌐 Isolation réseau par proxy : Acheminez le trafic de certains clones via des proxys HTTP ou SOCKS5 distincts sans altérer la connexion réseau de l'hôte.

📚 Concepts clés & Glossaire¶

Application hôte (Host App) : L'application d'origine installée sur votre Mac (généralement dans /Applications).
Application clonée (Clone App) : L'instance générée par ATBClone (par défaut dans ~/ATBClone/Apps).
Hard Clone (Duplication physique & détournement de wrapper) : Copie complète du bundle, modification du Bundle ID, injection de scripts d'environnement et re-signature. Recommandé pour WeChat, Telegram, Slack et Discord.
Soft Clone (Wrapper de lanceur) : Crée un lanceur léger transmettant des arguments de données isolés (--user-data-dir). Idéal pour les navigateurs et éditeurs de code (Cursor, VS Code, Chrome).
Recette (Recipe) : Fichier YAML décrivant les règles de clonage et d'isolation d'une application.
Répertoire de données isolé : Dossier où sont stockés les discussions, réglages et caches (par défaut ~/ATBClone/Data/<NomDuClone>).

🚀 Démarrage rapide¶

Téléchargement & Installation : Téléchargez ATBClone-*.dmg depuis les GitHub Releases et glissez ATBClone.app dans /Applications.
Lancement : Ouvrez ATBClone depuis le Launchpad.
Assistant : Cliquez sur "+ Nouveau clone" en haut à droite.
Suivez les 7 étapes : Choisissez l'application ➔ Vérifiez la recette ➔ Nommez le clone ➔ Validez les chemins ➔ "Cloner maintenant".
Profitez : Cliquez sur "Lancer" ou démarrez votre clone via Spotlight !