Skip to content
cccskills
FreePublished on GitHub

v8unpack

Распаковка и упаковка файлов 1С через v8unpack, включая отдельные Form.bin обычных форм, извлечение модуля и точечные правки описания формы. Использовать для работы с контейнером; полный цикл EPF/ERF вести через ordinary-form-workflow.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md5.7 KB
  • agents/openai.yaml156 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

v8unpack

Repo script: ./scripts/platform/v8unpack.sh

Выбор операции

Сначала определить установленную реализацию и версию: именем v8unpack называются разные инструменты. Приведённый ниже контракт проверен с Python-пакетом saby-integration/v8unpack 1.2.6. Проверить текущую обёртку и её --help; не переносить флаги между реализациями.

В репозитории, где есть scripts/platform/v8unpack.sh, использовать её:

ЗадачаДействие обёртки
Полностью разобрать CF/EPF/ERF в модель v8unpackextract
Собрать модель v8unpackbuild
Индексировать модельindex
Распаковать отдельный бинарный контейнер, например Form.bincontainer-extract
Собрать контейнер из его файловcontainer-build

extract/build и container-extract/container-build работают с разными представлениями. Не передавать сырой Form.bin на полный разбор метаданных, а Designer XML — на сборку модели v8unpack.

Если обёртки нет, найти принятый проектом entrypoint и проверить его контракт. Не считать проектную shell-команду универсальной установкой инструмента; при необходимости расширить ближайшую обёртку согласно AGENTS.md проекта.

Точечная работа с обычной формой

Работать в новом каталоге артефактов с копией входного файла. Пример из корня проекта (подставить подтверждённые пути):

bash scripts/platform/v8unpack.sh container-extract \
  --input "$form_bin" --output "$run_root/raw" --run-root "$run_root/extract"
# Изучить и отредактировать нужные файлы в raw.
bash scripts/platform/v8unpack.sh container-build \
  --input "$run_root/raw" --output "$run_root/Form.bin" --run-root "$run_root/build"
bash scripts/platform/v8unpack.sh container-extract \
  --input "$run_root/Form.bin" --output "$run_root/verified" --run-root "$run_root/verify"
  • Сначала инвентаризировать контейнер. В проверенных обычных формах есть 0/module (BSL) и 0/form (текст в формате скобок 1С); другой состав не отбрасывать и не заменять этим шаблоном.
  • Для правки логики менять только module, сохраняя кодировку, BOM и окончания строк. Анализатору при необходимости передать точную копию с расширением .bsl.
  • form — не XML управляемой формы. Для точечной замены сначала установить смысл узла и проверить единственность совпадения. Для изменения структуры использовать доступный декодер соответствующей версии и проверить обратное кодирование; не угадывать позиции, идентификаторы или связи элементов. Не обещать произвольное редактирование всех схем на основании одной успешной правки заголовка.
  • Не использовать преобразование в управляемую форму или analysis-only представление как промежуточный формат для обратной сборки обычной формы.
  • Сравнить набор относительных путей и байты каждого файла raw и verified. Проектный container-build уже делает такую проверку перед публикацией результата; подтвердить это по его текущей реализации. Отдельно проверить, что относительно исходной распаковки изменились только намеченные файлы.
  • SHA бинарного контейнера после упаковки может измениться при одинаковом содержимом. Это само по себе не повреждение и не доказательство совместимости с платформой.

Выдать путь результата и статус проверки контейнера. Загрузку формы Designer, сборку EPF/ERF и проверку поведения передать специализированному полному циклу.

Исходная документация: https://github.com/saby-integration/v8unpack/blob/main/docs/usage.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Проверяет синтаксис изменённых BSL-модулей одной командой: статический разбор BSL Analyzer и компиляция платформой 1С в целевой ИБ. Используйте для модулей основной конфигурации, расширений и внешних обработок/отчётов.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

Используйте, когда нужно создать информационную базу через канонический runtime contract проекта.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

Используйте, когда нужно сравнить source tree или выполнить adapter-aware diff через repo-owned entrypoint.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

Используйте, когда нужно проверить readiness runtime profile, adapter config и базовые зависимости проекта.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

Используйте, когда нужно выгрузить конфигурацию или расширение в исходники через канонический runtime contract проекта.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

Находит точную причину повторного падения процессов сервера 1С в Linux: SIGABRT, технологический журнал, core dump, GDB, C++-исключения и проверка причины. Используйте, когда rphost, ragent или rmngr исчезает, становится zombie, завершается сигналом 6 или оставляет core.

The English summary is being prepared. Showing the original description.

defin85/1c-runner-agnostic-template2Updated Oct 11, 2026

See all skills by defin85

Report a problem with this skill