dvpl_go [RU] | EN

Note

Конвертер использует библиотеку lz4 для повышения скорости и качества сжатия.
Формат имеет ограничения по размеру сжимаемых данных!

Как использовать?

Tip

Гайд по использованию конвертера на Русском
A guide to using the converter in English

Поддерживаемые типы сжатия

Note

Тип	Название	Описание
0	none	Сжатие полностью отсутствует.
1	lz4hc	Более сильное и медленное чем lz4.
2	lz4	Менее сильное и более быстрое чем lz4hc.

Переменные среды

В переменных среды могут храниться 2 настройки конвертера DVPL_MAX_WORKERS и DVPL_COMPRESS_TYPE для указания количества параллельно работающих процессов и тип сжатия соответственно.

• DVPL_MAX_WORKERS — Максимальное количество параллельных обработчиков. (Автоматически ограничивается при превышении допустимого значения.)
• DVPL_COMPRESS_TYPE — Указывает уровень сжатия от 0 до 2. (В случае несуществующего типа, будет ошибка.)

Как задать:

1. Создать вручную

   • Нажать Win+R.
   • Выполнить SystemPropertiesAdvanced.
   • Открыть Переменные среды... и создать соответствующие переменные.

2. Через командную строку

   • Пуск → cmd → правой кнопкой → Запуск от имени администратора
   • Вставьте одну из команд:
     • Для одного пользователя:

       setx DVPL_MAX_WORKERS 4
       setx DVPL_COMPRESS_TYPE 1

3. Использовать installer.bat

   • Скачайте из репозитория installer.bat и запустите.
   • Используйте внутренние функции для настройки.

Warning

Не рекомендуется для использования на данный момент т.к работает только с фиксированным путём C:\Tools\DvplGO. Создан в целях отладки.

CMD

R:\Github\dvpl_go\out>dvpl.exe -h

dvpl_go 2.1.2 x64 | Copyright (c) 2026 Qirashi

Usage: dvpl [options]
[Options]:
  -c    Compress .dvpl files.
  -compress int
        Compression type: 0 (none), 1 (lz4hc), 2 (lz4) | (default 1)
  -d    Decompress .dvpl files.
  -filter string
        List of file patterns to include. ("*.sc2,*.scg")
  -forced-compress
        Force compression even if the result is larger than the original.
  -i string
        Input path. (file or directory)
  -ignore string
        List of file patterns to ignore. ("*.exe,*.dll")
  -ignore-compress string
        List of file patterns for which compression should be disabled. ("*.webp")
  -keep-original
        Keep original files.
  -m int
        Maximum number of parallel workers (12). Minimum 1, recommended 2 | (default 2)
  -o string
        Output path. (file or directory)
  -trust-data
        CRC and some checks are ignored.

Examples:
        Compress   : dvpl -c -i ./in_dir -compress 1
        Decompress : dvpl -d -i ./in_dir -o ./out_dir
        Filter     : dvpl -d -i ./in_dir -o ./out_dir -filter "*.sc2,*.scg"
        Ignore     : dvpl -c -i ./in_dir -ignore "*.exe,*.dll"

Описание команд

• -c — Сжатие в .dvpl.

• -d — Распаковка .dvpl.

• -i — Входная директория или файл.

• -o — Выходная директория или файл.

• -keep-original — Сохранять оригинальный файл при распаковке или сжатии.

• -compress — Указывает уровень сжатия от 0 до 2.

  • 0 — none
  • 1 — lz4hc
  • 2 — lz4

• -ignore — Список шаблонов файлов, которые стоит игнорировать. (Файлы и расширения не будут обработаны)

• -ignore-compress — Список шаблонов файлов, которые принудительно будут сжаты в 0 тип. (Например *.webp)

• -filter — Список файлов шаблонов, которые будут обработаны. (Только файлы и расширения, которые будут обработаны, обратный от -ignore)

  • Например вам нужно распаковать в отдельную папку только *.webp и *.txt.
  • Это будет выглядеть так: dvpl -d -i ./in -o ./out -filter "*.webp,*.txt" -keep-original -m 4

  Символы подстановки для фильтров:

  • * — любое количество символов (кроме /).
  • ? — один символ.
  • [abc] — один из указанных символов.

  Примеры:

  • *.exe — игнорировать все .exe файлы.
  • file?.log — игнорировать файлы вида file1.log, file2.log.
  • data[1-3].csv — игнорировать файлы data1.csv, data2.csv, data3.csv.
  • image_[xyz].png — игнорировать файлы image_x.png, image_y.png, image_z.png.

• -m - Максимальное количество параллельных обработчиков (workers).

  • По умолчанию: 2 (однопоточный режим)
  • Оптимальное значение: 2-4 (зависит от CPU)
  • При указании значений > максимума автоматически корректируется.
  • Максимальное кол-во зависит от ядер и потоков процессора.

• -trust-data - CRC и некоторые проверки игнорируются (Используется для ускорения распаковки при работе с большим количеством данных или при неудачной попытке распаковать файл).

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

Этот конвертер на GoLang с многопотоком (2 workers) (lz4hc)

Начало:   16:4:43.85
Конец:    16:5:2.78
-----------------
Всего:    0 ч 0 мин 18.93 сек

Вес: 1,15 ГБ (1 244 843 076 байт)

Другой конвертер на NodeJS (lz4hc)

Начало:   15:59:13.41
Конец:    16:0:10.19
-----------------
Всего:    0 ч 0 мин 56.78 сек

Вес: 1,15 ГБ (1 243 007 962 байт)

Другой конвертер на GoLang (lz4)

Начало:   16:18:37.28
Конец:    16:18:43.51
-----------------
Всего:    0 ч 0 мин 6.23 сек

Вес: 2,81 ГБ (3 020 488 406 байт)

Итоги

Данный конвертер является оптимальным вариантом сжатия и скорости. Он позволяет выбрать уровень сжатия, что сказывается на скорости. В режиме сжатия lz4hc он обгоняет свои аналоги по скорости и не уступает в качестве сжатия. Другой конвертер на Go использовал lz4, что сжимает хуже, но быстрее. Этот же конвертер работает быстро и поддерживает все основные доступные методы.