# Audion Office Image Optimizer - руководство пользователя

**Содержание**

- [Запуск](#запуск)
- [Подготовка](#подготовка)
- [Оптимизация](#оптимизация)
- [Проверка Результата](#проверка-результата)
- [Workbench И Пути](#workbench-и-пути)
- [Launcher И Кодировка](#launcher-и-кодировка)
- [Безопасное Обслуживание](#безопасное-обслуживание)
- [Диагностика](#диагностика)
- [Перед Релизом](#перед-релизом)

Audion Office Image Optimizer уменьшает объём встроенных изображений в офисных документах, сохраняет результат отдельной копией и формирует понятный отчёт обработки.

## Запуск

Для обычной работы используйте GUI-launcher. Проектный launcher содержит те же операции для клавиатурного режима, а builder и install относятся к обслуживанию.

Перед первым запуском проверьте portable runtime. Исходные документы не должны находиться в disposable runtime/cache-папках.

## Подготовка

1. Добавьте один или несколько поддерживаемых документов через source picker.
2. Проверьте список и удалите случайные позиции.
3. Выберите output, отличный от папки источника.
4. Укажите профиль оптимизации и доступные ограничения качества/размера.

Не перезаписывайте единственный экземпляр важного документа. Работайте с копией и сравнивайте результат до замены оригинала.

## Оптимизация

Запустите операцию один раз и следите за терминалом. Приложение извлекает или потоково обрабатывает поддерживаемые изображения, применяет выбранную политику, пересобирает документ и сохраняет результат в target.

Результат зависит от формата документа, типов изображений, размеров, исходного сжатия, прозрачности и структуры Office-пакета. Неподдерживаемые объекты должны отражаться в отчёте, а не исчезать молча.

## Проверка Результата

После завершения:

- откройте результат в соответствующем Office-приложении;
- проверьте характерные страницы, слайды, листы, колонтитулы и фоны;
- сравните размер с исходным файлом;
- внимательно проверьте текст на изображениях, схемы, прозрачность и тонкие линии;
- прочитайте log/report о пропущенных или проблемных объектах;
- храните источник до завершения визуальной проверки.

## Workbench И Пути

GUI разделяет `Source` и `Target`. В source может быть несколько документов, target является выходной папкой. Reset очищает выбор, а delete удаляет только выбранную запись управляемого списка.

Поддерживаются пути с пробелами и кириллицей. Временные данные хранятся в управляемом runtime, а не в корне. Пользовательский output не считается кэшем.

## Launcher И Кодировка

GUI, FZF и CMD fallback вызывают одни проектные команды. Переводятся только видимые подписи; пути, ID команд, ключи config и переменные окружения остаются стабильными.

CMD/BAT используют UTF-8 без BOM и CRLF. Если launcher зацикливается, мгновенно закрывается или показывает битый текст, запустите encoding check и сравните dispatch FZF с fallback-меню.

## Безопасное Обслуживание

Штатный cleanup может удалить кэши, временное извлечение, отчёты, логи и пересобираемые runtime-артефакты согласно политике проекта. Он сохраняет код, config, input, пользовательский output, лицензии и каноническую документацию.

Builder нужен при изменении зависимостей или runtime. Для обычной обработки документов повторная сборка не требуется.

## Диагностика

- Нет результата: проверьте права target и первый error в терминале.
- Документ не открывается: сохраните исходник и найдите первую ошибку упаковки в отчёте.
- Изображения стали мягкими: выберите менее агрессивный профиль или поднимите quality/size limit.
- Размер почти не изменился: изображения уже могли быть сжаты или документ содержит векторные объекты.
- Часть изображений пропущена: проверьте поддержку их формата и типа Office-объекта.
- Не работает picker: проверьте portable PowerShell и quoting пути.

## Перед Релизом

Проверяются launcher-файлы, portable imports, по одному документу каждого поддерживаемого семейства, безопасность cleanup, лицензии и ссылки документации. Сгенерированные PDF не хранятся в исходном Docs-наборе.