# 🧠 Guide de Configuration Smart Connections

## 🎉 Plugin Surprise
Vous avez aussi **Smart Connections** installé ! C'est un **RAG local sur votre wiki** : il indexe vos 146 pages et permet de **poser des questions** à votre propre base de connaissances.

## 🎯 À quoi ça sert ?

Imaginez pouvoir demander à votre wiki :
- *"Quelle est la différence entre Docker et Kubernetes ?"*
- *"Liste-moi les pages sur l'auto-hébergement"*
- *"Résume-moi le concept de PQC"*

Smart Connections fait exactement ça, **localement** (pas d'API externe), en utilisant des embeddings pour trouver les passages les plus pertinents.

## ⚙️ Configuration Initiale

### 1. Activer l'indexation
1. **Paramètres** $\rightarrow$ **Smart Connections**
2. Section **API Settings** :
   - **API Key** : votre clé OpenAI (ou autre provider)
   - **Model** : `text-embedding-3-small` (rapide, peu cher)
3. **Sauvegarder**

### 2. Première indexation
1. Ouvrir la **palette de commandes** (`Ctrl/Cmd + P`)
2. Taper : `Smart Connections: Rebuild Index`
3. Attendre 1-5 minutes (selon taille du vault)
4. Pour 146 pages, ~2 minutes

### 3. Utilisation
Une fois indexé :
- Dans chaque page, une **section "Smart Connections"** apparaît en bas
- Liste des pages **les plus similaires** automatiquement
- **Chat** (option payante ou via plugin supplémentaire) pour poser des questions

## 🚀 Cas d'Usage pour votre Wiki

### 1. Découverte de contenu
Quand vous ouvrez une page, Smart Connections suggère les **3-5 pages connexes** que vous n'auriez peut-être pas découvertes.

### 2. Navigation sémantique
Contrairement aux wikilinks (qui sont **explicites**), Smart Connections trouve des **liens cachés** entre pages.

Exemple : la page [[firewall]] pourrait suggérer [[vpn]] et [[zero-trust]] automatiquement, même si ces liens n'existent pas encore.

### 3. Question-Réponse (avec le chat)
Le **chat** intégré (disponible dans les versions récentes) permet de :
- Poser des questions sur votre wiki
- Obtenir des réponses sourcées (avec liens vers les pages)

## 💡 Workflow Recommandé

### Pendant la lecture
1. Ouvrez une page (ex: `[[transformer-architecture]]`)
2. Scrollez en bas : Smart Connections liste les pages similaires
3. Cliquez pour naviguer
4. Si une suggestion est pertinente, **ajoutez un vrai wikilink** (lien explicite)

### Pendant l'écriture
1. Créez une nouvelle page
2. Smart Connections vous suggère des pages existantes à lier
3. Ajoutez les wikilinks pertinents
4. **Double bénéfice** : votre recherche sémantique + votre graphe explicite s'enrichissent mutuellement

## 🆓 Alternatives Gratuites (sans API)

Si vous ne voulez pas payer OpenAI, vous pouvez utiliser :
- **Ollama** (local) avec `nomic-embed-text` (gratuit, privé)
- **LM Studio** avec un modèle d'embedding
- Configuration : **Paramètres** $\rightarrow$ **Smart Connections** $\rightarrow\) **Custom API** (OpenAI-compatible)

## 📊 Performance Attendue

Avec 146 pages :
- **Indexation** : 1-3 minutes
- **Coût OpenAI** : ~$0.01 (one-time)
- **Coût par recherche** : gratuit (embeddings en cache)
- **Stockage local** : ~5 Mo

## 📚 Ressources

- [Site officiel](https://smartconnections.app/)
- [Documentation](https://smartconnections.app/docs/)
- [Communauté Discord](https://discord.gg/smart-connections)

---

Avec Smart Connections, votre wiki passe de **base statique** à **base interrogable**. C'est le chaînon manquant entre documentation passive et assistant intelligent ! 🤖