SPB Git

Repository Public

INSTALL.md 2.9 KB

# Installation

  1. 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.
  2. Ouvre l'image disque et glisse SP Chat dans Applications.
  3. 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).
  4. 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.

Configuration 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).

# Sur un autre Mac

  • Même compte iCloud, trousseau activé : la clé d'accès est déjà synchronisée, la connexion fonctionne directement.
  • 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é.

# Dépannage

Symptôme Cause Remède
« 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)
La feuille Touch ID ne propose aucune clé La clé d'accès n'est pas sur ce Mac Voir « Sur un autre Mac »
« 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
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
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

# Désinstaller

Glisse 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.

Files main
Menu

Theme