Qu'est-ce qu'une recipe (v4) ?
Un fichier YAML sous <workspace>/.solomd/agents/*.yml. Un fichier = un job d'agent. Champs requis : name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Optionnel : schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD livre 11 starters dans Paramètres → Recipes → Parcourir le cookbook — en installer un, l'éditer, l'exécuter. Le schéma complet vit dans docs/agents.md.
Les écritures d'agent sont-elles sûres ?
Chaque exécution de recipe commence en branchant depuis main : agent/<recipe>/<run-id>. Les écritures atterrissent uniquement sur cette branche. En cas de succès, l'exécution va dans Pending — examiner le diff et cliquer Accepter (fast-forward dans main) ou Rejeter (supprimer entièrement la branche). Une exécution rejetée laisse zéro trace dans votre historique. Les écritures imposent aussi un cap par exécution (par défaut 5, plafond dur 50) — un modèle qui demande à écrire 100 fichiers quand le cap est 5 obtient des refus au 6e appel, sans état semi-appliqué.
En quoi est-ce différent du ghost-text Cursor ou Copilot ?
Cursor et Copilot sont géniaux pour la complétion de code au niveau frappe. Les agents SoloMD sont différents en trois points : (1) l'unité de travail est le *vault*, pas le curseur — les agents lisent à travers les notes via wikilinks, backlinks, recherche full-text et tag ; (2) les écritures sont batchées + examinables, pas du ghost-text que vous acceptez inline ; (3) les agents peuvent tourner sur planning quand vous n'êtes pas au clavier (revue hebdo, résumé quotidien, triage on-tag). C'est plus proche du mode Agent / Composer de Cursor que de l'autocomplétion inline — et explicitement pas une autocomplétion de style d'écriture (nous croyons que le ghost-text dilue la voix de l'écrivain).
Les recipes ont-elles besoin d'une clé API ?
Seulement si la recipe spécifie un provider cloud. Pour provider: ollama (ou l'alias local), pas de clé nécessaire — qwen2.5:1.5b tourne gratuitement sur votre machine. Pour provider: claude / openai / gemini / etc, vous avez besoin de la clé de ce provider dans Paramètres → IA (BYOK). Le wizard de premier lancement vous guide à travers chaque chemin.
En quoi la recherche sémantique de SoloMD est-elle différente de grep ?
Grep matche les caractères ; la recherche sémantique matche le sens. Cherchez « deployment » et vous pouvez aussi faire surface des paragraphes sur « rolling out », « shipping », « release ». L'embedder tourne entièrement dans notre processus Rust — pas de téléchargement de fichier modèle, pas d'appel réseau, pas de cloud. Désactivée par défaut ; activer le bouton dans Paramètres pour opt-in. L'index vit dans <workspace>/.solomd/embeddings.sqlite (auto-gitignored).
SoloMD est-il vraiment gratuit ?
Oui. SoloMD est un logiciel open source sous licence MIT. Il n'y a pas de palier payant, pas de compte, pas de télémétrie par défaut, pas de pubs. S'il aide votre écriture, vous pouvez sponsoriser le développeur, mais vous n'êtes jamais obligé.
Où vivent les clés API pour les 14 providers IA ?
Dans votre trousseau OS — Apple Keychain sur macOS, Credential Manager sur Windows, libsecret sur Linux. Jamais dans localStorage, jamais dans un fichier de config que SoloMD écrit. Les requêtes IA vont directement de votre machine au provider que vous avez choisi ; SoloMD n'héberge aucun modèle ni ne relaie aucun trafic.
Quelle est la taille de l'installateur ?
Environ 10–15 Mo selon la plateforme. C'est environ 6× plus petit que Typora et 7× plus petit qu'Obsidian, parce que SoloMD utilise Tauri (webview système + Rust) au lieu d'embarquer Chromium.
Fonctionne-t-il hors ligne ?
Oui, complètement. L'éditeur lui-même fait zéro requête réseau. La recherche sémantique est locale uniquement. AutoGit committe vers un repo local et ne push jamais automatiquement. Le seul trafic sortant est (1) la vérification optionnelle de mise à jour GitHub release au démarrage (désactivable dans Paramètres) et (2) les appels de réécriture IA que vous déclenchez explicitement, qui vont directement au provider que vous avez choisi.
Comment fonctionne le serveur MCP ?
Un seul binaire sidecar de 1,5 Mo (solomd-mcp) parle le Model Context Protocol via stdio — pas de port réseau. Pointez Claude Desktop, Cursor ou n'importe quel client MCP vers votre workspace et il obtient 8 outils de lecture (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) plus 2 outils d'écriture derrière --allow-write. Path-traversal protégé, confinement workspace-canonical.
Comment SoloMD gère-t-il les fichiers non-UTF-8 comme GBK / Big5 ?
SoloMD auto-détecte l'encodage en utilisant la crate Rust chardetng quand vous ouvrez un fichier. UTF-8, UTF-16 LE/BE (avec ou sans BOM), GBK, GB18030, Big5, Shift_JIS et beaucoup d'autres sont reconnus et correctement affichés.
Puis-je synchroniser mes notes sur d'autres appareils ?
Pas encore — la sync CRDT intégrée est sur la roadmap v3. Pour l'instant, SoloMD fonctionne parfaitement avec iCloud Drive, Dropbox, OneDrive, Syncthing ou tout outil de sync basé sur dossier. Sauvegardez juste vos notes dans un dossier synchronisé. Ou utilisez AutoGit + push manuel vers GitHub.
Pourquoi n'y a-t-il pas de plugins ?
SoloMD omet intentionnellement un système de plugins pour rester léger, stable et facile à auditer. Les fonctionnalités que les écrivains sérieux demandent — recherche sémantique, historique de versions, réécriture IA, coller image, KaTeX, Mermaid, mode focus, CSS personnalisé — sont toutes livrées dans le core.
Pourquoi « Windows a protégé votre PC » est-il apparu au premier lancement ?
SoloMD est un petit projet open source qui n'a pas encore construit de réputation Microsoft SmartScreen. Cliquer « Plus d'infos → Exécuter quand même » une fois et il ne demandera plus. Nous travaillons sur un certificat de signature de code.
Comment ouvrir les fichiers .md avec SoloMD par défaut ?
Clic droit sur n'importe quel fichier .md → Ouvrir avec → SoloMD → cocher « Toujours utiliser cette app ». L'installateur empaqueté enregistre SoloMD comme handler pour les extensions .md, .markdown, .mdown, .mkd et .txt.
Quelle est la différence entre SoloMD et Obsidian ?
Obsidian est un outil de gestion de connaissances avec vaults, liens wiki, backlinks, vue graphique et marketplace de plugins. SoloMD est un éditeur léger pour écrire des fichiers Markdown — mais il livre certaines choses qu'Obsidian n'a pas (recherche sémantique dans le core, AutoGit, serveur MCP, 14 providers IA dans un panneau). Utilisez Obsidian si vous voulez un second cerveau avec marketplace de plugins ; utilisez SoloMD si vous voulez les outils d'écriture sans la plugin tax.