Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,88 @@
+# 🧠 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 ! 🤖