Руководство пользователя Presswork (RU)

Это руководство описывает все функции Presswork с пошаговым обзором каждой области приложения.

1. Обзор

Presswork — профессиональный Markdown-редактор для издательского дела и самиздата. Он сочетает чистое письмо, редакционные инструменты (стиль, синопсис, версии) и профессиональный экспорт (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). Включает Typst для быстрых PDF и поддерживает LaTeX + Ghostscript для сертифицированных PDF/X.

2. Требования и установка

• Включены: Pandoc, Typst (базовый PDF), внутренние движки.
• Опционально (Pro): LaTeX и Ghostscript для сертифицированных PDF/X.

Где проверить:

• Настройки → Приложение → Установки → Открыть полную проверку экспорта: проверка и инструкции по установке.

3. Режимы и лицензии (Base / Pro)

• Base: упрощённый интерфейс, быстрый PDF через Typst, меньше опций.
• Pro: PDF/X, preflight, мультиэкспорт, расширенные опции и полный набор редакционных инструментов.
• Быстрое переключение — кнопкой Base/Pro в шапке; полный план и Лицензия — в Настройки → App → Рабочий вид.

4. Основной интерфейс

• Шапка: быстрый доступ к Документу, Инструментам, Экспорту, Виду, лицензии, руководству.
• Редактор: область Markdown с панелью инструментов и горячими клавишами.
• Боковая панель: Outline, Snapshot, Backlink, Scrivener.
• Строка состояния: слова, символы, строка/столбец, цели.

5. Меню «Документы»

• Новый: создаёт новый документ.
• Сохранить MD / Сохранить как…: сохраняет в .md.
• Импорт документа: Word (.docx, .doc), ODT, HTML, Markdown, PDF, ICML, Final Draft. Изображения приходят вместе с текстом: рисунки из документа Word — включая таблицы Excel, вставленные как изображение, — и картинки, встроенные в PDF, извлекаются в папку рядом с импортированным файлом. То, что в PDF является векторным рисунком (а многие диаграммы именно такие), не изображение и извлечь его нельзя.
• Открыть проект: загружает проект по главам.
• Режим структуры: управление главами/порядком.
• Управление проектом: создание/обновление редакционных проектов.
• Печать: печатает текущий документ.
• Хронология (раздел История): точки, сохранённые автоматически, и восстановление (Ctrl/Cmd + Shift + H).
• Версии (раздел История): альтернативные версии книги рядом с окончательной, которая идёт в печать (§29).

Рекомендуемый порядок:

1. Создайте документ или проект.
2. Сохраняйтесь чаще.
3. Используйте «Хронологию», чтобы вернуться к более ранней точке.

6. Меню «Инструменты»

• Цели: дневные цели по словам или цели на документ.
• Статистика: динамика письма, темп, сложность, flow.
• Руководство пользователя: встроенное руководство.
• Проверка экспорта (LaTeX/Ghostscript): не в этом меню, а в Настройки → Приложение → Установки («Открыть полную проверку экспорта»).
• Command Palette: поиск команд (Ctrl/Cmd + P).
• Анализ стиля: повторы, читаемость, тон, инклюзивность.
• ИИ-ассистент: резюме, переписывание, согласованность.
• Режим Vim: не в этом меню, а в Настройки → Редактор → Режимы письма (или Ctrl + Alt + V).
• Collab: совместные сессии в реальном времени с быстрым приглашением по ID сессии; текст, чат и вложения проходят через ретранслятор PressWork (§20).
  • Быстрый старт: откройте Инструменты → Collab, укажите имя, создайте или вставьте ID сессии (pw-...) и нажмите «Подключиться».
  • Во время звонка: используйте переключатели микрофона и камеры на плавающей панели; голос и видео идут через WebRTC — напрямую или, если сеть этого не позволяет, через сервер пересылки (TURN): настраивать ничего не нужно.
• Тур: экскурсия по специальным форматам.
• Цифровая подпись: подписывает PDF сертификатом (Pro).

7. Меню «Экспорт»

Основные форматы

• PDF (Typst, быстрый)
• PDF/X (LaTeX, сертифицированный)
• PDF-сценарий (Голливуд)
• FDX (Final Draft)
• DOCX / ODT
• EPUB
• HTML
• ICML (InCopy/InDesign)

Опции

• Стиль PDF: выбор PDF-шаблона.
• PDF/X: ICC-профиль, валидация, встроенные шрифты.
• Метки обреза: в разделе «Параметры проф. печати (PDF)». Внутренний блок для KDP всегда выходит без них.
• Метаданные EPUB + обложка.
• Preflight: чек-лист качества и печати.
• История экспорта: журнал экспортов.
• Мультиэкспорт: несколько файлов в один.
• Мультиформатный экспорт: PDF + EPUB + HTML и т. д.
• Экспорт с ресурсами: включает изображения/ресурсы.
• Конвертировать папку: пакетная конвертация.

8. Меню «Вид»

• Режимы: Написание, MD код, Страница.
• Язык (9 языков): не в этом меню, а в Настройки → Приложение → Язык интерфейса.
• Тема: Настройки → Приложение → Тема, 🌙 Тёмная / ☀️ Светлая, или через Command Palette.
• Печатная машинка (активная строка по центру): Настройки → Редактор → Режимы письма → Режим печатной машинки.
• Режим фокуса: скрывает интерфейс (F11).
• Презентация: полноэкранные слайды.
• Доступность (размер текста, высокий контраст, шрифт для дислексии): не в этом меню, а в Настройки → Редактор → Текст и типографика.

9. Панель инструментов редактора

• Форматирование: жирный, курсив, подчёркнутый. Первый щелчок применяет его и оставляет слово выделенным, второй возвращает обычный вид (то же и для кода).
• Заголовки: H1/H2/H3.
• Элементы: ссылки, изображения, код строчный/блочный.
• Списки: маркированные/нумерованные.
• Цитаты.
• Таблицы.
• CriticMarkup: вставка, удаление, комментарий.
• Шаблоны: пресеты вёрстки.
• Метаданные: YAML front matter.
• Snapshot: снимки сцен.
• Синопсис: резюме по главам.

10. Панели боковой панели

• Outline: навигация по разделам.
• Snapshot: управление снимками.
• Backlink: связи между документами.
• Scrivener: главы и drag&drop.
• Scene Navigator: для сценариев.

11. Письмо в Markdown

Базовый синтаксис

• # Заголовок / ## Подзаголовок
• **жирный**, *курсив*
• - список / 1. нумерованный список
• [ссылка](url)
• ![alt](изображение)
• > цитата
• \newpage для разрыва страницы
• $E=mc^2$ в строке, $$ … $$ на отдельной строке: формула

Советы

• Перетаскивайте изображения.
• Используйте Split или Предпросмотр для контроля вёрстки.
• Формулы, и без сети: в предпросмотре они видны офлайн (при запуске PressWork ничего не скачивает). То, что в предпросмотре является формулой, выходит формулой в PDF, PDF/X, при печати, в быстром PDF, ePub и HTML, и наоборот: цена вроде «$50» остаётся текстом. Только при печати и в быстром PDF \cancel выводится как написано, а \color теряет цвет, но PDF всё равно создаётся.
• Эмодзи: попадают в PDF вместо квадратиков — цветными в обычном PDF и чёрными в PDF/X.

12. Шаблоны

• Готовые шаблоны: доступ с панели инструментов (Tpl).
• Пользовательские шаблоны:
  • Импорт одного файла или папки (меню Шаблоны → «Импортировать файл / Импортировать папку»).
  • Автоматическая классификация по вкладкам: css→UI Kit, xlsx/xls/ods/csv→Business, остальное→Документы.
  • Значок Custom и полная подсказка при наведении (имя + описание).
  • .md: загружаются в редактор.
  • .tex/.pdfx/.pdft: используются как стили экспорта PDF.
  • .xlsx/.xls/.ods/.csv: используются в потоках таблиц/отчётов.
• Автосвязка UI↔PDF: CSS-темы могут автоматически связываться с PDF-шаблоном (переключатель + Разъединить).
• Общая библиотека: сохранение общих типографских пресетов.
• Полный справочник функций шаблонов: docs/template-functions-overview-en.md.

13. Метаданные и front matter

• Метаданные (верхняя панель) открывают «🏷 Управление метаданными»; в Редакционном центре это окно открывает и «Редактировать метаданные (название, автор…)»: название, автор, язык, дата, ISBN, издатель, жанр, теги.
• Язык, под Названием и Автором: девять языков написаны каждый на своём (Italiano, English (US), English (UK), Español, Français, Deutsch, 中文, Русский, العربية, עברית); через «Другой…» вводится код вроде pt-BR или de-CH, а неверный код не сохраняется. Язык действует для ePub и для PDF: переносы, кавычки, «Содержание» или «Contents». Китайский, японский и корейский остаются итальянскими в PDF через LaTeX и в PDF/X, и окно об этом сообщает. При «Не указан» ePub берёт язык приложения, а PDF — итальянский.
• Язык становится строкой lang: документа: если вы писали её вручную, вы найдёте её в окне. «Издатель» и действительный ISBN попадают в ePub (ISBN в PDF не попадает), а формат страницы (поле Page size) становится «Бумагой» экспорта, в том числе для .md.
• YAML front matter для согласованного экспорта.
• EPUB: обложка и метаданные настоятельно рекомендуются.

14. Проекты и режим структуры

1. Документы → Управление проектом.
2. Создайте папку проекта.
3. Добавьте главы (.md).
4. Переупорядочивайте перетаскиванием.
5. Экспортируйте всё с автоматическим порядком.

15. Экспорт подробно

15.1 Базовый PDF (Typst)

• Быстрый, без LaTeX.
• Идеален для черновиков и вычиток.

15.2 PDF/X (LaTeX)

• Использует сертифицированный шаблон.
• Требует LaTeX + Ghostscript.
• Поддерживает ICC, валидацию и preflight.

15.3 PDF-сценарий

• Голливудская вёрстка.
• Совместим с Fountain.

15.4 FDX (Final Draft)

• Экспорт для кинопроизводственных процессов, с отчётом .breakdown.json рядом (сцены, персонажи, теги).
• Одновременный диалог: добавьте ^ после имени второго персонажа (GUIDO^) — в Final Draft реплики отображаются в две колонки (нативный dual dialogue); при импорте .fdx ^ возвращается автоматически.
• Производственные теги: правый клик по выделенному слову → Тег для производства, или напишите [[prop: фонарь]] или #prop: фонарь в конце строки. В FDX они становятся нативными тегами Tagger; в других форматах маркеры удаляются; теги, поставленные в Final Draft, возвращаются при импорте.
• Основные ключи (итальянский или английский): prop, costume, vehicle, sound, music, makeup, animal, effects, location, note.
• Название и автор (front matter или # Название + «by …» в начале документа) попадают на Title Page Final Draft.

15.5 DOCX/ODT

• Конвертация через Pandoc.

15.6 EPUB

• Метаданные + обложка рекомендуются; «Язык» метаданных (§13) определяет, как читалка переносит слова и читает вслух.
• Совместим с цифровыми магазинами.

15.7 HTML

• Веб-вывод с ресурсами.

15.8 ICML

• Стили, сопоставленные для InDesign/InCopy.
• Заголовки, списки, цитаты и сценарий преобразуются в отдельные стили.
• Включённые пресеты шаблонов + импорт собственного .icml.
• Настоящие сноски (нумерует InDesign), ссылки с назначениями, таблицы с шапками и выравниванием, изображения как связанные фреймы (панель «Связи»), над-/подстрочные и капитель — в том числе внутри ячеек, сносок и ссылок.
• Точный реимпорт: экспортированный и снова открытый в PressWork ICML сохраняет документ (круговой цикл проверен в CI, включая длинные рукописи).

15.9 Excel

• Экспорт Excel с разбором сцен, персонажей и производства.
• Поддержка шаблонов: запись в существующие листы для сохранения базовых стилей.
• Импорт нескольких листов в таблицы Markdown (с метаданными типа/ячейки).
• Выбор листа и диапазона при импорте, чтобы избежать лишних данных.
• Chart Mapper: опционально, строит превью-графики из данных Excel.

16. Расширенный экспорт

• Мультиэкспорт: объединяет несколько документов.
• Мультиформатный экспорт: создаёт PDF+EPUB+HTML в одной папке.
• Экспорт с ресурсами: копирует изображения и ресурсы.
• История экспорта: журнал и результаты.

17. KDP (Amazon)

• Редакционный центр (кнопка вверху): инструменты для Amazon KDP на пяти вкладках: Экспорт, Обложки, Валидация, Калькулятор, ИИ.
• 🚀 Экспорт KDP (PDF + ePub) записывает файлы для загрузки: Название_interior.pdf (PDF/X, если установлен LaTeX, иначе обычный PDF; всегда без обложки и без меток обреза), Название_ebook.epub и, если вы выбрали её на вкладке Обложки, Название_cover.pdf. В конце «Открыть» открывает внутренний блок.
• Обложки → Обложка печатной книги: вкладка показывает размеры развёрнутой обложки (целиком в мм и в дюймах, корешок, выпуск за обрез), рассчитанные по «Бумаге», выбранной в Экспорте (A4, A5, US Letter), с типом бумаги и числом страниц из Калькулятора. Кнопкой «Выбрать развёрнутую обложку…» выбирается уже готовая обложка (PDF, JPG или PNG), и PressWork сразу проверяет её размеры: PDF с метками обреза нужно экспортировать заново без них, у обложки, сделанной в обрезном формате, нет выпуска за обрез, ниже 300 DPI появляется предупреждение. «Убрать» снимает выбор.
• Если размеры не сходятся, обложка не записывается, а сообщение говорит, какие размеры нужны. Без обложки экспорт всё равно проходит, а обложку можно загрузить прямо в KDP. Выбор действует для открытой книги и не сохраняется после перезапуска.
• Калькулятор: по числу страниц и бумаге (кремовая, белая, Стандартный цвет, Премиум-цвет) даёт толщину корешка и минимальное внутреннее поле. Стандартного цвета нет в формате A4, и печатается он только от 72 страниц.
• Шаблоны KDP: три текстовых каркаса (Роман 6x9, Эссе 6x9, Самопомощь 5x8); выбранный после подтверждения заменяет текст в редакторе.
• Валидатор ePub: чек-лист, предпросмотр Kindle и скачиваемый отчёт.

18. Анализ стиля

• Длинные фразы, повторы, пассивный залог.
• Встроенные подсказки.
• Метрики читаемости.

19. ИИ-ассистент

• Резюме, переписывание, согласованность, заголовки. При выделении «Вставить в редактор» не заменяет текст, а предлагает, и решаете вы в тексте (§36).
• Облачные сервисы уже готовы в меню: OpenAI, Anthropic (Claude), Mistral и агрегаторы вроде OpenRouter. Выбор сервиса задаёт адрес и модель — остаётся только вставить ключ.
• Каждый сервис помнит свой ключ: при переключении его больше не нужно вводить заново. Ключи хранятся в связке ключей операционной системы, а не в файле приложения.
• Локальные модели: «Найти Ollama» покажет установленные на вашем компьютере. Там ключ не нужен, и ничего не покидает машину.
• Проверка соединения проверяет тот канал, которым вы действительно пользуетесь — облачный, если есть ключ, иначе локальный — и сообщает, какой именно проверил.

20. Совместная работа

• Общие сессии с цветными удалёнными курсорами, встроенными комментариями и живой синхронизацией.
• Встроенные голосовые/видеозвонки во время сессии.
• Общий ID сессии (pw-...) для быстрого приглашения других пользователей.

Как пользоваться (по шагам)

1. Откройте Инструменты → Collab и выберите узнаваемое имя.
2. Создайте новую сессию или вставьте ID, полученный от коллеги.
3. Дождитесь статуса Online и проверьте участников в доке совместной работы.
4. Для голоса/видео начните звонок с панели Collab и используйте кнопки «микрофон»/«камера».

Как передаются данные

• Текст, чат и вложения проходят через сервер связи PressWork (ретранслятор), который пересылает их другим участникам, не сохраняя: настраивать ничего не нужно. Если ретранслятор не отвечает, PressWork пытается соединить участников напрямую.
• Голос и видео идут через WebRTC — напрямую между участниками или, если сеть этого не позволяет, через сервер пересылки (TURN).
• Соединение защищено в пути, но у текста, чата и вложений нет сквозного шифрования: сервер связи видит их, пока пересылает. Поэтому совместная работа не подходит для конфиденциальных материалов.
• Войти может любой, у кого есть ID сессии: передавайте его только тем, кого приглашаете, как ключ.

21. Цифровая подпись

• Подпись PDF сертификатом PAdES-T.
• Метка времени RFC 3161 (нужна сеть).

22. Презентация

• Превращает документы в слайды.
• Настраиваемые макеты и палитры.

23. Доступность

• Размер текста 12–18px: Настройки → Редактор → Текст и типографика.
• Высокий контраст (меню и окна): в том же разделе. Меняет меню, панели и окна; лист с текстом остаётся прежним.
• Шрифт для дислексии в меню: в том же разделе. Использует OpenDyslexic или Atkinson Hyperlegible, если они установлены в системе (PressWork их не содержит), и действует в меню, а не в тексте.

24. Основные горячие клавиши

• Ctrl/Cmd + S → Сохранить
• Ctrl/Cmd + N → Новый
• Ctrl/Cmd + P → Command Palette
• Ctrl/Cmd + Shift + P → Презентация
• F11 → Режим фокуса
• Ctrl/Cmd + B/I/U → Жирный/Курсив/Подчёркнутый (повторное нажатие снимает)
• Ctrl + Alt + V → Vim

25. Решение проблем

• PDF/X недоступен: установите LaTeX + Ghostscript и перезапустите.
• Экспорт не удался: прочитайте сообщение — в нём сказано, что пошло не так и где (§35).
• Шаблоны не видны: используйте «Открыть папку шаблонов» и проверьте расширения.
• Медленный экспорт: отключите валидацию на этапе черновика.

26. Полезные пути

• Пользовательские шаблоны: папка presswork/templates в каталоге конфигурации пользователя.
• PDF/X ICC: папка presswork/pdfx.

Presswork объединяет простоту и профессиональные редакционные инструменты: пишите быстро в Base, публикуйте в Pro.

Недавние обновления (Data Hub / Графики)

• Вставка графика из Excel Data Hub теперь сразу показывает превью-изображение и в редакторе, а не только в панели предпросмотра.
• Встроенное превью уменьшено (примерно на 50 %), чтобы меньше мешать при письме.
• Двусторонний переключатель: 📝 Показать код открывает блок chart-data, 🖼️ Вернуться к графику восстанавливает вид изображения.
• Блок chart-data остаётся в Markdown для совместимости с предпросмотром/рендером/экспортом.
• Вставка таблицы или графика как изображения теперь сохраняет файл в ресурсы документа (имядок.assets/images/), а в редактор попадает только Markdown-ссылка: работает даже с очень большими листами.
• Если документ ещё не сохранён, приложение предлагает сохранить его сразу (как при перетаскивании изображений); при отказе таблица вставляется текстом Markdown, а график остаётся в листе.
• Вопрос «текст/изображение» понимает и ответы вроде «png», «jpg», «изображение», «фото»; нераспознанный ответ повторяет вопрос.
• Сетка данных следует активной светлой/тёмной теме.
• Сохранить как шаблон: окно переработано в стиле приложения и переведено. Требует данных в сетке и модели в редакторе с плейсхолдерами {{ИмяКолонки}}; «Сгенерировать Markdown» повторяет модель для каждой строки.
• Экспорт Excel (разбор): читает текст редактора (сцены INT./EXT. или главы #); если сцен нет, теперь предупреждает вместо создания пустого файла.
• Упрощено меню Tables: удалён дублирующий пункт «Импортировать как шаблон» (идентичен «Открыть лист Tables»).
• Панель Импорт/Экспорт: новая вкладка Пакетные (рядом с Базовый формат / Про-печать / Сценарий / Издательство) с пакетными действиями: Конвертировать папку, Мультиэкспорт, Мультиформат, С ресурсами. Расширенные опции показывают только то, что относится к выбранному формату.
• 🧪 Проверить ICML: в панели экспорта (формат ICML) проверяет созданный документ — иерархию, front matter, экранирование, пустые абзацы — ничего не записывая на диск; детали появляются в окне внутри приложения. Та же проверка в любом случае выполняется при каждом экспорте ICML.
• Более безопасный экспорт FDX: обычный Markdown (списки, таблицы, заметки) всегда становится Action — никогда случайно Персонажем/Диалогом; настоящие сценарии по-прежнему интерпретируются (сцены, персонажи, реплики, переходы). \newpage становится настоящим разрывом страницы (и в ICML — через переназначаемый стиль «Разрыв страницы»).
• Печать через PDF: кнопка «Печать» создаёт временный PDF (Typst, та же типографика, что и в экспорте) и открывает его в системном просмотрщике — печать через нативный диалог с точным предпросмотром.
• Настройки переупорядочены: раздел Установки (LaTeX в один клик, статус Ghostscript), язык в компактном виде, тема с чипами Тёмная/Светлая. Быстрые промпты панели ИИ сворачиваются.

27. Углублённый разбор функций (закрытые пробелы)

Этот раздел дополняет продвинутые функции, которые часто не используются из-за слабой видимости в меню.

27.1 ИИ: конфигурация, диагностика и качество ответа

• Настраиваемые облачные/локальные endpoint'ы (совместимые с OpenAI, Ollama, LM Studio) через переменные PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
• Диагностика ИИ-подключения с экспортируемым JSON-отчётом (полезно для техподдержки/ИТ-команд).
• Управление стилем ответа (краткий/сбалансированный/подробный), предпросмотр технического промпта и повтор последнего промпта.
• Закрепление endpoint/модели на проект: сохраняет редакционную согласованность между документами.

27.2 Статистика: метод расчёта (практика)

• Средняя продуктивность: по дневной истории (7 дней / 30 дней).
• Скорость письма: все слова, делённые на окно сессий (слова/час и слова/мин).
• TTR (Type-Token Ratio): уникальные слова / все слова.
• MSTTR: средний TTR по окнам из 50 слов (снижает искажение на длинных текстах).
• Flow state в реальном времени: средний интервал нажатий + доля недавних удалений.
• Прогноз завершения: оптимистичная/пессимистичная оценка по средним 7д и 30д.

27.3 Продвинутый экспорт, отсутствующий в кратком руководстве

• Final Draft (.fdx): сопоставляет заголовки настоящим Scene Heading, поддерживает заметки/разрывы страниц/нумерацию сцен и создаёт сопутствующий файл .breakdown.json.
• ICML: продвинутое типографское сопоставление (заголовки/списки/цитаты/сценарий) + пресеты + импорт собственного .icml.
• Мастер EPUB/ICML: блокирует экспорт, пока не заданы минимальные метаданные (название/автор/ISBN) и обложка.
• Подпись PDF: PKCS#7 detached + метка времени RFC 3161.

27.4 Режим Bundle (.pwk)

• Основное действие: Экспорт с выбором назначения.
• Автоматические цели вывода для уменьшения ручных ошибок пути.
• Переключатель в шапке для временного показа классического быстрого экспорта.

27.5 Совместная работа в реальных условиях

• Общий ID сессии pw-..., цветные удалённые курсоры, встроенные комментарии, живая синхронизация.
• Голосовой/видеозвонок в той же редакционной сессии.
• Текст, чат и вложения проходят через ретранслятор PressWork (свой ретранслятор задать нельзя), который пересылает их, не сохраняя; сквозного шифрования нет, поэтому для конфиденциальных материалов это неподходящий инструмент (§20).

27.6 Система шаблонов (профессиональное использование)

• Импорт файла/папки с автоматической классификацией (Business / Документы / UI Kit).
• Поддержка бинарных и табличных шаблонов для потоков отчётности.
• Автосвязка UI↔PDF для соединения темы редактора и стиля экспорта, с опцией «Разъединить».

27.7 Рекомендуемый рабочий чек-лист

1. Установите режим Base/Pro в зависимости от результата работы.
2. Проверьте требования в Проверке экспорта (Настройки → Приложение → Установки; LaTeX/Ghostscript — только если нужен PDF/X).
3. Выполните Preflight перед сдачей.
4. Для EPUB/ICML завершите мастер метаданных + обложки.
5. Для подписанных документов включите подпись PKCS#7 + метку времени.
6. В команде зафиксируйте ID сессии Collab во внутренних инструкциях.

28. Подключить помощника (MCP)

Начиная с 4.2 PressWork служит мостом MCP: чат-помощники (Claude Desktop, Codex CLI, Gemini CLI…) читают ваши проекты .pwk прямо на вашем компьютере — главы, заметки, статистику — без копипаста. Никогда не пишет в текст: у моста восемь инструментов для чтения и, только в тех документах, где вы это разрешили, два инструмента, которые оставляют предложения на ваше решение (§36). Ни один инструмент не меняет текст. Если у подключённого помощника есть собственные инструменты доступа к файлам компьютера, они работают не через PressWork.

• Настройка в один клик: Настройки → ИИ → Подключить помощника (MCP) → «Настрой за меня» (Claude Desktop / Codex CLI / Gemini CLI). Подключается папка открытого проекта со всеми .pwk внутри.
• Полностью закройте помощника перед настройкой (Claude Desktop переписывает свою конфигурацию при закрытии), затем откройте снова. Перед записью приложение делает резервную копию конфигурации.
• Папки суммируются: настройте из проектов в разных папках — помощник увидит все. Работает и при закрытом PressWork.
• В Claude: обычные чаты живут в облаке и не достают до вашего компьютера — выберите активность «На вашем компьютере» или отметьте коннектор presswork.
• Другие MCP-клиенты (Cursor, OpenCode…): ручной сниппет конфигурации для копирования. Через Экспорт Компетенции вы создаёте skill, который учит Claude наилучшим образом работать с вашими проектами (добавляется один раз, действует навсегда).
• Приватность, честно: то, что помощник читает, отправляется в его облачный сервис для обработки ответа — как копипаст, только автоматический. Не подключайте проекты, которые не отправили бы в чат.
• Требуется рабочий вид Complete.

29. Версии и варианты главы

Два разных инструмента для одного вопроса — «а если наоборот…» — на двух разных масштабах.

Версия — это другая книга. А в каждой версии у каждой главы могут быть свои варианты.

29.1 Версии

• Версия — альтернатива всего документа: другой финал, убранный персонаж, иная структура. Окончательная, та, что идёт в печать, остаётся нетронутой.
• Панель: Ctrl/Cmd+Shift+B или через меню. Открыть версию — значит войти в неё: с этого момента вы пишете там.
• Где вы находитесь, видно всегда: внизу окна появляется плашка с именем версии. Нет плашки — вы в окончательной версии.
• Сделать окончательной превращает версию в текст, который идёт в печать; прежний текст не теряется, он остаётся точкой в хронологии, и его можно восстановить. Сравнить показывает отличия от окончательной строка за строкой. Копировать в новый документ… отделяет версию в самостоятельный .pwk.
• Все версии лежат в одном .pwk: никаких лишних файлов, никакого Git.
• Карточки Синопсиса показывают, где дороги расходятся: на каждой карточке главы появляется отметка цветом версии там, где эта глава отличается, и перечёркнутая там, где её нет. Клик открывает Версии. Карточки, одинаковые во всех версиях, остаются чистыми: молчание означает «здесь ничего не разошлось». Находясь внутри версии, сравнение включает и окончательную — именно с ней и нужно сверяться, пока пробуешь другой путь.
• Главы, которые живут только в другом месте, не пропадают из виду: внизу Синопсиса при необходимости появляется список глав, существующих только в другой версии. Это особенно важно для переименованных, ведь главы распознаются по заголовку.

29.2 Варианты главы

• Вариант — вторая редакция одной главы: на бумаге это было «зачеркнуть кусок и написать рядом другой». В тексте живым остаётся только один — он и попадает в файлы.
• Создать: Синопсис → наведите курсор на карточку главы → ⑂ справа вверху. Текущий текст становится первой редакцией; новой вы даёте имя.
• Переключить: нажмите значок ⑂ на карточке и выберите. Активный помечен «в тексте». Меняется только эта глава.
• Удалить: корзина в меню. Активный удалить нельзя: сначала перейдите на другой.
• Где это видно: строка состояния, рядом со счётчиком слов — ⑂ вариант: имя. Если у главы под курсором вариантов нет, об этом тоже сказано, серым.
• У каждой версии свои варианты: созданные внутри версии не показываются в окончательной, и это сделано намеренно.

29.3 Если что-то не сходится

• Переименовал главу — варианты пропали: они не потеряны. Внизу Синопсиса есть полоса «Варианты без главы» со всем, что сейчас не нашло места; через меню «назначить…» вы возвращаете их на нужную главу. PressWork пытается сам отследить переименование, но, не будучи уверенным, предпочитает показать материал, а не угадывать.
• Отмена работает и здесь: смена варианта — такая же правка текста, как любая другая (Ctrl/Cmd+Z).
• На диске: versions/branches/<id>/ и versions/variants/ внутри .pwk. Это обычные .md: даже без PressWork работа читается.

30. Вид «Сводка», сроки сдачи и остальное в 4.4

30.1 Вид «Сводка» и срок сдачи

• Внутри синопсиса вид Сводка показывает главы таблицей: для каждой — целевое число слов, написанные слова и Разница между ними. Перетаскивайте строки, чтобы изменить порядок; новый порядок применяется к настоящему документу.
• Подвал ведёт общий счёт: цель документа, сколько распределено по главам, сколько осталось распределить. Для печати последняя строка оценивает страницы и показывает, сколько не хватает до кратного 16 (печатной тетради).
• В окне 🎯 Цели (верхняя панель) можно добавить срок сдачи: подвал «Сводки» покажет, сколько дней осталось и сколько слов в день нужно — считая написанные слова, а не цели. Он необязателен и исчезает при дневной цели; когда цель достигнута, темп умолкает.

30.2 Окно обновления

• Когда выходит новая версия, через несколько секунд после запуска появляется окно: какая версия доступна и какая установлена. «Что нового» открывает журнал изменений на вашем языке; «Обновить сейчас» скачивает и перезапускает; «Позже» просто закрывает — предложение вернётся при следующем запуске.

30.3 Два языка ассистента

• Ассистент говорит с вами на языке приложения, а пишет на языке рукописи: приложение на русском и роман на английском = пояснения по-русски, проза остаётся английской. Явно попросите перевод, когда хотите сменить язык текста.

31. Импорт папки Markdown (Notion, Obsidian, заметки)

• Файл и проект → Импортировать папку Markdown: выберите папку с файлами .md — экспорт из Notion (Экспорт → Markdown и CSV с подстраницами, затем распакуйте zip), хранилище Obsidian (оно уже папка) или папку с заметками. PressWork показывает реальное дерево и спрашивает, с чего начинается книга: записи первого уровня под выбранной точкой становятся главами, более глубокие — разделами. Рядом с папкой создаётся новый .pwk; исходная не изменяется.
• Notion и Obsidian распознаются автоматически: шестнадцатеричные коды убраны из заголовков, маленькие базы → таблицы, большие → Заметки, строки баз исключены, выноски → цитаты; [[wikilink]] и встраивания разрешаются по имени, front matter удаляется. Изображения копируются в документ; ссылки между страницами книги становятся перекрёстными, ссылки наружу — текстом.
• Итоговый отчёт сообщает, что вошло, а что нет — страницы, главы, скопированные и не найденные изображения, переписанные и ставшие текстом ссылки, таблицы, пропущенные файлы, закрытые блоки кода. Нулевые значения тоже показываются.

32. Сохранить и экспортировать под именем, открыть из системы (4.5)

• Сохранить как… (Файл и проект, рядом с Сохранить): для .md сохраняет копию под выбранным именем, и работа продолжается в копии; для .pwk дублирует весь документ — текст, метаданные, изображения, заметки, историю, версии — и открывает копию, без выводов из exports/. Заголовок раздела всегда говорит, какой файл открыт («Документ · роман.pwk»); Сохранить как документ .pwk появляется только для .md.
• Экспорт как… (панель Экспорт, рядом с Создать): всегда открывает системный диалог для имени и папки, даже там, где обычный экспорт пишет без вопросов. Поле Имя файла находится под Формат, выбранное имя запоминается для документа, независимо от заголовка в метаданных.
• Открыть с помощью: на Mac и Windows PressWork появляется в списке «Открыть с помощью» для файлов .md, не становясь программой по умолчанию: после установки .md по-прежнему открывается прежней программой. Двойной щелчок по .md, связанному с PressWork, открывает этот файл, даже при запущенном приложении. На Mac (с версии 4.6) .pwk — это документ: двойной щелчок открывает PressWork; заглянуть внутрь можно через Показать содержимое пакета (правый щелчок), а экспортированные файлы открываются из метки вывода или через Поделиться. В Windows и Linux .pwk остаётся папкой: открывайте из недавних, перетаскиванием в окно или через Открыть документ.

33. Диктовать вместо печати

• Диктовать вместо печати: PressWork использует системную диктовку, которая пишет в редактор, как в любое текстовое поле, с проговариваемой пунктуацией («запятая», «точка»). macOS: дважды fn; без fn — Системные настройки → Клавиатура → Диктовка → Сочетание клавиш, например «Дважды нажать Control». Windows: Win+H. В Linux системной диктовки нет.

34. Где вы находитесь и что сохранено (4.6, 4.7)

• Имя документа всегда на виду: внизу слева в строке состояния (при наведении виден полный путь) и в заголовке окна, если система его показывает. В версии рядом появляются 🌿 и её имя, а при повторном открытии документа, оставленного в версии, PressWork возвращается в эту версию.
• У .md с несохранёнными изменениями имя выделено курсивом и перед ним стоит «•». Если закрыть PressWork в таком состоянии, приложение спросит, закрыть ли без сохранения. Если всё же закрыть, изменения откладываются: при следующем запуске PressWork откроет последний .md и предложит их восстановить — затем достаточно сохранить. .pwk сохраняется сам и ничего не спрашивает, пока сохранение удаётся.
• Если сохранить не удаётся (.pwk переименовали или переместили извне, диск заполнен, не хватает прав, флешку вынули), это состояние остаётся на виду: имя получает «•», а индикатор внизу и метка вверху показывают ⚠️ Не сохранено, пока сохранение не удастся. Прежде чем закрыть приложение, перейти к другой версии, нажать «Сделать окончательной» или открыть другой документ, появляется окно «Документ не сохраняется» с причиной.
• Варианты в окне: «Повторить сохранение» (после того как вы вставили флешку обратно или освободили место на диске), «Сохранить копию…» (текст в другое место), «Выйти без сохранения» при закрытии или «Продолжить без сохранения» в остальных случаях, и «Отмена», чтобы остаться. Если уйти потом не удаётся, вы остаётесь в документе, и в следующий раз окно спросит снова. Документ, который сохраняется, ничего лишнего не спрашивает.
• Если content.md изменён другой программой, появится полоса с предложением перезагрузить его.

35. Экспорт и обращение за помощью (4.6, 4.7)

• Экспорт запоминает последнюю папку для каждого документа на этом компьютере. Если изменить заголовок, файл со старым именем в exports/ заменяется файлом с новым именем, чтобы не отправить не тот.
• После экспорта у сообщения «Сохранено: …» две кнопки: Открыть открывает файл, Показать в папке показывает его уже выделенным. Они есть и после PDF/X или при предупреждении, а сообщение не исчезает, пока на нём держится указатель мыши; после экспорта KDP «Открыть» открывает внутренний блок.
• Если экспорт не удался, сообщение на языке приложения говорит, что пошло не так и где: неизвестная команда LaTeX и рядом с какой фразой, недостающий пакет LaTeX и как его установить, ошибка Typst с номером строки, сломанный YAML front matter. Если не хватает изображений, оно говорит, сколько их, какое первое и в какой папке их искали.
• Word и ODT получают формат страницы и поля PDF; ePub содержит оглавление и таблицу стилей PressWork, даже при экспорте одного документа.
• Большие фотографии, например снимки с телефона в полном разрешении, в редакторе и предпросмотре показываются из уменьшенной копии, которая создаётся в первый раз примерно за секунду: приложение не зависает, а экспорт всегда использует оригинал.
• Для поддержки: окно Инфо → «Скопировать сведения для поддержки». Копируются версия, система и установленные движки экспорта, без текстов и имён файлов: вставьте это в сообщение.

36. Правки и предложения, решаемые в тексте (4.7)

• У каждой пометки правки свои кнопки. Рядом со вставкой, удалением или заменой стоят ✓ (принять) и ✗ (отклонить); у выделения или комментария — ✓ (готово: убирает пометку и оставляет текст). Решение принимается прямо там, где стоит пометка, по одной; Отмена (Ctrl/Cmd+Z) возвращает назад.
• Ассистенты могут предлагать, но никогда не писать. Ассистент, подключённый через мост MCP (§28), — Claude, Codex, Gemini — может оставлять предложения только в тех документах, где вы это разрешили: щелчок по имени документа внизу → «Ассистенты могут предлагать правки». Пока разрешение включено, рядом с именем видно ✎ Предложения ИИ включены: один щелчок его выключает. В новых документах оно выключено.
• Предложения ждут вне текста. Когда они приходят, появляется ✎ Предложения от Claude: 3: один щелчок переносит их в текст как пометки, с именем того, кто предлагает, и причиной (@Claude: …), чтобы решить их с помощью ✓ и ✗. Отмена убирает их все сразу. Сами они не входят: текст не сдвигается, пока вы пишете.
• ИИ внутри PressWork тоже предлагает. При выделении кнопка Вставить в редактор в окне AI-ассистента ставит текст ИИ как предложение, с ✓ и ✗ (на нескольких строках каждая строка решается отдельно), и пока вы его не примете, в печать идёт прежний текст. Без выделения текст добавляется у курсора, как раньше. При выделении ИИ отвечает только новым текстом.
• Все сразу. Рядом с ✓ ✗ предложения есть ▾ с пунктами «Принять все предложения AI (15)» и «Отклонить все предложения AI (15)»: они действуют для того, кто сделал это предложение, а предложения других авторов и ваши собственные правки остаются на месте. Отмена возвращает их все.
• Если за это время эта фраза изменилась, предложение ничего не трогает: индикатор засчитывает его как «уже неприменимое», и оно отбрасывается.
• То, что не решено, не идёт в печать. Предложение на рассмотрении не попадает ни в предпросмотр, ни в один экспорт, как если бы оно было отклонено, а меню Export показывает, сколько их. Ваши собственные правки, как всегда, считаются принятыми.
• Также заметки и синопсисы. Ассистент может предложить новую заметку (заметку, материал, персонажа) или синопсис главы. Через индикатор они попадают на своё место: заметка — в панель Заметки с меткой «✎ @Claude», синопсис — на карточку главы, в рамке. Там вы их оставляете или отбрасываете; ничто не перезаписывает уже написанное.
• Предложения относятся к окончательной версии, а не к другим версиям.