v4.0.0
L'editor dove vivono gli agent.
v4.0 è la release maggiore agent-native author. Gli agent sono passati da "CLI esterno chiamato occasionalmente" a cittadini di prima classe dentro l'editor — presenti continuamente, lavorando attraverso più vault, visibilità completa, ripetibili, reversibili. Tutto sotto è nel core, nessun plugin necessario. L'installer è ancora ~15 MB.
Cinque pilastri
Ognuno è nel core, alternabile in impostazioni. Completamente compatibile con le tue note esistenti — nessuna migrazione DB, nessun nuovo formato file, nessun account cloud forzato.
1 · Pannello Agent integrato
Pannello di prima classe a destra, allo stesso livello di Outline / Backlinks /
Tags / History. Chat-with-vault streamato via interfaccia MCP intra-processo
e stack AI 14-provider esistente. Citazioni [[wikilink]]
si risolvono in salti di nota reali; ogni scheda di chiamata strumento
dell'agent si dispiega nel flusso di conversazione — vedi cosa è stato letto,
cosa è stato scritto. Risposta troppo lunga?
Pulsanti Inserisci e Copia lasciano cadere
il paragrafo intero nell'editor corrente — sostituisce selezione se presente,
altrimenti inserisce alla posizione del cursore. Cronologia esecuzione
persiste come markdown semplice sotto .solomd/agent-runs/,
grep-abile, git-tracciabile.
2 · Recipe Agent / esecuzione pianificata
Job agent dichiarativi, file YAML sotto
<workspace>/.solomd/agents/*.yml.
Trigger: schedule (cron), on-save,
on-commit, on-tag-add, manuale.
Guardrail di sicurezza non negoziabili: ogni esecuzione
parte sulla propria branch AutoGit
agent/<recipe>/<run-id>, tutte le scritture
atterrano solo sulla branch, passano per UI accept / reject prima del merge in main;
write-cap per esecuzione (predefinito 5, soffitto duro 50)
previene loop fuori controllo; Reject hard-delete la branch, quella
esecuzione è completamente invisibile nella cronologia git. Porta
11 template di Recipe (revisione settimanale, pulizia
log, estrazione TODO, traduzione, pulizia citazioni, revisione CJK,
…) — installare, modificare prompt, eseguire.
3 · Vista Trace Agent
Ogni esecuzione (sia conversazione Pannello sia Recipe) genera
trace.jsonl per passo:
prompt / model_call /
tool_call / tool_result /
git_commit / done.
Schede di passo si dispiegano per mostrare args, risultati, conteggi
token, stime costi, riferimenti branch AutoGit.
Pulsante Replay-from-step riavvolge esecuzione al passo N,
cambia input e ri-esegue da lì — quella è l'entrata ai recipes
self-correcting. Nuovo strumento MCP
read_agent_trace(run_id) espone il trace ad altri agent.
4 · Federazione MCP multi-vault
solomd-mcp --workspace path1 --workspace path2 --workspace path3
—— una sessione MCP, più vault. Le firme degli strumenti hanno guadagnato
parametro workspace opzionale, predefinito = primo passato
(completamente back-compat con client MCP single-vault). Branch AutoGit
isolate per workspace. Impostazioni → Integrazioni
ha UI di profilo MCP: empacchettare più vault nominati, copiare
snippet di config Claude Desktop con un clic.
5 · Ollama prima classe
Non empacchettiamo noi stessi il runtime LLM locale
—— Ollama lo fa già bene. v4.0 ha solo lucidato l'integrazione:
auto-rilevamento su localhost:11434 (Impostazioni → AI ha
indicatore di stato verde), guida installazione con un clic se non installato,
3 preset di modello incorporati (rewrite → qwen2.5:7b ·
quick → qwen2.5:1.5b ·
cjk → qwen2.5:14b), pull raccomandato inline quando l'elenco
di modelli è vuoto. Recipes possono specificare provider: local
(alias Ollama), per loop di automazione senza costo cloud.
Le tue note non lasciano mai la macchina —— via BYOK Ollama
questo è sempre stato vero, v4.0 lo rende un'entrata scopribile.
🛡️ Guardrail di sicurezza (cosa nessun altro fa)
- Sandbox di branch AutoGit. Ogni esecuzione di Recipe
inizia sulla propria branch. Prima che tu clicchi Accetta,
mainnon si muove. Esecuzioni Reject non lasciano nulla —— branch cancellata, albero file riavvolto. - Soffitto di scrittura per esecuzione. Modello vuole scrivere 50 file quando il cap è 5, dalla 6ª chiamata strumento in poi è rifiutato. Nessuno stato "semi-finito", nessuna modifica massiva accidentale.
- Rifiuta di partire quando il workspace è dirty. Hai modifiche non commitate, il trigger Recipe scatta, esce con errore, il tuo WIP non viene spazzato in commit di agent.
- Indurimento path-traversal. Interfaccia strumento
intra-processo e tutti i comandi Tauri che accettano
run_id/pathforniti dall'utente ora rifiutano in anticipo segmenti..e percorsi assoluti. A livello di codice, l'agent non può scrivere fuori dal workspace. - Trace ripetibile. Ogni passo atterra riga per riga come JSON su disco. Comportamento Pannello sospetto? Seguire il trace, localizzare il passo cattivo, cambiare input, riprodurre dal passo N–1.
Barra qualità
- Wizard di prima esecuzione. I nuovi utenti vedono il pannello Agent in meno di 60 secondi —— ti guida a inserire chiave BYOK o installare Ollama. Riapri da Aiuto più tardi.
- Cookbook di Recipe (11 template starter). Impostazioni → Recipes → Sfoglia cookbook. Revisione settimanale, log giornaliero, estrazione TODO, passaggio di traduzione, pulizia citazioni, agent di revisione CJK, rilevatore link rot, normalizzatore frontmatter, outline-a-blog, passaggio refactor, triage settimanale tag. Installare, modificare prompt, eseguire.
- API REST locale (ascolta solo su localhost, autenticazione token). Stessa interfaccia di MCP, per client che non parlano ancora MCP — Alfred / Raycast / n8n / i tuoi script.
- Contatore costi BYOK. Token spesi cumulati per provider, opt-in. Impostazioni → Integrazioni.
- Localizzazione. 9 lingue UI copertura completa (en/zh/ja/ko/de/fr/es/pt/it). Questa release ha aggiunto 5 lingue europee — tedesco, francese, spagnolo, portoghese, italiano — tutte con la stessa parità di chiavi del dizionario di en/zh.
Polish UX percepito dal primo giorno
- Guardie IME ovunque. Pinyin cinese, modalità kana giapponese, hangul coreano — Enter per confermare parole candidate non innesca più accidentalmente invio conversazione / rinomina file tree / esecuzione tavolozza comandi / apertura ricerca. Fix unico per 7 pannelli di input.
- Pulsanti Insert / Copy per risposte Assistant. Due pulsanti sotto ogni risposta finita. Insert è editor-selezione-aware (con selezione sostituisce), senza selezione inserisce alla posizione del cursore. Copy è clipboard normale.
- UX di avvio macOS. Timing di attivazione all'avvio corretto —— SoloMD avvio a freddo arriva davvero in primo piano, non si nasconde più dietro Finder. Ripristino posizione finestra atterra sempre nel workspace dello schermo corrente; ripristino da cattivo cache dopo disconnessione di schermo secondario si ricentra automaticamente, invece di aprire fuori schermo.
- "Generazione..." bloccato senza errore. Corretto. Errore di configurazione provider (es. Ollama con modello non scaricato) lasciava il pannello appeso. Ora vedi una barra di errore rossa con la risposta reale del backend, anche il pulsante invia torna.
Cosa v4.0 esplicitamente non fa (e perché)
Dire no è anche parte del prodotto. Queste sono state seriamente considerate ed esplicitamente non fatte:
- Portare il nostro runtime LLM locale. Ollama lo fa già bene; reinventare la ruota viola il principio "scrivere meno codice da mantenere permanentemente". Provider BYOK rimane il percorso.
- Marketplace Recipe online. Operazione server + moderazione contenuti = deviazione dalla linea principale. Cookbook empacchettati direttamente nelle release, aggiornati con lo strumento.
- Multi-utente / agent di team. Viola "una finestra, un scrittore". Questo prodotto è per autore singolo; la collaborazione appartiene a un altro prodotto.
- Completamento ghost-text stile Copilot. Posizionamento di brand diverso. Ghost-text diluisce la voce dello scrittore; i nostri agent lavorano in unità di vault, scritture sono in batch + esaminabili + branch-based.
Note di upgrade
- Nessuna modifica di formato file.
.mdesistenti, cronologia AutoGit, configurazione sync, chiavi BYOK tutti preservati come sono. - Pannello Agent acceso automaticamente alla prima esecuzione.
Gli utenti v3.6.x potrebbero avere un
showAgentPanel: falsenascosto a causa del default dello scaffold del periodo v4-beta; migrazione unica lo capovolge a true, vedi davvero la funzionalità principale. Se non la vuoi, puoi spegnerla via⌘⇧P → View: Toggle Agent Panel. - Il pannello Impostazioni ha due nuove tab Recipes e Contatore costi, sotto Integrazioni. Posizioni di impostazioni esistenti invariate.
- Il server MCP (
solomd-mcp) ha guadagnato nuovo parametro--workspace(ripetibile). I client MCP single-workspace esistenti continuano a funzionare; il comportamento di federazione è opt-in.
🔮 Cosa viene dopo
5 pilastri principali + barra qualità sono il contenuto principale questa volta. Le direzioni aperte per v4.x e oltre sono tutte nella roadmap: API di script sandboxata, CLI v2 (rewrite / commit / ricerca semantica / trigger Recipe nel terminale), e la domanda sempre rimandata "SoloMD dovrebbe diventare un prodotto commerciale?" (sync a pagamento — vecchia domanda dell'era v3.0, ancora senza risposta, finché non si decide, nessuna ingegneria sarà fatta in quest'area).
Grazie a tutti coloro che durante il periodo silenzioso hanno inviato issue / mandato PR / fatto girare build v4-beta con vault reali. v4.0 ha potuto essere spedita perché il dogfood ha scoperto i bug che i test di integrazione hanno mancato. Versioni precedenti: Vedi il blog (en) →