{"slug":"v8unpack-cf","title":"v8unpack-cf","summary":"Распаковка и сборка бинарных файлов 1С (CF/CFE/EPF) через Python-утилиту v8unpack. Используй когда нужно распаковать конфигурацию, расширение или обработку в исходники, или собрать обратно.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-24T17:35:12.889412Z","repo":{"url":"https://github.com/Desko77/claude-code-skills-1c","stars":72,"forks":16,"license":"MIT","updatedAt":"2026-09-24T10:53:41Z"},"bodyHtml":"
\n

name: v8unpack-cf\ndescription: \"Распаковка и сборка бинарных файлов 1С (CF/CFE/EPF) через Python-утилиту v8unpack. Используй когда нужно распаковать конфигурацию, расширение или обработку в исходники, или собрать обратно.\"\nargument-hint: \"<-E|-B>

\n\n
\n

v8unpack-cf — распаковка и сборка бинарных файлов 1С

\n

Утилита saby v8unpack (Python) распаковывает CF/CFE/EPF файлы 1С в человекочитаемые исходники (JSON + BSL) с деревом метаданных — без платформы 1С.

\n

Установка: pip install v8unpack (или dev-install из репозитория).

\n

Команды

\n

Распаковка (-E)

\n
python -m v8unpack -E \"<файл.cf>\" \"<папка_исходников>\" --temp \"<папка_temp>\"\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПараметрОписание
<файл.cf>Путь к CF, CFE или EPF файлу
<папка_исходников>Куда распаковать (создаётся автоматически)
--temp <путь>Папка для промежуточных данных (не удаляется — для отладки)
--processes NКоличество потоков (по умолчанию cpu_count - 2)
--descent XYYZZZРежим версионирования расширений (суффикс версии конфигурации)
--auto_includeДинамическое оглавление из папки, а не из заголовка
--prefix STRПрефикс имён метаданных 1-го уровня
\n

Сборка (-B)

\n
python -m v8unpack -B \"<папка_исходников>\" \"<файл.cf>\"\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПараметрОписание
<папка_исходников>Папка с распакованными исходниками
<файл.cf>Путь к выходному CF/CFE/EPF файлу
--index <path>JSON-файл оглавления (маппинг файлов по папкам)
--version XYYZZВерсия режима совместимости (для расширений), напр. 80306 = 8.3.6
--descent XYYZZZСуффикс версии конфигурации
\n

Индексация (-I)

\n
python -m v8unpack -I \"<папка_исходников>\" --index index.json --core core\n
\n

Генерирует/обновляет index.json — файл оглавления для раскладки исходников по подпапкам.

\n

Пакетные операции (-EA, -BA, -IA)

\n
python -m v8unpack -EA products.json              # распаковать все продукты\npython -m v8unpack -BA products.json              # собрать все продукты\npython -m v8unpack -BA products.json --index KEY  # собрать конкретный продукт\n
\n

Файл products.json описывает несколько продуктов с индивидуальными параметрами сборки.

\n

Python API

\n
import v8unpack\n\nv8unpack.extract('d:/sample.cf', 'd:/src')\nv8unpack.extract('d:/sample.cf', 'd:/src', temp_dir='d:/temp',\n                 options={'descent': 4100200, 'auto_include': True})\n\nv8unpack.build('d:/src', 'd:/repacked.cf')\nv8unpack.build('d:/src', 'd:/repacked.cf', index='index.json',\n               options={'descent': 4100200, 'version': '80306'})\n
\n

Примеры использования

\n

Распаковать конфигурацию

\n
python -m v8unpack -E \"<project>/1Cv8.cf\" \"<project>/src\" --temp \"<project>/temp\"\n
\n

Собрать обратно

\n
python -m v8unpack -B \"<project>/src\" \"<project>/1Cv8_new.cf\"\n
\n

Распаковать внешнюю обработку

\n
python -m v8unpack -E \"МояОбработка.epf\" \"src_epf\"\n
\n

Распаковать расширение

\n
python -m v8unpack -E \"МоёРасширение.cfe\" \"src_cfe\" --descent 3000112\n
\n

Собрать расширение

\n
python -m v8unpack -B \"src_cfe\" \"bin/ext.cfe\" --index cmd/index.json --descent 3000112 --version 80316\n
\n

Совместимость версий

\n

Версия утилиты записывается в Configuration.json (\"v8unpack\": \"1.2.6\"). При сборке проверяется совпадение major.minor. Если версии не совпадают:

\n
    \n
  1. Собрать старой версией
    2. \n
  2. Обновить утилиту
    3. \n
  3. Распаковать новой версией
    4. \n
  4. Закоммитить
    5. \n
\n

Круговая сборка: проверяй, а не верь на слово

\n

Про версию 1.2.6 встречается утверждение, что при сборке (-B) она пишет в заголовок контейнера\nразмер блока 0x54 вместо 0x200, из-за чего результат приходится патчить.

\n

На 1.2.9 это не воспроизводится (проверено 14.08.2026 на реальной .epf 1.8 МБ): распаковка и\nобратная сборка проходят без ошибок, в заголовке и исходного, и пересобранного файла\npage_size = 0x200. Размер файлов при этом отличается - это нормально и само по себе о поломке не\nговорит.

\n

Отсюда правило: перед тем как городить патч заголовка, сделай круговую проверку на своей версии.

\n
python -m v8unpack -E исходный.epf ./src\npython -m v8unpack -B ./src пересобранный.epf\npython -c \"import struct;print([hex(struct.unpack('<IIII', open(p,'rb').read(16))[1]) for p in ('исходный.epf','пересобранный.epf')])\"\n
\n

Оба значения 0x200 - заголовок в порядке. Дальше проверяется главное: пересобранный файл должен\nоткрываться платформой и содержать те же модули.

\n

Промежуточные стадии (--temp)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
СтадияОписание
decode_stage_0/Извлечение из контейнера 1С
decode_stage_1/Декомпрессия (zlib), скобкофайлы
decode_stage_3/Разбор метаданных → дерево
Папка назначенияОрганизация кода (include, элементы форм)
\n

Ограничения

\n\n","files":[{"path":"evals/evals.json","sizeBytes":2839,"isText":true},{"path":"SKILL.md","sizeBytes":7489,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-28T19:24:55.040812Z","sha256":"036576B9157BE94721D53E70BCE93B8028309D4C2955F65849DDEA2D5E172F1D","sizeBytes":3846},"review":null,"source":{"repositoryUrl":"https://github.com/Desko77/claude-code-skills-1c","path":"skills/v8unpack-cf","license":"MIT","commit":"3accdd9a57aca1aabbe49a892a932df403ad5059","subtreeSha":"0413DCB48D560A7D95097710F9313A7F5C7E47A3AAFBA3F554422F5D47D66E10","lastSyncedAt":"2026-09-27T20:54:37.190964Z"},"reviewedAt":"2026-08-28T19:30:01.723811Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Desko77/claude-code-skills-1c/tree/main/skills/v8unpack-cf"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install desko77-claude-code-skills-1c@llmmart"},{"target":"git","command":"git clone https://github.com/Desko77/claude-code-skills-1c.git"}]}