mirror of
https://github.com/NickoScope/nickol-knx-mcp.git
synced 2026-09-30 03:41:58 +02:00
Nikolay MiroshnichenkoandClaude Opus 4.8
2d0a63c548
A 96% structural match of an auto-designed GA structure vs a professional reference, from a 42-page spec alone — 662 GA, 0 validation errors, HA package. No client data/files; reference used only as an anonymous benchmark. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
55 lines
4.5 KiB
Markdown
55 lines
4.5 KiB
Markdown
# Кейс — из PDF-ТЗ в выверенную KNX-структуру на 662 GA, за минуты
|
|
|
|
> 🌍 **English version:** [case-study.md](case-study.md)
|
|
|
|
## Вопрос
|
|
Насколько далеко можно **из одного ТЗ** получить готовую, корректную по стандарту KNX-структуру
|
|
групповых адресов — и насколько близко к работе профессионала?
|
|
|
|
## Вход
|
|
Реальный жилой проект — **14 помещений (~155 м²)**, на оборудовании Zennio: коммутируемый и
|
|
диммируемый свет, электрический тёплый пол, вентиляция с рекуперацией, моторизованные шторы,
|
|
учёт воды / электро / тепла, протечки и пожарная безопасность — описан **только в 42-страничном
|
|
ТЗ (PDF)**. Ни группадресов, ни DPT, ни нейминга в ТЗ нет: там оборудование и функции, не KNX-структура.
|
|
|
|
## Конвейер
|
|
```
|
|
PDF-ТЗ
|
|
│ AI-ассистент, опираясь на стандарт KNX Association + мировую практику,
|
|
▼ ПРОЕКТИРУЕТ полную структуру групповых адресов
|
|
GA-структура (таксономия · нейминг · DPT · пары команда/статус · сцены · резервы)
|
|
│ nickol-knx-mcp ВАЛИДИРУЕТ её и ГЕНЕРИРУЕТ выходные файлы
|
|
▼
|
|
пакет Home Assistant + ETS-импортируемый XML групповых адресов
|
|
```
|
|
|
|
## Выход
|
|
- **662 групповых адреса** в **10 функциональных доменах**, как `ga-export/01` XML, готовый для ETS
|
|
*Import Group Addresses* → размещение устройств → экспорт `.knxproj`.
|
|
- Получено за **минуты**.
|
|
|
|
## Сверка — с профессиональной эталонной реализацией того же объекта
|
|
| Метрика | Результат |
|
|
|---|---|
|
|
| Структурное совпадение | **96 %** (662 против 687 GA) |
|
|
| Таксономия доменов | **10 из 10 совпали** |
|
|
| Имена адресов | **118 дословных**, 68 % с близким аналогом |
|
|
| DPT-дисциплина | точные под-типы у всех; DPT 5.001 ≈ 1 : 1 |
|
|
| Валидация (nickol-knx-mcp) | **0 ошибок**; шум (резервы/логика) распознан автоматически |
|
|
| Home Assistant | **9 климат-зон · 11 штор · 12 диммеров** + датчики, собраны сразу |
|
|
|
|
## Что это показывает
|
|
Стандартизованный и трудоёмкий **«скелет»** KNX-проекта — то, что определяется стандартом и
|
|
оборудованием — проектируется автоматически до **почти профессионального уровня за минуты против
|
|
дней** ручной работы с группадресами. Это освобождает время инженера для по-настоящему творческой
|
|
части — проектной логики, которая остаётся его ремеслом (оставшиеся проценты — ровно эти одноразовые
|
|
логические функции).
|
|
|
|
## Честные оговорки
|
|
- **Никакие клиентские данные и файлы проектов не публикуются.** Эталонная реализация используется
|
|
только как анонимный ориентир; в кейсе — параметры и проценты совпадения, ничего идентифицирующего.
|
|
- **Проектирование** выполняет AI-ассистент, заземлённый на знания KNX (стандарт KNX Association +
|
|
мировая практика). **Роль nickol-knx-mcp** — валидация только на чтение и экспорт в Home Assistant /
|
|
ETS; к живой шине он не подключается.
|
|
- Цифры — со структуры, которая реально прошла проверки инструмента (0 ошибок).
|