mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-09-15 22:35:23 +03:00
Nick ShirokovandClaude Opus 4.6
544893b781
Bash on Windows strips backslashes in unquoted paths, causing "file not found" errors. Forward slashes work cross-platform. Also fix pwsh → powershell.exe in epf-init and epf-add-form. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
100 lines
4.6 KiB
Markdown
100 lines
4.6 KiB
Markdown
---
|
||
name: epf-dump
|
||
description: Разобрать EPF-файл обработки 1С (EPF/ERF) в XML-исходники
|
||
argument-hint: <EpfFile>
|
||
allowed-tools:
|
||
- Bash
|
||
- Read
|
||
- Glob
|
||
- Grep
|
||
---
|
||
|
||
# /epf-dump — Разборка обработки
|
||
|
||
Разбирает EPF-файл во XML-исходники с помощью платформы 1С (иерархический формат). Та же команда CLI работает и для внешних отчётов (ERF) — см. `/erf-dump`.
|
||
|
||
## Usage
|
||
|
||
```
|
||
/epf-dump <EpfFile> [OutDir]
|
||
```
|
||
|
||
| Параметр | Обязательный | По умолчанию | Описание |
|
||
|----------|:------------:|--------------|-------------------------------------|
|
||
| EpfFile | да | — | Путь к EPF-файлу |
|
||
| OutDir | нет | `src` | Каталог для выгрузки исходников |
|
||
|
||
## Параметры подключения
|
||
|
||
Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
|
||
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
|
||
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
|
||
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
|
||
4. Если ветка не совпала — используй `default`
|
||
5. Если `.v8-project.json` нет или баз нет — создай пустую ИБ в `./base`
|
||
Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1`
|
||
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
|
||
|
||
## Команда
|
||
|
||
```powershell
|
||
powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <параметры>
|
||
```
|
||
|
||
### Параметры скрипта
|
||
|
||
| Параметр | Обязательный | Описание |
|
||
|----------|:------------:|----------|
|
||
| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
|
||
| `-InfoBasePath <путь>` | * | Файловая база |
|
||
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
|
||
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
|
||
| `-UserName <имя>` | нет | Имя пользователя |
|
||
| `-Password <пароль>` | нет | Пароль |
|
||
| `-InputFile <путь>` | да | Путь к EPF/ERF-файлу |
|
||
| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
|
||
| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
|
||
|
||
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
|
||
|
||
## Коды возврата
|
||
|
||
| Код | Описание |
|
||
|-----|-----------------------------|
|
||
| 0 | Успешная разборка |
|
||
| 1 | Ошибка (см. лог) |
|
||
|
||
## Формат `-Format Hierarchical`
|
||
|
||
Ключ `-Format Hierarchical` создаёт структуру каталогов:
|
||
|
||
```
|
||
<OutDir>/
|
||
├── <Name>.xml # Корневой файл
|
||
└── <Name>/
|
||
├── Ext/
|
||
│ └── ObjectModule.bsl # Модуль объекта (если есть)
|
||
├── Forms/
|
||
│ ├── <FormName>.xml
|
||
│ └── <FormName>/
|
||
│ └── Ext/
|
||
│ ├── Form.xml
|
||
│ └── Form/
|
||
│ └── Module.bsl
|
||
└── Templates/
|
||
├── <TemplateName>.xml
|
||
└── <TemplateName>/
|
||
└── Ext/
|
||
└── Template.<ext>
|
||
```
|
||
|
||
## Примеры
|
||
|
||
```powershell
|
||
# Разборка обработки (файловая база)
|
||
powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МояОбработка.epf" -OutputDir "src"
|
||
|
||
# Серверная база
|
||
powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build\МояОбработка.epf" -OutputDir "src"
|
||
```
|