Свой блокнот — заметки без чужих ограничений

• 💡 Введение
• 🧭 Философия
• 🆚 Чем этот форк отличается от оригинала
• 🔮 Возможности
• 🏗️ Архитектура и экосистема
• 🗺️ Обновления и версии
• 🚀 Установка
• 🛠️ Сборка из исходников
• ⌨️ Интерфейс командной строки
• ❓ Частые вопросы
• 🙏 Благодарности
• 🤝 Обратная связь
• 💛 Подумайте о том, чтобы поддержать проект

SvoyBloknot — личный форк SiYuan Note, блочной системы управления знаниями с приоритетом на приватность: тонкая гранулярность блочных ссылок, WYSIWYG-редактирование Markdown, всё хранится локально.

Второе назначение проекта — бэкенд памяти для SvoyAgent, персонального ИИ-агента: SvoyBloknot хранит историю диалогов и память агента как обычные заметки, без отдельной базы данных.

Полную официальную документацию по самой SiYuan смотрите в апстриме — здесь ниже описаны только возможности и то, чем конкретно этот форк отличается. Подробности решений и обоснования — в ARCHITECTURE.md; что сделано и что дальше — в ROADMAP.md.

Полная версия — в PHILOSOPHY.md. Коротко: SvoyBloknot существует ради тех же принципов, что и SvoyAgent — из его манифеста:

❌ Не скрывает функции за искусственными ограничениями.

❌ Не запирает данные пользователя в закрытом формате.

Оригинальный клиент SiYuan прячет часть функций (например, стороннюю синхронизацию) за подпиской, а данные при этом и так открыты и локальны — но сам факт искусственного ограничения противоречит этому принципу. Отсюда и этот форк: тот же код, та же лицензия, без скрытых за подпиской возможностей.

Оригинальный клиент SiYuan привязывает часть функций к официальной подписке/облаку. Здесь это убрано:

• Сторонняя синхронизация (S3 / WebDAV / локальная папка) не требует подписки. В оригинале это ограничение было не только косметическим — настройка этих провайдеров была заблокирована и на фронтенде, и в самом ядре без активной платной подписки SiYuan.
• Иконка "не подписан" в верхней панели выключена по умолчанию — не показывает предупреждение тем, кто никогда не логинился в облако SiYuan.
• Никаких тостов "оплатите синхронизацию".
• Проверка обновлений и фоновая автозагрузка официальных пакетов SiYuan отключены — апстрим не может незаметно предложить "обновиться" на официальный релиз поверх этого форка. Обновление SvoyBloknot — ручное действие (подтянуть апстрим, пересобрать).
• Бренд: имя приложения, ярлыка и установщика — SvoyBloknot вместо SiYuan.

Ничего из этого не меняет API ядра или API плагинов — существующие плагины и темы SiYuan совместимы без изменений.

Всё, что умеет оригинальная SiYuan — доступно здесь без ограничений и без подписки:

• Блочный контент
  • Блочные ссылки и двусторонние связи
  • Пользовательские атрибуты блоков
  • Встраивание SQL-запросов
  • Протокол siyuan://
• Редактор
  • Блочный стиль
  • Markdown WYSIWYG
  • Оглавление по спискам
  • Приближение к блоку (zoom-in)
  • Редактирование документов на миллионы слов
  • Формулы, диаграммы, блок-схемы, диаграммы Ганта, нотный стан и т.д.
  • Веб-клиппер
  • Привязка PDF-аннотаций
• Экспорт
  • Ссылки и вставки блоков
  • Стандартный Markdown с ресурсами
  • PDF, Word, HTML
• База данных
  • Табличный вид
• Флеш-карточки с интервальным повторением
• ИИ-написание и чат вопрос/ответ через OpenAI-совместимый API
• Распознавание текста Tesseract OCR
• Несколько вкладок, разделение экрана перетаскиванием
• Шаблоны-сниппеты
• JavaScript/CSS-сниппеты
• API ядра
• Совместимость с готовыми плагинами и темами сообщества SiYuan

SvoyBloknot использует то же ядро и ту же экосистему открытых проектов, что и оригинальная SiYuan — форк не переписывает эти компоненты, а собирается поверх них:

Обновление форка — ручное действие: подтянуть новую версию апстрима и пересобрать (см. ниже). Автоматическая проверка обновлений на сервис SiYuan отключена намеренно (см. раздел про отличия выше).

• Список изменений именно этого форка — в Releases и в истории git-коммитов.
• Список изменений апстрима (новые возможности ядра/редактора) — CHANGELOG.md оригинального проекта.

Готовые сборки для Windows — на странице Releases. Скачайте .exe и установите как обычную программу.

Магазины приложений (App Store, Google Play, Microsoft Store), Docker/Unraid/TrueNAS-образы и пакеты для менеджеров пакетов — это официальные каналы распространения оригинальной SiYuan, этот форк там не публикуется. Для такого варианта установки используйте апстрим.

# Ядро (Go)
cd kernel && CGO_ENABLED=1 go build -tags "fts5 sqlcipher" -ldflags "-s -w" -o ../app/kernel/SiYuan-Kernel.exe .

# Приложение (Electron)
cd app
pnpm install
pnpm run build
pnpm run dist

Собранный установщик появится в app/build/.

Встроенный CLI даёт прямой доступ к данным рабочего пространства без запущенного сервера.

# Список всех блокнотов
siyuan notebook list -w ~/SiYuan

# Полнотекстовый поиск с выводом в JSON
siyuan search "ключевое слово" -w ~/SiYuan -f json

# Поиск внутри вложенных файлов (PDF/Word/Excel/txt и т.д.)
siyuan search "фраза" --asset -w ~/SiYuan

# Экспорт документа в Markdown
siyuan export md --id <block-id> -w ~/SiYuan

Полное дерево команд — siyuan --help. Бинарник CLI — <папка установки>/resources/kernel/SiYuan-Kernel.exe, установщик Windows сам добавляет эту папку в PATH.

Нужно ли платить за что-либо? Нет. Именно это и есть смысл форка — сторонняя синхронизация и весь остальной функционал доступны без подписки.

Поддерживается ли синхронизация через сторонний диск (WebDAV/S3/локальная папка)? Да, без ограничений и без подписки — в этом ключевое отличие от оригинала (см. раздел выше).

Открыт ли исходный код? Да, полностью, лицензия AGPL-3.0-or-later — как у оригинальной SiYuan. Список изменений форка — в git-истории этого репозитория.

Как обновиться до новой версии? Автообновление отключено намеренно. Чтобы обновиться — подтянуть новый коммит из апстрима, заново применить патчи форка (см. git-историю) и пересобрать (см. раздел «Сборка из исходников»).

Как устроено хранение данных? Так же, как в оригинале — данные лежат в папке рабочего пространства обычными файлами (.sy — JSON с содержимым документа), плюс отдельные подпапки под ресурсы, темы, плагины, шаблоны и т.д.

Что делать, если потерян ключ репозитория данных? Как в оригинале — см. раздел Settings → Account & Sync → Local Data Repo внутри самого приложения; шаги идентичны официальной документации SiYuan.

Ядро и подавляющая часть кода — заслуга команды b3log / SiYuan Note и её контрибьюторов. Список изменений именно этого форка — в истории git-коммитов и в Releases.

Нашли баг, есть идея по улучшению или вопрос — открывайте Issue или Pull Request. Буду рада любой обратной связи.

Если проект оказался полезен — можно перевести любую сумму на карту Belarusbank:

• В белорусских рублях: 9112 3801 3437 1527
• В долларах США: 4255 1901 3828 9635
• В евро: 5470 8740 7566 2401
• В российских рублях: 9112 3801 6867 9092

Не обязательно — но приятно 🙂

Ещё один бесплатный способ поддержать — подписаться на YouTube-канал.