About epf-dump
epf-dump is a skill for unpacking 1C EPF/ERF files into source files. It requires a connected information base so reference types are preserved during the dump.
Key features
- 01Exports EPF/ERF contents to a directory
- 02Hierarchical or plain output format
- 03Supports file-based and server information bases
- 04Accepts platform path and additional launch arguments
Use cases
- 01Extracting source files from an EPF or ERF file
- 02Choosing an information base to preserve reference types
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/epf-dumpin Claude Code to confirm it loaded.
Bundled filesscripts/epf-dump.ps1scripts/epf-dump.py
Details
From the project README/epf-dump — Разборка обработки
Usage
/epf-dump <EpfFile> [OutDir]
| Параметр | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| EpfFile | да | — | Путь к EPF-файлу |
| OutDir | нет | src | Каталог для выгрузки исходников |
Параметры подключения (обязательно)
Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
- Прочитай
.v8-project.jsonиз корня проекта и разреши базу: - Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
default - Если
.v8-project.jsonнет или база не найдена — сообщи пользователю об ошибке. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через/db-list add.
Платформа — v8path найденной записи базы, иначе корневой v8path. Не задан ни там, ни там — -V8Path не передавай.
Если использованная база не зарегистрирована — после выполнения предложи добавить через /db-list add.
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы, или полный путь к 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Имя пользователя |
-Password <пароль> | нет | Пароль |
-InputFile <путь> | да | Путь к EPF/ERF-файлу |
-OutputDir <путь> | да | Каталог для выгрузки исходников |
-Format <формат> | нет | Hierarchical (по умолч.) / Plain |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
Примеры
# Разборка обработки (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"