Czym jest recipe (v4)?
Plikiem YAML w <workspace>/.solomd/agents/*.yml. Jeden plik = jedno zadanie agenta. Wymagane pola: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Opcjonalne: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD dostarcza 11 starterów w Ustawienia → Recipes → Przeglądaj cookbook — zainstaluj jeden, edytuj, uruchom. Pełny schemat opisany jest w docs/agents.md.
Czy zapisy agenta są bezpieczne?
Każde uruchomienie recipe zaczyna się od odgałęzienia od main: agent/<recipe>/<run-id>. Zapisy lądują tylko na tej branchu. Po sukcesie uruchomienie trafia do Pending — przejrzyj diff i kliknij Akceptuj (fast-forward do main) albo Odrzuć (skasuj branch w całości). Odrzucone uruchomienie nie zostawia żadnego śladu w twojej historii. Zapisy podlegają też cap’owi na uruchomienie (domyślnie 5, twardy limit 50) — model, który chce zapisać 100 plików przy capie 5, dostaje odmowę od 6. wywołania, bez stanu pół-zaaplikowanego.
Czym to się różni od ghost-text Cursora albo Copilota?
Cursor i Copilot są świetne do uzupełniania kodu na poziomie wciśnięć klawiszy. Agenty SoloMD różnią się trzema rzeczami: (1) jednostką pracy jest *vault*, nie kursor — agenty czytają w poprzek notatek przez wikilinks, backlinks, full-text search i tagi; (2) zapisy są wsadowe + do przeglądu, nie ghost-textem akceptowanym inline; (3) agenty mogą działać według harmonogramu, gdy nie siedzisz przy klawiaturze (cotygodniowy przegląd, codzienne podsumowanie, triage on-tag). Bliżej jej do trybu Agent / Composer w Cursorze niż do uzupełniania inline — i jawnie nie jest to uzupełnianie stylu pisania (uważamy, że ghost-text rozwadnia głos autora).
Czy recipes potrzebują klucza API?
Tylko jeśli recipe deklaruje dostawcę chmurowego. Przy provider: ollama (lub aliasie local) klucz nie jest potrzebny — qwen2.5:1.5b działa za darmo na twojej maszynie. Przy provider: claude / openai / gemini / etc potrzebujesz klucza danego dostawcy w Ustawienia → AI (BYOK). Wizard pierwszego uruchomienia prowadzi cię przez każdą ścieżkę.
Czym wyszukiwanie semantyczne SoloMD różni się od grepa?
Grep dopasowuje znaki; wyszukiwanie semantyczne dopasowuje znaczenie. Wpisz „deployment”, a możesz wyciągnąć też akapity o „rolling out”, „shipping”, „release”. Embedder działa w całości w naszym procesie Rust — żadnych pobierań plików modelu, żadnych wywołań sieciowych, żadnej chmury. Domyślnie wyłączone; przełącznik w Ustawieniach włącza opt-in. Indeks żyje w <workspace>/.solomd/embeddings.sqlite (auto-gitignored).
Czy SoloMD jest naprawdę darmowy?
Tak. SoloMD to oprogramowanie open source na licencji MIT. Nie ma planu płatnego, nie ma kont, domyślnie nie ma telemetrii, nie ma reklam. Jeśli pomaga ci pisać, możesz wesprzeć dewelopera, ale nigdy nie jesteś do tego zobowiązany.
Gdzie żyją klucze API dla 14 dostawców AI?
W keychainie twojego systemu — Apple Keychain na macOS, Credential Manager na Windows, libsecret na Linuksie. Nigdy w localStorage, nigdy w pliku konfiguracyjnym zapisywanym przez SoloMD. Żądania AI lecą prosto z twojej maszyny do wybranego przez ciebie dostawcy; SoloMD nie hostuje żadnego modelu i nie pośredniczy w ruchu.
Jak duży jest instalator?
Około 10–15 MB w zależności od platformy. To około 6× mniej niż Typora i 7× mniej niż Obsidian, bo SoloMD korzysta z Tauri (systemowy webview + Rust) zamiast pakować Chromium.
Czy działa offline?
Tak, w pełni. Sam edytor wykonuje zero żądań sieciowych. Wyszukiwanie semantyczne jest wyłącznie lokalne. AutoGit commit-uje do lokalnego repo i nigdy nie pushuje automatycznie. Jedyny ruch wychodzący to (1) opcjonalne sprawdzanie wydania na GitHub przy starcie (do wyłączenia w Ustawieniach) i (2) wywołania przepisywania AI, które wyzwalasz świadomie, lecące prosto do wybranego dostawcy.
Jak działa serwer MCP?
To jeden binarny sidecar 1,5 MB (solomd-mcp), który mówi Model Context Protocol przez stdio — żadnego portu sieciowego. Wskaż Claude Desktop, Cursorowi czy dowolnemu klientowi MCP twój workspace, a dostanie 8 narzędzi do odczytu (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) plus 2 narzędzia zapisu za flagą --allow-write. Zabezpieczenie przed path-traversal, ograniczenie do kanonicznego workspace’a.
Jak SoloMD radzi sobie z plikami nie-UTF-8 typu GBK / Big5?
SoloMD autowykrywa kodowanie za pomocą crate’u Rust chardetng przy otwieraniu pliku. UTF-8, UTF-16 LE/BE (z BOM lub bez), GBK, GB18030, Big5, Shift_JIS i wiele innych są rozpoznawane i wyświetlane poprawnie.
Czy mogę synchronizować notatki na inne urządzenia?
Jeszcze nie — wbudowany sync CRDT jest w roadmapie v3. Na razie SoloMD świetnie działa z iCloud Drive, Dropboxem, OneDrive, Syncthingiem albo dowolnym narzędziem syncującym foldery. Po prostu zapisz notatki w synchronizowanym folderze. Albo użyj AutoGit + ręcznego pusha do GitHub.
Dlaczego nie ma pluginów?
SoloMD świadomie pomija system pluginów, by pozostać lekkim, stabilnym i łatwym do audytu. Funkcje, o które proszą poważni piszący — wyszukiwanie semantyczne, historia wersji, przepisywanie AI, wklejanie obrazów, KaTeX, Mermaid, tryb focus, własny CSS — przychodzą wszystkie w core.
Dlaczego przy pierwszym uruchomieniu pojawiło się „System Windows ochronił komputer”?
SoloMD to mały projekt open source, który nie zbudował jeszcze reputacji w Microsoft SmartScreen. Kliknij raz „Więcej informacji → Uruchom mimo to” i więcej cię nie zapyta. Pracujemy nad certyfikatem do podpisywania kodu.
Jak otworzyć pliki .md domyślnie w SoloMD?
Prawy klik na dowolnym pliku .md → Otwórz za pomocą → SoloMD → zaznacz „Zawsze używaj tej aplikacji”. Dołączony instalator rejestruje SoloMD jako handler dla rozszerzeń .md, .markdown, .mdown, .mkd i .txt.
Czym SoloMD różni się od Obsidiana?
Obsidian to narzędzie do zarządzania wiedzą z vaultami, wikilinkami, backlinkami, widokiem grafu i marketplace’em pluginów. SoloMD to lekki edytor do pisania plików Markdown — ale dostarcza kilka rzeczy, których Obsidian nie ma (wyszukiwanie semantyczne w core, AutoGit, serwer MCP, 14 dostawców AI w jednym panelu). Wybierz Obsidian, jeśli chcesz drugi mózg z marketplace’em pluginów; wybierz SoloMD, jeśli chcesz narzędzia do pisania bez plugin tax.
