Що таке recipe (v4)?
YAML-файл у <workspace>/.solomd/agents/*.yml. Один файл = одне agent-завдання. Обов'язкові поля: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Опційні: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist інструментів. SoloMD постачає 11 starter'ів у Налаштування → Recipes → Переглянути cookbook — встановіть, відредагуйте, запустіть. Повна схема живе в docs/agents.md.
Чи безпечні записи агента?
Кожен запуск recipe починається з відгалуження від main: agent/<recipe>/<run-id>. Записи потрапляють лише в цю гілку. У разі успіху запуск переходить у Pending — перегляньте diff і клацніть Прийняти (fast-forward у main) або Відхилити (повне видалення гілки). Відхилений запуск не залишає жодного сліду в історії. Записи також обмежені cap на запуск (типово 5, жорстка стеля 50) — модель, що просить записати 100 файлів за cap 5, отримує відмови з 6-го виклику, без напівзастосованого стану.
Чим це відрізняється від ghost-text у Cursor чи Copilot?
Cursor і Copilot чудові для покрокового доповнення коду. Агенти SoloMD інші у трьох аспектах: (1) одиниця роботи — це *vault*, а не курсор — агенти читають крізь нотатки через wikilinks, backlinks, повнотекстовий пошук і теги; (2) записи пакетні + рецензовані, а не ghost-text, який ви приймаєте інлайн; (3) агенти можуть виконуватися за розкладом, коли вас немає за клавіатурою (щотижневий огляд, щоденний підсумок, on-tag triage). Це ближче до Agent / Composer-режиму Cursor, ніж до інлайн-доповнення — і явно не є доповненням стилю письма (ми вважаємо, що ghost-text розводнює голос автора).
Чи потрібен recipes API-ключ?
Лише якщо recipe вказує хмарного провайдера. Для provider: ollama (або псевдоніма local) ключ не потрібен — qwen2.5:1.5b працює безкоштовно на вашій машині. Для provider: claude / openai / gemini / тощо — потрібен ключ цього провайдера в Налаштування → AI (BYOK). Майстер першого запуску проведе вас будь-яким шляхом.
Чим семантичний пошук SoloMD відрізняється від grep?
Grep збігає символи; семантичний пошук збігає зміст. Шукайте «deployment» — і ви також знайдете абзаци про «rolling out», «shipping», «release». Embedder виконується повністю в нашому Rust-процесі — без завантаження файлів моделі, без мережевих викликів, без хмари. Типово вимкнено; перемикайте у Налаштуваннях для opt-in. Індекс живе в <workspace>/.solomd/embeddings.sqlite (автоматично в gitignore).
Чи SoloMD дійсно безкоштовний?
Так. SoloMD — програмне забезпечення з відкритим кодом, ліцензія MIT. Немає платного рівня, акаунтів, типової телеметрії, реклами. Якщо це допомагає вашому письму, ви можете спонсорувати розробника, але ніколи не зобов'язані.
Де живуть API-ключі для 14 AI-провайдерів?
У системному сховищі ключів — Apple Keychain на macOS, Credential Manager на Windows, libsecret на Linux. Ніколи в localStorage, ніколи в конфіг-файлі, який пише SoloMD. AI-запити йдуть напряму з вашої машини до обраного провайдера; SoloMD не хостить жодних моделей і не ретранслює трафік.
Якого розміру інсталятор?
Близько 10–15 МБ залежно від платформи. Це приблизно у 6 разів менше за Typora й у 7 разів менше за Obsidian, бо SoloMD використовує Tauri (системний webview + Rust) замість того, щоб упаковувати Chromium.
Чи працює офлайн?
Так, повністю. Сам редактор робить нуль мережевих запитів. Семантичний пошук — лише локальний. AutoGit комітить у локальний репозиторій і ніколи автоматично не пушить. Єдиний вихідний трафік — це (1) опційна перевірка оновлень GitHub-релізів при запуску (вимикається в Налаштуваннях) і (2) AI-виклики переписування, які ви явно ініціюєте, що йдуть напряму до обраного провайдера.
Як працює MCP-сервер?
Один sidecar-бінарник 1,5 МБ (solomd-mcp) говорить за Model Context Protocol через stdio — без мережевих портів. Вкажіть Claude Desktop, Cursor або будь-якому MCP-клієнту на ваш workspace, і він отримає 8 інструментів читання (list_notes, read_note, search, get_backlinks, list_tags, get_outline тощо) плюс 2 інструменти запису за прапорцем --allow-write. Захист від path-traversal, обмеження workspace-canonical.
Як SoloMD обробляє файли не-UTF-8 на кшталт GBK / Big5?
SoloMD автоматично визначає кодування за допомогою Rust-крейту chardetng при відкритті файлу. UTF-8, UTF-16 LE/BE (з BOM або без), GBK, GB18030, Big5, Shift_JIS і багато інших розпізнаються та коректно відображаються.
Чи можу я синхронізувати нотатки на інші пристрої?
Поки що ні — вбудована CRDT-синхронізація у roadmap. Наразі SoloMD чудово працює з iCloud Drive, Dropbox, OneDrive, Syncthing або будь-яким інструментом синхронізації на основі тек. Просто зберігайте нотатки в синхронізованій теці. Або використовуйте AutoGit + ручний push до GitHub.
Чому немає plugin'ів?
SoloMD навмисно не має plugin-системи, щоб залишатися легким, стабільним і легким для аудиту. Можливості, яких просять серйозні автори — семантичний пошук, історія версій, AI-переписування, вставка зображень, KaTeX, Mermaid, режим фокусу, користувацький CSS — усі є в ядрі.
Чому при першому запуску з'явилося «Windows захистив ваш ПК»?
SoloMD — невеликий проєкт з відкритим кодом, який поки не набрав репутації Microsoft SmartScreen. Клацніть «Докладніше → Виконати в будь-якому випадку» один раз, і вас більше не питатимуть. Ми працюємо над сертифікатом підпису коду.
Як відкривати файли .md за замовчуванням SoloMD?
Правий клік на будь-якому .md файлі → Відкрити з → SoloMD → позначте «Завжди використовувати цю програму». Вбудований інсталятор реєструє SoloMD як обробник для розширень .md, .markdown, .mdown, .mkd і .txt.
Яка різниця між SoloMD і Obsidian?
Obsidian — інструмент керування знаннями з vault, wiki-посиланнями, backlinks, перегляду графа й plugin-маркетплейсом. SoloMD — легкий редактор для написання Markdown-файлів — але постачає деякі речі, яких в Obsidian немає (семантичний пошук у ядрі, AutoGit, MCP-сервер, 14 AI-провайдерів в одній панелі). Використовуйте Obsidian, якщо хочете другий мозок із plugin-маркетплейсом; використовуйте SoloMD, якщо хочете інструменти для письма без plugin tax.
Які системні вимоги? Чи працює SoloMD на Windows 7?
SoloMD потребує Windows 10 або новішої, macOS 10.15+, актуального дистрибутива Linux, iOS 15+ або Android 7+. Windows 7/8/8.1 підтримувати неможливо, і придатної старої збірки не існує: інструментарій Rust від версії 1.78 вимагає Windows 10, а Microsoft заморозила WebView2 — рушій рендерингу SoloMD — на версії 109 для Windows 7 без подальших оновлень безпеки.
