✨ Experimente nossa plataforma de escrita de romances com IA → StoryAlter.com
#MD SoloMD

v4.0.0

O editor onde os agentes vivem.

v4.0 é a release maior agent-native author. Os agentes passaram de "CLI externo chamado ocasionalmente" a cidadãos de primeira classe dentro do editor — presentes continuamente, trabalhando através de múltiplos vaults, visibilidade completa, reproduzíveis, reversíveis. Tudo abaixo está no core, sem necessidade de plugins. Instalador continua ~15 MB.

Cinco pilares

Cada um está no core, alternável nas configurações. Totalmente compatível com suas notas existentes — sem migração de DB, sem novo formato de arquivo, sem conta cloud forçada.

1 · Painel Agent embutido

Painel de primeira classe à direita, no mesmo nível de Outline / Backlinks / Tags / History. Chat-with-vault em streaming via interface MCP intra-processo e stack AI 14-providers existente. Citações [[wikilink]] resolvem para saltos de nota reais; cada cartão de chamada de ferramenta do agente se desdobra no fluxo de conversação — você vê o que foi lido, o que foi escrito. Resposta muito longa? Botões Inserir e Copiar deixam cair o parágrafo inteiro no editor atual — substitui seleção se houver, senão insere na posição do cursor. Histórico de execução persiste como markdown puro sob .solomd/agent-runs/, grep-ável, git-trackável.

2 · Recipe Agent / execução agendada

Tarefas de agente declarativas, arquivos YAML sob <workspace>/.solomd/agents/*.yml. Triggers: schedule (cron), on-save, on-commit, on-tag-add, manual. Trilhos de segurança inegociáveis: cada execução começa em sua própria branch AutoGit agent/<recipe>/<run-id>, todas as escritas aterrissam apenas na branch, passam por UI accept / reject antes do merge no main; write-cap por execução (padrão 5, teto duro 50) previne loops descontrolados; Reject hard-delete a branch, essa execução é completamente invisível no histórico git. Traz 11 templates de Recipe (revisão semanal, limpeza de log, extração TODO, tradução, limpeza de citações, revisão CJK, …) — instalar, editar prompt, executar.

3 · Visualização Trace Agent

Cada execução (seja conversa Painel ou Recipe) gera trace.jsonl por etapa: prompt / model_call / tool_call / tool_result / git_commit / done. Cartões de etapa se desdobram para mostrar args, resultados, contagens de tokens, estimativas de custo, referências de branch AutoGit. Botão Replay-from-step rebobina execução para etapa N, muda entrada e re-executa de lá — essa é a entrada para recipes self-correcting. Nova ferramenta MCP read_agent_trace(run_id) expõe trace a outros agentes.

4 · Federação MCP multi-vault

solomd-mcp --workspace path1 --workspace path2 --workspace path3 —— uma sessão MCP, múltiplos vaults. Assinaturas de ferramenta ganharam parâmetro workspace opcional, padrão = primeiro passado (totalmente back-compat com clientes MCP single-vault). Branches AutoGit isoladas por workspace. Configurações → Integrações tem UI de perfil MCP: empacotar múltiplos vaults nomeados, copiar snippet de config Claude Desktop com um clique.

5 · Ollama primeira classe

Não empacotamos o runtime LLM local nós mesmos —— Ollama já faz bem. v4.0 só poliu a integração: auto-detecção em localhost:11434 (Configurações → AI tem indicador de status verde), guia de instalação com um clique se não instalado, 3 presets de modelo embutidos (rewrite → qwen2.5:7b · quick → qwen2.5:1.5b · cjk → qwen2.5:14b), pull recomendado inline quando a lista de modelos está vazia. Recipes podem especificar provider: local (alias Ollama), para loops de automação sem custo cloud. Suas notas nunca saem da máquina —— via BYOK Ollama isso sempre foi verdade, v4.0 torna uma entrada descobrível.

🛡️ Trilhos de segurança (o que ninguém mais faz)

  • Sandbox de branch AutoGit. Cada execução de Recipe começa em sua própria branch. Antes de você clicar Aceitar, main não se move. Execuções Reject não deixam nada —— branch apagada, árvore de arquivos rebobinada.
  • Teto de escrita por execução. Modelo quer escrever 50 arquivos quando o cap é 5, da 6ª chamada de ferramenta em diante é rejeitado. Sem estado "meio-pronto", sem modificações em massa acidentais.
  • Recusa iniciar quando o workspace está sujo. Você tem mudanças não commitadas, o trigger Recipe dispara, sai com erro, seu WIP não é varrido em commits de agente.
  • Endurecimento path-traversal. Interface de ferramenta intra-processo e todos os comandos Tauri que aceitam run_id / path fornecidos pelo usuário agora rejeitam antecipadamente segmentos .. e caminhos absolutos. Em nível de código, o agent não pode escrever fora do workspace.
  • Trace reproduzível. Cada etapa aterrissa linha por linha como JSON em disco. Comportamento Painel suspeito? Seguir o trace, localizar a etapa ruim, mudar entrada, reproduzir da etapa N–1.

Barra de qualidade

  • Wizard de primeira execução. Novos usuários veem o painel Agent em menos de 60 segundos —— te guia para preencher chave BYOK ou instalar Ollama. Reabrir do Ajuda mais tarde.
  • Cookbook de Recipe (11 templates starter). Configurações → Recipes → Explorar cookbook. Revisão semanal, log diário, extração TODO, passagem de tradução, limpeza de citações, agente de revisão CJK, detector de link rot, normalizador de frontmatter, outline-para-blog, passagem de refactor, triagem semanal de tags. Instalar, editar prompt, executar.
  • API REST local (escuta apenas em localhost, autenticação por token). Mesma interface que MCP, para clientes que ainda não falam MCP — Alfred / Raycast / n8n / seus próprios scripts.
  • Medidor de custo BYOK. Tokens gastos acumulados por provider, opt-in. Configurações → Integrações.
  • Localização. 9 idiomas UI cobertura completa (en/zh/ja/ko/de/fr/es/pt/it). Esta release adicionou 5 idiomas europeus — alemão, francês, espanhol, português, italiano — todos com a mesma paridade de chaves de dicionário que en/zh.

Polimento UX sentido desde o primeiro dia

  • Guardas IME em todo lugar. Pinyin chinês, modo kana japonês, hangul coreano — Enter para confirmar palavras candidatas não dispara mais acidentalmente envio de conversa / renomeio de file tree / execução de paleta de comandos / abertura de busca. Fix único para 7 painéis de entrada.
  • Botões Insert / Copy para respostas Assistant. Dois botões sob cada resposta finalizada. Insert é editor-seleção-aware (com seleção substitui), sem seleção insere na posição do cursor. Copy é clipboard normal.
  • UX de inicialização macOS. Timing de ativação na inicialização corrigido —— SoloMD inicialização a frio chega de verdade ao primeiro plano, não se esconde mais atrás do Finder. Restauração de posição de janela aterrissa sempre no workspace da tela atual; restauração de cache ruim após desconexão de monitor secundário se recentra automaticamente, em vez de abrir fora da tela.
  • "Gerando..." travado sem erro. Corrigido. Erro de configuração de provider (ex. Ollama com modelo não baixado) deixava o painel pendurado. Agora você vê uma barra de erro vermelha com a resposta real do backend, o botão enviar também volta.

O que v4.0 explicitamente não faz (e por quê)

Dizer não também é parte do produto. Estas foram seriamente consideradas e explicitamente não feitas:

  • Trazer nosso próprio runtime LLM local. Ollama já faz bem; reinventar a roda viola o princípio "escrever menos código a manter permanentemente". Provider BYOK continua sendo o caminho.
  • Marketplace de Recipe online. Operação de servidor + moderação de conteúdo = desvio da linha principal. Cookbooks empacotados diretamente nas releases, atualizados com a ferramenta.
  • Multi-usuário / agente de equipe. Viola "uma janela, um escritor". Este produto é para autor único; colaboração pertence a outro produto.
  • Completação ghost-text estilo Copilot. Posicionamento de marca diferente. Ghost-text dilui a voz do escritor; nossos agentes trabalham em unidade de vault, escritas são em lote + revisáveis + branch-based.

Notas de upgrade

  • Sem mudanças de formato de arquivo. .md existentes, histórico AutoGit, configuração sync, chaves BYOK todos preservados como estão.
  • Painel Agent ligado automaticamente na primeira execução. Usuários v3.6.x podem ter um showAgentPanel: false oculto devido ao default do scaffold do período v4-beta; migração única o inverte para true, você vê de fato a funcionalidade principal. Se não quiser, pode desligar via ⌘⇧P → View: Toggle Agent Panel.
  • O painel Configurações tem duas novas abas Recipes e Medidor de custo, sob Integrações. Posições de configurações existentes inalteradas.
  • O servidor MCP (solomd-mcp) ganhou novo parâmetro --workspace (repetível). Clientes MCP single-workspace existentes continuam funcionando; o comportamento de federação é opt-in.

🔮 O que vem a seguir

5 pilares principais + barra de qualidade são o conteúdo principal desta vez. As direções abertas para v4.x e além estão todas no roadmap: API de script sandboxada, CLI v2 (rewrite / commit / busca semântica / trigger Recipe no terminal), e a pergunta sempre adiada "O SoloMD deve se tornar um produto comercial?" (sync paga — pergunta antiga da era v3.0, ainda sem resposta, até decidir, nenhuma engenharia será feita nessa área).

Obrigado a todos que durante o período silencioso enviaram issues / mandaram PRs / rodaram builds v4-beta com vaults reais. v4.0 pôde ser lançada porque o dogfood pegou os bugs que os testes de integração perderam. Versões anteriores: Ver o blog (en) →

Comentários & feedback

Comentários vivem no GitHub Discussions — entre uma vez com sua conta GitHub.

Comentários carregam do GitHub Discussions. Se você vê esta mensagem em vez disso, o mantenedor ainda não terminou a configuração única giscus.app — ver web/COMMUNITY-SETUP.md.

Abrir no GitHub Discussions →