Repository Public
1<!--2SP Chat — native macOS3File: docs/INSTALL.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Installation891. Télécharge `SPChat-1.0.0.dmg` (release v1.0.0 sur git.spboucher.ai). Empreinte SHA-256 : fichier `SPChat-1.0.0.dmg.sha256`.102. Ouvre l'image disque et **glisse SP Chat dans Applications**.113. Lance SP Chat **depuis le dossier Applications**. Gatekeeper l'accepte sans avertissement particulier : l'app et le DMG sont signés Developer ID et notarisés par Apple (ticket agrafé, vérifiable hors ligne).124. Clique « Continuer avec ma clé d'accès » : macOS propose la clé d'accès de `chat.spboucher.ai` (trousseau iCloud, Touch ID). Tu retrouves l'historique du site.1314Configuration requise : macOS 15 ou plus récent, Mac Apple Silicon ou Intel, connexion Internet pour se connecter (l'historique déjà consulté reste lisible hors ligne).1516## Sur un autre Mac1718- **Même compte iCloud, trousseau activé** : la clé d'accès est déjà synchronisée, la connexion fonctionne directement.19- **Autre Mac sans la clé** : dans SP Chat, « Première connexion sur ce Mac, ou code de récupération », saisis un code de récupération (Réglages → Sécurité sur un appareil connecté) ou un code créé sur le serveur (`pnpm auth bootstrap --recover`), puis enregistre une clé d'accès pour ce Mac. Autre possibilité : choisir « un autre appareil » dans la feuille macOS et scanner le code QR avec l'iPhone qui détient la clé.2021## Dépannage2223| Symptôme | Cause | Remède |24|---|---|---|25| « macOS n'a pas (encore) validé l'association entre cette application et le domaine des clés d'accès » | Le service système qui valide le lien app ↔ `chat.spboucher.ai` n'a pas pu lire l'app. **Cas constaté** : app lancée depuis un dossier protégé (Bureau, Documents, Téléchargements) ou depuis l'image disque, ou plusieurs copies de l'app enregistrées sur le Mac | Mets l'app dans `/Applications`, supprime les autres copies, relance. La validation demande Internet au premier lancement (quelques secondes) |26| La feuille Touch ID ne propose aucune clé | La clé d'accès n'est pas sur ce Mac | Voir « Sur un autre Mac » |27| « Session terminée » au lancement | Session révoquée ou expirée (30 jours d'inactivité, 90 jours au total) | Se reconnecter avec la clé d'accès |28| Bandeau « Hors ligne — cache local » | Serveur ou réseau injoignable | Les conversations déjà ouvertes restent lisibles ; l'envoi reprend au retour du réseau |29| Aucune fenêtre après un arrêt forcé | — | Corrigé en 1.0.0 : une fenêtre principale est toujours rouverte au lancement ; cliquer l'icône du Dock en rouvre une |3031## Désinstaller3233Glisse l'app à la corbeille. Données locales : `~/Library/Containers/ai.spboucher.spchat` (cache, préférences) et l'élément « ai.spboucher.spchat » du trousseau (jeton de session). « Se déconnecter de ce Mac » efface le cache et révoque la session côté serveur.34