Tensionix ENDERU
GitHub28 repositoriesDaily Tech3 subscribersaudion.devthe product shelfRSSrelease feed
← All notesProjects

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

Содержание

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-наборе.

Edited 09.04.2026