# Документация по работе с книгой.

Руководство описывает текущий проект и этап, к которому относится каждая функция. Инструкции по установке появятся вместе с проверенной публичной сборкой.

## Установка ждёт публичной сборки

Публичных установщиков для Windows, Linux и macOS сейчас нет. Когда сборка появится, на странице «Разработка» будут указаны версия, ОС, архитектура, контрольная сумма, статус подписи и известные ограничения.

- Сборки для Windows и Linux до версии 1.0 не подписаны.
- Windows может показать предупреждение о неизвестном издателе.
- AppImage для Linux требует FUSE 2 или режим распаковки и запуска.
- macOS ожидает проверки; мы не заявляем о готовности установки на этой ОС.

## Начните с обычной папки Markdown

Действие «Новая книга» в M1 создаёт обычную папку Markdown. Существующие папки распознаются как книги Markdown, книги mdbindery, проекты mdeditorial или книги Mdnarra по их файлам. Структура книги следует источнику порядка чтения проекта.

- M1 редактирует только UTF-8 с меткой порядка байтов или без неё.
- Файл в другой кодировке открывается только для чтения, а не преобразуется без предупреждения.
- Сохранение без изменений ничего не записывает.
- Файлы записей проекта открываются в M1 только для чтения; их редактирование появится позже в плагинах.

## Пишите, читайте и ищите

Write показывает живой предпросмотр Markdown, а Source открывает текст напрямую. Режим чтения следует порядку книги. Полнотекстовый индекс поиска создаётся в памяти: вторая копия прозы в кеше не сохраняется.

- Подсчёт слов учитывает язык книги и исключает разметку Markdown, метаданные, комментарии, код и адреса ссылок.
- В M1 проверка орфографии использует встроенные словари английского, русского, украинского и испанского языков.
- Автоматические переносы и таблицы стилей книги в режиме чтения намеренно не входят в M1.

## Собирайте книгу встроенными инструментами

M3 добавит запуск инструментов и управление toolchain. mdbindery проверяет книгу и собирает EPUB/PDF; mdrestyler измеряет текст по профилю голоса. Дополнительные внешние инструменты загружаются только с согласия пользователя.

## Конфиденциальность, агенты и восстановление

Для обычных папок и локального git вход в mdquire не нужен. Авторизация GitHub используется только для работы с GitHub. Функции агентов появятся в M4 с явными границами материалов и подтверждениями. Нативный файловый помощник сохраняет версии для восстановления по правилам проверенного сохранения; конфликт показывается пользователю, а не перезаписывается без предупреждения.

## Клавиатура и доступность

Спецификация интерфейса включает управление с клавиатуры, видимый фокус, уменьшение движения и четыре языка. Полные инструкции и аудит доступности относятся к M7, поэтому мы не заявляем, что этот аудит уже пройден.