| name | mxl-decompile |
| description | Декомпиляция табличного документа (MXL) в JSON-определение. Используй когда нужно получить редактируемое описание существующего макета |
| argument-hint | <TemplatePath> [OutputPath] |
| allowed-tools | ["Bash","Read","Write","Glob"] |
/mxl-decompile — Декомпилятор макета в DSL
Принимает Template.xml табличного документа 1С и генерирует компактное JSON-определение (DSL). Обратная операция к /mxl-compile.
Использование
/mxl-decompile <TemplatePath> [OutputPath]
Параметры
| Параметр | Обязательный | Описание |
|---|
| TemplatePath | да | Путь к Template.xml |
| OutputPath | нет | Путь для JSON (если не указан — stdout) |
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.ps1" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
Рабочий процесс
Декомпиляция существующего макета для анализа или доработки:
- Вызвать
/mxl-decompile для получения JSON из Template.xml
- Проанализировать или изменить JSON (добавить области, поменять стили)
- Вызвать
/mxl-compile для генерации нового Template.xml
- Вызвать
/mxl-validate для проверки
Формат JSON на выходе — тот же DSL, что принимает /mxl-compile; его описание живёт в навыке /mxl-compile.
Ключи, которых нет в описании DSL
В разобранном макете попадаются ключи, которых нет в инструкции /mxl-compile: например,
у rowStyle — модификатор apply, у ячейки-поля ввода — controlType: "none". Они несут
состояние исходного файла, которое иначе не выразить. Писать их самому не нужно; удалять
из разобранного JSON — тоже: компилятор принимает их обратно как есть, а без них макет
изменится.
Что нужно знать о пересборке
Правка через DSL — это полная перегенерация макета, а не точечное изменение XML. Поэтому
diff после цикла «декомпиляция → компиляция» обычно шире фактической доработки, даже когда
содержание сохранено целиком.
Побайтового совпадения с исходником ждать не всегда стоит. В макетах, которые долго правили
в Конфигураторе, остаются следы прежних состояний: например, формат ячейки несёт ширину
колонки, которая с тех пор изменилась. Из итогового документа такие значения не выводятся,
и в пересобранный файл они не возвращаются.
Не переживают цикл вовсе (в JSON не попадают, в XML не возвращаются):
- объединения, не привязанные к ячейке — по всей высоте или ширине документа;
- настройки диаграмм (
Chart, GanttChart) — сам рисунок сохраняется, его содержимое нет;
- область печати.
Если задача — сохранить чужой макет как есть и поправить в нём малое, сверяйте результат
/mxl-info или diff-ом: перечисленное выше нужно вернуть руками.
