Auto-build: codeassistant (python) from 8826a88

2026-07-22 12:41:02 +03:00 · 2026-07-20 17:20:59 +00:00
commit 54d9ff2a52
306 changed files with 149407 additions and 0 deletions
@@ -0,0 +1,132 @@
+---
+name: mxl-info
+description: Анализ структуры макета табличного документа (MXL) — области, параметры, наборы колонок. Используй при разработке печати — получить области и заполняемые параметры макета
+argument-hint: <TemplatePath> или <ProcessorName> <TemplateName>
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+---
+
+# /mxl-info — Анализ структуры макета
+
+Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок. Заменяет необходимость читать тысячи строк XML.
+
+## Использование
+
+```
+/mxl-info <TemplatePath>
+/mxl-info <ProcessorName> <TemplateName>
+```
+
+## Параметры
+
+| Параметр      | Обязательный | По умолчанию | Описание                                 |
+|---------------|:------------:|--------------|------------------------------------------|
+| TemplatePath  | нет          | —            | Прямой путь к Template.xml               |
+| ProcessorName | нет          | —            | Имя обработки (альтернатива пути)        |
+| TemplateName  | нет          | —            | Имя макета (альтернатива пути)           |
+| SrcDir        | нет          | `src`        | Каталог исходников                       |
+| Format        | нет          | `text`       | Формат вывода: `text` или `json`         |
+| WithText      | нет          | false        | Включить статический текст и шаблоны     |
+| MaxParams     | нет          | 10           | Макс. параметров в списке на область     |
+| Limit         | нет          | 150          | Макс. строк вывода (защита от переполнения) |
+| Offset        | нет          | 0            | Пропустить N строк (для пагинации)       |
+
+Укажите либо `-TemplatePath`, либо оба `-ProcessorName` и `-TemplateName`.
+
+## Команда
+
+```powershell
+python ".codeassistant/skills/mxl-info/scripts/mxl-info.py" -TemplatePath "<путь>"
+```
+
+Или по имени обработки/макета:
+```powershell
+python ".codeassistant/skills/mxl-info/scripts/mxl-info.py" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
+```
+
+Дополнительные флаги:
+```powershell
+... -WithText              # включить текстовое содержимое ячеек
+... -Format json           # JSON-вывод для программной обработки
+... -MaxParams 20          # показать больше параметров на область
+... -Offset 150            # пагинация: пропустить первые 150 строк
+```
+
+## Чтение вывода
+
+### Области — сортировка сверху вниз
+
+Области перечислены в порядке документа (по позиции строки), а не по алфавиту. Это соответствует порядку вывода областей в коде заполнения — сверху вниз.
+
+```
+--- Named areas ---
+  Заголовок          Rows     rows 1-4     (1 params)
+  Поставщик          Rows     rows 5-6     (1 params)
+  Строка             Rows     rows 14-14   (8 params)
+  Итого              Rows     rows 16-17   (1 params)
+```
+
+Типы областей:
+- **Rows** — горизонтальная область (диапазон строк). Получение: `Макет.ПолучитьОбласть("Имя")`
+- **Columns** — вертикальная область (диапазон колонок). Получение: `Макет.ПолучитьОбласть("Имя")`
+- **Rectangle** — фиксированная область (строки + колонки). Обычно использует отдельный набор колонок.
+- **Drawing** — именованный рисунок/штрихкод.
+
+### Пересечения
+
+Когда есть области и Rows, и Columns (этикетки, ценники), скрипт выводит пары пересечений:
+
+```
+--- Intersections (use with GetArea) ---
+  ВысотаЭтикетки|ШиринаЭтикетки
+```
+
+В BSL: `Макет.ПолучитьОбласть("ВысотаЭтикетки|ШиринаЭтикетки")`
+
+### Параметры и detailParameter
+
+Параметры перечислены по областям. Если у параметра есть `detailParameter` (расшифровка), он показан ниже:
+
+```
+--- Parameters by area ---
+  Поставщик: ПредставлениеПоставщика
+    detail: ПредставлениеПоставщика->Поставщик
+  Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
+    detail: Товар->Номенклатура
+```
+
+Это означает: параметр `Товар` отображает значение, а при клике открывает `Номенклатура` (объект расшифровки).
+
+### Параметры из шаблонов (суффикс `[tpl]`)
+
+Некоторые параметры встроены в шаблонный текст: `"Инв № [ИнвентарныйНомер]"`. Они заполняются через fillType=Template, а не fillType=Parameter. Скрипт всегда извлекает их и помечает суффиксом `[tpl]`:
+
+```
+  НумерацияЛистов: Номер [tpl], Дата [tpl], НомерЛиста [tpl]
+```
+
+В BSL шаблонные параметры заполняются так же, как обычные:
+```bsl
+Область.Параметры.Номер = НомерДокумента;
+Область.Параметры.Дата = ДатаДокумента;
+```
+
+Числовые подстановки вроде `[5]`, `[6]` (ссылки на сноски в официальных формах) игнорируются.
+
+### Текстовое содержимое (`-WithText`)
+
+Показывает статический текст (надписи, заголовки) и шаблонные строки с подстановками `[Параметр]`:
+
+```
+--- Text content ---
+  ШапкаТаблицы:
+    Text: "№", "Товар", "Ед. изм.", "Кол-во", "Цена", "Сумма"
+  Строка:
+    Templates: "Инв № [ИнвентарныйНомер]"
+```
+
+- **Text** — статические надписи (fillType=Text). Полезно для понимания назначения колонок.
+- **Templates** — текст с подстановками `[ИмяПараметра]` (fillType=Template). Параметр внутри `[]` заполняется программно.
+