Origami PDF: возможности, ограничения и актуальный статус проекта

Origami PDF — не обычный просмотрщик, а Ruby-библиотека и набор консольных утилит для разбора внутренней структуры PDF. Канонический проект Guillaume Delugré публикуется как gem origami: он читает объектную модель, изменяет и создаёт PDF, работает с шифрованием, подписями, вложениями и формами. Последний официальный gem 2.1.0 выпущен 7 октября 2017 года, поэтому сегодня исходный Origami разумно считать legacy-инструментом, отдельно от более новых форков.

Скачать Origami PDF

Безопасный исходный путь получения Origami — реестр RubyGems и канонический репозиторий gdelugre/origami. Для воспроизводимой установки разумно явно фиксировать версию 2.1.0, потому что именно она является последним опубликованным gem исходного проекта. Команда установки через RubyGems выглядит как gem install origami -v 2.1.0. При использовании Bundler лучше закрепить ту же версию в зависимостях проекта, чтобы сборка не зависела от случайных изменений окружения.

Опубликованный gem и текущая ветка master не идентичны: для 2.1.0 RubyGems фиксирует зависимость colorize ~> 0.7, а нынешний gemspec репозитория — ~> 0.8. Поэтому для воспроизводимой сборки используйте либо gem 2.1.0, либо конкретный commit исходников; установка произвольного master меняет состав кода и зависимостей.

Современные варианты миграции — отдельные gems origami-docspring и origamindee, а не новые версии исходного пакета. origami-docspring 2.3.3 опубликован в июле 2025 года и требует Ruby 3.2+, origamindee 4.0.2 — в мае 2025 года и требует Ruby 2.7+. Их следует оценивать как форки с собственной версионностью и зависимостями.

Что такое Origami PDF

Origami — чистая Ruby-библиотека для работы с внутренней моделью PDF. Официальное описание сводится к трём базовым операциям: разобрать существующий документ, изменить его структуру и сохранить результат либо создать новый PDF программно. Это принципиально отличает Origami от пользовательских приложений вроде PDF-XChange Editor, где основные задачи выполняются через визуальный интерфейс.

Разработчиком исходного проекта и автором gem указан Guillaume Delugré. Официальный пакет называется origami; обозначения «Origami PDF» и «origami-pdf» часто встречаются в названиях дистрибутивных пакетов и старых зеркал, но канонический upstream-репозиторий называется gdelugre/origami. Это стоит учитывать при поиске, потому что в сети есть не связанные с PDF проекты с названием Origami, а также старые форки исходного кода.

На 15 сентября 2026 года 2.1.0 остаётся последним релизом исходного gem. Репозиторий не помечен как архивный, однако релизов с 2017 года нет, а Mindee объясняла создание собственного форка неактивностью оригинального проекта. Корректный статус — доступный, но фактически не развиваемый upstream, а не формально закрытый продукт.

Хронология развития и поддержки

Версия 2.0 стала крупной технической переработкой: код был адаптирован под Ruby 2.x, минимальная версия Ruby поднялась до 2.1, появился lazy parser, были улучшены типизация объектов и работа с cross-reference, добавлены crypt filters и многочисленные исправления. Версия 2.1.0 сделала важное организационное изменение — PDF Walker был вынесен в отдельный gem и отдельный репозиторий.

После 7 октября 2017 года новых релизов исходного gem не было. В 2022 году Mindee выпустила Origamindee, мотивируя форк поддержкой Ruby 3 и возможностью исправлять проблемы парсинга; в 2025 году появился origami-docspring с требованием Ruby 3.2+. Поэтому существующую зависимость от origami 2.1.0 логично сопровождать как legacy-компонент, а для нового кода сначала сравнить форки и современные PDF-библиотеки.

Основные функции Origami PDF

Разбор объектной структуры PDF

Главная сильная сторона Origami — представление PDF как набора Ruby-объектов, а не только как последовательности страниц. Класс Origami::PDF читает файл с диска, сохраняет информацию о ревизиях, заголовке, каталоге, страницах, потоках и ссылках. Можно обходить объекты документа, страницы, шрифты, поля форм и именованные сущности. Для исследовательских задач это полезнее обычного визуального просмотра: пользователь видит не только то, что отрисует viewer, но и технические компоненты, которые могут быть скрыты от страницы.

Парсер поддерживает два режима. По умолчанию документ разбирается целиком. При параметре lazy объекты загружаются по мере обращения. Такой режим особенно уместен, когда скрипту нужен ограниченный набор данных — например, шрифты нескольких страниц или метаданные. При этом lazy parsing не превращает Origami в потоковый редактор: при сохранении библиотека при необходимости загружает оставшиеся объекты, поэтому экономия на старте не гарантирует малого пикового потребления памяти на всём цикле обработки.

Создание и изменение документов

Origami умеет создавать PDF с нуля, добавлять и вставлять страницы, записывать текст и работать с объектами каталога. Официальный пример создаёт объект PDF, добавляет страницу, записывает строку и сохраняет файл. На более низком уровне доступны добавление объектов, новые ревизии, управление ссылками, удаление revision и сохранение документа до заданной ревизии. Последняя возможность особенно интересна при анализе incremental updates: можно получить состояние файла на определённом этапе истории.

Шифрование, подписи и права

Origami поддерживает RC4 и AES, а в changelog и README отдельно заявлена поддержка revision 6 стандартного security handler. Метод encrypt принимает пользовательский и owner-пароли, выбор cipher, длину ключа, hardened-режим, шифрование метаданных и набор разрешений. В документации метода значение по умолчанию — AES с ключом 128 бит. Это исторически полезный набор возможностей, но его нельзя интерпретировать как рекомендацию использовать устаревшие RC4-схемы в новых системах.

API содержит функции цифровой подписи с X.509-сертификатом и закрытым ключом, параметры PKCS#7, данные о причине, месте и контакте подписанта. Также присутствует поддержка Usage Rights. Для серьёзного электронного документооборота одной возможности поставить PDF-подпись недостаточно: отдельно нужно проверять требования к алгоритмам, цепочкам доверия, timestamping, профилям PAdES и регуляторной совместимости. Origami 2.1.0 не является полноценной современной платформой управления доверенными подписями.

Формы, вложения и активное содержимое

В модели представлены AcroForm и XFA, поля форм, вложенные файлы и PDF Portfolio. Методы позволяют искать встроенные файлы по имени, обходить поля и работать с JavaScript-действиями документа. Это важно в анализе подозрительных PDF: вредоносная логика часто живёт не в видимом тексте страницы, а в действиях, скриптах, вложениях или нетипичных объектах.

Для JavaScript-эмуляции README указывает необязательную зависимость therubyracer. Этот компонент относится к старой экосистеме Ruby/V8 и не должен восприниматься как обязательная часть базового парсинга. Если задача состоит только в извлечении JavaScript-кода или поиске соответствующих объектов, выполнение скрипта не требуется и с точки зрения безопасности обычно нежелательно.

Консольные инструменты

Вместе с gem устанавливается набор команд. pdfmetadata выводит метаданные; pdfdecompress снимает фильтры с потоков; pdfdecrypt и pdfencrypt работают с защищёнными документами; pdfextract извлекает потоки, JavaScript, вложения, шрифты, метаданные и изображения; pdfexplode помогает минимизировать проблемные документы; pdf2ruby экспериментально преобразует PDF в Ruby-скрипт, который строит эквивалентную структуру; pdfsh запускает интерактивную Ruby-среду в пространстве имён Origami.

Отдельно стоит pdfcop. Это не антивирус и не универсальный malware scanner, а фильтрующий механизм на основе политик и белых списков PDF-функций. Исходный код описывает его как движок, который сканирует документ на опасные структуры и может применять выбранную policy. Его результат полезен как дополнительный сигнал при исследовании файла, но не как доказательство безопасности.

Интерфейс и удобство использования

У основного Origami 2.1.0 нет привычного графического интерфейса. Основная рабочая зона — Ruby-код, командная строка и при необходимости интерактивный pdfsh. Поэтому оценивать удобство по критериям «панель миниатюр», «лента», «drag-and-drop» или локализация меню бессмысленно: таких элементов у библиотеки нет.

На уровне API логика достаточно последовательна для разработчика, знакомого с PDF: документ представлен классом PDF, страницы и объектные структуры обходятся перечислителями, высокоуровневые операции соседствуют с прямым доступом к словарям и ссылкам. Это даёт большую гибкость, но порог входа выше, чем у библиотек, ориентированных на типовые операции. Для уверенной работы полезно понимать indirect objects, xref, trailers, streams, incremental updates и security handlers.

PDF Walker часто ошибочно называют «GUI Origami». Исторически он действительно был связан с проектом, но с версии 2.1 вынесен в отдельный gem и репозиторий. PDF Walker использует Gtk2 и Gtkhex и умеет ходить по дереву объектов, ссылкам и потокам. В обзоре Origami 2.1.0 его корректно считать внешним интерфейсом на базе Origami, а не встроенной частью пакета.

Русский интерфейс как отдельная функция отсутствует: сообщения CLI и документация проекта англоязычные, а API использует английские имена классов и методов. Для разработчика это стандартно, но для пользователя без опыта командной строки Origami существенно менее доступен, чем Foxit Reader или другой настольный viewer.

Поддерживаемые форматы и совместимость

Официальный README прямо указывает разбор PDF, FDF и PPKLite. PDF является основным рабочим форматом и единственным, для которого проект предоставляет широкий набор операций создания, изменения и сохранения. FDF относится к данным PDF-форм, а PPKLite — к хранилищу сертификатов Adobe; наличие парсеров этих форматов не означает, что Origami является универсальным конвертером документов.

Экспортом фактически является запись новой PDF-структуры, а также извлечение внутренних ресурсов. Метод save может перекомпилировать документ, перестроить служебные структуры и по умолчанию делинеаризовать linearized PDF. Поэтому полученный файл может быть функционально эквивалентным, но не побайтно идентичным исходнику. Для цифровой криминалистики исходный файл необходимо хранить отдельно.

По платформам gemspec объявляет Gem::Platform::RUBY, то есть пакет не привязан к одной ОС на уровне метаданных. Но это не официальная матрица Windows/macOS/Linux: upstream указывает прежде всего версию Ruby. Наличие пакета в Debian и FreeBSD подтверждает практическую переносимость на Unix-подобных системах. Совместимость с конкретной современной версией Ruby 3.x для исходного gem 2.1.0 официально не гарантирована; именно это стало одной из причин появления форков.

Производительность и стабильность

Upstream не публикует актуальных бенчмарков, поэтому корректных универсальных цифр скорости и памяти нет. Проект написан на чистом Ruby; по умолчанию PDF разбирается целиком, а режим lazy откладывает загрузку части объектов до обращения к ним, что полезно для выборочного анализа.

При сохранении ситуация меняется: реализация save вызывает загрузку всех объектов, если документ ещё не полностью загружен. Следовательно, lazy mode полезен для чтения и разведочного анализа, но не гарантирует малое потребление памяти при полной перезаписи крупного файла. Документы с множеством потоков, изображений, вложений и ревизий потенциально требуют заметно больше ресурсов, чем показывает размер самого PDF на диске.

Стабильность нужно оценивать с учётом возраста кода. Последний официальный release старше современных Ruby 3.x, в issue-трекере остаются открытые задачи, а сторонние форки отдельно добавляли совместимость с новыми версиями Ruby и стандартными библиотеками, вынесенными из core. Для production-системы это означает обязательные regression-тесты на собственном наборе PDF, особенно если файлы приходят от внешних пользователей.

Парсер намеренно работает с нетривиальными и иногда повреждёнными структурами, а pdfextract даже имеет опции обхода ошибок zlib и PNG при извлечении. Это полезно в forensic-сценариях, но не превращает библиотеку в гарантированно устойчивый sanitizer. Если файл потенциально враждебный, разумно запускать обработку в изолированном процессе или контейнере с лимитами CPU, памяти, времени и доступа к файловой системе.

Лицензирование и версии

Origami 2.1.0 распространяется бесплатно как open-source software. RubyGems и gemspec указывают лицензию LGPL-3.0+. Платной редакции, подписки, пробного периода, лимита числа файлов или обязательной регистрации у исходного проекта нет. Для локального использования не требуется аккаунт или подключение к облачному сервису.

Версионная картина требует аккуратности. Официальный gem origami остановился на 2.1.0. Номер версии ветки master не следует автоматически считать новым стабильным релизом, потому что RubyGems ничего новее не публикует. PDF Walker имеет собственный gem 1.0.0 и GPL-3.0+; это отдельный пакет. Origamindee и origami-docspring также имеют собственную нумерацию и не должны подменять собой исходный продукт в документации или зависимостях.

Есть и юридическая деталь зависимостей. Опубликованный origami 2.1.0 задаёт для colorize диапазон ~> 0.7; версии colorize, попадающие в этот диапазон, публикуются на RubyGems под GPL-2.0. Команда Mindee в описании своего форка прямо называет лицензию colorize причиной замены её на Rainbow и указывает на несовместимость с желаемой моделью LGPL. Это не является юридической консультацией, но для компании, которая встраивает Origami в распространяемый закрытый продукт, лицензионную цепочку следует проверить отдельно, а не ограничиваться строкой «LGPL-3.0+» у верхнего gem.

Системные требования

Ruby и зависимости

Для официального gem 2.1.0 RubyGems указывает минимальный Ruby 2.1. Это единственное чёткое обязательное требование версии, опубликованное в метаданных пакета. Runtime-зависимость релиза — colorize с требованием ~> 0.7. В README также указана необязательная зависимость therubyracer для эмуляции PDF JavaScript.

Важно не превращать «Ruby >= 2.1» в утверждение о полной совместимости со всеми более новыми Ruby. Метаданные gem допускают установку, но не содержат современной тестовой матрицы. На Ruby 3.x могут понадобиться дополнительные зависимости или патчи, а поддерживаемые форки как раз обновляют требования: origami-docspring 2.3.3 требует Ruby 3.2+, Origamindee 4.0.2 — Ruby 2.7+.

Операционная система и ресурсы

Официальных требований к объёму RAM, диска, процессору и конкретным версиям Windows, macOS или Linux upstream не публикует. Пакет обозначен как Ruby-platform gem, поэтому практическое ограничение задаётся доступностью совместимого Ruby и зависимостей. Для server-сценариев следует дополнительно учитывать размер и сложность входных PDF: декомпрессия потоков и полная загрузка объектной модели могут значительно увеличить фактическое потребление памяти.

Карта критических зависимостей

Паспорт обратимости операций

Чтение и анализ. Операции PDF.read, обход объектов, pdfmetadata и диагностические проверки не обязаны менять исходный файл. Это наиболее обратимый режим: достаточно работать с копией или открыть документ только для чтения. Однако извлечённые данные могут содержать активное или конфиденциальное содержимое, поэтому каталог результатов следует защищать так же, как оригинал.

Сохранение через save. Библиотека может перекомпилировать объектную структуру, перестроить ссылки и по умолчанию делинеаризовать linearized PDF. Вернуть байт-в-байт исходник из результата нельзя; обратимость обеспечивается только сохранённой оригинальной копией. Для forensic-процедур вычисляйте хэш исходного файла до обработки и никогда не заменяйте его рабочим результатом.

Редактирование объектной модели. Часть изменений можно отменить в рамках собственного Ruby-кода до вызова save, но у Origami нет пользовательского глобального Undo-стека как у настольного редактора. Надёжная стратегия — immutable source, отдельный output и автоматическая проверка результата сторонним viewer или валидатором.

Преимущества и недостатки Origami PDF

Плюсы и минусы

• Глубокий доступ к внутренним PDF-объектам, ревизиям, потокам, xref, вложениям, формам и действиям.

• Чистый Ruby: библиотеку удобно встраивать в Ruby-скрипты и приложения без отдельного нативного API.

• Есть и программный API, и готовые CLI-инструменты для метаданных, извлечения, шифрования и анализа.

• Поддерживаются сложные функции PDF: AES/RC4, подписи, Usage Rights, AcroForm/XFA, object streams и вложенные файлы.

• Lazy parsing позволяет не разбирать весь документ сразу в задачах выборочного чтения.

• Нет облачной зависимости, аккаунта, подписки и лимита числа файлов.

Минусы

• Последний официальный gem 2.1.0 выпущен в 2017 году; активного upstream-сопровождения фактически нет.

• Нет встроенного рендеринга страниц и обычного GUI, поэтому продукт не подходит как повседневный PDF-reader.

• Совместимость исходного gem с текущими Ruby 3.x не подтверждается современной upstream-матрицей.

• Высокий порог входа: для безопасной модификации нужно понимать внутреннюю структуру PDF.

• При полном сохранении lazy mode не исключает загрузку всех объектов и заметное потребление памяти.

• Лицензионная цепочка вокруг зависимости colorize требует отдельной проверки при распространении ПО.

• pdfcop и другие аналитические функции не заменяют полноценный malware sandbox, антивирус или специализированный валидатор.

Сравнение с аналогами

С настольными редакторами сравнение ещё проще. Adobe Acrobat Pro и PDFsam Basic решают пользовательские задачи через GUI: редактирование, организация страниц, экспорт или типовые операции. Origami рассчитан на программирование и анализ структуры. Выбирать его вместо GUI-продукта имеет смысл только тогда, когда сценарий должен быть автоматизирован или требует доступа к внутренним объектам PDF.

С Sumatra PDF продукты почти не конкурируют. Sumatra PDF — быстрый Windows-просмотрщик и рендерер документов; Origami не рисует страницу и не предназначен для чтения книг или повседневного просмотра. Они скорее дополняют друг друга: скрипт Origami может создать или модифицировать PDF, а Sumatra PDF — независимо открыть результат и показать, как его интерпретирует реальный viewer.

Инструкция по установке

Установка через RubyGems

1. Установите рабочую версию Ruby и убедитесь, что команды ruby и gem доступны в терминале. Для исходного Origami 2.1.0 формальный минимум — Ruby 2.1, но для новой системы лучше заранее выбрать конкретную протестированную сборку, а не рассчитывать на любую Ruby 3.x.

2. Создайте отдельное окружение проекта или контейнер, если Origami будет обрабатывать файлы из внешних источников. Это снижает риск конфликтов со старыми зависимостями и упрощает воспроизводимость.

3. Установите фиксированную версию командой gem install origami -v 2.1.0. В проекте с Bundler укажите точную версию зависимости и сохраните lock-файл.

4. Проверьте наличие gem командой gem list origami. Затем выполните короткую загрузку библиотеки через Ruby и выведите Origami::VERSION; ожидаемая версия исходного пакета — 2.1.0.

5. Проверьте установку консольных утилит командой справки, например pdfextract —help или pdfmetadata —help. Если shell не видит исполняемый файл, проверьте каталог gem executables в PATH.

Первый запуск без изменения документа

Для первой проверки не начинайте с save или шифрования. Возьмите неважный тестовый PDF, сделайте копию и выполните pdfmetadata. Затем запустите pdfextract только в отдельный пустой каталог. Такой порядок подтверждает, что Ruby, gem и парсер работают, но не изменяет исходный PDF. Если задача — разработка через API, сначала ограничьтесь PDF.read и выводом количества страниц.

Безопасное удаление

Если пакет больше не нужен, сначала удалите его из Gemfile проекта и сохраните lock-файл, затем проверьте зависимости. Для локальной установки используйте gem uninstall origami -v 2.1.0: RubyGems предупреждает, если удаляемый gem нужен другому установленному пакету. Не применяйте принудительное игнорирование зависимостей без отдельной проверки; собственные Ruby-скрипты и исходные PDF сохраняйте независимо от gem.

Практические кейсы

Структурный аудит подозрительного PDF

Цель: получить техническую картину документа без открытия в обычном viewer. Подготовка: работать с копией файла в изолированном каталоге, зафиксировать хэш оригинала. Шаги: сначала вывести метаданные через pdfmetadata; затем запустить pdfcop с подходящей политикой; после этого извлечь JavaScript, вложения и потоки через pdfextract в отдельную папку. Проверка: сопоставить отчёт pdfcop с наличием извлечённых скриптов и вложений. Ограничение: отсутствие срабатывания не доказывает безопасность, а извлечённые файлы нельзя автоматически запускать.

Извлечение ресурсов для ручного анализа

Цель: получить изображения, шрифты, метаданные, вложения и JavaScript из PDF. Подготовка: создать пустой output-каталог на разделе с достаточным свободным местом. Шаги: для полного набора явно указать переключатели -s -j -a -f -m -i: без параметров pdfextract по умолчанию включает потоки, JavaScript, шрифты, вложения и изображения, но не metadata. Проверка: убедиться, что для выбранных категорий появились ожидаемые файлы и каталоги. Ограничение: декодированные потоки способны занять существенно больше места, чем исходный PDF.

Создание простого PDF из Ruby

Цель: сгенерировать документ программно без GUI. Подготовка: отдельный Ruby-скрипт с require ‘origami’. Шаги: создать Origami::PDF, добавить страницу методом append_page, записать текст через page.write и сохранить в новый путь. Проверка: снова открыть полученный файл через Origami и посчитать страницы, затем проверить визуальную отрисовку независимым viewer. Ограничение: Origami не является современной системой верстки; сложные макеты, типографика и доступность потребуют более специализированного инструмента.

Создание защищённой копии

Цель: сформировать отдельный зашифрованный PDF. Подготовка: не заменять оригинал, заранее определить требования к алгоритму и совместимости с целевыми viewer. Шаги: использовать pdfencrypt или метод encrypt, задать пользовательский и owner-пароли и сохранить новый файл. Проверка: открыть результат в независимом просмотрщике, проверить запрос пароля и разрешённые операции. Ограничение: поддержка старых RC4-схем не означает, что их следует выбирать в новой системе; криптографические требования организации имеют приоритет.

Контроль перед сохранением и передачей

• Оригинал хранится отдельно и не перезаписывается.

• Известно, применялись ли recompile, delinearize, decrypt или другие параметры save.

• Файл повторно открывается Origami без ошибки парсера.

• Количество страниц и критичные метаданные соответствуют ожидаемым.

• Формы, вложения и подписи проверены отдельно, если они важны для бизнес-процесса.

• Результат визуально открыт как минимум одним независимым PDF-renderer.

• Для передачи наружу подсчитан хэш финального файла и сохранён журнал параметров преобразования.

Навигатор по сбоям

Симптом: gem устанавливается, но require ‘origami’ падает. Сначала проверьте версию Ruby и список зависимостей. На современной Ruby причиной может быть изменение состава стандартной библиотеки; не маскируйте проблему случайным добавлением gems без тестов. Если это новый проект, сравните поведение с поддерживаемым форком.

Симптом: CLI-команда не найдена. Проверьте, куда RubyGems установил executables и входит ли этот каталог в PATH. Сам факт наличия gem в gem list не гарантирует корректную настройку shell.

Симптом: конкретный PDF не парсится. Сохраните файл как regression fixture, попробуйте только чтение без модификации и посмотрите тип исключения. Не включайте глобально режимы игнорирования ошибок для production-потока: они полезны в forensic-анализе, но могут скрыть проблему структуры.

Симптом: после save файл открывается иначе. Сравните исходный и выходной документ на уровне страниц, форм, вложений и подписей. Помните, что save по умолчанию может перекомпилировать структуру и снять linearization. Если побайтная сохранность важна, Origami не должен перезаписывать доказательную копию.

Симптом: подпись стала недействительной. Любая модификация подписанного PDF может повлиять на проверку подписи в зависимости от типа изменения и ByteRange. Не пытайтесь «починить» документ повторным save. Вернитесь к исходнику и проектируйте операцию как отдельный подписной workflow.

Часто задаваемые вопросы

Нужен ли компилятор для базовой установки Origami?

Сам Origami заявлен как pure Ruby library, а его обязательная runtime-зависимость colorize также является Ruby-пакетом. Поэтому у базового gem нет собственного нативного расширения, которое требуется компилировать при каждой установке. Иная ситуация возможна с необязательными компонентами: например, therubyracer нужен только для эмуляции JavaScript и относится к старому стеку Ruby/V8.

Можно ли извлечь JavaScript из PDF, не выполняя его?

Да. pdfextract ищет JavaScript-объекты и сохраняет найденный код как отдельные файлы; для такого извлечения эмуляция через therubyracer не нужна. Для анализа неизвестного PDF это важное различие: код можно исследовать как данные, не включая его исполнение в рабочий процесс.

Что именно делает экспериментальный pdf2ruby?

Официальный README описывает pdf2ruby как инструмент, который преобразует PDF в скрипт Origami, способный построить эквивалентный документ. Пометка experimental принципиальна: такой результат подходит для исследования структуры и воспроизведения объекта через API, но не обещает байт-в-байт идентичность исходному файлу.

Как гарантировать, что проект использует исходный Origami, а не один из форков?

У пакетов разные имена в RubyGems: исходный пакет называется origami, а форки публикуются как origami-docspring и origamindee. В Bundler следует фиксировать именно имя и нужную версию gem, а lock-файл хранить вместе с проектом. Простого совпадения пространства имён Origami в Ruby-коде недостаточно, чтобы определить происхождение установленной реализации.

Почему сохранённый через Origami PDF нельзя считать копией исходника?

Операция save может перекомпилировать объектную структуру и по умолчанию убрать linearization. Даже когда документ визуально выглядит так же, расположение объектов, служебные таблицы и байтовое представление способны измениться. Поэтому для аудита или цифровой криминалистики исходный файл и его хэш хранят отдельно, а результат записывают в новый путь.

Можно ли использовать pdfextract как средство резервного копирования PDF?

Нет. Утилита извлекает выбранные ресурсы — потоки, скрипты, изображения, шрифты, метаданные и вложения — но набор этих файлов не является самодостаточным образом исходного PDF. Для восстановления документа нужен оригинал либо отдельно спроектированный процесс сериализации всей структуры.

Вывод

Origami PDF остаётся необычно мощным инструментом для разработчика, которому нужен низкоуровневый доступ к PDF из Ruby: объектная модель, ревизии, потоки, вложения, формы, шифрование, подписи и набор исследовательских CLI-команд дают больше контроля, чем типичный пользовательский редактор. Особенно полезен он в legacy-проектах, автоматизированной инспекции файлов и узких forensic-сценариях, где уже существует код на API Origami.

Главный минус в 2026 году — не отсутствие функций, а состояние исходного upstream. Официальный gem 2.1.0 не обновлялся с 2017 года, его совместимость с современной Ruby не поддерживается актуальной тестовой матрицей, а экосистема уже породила отдельные форки для решения этих проблем. Поэтому начинать новый production-проект непосредственно на gdelugre/origami без сравнительного теста трудно обосновать.

Для нового Ruby-кода логичнее сначала проверить origami-docspring, Origamindee или HexaPDF; для надёжных структурных преобразований на командной строке — qpdf. Если же задача пользовательская — чтение, аннотации, организация страниц или визуальное редактирование — лучше выбрать профильное приложение вроде PDF24 Creator, PDF-XChange Editor или Sumatra PDF в зависимости от требуемых функций. Origami стоит выбирать тогда, когда нужен именно программируемый доступ к внутренностям PDF и команда готова сама контролировать runtime, совместимость и безопасность.