Cos'è un recipe (v4)?
Un file YAML sotto <workspace>/.solomd/agents/*.yml. Un file = un job agent. Campi richiesti: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Opzionali: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD spedisce 11 starter in Impostazioni → Recipes → Sfoglia cookbook — installane uno, modificalo, eseguilo. Lo schema completo vive in docs/agents.md.
Le scritture agent sono sicure?
Ogni esecuzione di recipe inizia ramificando da main: agent/<recipe>/<run-id>. Le scritture atterrano solo su quella branch. Al successo l'esecuzione va in Pending — esamina il diff e clicca Accetta (fast-forward in main) o Rifiuta (cancella la branch interamente). Un'esecuzione rifiutata lascia zero tracce nella tua cronologia. Le scritture impongono anche un cap per esecuzione (predefinito 5, soffitto duro 50) — un modello che chiede di scrivere 100 file quando il cap è 5 ottiene rifiuti dal 6° call, senza stato semi-applicato.
In cosa è diverso questo dal ghost-text di Cursor o Copilot?
Cursor e Copilot sono ottimi per il completamento codice a livello di tasto. Gli agent SoloMD sono diversi in tre modi: (1) l'unità di lavoro è il *vault*, non il cursore — gli agent leggono attraverso le note via wikilinks, backlinks, ricerca full-text e tag; (2) le scritture sono in batch + esaminabili, non ghost-text che accetti inline; (3) gli agent possono girare in pianificazione quando non sei alla tastiera (revisione settimanale, riepilogo giornaliero, triage on-tag). È più vicino alla modalità Agent / Composer di Cursor che al completamento inline — ed esplicitamente non è un completamento di stile di scrittura (crediamo che il ghost-text diluisca la voce dello scrittore).
I recipes hanno bisogno di una chiave API?
Solo se il recipe specifica un provider cloud. Per provider: ollama (o l'alias local), nessuna chiave necessaria — qwen2.5:1.5b gira gratis sulla tua macchina. Per provider: claude / openai / gemini / etc, hai bisogno della chiave di quel provider in Impostazioni → AI (BYOK). Il wizard di prima esecuzione ti guida attraverso ogni percorso.
Come la ricerca semantica di SoloMD differisce da grep?
Grep matcha caratteri; la ricerca semantica matcha significato. Cerca "deployment" e puoi anche far emergere paragrafi su "rolling out", "shipping", "release". L'embedder gira interamente nel nostro processo Rust — nessun download di file modello, nessuna chiamata di rete, nessun cloud. Spenta predefinita; gira l'interruttore in Impostazioni per opt-in. L'indice vive in <workspace>/.solomd/embeddings.sqlite (auto-gitignored).
SoloMD è davvero gratis?
Sì. SoloMD è software open-source con licenza MIT. Non c'è livello a pagamento, nessun account, nessuna telemetria predefinita, nessuna pubblicità. Se aiuta la tua scrittura puoi sponsorizzare lo sviluppatore, ma non sei mai obbligato.
Dove vivono le chiavi API per i 14 provider AI?
Nel tuo portachiavi OS — Apple Keychain su macOS, Credential Manager su Windows, libsecret su Linux. Mai in localStorage, mai in un file di config che SoloMD scriva. Le richieste AI vanno dirette dalla tua macchina al provider che hai scelto; SoloMD non ospita nessun modello né rilancia traffico.
Quanto è grande l'installer?
Circa 10–15 MB a seconda della piattaforma. È circa 6× più piccolo di Typora e 7× più piccolo di Obsidian, perché SoloMD usa Tauri (webview di sistema + Rust) invece di empacchettare Chromium.
Funziona offline?
Sì, completamente. L'editor stesso fa zero richieste di rete. La ricerca semantica è solo locale. AutoGit fa commit in un repo locale e non fa mai auto-push. L'unico traffico in uscita è (1) il controllo opzionale di aggiornamento release GitHub all'avvio (spento in Impostazioni) e (2) le chiamate di riscrittura AI che attivi esplicitamente, che vanno dirette al provider che hai scelto.
Come funziona il server MCP?
Un singolo binario sidecar di 1,5 MB (solomd-mcp) parla il Model Context Protocol via stdio — nessuna porta di rete. Punta Claude Desktop, Cursor o qualsiasi client MCP al tuo workspace e ottiene 8 strumenti di lettura (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) più 2 strumenti di scrittura dietro --allow-write. Path-traversal protetto, contenimento workspace-canonical.
Come SoloMD gestisce file non UTF-8 come GBK / Big5?
SoloMD auto-rileva la codifica usando la crate Rust chardetng quando apri un file. UTF-8, UTF-16 LE/BE (con o senza BOM), GBK, GB18030, Big5, Shift_JIS e molti altri sono riconosciuti e visualizzati correttamente.
Posso sincronizzare le mie note ad altri dispositivi?
Non ancora — la sync CRDT integrata è nella roadmap v3. Per ora SoloMD funziona perfettamente con iCloud Drive, Dropbox, OneDrive, Syncthing o qualsiasi strumento di sync basato su cartella. Salva semplicemente le tue note dentro una cartella sincronizzata. O usa AutoGit + push manuale a GitHub.
Perché non ci sono plugin?
SoloMD omette intenzionalmente un sistema di plugin per restare leggero, stabile e facile da auditare. Le funzionalità che gli scrittori seri chiedono — ricerca semantica, cronologia versioni, riscrittura AI, incolla immagine, KaTeX, Mermaid, modalità focus, CSS personalizzato — vengono tutte nel core.
Perché "Windows ha protetto il PC" è apparso al primo avvio?
SoloMD è un piccolo progetto open-source che non ha ancora costruito reputazione Microsoft SmartScreen. Clicca "Maggiori informazioni → Esegui comunque" una volta e non ti chiederà di nuovo. Stiamo lavorando a un certificato di firma codice.
Come apro file .md con SoloMD predefinito?
Clic destro su qualsiasi file .md → Apri con → SoloMD → spunta "Usa sempre questa app". L'installer empacchettato registra SoloMD come handler per le estensioni .md, .markdown, .mdown, .mkd e .txt.
Qual è la differenza tra SoloMD e Obsidian?
Obsidian è uno strumento di gestione conoscenza con vault, link wiki, backlinks, vista grafico e marketplace di plugin. SoloMD è un editor leggero per scrivere file Markdown — ma spedisce alcune cose che Obsidian non ha (ricerca semantica nel core, AutoGit, server MCP, 14 provider AI in un pannello). Usa Obsidian se vuoi un secondo cervello con marketplace di plugin; usa SoloMD se vuoi gli strumenti di scrittura senza il plugin tax.