From c8e92e61ef7b8f65be99e86a3c71665a73cb936a Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 15:55:32 +0300 Subject: [PATCH 01/14] docs: translate release policy --- .github/RELEASE_POLICY.md | 2 ++ .github/RELEASE_POLICY.ru.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 .github/RELEASE_POLICY.ru.md diff --git a/.github/RELEASE_POLICY.md b/.github/RELEASE_POLICY.md index 18974fc..d60d2a7 100644 --- a/.github/RELEASE_POLICY.md +++ b/.github/RELEASE_POLICY.md @@ -1,5 +1,7 @@ # 4FusionLab — automatic runtime release policy +[Русская версия](RELEASE_POLICY.ru.md) + ## Trigger - A direct push to `main` or a PR merge into `main` is the only normal release event. PR checks, manual CI dispatch and version-tag pushes **do not** initiate publication. diff --git a/.github/RELEASE_POLICY.ru.md b/.github/RELEASE_POLICY.ru.md new file mode 100644 index 0000000..6e2f444 --- /dev/null +++ b/.github/RELEASE_POLICY.ru.md @@ -0,0 +1,29 @@ +# 4FusionLab — политика автоматических релизов исполняемых компонентов + +[English](RELEASE_POLICY.md) + +## Запуск + +- Прямой push в `main` или объединение PR в `main` — единственное обычное событие релиза. Проверки PR, ручной запуск CI и отправка тегов версий **не** запускают публикацию. +- Перед публикацией сравнивайте `GITHUB_SHA` с последним **опубликованным** тегом GitHub Release, являющимся предком `main`. Если ZIP-релизов нет, используйте исходный диапазон push `github.event.before..GITHUB_SHA`. Удалённые и переименованные исполняемые файлы по-прежнему дают право на релиз. +- `.github/release-paths.txt` репозитория остаётся проверенным перечнем путей релиза. Изменения только README, руководств, тестов и CI **сами по себе не создают релиз**. Push только документации может восстановить ранее неудавшийся выпуск, если подходящие изменения после последнего опубликованного тега ещё не выпущены. +- Перед публикацией должны пройти все обязательные существующие проверки CI. При отказе проверки нет релиза, изменяемого тега и замены артефактов. + +## Версия и распространение + +- GitVersion.Tool **6.8.2** определяет числовую версию `MAJOR.MINOR.PATCH` по `GitVersion.yml` и полной истории Git. ZIP пакета, встроенный манифест Fusion (где применимо), автоматически созданный неизменяемый тег `vMAJOR.MINOR.PATCH` и GitHub Release соответствуют одному коммиту и версии. +- Конвейер создаёт тег **автоматически** при публикации GitHub Release. Участники никогда не создают и не отправляют теги релиза вручную. Существующий тег версии, указывающий на другой коммит, считается ошибкой; опубликованный релиз никогда не перезаписывается. +- При наличии используются проверенные заметки конкретной версии; иначе они автоматически создаются из истории Git. Подготовка файла заметок вручную только для выпуска изменения кода не требуется. +- Стабильные релизы становятся Latest. Предварительные выпуски никогда не становятся Latest. Проектные требования к нативной CAD-приёмке, тестам, подписанным архивам и контрольным суммам, совместимости ОС и публикации продолжают действовать. + +## Этот репозиторий + +Перечень исполняемых файлов: `Selectra/**`, `scripts/build.py`. Пакеты всех трёх ОС должны совпадать побайтово и содержать корректный манифест. + +Если после последнего опубликованного релиза не изменились подходящие входные исполняемые файлы, CI может запуститься, но публикация пропускается, даже если GitVersion вычислит другую версию. После сбоя следующая отправка в `main` повторяет публикацию после успешного прохождения обычных проверок CI; опубликованные теги и артефакты никогда не перезаписываются. + +## Общие Actions релизов + +GitVersion 6.8.2, определение влияния, заметки релиза и проверка ZIP/SHA-256 используют общие Actions, закреплённые за коммитом `ad9d60ba4aabc494b4f2c85d6c566a50ca423751` репозитория `4FusionLab/.github`. Сборка пакета, специальные проверки релиза и публикация остаются в этом репозитории. Устаревшие локальные `scripts/release_changes.py` и `scripts/release_notes.py` удалены только после переноса CI потребителя. + +**Платформа восстановления:** классификатор опубликованных релизов отдельно закреплён за `2e961620a068c3ad754f6e1be05fb6e4ac68e843` с `recover-unpublished: 'true'` и `github.token` только для чтения. Остальные общие Actions сохраняют проверенное закрепление `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`. From c10635f153db9a27a82389b0ef568f52165e4c75 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:12:22 +0300 Subject: [PATCH 02/14] docs: provide bilingual selection glossary --- GLOSSARY.md | 48 +++++++++++++++++++++++++----------------------- GLOSSARY.ru.md | 38 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 63 insertions(+), 23 deletions(-) create mode 100644 GLOSSARY.ru.md diff --git a/GLOSSARY.md b/GLOSSARY.md index 9db5c56..26290e7 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -1,36 +1,38 @@ # Selectra -Язык выбора похожих рёбер и граней по примерам в явно заданной области сборки. +[Русская версия](GLOSSARY.ru.md) -**Область поиска**: -Тело, иерархия выбранного экземпляра компонента или вся видимая сборка. Каноническая семантика This Body / This Component / All Components — в [UX.md](docs/UX.md). +The language of selecting similar edges and faces by example within an explicitly defined assembly scope. -## Термины +**Search scope**: +The body, the selected component instance's hierarchy, or the entire visible assembly. The canonical semantics of This Body / This Component / All Components are in [UX.md](docs/UX.md). -**Пример**: -Ребро или грань, которые пользователь явно показал как часть желаемого выбора. Найденный инструментом элемент сам по себе примером не становится. +## Terms -**Исключение**: -Элемент, который пользователь явно указал как нежелательный. Он задаёт ограничение результата и помогает различать возможные намерения. +**Example**: +An edge or face explicitly shown by the user as part of the desired selection. An element found by the tool does not itself become an example. -**Намерение**: -Предположение о том, какое свойство или геометрическую связь пользователь считает основанием сходства. -_Избегать_: уверенность пользователя, истинное намерение +**Exclusion**: +An element the user explicitly marked as unwanted. It constrains the result and helps distinguish possible intents. -**Аналог формы**: -Элемент с соответствующей формой и размером, допускающий перенос, поворот или отражение в пределах заданного допуска. Равный периметр сам по себе не делает элементы аналогами формы. +**Intent**: +A hypothesis about which property or geometric relationship the user regards as the basis for similarity. +_Avoid_: user confidence, true intent -**Пара стенки**: -Две грани на противоположных сторонах одной локальной стенки тела. Простая параллельность или близость ещё не доказывает эту связь. +**Shape analogue**: +An element with matching shape and size, allowing translation, rotation or reflection within the specified tolerance. Equal perimeter alone does not make elements shape analogues. -**Повтор элемента**: -Несколько участков геометрии с общей структурой и размером, расположенных по повторяющемуся преобразованию. +**Wall pair**: +Two faces on opposite sides of one local wall of a body. Parallelism or proximity alone does not establish this relationship. -**Уровень похожести**: -Группа одинаково обоснованных кандидатов в зафиксированном порядке расширения выбора. Уровень не означает число переходов по соседним граням. +**Feature repetition**: +Several portions of geometry with a common structure and size, positioned by a repeated transformation. -**Диапазон выбора**: -Примеры и все включённые уровни похожести за вычетом исключений. +**Similarity level**: +A group of equally justified candidates in a fixed selection-expansion order. A level does not mean a number of transitions between adjacent faces. -**Объяснение выбора**: -Короткое проверяемое основание включения элемента: например, такая же форма или внутренняя сторона стенки примера. +**Selection range**: +The examples and all included similarity levels, minus exclusions. + +**Selection explanation**: +A short, verifiable reason for including an element, such as the same shape or the inner side of the example wall. diff --git a/GLOSSARY.ru.md b/GLOSSARY.ru.md new file mode 100644 index 0000000..e824691 --- /dev/null +++ b/GLOSSARY.ru.md @@ -0,0 +1,38 @@ +# Selectra + +[English](GLOSSARY.md) + +Язык выбора похожих рёбер и граней по примерам в явно заданной области сборки. + +**Область поиска**: +Тело, иерархия выбранного экземпляра компонента или вся видимая сборка. Каноническая семантика This Body / This Component / All Components — в [UX.md](docs/UX.md). + +## Термины + +**Пример**: +Ребро или грань, которые пользователь явно показал как часть желаемого выбора. Найденный инструментом элемент сам по себе примером не становится. + +**Исключение**: +Элемент, который пользователь явно указал как нежелательный. Он задаёт ограничение результата и помогает различать возможные намерения. + +**Намерение**: +Предположение о том, какое свойство или геометрическую связь пользователь считает основанием сходства. +_Избегать_: уверенность пользователя, истинное намерение + +**Аналог формы**: +Элемент с соответствующей формой и размером, допускающий перенос, поворот или отражение в пределах заданного допуска. Равный периметр сам по себе не делает элементы аналогами формы. + +**Пара стенки**: +Две грани на противоположных сторонах одной локальной стенки тела. Простая параллельность или близость ещё не доказывает эту связь. + +**Повтор элемента**: +Несколько участков геометрии с общей структурой и размером, расположенных по повторяющемуся преобразованию. + +**Уровень похожести**: +Группа одинаково обоснованных кандидатов в зафиксированном порядке расширения выбора. Уровень не означает число переходов по соседним граням. + +**Диапазон выбора**: +Примеры и все включённые уровни похожести за вычетом исключений. + +**Объяснение выбора**: +Короткое проверяемое основание включения элемента: например, такая же форма или внутренняя сторона стенки примера. From 9cf45acc9db0fccd69e2d53739a2f19abc6cfc7e Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:19:20 +0300 Subject: [PATCH 03/14] docs: provide bilingual changelog --- CHANGELOG.md | 30 ++++++++++++++++-------------- CHANGELOG.ru.md | 24 ++++++++++++++++++++++++ 2 files changed, 40 insertions(+), 14 deletions(-) create mode 100644 CHANGELOG.ru.md diff --git a/CHANGELOG.md b/CHANGELOG.md index e723ea6..df566fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,22 +1,24 @@ -# История изменений +# Changelog + +[Русская версия](CHANGELOG.ru.md) ## 1.0.1 — 2026-10-28 -- **Select Chain** находит замкнутые полосы из смежных граней одного тела с двумя простыми границами. Узкий обод получает приоритет, в том числе при переходах по наклонным граням. -- При смене исходного примера каталог перестраивается; прежние варианты контуров сохраняются. Перебор ограничен бюджетом. -- В Fusion на macOS проверены предпросмотр, переключение вариантов и применение обода из четырёх граней на отдельной копии модели. 185 Python-тестов; нативная CAD-приёмка на Windows не проводилась. +- **Select Chain** finds closed strips of adjacent faces of one body with two simple boundaries. A narrow rim takes priority, including transitions along inclined faces. +- When the starting example changes, the catalog is rebuilt; previous contour options are retained. Enumeration is budget-limited. +- Preview, option switching, and application of a four-face rim were tested in Fusion on macOS on a separate copy of a model. 185 Python tests; native CAD acceptance on Windows was not performed. ## 1.0.0 — 2026-10-26 -Первый стабильный выпуск Selectra для Autodesk Fusion. +The first stable release of Selectra for Autodesk Fusion. -- **Select Similar**: похожие BRep-рёбра, грани и связанные группы по одному или нескольким примерам; уточнения Examples, Exclude и Match. -- Приоритет формы и размера, затем положение: плоскости примеров, параллельные, остальные. -- **Search Scope**: This Body, This Component (по умолчанию, включая вложенную иерархию), All Components. -- **Select Chain**: отдельные замкнутые контуры рёбер и обходы стенок. Каждый вариант проходит через все примеры и заменяет предыдущий. -- Границы плавных групп и их промежуточных связных частей; исходные контуры Split Body сохраняются. -- **Chain across contact**, включённая по умолчанию: переход через полный точный контакт граней без изменения исходных тел. Зазоры, частичное касание и объёмные пересечения не соединяются. -- **PgUp/PgDown** и **=/-**, нативный ползунок, Magenta-подсветка до OK и восстановление исходного выбора по Cancel. -- Русская и английская документация, демонстрационные снимки, воспроизводимый ZIP и SHA-256; сборка и публикация стабильных релизов по тегу через GitHub Actions. +- **Select Similar**: similar BRep edges, faces, and connected groups from one or more examples, refined using Examples, Exclude, and Match. +- Shape and size take priority, then position: example planes, parallel planes, then others. +- **Search Scope**: This Body, This Component (default, including nested hierarchy), All Components. +- **Select Chain**: separate closed edge contours and wall chains. Each option passes through every example and replaces the previous one. +- Boundaries of smooth groups and their intermediate connected parts; original Split Body contours are preserved. +- **Chain across contact**, on by default: transition across full exact face contact without changing source bodies. Gaps, partial contact, and volume intersections are not connected. +- **PgUp/PgDown** and **=/-**, native slider, Magenta preview before OK, and restoration of the original selection on Cancel. +- English and Russian documentation, demonstration images, reproducible ZIP and SHA-256; stable releases were built and published by tag via GitHub Actions. -Проверки: 182 Python-теста; сборка и CI на macOS, Windows и Ubuntu. Нативные CAD-сценарии проверены в Fusion на macOS; нативная Windows-приёмка отдельно не выполнена. Подробнее — [протокол](docs/VALIDATION.md). +Validation: 182 Python tests; build and CI on macOS, Windows, and Ubuntu. Native CAD scenarios were checked in Fusion on macOS; native Windows acceptance was not separately performed. See the [validation report](docs/VALIDATION.md). diff --git a/CHANGELOG.ru.md b/CHANGELOG.ru.md new file mode 100644 index 0000000..12a44c1 --- /dev/null +++ b/CHANGELOG.ru.md @@ -0,0 +1,24 @@ +# История изменений + +[English](CHANGELOG.md) + +## 1.0.1 — 2026-10-28 + +- **Select Chain** находит замкнутые полосы из смежных граней одного тела с двумя простыми границами. Узкий обод получает приоритет, в том числе при переходах по наклонным граням. +- При смене исходного примера каталог перестраивается; прежние варианты контуров сохраняются. Перебор ограничен бюджетом. +- В Fusion на macOS проверены предпросмотр, переключение вариантов и применение обода из четырёх граней на отдельной копии модели. 185 Python-тестов; нативная CAD-приёмка на Windows не проводилась. + +## 1.0.0 — 2026-10-26 + +Первый стабильный выпуск Selectra для Autodesk Fusion. + +- **Select Similar**: похожие BRep-рёбра, грани и связанные группы по одному или нескольким примерам; уточнения Examples, Exclude и Match. +- Приоритет формы и размера, затем положение: плоскости примеров, параллельные, остальные. +- **Search Scope**: This Body, This Component (по умолчанию, включая вложенную иерархию), All Components. +- **Select Chain**: отдельные замкнутые контуры рёбер и обходы стенок. Каждый вариант проходит через все примеры и заменяет предыдущий. +- Границы плавных групп и их промежуточных связных частей; исходные контуры Split Body сохраняются. +- **Chain across contact**, включённая по умолчанию: переход через полный точный контакт граней без изменения исходных тел. Зазоры, частичное касание и объёмные пересечения не соединяются. +- **PgUp/PgDown** и **=/-**, нативный ползунок, Magenta-подсветка до OK и восстановление исходного выбора по Cancel. +- Русская и английская документация, демонстрационные снимки, воспроизводимый ZIP и SHA-256; сборка и публикация стабильных релизов по тегу через GitHub Actions. + +Проверки: 182 Python-теста; сборка и CI на macOS, Windows и Ubuntu. Нативные CAD-сценарии проверены в Fusion на macOS; нативная Windows-приёмка отдельно не выполнена. Подробнее — [протокол](docs/VALIDATION.md). From 4f839a3a5799cc95451c39b5da652913173562a6 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:20:17 +0300 Subject: [PATCH 04/14] docs: provide bilingual offline benchmarks --- docs/BENCHMARKS.md | 18 ++++++++++-------- docs/BENCHMARKS.ru.md | 21 +++++++++++++++++++++ 2 files changed, 31 insertions(+), 8 deletions(-) create mode 100644 docs/BENCHMARKS.ru.md diff --git a/docs/BENCHMARKS.md b/docs/BENCHMARKS.md index 6c5ef5c..99b4375 100644 --- a/docs/BENCHMARKS.md +++ b/docs/BENCHMARKS.md @@ -1,19 +1,21 @@ -# Офлайн-замеры ядра +# Offline kernel benchmarks -25.10.2026, Python 3.14.5, macOS 27.0.1 ARM64. Три повтора; в таблице медиана. Данные синтетические: числовые дескрипторы прямых рёбер с пятью длинами и двумя направлениями. +[Русская версия](BENCHMARKS.ru.md) -| Кандидаты + пример | Отдельные гипотезы, мс | Общее ранжирование, мс | Пара шагов диапазона, мс | +25 October 2026, Python 3.14.5, macOS 27.0.1 ARM64. Three repetitions; the table reports the median. Data are synthetic: numeric descriptors for straight edges with five lengths and two directions. + +| Candidates + example | Separate hypotheses, ms | Shared ranking, ms | Pair of range steps, ms | | --- | ---: | ---: | ---: | | 100 + 1 | 0.352 | 0.379 | 0.018 | -| 1 000 + 1 | 3.295 | 3.609 | 0.021 | -| 10 000 + 1 | 32.475 | 36.609 | 0.029 | +| 1,000 + 1 | 3.295 | 3.609 | 0.021 | +| 10,000 + 1 | 32.475 | 36.609 | 0.029 | -Это не задержки Fusion. В замер не входят чтение BRep, построение CustomGraphics, обработка клавиатуры приложением или перерисовка viewport. Пара шагов измеряет изменение диапазона на уже готовом ранжировании, без нового извлечения признаков. +These are not Fusion latencies. The measurement excludes BRep reading, CustomGraphics construction, application keyboard handling, and viewport redraw. The pair of steps measures range changes on an already prepared ranking, without extracting features again. -Повторить: +To reproduce: ```sh python scripts/benchmark_offline.py --repeats 3 ``` -В живой контрольной сессии `tests/fusion_read_contract.py` проверил 97 рёбер и 39 граней с восемью примерами каждого типа примерно за 0.03 секунды. Это ограниченный read-only контракт на одной модели, не общий CAD-бенчмарк. +In a live control session, `tests/fusion_read_contract.py` checked 97 edges and 39 faces with eight examples of each type in approximately 0.03 seconds. This is a limited read-only contract on one model, not a general CAD benchmark. diff --git a/docs/BENCHMARKS.ru.md b/docs/BENCHMARKS.ru.md new file mode 100644 index 0000000..6a4f39f --- /dev/null +++ b/docs/BENCHMARKS.ru.md @@ -0,0 +1,21 @@ +# Офлайн-замеры ядра + +[English](BENCHMARKS.md) + +25.10.2026, Python 3.14.5, macOS 27.0.1 ARM64. Три повтора; в таблице медиана. Данные синтетические: числовые дескрипторы прямых рёбер с пятью длинами и двумя направлениями. + +| Кандидаты + пример | Отдельные гипотезы, мс | Общее ранжирование, мс | Пара шагов диапазона, мс | +| --- | ---: | ---: | ---: | +| 100 + 1 | 0.352 | 0.379 | 0.018 | +| 1 000 + 1 | 3.295 | 3.609 | 0.021 | +| 10 000 + 1 | 32.475 | 36.609 | 0.029 | + +Это не задержки Fusion. В замер не входят чтение BRep, построение CustomGraphics, обработка клавиатуры приложением или перерисовка viewport. Пара шагов измеряет изменение диапазона на уже готовом ранжировании, без нового извлечения признаков. + +Повторить: + +```sh +python scripts/benchmark_offline.py --repeats 3 +``` + +В живой контрольной сессии `tests/fusion_read_contract.py` проверил 97 рёбер и 39 граней с восемью примерами каждого типа примерно за 0.03 секунды. Это ограниченный read-only контракт на одной модели, не общий CAD-бенчмарк. From 68f04f51861aa4fa578b6ae639433589e4761ccc Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:21:42 +0300 Subject: [PATCH 05/14] docs: provide bilingual product specification --- docs/PRODUCT.md | 94 +++++++++++++++++++++++----------------------- docs/PRODUCT.ru.md | 75 ++++++++++++++++++++++++++++++++++++ 2 files changed, 123 insertions(+), 46 deletions(-) create mode 100644 docs/PRODUCT.ru.md diff --git a/docs/PRODUCT.md b/docs/PRODUCT.md index 52ee8be..e6c14a6 100644 --- a/docs/PRODUCT.md +++ b/docs/PRODUCT.md @@ -1,73 +1,75 @@ -# Selectra: выбор по примерам +# Selectra: selection by example -## Задача +[Русская версия](PRODUCT.ru.md) -Пользователь показывает, что считает похожим, а Selectra предлагает выделение. Основной вход — `Select Similar` в меню правой кнопки. Отдельный `Select Chain` находит замкнутые петли рёбер и обходы стенок. Пользователь не должен начинать с выбора технической метрики. +## Problem -**Область поиска уточнена пользователем 25.10.2026:** This Body, This Component (по умолчанию), All Components. This Component включает вложенную иерархию выбранного экземпляра; All Components — всю видимую сборку. Примеры и исключения лежат в выбранной области. Область не расширяется неявно; её переключение видно в диалоге. Каноническая семантика — [UX.md](UX.md). +The user shows what they consider similar, and Selectra proposes a selection. The main entry point is `Select Similar` in the right-click menu. A separate `Select Chain` finds closed edge loops and wall chains. The user should not have to begin by choosing a technical metric. -Актуальный сценарий и элементы интерфейса: [UX.md](UX.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. +**Search scope clarified by the user on 25 October 2026:** This Body, This Component (default), All Components. This Component includes the selected instance's nested hierarchy; All Components includes the entire visible assembly. Examples and exclusions lie within the selected scope. Scope is not expanded implicitly; switching it is visible in the dialog. Canonical semantics: [UX.md](UX.md). -## Основной сценарий +For the current workflow and controls see [UX.md](UX.md). For the target intent-inference model see [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown control ranked similarity; graph adjacency remains a separate operation. -1. Выбрать одно или несколько рёбер либо граней одного тела. -2. ПКМ → `Select Similar`. Геометрия считывается после запуска команды, а не на каждом открытии меню. -3. Сразу увидеть лучший предложенный набор и число элементов. Примеры остаются в наборе. При неоднозначности — короткое объяснение. -4. Нажать `OK`; получить обычное выделение Fusion и продолжить работу, например запустить Fillet. `Cancel` восстанавливает исходный выбор при неизменном контексте. -5. Если результат не тот, уточнить примером или исключением. В нативном диалоге есть Examples и Exclude; уточнение пересчитывает ранжирование и сбрасывает ручной диапазон. +## Main workflow -В основной части — ползунок Similarity, который управляет тем же диапазоном, что и PgUp/PgDown. `Refine` свёрнут: необязательный Match и Reset Range. По умолчанию используется автоматическое ранжирование с размерным допуском 1% и угловым допуском 2°. Числовая дистанция не выводится как вероятность намерения. +1. Select one or more edges or faces from one body. +2. Right-click → `Select Similar`. Geometry is read after starting the command, not every time the menu opens. +3. Immediately see the best proposed set and its count. Examples remain in the set. If ambiguous, show a brief explanation. +4. Press `OK` to obtain an ordinary Fusion selection and continue working, for example by starting Fillet. `Cancel` restores the original selection if the context is unchanged. +5. If the result is wrong, refine it with an example or exclusion. The native dialog has Examples and Exclude; refinement recalculates ranking and resets the manual range. -## Как выводится намерение +The main area contains the Similarity slider, which controls the same range as PgUp/PgDown. `Refine` is collapsed and contains optional Match and Reset Range. Automatic ranking defaults to a 1% dimensional and 2° angular tolerance. Numeric distance is not presented as an intent probability. -Все сущности выбранного типа исходного тела получают непрерывную геометрическую оценку сходства. Общие признаки примеров определяют веса, различающиеся признаки перестают быть обязательными. Наборы с одинаковой оценкой включаются целиком. Исходное ядро отдельных гипотез сохранено для объяснений и сравнения; основное управление диапазоном использует общее ранжирование, а не переключение разрозненных наборов. +## How intent is inferred -Примеры: +All entities of the selected type in the source body receive a continuous geometric similarity score. Shared example features determine weights; features that differ cease to be mandatory. Sets with equal scores are included as a whole. The original separate-hypothesis kernel is retained for explanations and comparison; main range control uses a shared ranking rather than switching disconnected sets. -- Два прямых ребра разной длины, но одного направления → признак длины исключается, остаются параллельные рёбра. -- Два ребра одной длины с разным направлением → направление перестаёт ограничивать набор. -- Две цилиндрические грани одного радиуса с разными площадями → искать такой же радиус, не одинаковую площадь. -- Две несвязанные плоские грани разных размеров с полными контурами → искать объединение подтверждённых аналогов каждого примера; общая нормаль не заменяет форму. +Examples: -Направление прямого ребра — ось: разворот параметризации на 180° ничего не меняет. В Automatic сравнивается ось нормали плоскости; явный Orientation использует направленный вектор и различает противоположные стороны. У кривой поверхности одна произвольная нормаль не описывает направление целиком. +- Two straight edges of different lengths but the same direction → length is excluded as a feature, leaving parallel edges. +- Two edges of the same length with different directions → direction no longer restricts the set. +- Two cylindrical faces with the same radius and different areas → find the same radius, not the same area. +- Two disconnected planar faces of different sizes with complete contours → find the union of verified analogues of each example; a shared normal does not replace shape. -Если примеры не имеют устойчивого общего признака, инструмент сообщает об этом. Он не должен незаметно выбирать всё тело. Для несвязанных плоских примеров с полными контурами поддержано объединение проверенных семейств формы и размера. Связанные примеры по-прежнему могут задавать повтор узла, а пара сторон — семейство стенок. Связанные группы с цилиндрическими и NURBS-гранями дополнительно проверяются по триангуляции поверхности и общему расположению. Для остальных типов геометрии используются доступные общие признаки. +A straight edge's direction is an axis: reversing its parameterization by 180° changes nothing. Automatic compares the axis of a planar normal; explicit Orientation uses a directed vector and distinguishes opposite sides. A single arbitrary normal does not describe the complete direction of a curved surface. -## Каталог сценариев +If examples have no stable common feature, the tool reports this. It must not silently select the entire body. For disconnected planar examples with complete contours, the union of verified shape-and-size families is supported. Connected examples can still describe a repeated feature, while opposite sides can describe a wall family. Connected groups with cylindrical and NURBS faces are additionally checked by surface triangulation and relative arrangement. Other geometry types use available shared features. -| Пример | Ожидаемый смысл | Признаки и неоднозначности | Этап | +## Scenario catalog + +| Example | Intended meaning | Features and ambiguity | Stage | | --- | --- | --- | --- | -| Прямое ребро | Такие же по длине; параллельные; оба условия | Длина и ось. Второй пример различает намерение | Ядро spike | -| Круговая кромка | Кромки такого же радиуса | Тип кривой + радиус; полный круг и дуга различаются | Ядро spike | -| Дуга | Такой же радиус или радиус и длина | Не называть любой круг отверстием | Ядро spike | -| Плоская грань | Такие же размеры/граница или ориентация | Площадь, периметр, число рёбер/петель, нормаль; не доказательство конгруэнтности | Ядро spike | -| Цилиндрическая грань | Такой же радиус, иногда и площадь | Отверстие и наружный вал пока не различаются | Ядро spike | -| Сквозное или глухое отверстие | Все отверстия такого же диаметра/типа | Внутренняя ориентация, ось, петли, дно, соседство | Семантика после CAD-spike | -| Скругление | Все скругления такого же радиуса | Цилиндр/тор/свободная поверхность, соседние грани, выпуклость | После базового MVP | -| Фаска | Все фаски такой же ширины/угла | Геометрия и соседство; одной площади мало | После базового MVP | -| Цепочка рёбер | Касательно связанные или одинаковые цепочки | Граф соседства; отличать от штатной Tangent Chain | После базового MVP | -| Карман/бобышка | Похожие группы граней | Топологический регион вместо отдельных граней | Отдельный этап | -| Импорт STEP | Повторяющиеся элементы без истории | Геометрия и топология; история Hole/Pattern необязательна | CAD-корпус MVP | -| Свободная поверхность | Повторяющиеся участки формы | Выборки кривизны, ориентации и границы; площадь лишь грубый фильтр | Исследование | +| Straight edge | Same length; parallel; or both | Length and axis. A second example distinguishes intent | Kernel spike | +| Circular edge | Edges of the same radius | Curve type + radius; distinguish a full circle and an arc | Kernel spike | +| Arc | Same radius, or radius and length | Do not call every circle a hole | Kernel spike | +| Planar face | Same dimensions/boundary or orientation | Area, perimeter, edge/loop counts, normal; not proof of congruence | Kernel spike | +| Cylindrical face | Same radius, sometimes area | Holes and external shafts are not yet distinguished | Kernel spike | +| Through or blind hole | All holes of the same diameter/type | Internal orientation, axis, loops, bottom, adjacency | Semantics after CAD spike | +| Fillet | All fillets of the same radius | Cylinder/torus/freeform, neighboring faces, convexity | After basic MVP | +| Chamfer | All chamfers of the same width/angle | Geometry and adjacency; area alone is insufficient | After basic MVP | +| Edge chain | Tangentially connected or equivalent chains | Adjacency graph; distinguish from native Tangent Chain | After basic MVP | +| Pocket/boss | Similar face groups | Topological region rather than individual faces | Separate stage | +| STEP import | Repeated features without history | Geometry and topology; Hole/Pattern history is optional | MVP CAD corpus | +| Freeform surface | Repeated shape regions | Curvature, orientation and boundary sampling; area is only a coarse filter | Research | -Mesh, T-Spline и эскизные сущности не входят в начальный BRep MVP. Для связанных групп кривых BRep-поверхностей поддержана дискретная проверка формы под одной общей трансформацией. Для одиночной кривой грани остаются простые числовые сравнения; точное аналитическое распознавание произвольных NURBS не заявляется. +Mesh, T-Spline, and sketch entities are outside the initial BRep MVP. For connected groups of curved BRep faces, a discrete shape check under one shared transformation is supported. Individual curved faces retain simple numerical comparisons; exact analytical recognition of arbitrary NURBS is not claimed. -## Инженерные решения из опыта Perfora +## Engineering decisions informed by Perfora -Ядро получает только неизменяемые снимки; перестановка примеров не меняет результат. Fusion adapter сохраняет исходный контекст. Никакие атрибуты не записываются на рёбра и грани. Модель не перестраивается, временные CAD-тела не создаются. +The kernel receives immutable snapshots only; reordering examples does not change the result. The Fusion adapter preserves the original context. No attributes are written to edges or faces. The model is not rebuilt and temporary CAD bodies are not created. -Сначала дешёвые аналитические признаки. Уточнение топологии и кривизны добавляется только там, где снижает ложные совпадения. Лимиты прототипа: до 10 000 сущностей тела и мягкий бюджет чтения 2 секунды. Проверка бюджета между API-вызовами не может прервать один долгий вызов; это защита от продолжения обхода, не гарантия задержки интерфейса. Массовая подсветка требует отдельного измерения. +Use inexpensive analytical features first. Add topology and curvature refinement only where it reduces false matches. Prototype limits: up to 10,000 body entities and a soft two-second reading budget. Checking the budget between API calls cannot interrupt one long call; it prevents traversal from continuing, but does not guarantee UI latency. Large-scale highlighting needs separate measurement. -Первую модель намерения реализуем локально и детерминированно. LLM для сравнения BRep не нужен. Адаптацию к привычкам пользователя можно исследовать позже на основе явных исправлений, не подменяя ей геометрические проверки. +Implement the first intent model locally and deterministically. An LLM is not needed to compare BRep. Adaptation to user habits may be studied later using explicit corrections, without substituting it for geometric checks. -## Замкнутые цепочки +## Closed chains -Select Chain отделяет топологическую операцию от сходства. Один или несколько примеров запускают поиск ближайшего замкнутого контура через них; Chain across contact по умолчанию допускает переход через полный точный стык тел, а PgUp/PgDown и =/- переключают отдельные варианты контуров, заменяя предыдущий. Рёбра и грани имеют отдельную семантику, описанную в UX. Тела, геометрия и таймлайн не меняются. +Select Chain separates topology from similarity. One or more examples start a search for the nearest closed contour passing through them. Chain across contact is enabled by default and permits transitions across a full exact body contact. PgUp/PgDown and =/- switch individual contour options, replacing the previous one. Edges and faces have separate semantics described in UX. Bodies, geometry and the timeline do not change. -Уточнение Select Chain: каждый контур на каждом уровне проходит через все выбранные примеры. PgUp/PgDown и =/- переключают допустимые обходы через них без накопления. Поиск соседних отверстий, удалённых контуров или графовое расширение в Select Chain не входят. Плоскость влияет только на порядок уже допустимых контуров. +Select Chain clarification: every contour at every level passes through all selected examples. PgUp/PgDown and =/- switch valid traversals through them without accumulation. Searching neighboring holes, remote contours, or graph expansion are not part of Select Chain. Plane affects only the ordering of already valid contours. -Сквозной поиск сохраняет исходные контуры отдельных тел и добавляет контуры через точный стык. Временное удаление шва при Boolean Union не означает, что контуры по исходной линии разреза исчезают из выбора. Это относится и к рёбрам, и к цепочкам стенок. +Cross-contact search preserves original contours of individual bodies and adds contours across exact contact. Temporary seam removal during Boolean Union does not mean contours along the original split line disappear from the selection. This applies to edges and wall chains alike. -Для рёбер каталог включает также границы промежуточных связных частей плавного участка. Внутренний шов полного участка может оставаться границей его части и входить в искомый контур. Эти дополнительные варианты следуют после прежних контуров в том же классе плоскости; каждый всё равно обязан содержать все примеры. Перебор ограничен бюджетом топологии и времени, превышение явно отменяет результат. +For edges, the catalog also includes boundaries of intermediate connected parts of a smooth region. An interior seam of the complete region can remain a boundary of one of its parts and belong to a requested contour. These additional options follow earlier contours in the same plane class; each must still contain every example. Enumeration is bounded by topology and time budgets; exceeding a budget explicitly cancels the result. -Для граней дополнительно распознаются замкнутые полосы одного тела с двумя простыми границами и циклом поперечных стыков. Узкая полоса имеет приоритет; ширина относительно длины границы — эвристика порядка, не доказательство намерения. Ранее доступные обходы остаются вариантами. Полосы через стык нескольких тел этой проверкой пока не строятся. +For faces, closed strips of one body with two simple boundaries and a cycle of cross seams are also recognized. A narrow strip takes priority; width relative to boundary length is an ordering heuristic, not proof of intent. Previously available traversals remain options. This check does not yet construct strips across the contact of multiple bodies. diff --git a/docs/PRODUCT.ru.md b/docs/PRODUCT.ru.md new file mode 100644 index 0000000..4bf3c72 --- /dev/null +++ b/docs/PRODUCT.ru.md @@ -0,0 +1,75 @@ +# Selectra: выбор по примерам + +[English](PRODUCT.md) + +## Задача + +Пользователь показывает, что считает похожим, а Selectra предлагает выделение. Основной вход — `Select Similar` в меню правой кнопки. Отдельный `Select Chain` находит замкнутые петли рёбер и обходы стенок. Пользователь не должен начинать с выбора технической метрики. + +**Область поиска уточнена пользователем 25.10.2026:** This Body, This Component (по умолчанию), All Components. This Component включает вложенную иерархию выбранного экземпляра; All Components — всю видимую сборку. Примеры и исключения лежат в выбранной области. Область не расширяется неявно; её переключение видно в диалоге. Каноническая семантика — [UX.md](UX.md). + +Актуальный сценарий и элементы интерфейса: [UX.md](UX.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. + +## Основной сценарий + +1. Выбрать одно или несколько рёбер либо граней одного тела. +2. ПКМ → `Select Similar`. Геометрия считывается после запуска команды, а не на каждом открытии меню. +3. Сразу увидеть лучший предложенный набор и число элементов. Примеры остаются в наборе. При неоднозначности — короткое объяснение. +4. Нажать `OK`; получить обычное выделение Fusion и продолжить работу, например запустить Fillet. `Cancel` восстанавливает исходный выбор при неизменном контексте. +5. Если результат не тот, уточнить примером или исключением. В нативном диалоге есть Examples и Exclude; уточнение пересчитывает ранжирование и сбрасывает ручной диапазон. + +В основной части — ползунок Similarity, который управляет тем же диапазоном, что и PgUp/PgDown. `Refine` свёрнут: необязательный Match и Reset Range. По умолчанию используется автоматическое ранжирование с размерным допуском 1% и угловым допуском 2°. Числовая дистанция не выводится как вероятность намерения. + +## Как выводится намерение + +Все сущности выбранного типа исходного тела получают непрерывную геометрическую оценку сходства. Общие признаки примеров определяют веса, различающиеся признаки перестают быть обязательными. Наборы с одинаковой оценкой включаются целиком. Исходное ядро отдельных гипотез сохранено для объяснений и сравнения; основное управление диапазоном использует общее ранжирование, а не переключение разрозненных наборов. + +Примеры: + +- Два прямых ребра разной длины, но одного направления → признак длины исключается, остаются параллельные рёбра. +- Два ребра одной длины с разным направлением → направление перестаёт ограничивать набор. +- Две цилиндрические грани одного радиуса с разными площадями → искать такой же радиус, не одинаковую площадь. +- Две несвязанные плоские грани разных размеров с полными контурами → искать объединение подтверждённых аналогов каждого примера; общая нормаль не заменяет форму. + +Направление прямого ребра — ось: разворот параметризации на 180° ничего не меняет. В Automatic сравнивается ось нормали плоскости; явный Orientation использует направленный вектор и различает противоположные стороны. У кривой поверхности одна произвольная нормаль не описывает направление целиком. + +Если примеры не имеют устойчивого общего признака, инструмент сообщает об этом. Он не должен незаметно выбирать всё тело. Для несвязанных плоских примеров с полными контурами поддержано объединение проверенных семейств формы и размера. Связанные примеры по-прежнему могут задавать повтор узла, а пара сторон — семейство стенок. Связанные группы с цилиндрическими и NURBS-гранями дополнительно проверяются по триангуляции поверхности и общему расположению. Для остальных типов геометрии используются доступные общие признаки. + +## Каталог сценариев + +| Пример | Ожидаемый смысл | Признаки и неоднозначности | Этап | +| --- | --- | --- | --- | +| Прямое ребро | Такие же по длине; параллельные; оба условия | Длина и ось. Второй пример различает намерение | Ядро spike | +| Круговая кромка | Кромки такого же радиуса | Тип кривой + радиус; полный круг и дуга различаются | Ядро spike | +| Дуга | Такой же радиус или радиус и длина | Не называть любой круг отверстием | Ядро spike | +| Плоская грань | Такие же размеры/граница или ориентация | Площадь, периметр, число рёбер/петель, нормаль; не доказательство конгруэнтности | Ядро spike | +| Цилиндрическая грань | Такой же радиус, иногда и площадь | Отверстие и наружный вал пока не различаются | Ядро spike | +| Сквозное или глухое отверстие | Все отверстия такого же диаметра/типа | Внутренняя ориентация, ось, петли, дно, соседство | Семантика после CAD-spike | +| Скругление | Все скругления такого же радиуса | Цилиндр/тор/свободная поверхность, соседние грани, выпуклость | После базового MVP | +| Фаска | Все фаски такой же ширины/угла | Геометрия и соседство; одной площади мало | После базового MVP | +| Цепочка рёбер | Касательно связанные или одинаковые цепочки | Граф соседства; отличать от штатной Tangent Chain | После базового MVP | +| Карман/бобышка | Похожие группы граней | Топологический регион вместо отдельных граней | Отдельный этап | +| Импорт STEP | Повторяющиеся элементы без истории | Геометрия и топология; история Hole/Pattern необязательна | CAD-корпус MVP | +| Свободная поверхность | Повторяющиеся участки формы | Выборки кривизны, ориентации и границы; площадь лишь грубый фильтр | Исследование | + +Mesh, T-Spline и эскизные сущности не входят в начальный BRep MVP. Для связанных групп кривых BRep-поверхностей поддержана дискретная проверка формы под одной общей трансформацией. Для одиночной кривой грани остаются простые числовые сравнения; точное аналитическое распознавание произвольных NURBS не заявляется. + +## Инженерные решения из опыта Perfora + +Ядро получает только неизменяемые снимки; перестановка примеров не меняет результат. Fusion adapter сохраняет исходный контекст. Никакие атрибуты не записываются на рёбра и грани. Модель не перестраивается, временные CAD-тела не создаются. + +Сначала дешёвые аналитические признаки. Уточнение топологии и кривизны добавляется только там, где снижает ложные совпадения. Лимиты прототипа: до 10 000 сущностей тела и мягкий бюджет чтения 2 секунды. Проверка бюджета между API-вызовами не может прервать один долгий вызов; это защита от продолжения обхода, не гарантия задержки интерфейса. Массовая подсветка требует отдельного измерения. + +Первую модель намерения реализуем локально и детерминированно. LLM для сравнения BRep не нужен. Адаптацию к привычкам пользователя можно исследовать позже на основе явных исправлений, не подменяя ей геометрические проверки. + +## Замкнутые цепочки + +Select Chain отделяет топологическую операцию от сходства. Один или несколько примеров запускают поиск ближайшего замкнутого контура через них; Chain across contact по умолчанию допускает переход через полный точный стык тел, а PgUp/PgDown и =/- переключают отдельные варианты контуров, заменяя предыдущий. Рёбра и грани имеют отдельную семантику, описанную в UX. Тела, геометрия и таймлайн не меняются. + +Уточнение Select Chain: каждый контур на каждом уровне проходит через все выбранные примеры. PgUp/PgDown и =/- переключают допустимые обходы через них без накопления. Поиск соседних отверстий, удалённых контуров или графовое расширение в Select Chain не входят. Плоскость влияет только на порядок уже допустимых контуров. + +Сквозной поиск сохраняет исходные контуры отдельных тел и добавляет контуры через точный стык. Временное удаление шва при Boolean Union не означает, что контуры по исходной линии разреза исчезают из выбора. Это относится и к рёбрам, и к цепочкам стенок. + +Для рёбер каталог включает также границы промежуточных связных частей плавного участка. Внутренний шов полного участка может оставаться границей его части и входить в искомый контур. Эти дополнительные варианты следуют после прежних контуров в том же классе плоскости; каждый всё равно обязан содержать все примеры. Перебор ограничен бюджетом топологии и времени, превышение явно отменяет результат. + +Для граней дополнительно распознаются замкнутые полосы одного тела с двумя простыми границами и циклом поперечных стыков. Узкая полоса имеет приоритет; ширина относительно длины границы — эвристика порядка, не доказательство намерения. Ранее доступные обходы остаются вариантами. Полосы через стык нескольких тел этой проверкой пока не строятся. From 10d523d47639ebfeffc9f8c4de552f79ad6186ff Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:23:18 +0300 Subject: [PATCH 06/14] docs: provide bilingual interaction contract --- GLOSSARY.ru.md | 2 +- docs/PRODUCT.ru.md | 4 +- docs/UX.md | 96 +++++++++++++++++++++++----------------------- docs/UX.ru.md | 87 +++++++++++++++++++++++++++++++++++++++++ 4 files changed, 139 insertions(+), 50 deletions(-) create mode 100644 docs/UX.ru.md diff --git a/GLOSSARY.ru.md b/GLOSSARY.ru.md index e824691..346f51a 100644 --- a/GLOSSARY.ru.md +++ b/GLOSSARY.ru.md @@ -5,7 +5,7 @@ Язык выбора похожих рёбер и граней по примерам в явно заданной области сборки. **Область поиска**: -Тело, иерархия выбранного экземпляра компонента или вся видимая сборка. Каноническая семантика This Body / This Component / All Components — в [UX.md](docs/UX.md). +Тело, иерархия выбранного экземпляра компонента или вся видимая сборка. Каноническая семантика This Body / This Component / All Components — в [UX.md](docs/UX.ru.md). ## Термины diff --git a/docs/PRODUCT.ru.md b/docs/PRODUCT.ru.md index 4bf3c72..8d2cf97 100644 --- a/docs/PRODUCT.ru.md +++ b/docs/PRODUCT.ru.md @@ -6,9 +6,9 @@ Пользователь показывает, что считает похожим, а Selectra предлагает выделение. Основной вход — `Select Similar` в меню правой кнопки. Отдельный `Select Chain` находит замкнутые петли рёбер и обходы стенок. Пользователь не должен начинать с выбора технической метрики. -**Область поиска уточнена пользователем 25.10.2026:** This Body, This Component (по умолчанию), All Components. This Component включает вложенную иерархию выбранного экземпляра; All Components — всю видимую сборку. Примеры и исключения лежат в выбранной области. Область не расширяется неявно; её переключение видно в диалоге. Каноническая семантика — [UX.md](UX.md). +**Область поиска уточнена пользователем 25.10.2026:** This Body, This Component (по умолчанию), All Components. This Component включает вложенную иерархию выбранного экземпляра; All Components — всю видимую сборку. Примеры и исключения лежат в выбранной области. Область не расширяется неявно; её переключение видно в диалоге. Каноническая семантика — [UX.md](UX.ru.md). -Актуальный сценарий и элементы интерфейса: [UX.md](UX.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. +Актуальный сценарий и элементы интерфейса: [UX.md](UX.ru.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. ## Основной сценарий diff --git a/docs/UX.md b/docs/UX.md index fe62988..0af066c 100644 --- a/docs/UX.md +++ b/docs/UX.md @@ -1,85 +1,87 @@ -# Selectra: продуктовый сценарий +# Selectra: product workflow -## Обещание +[Русская версия](UX.ru.md) -Покажи пример — получи похожие элементы в выбранной области. По умолчанию это компонент примера вместе с вложенной иерархией. Инструмент начинает с разумного предложения и даёт уточнить его по результату, не заставляя сначала выбирать технический критерий. +## Promise -Ориентир — скорость выделения Blender. Особенности Selectra: аналитическая CAD-геометрия, автоматический подбор общих признаков, обучение по дополнительным примерам и исключениям, ранжированный диапазон. Целевая модель геометрических отношений и намерений — [INTENT_MODEL.md](INTENT_MODEL.md); ниже описан интерфейс и текущее поведение. +Show an example and obtain similar elements in the selected scope. By default, this is the example's component and nested hierarchy. The tool starts with a reasonable proposal and lets the user refine the result without first choosing a technical criterion. -## Основной путь +The speed of Blender selection is a reference point. Selectra's distinguishing features are analytical CAD geometry, automatic selection of shared features, learning from additional examples and exclusions, and a ranked range. The target model of geometric relationships and intent is in [INTENT_MODEL.md](INTENT_MODEL.md); this document describes the interface and current behavior. -1. Пользователь выбирает ребро или грань и нажимает **ПКМ → Select Similar**. Уже выбранные элементы становятся примерами. Тип сущностей фиксирован; область по умолчанию — **This Component**. -2. Сразу видит **Magenta-подсветку** предложенного набора: примеры и первую непустую группу совпадений. Непрозрачность заливки 35%, чтобы видеть перекрывающиеся плоскости. Это временное представление; реальное выделение результата ещё не применяется. Поля Preview и переключателя Wheel нет. -3. Обычно достаточно **OK**. Пользователь получает обычное выделение Fusion и запускает нужную штатную операцию. -4. Если набор слишком узкий или широкий, **PgUp / =** добавляет следующий уровень сходства, **PgDown / -** убирает самый слабый включённый уровень. Ползунок Similarity делает то же самое. Колесо сохраняет штатную навигацию Fusion. -5. Если инструмент выбрал неправильный смысл сходства, пользователь добавляет второй пример в **Examples**. Чтобы показать лишний элемент, использует **Exclude** рядом. Это пересчитывает ранжирование и возвращает автоматический диапазон. -6. **Cancel / Esc** удаляет временную подсветку и возвращает исходный выбор. Запуск другой команды не считается нажатием OK. +## Main path -## Компактный нативный диалог +1. The user selects an edge or face and chooses **right-click → Select Similar**. Already selected elements become examples. Entity type is fixed; the default scope is **This Component**. +2. The proposed set immediately receives **Magenta highlighting**: examples and the first nonempty group of matches. Fill opacity is 35% to reveal overlapping planes. This is temporary; the actual result selection has not yet been applied. There is no Preview field or Wheel toggle. +3. Usually **OK** is sufficient. The user receives an ordinary Fusion selection and starts the desired native operation. +4. If the set is too narrow or broad, **PgUp / =** adds the next similarity level and **PgDown / -** removes the weakest included level. The Similarity slider does the same. The mouse wheel retains normal Fusion navigation. +5. If the tool chose the wrong meaning of similarity, the user adds a second example in **Examples**. To identify an unwanted element, use adjacent **Exclude**. This recalculates the ranking and restores the automatic range. +6. **Cancel / Esc** removes temporary highlighting and restores the original selection. Starting another command is not treated as pressing OK. -В основной части: количество результата и область, **Search Scope**, Examples и Exclude, ползунок **Similarity** с подписями **Closest / Broader**, подсказка **PgUp / =: more | PgDown / -: fewer**, OK и Cancel. +## Compact native dialog -**This Body** ограничивается телом выбранного примера в конкретном экземпляре. **This Component** включает тела выбранного компонента и всех его вложенных компонентов в этом экземпляре. Соседние экземпляры того же определения сюда не входят. Для тела корневого компонента его иерархия — вся сборка. **All Components** охватывает видимые доступные BRep-тела всей сборки, включая вложенные экземпляры. +The main area shows result count and scope, **Search Scope**, Examples and Exclude, the **Similarity** slider labeled **Closest / Broader**, the hint **PgUp / =: more | PgDown / -: fewer**, OK, and Cancel. -Смена области пересчитывает снимок и возвращает автоматический диапазон. Примеры можно добавлять из любого тела выбранной области. Если сужение оставляет явные примеры за её границей, пользователь сначала удаляет их; область не меняется незаметно. Исключения за пределами суженной области снимаются из Exclude. Текущая область всегда указана в статусе. При отказе расширения прежняя область сохраняется с сообщением; частичный набор из новой области не применяется. +**This Body** is limited to the example's body in its particular instance. **This Component** includes bodies in the selected component and all nested components of that instance. Neighboring instances of the same definition are excluded. For a root-component body, its hierarchy is the entire assembly. **All Components** covers visible accessible BRep bodies throughout the assembly, including nested instances. -**Refine** свёрнут. Внутри необязательный **Match** (Automatic либо конкретный признак), **Reset Range**. Технические признаки остаются доступны для воспроизводимости, но автоматический режим выбран по умолчанию. Большая палитра настроек, проценты «уверенности» и обязательный выбор критерия не нужны. +Changing scope rebuilds the snapshot and restores the automatic range. Examples can be added from any body in the selected scope. If narrowing would leave explicit examples outside it, the user removes them first; scope does not change silently. Exclusions outside the narrowed scope are removed from Exclude. Current scope is always shown in status. If expansion fails, the previous scope remains with a message; a partial set from the new scope is not applied. -Пользователь видит результат на модели, а не список tempId. Число включённых элементов обновляется вместе с подсветкой. Смена примеров не создаёт геометрию и не меняет таймлайн. +**Refine** is collapsed. It contains optional **Match** (Automatic or a specific feature) and **Reset Range**. Technical features remain available for reproducibility, but automatic mode is the default. A large settings palette, confidence percentages, and mandatory criterion selection are unnecessary. -## Ранжирование и управление диапазоном +The user sees the result on the model, not a list of tempIds. The included-element count updates with highlighting. Changing examples does not create geometry or modify the timeline. -Все сущности выбранного типа текущей области получают расстояние сходства. Отношения соседства и материала проверяются внутри каждого тела; совпадения формы допускаются между телами. Это геометрический порядок, не вероятность намерения. +## Ranking and range control -В автоматическом режиме используются доступные признаки: тип геометрии, длина/площадь, радиус, направление/ось нормали, периметр, простая сигнатура границы. Внутренняя сторона тонкой стенки не считается менее похожей только из-за разворота нормали на 180°. Ориентация слабее размера и формы; точное направление доступно через Match → Orientation. Если два примера различаются по признаку сильнее допуска, он перестаёт быть обязательным общим свойством. Исключения усиливают признаки, которые отделяют их от примеров. +All entities of the selected type in the current scope receive a similarity distance. Adjacency and material relationships are checked within each body; shape matches may cross bodies. This is a geometric order, not an intent probability. -Исходные примеры сохраняются при любом диапазоне; исключения не включаются даже при максимальном расширении. Равно похожие элементы добавляются и убираются вместе: порядок идентификаторов не должен произвольно разрывать такую группу. Поэтому один шаг PgUp может добавить несколько элементов. +Automatic mode uses available features: geometry type, length/area, radius, direction/normal axis, perimeter, and a simple boundary signature. The inner side of a thin wall is not considered less similar solely because its normal is reversed by 180°. Orientation is weaker than size and shape; exact direction is available through Match → Orientation. If two examples differ on a feature beyond tolerance, it ceases to be a mandatory shared property. Exclusions strengthen features that distinguish them from examples. -Диапазоны вложены: расширение сохраняет уже включённое; сужение удаляет наименее похожее. До максимума можно дойти до всех допустимых элементов этого типа в теле. Это не поиск соседей и не изменение геометрии. Графовые More/Less, Linked и поиск путей — отдельные операции; PgUp/PgDown к ним не привязаны. +Original examples remain at every range; exclusions are not included even at maximum expansion. Equally similar elements are added and removed together: identifier order must not arbitrarily split the group. One PgUp step can therefore add several elements. -Начальный автоматический диапазон сразу включает первую доступную группу похожих элементов сверх примеров; Reset Range возвращает её. Если кандидатов нет либо общих признаков недостаточно, инструмент сохраняет примеры и просит уточнить. Если исключение геометрически неотличимо от примера, это сообщается; произвольное различие не выдаётся за распознанное намерение. +Ranges are nested: expanding keeps included elements; narrowing removes the least similar. At maximum, all permitted elements of that type in the body can be reached. This is not a neighbor search or geometry modification. Graph More/Less, Linked, and path search are separate operations; PgUp/PgDown are not bound to them. -## Поведение подсветки +The initial automatic range immediately includes the first available group of similar elements beyond the examples; Reset Range restores it. If no candidates exist or shared features are insufficient, the tool retains examples and asks for refinement. If an exclusion is geometrically indistinguishable from an example, this is reported; an arbitrary distinction is not presented as recognized intent. -Последний включённый уровень дополнительно обведён контуром 3 px. При расширении акцент переходит на добавленную группу, при сужении — на внешний оставшийся уровень. Контур не мигает; предыдущие грани сохраняют заливку 35%, рёбра — Magenta-контур 1.5 px. Короткий статус различает подтверждённую форму, сторону стенки, повтор группы и приближённое сходство. Максимум явно подписан как все разрешённые элементы исходного типа тела. +## Highlighting behavior -Magenta-подсветка должна оставаться на месте при остановленном вводе, движении курсора, смене параметров и вращении вида. Временные объекты не перехватывают выбор мышью. +The last included level receives an additional 3 px outline. When expanding, the emphasis moves to the added group; when narrowing, it moves to the outermost remaining level. The outline does not blink; earlier faces retain a 35% fill and edges a 1.5 px Magenta outline. Short status text distinguishes a verified shape, wall side, repeated group, and approximate similarity. The maximum is explicitly labeled as all permitted elements of the body's original type. -Для совпадающих поверхностей используется эффект наложения и приоритет глубины. Координаты реальной грани не смещаются. Графика создаётся в штатном событии preview команды; валидная группа переиспользуется, элементы скрываются/показываются без очистки всего кадра. OK/Cancel/Stop удаляют группу целиком. +Magenta highlighting must remain in place when input stops, the cursor moves, parameters change, and the view rotates. Temporary objects do not intercept mouse selection. -Отдельно проверяются исчезновение графики из-за жизненного цикла preview и конфликт глубины на совпадающих поверхностях. Стабильность не считается доказанной только по наличию созданных CustomGraphics-объектов — нужна визуальная проверка в Fusion. +Overlapping surfaces use an overlay effect and depth priority. Real face coordinates are not displaced. Graphics are created in the command's native preview event; a valid group is reused, and elements are hidden/shown without clearing the entire frame. OK/Cancel/Stop removes the complete group. -## Критерии готовности опыта +Disappearance caused by the preview lifecycle and depth conflicts on overlapping surfaces are checked separately. Stability is not established merely by created CustomGraphics objects: visual validation in Fusion is required. -- С одним примером можно получить предложение и подтвердить его без посещения Refine. -- PgUp/PgDown и ползунок управляют одним ранжированием; соседство не влияет на порядок похожести. -- Подсветка непрерывна, Magenta, совпадает с набором после OK и не становится настоящим выделением до подтверждения. -- Дополнительный пример и исключение меняют смысл поиска предсказуемо; Reset Range возвращает автоматический диапазон. -- Cancel и прерывание сохраняют модель и не оставляют временной графики. -- Неизвестные признаки, бюджет отображения или изменение тела приводят к понятному сообщению без частичного применения. +## Experience acceptance criteria -Документ фиксирует целевое поведение и контракт ядра. Фактическая CAD-приёмка записывается отдельно в [VALIDATION.md](VALIDATION.md). +- One example can produce a proposal and be confirmed without visiting Refine. +- PgUp/PgDown and the slider control one ranking; adjacency does not determine similarity order. +- Highlighting is continuous and Magenta, matches the set after OK, and does not become actual selection before confirmation. +- An additional example and exclusion change search meaning predictably; Reset Range restores the automatic range. +- Cancel and interruption preserve the model and leave no temporary graphics. +- Unknown features, display-budget exhaustion, or a changed body produce a clear message without partial application. -Для одинаковой геометрической группы Automatic предлагает сначала элементы в плоскости примера, затем отдельным шагом — в параллельных плоскостях, затем — в остальных. Например, кромки отверстий на внешней стороне пластины идут до внутренних кромок на обратной стороне. Статус показывает In the example plane / In parallel planes / In other planes; отсутствие опорной плоскости обозначается Support plane unavailable. +This document records target behavior and the kernel contract. Actual CAD acceptance is recorded separately in [VALIDATION.md](VALIDATION.md). -Несколько несвязанных плоских Examples могут задавать разные размерные семейства. Automatic сначала показывает подтверждённые аналоги каждого примера с пояснением Matching shapes and sizes of the examples. Связанные примеры могут задавать повтор всей группы; общая плоскость сама по себе не заменяет проверку формы. +For the same geometric group, Automatic first proposes elements in the example plane, then in a separate step those in parallel planes, then others. For example, hole edges on a plate's outer side precede inner edges on the reverse side. Status shows In the example plane / In parallel planes / In other planes; an absent support plane is labeled Support plane unavailable. -Выбранные внутренние стороны паза могут включать цилиндрические и NURBS-грани. Связанные части ищутся целыми группами: нельзя включить только одну случайную грань похожего размера. Для экструзионного паза сохраняется порядок уровней по его торцевой плоскости: та же → параллельные → остальные. Статус Matching curved-face groups (sampled geometry) указывает на дискретную проверку формы. +Several disconnected planar Examples can define different size families. Automatic first shows verified analogues of each example with the explanation Matching shapes and sizes of the examples. Connected examples can define a repetition of the complete group; a shared plane alone does not replace shape checking. + +Selected inner sides of a slot may include cylindrical and NURBS faces. Connected parts are searched as complete groups: one arbitrary similarly sized face cannot be included alone. For an extruded slot, level order follows its end plane: same → parallel → others. Matching curved-face groups (sampled geometry) indicates a discrete shape check. ## Select Chain -Отдельная команда контекстного меню для одного или нескольких выбранных BRep-рёбер либо граней стенки. Каждый предлагаемый контур на любом уровне должен проходить через все примеры. Ребро задаёт ближайшую замкнутую петлю рёбер; грань — замкнутый обход прилегающих стенок по петле соседней грани. Замкнутость берётся из BRep-топологии, а не из зрительного сходства. Для стенок проверяется непрерывность соседних участников обхода. Швы с повторным прохождением одного ребра не считаются простой петлёй рёбер. +A separate context-menu command for one or more selected BRep edges or wall faces. Every proposed contour at every level must pass through all examples. An edge defines the nearest closed edge loop; a face defines a closed traversal of adjacent walls around a neighboring face loop. Closure comes from BRep topology, not visual resemblance. For walls, continuity of neighboring traversal members is checked. Seams that traverse one edge repeatedly are not simple edge loops. -Галочка **Chain across contact** включена по умолчанию: цепочка может проходить через полностью совпадающие общие грани видимых тел, как после Split Body. Совпадение точки/ребра, частичное касание, зазор и объёмное перекрытие не считаются таким стыком. При выключенной галочке тела остаются раздельными. Все контуры должны проходить через все примеры. Среди таких контуров выше идут лежащие в плоскости примеров, затем параллельные, остальные и контуры с неопределённой плоскостью. Внутри этого порядка учитываются внутренняя петля и периметр. Переключение выбирает только альтернативные замкнутые обходы через те же примеры. Соседние отверстия и контуры, не содержащие выбранный элемент, не входят в поиск даже на максимуме. Разные контуры с равным рангом остаются отдельными вариантами. Это эвристика выбора ближайшего контура, а не единственное математически возможное понимание стенки. +**Chain across contact** is enabled by default: a chain can cross completely coincident shared faces of visible bodies, as after Split Body. Point/edge coincidence, partial contact, a gap, and volume overlap do not count as such a junction. With the checkbox off, bodies remain separate. Every contour must pass through all examples. Among those, contours in the examples' plane rank first, then parallel, other, and undefined-plane contours. Within that order, inner loops and perimeter are considered. Switching selects only alternative closed traversals through the same examples. Neighboring holes and contours without the chosen element are excluded even at maximum. Different equally ranked contours remain separate options. This is a nearest-contour heuristic, not the only mathematically possible interpretation of a wall. -Contour, PgUp и = выбирают следующий целый контур вместо предыдущего; PgDown и - возвращают предыдущий вариант. Одновременно показывается ровно один контур, накопления нет. Пример сохраняется. Подсветка Magenta, перенос выделения только по OK, Cancel восстанавливает исходный пример. Когда замкнутой цепочки нет, показано явное сообщение и OK недоступен. Examples позволяет добавлять примеры и убирать лишние; Search Scope, Match и Exclude здесь не показываются. +Contour, PgUp, and = choose the next complete contour instead of the previous one; PgDown and - return to the previous option. Exactly one contour is displayed at a time, without accumulation. The example is retained. Highlighting is Magenta; selection transfers only on OK; Cancel restores the original example. If no closed chain exists, a clear message is shown and OK is disabled. Examples allows adding and removing examples; Search Scope, Match, and Exclude are not shown here. -Переход через стык проверяется на временных BRep-копиях; реального Combine, Stitch или изменения таймлайна нет. Замкнутый контур строится после виртуального удаления внутренних швов и полностью сопоставляется исходным рёбрам/граням. Если примеры на раздельных телах при выключенной галочке не принадлежат одному контуру, они сохраняются, показано No closed contour passes through all examples, OK недоступен. Ползунок, PgUp/PgDown и =/- продолжают добавлять целые контуры. +Cross-contact transitions are checked on temporary BRep copies; no real Combine, Stitch, or timeline modification occurs. A closed contour is constructed after virtual removal of internal seams and mapped completely back to original edges/faces. If examples on separate bodies do not belong to one contour with the checkbox off, they remain selected, No closed contour passes through all examples is displayed, and OK is disabled. The slider, PgUp/PgDown, and =/- continue adding whole contours. -Для ребра плоскость определяется по его известным опорным плоскостям; для нескольких примеров берутся общие плоскости. У прямого ребра их может быть несколько. Если плоскость примера не определена (например, для стенки), используется плоскость ближайшего подходящего замкнутого контура. На любом шаге добавляется целая петля через все примеры. Совпадение плоскости и геометрическое соседство не заменяют это обязательное условие. Статус показывает In the example plane / In parallel planes / In other planes / Contour plane unavailable. +For an edge, plane is determined from its known support planes; for multiple examples, common planes are used. A straight edge can have several. If the example plane is undefined (for example, for a wall), the plane of the nearest suitable closed contour is used. Every step adds a whole loop through all examples. Plane coincidence and geometric adjacency do not replace this mandatory condition. Status shows In the example plane / In parallel planes / In other planes / Contour plane unavailable. -Chain across contact добавляет сквозные варианты к контурам исходных тел. Она не заменяет каталог исходных тел временно объединённой геометрией: контуры по границе Split Body остаются доступными, даже если виртуальное объединение удаляет этот шов. Каждый вариант по-прежнему проходит через все примеры. +Chain across contact adds cross-body options to the source bodies' contours. It does not replace the source-body catalog with temporarily united geometry: contours along the Split Body boundary remain available even if virtual union removes that seam. Every option still passes through all examples. -Для рёбер доступны также общие границы групп плавно соединённых граней: например, обход трёх внутренних стенок половины паза целиком. Внутренние стыки этих стенок не входят в контур. Если у группы несколько отдельных замкнутых границ, каждая остаётся самостоятельным вариантом; в поиск попадают только проходящие через все примеры. Простое соседство или совпадение координат концов не считается доказательством замыкания. +For edges, shared boundaries of smoothly connected face groups are also available: for example, the complete outline of three inner walls of half a slot. Internal junctions of those walls are not part of the contour. If a group has several separate closed boundaries, each remains an independent option; only those through all examples enter the search. Simple adjacency or coincident endpoint coordinates do not prove closure. -Для граней поиск также распознаёт замкнутую полосу из нескольких смежных граней одного тела, если у неё две полные простые границы и простой цикл поперечных стыков. Узкие полосы ранжируются перед обходами соседних граней; их порядок зависит от отношения средней длины стыка к длине меньшей границы. Это эвристика: для широкой или сложной полосы порядок может отличаться от ожидаемого. Поиск ограничен бюджетом и не выдаёт частичный результат при его превышении. Сквозные полосы из нескольких тел пока не распознаются этой дополнительной проверкой. +For faces, the search also recognizes a closed strip of several adjacent faces of one body when it has two complete simple boundaries and a simple cycle of cross junctions. Narrow strips rank before traversals of neighboring faces; their order depends on the ratio of mean junction length to the smaller boundary length. This is a heuristic: for a wide or complex strip the order can differ from expectations. Search is budget-limited and does not return a partial result when exceeded. This additional check does not yet recognize cross-body strips. diff --git a/docs/UX.ru.md b/docs/UX.ru.md new file mode 100644 index 0000000..b9563ef --- /dev/null +++ b/docs/UX.ru.md @@ -0,0 +1,87 @@ +# Selectra: продуктовый сценарий + +[English](UX.md) + +## Обещание + +Покажи пример — получи похожие элементы в выбранной области. По умолчанию это компонент примера вместе с вложенной иерархией. Инструмент начинает с разумного предложения и даёт уточнить его по результату, не заставляя сначала выбирать технический критерий. + +Ориентир — скорость выделения Blender. Особенности Selectra: аналитическая CAD-геометрия, автоматический подбор общих признаков, обучение по дополнительным примерам и исключениям, ранжированный диапазон. Целевая модель геометрических отношений и намерений — [INTENT_MODEL.md](INTENT_MODEL.md); ниже описан интерфейс и текущее поведение. + +## Основной путь + +1. Пользователь выбирает ребро или грань и нажимает **ПКМ → Select Similar**. Уже выбранные элементы становятся примерами. Тип сущностей фиксирован; область по умолчанию — **This Component**. +2. Сразу видит **Magenta-подсветку** предложенного набора: примеры и первую непустую группу совпадений. Непрозрачность заливки 35%, чтобы видеть перекрывающиеся плоскости. Это временное представление; реальное выделение результата ещё не применяется. Поля Preview и переключателя Wheel нет. +3. Обычно достаточно **OK**. Пользователь получает обычное выделение Fusion и запускает нужную штатную операцию. +4. Если набор слишком узкий или широкий, **PgUp / =** добавляет следующий уровень сходства, **PgDown / -** убирает самый слабый включённый уровень. Ползунок Similarity делает то же самое. Колесо сохраняет штатную навигацию Fusion. +5. Если инструмент выбрал неправильный смысл сходства, пользователь добавляет второй пример в **Examples**. Чтобы показать лишний элемент, использует **Exclude** рядом. Это пересчитывает ранжирование и возвращает автоматический диапазон. +6. **Cancel / Esc** удаляет временную подсветку и возвращает исходный выбор. Запуск другой команды не считается нажатием OK. + +## Компактный нативный диалог + +В основной части: количество результата и область, **Search Scope**, Examples и Exclude, ползунок **Similarity** с подписями **Closest / Broader**, подсказка **PgUp / =: more | PgDown / -: fewer**, OK и Cancel. + +**This Body** ограничивается телом выбранного примера в конкретном экземпляре. **This Component** включает тела выбранного компонента и всех его вложенных компонентов в этом экземпляре. Соседние экземпляры того же определения сюда не входят. Для тела корневого компонента его иерархия — вся сборка. **All Components** охватывает видимые доступные BRep-тела всей сборки, включая вложенные экземпляры. + +Смена области пересчитывает снимок и возвращает автоматический диапазон. Примеры можно добавлять из любого тела выбранной области. Если сужение оставляет явные примеры за её границей, пользователь сначала удаляет их; область не меняется незаметно. Исключения за пределами суженной области снимаются из Exclude. Текущая область всегда указана в статусе. При отказе расширения прежняя область сохраняется с сообщением; частичный набор из новой области не применяется. + +**Refine** свёрнут. Внутри необязательный **Match** (Automatic либо конкретный признак), **Reset Range**. Технические признаки остаются доступны для воспроизводимости, но автоматический режим выбран по умолчанию. Большая палитра настроек, проценты «уверенности» и обязательный выбор критерия не нужны. + +Пользователь видит результат на модели, а не список tempId. Число включённых элементов обновляется вместе с подсветкой. Смена примеров не создаёт геометрию и не меняет таймлайн. + +## Ранжирование и управление диапазоном + +Все сущности выбранного типа текущей области получают расстояние сходства. Отношения соседства и материала проверяются внутри каждого тела; совпадения формы допускаются между телами. Это геометрический порядок, не вероятность намерения. + +В автоматическом режиме используются доступные признаки: тип геометрии, длина/площадь, радиус, направление/ось нормали, периметр, простая сигнатура границы. Внутренняя сторона тонкой стенки не считается менее похожей только из-за разворота нормали на 180°. Ориентация слабее размера и формы; точное направление доступно через Match → Orientation. Если два примера различаются по признаку сильнее допуска, он перестаёт быть обязательным общим свойством. Исключения усиливают признаки, которые отделяют их от примеров. + +Исходные примеры сохраняются при любом диапазоне; исключения не включаются даже при максимальном расширении. Равно похожие элементы добавляются и убираются вместе: порядок идентификаторов не должен произвольно разрывать такую группу. Поэтому один шаг PgUp может добавить несколько элементов. + +Диапазоны вложены: расширение сохраняет уже включённое; сужение удаляет наименее похожее. До максимума можно дойти до всех допустимых элементов этого типа в теле. Это не поиск соседей и не изменение геометрии. Графовые More/Less, Linked и поиск путей — отдельные операции; PgUp/PgDown к ним не привязаны. + +Начальный автоматический диапазон сразу включает первую доступную группу похожих элементов сверх примеров; Reset Range возвращает её. Если кандидатов нет либо общих признаков недостаточно, инструмент сохраняет примеры и просит уточнить. Если исключение геометрически неотличимо от примера, это сообщается; произвольное различие не выдаётся за распознанное намерение. + +## Поведение подсветки + +Последний включённый уровень дополнительно обведён контуром 3 px. При расширении акцент переходит на добавленную группу, при сужении — на внешний оставшийся уровень. Контур не мигает; предыдущие грани сохраняют заливку 35%, рёбра — Magenta-контур 1.5 px. Короткий статус различает подтверждённую форму, сторону стенки, повтор группы и приближённое сходство. Максимум явно подписан как все разрешённые элементы исходного типа тела. + +Magenta-подсветка должна оставаться на месте при остановленном вводе, движении курсора, смене параметров и вращении вида. Временные объекты не перехватывают выбор мышью. + +Для совпадающих поверхностей используется эффект наложения и приоритет глубины. Координаты реальной грани не смещаются. Графика создаётся в штатном событии preview команды; валидная группа переиспользуется, элементы скрываются/показываются без очистки всего кадра. OK/Cancel/Stop удаляют группу целиком. + +Отдельно проверяются исчезновение графики из-за жизненного цикла preview и конфликт глубины на совпадающих поверхностях. Стабильность не считается доказанной только по наличию созданных CustomGraphics-объектов — нужна визуальная проверка в Fusion. + +## Критерии готовности опыта + +- С одним примером можно получить предложение и подтвердить его без посещения Refine. +- PgUp/PgDown и ползунок управляют одним ранжированием; соседство не влияет на порядок похожести. +- Подсветка непрерывна, Magenta, совпадает с набором после OK и не становится настоящим выделением до подтверждения. +- Дополнительный пример и исключение меняют смысл поиска предсказуемо; Reset Range возвращает автоматический диапазон. +- Cancel и прерывание сохраняют модель и не оставляют временной графики. +- Неизвестные признаки, бюджет отображения или изменение тела приводят к понятному сообщению без частичного применения. + +Документ фиксирует целевое поведение и контракт ядра. Фактическая CAD-приёмка записывается отдельно в [VALIDATION.md](VALIDATION.md). + +Для одинаковой геометрической группы Automatic предлагает сначала элементы в плоскости примера, затем отдельным шагом — в параллельных плоскостях, затем — в остальных. Например, кромки отверстий на внешней стороне пластины идут до внутренних кромок на обратной стороне. Статус показывает In the example plane / In parallel planes / In other planes; отсутствие опорной плоскости обозначается Support plane unavailable. + +Несколько несвязанных плоских Examples могут задавать разные размерные семейства. Automatic сначала показывает подтверждённые аналоги каждого примера с пояснением Matching shapes and sizes of the examples. Связанные примеры могут задавать повтор всей группы; общая плоскость сама по себе не заменяет проверку формы. + +Выбранные внутренние стороны паза могут включать цилиндрические и NURBS-грани. Связанные части ищутся целыми группами: нельзя включить только одну случайную грань похожего размера. Для экструзионного паза сохраняется порядок уровней по его торцевой плоскости: та же → параллельные → остальные. Статус Matching curved-face groups (sampled geometry) указывает на дискретную проверку формы. + +## Select Chain + +Отдельная команда контекстного меню для одного или нескольких выбранных BRep-рёбер либо граней стенки. Каждый предлагаемый контур на любом уровне должен проходить через все примеры. Ребро задаёт ближайшую замкнутую петлю рёбер; грань — замкнутый обход прилегающих стенок по петле соседней грани. Замкнутость берётся из BRep-топологии, а не из зрительного сходства. Для стенок проверяется непрерывность соседних участников обхода. Швы с повторным прохождением одного ребра не считаются простой петлёй рёбер. + +Галочка **Chain across contact** включена по умолчанию: цепочка может проходить через полностью совпадающие общие грани видимых тел, как после Split Body. Совпадение точки/ребра, частичное касание, зазор и объёмное перекрытие не считаются таким стыком. При выключенной галочке тела остаются раздельными. Все контуры должны проходить через все примеры. Среди таких контуров выше идут лежащие в плоскости примеров, затем параллельные, остальные и контуры с неопределённой плоскостью. Внутри этого порядка учитываются внутренняя петля и периметр. Переключение выбирает только альтернативные замкнутые обходы через те же примеры. Соседние отверстия и контуры, не содержащие выбранный элемент, не входят в поиск даже на максимуме. Разные контуры с равным рангом остаются отдельными вариантами. Это эвристика выбора ближайшего контура, а не единственное математически возможное понимание стенки. + +Contour, PgUp и = выбирают следующий целый контур вместо предыдущего; PgDown и - возвращают предыдущий вариант. Одновременно показывается ровно один контур, накопления нет. Пример сохраняется. Подсветка Magenta, перенос выделения только по OK, Cancel восстанавливает исходный пример. Когда замкнутой цепочки нет, показано явное сообщение и OK недоступен. Examples позволяет добавлять примеры и убирать лишние; Search Scope, Match и Exclude здесь не показываются. + +Переход через стык проверяется на временных BRep-копиях; реального Combine, Stitch или изменения таймлайна нет. Замкнутый контур строится после виртуального удаления внутренних швов и полностью сопоставляется исходным рёбрам/граням. Если примеры на раздельных телах при выключенной галочке не принадлежат одному контуру, они сохраняются, показано No closed contour passes through all examples, OK недоступен. Ползунок, PgUp/PgDown и =/- продолжают добавлять целые контуры. + +Для ребра плоскость определяется по его известным опорным плоскостям; для нескольких примеров берутся общие плоскости. У прямого ребра их может быть несколько. Если плоскость примера не определена (например, для стенки), используется плоскость ближайшего подходящего замкнутого контура. На любом шаге добавляется целая петля через все примеры. Совпадение плоскости и геометрическое соседство не заменяют это обязательное условие. Статус показывает In the example plane / In parallel planes / In other planes / Contour plane unavailable. + +Chain across contact добавляет сквозные варианты к контурам исходных тел. Она не заменяет каталог исходных тел временно объединённой геометрией: контуры по границе Split Body остаются доступными, даже если виртуальное объединение удаляет этот шов. Каждый вариант по-прежнему проходит через все примеры. + +Для рёбер доступны также общие границы групп плавно соединённых граней: например, обход трёх внутренних стенок половины паза целиком. Внутренние стыки этих стенок не входят в контур. Если у группы несколько отдельных замкнутых границ, каждая остаётся самостоятельным вариантом; в поиск попадают только проходящие через все примеры. Простое соседство или совпадение координат концов не считается доказательством замыкания. + +Для граней поиск также распознаёт замкнутую полосу из нескольких смежных граней одного тела, если у неё две полные простые границы и простой цикл поперечных стыков. Узкие полосы ранжируются перед обходами соседних граней; их порядок зависит от отношения средней длины стыка к длине меньшей границы. Это эвристика: для широкой или сложной полосы порядок может отличаться от ожидаемого. Поиск ограничен бюджетом и не выдаёт частичный результат при его превышении. Сквозные полосы из нескольких тел пока не распознаются этой дополнительной проверкой. From c7449f32c33f0cecfcf982407d47af63f0c9167f Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:24:17 +0300 Subject: [PATCH 07/14] docs: align bilingual publishing instructions --- docs/PUBLISHING.md | 30 ++++++++++++++++-------------- docs/PUBLISHING.ru.md | 23 +++++++++++++++++++++++ 2 files changed, 39 insertions(+), 14 deletions(-) create mode 100644 docs/PUBLISHING.ru.md diff --git a/docs/PUBLISHING.md b/docs/PUBLISHING.md index a492c61..7398f4e 100644 --- a/docs/PUBLISHING.md +++ b/docs/PUBLISHING.md @@ -1,21 +1,23 @@ -# Публикация Selectra +# Publishing Selectra -Selectra использует GitVersion 6.8.2 как источник версии X.Y.Z. Для стабильных релизов тег имеет вид `vX.Y.Z`, для предварительных — `vX.Y.Z-IDENTIFIER`. Версия в опубликованном Fusion manifest и имени ZIP всегда числовая X.Y.Z и должна совпадать с GitVersion. Релизные файлы собирает и публикует только GitHub Actions. +[Русская версия](PUBLISHING.ru.md) -## Каждый push и pull request +Selectra uses GitVersion 6.8.2 as the source of its numeric `X.Y.Z` release identity. The current workflow publishes stable releases from eligible pushes to `main`; it creates the immutable `vX.Y.Z` tag automatically. Do not create or move release tags manually. The version embedded in the Fusion manifest inside the published ZIP and the ZIP name must match GitVersion. GitHub Actions alone builds and publishes release assets. -CI проверяет Python 3.14 на Ubuntu, macOS и Windows: синтаксис, unit-тесты, документы, manifest и ZIP. Версии сторонних Actions закреплены полными commit SHA; Dependabot предлагает обновления отдельными PR. +## Push and pull request checks -Каждая ОС загружает артефакт `Selectra-package-Linux`, `Selectra-package-macOS` или `Selectra-package-Windows` с ZIP и SHA-256. Workflow не запускает Fusion и не заменяет CAD-приёмку. +CI checks Python 3.14 on Ubuntu, macOS and Windows: compilation, unit tests, public metadata and documents, manifest, and ZIP. Third-party Actions are pinned to full commit SHAs; Dependabot proposes updates in separate PRs. -## Стабильный выпуск +Each OS uploads a `Selectra-package-Linux`, `Selectra-package-macOS`, or `Selectra-package-Windows` artifact containing a ZIP and SHA-256. The workflow does not run Fusion and does not replace CAD acceptance. -1. Пройти CAD-сценарии на заявляемых платформах и записать Fusion/ОС, выполненные проверки и ограничения в [протокол](VALIDATION.md). Автоматические проверки и нативную приёмку указывать отдельно. -2. Рассчитать версию через GitVersion, обновить README, CHANGELOG и обе страницы `docs/releases/X.Y.Z.md` / `X.Y.Z.ru.md`. Сделать реальные демо-снимки Fusion. CI подставляет GitVersion в manifest **внутри ZIP**, не меняя исходный файл в репозитории. -3. Проверить установку распакованного ZIP через GUI Fusion. Локальная сборка используется только для проверки, не для загрузки в Release. -4. Выполнить локальные проверки и дождаться зелёного CI выпускаемого commit. Перенести проверенный commit в main и создать новый тег `vX.Y.Z` (либо `vX.Y.Z-IDENTIFIER` для prerelease) без переписывания существующих тегов. -5. Push тега запускает полную CI-матрицу повторно. Зависимый job `release` скачивает все три пакета, сверяет manifest и SHA-256 и требует побайтового совпадения архивов. -6. `scripts/publish_release.py` создаёт draft, загружает ZIP и checksum из CI, проверяет серверные digest и публикует `draft=false`: стабильная версия получает `prerelease=false` и Latest, предварительная — `prerelease=true` и не становится Latest. Токен выдаётся GitHub Actions только job публикации. Локальная публикация запрещена скриптом. -7. Прочитать опубликованные метаданные, скачать ZIP и SHA-256 со страницы релиза, проверить состав и контрольную сумму. Ссылка на CI и commit включается в описание автоматически. +## Preparing a stable release -Архивы называются `Selectra-X.Y.Z.zip` независимо от канала; канал задаёт Git-тег и GitHub Release. При несовпадении GitVersion, manifest, версий трёх пакетов ОС или checksum публикация блокируется. Повторный запуск не подменяет отличающиеся файлы опубликованного релиза. +1. Run CAD scenarios on the platforms being claimed and record Fusion/OS versions, checks performed and limitations in [the validation report](VALIDATION.md). Distinguish automated checks from native acceptance. +2. Resolve the version using GitVersion and update the README, changelog and, where applicable, both `docs/releases/X.Y.Z.md` / `X.Y.Z.ru.md`. Capture real Fusion demo images. CI stamps GitVersion into the manifest **inside the ZIP**, without changing the source manifest in the repository. +3. Verify installation of the extracted ZIP through the Fusion GUI. A local build is for verification, not upload to a Release. +4. Run local checks and wait for green CI for the reviewed commit, then merge it to `main`. The release job runs only on a `main` push with eligible shipped changes under `.github/release-paths.txt`. A docs-only push may retry an earlier missed runtime release; it does not create a release independently. PR and manual workflow runs do not publish. +5. After the three OS jobs pass, the release job downloads all three packages, validates manifest and SHA-256, and requires byte-identical archives. It uses reviewed version-specific notes when available; otherwise the shared action generates notes from Git history. +6. `scripts/publish_release.py` creates a draft, uploads the ZIP and checksum from CI, verifies server digests, and publishes it. The current workflow uses the stable channel and marks the release Latest. GitHub Actions supplies a token only to the publishing job; the script rejects local publication. +7. Read published metadata, download the ZIP and SHA-256 from the release page, and verify contents and checksum. The description automatically includes the CI link and commit. + +Archives are named `Selectra-X.Y.Z.zip`. Publication is blocked on mismatched GitVersion, manifest, package bytes or checksum. A published release is immutable; retries do not replace different published assets. See the [release policy](../.github/RELEASE_POLICY.md) for recovery and eligibility details. diff --git a/docs/PUBLISHING.ru.md b/docs/PUBLISHING.ru.md new file mode 100644 index 0000000..2464bc8 --- /dev/null +++ b/docs/PUBLISHING.ru.md @@ -0,0 +1,23 @@ +# Публикация Selectra + +[English](PUBLISHING.md) + +Selectra использует GitVersion 6.8.2 как источник числовой версии `X.Y.Z`. Текущий workflow публикует стабильные релизы по подходящим push в `main` и автоматически создаёт неизменяемый тег `vX.Y.Z`. Не создавайте и не перемещайте релизные теги вручную. Версия Fusion manifest внутри опубликованного ZIP и имя ZIP должны совпадать с GitVersion. Релизные файлы собирает и публикует только GitHub Actions. + +## Проверки push и pull request + +CI проверяет Python 3.14 на Ubuntu, macOS и Windows: компиляцию, модульные тесты, публичные метаданные и документы, манифест и ZIP. Сторонние Actions закреплены полными SHA коммитов; Dependabot предлагает обновления отдельными PR. + +Каждая ОС загружает артефакт `Selectra-package-Linux`, `Selectra-package-macOS` или `Selectra-package-Windows` с ZIP и SHA-256. Workflow не запускает Fusion и не заменяет CAD-приёмку. + +## Подготовка стабильного выпуска + +1. Выполните CAD-сценарии на заявляемых платформах и запишите версии Fusion/ОС, выполненные проверки и ограничения в [протокол](VALIDATION.md). Различайте автоматические проверки и нативную приёмку. +2. Определите версию через GitVersion и обновите README, историю изменений и, где применимо, обе страницы `docs/releases/X.Y.Z.md` / `X.Y.Z.ru.md`. Сделайте реальные демо-снимки Fusion. CI подставляет GitVersion в манифест **внутри ZIP**, не меняя исходный файл репозитория. +3. Проверьте установку распакованного ZIP через интерфейс Fusion. Локальная сборка используется для проверки, а не для загрузки в Release. +4. Выполните локальные проверки и дождитесь успешного CI проверенного коммита, затем объедините его в `main`. Задание релиза запускается только при push в `main` с подходящими изменениями поставляемых файлов из `.github/release-paths.txt`. Push только документации может повторить ранее пропущенный выпуск с изменениями продукта, но сам по себе релиз не создаёт. PR и ручной запуск workflow не публикуют релиз. +5. После успешных заданий трёх ОС задание релиза скачивает все три пакета, проверяет манифест и SHA-256 и требует побайтового совпадения архивов. При наличии используются проверенные заметки конкретной версии; иначе общий Action создаёт заметки из истории Git. +6. `scripts/publish_release.py` создаёт черновик, загружает ZIP и контрольную сумму из CI, проверяет серверные дайджесты и публикует его. Текущий workflow использует стабильный канал и помечает релиз Latest. Токен GitHub Actions выдаётся только заданию публикации; скрипт отклоняет локальную публикацию. +7. Прочитайте опубликованные метаданные, скачайте ZIP и SHA-256 со страницы релиза, проверьте состав и контрольную сумму. Ссылка на CI и коммит включается в описание автоматически. + +Архивы называются `Selectra-X.Y.Z.zip`. При несовпадении GitVersion, манифеста, байтов пакетов или контрольной суммы публикация блокируется. Опубликованный релиз неизменяем; повторные запуски не заменяют отличающиеся опубликованные файлы. Условия восстановления и выпуска приведены в [политике релизов](../.github/RELEASE_POLICY.ru.md). From 5e80190410654a95b3620e586d18e8b23db63ac3 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:26:20 +0300 Subject: [PATCH 08/14] docs: provide bilingual intent specification --- docs/INTENT_MODEL.md | 184 ++++++++++++++++++++-------------------- docs/INTENT_MODEL.ru.md | 147 ++++++++++++++++++++++++++++++++ docs/PRODUCT.ru.md | 2 +- docs/UX.ru.md | 2 +- 4 files changed, 242 insertions(+), 93 deletions(-) create mode 100644 docs/INTENT_MODEL.ru.md diff --git a/docs/INTENT_MODEL.md b/docs/INTENT_MODEL.md index 2ed6dc8..9093ee0 100644 --- a/docs/INTENT_MODEL.md +++ b/docs/INTENT_MODEL.md @@ -1,145 +1,147 @@ -# Модель предсказания выбора Selectra +# Selectra selection-prediction model -Статус: спецификация с частичным внедрением 25.10.2026. Планарные полигональные аналоги, локальные пары стенок, общая геометрия повторов и нативные группы внедрены; объём проверки и ограничения — в [EVALUATION.md](EVALUATION.md). Свободные поверхности, роли отверстий/валов и полная матрица ниже ещё не реализованы. Алгоритм — в [RANKING.md](RANKING.md), термины — в [GLOSSARY.md](../GLOSSARY.md). +[Русская версия](INTENT_MODEL.ru.md) -## Что предсказываем +Status: specification partially implemented on 25 October 2026. Planar polygon analogues, local wall pairs, shared geometry of repetitions, and native groups are implemented; validation scope and limits are in [EVALUATION.md](EVALUATION.md). Freeform surfaces, hole/shaft roles, and the complete matrix below remain unimplemented. The algorithm is in [RANKING.md](RANKING.md); terminology is in [GLOSSARY.md](../GLOSSARY.md). -Уточнение области от 25.10.2026: Search Scope предлагает This Body / This Component / All Components, по умолчанию This Component с вложенными экземплярами выбранного компонента. Упоминания исходного тела ниже описывают границы графовых/материальных отношений и режим This Body; соответствие формы может искаться между телами выбранной области. Каноническая семантика — [UX.md](UX.md). +## What is predicted -Пользователь выбирает элементы как часть задачи: обработать одинаковые кромки, найти парные стороны стенки, выбрать повторяющиеся отверстия. Selectra оценивает несколько возможных оснований такого выбора и строит один понятный порядок расширения. +Scope clarification of 25 October 2026: Search Scope offers This Body / This Component / All Components, defaulting to This Component with nested instances of the selected component. References to the source body below describe the boundaries of graph/material relationships and This Body mode; shape matches can be sought across bodies in the selected scope. Canonical semantics are in [UX.md](UX.md). -Обязательный контракт: только исходное тело, тот же тип сущностей, все явные примеры в результате, все исключения вне результата. Ни предполагаемая симметрия, ни повтор не расширяют область на соседнее тело. Признаки камеры, видимости и расстояния на экране не определяют геометрическое сходство. +The user selects elements as part of a task: work on identical edges, find paired sides of a wall, or select repeated holes. Selectra evaluates several possible grounds for that selection and constructs one understandable expansion order. -## Контрольный сценарий: тонкая стенка +Required contract: source body only, same entity type, all explicit examples in the result, and all exclusions outside it. Neither inferred symmetry nor repetition expands scope to a neighboring body. Camera, visibility, and screen-distance features do not determine geometric similarity. The scope clarification above governs cross-body shape matching. -Пример — наружная торцевая грань стенки. Ожидаемая последовательность: +## Control scenario: thin wall -1. Такая же наружная грань на другой стороне тела: совпадает форма и размер, хотя меняются положение и ориентация. -2. Внутренняя грань непосредственно за примером: форма слегка отличается, плоскости параллельны, между ними малая толщина материала. -3. Внутренняя грань у найденного наружного аналога: более опосредованная связь с исходным примером. -4. Остальные приближённые аналоги — по ослаблению геометрического соответствия. +The example is an outer end face of a wall. Expected sequence: -Эти номера описывают порядок групп, а не обещают одинаковое число на ползунке для каждой детали. Равноправные кандидаты включаются вместе. В данном примере пользователь различает прямую пару стенки и пару найденного аналога; это различие нельзя стирать одной суммой площади и угла. +1. The same outer face on the other side of the body: shape and size match despite changed position and orientation. +2. The inner face directly behind the example: shape differs slightly, planes are parallel, and a small material thickness lies between them. +3. The inner face at the found outer analogue: a more indirect relationship to the original example. +4. Remaining approximate analogues, in order of weakening geometric correspondence. -Слишком простые правила дают ошибки: «ближайшая» может оказаться фаской, «тот же периметр» — другой фигурой, «тот же радиус» — валом вместо отверстия, «ближе нормаль» — дальней поперечной стенкой вместо ближней параллельной. +These numbers describe group order, not a promise of the same slider count for every part. Equivalent candidates are included together. In this example the user distinguishes the direct wall pair from the found analogue's pair; that distinction must not be erased by one sum of area and angle. -## Три источника свидетельств +Overly simple rules fail: the nearest face can be a chamfer, the same perimeter can describe another shape, the same radius can describe a shaft instead of a hole, and a closer normal can indicate a distant transverse wall rather than a nearby parallel wall. -| Источник | Что учитываем | Какую ошибку предотвращаем | +## Three sources of evidence + +| Source | Considered evidence | Error prevented | | --- | --- | --- | -| Собственная геометрия | Тип поверхности/кривой, размер, обрезанный контур, петли, радиусы, последовательность участков границы | Совпадение площади и периметра разных фигур | -| Связь с примерами | Параллельность, смещение плоскостей, перекрытие проекций, отражение/поворот/перенос, общая ось | Потерю парной стенки и симметричного аналога | -| Окружение | Типы и углы соседних поверхностей, выпуклость, вогнутость, толщина материала, повтор структуры | Вал вместо отверстия, случайная плоскость вместо фаски | +| Intrinsic geometry | Surface/curve type, size, trimmed contour, loops, radii, boundary-segment sequence | Equal area and perimeter of different shapes | +| Relationship to examples | Parallelism, plane offset, projected overlap, reflection/rotation/translation, common axis | Missing a paired wall or symmetric analogue | +| Context | Neighboring surface types and angles, convexity, concavity, material thickness, structural repetition | Shaft instead of hole, random plane instead of chamfer | -Дешёвые признаки сначала отбирают кандидатов; более точная проверка подтверждает конкретную связь. Отсутствующий признак — неизвестность, а не совпадение. История построения может подтвердить гипотезу, но импортированный STEP должен оставаться полноценным случаем. +Cheap features first select candidates; a more precise check confirms a particular relationship. A missing feature means unknown, not a match. Construction history can support a hypothesis, but imported STEP must remain a first-class case. -## Семейства намерений +## Intent families -| Намерение | Доказательства | Недостаточные признаки | +| Intent | Evidence | Insufficient features | | --- | --- | --- | -| Такая же форма и размер | Соответствие границ в локальных координатах с учётом переноса/поворота/отражения, петли и размеры | Только площадь, периметр или число рёбер | -| Другая сторона стенки | Совпадающие оси нормалей, малое нормальное смещение, достаточное перекрытие, подтверждённый материал между поверхностями | Евклидова близость центров, один угол | -| Симметричный/повторённый элемент | Подтверждённая форма и согласованное преобразование, поддержанное несколькими элементами/окружением | Равное удаление от центра bounding box | -| Такое же направление | Общая ось рёбер или нормалей; направленная нормаль — отдельное явное уточнение | Случайная нормаль кривой поверхности | -| Такой же размер | Длина, площадь либо радиус с подходящим контекстом | Один общий скаляр при несовместимом типе | -| Та же роль в детали | Сходство локального окружения: отверстие, скругление, фаска | Название feature или единственный цилиндр | +| Same shape and size | Boundary correspondence in local coordinates under translation/rotation/reflection, loops and dimensions | Area, perimeter or edge count alone | +| Other side of a wall | Coincident normal axes, small normal offset, sufficient overlap, verified material between surfaces | Euclidean center proximity, one angle | +| Symmetric/repeated feature | Verified shape and a consistent transformation supported by several elements/context | Equal distance from bounding-box center | +| Same direction | Common edge or normal axis; directed normal is a separate explicit refinement | An arbitrary normal on a curved surface | +| Same size | Length, area or radius with suitable context | One shared scalar with an incompatible type | +| Same role in the part | Similar local context: hole, fillet, chamfer | Feature name or a single cylinder | -Для рёбер используются аналогичные связи: одинаковая кривая и длина; соответствующие кромки парных стенок; одинаковая роль между соседними гранями. Касательная цепь и графовое соседство остаются отдельными операциями, не подменяют похожесть. +Edges use analogous relationships: same curve and length; corresponding edges of paired walls; same role between neighboring faces. Tangent chains and graph adjacency remain separate operations and do not replace similarity. -## Как распознать пару стенки +## Recognizing a wall pair -Для плоских граней угол осей считается как `acos(abs(dot(n1, n2)))`. Разворот наружной нормали на 180° сам по себе не ухудшает сходство. Направленные нормали сохраняются для проверки материала и явного Orientation. +For planar faces, axis angle is `acos(abs(dot(n1, n2)))`. Reversing the outward normal by 180° alone does not reduce similarity. Directed normals are retained for material checks and explicit Orientation. -Далее проверяются: +Then check: -1. Нормальный зазор между плоскостями, нормированный на локальный размер. Абсолютная толщина в миллиметрах не задаётся универсально для всех деталей. -2. Перекрытие обрезанных областей после проекции. Допускаются ожидаемые изменения от фасок и скруглений; небольшая случайная площадка не считается парой большой стены. -3. Материал между поверхностями: несколько проверок внутри области перекрытия должны подтвердить локальную стенку. Через пустую полость не образуется пара стенки. Граничные и неопределённые пробы не считаются подтверждением. -4. Согласованность с локальным окружением и другими оценками толщины. Противоречие понижает гипотезу, а не скрывается увеличением допуска. +1. Normal gap between planes, normalized to local size. No universal absolute thickness in millimeters is imposed on every part. +2. Projected overlap of trimmed regions. Expected changes from chamfers and fillets are allowed; a small incidental patch is not paired with a large wall. +3. Material between surfaces: several samples inside the overlap must confirm a local wall. A wall pair is not formed across an empty cavity. Boundary and uncertain samples do not count as confirmation. +4. Consistency with local context and other thickness estimates. Contradictions lower the hypothesis rather than being hidden by increasing tolerance. -Расстояние — уточнение внутри подходящего класса связи. Очень близкая грань другой формы не обгоняет подтверждённый аналог формы на другом конце тела. Центроид не используется как доказательство зазора, перекрытия или толщины. +Distance refines a suitable relationship class. A very close face of another shape does not outrank a verified shape analogue at the other end of the body. A centroid is not evidence of gap, overlap, or thickness. -## Как выбрать смысл без меню критериев +## Choosing meaning without a criteria menu -На запуске формируются несколько проверяемых гипотез из таблицы. Каждая хранит: какое отношение она предполагает, какие примеры объясняет, какие исключения нарушает, подтверждающие признаки и недостающие проверки. +At startup, several testable hypotheses from the table are formed. Each records its proposed relationship, examples explained, exclusions violated, supporting features, and missing checks. -Порядок сравнения гипотез: +Compare hypotheses in this order: -1. Соблюдение области, типа и явной обратной связи. -2. Объяснение всех примеров без противоречий. -3. Сила геометрического доказательства и отделение исключений. -4. Специфичность: предпочтение точной форме/роли перед общим «все плоскости». -5. Минимум произвольных допущений; продуктовый приоритет точного аналога формы при одном примере. +1. Compliance with scope, type, and explicit feedback. +2. Explanation of all examples without contradictions. +3. Strength of geometric evidence and separation of exclusions. +4. Specificity: prefer exact shape/role over a general “all planes.” +5. Minimal arbitrary assumptions; product priority for an exact shape analogue with one example. -Нельзя компенсировать нарушение исключения хорошим средним баллом. Нельзя назвать достоверной форму, для которой проверены только площадь и периметр. Внутри одного класса доказательств можно использовать нормированную числовую оценку; единого глобального взвешенного среднего для всех отношений недостаточно. +A good average score cannot compensate for violating an exclusion. A shape cannot be called verified when only area and perimeter were checked. A normalized numeric score can be used within one evidence class; one global weighted average for all relationships is insufficient. -Второй пример — свидетельство о связи, а не просто причина удалить каждый различающийся признак. Например, наружная и внутренняя грани поддерживают намерение «стороны одной стенки»; два разных по длине параллельных ребра поддерживают «направление». Если нет общего объяснения, инструмент сохраняет примеры и предлагает уточнить. Несвязанные плоские примеры могут задавать объединение семейств, если каждый кандидат подтверждён полным контуром одного из примеров. Потеря размера и формы с переходом к выбору всех параллельных стенок недопустима. +A second example is evidence about a relationship, not merely a reason to discard every differing feature. For example, outer and inner faces support “sides of one wall”; two parallel edges of different lengths support “direction.” Without a common explanation, retain examples and ask for refinement. Disconnected planar examples can define a union of families if each candidate is verified by one example's full contour. Losing size and shape and switching to all parallel walls is unacceptable. -## Как получить одно ранжирование всех элементов +## Producing one ranking of all elements -После интерпретации обратной связи каждому кандидату назначается лучшее подтверждённое объяснение относительно **явных примеров**. Порядок задаётся классом отношения, качеством соответствия, прямотой связи и уместной локальной метрикой. Продуктовый порядок по умолчанию: +After interpreting feedback, each candidate receives its best verified explanation relative to **explicit examples**. Order is determined by relationship class, match quality, directness, and an appropriate local metric. Default product order: -1. Подтверждённые аналоги формы/размера, независимо от положения. -2. Подтверждённые непосредственные пары стенок примеров. -3. Подтверждённые связанные аналоги, например внутренняя сторона аналога из первой группы. -4. Приближённые аналоги с ослаблением формы/размера и контекста. -5. Остальные допустимые элементы с явно слабым либо неизвестным соответствием. +1. Verified shape/size analogues, regardless of position. +2. Verified direct wall pairs of examples. +3. Verified related analogues, such as the inner side of an analogue in the first group. +4. Approximate analogues with weaker shape/size and contextual correspondence. +5. Other permitted elements with explicitly weak or unknown correspondence. -Группы 1–3 не получают сильный статус без соответствующих проверок. При недостающих данных кандидат остаётся в приближённой группе. Для явного намерения, например Direction, порядок строится по нему; универсальная лестница формы не отменяет выбор пользователя. +Groups 1–3 do not receive strong status without the corresponding checks. With missing data, a candidate remains approximate. For an explicit intent such as Direction, ranking follows it; the general shape ladder does not override the user's choice. -Все сущности исходного типа получают место, включая исключения с запретом включения. Неотличимые доказательства образуют общий уровень; tempId не используется для придумывания геометрического порядка. PgUp/PgDown меняют только границу уже построенного ранжирования. Ранжирование перестраивается после примера, исключения или явного критерия, а не при вращении камеры. +Every entity of the source type receives a place, including exclusions marked ineligible for inclusion. Indistinguishable evidence forms one level; tempId is not used to invent geometric order. PgUp/PgDown change only the boundary of an existing ranking. Ranking is rebuilt after an example, exclusion, or explicit criterion, not when the camera rotates. -Вложенность обязательна: расширение сохраняет уже включённое. Найденные элементы не становятся новыми примерами; прямую связь с примером и связь через найденный аналог различаем явно. Транзитивные цепочки не запускают бесконтрольное распространение. Максимальный диапазон включает все не исключённые элементы типа; сообщение о широком диапазоне объясняет его смысл. +Nesting is mandatory: expansion retains what is already included. Found elements do not become new examples; a direct relationship to an example and a relationship through a found analogue are explicitly distinguished. Transitive chains do not cause uncontrolled propagation. Maximum range includes all non-excluded elements of the type; a message explains the meaning of a broad range. -## Обратная связь и объяснение +## Feedback and explanation -Главный интерфейс сохраняется: Examples, Exclude, диапазон, OK. Короткий статус описывает текущее основание: «Такая же форма», «Добавлена внутренняя сторона стенки» или «Общие размеры; форма не подтверждена». Не показывать пользователю сырой набор весов и процентов уверенности. +The primary interface remains Examples, Exclude, range, and OK. A short status describes the current basis: “Same shape,” “Added the inner wall side,” or “Shared dimensions; shape not verified.” Do not show raw weights and confidence percentages. -Добавление примера поддерживает гипотезы, которые объясняют его совместно с остальными. Исключение запрещает элемент и снижает гипотезы, которые включали бы его по тому же основанию. Геометрически неразличимые пример и исключение дают честное сообщение об ограничении. +Adding an example supports hypotheses that explain it together with the others. An exclusion prohibits the element and weakens hypotheses that would include it on the same basis. A geometrically indistinguishable example and exclusion produce an honest limitation message. -Если две гипотезы дают одинаковый результат, пользователь не должен выбирать между их названиями. Если результаты расходятся и доказательств мало, показать небольшой обоснованный набор, а один дополнительный пример или исключение использовать как уточнение. Обязательного вопросника нет. +If two hypotheses produce the same result, users should not have to choose between their names. If results diverge and evidence is weak, show a small justified set and use one additional example or exclusion for refinement. No mandatory questionnaire is required. -PgDown означает «этот диапазон слишком широк»; он не превращает все убранные грани в отрицательные примеры. PgUp также не означает одобрение каждого добавленного элемента как образца. OK подтверждает набор для этой команды и сам по себе не обучает глобальные привычки пользователя. +PgDown means “this range is too broad”; it does not turn every removed face into a negative example. PgUp likewise does not endorse each added element as an example. OK confirms the set for this command and does not by itself train global user habits. -## Архитектура реализации +## Implementation architecture -Четыре независимых слоя: снимок геометрии → проверка отношений → оценка гипотез намерения → стабильные уровни выбора. Нативный UI получает только уровни, объяснение и состояние неоднозначности. +Four independent layers: geometry snapshot → relationship checks → intent-hypothesis evaluation → stable selection levels. Native UI receives only levels, explanation, and ambiguity state. -Для каждого отношения нужны тип, источники-примеры, целевой элемент, качество доказательства, измеренные ошибки и причина отказа/неопределённости. Объяснения хранятся структурно; их нельзя восстанавливать постфактум из одного числа. +Each relationship requires type, source examples, target, evidence quality, measured errors, and reason for rejection/uncertainty. Explanations are stored structurally and cannot be reconstructed afterward from one number. -Ограничения времени/числа проверок не дают права объявить непроверенных кандидатов точными. Дешёвая стадия даёт быстрый черновой набор; точная стадия завершается атомарно и не меняет границу под руками пользователя. При превышении бюджета — явный неполный анализ и блокировка применения непроверенного результата. Геометрия и таймлайн не меняются. +Time/check-count limits do not permit calling unchecked candidates exact. A cheap stage yields a fast preliminary set; the exact stage completes atomically and does not move the range under the user. On budget exhaustion, report incomplete analysis explicitly and block applying unchecked results. Geometry and timeline do not change. -## Корпус и критерии качества +## Corpus and quality criteria -| Сценарий | Обязательный ожидаемый порядок/отказ | +| Scenario | Required order/refusal | | --- | --- | -| Пользовательская тонкая стенка | Аналог наружной грани → внутренняя пара примера → внутренняя пара аналога | -| Далёкий точный аналог и близкая фаска | Аналог раньше фаски | -| Равный периметр, разная форма | Не объявлять точным аналогом | -| Две параллельные стенки через полость | Не объявлять парой материала | -| Узкая фаска вплотную к примеру | Близость не доказывает пару стенки | -| Одинаковые отверстие и вал по радиусу | Разделять подтверждённой ролью, иначе сообщать недостаток данных | -| Повернутый/зеркальный повтор | Сохранить аналог формы при смене нормалей | -| Два размерных семейства | Не расширять до всех сущностей из-за потери общих признаков | -| Полностью равноправные элементы | Один уровень, порядок tempId не влияет | -| Поворот/перенос всей модели, другая камера | Сохранить семантическое ранжирование | -| Идентичное соседнее тело | Ни один его элемент не включён | +| User's thin wall | Outer-face analogue → example's inner pair → analogue's inner pair | +| Distant exact analogue and nearby chamfer | Analogue before chamfer | +| Equal perimeter, different shape | Do not call it an exact analogue | +| Two parallel walls across a cavity | Do not call them a material pair | +| Narrow chamfer next to example | Proximity does not prove a wall pair | +| Hole and shaft with equal radii | Separate by verified role or report insufficient data | +| Rotated/mirrored repetition | Retain shape analogue when normals change | +| Two dimensional families | Do not expand to all entities after losing shared features | +| Fully equivalent elements | One level; tempId order has no effect | +| Rotated/translated model, different camera | Preserve semantic ranking | +| Identical neighboring body | Include none of its elements | -На размеченном корпусе оценивать: правильность первой группы; число PgUp/уточнений до целевого набора; лишние/пропущенные элементы; корректность пары стенки; устойчивость порядка после несущественных изменений; p50/p95 времени чтения, анализа и подсветки раздельно. Варианты одной детали не должны попадать одновременно в обучающую и контрольную группы. Проценты точности и вероятности намерения не заявлять до такого измерения. +On a labeled corpus, measure first-group correctness; PgUp/refinement count to reach the target set; extra/missed elements; wall-pair correctness; ranking stability after insignificant changes; and p50/p95 read, analysis, and highlighting times separately. Variants of one part must not appear in both training and control groups. Do not claim accuracy percentages or intent probabilities before such measurement. -## Порядок внедрения +## Implementation order -1. Сохранить регрессию текущей ошибки нормалей. Уже сделано: Automatic сравнивает ось нормали с меньшим весом, явный Orientation остаётся направленным. Это локальная поправка, не полный распознаватель стенок. -2. Добавить проверяемую сигнатуру обрезанного контура и соответствие формы с переносом/поворотом/отражением. Не опираться только на скаляры. -3. Извлекать положение плоскостей и локальную геометрию; реализовать перекрытие, зазор и проверку материала для пары стенки. -4. Ввести отношения/гипотезы/объяснения и заменить глобальное смешивание признаков сравнением классов доказательств. -5. Добавить симметрию и повтор, затем роли отверстий/скруглений/фасок с собственными отрицательными примерами. -6. Пройти размеченный корпус и нативную CAD-приёмку до заявления об автоматическом понимании намерения. +1. Preserve regression coverage for the current normal error. Already done: Automatic compares the normal axis with lower weight; explicit Orientation remains directed. This is a local fix, not a complete wall recognizer. +2. Add a testable trimmed-boundary signature and shape correspondence under translation/rotation/reflection. Do not rely only on scalars. +3. Extract plane positions and local geometry; implement overlap, gap, and material checks for a wall pair. +4. Introduce relationships/hypotheses/explanations and replace global feature mixing with comparison of evidence classes. +5. Add symmetry and repetition, then hole/fillet/chamfer roles with their own negative examples. +6. Complete the labeled corpus and native CAD acceptance before claiming automatic intent understanding. -## Уточнение порядка плоскостей, 25.10.2026 +## Plane ordering clarification, 25 October 2026 -Внутри каждого семейства формы/размера Automatic разделяет совпадение плоскости, параллельные плоскости и остальные плоскости на последовательные уровни. Это применено и к окружностям/дугам: одинаковый радиус отверстия не объединяет сразу его наружную и внутреннюю кромки. Проверяется мировая опорная плоскость, а не глубина на экране. Неизвестные плоскости идут последними внутри семейства. Дополнительные явные примеры расширяют набор опорных плоскостей. +Within each shape/size family, Automatic separates matching, parallel, and other planes into sequential levels. This applies to circles/arcs as well: equal hole radius does not immediately group its outer and inner edges. The world support plane is checked, not screen depth. Unknown planes come last within the family. Additional explicit examples expand the set of support planes. -## Криволинейные стороны паза, 26.10.2026 +## Curved slot sides, 26 October 2026 -Несколько выбранных внутренних граней паза могут образовывать несколько связных частей на разных телах. Каждый связный образец ищется как целая группа с сохранением геометрии и смежности. Поддержка цилиндрических/NURBS-поверхностей использует дискретную проверку обрезанной поверхности, общей трансформации и нормалей. Это отдельное свидетельство формы, а не вывод по площади. Порядок плоскостей применяется к целой группе по уровню экструзии, чтобы части одного паза не разрывались между шагами. +Several selected inner slot faces can form several connected parts on different bodies. Each connected example is sought as a complete group with geometry and adjacency preserved. Cylindrical/NURBS support uses a discrete check of the trimmed surface, common transformation, and normals. This is separate shape evidence, not an inference from area. Plane order applies to the whole group by extrusion level so parts of one slot are not split across steps. diff --git a/docs/INTENT_MODEL.ru.md b/docs/INTENT_MODEL.ru.md new file mode 100644 index 0000000..047b50f --- /dev/null +++ b/docs/INTENT_MODEL.ru.md @@ -0,0 +1,147 @@ +# Модель предсказания выбора Selectra + +[English](INTENT_MODEL.md) + +Статус: спецификация с частичным внедрением 25.10.2026. Планарные полигональные аналоги, локальные пары стенок, общая геометрия повторов и нативные группы внедрены; объём проверки и ограничения — в [EVALUATION.md](EVALUATION.md). Свободные поверхности, роли отверстий/валов и полная матрица ниже ещё не реализованы. Алгоритм — в [RANKING.md](RANKING.md), термины — в [GLOSSARY.md](../GLOSSARY.ru.md). + +## Что предсказываем + +Уточнение области от 25.10.2026: Search Scope предлагает This Body / This Component / All Components, по умолчанию This Component с вложенными экземплярами выбранного компонента. Упоминания исходного тела ниже описывают границы графовых/материальных отношений и режим This Body; соответствие формы может искаться между телами выбранной области. Каноническая семантика — [UX.md](UX.ru.md). + +Пользователь выбирает элементы как часть задачи: обработать одинаковые кромки, найти парные стороны стенки, выбрать повторяющиеся отверстия. Selectra оценивает несколько возможных оснований такого выбора и строит один понятный порядок расширения. + +Обязательный контракт: только исходное тело, тот же тип сущностей, все явные примеры в результате, все исключения вне результата. Ни предполагаемая симметрия, ни повтор не расширяют область на соседнее тело. Признаки камеры, видимости и расстояния на экране не определяют геометрическое сходство. + +## Контрольный сценарий: тонкая стенка + +Пример — наружная торцевая грань стенки. Ожидаемая последовательность: + +1. Такая же наружная грань на другой стороне тела: совпадает форма и размер, хотя меняются положение и ориентация. +2. Внутренняя грань непосредственно за примером: форма слегка отличается, плоскости параллельны, между ними малая толщина материала. +3. Внутренняя грань у найденного наружного аналога: более опосредованная связь с исходным примером. +4. Остальные приближённые аналоги — по ослаблению геометрического соответствия. + +Эти номера описывают порядок групп, а не обещают одинаковое число на ползунке для каждой детали. Равноправные кандидаты включаются вместе. В данном примере пользователь различает прямую пару стенки и пару найденного аналога; это различие нельзя стирать одной суммой площади и угла. + +Слишком простые правила дают ошибки: «ближайшая» может оказаться фаской, «тот же периметр» — другой фигурой, «тот же радиус» — валом вместо отверстия, «ближе нормаль» — дальней поперечной стенкой вместо ближней параллельной. + +## Три источника свидетельств + +| Источник | Что учитываем | Какую ошибку предотвращаем | +| --- | --- | --- | +| Собственная геометрия | Тип поверхности/кривой, размер, обрезанный контур, петли, радиусы, последовательность участков границы | Совпадение площади и периметра разных фигур | +| Связь с примерами | Параллельность, смещение плоскостей, перекрытие проекций, отражение/поворот/перенос, общая ось | Потерю парной стенки и симметричного аналога | +| Окружение | Типы и углы соседних поверхностей, выпуклость, вогнутость, толщина материала, повтор структуры | Вал вместо отверстия, случайная плоскость вместо фаски | + +Дешёвые признаки сначала отбирают кандидатов; более точная проверка подтверждает конкретную связь. Отсутствующий признак — неизвестность, а не совпадение. История построения может подтвердить гипотезу, но импортированный STEP должен оставаться полноценным случаем. + +## Семейства намерений + +| Намерение | Доказательства | Недостаточные признаки | +| --- | --- | --- | +| Такая же форма и размер | Соответствие границ в локальных координатах с учётом переноса/поворота/отражения, петли и размеры | Только площадь, периметр или число рёбер | +| Другая сторона стенки | Совпадающие оси нормалей, малое нормальное смещение, достаточное перекрытие, подтверждённый материал между поверхностями | Евклидова близость центров, один угол | +| Симметричный/повторённый элемент | Подтверждённая форма и согласованное преобразование, поддержанное несколькими элементами/окружением | Равное удаление от центра bounding box | +| Такое же направление | Общая ось рёбер или нормалей; направленная нормаль — отдельное явное уточнение | Случайная нормаль кривой поверхности | +| Такой же размер | Длина, площадь либо радиус с подходящим контекстом | Один общий скаляр при несовместимом типе | +| Та же роль в детали | Сходство локального окружения: отверстие, скругление, фаска | Название feature или единственный цилиндр | + +Для рёбер используются аналогичные связи: одинаковая кривая и длина; соответствующие кромки парных стенок; одинаковая роль между соседними гранями. Касательная цепь и графовое соседство остаются отдельными операциями, не подменяют похожесть. + +## Как распознать пару стенки + +Для плоских граней угол осей считается как `acos(abs(dot(n1, n2)))`. Разворот наружной нормали на 180° сам по себе не ухудшает сходство. Направленные нормали сохраняются для проверки материала и явного Orientation. + +Далее проверяются: + +1. Нормальный зазор между плоскостями, нормированный на локальный размер. Абсолютная толщина в миллиметрах не задаётся универсально для всех деталей. +2. Перекрытие обрезанных областей после проекции. Допускаются ожидаемые изменения от фасок и скруглений; небольшая случайная площадка не считается парой большой стены. +3. Материал между поверхностями: несколько проверок внутри области перекрытия должны подтвердить локальную стенку. Через пустую полость не образуется пара стенки. Граничные и неопределённые пробы не считаются подтверждением. +4. Согласованность с локальным окружением и другими оценками толщины. Противоречие понижает гипотезу, а не скрывается увеличением допуска. + +Расстояние — уточнение внутри подходящего класса связи. Очень близкая грань другой формы не обгоняет подтверждённый аналог формы на другом конце тела. Центроид не используется как доказательство зазора, перекрытия или толщины. + +## Как выбрать смысл без меню критериев + +На запуске формируются несколько проверяемых гипотез из таблицы. Каждая хранит: какое отношение она предполагает, какие примеры объясняет, какие исключения нарушает, подтверждающие признаки и недостающие проверки. + +Порядок сравнения гипотез: + +1. Соблюдение области, типа и явной обратной связи. +2. Объяснение всех примеров без противоречий. +3. Сила геометрического доказательства и отделение исключений. +4. Специфичность: предпочтение точной форме/роли перед общим «все плоскости». +5. Минимум произвольных допущений; продуктовый приоритет точного аналога формы при одном примере. + +Нельзя компенсировать нарушение исключения хорошим средним баллом. Нельзя назвать достоверной форму, для которой проверены только площадь и периметр. Внутри одного класса доказательств можно использовать нормированную числовую оценку; единого глобального взвешенного среднего для всех отношений недостаточно. + +Второй пример — свидетельство о связи, а не просто причина удалить каждый различающийся признак. Например, наружная и внутренняя грани поддерживают намерение «стороны одной стенки»; два разных по длине параллельных ребра поддерживают «направление». Если нет общего объяснения, инструмент сохраняет примеры и предлагает уточнить. Несвязанные плоские примеры могут задавать объединение семейств, если каждый кандидат подтверждён полным контуром одного из примеров. Потеря размера и формы с переходом к выбору всех параллельных стенок недопустима. + +## Как получить одно ранжирование всех элементов + +После интерпретации обратной связи каждому кандидату назначается лучшее подтверждённое объяснение относительно **явных примеров**. Порядок задаётся классом отношения, качеством соответствия, прямотой связи и уместной локальной метрикой. Продуктовый порядок по умолчанию: + +1. Подтверждённые аналоги формы/размера, независимо от положения. +2. Подтверждённые непосредственные пары стенок примеров. +3. Подтверждённые связанные аналоги, например внутренняя сторона аналога из первой группы. +4. Приближённые аналоги с ослаблением формы/размера и контекста. +5. Остальные допустимые элементы с явно слабым либо неизвестным соответствием. + +Группы 1–3 не получают сильный статус без соответствующих проверок. При недостающих данных кандидат остаётся в приближённой группе. Для явного намерения, например Direction, порядок строится по нему; универсальная лестница формы не отменяет выбор пользователя. + +Все сущности исходного типа получают место, включая исключения с запретом включения. Неотличимые доказательства образуют общий уровень; tempId не используется для придумывания геометрического порядка. PgUp/PgDown меняют только границу уже построенного ранжирования. Ранжирование перестраивается после примера, исключения или явного критерия, а не при вращении камеры. + +Вложенность обязательна: расширение сохраняет уже включённое. Найденные элементы не становятся новыми примерами; прямую связь с примером и связь через найденный аналог различаем явно. Транзитивные цепочки не запускают бесконтрольное распространение. Максимальный диапазон включает все не исключённые элементы типа; сообщение о широком диапазоне объясняет его смысл. + +## Обратная связь и объяснение + +Главный интерфейс сохраняется: Examples, Exclude, диапазон, OK. Короткий статус описывает текущее основание: «Такая же форма», «Добавлена внутренняя сторона стенки» или «Общие размеры; форма не подтверждена». Не показывать пользователю сырой набор весов и процентов уверенности. + +Добавление примера поддерживает гипотезы, которые объясняют его совместно с остальными. Исключение запрещает элемент и снижает гипотезы, которые включали бы его по тому же основанию. Геометрически неразличимые пример и исключение дают честное сообщение об ограничении. + +Если две гипотезы дают одинаковый результат, пользователь не должен выбирать между их названиями. Если результаты расходятся и доказательств мало, показать небольшой обоснованный набор, а один дополнительный пример или исключение использовать как уточнение. Обязательного вопросника нет. + +PgDown означает «этот диапазон слишком широк»; он не превращает все убранные грани в отрицательные примеры. PgUp также не означает одобрение каждого добавленного элемента как образца. OK подтверждает набор для этой команды и сам по себе не обучает глобальные привычки пользователя. + +## Архитектура реализации + +Четыре независимых слоя: снимок геометрии → проверка отношений → оценка гипотез намерения → стабильные уровни выбора. Нативный UI получает только уровни, объяснение и состояние неоднозначности. + +Для каждого отношения нужны тип, источники-примеры, целевой элемент, качество доказательства, измеренные ошибки и причина отказа/неопределённости. Объяснения хранятся структурно; их нельзя восстанавливать постфактум из одного числа. + +Ограничения времени/числа проверок не дают права объявить непроверенных кандидатов точными. Дешёвая стадия даёт быстрый черновой набор; точная стадия завершается атомарно и не меняет границу под руками пользователя. При превышении бюджета — явный неполный анализ и блокировка применения непроверенного результата. Геометрия и таймлайн не меняются. + +## Корпус и критерии качества + +| Сценарий | Обязательный ожидаемый порядок/отказ | +| --- | --- | +| Пользовательская тонкая стенка | Аналог наружной грани → внутренняя пара примера → внутренняя пара аналога | +| Далёкий точный аналог и близкая фаска | Аналог раньше фаски | +| Равный периметр, разная форма | Не объявлять точным аналогом | +| Две параллельные стенки через полость | Не объявлять парой материала | +| Узкая фаска вплотную к примеру | Близость не доказывает пару стенки | +| Одинаковые отверстие и вал по радиусу | Разделять подтверждённой ролью, иначе сообщать недостаток данных | +| Повернутый/зеркальный повтор | Сохранить аналог формы при смене нормалей | +| Два размерных семейства | Не расширять до всех сущностей из-за потери общих признаков | +| Полностью равноправные элементы | Один уровень, порядок tempId не влияет | +| Поворот/перенос всей модели, другая камера | Сохранить семантическое ранжирование | +| Идентичное соседнее тело | Ни один его элемент не включён | + +На размеченном корпусе оценивать: правильность первой группы; число PgUp/уточнений до целевого набора; лишние/пропущенные элементы; корректность пары стенки; устойчивость порядка после несущественных изменений; p50/p95 времени чтения, анализа и подсветки раздельно. Варианты одной детали не должны попадать одновременно в обучающую и контрольную группы. Проценты точности и вероятности намерения не заявлять до такого измерения. + +## Порядок внедрения + +1. Сохранить регрессию текущей ошибки нормалей. Уже сделано: Automatic сравнивает ось нормали с меньшим весом, явный Orientation остаётся направленным. Это локальная поправка, не полный распознаватель стенок. +2. Добавить проверяемую сигнатуру обрезанного контура и соответствие формы с переносом/поворотом/отражением. Не опираться только на скаляры. +3. Извлекать положение плоскостей и локальную геометрию; реализовать перекрытие, зазор и проверку материала для пары стенки. +4. Ввести отношения/гипотезы/объяснения и заменить глобальное смешивание признаков сравнением классов доказательств. +5. Добавить симметрию и повтор, затем роли отверстий/скруглений/фасок с собственными отрицательными примерами. +6. Пройти размеченный корпус и нативную CAD-приёмку до заявления об автоматическом понимании намерения. + +## Уточнение порядка плоскостей, 25.10.2026 + +Внутри каждого семейства формы/размера Automatic разделяет совпадение плоскости, параллельные плоскости и остальные плоскости на последовательные уровни. Это применено и к окружностям/дугам: одинаковый радиус отверстия не объединяет сразу его наружную и внутреннюю кромки. Проверяется мировая опорная плоскость, а не глубина на экране. Неизвестные плоскости идут последними внутри семейства. Дополнительные явные примеры расширяют набор опорных плоскостей. + +## Криволинейные стороны паза, 26.10.2026 + +Несколько выбранных внутренних граней паза могут образовывать несколько связных частей на разных телах. Каждый связный образец ищется как целая группа с сохранением геометрии и смежности. Поддержка цилиндрических/NURBS-поверхностей использует дискретную проверку обрезанной поверхности, общей трансформации и нормалей. Это отдельное свидетельство формы, а не вывод по площади. Порядок плоскостей применяется к целой группе по уровню экструзии, чтобы части одного паза не разрывались между шагами. diff --git a/docs/PRODUCT.ru.md b/docs/PRODUCT.ru.md index 8d2cf97..a3dd2f5 100644 --- a/docs/PRODUCT.ru.md +++ b/docs/PRODUCT.ru.md @@ -8,7 +8,7 @@ **Область поиска уточнена пользователем 25.10.2026:** This Body, This Component (по умолчанию), All Components. This Component включает вложенную иерархию выбранного экземпляра; All Components — всю видимую сборку. Примеры и исключения лежат в выбранной области. Область не расширяется неявно; её переключение видно в диалоге. Каноническая семантика — [UX.md](UX.ru.md). -Актуальный сценарий и элементы интерфейса: [UX.md](UX.ru.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. +Актуальный сценарий и элементы интерфейса: [UX.md](UX.ru.md). Целевая модель вывода намерения: [INTENT_MODEL.md](INTENT_MODEL.ru.md). PgUp/PgDown управляют ранжированным сходством; графовое соседство остаётся отдельной операцией. ## Основной сценарий diff --git a/docs/UX.ru.md b/docs/UX.ru.md index b9563ef..51c7233 100644 --- a/docs/UX.ru.md +++ b/docs/UX.ru.md @@ -6,7 +6,7 @@ Покажи пример — получи похожие элементы в выбранной области. По умолчанию это компонент примера вместе с вложенной иерархией. Инструмент начинает с разумного предложения и даёт уточнить его по результату, не заставляя сначала выбирать технический критерий. -Ориентир — скорость выделения Blender. Особенности Selectra: аналитическая CAD-геометрия, автоматический подбор общих признаков, обучение по дополнительным примерам и исключениям, ранжированный диапазон. Целевая модель геометрических отношений и намерений — [INTENT_MODEL.md](INTENT_MODEL.md); ниже описан интерфейс и текущее поведение. +Ориентир — скорость выделения Blender. Особенности Selectra: аналитическая CAD-геометрия, автоматический подбор общих признаков, обучение по дополнительным примерам и исключениям, ранжированный диапазон. Целевая модель геометрических отношений и намерений — [INTENT_MODEL.md](INTENT_MODEL.ru.md); ниже описан интерфейс и текущее поведение. ## Основной путь From cb61eb263c83242e2c82916b6fbd959aad247207 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:27:39 +0300 Subject: [PATCH 09/14] docs: provide bilingual ranking specification --- docs/INTENT_MODEL.ru.md | 2 +- docs/RANKING.md | 69 +++++++++++++++++++++-------------------- docs/RANKING.ru.md | 64 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 100 insertions(+), 35 deletions(-) create mode 100644 docs/RANKING.ru.md diff --git a/docs/INTENT_MODEL.ru.md b/docs/INTENT_MODEL.ru.md index 047b50f..746b42d 100644 --- a/docs/INTENT_MODEL.ru.md +++ b/docs/INTENT_MODEL.ru.md @@ -2,7 +2,7 @@ [English](INTENT_MODEL.md) -Статус: спецификация с частичным внедрением 25.10.2026. Планарные полигональные аналоги, локальные пары стенок, общая геометрия повторов и нативные группы внедрены; объём проверки и ограничения — в [EVALUATION.md](EVALUATION.md). Свободные поверхности, роли отверстий/валов и полная матрица ниже ещё не реализованы. Алгоритм — в [RANKING.md](RANKING.md), термины — в [GLOSSARY.md](../GLOSSARY.ru.md). +Статус: спецификация с частичным внедрением 25.10.2026. Планарные полигональные аналоги, локальные пары стенок, общая геометрия повторов и нативные группы внедрены; объём проверки и ограничения — в [EVALUATION.md](EVALUATION.md). Свободные поверхности, роли отверстий/валов и полная матрица ниже ещё не реализованы. Алгоритм — в [RANKING.md](RANKING.ru.md), термины — в [GLOSSARY.md](../GLOSSARY.ru.md). ## Что предсказываем diff --git a/docs/RANKING.md b/docs/RANKING.md index f0320fe..3e92d06 100644 --- a/docs/RANKING.md +++ b/docs/RANKING.md @@ -1,62 +1,63 @@ -# Ранжирование похожести +# Similarity ranking -`ranking.py` обрабатывает неизменяемый BodySnapshot явно выбранной области. Все допустимые рёбра либо все допустимые грани этого снимка получают расстояние сходства; исключённые элементы тоже получают ранг, но помечаются blocked и не включаются в результат. При объединении тел ключи получают пространство имён; топология и свидетельства материала не пересекают границы тел. +[Русская версия](RANKING.ru.md) -## Признаки +`ranking.py` processes an immutable BodySnapshot of the explicitly selected scope. All eligible edges or all eligible faces in that snapshot receive a similarity distance; excluded elements also receive a rank but are marked blocked and are not included in the result. When bodies are combined, keys are namespaced; topology and material evidence do not cross body boundaries. -Автоматическое ранжирование плоских граней с полными контурами сначала использует геометрические отношения из `intentions.py`. Порядок: совпадающая обрезанная форма и размер → непосредственная пара стенки примера → пара найденного аналога → приближённые группы. Сравнение полигональных петель допускает одну изометрию или отражение, сохраняет размеры и взаимное размещение отверстий; площадь/периметр служат только дешёвым предварительным фильтром. Отсутствующий контур плоского примера даёт неоднозначность и стартовый уровень 0. +## Features -Пара стенки требует противоположных наружных нормалей, локального смещения, перекрытия не менее половины меньшей обрезанной области и толщины не более `0.25 * sqrt(min_area)`. Это текущая явная эвристика локальности, не универсальный закон для деталей. Adapter проверяет материал внутри каждой контрольной трассы и отсутствие промежуточных пересечений BRep. Поперёк области остаётся дискретная выборка: объёмная гарантия для всей стенки не заявляется. +Automatic ranking of planar faces with complete contours first uses geometric relationships from `intentions.py`. Order: matching trimmed shape and size → direct wall pair of the example → pair of the found analogue → approximate groups. Polygon-loop comparison permits one isometry or reflection, preserving dimensions and relative hole positions; area/perimeter are only an inexpensive preliminary filter. A planar example with a missing contour yields ambiguity and initial level 0. -Два примера противоположных сторон могут задать семейство пар: нужны обе формы, толщина и одна общая трансформация всей пары. Два или больше связанных примеров могут задать повтор узла: проверяются точный индуцированный граф и общая геометрия всех граней. Исключение отклоняет целый противоречащий узел. Широкие гипотезы параллельности/площади допустимы только при объяснении всех примеров и отделении всех исключений. Для несвязанных плоских примеров приоритетнее широких гипотез идёт объединение подтверждённых семейств формы/размера. Каждый кандидат должен совпасть с полным контуром хотя бы одного примера; равенство нормали недостаточно. Проверенные связанные узлы и пары стенок сохраняют приоритет. +A wall pair requires opposite outward normals, local offset, overlap of at least half the smaller trimmed region, and thickness no greater than `0.25 * sqrt(min_area)`. This is the current explicit locality heuristic, not a universal law for parts. The adapter checks material within each test trace and absence of intermediate BRep intersections. Sampling across the area remains discrete: no volumetric guarantee for the entire wall is claimed. -Ниже описана скалярная оценка для предварительного фильтра, приближённых групп и явных критериев. Она сама по себе не подтверждает форму. +Two examples of opposite sides can define a pair family: both shapes, thickness, and one common transformation of the whole pair are required. Two or more connected examples can define a repeated feature: the exact induced graph and common geometry of all faces are checked. An exclusion rejects an entire conflicting feature. Broad parallelism/area hypotheses are permitted only when they explain all examples and separate all exclusions. For disconnected planar examples, the union of verified shape/size families takes priority over broad hypotheses. Each candidate must match the complete contour of at least one example; equal normals are insufficient. Verified connected features and wall pairs retain priority. -Автоматические базовые веса: тип геометрии 0.8; длина/площадь 1.2; радиус 1.6; направление 1.0; ось нормали 0.2; периметр 0.7; число сторон/петель/соседних граней по 0.25; угол соседних граней 0.5. Учитываются только доступные у всех примеров признаки. Часть полей уже поддерживается ядром, но ещё не извлекается нативным adapter, например угол на общем ребре кривых поверхностей. +The scalar score below is for preliminary filtering, approximate groups, and explicit criteria. It does not by itself verify shape. -Если примеры различаются по признаку сильнее допуска, автоматический режим исключает его из обязательных общих свойств. Если признак отделяет отрицательные примеры, его вес увеличивается. Нормаль извлекается для плоских граней и плоскостей окружностей/дуг. Для плоских граней: Automatic сравнивает её ось, поэтому противоположные стороны тонкой стенки не штрафуются за угол 180°. Размер и форма имеют больший вес, чем ориентация. Явный Match → Orientation сохраняет направленную нормаль и различает 0° и 180°. Для окружностей и дуг явная Orientation сравнивает ось плоскости без знака нормали. Направление прямой осевое: смена параметризации не меняет сходство. +Automatic base weights: geometry type 0.8; length/area 1.2; radius 1.6; direction 1.0; normal axis 0.2; perimeter 0.7; side/loop/neighboring-face counts 0.25 each; neighboring-face angle 0.5. Only features available for every example are used. The kernel supports some fields not yet extracted by the native adapter, such as the angle at a shared edge of curved surfaces. -Размеры сравниваются относительно масштаба с абсолютным нижним допуском. По умолчанию относительный допуск 1%, угол 2°, длина 1e-6 cm и площадь 1e-8 cm². В пределах допуска разность обнуляется. Расстояния нормированы в [0, 1]; взвешенное среднее задаёт порядок, а не вероятность намерения. +If examples differ on a feature beyond tolerance, automatic mode excludes it from mandatory shared properties. If a feature separates negative examples, its weight increases. Normals are extracted for planar faces and circle/arc planes. For planar faces, Automatic compares the normal axis, so opposite sides of a thin wall are not penalized for 180°. Size and shape outweigh orientation. Explicit Match → Orientation retains the directed normal and distinguishes 0° and 180°. For circles and arcs, explicit Orientation compares the plane axis without normal sign. Straight-line direction is axial: changing parameterization does not change similarity. -Скалярная автоматическая дистанция проверяется относительно всех примеров. Геометрическая гипотеза независимых семейств объединяет полные совпадения с каждым отдельным примером. При явном выборе одного критерия допускается совпадение с любым примером, как объединение семейств. Совпадение простых числовых признаков не доказывает геометрическую конгруэнтность. +Dimensions are compared relative to scale with an absolute lower tolerance. Defaults are 1% relative, 2° angular, 1e-6 cm length, and 1e-8 cm² area. Differences within tolerance become zero. Distances are normalized to [0, 1]; the weighted mean defines ordering, not intent probability. -## Диапазоны +Scalar automatic distance is checked against all examples. The geometric independent-family hypothesis unions complete matches to each individual example. When one criterion is explicitly chosen, matching any example is allowed, as a union of families. Matching simple numerical features does not prove geometric congruence. -Подтверждённые геометрические отношения образуют атомарные уровни. Приближённые плоские группы используют фиксированные границы скалярной дистанции 0.02/0.10/0.25/0.50/1.0. Рёбра — 0/0.005/0.02/0.05/0.10/0.20/0.35/0.60/1.0. Так небольшие вариации размеров не создают отдельный PgUp на каждую сущность. Для оставшихся скалярных поверхностей сохраняются числовые ничьи, описанные ниже. +## Ranges -Равно похожие элементы объединяются в уровни с числовым допуском 1e-9. Включение/снятие уровня атомарно: идентификаторы не разрывают ничью. Начальный автоматический диапазон — первая непустая группа кандидатов сверх примеров при наличии информативных признаков и отсутствии неразличимого исключения. Он не остаётся на нуле из-за фиксированного числового порога. Если допустимых кандидатов нет или обратная связь противоречива, сохраняются только примеры; ближайший кандидат не объявляется доказанным аналогом формы. +Verified geometric relationships form atomic levels. Approximate planar groups use fixed scalar-distance boundaries 0.02/0.10/0.25/0.50/1.0. Edges use 0/0.005/0.02/0.05/0.10/0.20/0.35/0.60/1.0. This prevents small size variations from requiring a separate PgUp for each entity. Remaining scalar surfaces retain the numerical ties described below. -PgUp добавляет следующий уровень, PgDown удаляет самый слабый включённый. Ползунок управляет тем же целым индексом диапазона. Положительные примеры сохраняются всегда. На максимуме выбираются все не исключённые элементы исходного типа и тела. Соседство на этот порядок не влияет. +Equally similar elements are grouped into levels with numerical tolerance 1e-9. Including/removing a level is atomic: identifiers do not split ties. The initial automatic range is the first nonempty candidate group beyond the examples when informative features exist and no indistinguishable exclusion exists. It does not remain at zero because of a fixed numeric threshold. If no eligible candidates exist or feedback conflicts, only examples are retained; the nearest candidate is not called a verified shape analogue. -Новый пример, исключение или критерий пересчитывает ранги и возвращает автоматический диапазон. Изменение диапазона использует готовое ранжирование без повторного чтения BRep. Undo/Redo в ядре восстанавливает состояние уточнений; системный Undo Fusion этим не переопределяется. +PgUp adds the next level; PgDown removes the weakest included level. The slider controls the same integer range index. Positive examples are always retained. At maximum, all non-excluded elements of the original type and body are selected. Adjacency does not affect this order. -## Порядок плоскостей +A new example, exclusion, or criterion recalculates ranks and restores the automatic range. Changing range uses the prepared ranking without rereading BRep. Undo/Redo in the kernel restores refinement state; it does not override Fusion's system Undo. -В Automatic каждый уже построенный геометрический уровень дополнительно разделяется: в плоскости примера → в параллельных плоскостях → в остальных плоскостях → с неизвестной опорной плоскостью. Форма и размер остаются первичными: увеличенная копланарная окружность не опережает точную повёрнутую. Каждый непустой подкласс — отдельный шаг PgUp/PgDown или =/-. Явные Match-критерии не получают этот дополнительный фильтр. +## Plane ordering -У окружности и дуги используется собственная плоскость кривой; у остальных рёбер — доступные плоскости смежных граней. У прямого ребра их может быть несколько: достаточно общей опорной плоскости. У плоской грани используются её нормаль и положение. Параллельность проверяется по оси нормали с допуском 1e-7 rad, совпадение плоскостей — по нормальному смещению с линейным допуском снимка. Разворот нормали не создаёт отдельный шаг. Все данные переводятся в мировые координаты экземпляра; камера не участвует. +In Automatic, each already constructed geometric level is further divided: in the example plane → in parallel planes → in other planes → with an unknown support plane. Shape and size remain primary: an enlarged coplanar circle does not outrank an exact rotated circle. Each nonempty subclass is a separate PgUp/PgDown or =/- step. Explicit Match criteria do not receive this additional filter. -Несколько явных примеров задают объединение своих опорных плоскостей и всегда сохраняются. Исключение идентичной формы в другой известной плоскости может объясняться плоскостью; неразличимое исключение в той же плоскости остаётся неоднозначностью. Снимок schema 4 сохраняет опорные плоскости; чтение schema 1–3 поддерживается. +A circle or arc uses its own curve plane; other edges use available adjacent-face planes. A straight edge can have several: one common support plane is enough. A planar face uses its normal and position. Parallelism is checked by normal axis with 1e-7 rad tolerance; plane coincidence by normal offset with the snapshot's linear tolerance. Reversing a normal does not create a separate step. All data are transformed to instance world coordinates; the camera is not involved. -## Границы +Multiple explicit examples define the union of their support planes and are always retained. An exclusion of identical shape in another known plane can be explained by plane; an indistinguishable exclusion in the same plane remains ambiguous. Snapshot schema 4 stores support planes; schemas 1–3 remain readable. -Область задаётся This Body / This Component / All Components, по умолчанию This Component со всей вложенной иерархией выбранного экземпляра. В schema 3 хранится флаг полноты необязательной проверки стенок. Если этот этап ограничен, пары стенок отбрасываются целиком, а полный набор сущностей и сравнение формы остаются доступными; UI сообщает ограничение. Отказ обязательного чтения или бюджета всей области сохраняет прежнюю область, без частичного применения нового результата. +## Limits -- Контуры извлекаются с отклонением аппроксимации 1e-4 cm; предел 512 точек на грань и 160 планарных граней в нативном анализе. Разные разбиения кривых на точки не являются признаком разной формы: после проверки топологии опорные преобразования строятся по интегральным моментам внешней границы. Полные полилинии проверяются в обоих направлениях в пределах геометрического допуска, отверстия — биективно под той же трансформацией. Покрытие сегментов доказывается выпуклостью капсулы отрезка или адаптивным подразделением с липшицевой границей расстояния; превышение бюджета даёт неполный результат. Неудачное выравнивание может консервативно отклонить совпадение. Это не аналитический NURBS-распознаватель. -- Бюджеты анализа дают явный отказ без частичного применения. Снимок schema 2 хранит контуры и пары стенок; чтение schema 1 сохранено. -- Последний включённый уровень имеет устойчивый контур 3 px; предыдущие рёбра сохраняют контур 1.5 px, грани — заливку 35%; выделение Fusion применяется только по OK. +Scope is This Body / This Component / All Components, defaulting to This Component with the selected instance's complete nested hierarchy. Schema 3 stores the completeness flag for optional wall checks. If that stage is limited, wall pairs are discarded as a whole while the complete entity set and shape comparison remain available; UI reports the limit. Failure of required reading or of the entire scope budget preserves the previous scope without partially applying a new result. -- Неразличимые по доступным признакам пример и исключение дают предупреждение о неоднозначности; скрытый признак не выдумывается. -- Размерные семейства, скругления и отверстия не объявляются распознанными только по радиусу или площади. -- Реальная геометрия может измениться при внешнем редактировании; BodySnapshot связан с scope и revision, устаревший результат не применяется. -- Производительность числового ядра приведена в [BENCHMARKS.md](BENCHMARKS.md). CAD и графика проверяются отдельно. +- Contours are extracted with approximation deviation 1e-4 cm; native analysis is limited to 512 points per face and 160 planar faces. Different curve subdivisions into points are not treated as different shapes: after checking topology, support transformations are constructed from integral moments of the outer boundary. Complete polylines are checked in both directions within geometric tolerance; holes are matched bijectively under the same transformation. Segment coverage is proved using convexity of a segment capsule or adaptive subdivision with a Lipschitz distance bound; budget exhaustion yields an incomplete result. Failed alignment can conservatively reject a match. This is not an analytical NURBS recognizer. +- Analysis budgets produce an explicit refusal without partial application. Snapshot schema 2 stores contours and wall pairs; schema 1 remains readable. +- The last included level has a stable 3 px outline; earlier edges retain a 1.5 px outline and faces a 35% fill. Fusion selection is applied only on OK. +- An example and exclusion indistinguishable by available features produce an ambiguity warning; no hidden feature is invented. +- Size families, fillets, and holes are not declared recognized solely from radius or area. +- Real geometry can change through external edits; BodySnapshot is tied to scope and revision, and stale results are not applied. +- Numerical-kernel performance is in [BENCHMARKS.md](BENCHMARKS.md). CAD and graphics are tested separately. -## Группы криволинейных граней, 26.10.2026 +## Curved-face groups, 26 October 2026 -`curved_regions.py` обрабатывает несколько выбранных граней с неплоскими поверхностями. Выбранные компоненты связности рассматриваются как отдельные образцы групп; каждый должен содержать 2–12 граней. Кандидаты сначала фильтруются по типу поверхности, площади, периметру, радиусу и петлям. Проверяются точный индуцированный граф смежности и одно общее жёсткое преобразование/отражение всей группы. Примеры из разных тел не соединяются выдуманной топологией. +`curved_regions.py` processes multiple selected faces with nonplanar surfaces. Selected connected components are treated as separate group examples; each must contain 2–12 faces. Candidates are first filtered by surface type, area, perimeter, radius, and loops. The exact induced adjacency graph and one common rigid transformation/reflection of the entire group are checked. Examples from different bodies are not joined by invented topology. -Геометрическое свидетельство включает BRep-вершины и триангуляцию обрезанных поверхностей: узлы и центры треугольников проверяются в обоих направлениях до целевых треугольников. Проверяются также ориентированные нормали (dot не ниже 0.95 от произведения длин), чтобы не спутать противоположную сторону поверхности. Пространственный допуск — максимум линейного допуска и 1% диаметра опорных вершин при стандартной настройке. Индекс AABB ограничивает стоимость пространственных запросов. Это дискретная проверка формы с допуском, а не доказательство точного равенства произвольных аналитических поверхностей. +Geometric evidence includes BRep vertices and triangulation of trimmed surfaces: nodes and triangle centers are checked in both directions against target triangles. Directed normals are also checked (dot product no less than 0.95 times the product of lengths), to avoid confusing opposite sides. Spatial tolerance is the maximum of linear tolerance and 1% of support-vertex diameter at default settings. An AABB index bounds spatial-query cost. This is a discrete shape check with tolerance, not proof of exact equality of arbitrary analytical surfaces. -Группа сохраняется атомарной при ранжировании. Для пазов с общей цилиндрической осью и вершинами на двух торцевых уровнях плоскость уровня задаётся серединой между торцами: та же плоскость → параллельные → остальные. Это положение паза по глубине, не произвольная нормаль NURBS-грани. Неопределяемые плоскости идут отдельно последними. Exclude отклоняет всю содержащую его группу. Без подтверждённого дополнительного аналога автоматический уровень остаётся 0; приближённые группы доступны только при расширении. +A group remains atomic during ranking. For slots with a shared cylindrical axis and vertices at two end levels, the level plane is halfway between ends: same plane → parallel → others. This is slot depth position, not an arbitrary NURBS face normal. Undefined planes are separate and last. Exclude rejects the whole containing group. Without a verified additional analogue, the automatic level remains 0; approximate groups are available only through expansion. -Снимок schema 5 хранит неизменяемые вершины, узлы, треугольники и нормали; schema 1–4 читаются. Mesh читается только для возможных ролей выбранных примеров; добавление Examples дочитывает нужные данные. Лимиты: 160 новых граней за чтение, 64 BRep-вершины, 1024 узла и 2048 треугольников на грань; 2 s на чтение, 2 s/2 млн состояний на поиск. Превышение бюджета и недостающая геометрия дают явный отказ без частичного результата. Одиночные кривые грани пока используют скалярное ранжирование. +Snapshot schema 5 stores immutable vertices, nodes, triangles, and normals; schemas 1–4 remain readable. Mesh is read only for potential roles of selected examples; adding Examples reads the required data. Limits: 160 new faces per read, 64 BRep vertices, 1,024 nodes and 2,048 triangles per face; 2 seconds for reading, 2 seconds/2 million states for search. Budget exhaustion or missing geometry produces an explicit refusal without a partial result. Individual curved faces still use scalar ranking. diff --git a/docs/RANKING.ru.md b/docs/RANKING.ru.md new file mode 100644 index 0000000..a970730 --- /dev/null +++ b/docs/RANKING.ru.md @@ -0,0 +1,64 @@ +# Ранжирование похожести + +[English](RANKING.md) + +`ranking.py` обрабатывает неизменяемый BodySnapshot явно выбранной области. Все допустимые рёбра либо все допустимые грани этого снимка получают расстояние сходства; исключённые элементы тоже получают ранг, но помечаются blocked и не включаются в результат. При объединении тел ключи получают пространство имён; топология и свидетельства материала не пересекают границы тел. + +## Признаки + +Автоматическое ранжирование плоских граней с полными контурами сначала использует геометрические отношения из `intentions.py`. Порядок: совпадающая обрезанная форма и размер → непосредственная пара стенки примера → пара найденного аналога → приближённые группы. Сравнение полигональных петель допускает одну изометрию или отражение, сохраняет размеры и взаимное размещение отверстий; площадь/периметр служат только дешёвым предварительным фильтром. Отсутствующий контур плоского примера даёт неоднозначность и стартовый уровень 0. + +Пара стенки требует противоположных наружных нормалей, локального смещения, перекрытия не менее половины меньшей обрезанной области и толщины не более `0.25 * sqrt(min_area)`. Это текущая явная эвристика локальности, не универсальный закон для деталей. Adapter проверяет материал внутри каждой контрольной трассы и отсутствие промежуточных пересечений BRep. Поперёк области остаётся дискретная выборка: объёмная гарантия для всей стенки не заявляется. + +Два примера противоположных сторон могут задать семейство пар: нужны обе формы, толщина и одна общая трансформация всей пары. Два или больше связанных примеров могут задать повтор узла: проверяются точный индуцированный граф и общая геометрия всех граней. Исключение отклоняет целый противоречащий узел. Широкие гипотезы параллельности/площади допустимы только при объяснении всех примеров и отделении всех исключений. Для несвязанных плоских примеров приоритетнее широких гипотез идёт объединение подтверждённых семейств формы/размера. Каждый кандидат должен совпасть с полным контуром хотя бы одного примера; равенство нормали недостаточно. Проверенные связанные узлы и пары стенок сохраняют приоритет. + +Ниже описана скалярная оценка для предварительного фильтра, приближённых групп и явных критериев. Она сама по себе не подтверждает форму. + +Автоматические базовые веса: тип геометрии 0.8; длина/площадь 1.2; радиус 1.6; направление 1.0; ось нормали 0.2; периметр 0.7; число сторон/петель/соседних граней по 0.25; угол соседних граней 0.5. Учитываются только доступные у всех примеров признаки. Часть полей уже поддерживается ядром, но ещё не извлекается нативным adapter, например угол на общем ребре кривых поверхностей. + +Если примеры различаются по признаку сильнее допуска, автоматический режим исключает его из обязательных общих свойств. Если признак отделяет отрицательные примеры, его вес увеличивается. Нормаль извлекается для плоских граней и плоскостей окружностей/дуг. Для плоских граней: Automatic сравнивает её ось, поэтому противоположные стороны тонкой стенки не штрафуются за угол 180°. Размер и форма имеют больший вес, чем ориентация. Явный Match → Orientation сохраняет направленную нормаль и различает 0° и 180°. Для окружностей и дуг явная Orientation сравнивает ось плоскости без знака нормали. Направление прямой осевое: смена параметризации не меняет сходство. + +Размеры сравниваются относительно масштаба с абсолютным нижним допуском. По умолчанию относительный допуск 1%, угол 2°, длина 1e-6 cm и площадь 1e-8 cm². В пределах допуска разность обнуляется. Расстояния нормированы в [0, 1]; взвешенное среднее задаёт порядок, а не вероятность намерения. + +Скалярная автоматическая дистанция проверяется относительно всех примеров. Геометрическая гипотеза независимых семейств объединяет полные совпадения с каждым отдельным примером. При явном выборе одного критерия допускается совпадение с любым примером, как объединение семейств. Совпадение простых числовых признаков не доказывает геометрическую конгруэнтность. + +## Диапазоны + +Подтверждённые геометрические отношения образуют атомарные уровни. Приближённые плоские группы используют фиксированные границы скалярной дистанции 0.02/0.10/0.25/0.50/1.0. Рёбра — 0/0.005/0.02/0.05/0.10/0.20/0.35/0.60/1.0. Так небольшие вариации размеров не создают отдельный PgUp на каждую сущность. Для оставшихся скалярных поверхностей сохраняются числовые ничьи, описанные ниже. + +Равно похожие элементы объединяются в уровни с числовым допуском 1e-9. Включение/снятие уровня атомарно: идентификаторы не разрывают ничью. Начальный автоматический диапазон — первая непустая группа кандидатов сверх примеров при наличии информативных признаков и отсутствии неразличимого исключения. Он не остаётся на нуле из-за фиксированного числового порога. Если допустимых кандидатов нет или обратная связь противоречива, сохраняются только примеры; ближайший кандидат не объявляется доказанным аналогом формы. + +PgUp добавляет следующий уровень, PgDown удаляет самый слабый включённый. Ползунок управляет тем же целым индексом диапазона. Положительные примеры сохраняются всегда. На максимуме выбираются все не исключённые элементы исходного типа и тела. Соседство на этот порядок не влияет. + +Новый пример, исключение или критерий пересчитывает ранги и возвращает автоматический диапазон. Изменение диапазона использует готовое ранжирование без повторного чтения BRep. Undo/Redo в ядре восстанавливает состояние уточнений; системный Undo Fusion этим не переопределяется. + +## Порядок плоскостей + +В Automatic каждый уже построенный геометрический уровень дополнительно разделяется: в плоскости примера → в параллельных плоскостях → в остальных плоскостях → с неизвестной опорной плоскостью. Форма и размер остаются первичными: увеличенная копланарная окружность не опережает точную повёрнутую. Каждый непустой подкласс — отдельный шаг PgUp/PgDown или =/-. Явные Match-критерии не получают этот дополнительный фильтр. + +У окружности и дуги используется собственная плоскость кривой; у остальных рёбер — доступные плоскости смежных граней. У прямого ребра их может быть несколько: достаточно общей опорной плоскости. У плоской грани используются её нормаль и положение. Параллельность проверяется по оси нормали с допуском 1e-7 rad, совпадение плоскостей — по нормальному смещению с линейным допуском снимка. Разворот нормали не создаёт отдельный шаг. Все данные переводятся в мировые координаты экземпляра; камера не участвует. + +Несколько явных примеров задают объединение своих опорных плоскостей и всегда сохраняются. Исключение идентичной формы в другой известной плоскости может объясняться плоскостью; неразличимое исключение в той же плоскости остаётся неоднозначностью. Снимок schema 4 сохраняет опорные плоскости; чтение schema 1–3 поддерживается. + +## Границы + +Область задаётся This Body / This Component / All Components, по умолчанию This Component со всей вложенной иерархией выбранного экземпляра. В schema 3 хранится флаг полноты необязательной проверки стенок. Если этот этап ограничен, пары стенок отбрасываются целиком, а полный набор сущностей и сравнение формы остаются доступными; UI сообщает ограничение. Отказ обязательного чтения или бюджета всей области сохраняет прежнюю область, без частичного применения нового результата. + +- Контуры извлекаются с отклонением аппроксимации 1e-4 cm; предел 512 точек на грань и 160 планарных граней в нативном анализе. Разные разбиения кривых на точки не являются признаком разной формы: после проверки топологии опорные преобразования строятся по интегральным моментам внешней границы. Полные полилинии проверяются в обоих направлениях в пределах геометрического допуска, отверстия — биективно под той же трансформацией. Покрытие сегментов доказывается выпуклостью капсулы отрезка или адаптивным подразделением с липшицевой границей расстояния; превышение бюджета даёт неполный результат. Неудачное выравнивание может консервативно отклонить совпадение. Это не аналитический NURBS-распознаватель. +- Бюджеты анализа дают явный отказ без частичного применения. Снимок schema 2 хранит контуры и пары стенок; чтение schema 1 сохранено. +- Последний включённый уровень имеет устойчивый контур 3 px; предыдущие рёбра сохраняют контур 1.5 px, грани — заливку 35%; выделение Fusion применяется только по OK. + +- Неразличимые по доступным признакам пример и исключение дают предупреждение о неоднозначности; скрытый признак не выдумывается. +- Размерные семейства, скругления и отверстия не объявляются распознанными только по радиусу или площади. +- Реальная геометрия может измениться при внешнем редактировании; BodySnapshot связан с scope и revision, устаревший результат не применяется. +- Производительность числового ядра приведена в [BENCHMARKS.md](BENCHMARKS.ru.md). CAD и графика проверяются отдельно. + +## Группы криволинейных граней, 26.10.2026 + +`curved_regions.py` обрабатывает несколько выбранных граней с неплоскими поверхностями. Выбранные компоненты связности рассматриваются как отдельные образцы групп; каждый должен содержать 2–12 граней. Кандидаты сначала фильтруются по типу поверхности, площади, периметру, радиусу и петлям. Проверяются точный индуцированный граф смежности и одно общее жёсткое преобразование/отражение всей группы. Примеры из разных тел не соединяются выдуманной топологией. + +Геометрическое свидетельство включает BRep-вершины и триангуляцию обрезанных поверхностей: узлы и центры треугольников проверяются в обоих направлениях до целевых треугольников. Проверяются также ориентированные нормали (dot не ниже 0.95 от произведения длин), чтобы не спутать противоположную сторону поверхности. Пространственный допуск — максимум линейного допуска и 1% диаметра опорных вершин при стандартной настройке. Индекс AABB ограничивает стоимость пространственных запросов. Это дискретная проверка формы с допуском, а не доказательство точного равенства произвольных аналитических поверхностей. + +Группа сохраняется атомарной при ранжировании. Для пазов с общей цилиндрической осью и вершинами на двух торцевых уровнях плоскость уровня задаётся серединой между торцами: та же плоскость → параллельные → остальные. Это положение паза по глубине, не произвольная нормаль NURBS-грани. Неопределяемые плоскости идут отдельно последними. Exclude отклоняет всю содержащую его группу. Без подтверждённого дополнительного аналога автоматический уровень остаётся 0; приближённые группы доступны только при расширении. + +Снимок schema 5 хранит неизменяемые вершины, узлы, треугольники и нормали; schema 1–4 читаются. Mesh читается только для возможных ролей выбранных примеров; добавление Examples дочитывает нужные данные. Лимиты: 160 новых граней за чтение, 64 BRep-вершины, 1024 узла и 2048 треугольников на грань; 2 s на чтение, 2 s/2 млн состояний на поиск. Превышение бюджета и недостающая геометрия дают явный отказ без частичного результата. Одиночные кривые грани пока используют скалярное ранжирование. From 2328dba60202b4e18dd75f4c55af1321447f0c47 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:28:06 +0300 Subject: [PATCH 10/14] docs: link translated changelog --- CONTRIBUTING.ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.ru.md b/CONTRIBUTING.ru.md index 5dfe2b2..8134c2e 100644 --- a/CONTRIBUTING.ru.md +++ b/CONTRIBUTING.ru.md @@ -25,7 +25,7 @@ ``` 5. Для UI, adapter и жизненного цикла выполните соответствующие сценарии [CAD-приёмки](docs/VALIDATION.md). Невыполненные проверки обозначьте явно. -6. Обновите документы и Unreleased в [CHANGELOG.md](CHANGELOG.md), затем откройте PR. +6. Обновите документы и Unreleased в [CHANGELOG.ru.md](CHANGELOG.ru.md), затем откройте PR. Используйте Conventional Commits: `feat:`, `fix:`, `docs:`, `test:`, `ci:`, `chore:`. В PR объясните поведение и приведите результаты проверок. CAD-проверки выполняются в отдельном несохранённом документе. From 1dcf5f4c02515e82b4f521f0129b09c148645cfa Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:33:57 +0300 Subject: [PATCH 11/14] docs: provide bilingual surface-group notes --- docs/SURFACE_GROUPS.md | 14 ++++++++------ docs/SURFACE_GROUPS.ru.md | 13 +++++++++++++ 2 files changed, 21 insertions(+), 6 deletions(-) create mode 100644 docs/SURFACE_GROUPS.ru.md diff --git a/docs/SURFACE_GROUPS.md b/docs/SURFACE_GROUPS.md index 4cff086..ccccabe 100644 --- a/docs/SURFACE_GROUPS.md +++ b/docs/SURFACE_GROUPS.md @@ -1,11 +1,13 @@ -# Логические поверхности из фрагментов +# Logical surfaces from fragments -`surface_groups.py` — исполняемое офлайн-исследование объединения планарных полигональных фрагментов. Оно пока не подключено к нативному выбору: реальная STEP-приёмка и политика выбора целой логической поверхности остаются отдельным этапом. +[Русская версия](SURFACE_GROUPS.ru.md) -Вход — `BodySnapshot` одного тела. Группировка требует графовой связи исходных граней, совпадения опорных плоскостей в абсолютном допуске и подтверждённого общего отрезка границы. Внутренние общие сегменты удаляются; коллинеарные подразделения и T-соединения предварительно разбиваются. Результат хранит внешний контур, отверстия и все `source_keys`: ссылки на исходные BRep-грани не заменяются синтетическим ключом. +`surface_groups.py` is an executable offline investigation of joining planar polygonal fragments. It is not yet connected to native selection: real STEP acceptance and the policy for selecting a complete logical surface remain separate work. -Относительный допуск похожести 1% не используется для склеивания щелей. Неоднозначное соединение, пересечение внутренних областей, ветвление или неподдержанная грань сохраняются в `rejected` вместе с исходными ключами. При превышении бюджета `complete=False`, получение полного выбора запрещено. +The input is a `BodySnapshot` of one body. Grouping requires graph connectivity of the source faces, coincident support planes within absolute tolerance, and a confirmed shared boundary segment. Internal shared segments are removed; collinear subdivisions and T-junctions are split first. The result retains the outer contour, holes, and all `source_keys`: references to original BRep faces are not replaced with a synthetic key. -Проверены синтетические прямоугольные фрагменты, подразделённая граница, рамка с отверстием, заполнение отверстия, разные плоскости, нормали противоположных направлений, жёсткое преобразование, перекрытие, самопересечение, точечное касание и бюджеты. Команда: `python3 -m unittest tests.test_surface_groups -v`. +The 1% relative similarity tolerance is not used to bridge gaps. Ambiguous joins, interior overlap, branching, or unsupported faces are retained in `rejected` with their source keys. If the budget is exceeded, `complete=False` and obtaining a complete selection is prohibited. -Это не общий boolean произвольных NURBS-поверхностей. Тесселяция разных криволинейных границ, реальные STEP-импорты и перенос выбора объединённого участка в Fusion здесь не подтверждены. Автоматическое объединение в продукте пока выключено. +Synthetic rectangular fragments, a subdivided boundary, a frame with a hole, filling a hole, different planes, opposite normals, a rigid transform, overlap, self-intersection, point contact, and budgets have been checked. Command: `python3 -m unittest tests.test_surface_groups -v`. + +This is not a general Boolean for arbitrary NURBS surfaces. Tessellation of different curved boundaries, real STEP imports, and transferring selection of a merged region into Fusion are not established here. Automatic merging in the product is currently disabled. diff --git a/docs/SURFACE_GROUPS.ru.md b/docs/SURFACE_GROUPS.ru.md new file mode 100644 index 0000000..1fdc579 --- /dev/null +++ b/docs/SURFACE_GROUPS.ru.md @@ -0,0 +1,13 @@ +# Логические поверхности из фрагментов + +[English](SURFACE_GROUPS.md) + +`surface_groups.py` — исполняемое офлайн-исследование объединения планарных полигональных фрагментов. Оно пока не подключено к нативному выбору: реальная STEP-приёмка и политика выбора целой логической поверхности остаются отдельным этапом. + +Вход — `BodySnapshot` одного тела. Группировка требует графовой связи исходных граней, совпадения опорных плоскостей в абсолютном допуске и подтверждённого общего отрезка границы. Внутренние общие сегменты удаляются; коллинеарные подразделения и T-соединения предварительно разбиваются. Результат хранит внешний контур, отверстия и все `source_keys`: ссылки на исходные BRep-грани не заменяются синтетическим ключом. + +Относительный допуск похожести 1% не используется для склеивания щелей. Неоднозначное соединение, пересечение внутренних областей, ветвление или неподдержанная грань сохраняются в `rejected` вместе с исходными ключами. При превышении бюджета `complete=False`, получение полного выбора запрещено. + +Проверены синтетические прямоугольные фрагменты, подразделённая граница, рамка с отверстием, заполнение отверстия, разные плоскости, нормали противоположных направлений, жёсткое преобразование, перекрытие, самопересечение, точечное касание и бюджеты. Команда: `python3 -m unittest tests.test_surface_groups -v`. + +Это не общий boolean произвольных NURBS-поверхностей. Тесселяция разных криволинейных границ, реальные STEP-импорты и перенос выбора объединённого участка в Fusion здесь не подтверждены. Автоматическое объединение в продукте пока выключено. From 069747d9c0e31cbd6946ab2dc832f79e9565bdd3 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:53:09 +0300 Subject: [PATCH 12/14] docs: provide bilingual agent instructions --- AGENTS.md | 86 +++++++++++++++++++++++++++------------------------- AGENTS.ru.md | 46 ++++++++++++++++++++++++++++ 2 files changed, 90 insertions(+), 42 deletions(-) create mode 100644 AGENTS.ru.md diff --git a/AGENTS.md b/AGENTS.md index 9fbc973..5e0c890 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,44 +1,46 @@ # Selectra -Selectra упрощает выделение BRep-рёбер и граней в Autodesk Fusion по примерам. - -## Работа - -- Общение, документация и планы, включая режим планирования, — на русском. Подписи интерфейса — на английском, в терминах Fusion. -- Для вопросов о библиотеках, SDK, API, CLI и облачных сервисах используй Context7: сначала resolve-library-id, затем query-docs по конкретному вопросу. При неполном покрытии Fusion сверяй официальные документы Autodesk и определения установленного API. -- Перед изменениями проверяй Git и сохраняй чужие изменения. Ветки — `codex/…`. -- Область задаёт Search Scope: This Body — исходное тело выбранного экземпляра; This Component — компонент первого примера и его вложенная иерархия, по умолчанию; All Components — вся видимая сборка. В This Component соседние экземпляры того же определения исключены. Примеры и исключения доступны в выбранной области; сужение за пределы явных примеров отклоняется до их удаления пользователем. -- Веб-демо не создавать. Проверки ядра выполнять в Python, интерфейс проверять в самом Fusion после разрешения пользователя. -- PgUp/PgDown и алиасы =/- изменяют ранжированный диапазон сущностей выбранного типа в текущей области. Колесо остаётся навигации Fusion; графовое соседство — отдельная операция. -- Результат до OK показывай стабильной Magenta-подсветкой. Отдельного поля Preview нет. Канонический сценарий — `docs/UX.md`. -- Для браузера предпочитай подключённый DevTools или конкретную вкладку и узкие запросы. Computer Use применяй для нативного UI, визуальных проверок и недоступных элементов. Проверяй фактическое подключение; запуск удалённой отладки и перезапуск браузера согласовывай отдельно. - -## Архитектура и продукт - -- `Selectra/matching.py` — чистое детерминированное ядро на числовых снимках, без `adsk`. Единицы: cm, cm², rad. -- `ranking.py`, `snapshot.py`, `selection.py` — общее ранжирование, снимок тела и состояние диапазона/уточнений; устройство алгоритма — `docs/RANKING.md`. -- `highlight.py` — временное Magenta-наложение в executePreview; валидная графика переиспользуется, группы очищаются при завершении команды. -- `Selectra/fusion_adapter.py` — чтение BRep и проверка области; ссылки на живые объекты принадлежат одной сессии команды. -- `Selectra/Selectra.py` — нативная команда, предпросмотр и жизненный цикл событий. Дополнение меняет выделение, сохраняя геометрию и таймлайн. -- Вход по умолчанию — один `Select Similar`. Критерии выводятся из примеров; уточнения показываются по необходимости. Ранжирование — эвристика, не вероятность намерения пользователя. -- Для изменения UX и алгоритма прочитай `docs/PRODUCT.md`; возможности API и ограничения — в `docs/API_RESEARCH.md`; очередность и критерии готовности — в `PLAN.md`. -- Adapter сохраняет proxy/assemblyContext и различает экземпляры, числовые снимки и временная графика приведены к мировым координатам. tempId получает пространство имён тела при объединении; топология и пары стенок остаются внутри тела. Проверяй ревизии всех тел области и преобразования occurrences перед preview и отложенным OK. -- Используй стандартную библиотеку Python, поставляемую Fusion. Preview API не используй в распространяемом продукте. - -## Проверка - -- Проверяй ядро: `python3 -m unittest discover -s tests -v`. -- Для публичной обвязки дополнительно выполняй `python3 scripts/check_project.py` и `python3 scripts/build.py`. Сохраняй PolyForm Noncommercial 1.0.0 и соответствующие SPDX-заголовки. Перед релизом прочитай `docs/PUBLISHING.md`. -- Для UI и adapter нужны проверки в настоящем Fusion по `docs/VALIDATION.md`. Выполняй их одной CAD-сессией на отдельном несохранённом документе; активный документ пользователя сохраняй нетронутым. -- Отличай unit-тесты и проверку API definitions от живой CAD-приёмки. Точный выполненный объём смотри в `docs/VALIDATION.md`; результаты macOS не подтверждают Windows. -- При завершении команды проверяй документ, текущую команду и валидность объектов перед отложенным переносом выбора. Храни event handlers до завершения сессии, освобождай при stop. - -## Общий инженерный контракт 4FusionLab - -- Корпоративные правила и общие CI-компоненты описаны в [4FusionLab/.github](https://github.com/4FusionLab/.github/blob/main/AGENTS.md) и [Release Platform](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md). Настоящие правила конкретного продукта действуют дополнительно. -- Перед правками проверь существующие Git-изменения, документацию, автоматические проверки и совместимость с Autodesk Fusion. Не удаляй пользовательские данные, не меняй существующие IDs команд, UUID manifest или структуру аддона без миграционного плана. -- Для обычной разработки используй Conventional Commits; предпочтителен небольшой PR с CI, но прямой push в `main` допускается политикой репозитория. Не переписывай историю и не изменяй опубликованные теги/артефакты. -- Включён **автоматический выпуск только при изменении распространяемого продукта**: push или merge в `main` → проверка `.github/release-paths.txt` → тесты → GitVersion 6.8.2 → новый неизменяемый тег и GitHub Release. Теги вручную не создавай; изменения README, документации, тестов, workflow, `AGENTS.md` не должны публиковать релиз. -- Общие GitHub Actions подключай только по **точному SHA** проверенного коммита `4FusionLab/.github`, а не по `@main`. Пакет, manifest, SHA-256, release notes и version согласованы; существующие релизы не перезаписывай. -- Выполнение unit-тестов и успешная сборка ZIP **не доказывают** работоспособность в установленном Autodesk Fusion. Для изменений Fusion API и пользовательского интерфейса фиксируй фактическую CAD-приёмку и ОС отдельно. -- Сохраняй существующие английскую и русскую версии документации, лицензии, ограничения и уникальные сценарии проекта. Не публикуй секреты, персональные CAD-документы, токены или артефакты с локальной машины. +[Русская версия](AGENTS.ru.md) + +Selectra simplifies selecting Autodesk Fusion BRep edges and faces by example. + +## Work + +- Communicate and plan, including in plan mode, in Russian. Write documents in English and maintain separate Russian versions of documentation; intermediate working notes do not require translation. UI labels are English, using Fusion terminology. +- For questions about libraries, SDKs, APIs, CLI tools and cloud services use Context7: first resolve-library-id, then query-docs for the specific question. If Fusion coverage is incomplete, check official Autodesk documentation and installed API definitions. +- Check Git before changes and preserve others' work. Branches use `codex/…`. +- Search Scope defines the area: This Body is the source body of the selected instance; This Component is the first example's component and nested hierarchy, by default; All Components is the entire visible assembly. This Component excludes neighboring instances of the same definition. Examples and exclusions are available within the chosen scope; narrowing past explicit examples is rejected until the user removes them. +- Do not create a web demo. Test the core in Python and validate the interface in Fusion after user authorization. +- PgUp/PgDown and aliases =/- change the ranked range of entities of the selected type in the current scope. The wheel remains Fusion navigation; graph adjacency is a separate operation. +- Before OK, display the result with stable Magenta highlighting. There is no separate Preview field. The canonical workflow is `docs/UX.md`. +- For the browser prefer connected DevTools or a specific tab and narrow requests. Use Computer Use for native UI, visual checks and unavailable elements. Verify actual connectivity; coordinate remote-debugging activation and browser restart separately. + +## Architecture and product + +- `Selectra/matching.py` is the pure deterministic kernel on numeric snapshots, without `adsk`. Units: cm, cm², rad. +- `ranking.py`, `snapshot.py`, `selection.py` provide shared ranking, body snapshot and range/refinement state; algorithm details are in `docs/RANKING.md`. +- `highlight.py` provides the temporary Magenta overlay in executePreview; valid graphics are reused and groups are cleared when the command ends. +- `Selectra/fusion_adapter.py` reads BRep and checks scope; references to live objects belong to one command session. +- `Selectra/Selectra.py` implements the native command, preview and event lifecycle. The add-in changes selection while preserving geometry and timeline. +- The default entry point is one `Select Similar`. Criteria are inferred from examples; refinements are shown when needed. Ranking is a heuristic, not a probability of user intent. +- For UX and algorithm changes read `docs/PRODUCT.md`; API capabilities and limitations are in `docs/API_RESEARCH.md`; sequencing and completion criteria are in `PLAN.md`. +- The adapter preserves proxy/assemblyContext and distinguishes instances; numeric snapshots and temporary graphics are converted to world coordinates. tempId is namespaced by body when combining; topology and wall pairs remain inside the body. Check revisions of all bodies in scope and occurrence transforms before preview and delayed OK. +- Use the Python standard library supplied with Fusion. Do not use Preview API in the distributed product. + +## Verification + +- Test the core: `python3 -m unittest discover -s tests -v`. +- For public packaging also run `python3 scripts/check_project.py` and `python3 scripts/build.py`. Preserve PolyForm Noncommercial 1.0.0 and the corresponding SPDX headers. Before release read `docs/PUBLISHING.md`. +- UI and adapter require real Fusion tests according to `docs/VALIDATION.md`. Use one CAD session and a separate unsaved document; leave the user's active document untouched. +- Distinguish unit tests and API definition checks from live CAD acceptance. See `docs/VALIDATION.md` for exact coverage; macOS results do not establish Windows behavior. +- On command completion check document, current command and object validity before delayed transfer of selection. Retain event handlers until session end and release them on stop. + +## Shared 4FusionLab engineering contract + +- Organization rules and shared CI components are documented in [4FusionLab/.github](https://github.com/4FusionLab/.github/blob/main/AGENTS.md) and [Release Platform](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md). These product-specific rules apply in addition. +- Before edits inspect existing Git changes, documentation, automated checks and Autodesk Fusion compatibility. Do not delete user data or change existing command IDs, manifest UUID or add-in structure without a migration plan. +- Use Conventional Commits for ordinary development; a small PR with CI is preferred, though direct push to `main` is allowed by repository policy. Do not rewrite history or modify published tags/artifacts. +- **Automatic releases occur only for shipped product changes**: push or merge to `main` → check `.github/release-paths.txt` → tests → GitVersion 6.8.2 → new immutable tag and GitHub Release. Do not create tags manually; changes to README, documentation, tests, workflows or `AGENTS.md` must not independently publish a release. +- Pin shared GitHub Actions to the **exact SHA** of a reviewed `4FusionLab/.github` commit, not `@main`. Package, manifest, SHA-256, release notes and version must agree; do not overwrite existing releases. +- Passing unit tests and building a ZIP **does not prove** operation in installed Autodesk Fusion. Record actual CAD acceptance and OS separately for Fusion API and UI changes. +- Preserve existing English and Russian documentation, licenses, limitations and project-specific workflows. Do not publish secrets, personal CAD documents, tokens or local-machine artifacts. diff --git a/AGENTS.ru.md b/AGENTS.ru.md new file mode 100644 index 0000000..cdb74b7 --- /dev/null +++ b/AGENTS.ru.md @@ -0,0 +1,46 @@ +# Selectra + +[English](AGENTS.md) + +Selectra упрощает выделение BRep-рёбер и граней в Autodesk Fusion по примерам. + +## Работа + +- Общение и планы, включая режим планирования, — на русском. Документы ведутся на английском; для документации поддерживаются отдельные русские версии, промежуточные рабочие заметки переводить не требуется. Подписи интерфейса — на английском, в терминах Fusion. +- Для вопросов о библиотеках, SDK, API, CLI и облачных сервисах используй Context7: сначала resolve-library-id, затем query-docs по конкретному вопросу. При неполном покрытии Fusion сверяй официальные документы Autodesk и определения установленного API. +- Перед изменениями проверяй Git и сохраняй чужие изменения. Ветки — `codex/…`. +- Область задаёт Search Scope: This Body — исходное тело выбранного экземпляра; This Component — компонент первого примера и его вложенная иерархия, по умолчанию; All Components — вся видимая сборка. В This Component соседние экземпляры того же определения исключены. Примеры и исключения доступны в выбранной области; сужение за пределы явных примеров отклоняется до их удаления пользователем. +- Веб-демо не создавать. Проверки ядра выполнять в Python, интерфейс проверять в самом Fusion после разрешения пользователя. +- PgUp/PgDown и алиасы =/- изменяют ранжированный диапазон сущностей выбранного типа в текущей области. Колесо остаётся навигации Fusion; графовое соседство — отдельная операция. +- Результат до OK показывай стабильной Magenta-подсветкой. Отдельного поля Preview нет. Канонический сценарий — `docs/UX.md`. +- Для браузера предпочитай подключённый DevTools или конкретную вкладку и узкие запросы. Computer Use применяй для нативного UI, визуальных проверок и недоступных элементов. Проверяй фактическое подключение; запуск удалённой отладки и перезапуск браузера согласовывай отдельно. + +## Архитектура и продукт + +- `Selectra/matching.py` — чистое детерминированное ядро на числовых снимках, без `adsk`. Единицы: cm, cm², rad. +- `ranking.py`, `snapshot.py`, `selection.py` — общее ранжирование, снимок тела и состояние диапазона/уточнений; устройство алгоритма — `docs/RANKING.md`. +- `highlight.py` — временное Magenta-наложение в executePreview; валидная графика переиспользуется, группы очищаются при завершении команды. +- `Selectra/fusion_adapter.py` — чтение BRep и проверка области; ссылки на живые объекты принадлежат одной сессии команды. +- `Selectra/Selectra.py` — нативная команда, предпросмотр и жизненный цикл событий. Дополнение меняет выделение, сохраняя геометрию и таймлайн. +- Вход по умолчанию — один `Select Similar`. Критерии выводятся из примеров; уточнения показываются по необходимости. Ранжирование — эвристика, не вероятность намерения пользователя. +- Для изменения UX и алгоритма прочитай `docs/PRODUCT.md`; возможности API и ограничения — в `docs/API_RESEARCH.md`; очередность и критерии готовности — в `PLAN.md`. +- Adapter сохраняет proxy/assemblyContext и различает экземпляры, числовые снимки и временная графика приведены к мировым координатам. tempId получает пространство имён тела при объединении; топология и пары стенок остаются внутри тела. Проверяй ревизии всех тел области и преобразования occurrences перед preview и отложенным OK. +- Используй стандартную библиотеку Python, поставляемую Fusion. Preview API не используй в распространяемом продукте. + +## Проверка + +- Проверяй ядро: `python3 -m unittest discover -s tests -v`. +- Для публичной обвязки дополнительно выполняй `python3 scripts/check_project.py` и `python3 scripts/build.py`. Сохраняй PolyForm Noncommercial 1.0.0 и соответствующие SPDX-заголовки. Перед релизом прочитай `docs/PUBLISHING.md`. +- Для UI и adapter нужны проверки в настоящем Fusion по `docs/VALIDATION.md`. Выполняй их одной CAD-сессией на отдельном несохранённом документе; активный документ пользователя сохраняй нетронутым. +- Отличай unit-тесты и проверку API definitions от живой CAD-приёмки. Точный выполненный объём смотри в `docs/VALIDATION.md`; результаты macOS не подтверждают Windows. +- При завершении команды проверяй документ, текущую команду и валидность объектов перед отложенным переносом выбора. Храни event handlers до завершения сессии, освобождай при stop. + +## Общий инженерный контракт 4FusionLab + +- Корпоративные правила и общие CI-компоненты описаны в [4FusionLab/.github](https://github.com/4FusionLab/.github/blob/main/AGENTS.md) и [Release Platform](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md). Настоящие правила конкретного продукта действуют дополнительно. +- Перед правками проверь существующие Git-изменения, документацию, автоматические проверки и совместимость с Autodesk Fusion. Не удаляй пользовательские данные, не меняй существующие IDs команд, UUID manifest или структуру аддона без миграционного плана. +- Для обычной разработки используй Conventional Commits; предпочтителен небольшой PR с CI, но прямой push в `main` допускается политикой репозитория. Не переписывай историю и не изменяй опубликованные теги/артефакты. +- Включён **автоматический выпуск только при изменении распространяемого продукта**: push или merge в `main` → проверка `.github/release-paths.txt` → тесты → GitVersion 6.8.2 → новый неизменяемый тег и GitHub Release. Теги вручную не создавай; изменения README, документации, тестов, workflow, `AGENTS.md` не должны публиковать релиз. +- Общие GitHub Actions подключай только по **точному SHA** проверенного коммита `4FusionLab/.github`, а не по `@main`. Пакет, manifest, SHA-256, release notes и version согласованы; существующие релизы не перезаписывай. +- Выполнение unit-тестов и успешная сборка ZIP **не доказывают** работоспособность в установленном Autodesk Fusion. Для изменений Fusion API и пользовательского интерфейса фиксируй фактическую CAD-приёмку и ОС отдельно. +- Сохраняй существующие английскую и русскую версии документации, лицензии, ограничения и уникальные сценарии проекта. Не публикуй секреты, персональные CAD-документы, токены или артефакты с локальной машины. From 7f0d4701beb2fac8dcd5eeae6fc561b848d672bf Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:58:50 +0300 Subject: [PATCH 13/14] docs: add English selection evaluation --- docs/EVALUATION.md | 76 ++++++++++++++++++++++--------------------- docs/EVALUATION.ru.md | 66 +++++++++++++++++++++++++++++++++++++ 2 files changed, 105 insertions(+), 37 deletions(-) create mode 100644 docs/EVALUATION.ru.md diff --git a/docs/EVALUATION.md b/docs/EVALUATION.md index 7325594..f24557b 100644 --- a/docs/EVALUATION.md +++ b/docs/EVALUATION.md @@ -1,64 +1,66 @@ -# Оценка инженерных итераций Selectra +# Evaluation of Selectra engineering iterations -## Методика +English | [Русский](EVALUATION.ru.md) -Baseline — неизменённый алгоритм `ranking.py` из `c5ac432`, сохранённый в `evaluation/baseline_c5ac432.py`. Отличается только путём импорта чистых типов `Tolerance` и `_angle`. Новая реализация сравнивается с ним на одном корпусе `evaluation/corpus.py`. +## Method -Корпус **синтетический**, без пользовательских моделей. Метки заданы задачей: одинаковая длина/ось; второй пример; исключение; неразличимое исключение; U/T-контуры с одинаковыми площадью, периметром и числом сторон; перенос/поворот/отражение; смещение отверстия; последовательность аналог → своя стенка → стенка аналога; пустая полость; близкие размерные семейства. +The baseline is the unchanged `ranking.py` algorithm from `c5ac432`, saved in `evaluation/baseline_c5ac432.py`. Only the import path for the pure `Tolerance` and `_angle` types differs. The new implementation is compared with it on the same `evaluation/corpus.py` corpus. -Команда: `python3 scripts/evaluate_selection.py --json artifacts/evaluation/results.json`. +The corpus is **synthetic**, with no user models. Task labels cover equal length/axis; a second example; exclusion; an indistinguishable exclusion; U/T contours with equal area, perimeter and side count; translation/rotation/reflection; a shifted hole; the sequence analogue → its own wall → analogue's wall; an empty cavity; and nearby size families. -Измеряются: +Command: `python3 scripts/evaluate_selection.py --json artifacts/evaluation/results.json`. -- Точное совпадение первого предложения с целевым набором. Для многошагового сценария стенки первый набор сравнивается с первым checkpoint, достижимость и шаги — с конечной целью. -- Precision/recall только добавленных кандидатов; явные примеры не дают бесплатных правильных ответов. При пустом правильном и предсказанном добавлении обе метрики равны 1. -- Достижимость целевого набора каким-либо вложенным диапазоном и минимальное число шагов PgUp/PgDown от автоматического диапазона. Недостижимость показывается явно, не заменяется числом действий. -- Отдельные промежуточные наборы сценария стенки. -- Стоимость уже заданной обратной связи: второй пример и Exclude считаются отдельными действиями. Это ручные сценарии; оптимальность стратегии пользователя не заявляется. -- Сохранение всех групп при преобразовании координат, отражении, перестановке примеров и замене идентификаторов. Камера в снимок не входит; UI-устойчивость проверяется отдельно. -- Медиана времени чистого ранжирования в Python. Чтение BRep, подсветка, задержка UI и Fusion здесь **не измеряются**. +The measurements are: -## Результаты +- Exact match between the first proposal and the target set. For the multi-step wall scenario, the first set is compared with the first checkpoint, and reachability and steps with the final target. +- Precision/recall for added candidates only; explicit examples do not provide free correct answers. When both the correct and predicted additions are empty, both metrics equal 1. +- Reachability of the target set by some nested range and the minimum number of PgUp/PgDown steps from the automatic range. Unreachable targets are reported explicitly, not replaced by an action count. +- Separate intermediate sets in the wall scenario. +- Cost of feedback already specified: a second example and Exclude are separate actions. These are manual scenarios; user strategy optimality is not claimed. +- Preservation of all groups under coordinate transformations, reflection, example reordering and identifier replacement. The camera is not part of the snapshot; UI stability is checked separately. +- Median pure Python ranking time. BRep reading, highlighting, UI latency and Fusion are **not measured** here. -Предварительный офлайн-прогон 25.10.2026 после интеграции контрактов `Descriptor.contours` и `BodySnapshot.wall_pairs`: +## Results -| Корпус / алгоритм | Точный первый набор | Достижимость цели | Precision / recall дополнительных кандидатов | Инвариантность | +Preliminary offline run on 2026-10-25 after integrating the `Descriptor.contours` and `BodySnapshot.wall_pairs` contracts: + +| Corpus / algorithm | Exact first set | Target reachability | Precision / recall of added candidates | Invariance | | --- | --- | --- | --- | --- | -| Разработка, baseline | 5/11 | 7/11 | 0.697 / 0.758 | 11/11 | -| Разработка, текущий | 11/11 | 11/11 | 1.000 / 1.000 | 11/11 | -| Дополнительные сложные задачи, baseline | 2/6 | 4/6 | 0.500 / 0.750 | 6/6 | -| Дополнительные сложные задачи, текущий | 5/6 | 6/6 | 1.000 / 0.917 | 6/6 | +| Development, baseline | 5/11 | 7/11 | 0.697 / 0.758 | 11/11 | +| Development, current | 11/11 | 11/11 | 1.000 / 1.000 | 11/11 | +| Additional challenging tasks, baseline | 2/6 | 4/6 | 0.500 / 0.750 | 6/6 | +| Additional challenging tasks, current | 5/6 | 6/6 | 1.000 / 0.917 | 6/6 | -Дополнительные задачи (`holdout_tasks`) размечены после первичной интеграции и выводятся отдельно: поворот профиля на другую координатную плоскость, криволинейный отвлекающий элемент, неизвестный контур кандидата, неизвестный контур примера, исключение конгруэнтного аналога, два разных повторяющихся семейства с третьим исключённым профилем. Это ручные дополнительные примеры, не статистически независимая оценка рынка. +Additional tasks (`holdout_tasks`) were labelled after the initial integration and are reported separately: rotating a profile into another coordinate plane, a curved distractor, an unknown candidate contour, an unknown example contour, excluding a congruent analogue, and two different recurring families with a third excluded profile. These are additional manually designed examples, not a statistically independent market evaluation. -В первом прогоне дополнительных задач обнаружены два ограничения. Отсутствие контура примера исправлено: автоматический режим сохраняет примеры и сообщает неоднозначность, вместо включения ложной формы по scalar tie. В последующей проверке нескольких пользовательских областей введено объединение проверенных семейств для несвязанных плоских примеров. Задача двух разных семейств теперь даёт точный первый набор; метка задачи сохранена. Итоговые числа нужно переснять после доработок и CAD-приёмки. +The first additional run found two limitations. The missing example contour case was fixed: automatic mode retains the examples and reports ambiguity instead of including a false shape on a scalar tie. A later check of multiple user regions introduced the union of verified families for disconnected planar examples. The two-family task now produces the exact first set; its label was retained. Final numbers need to be measured again after further changes and CAD acceptance. -Сценарий стенки в текущем алгоритме проходит три заданных набора в нужном порядке; от первого предложения до конечной цели требуется два PgUp. Baseline не может выразить промежуточную пару отдельно от других равных по scalar-признакам внутренних граней. Превышение бюджета контура (513 точек) отдельно проверено как контролируемый отказ без частичного ранжирования. +The wall scenario in the current algorithm passes the three specified sets in order; two PgUp steps are needed from the first proposal to the final target. The baseline cannot express the intermediate pair separately from other interior faces with equal scalar features. Exceeding the contour budget (513 points) was separately verified as a controlled failure without partial ranking. -После завершения геометрической интеграции итоговые количества не изменились. Сумма медиан чистого анализа по 11 маленьким задачам составила примерно 0.34 ms baseline и 2.54 ms текущего алгоритма (5 повторов на задачу). Это локальная микрооценка, не показатель задержки команды и не масштабируемости. Машинный отчёт с хэшами исходников сохраняется локально в ignored `artifacts/evaluation/results.json`. +After geometric integration was completed, the final counts did not change. The sum of median pure analysis times across 11 small tasks was approximately 0.34 ms for the baseline and 2.54 ms for the current algorithm (five repeats per task). This is a local microbenchmark, not command latency or a scalability measure. A machine-readable report with source hashes is saved locally in the ignored `artifacts/evaluation/results.json`. -## Нативная проверка и практическая полезность +## Native validation and practical value -На отдельной синтетической CAD-детали подтверждены первое предложение и оба дальнейших уровня пар стенки, реальные PgUp/PgDown, OK/Cancel, сохранность области, отсутствие остаточной графики и неизменность модели. Два примера стенки сразу дали обе соответствующие пары; два соседних примера — геометрически повторённые узлы. Полный протокол и воспроизводимая фикстура — [VALIDATION.md](VALIDATION.md). +On a separate synthetic CAD part, the first proposal and both subsequent wall-pair levels, actual PgUp/PgDown, OK/Cancel, scope preservation, absence of residual graphics and an unchanged model were confirmed. Two wall examples immediately produced both corresponding pairs; two adjacent examples produced geometrically repeated groups. The full protocol and reproducible fixture are in [VALIDATION.md](VALIDATION.md). -Разделённые времена первого запуска: чтение BRep 2.37 ms, топология 0.58 ms, отношения/материал 1.77 ms, чистый анализ 0.48 ms, графика 70.16 ms. Для повторяющегося узла — анализ 1.40 ms, графика 91.53 ms. Графика оказалась основной стоимостью этой малой детали. Изменение диапазона использует готовые данные, без повторного чтения BRep. +Separated first-run times: BRep reading 2.37 ms, topology 0.58 ms, relations/material 1.77 ms, pure analysis 0.48 ms, graphics 70.16 ms. For a repeated group, analysis was 1.40 ms and graphics 91.53 ms. Graphics were the main cost for this small part. Changing the range uses cached data without rereading BRep. -Дополнительный read-only smoke на открытой детали из 39 граней: полное чтение 149.67 ms, анализ 9.22 ms, 6 диапазонов. Это подтверждение отсутствия регрессии области/чтения, а не разметка правильности предложения на пользовательской задаче. Точные пользовательские геометрические данные в корпус не сохранялись. +An additional read-only smoke test on an open 39-face part measured 149.67 ms for full reading, 9.22 ms for analysis and six ranges. This checks for scope/reading regressions; it does not label proposal correctness on a user task. Exact user geometry was not saved in the corpus. -При ревью обнаружено, что пять глубин точечных проб не доказывают непрерывность материала. Нативный эксперимент с узкой полостью между пробами воспроизвёл ложное подтверждение; добавленные BRep-ray пересечения всей контрольной трассы устранили его. Поперёк перекрытия остаются дискретные трассы — вся объёмная стенка не доказана. +Review found that five point-sampling depths do not prove material continuity. A native experiment with a narrow cavity between samples reproduced a false confirmation; added BRep-ray intersections along the full test path eliminated it. Paths across the overlap remain discrete, so the entire wall volume is not proven. -Повтор группы проверяется одной общей 3D-трансформацией. Ложный повтор с одинаковыми формами концов и толщиной, но иным тангенциальным смещением, отклоняется регрессионным тестом. При бюджете или неизвестных данных анализ явно неполон, применение частичного набора не выполняется. +A repeated group is checked using one common 3D transformation. A false repeat with matching end shapes and thickness but different tangential offset is rejected by a regression test. When the budget is exceeded or data is unknown, analysis is explicitly incomplete and a partial set is not applied. -Польза относительно baseline подтверждена для узкого корпуса: правильная форма при равных скалярах и выражаемые тремя уровнями стенки. Пользовательское время на реальных рабочих задачах ещё не измерено. Нельзя переносить 11/11 на произвольные CAD-модели. +Value relative to the baseline is established for the narrow corpus: correct shape with equal scalar features and walls expressible in three levels. User time on real tasks has not yet been measured. The 11/11 result cannot be generalized to arbitrary CAD models. -## Ограничения и следующие проверки +## Limitations and further checks -Области сборки и алиасы =/- внедрены отдельной итерацией. На нативной сборке из 10 видимых тел получены первые наборы 2 / 6 / 20 для This Body / This Component с дочерними компонентами / All Components. Мировая геометрия подсветки совпала с исходными proxy; OK сохранил точные сущности. На пользовательском проекте после устранения отказа по assemblyContext и оптимизации необязательных отношений полное чтение последнего снимка видимости заняло около 0.50 s для 338 граней, анализ — 0.074 s. Это отдельная проверка работоспособности, не новая метка точности корпуса. Подробности — в VALIDATION. +Assembly scopes and +/- aliases were added in a separate iteration. On a native assembly of 10 visible bodies, the first sets contained 2 / 6 / 20 entities for This Body / This Component with children / All Components. World-space highlighting geometry matched the original proxies; OK preserved the exact entities. On a user project, after fixing an assemblyContext failure and optimizing optional relations, a full read of the last visibility snapshot took about 0.50 s for 338 faces and analysis took 0.074 s. This is a separate functionality check, not a new corpus accuracy label. See VALIDATION for details. -Синтетический корпус мал и не позволяет оценивать распространённость пользовательских задач. Нужны размеченные реальные детали и STEP, повторяющиеся многогранные узлы, свободные поверхности, большие тела и Windows CAD. Дискретное нативное свидетельство материала не считается строгим объёмным доказательством стенки. Цели, не выражаемые диапазоном, остаются дефектами или ограничениями модели намерений, даже если precision первого набора выросла. +The synthetic corpus is small and cannot estimate how common user tasks are. Labelled real parts and STEP files, repeated polyhedral groups, freeform surfaces, large bodies and Windows CAD are needed. Discrete native material evidence is not strict volumetric proof of a wall. Targets that cannot be expressed by a range remain defects or limitations of the intent model even if first-set precision improves. -После введения порядка плоскостей 25.10.2026 development остаётся 11/11, holdout — 4/6 точных первых наборов и 6/6 достижимых целей, инвариантность 6/6. Историческая метка `holdout-spatial-rotation` ожидала немедленное объединение одинаковых форм в разных плоскостях; новое требование намеренно разделяет их, поэтому эта цель теперь достигается за один шаг. Метка сохранена без подгонки. Десять отдельных тестов плоскостей проверяют новый контракт, включая размеры, исключения, несколько примеров, неизвестные данные и преобразование координат. Нативное подтверждение: This Component 4→8→10, All Components 4→8→20 круговых кромок; точный перенос результата по OK и очистка графики проверены отдельно, см. VALIDATION. +After plane ordering was introduced on 2026-10-25, development remained at 11/11, holdout at 4/6 exact first sets and 6/6 reachable targets, with 6/6 invariance. The historical `holdout-spatial-rotation` label expected immediate union of identical shapes in different planes; the new requirement deliberately separates them, so that target is now reached in one step. The label was retained without fitting it to the result. Ten separate plane tests check the new contract, including dimensions, exclusions, multiple examples, unknown data and coordinate transformations. Native confirmation: This Component 4→8→10, All Components 4→8→20 circular edges; exact transfer on OK and graphics cleanup were checked separately; see VALIDATION. -После исправления нескольких областей development — 11/11, holdout — 5/6 первых наборов, 6/6 достижимых целей, precision/recall дополнительных кандидатов 1.000/0.917. `holdout-two-shape-families` теперь проходит сразу; пространственный поворот остаётся намеренно отдельным шагом по политике плоскостей. На локальном числовом снимке текущих двух фигурных граней пользовательской детали первый набор изменился с 26 до 6; анализ занял около 0.37 s. Снимок хранится только локально, в публичный корпус пользовательская геометрия не включена. +After fixing multiple regions, development was 11/11, holdout 5/6 first sets and 6/6 reachable targets, with added-candidate precision/recall of 1.000/0.917. `holdout-two-shape-families` now passes immediately; spatial rotation remains an intentional separate step under the plane policy. On a local numeric snapshot of the two current shaped faces of a user part, the first set changed from 26 to 6; analysis took about 0.37 s. The snapshot is kept locally only; user geometry is not included in the public corpus. -Итерация криволинейных пазов 26.10.2026 не меняет старые метки: development 11/11, holdout 5/6 первых наборов и 6/6 достижимых. Дополнительно выполнены семь регрессий групп и нативная последовательность 12→18→12 на несохранённой копии выбранных пазов, с точным OK и неизменностью исходных тел. Старые числа корпуса не являются оценкой точности нового класса NURBS-групп. +The 2026-10-26 curved-groove iteration does not change the old labels: development 11/11, holdout 5/6 first sets and 6/6 reachable targets. Seven additional group regressions and a native 12→18→12 sequence on an unsaved copy of selected grooves were performed, with exact OK and unchanged original bodies. The old corpus numbers are not an accuracy evaluation of the new NURBS group class. diff --git a/docs/EVALUATION.ru.md b/docs/EVALUATION.ru.md new file mode 100644 index 0000000..9795c1d --- /dev/null +++ b/docs/EVALUATION.ru.md @@ -0,0 +1,66 @@ +# Оценка инженерных итераций Selectra + +[English](EVALUATION.md) | Русский + +## Методика + +Baseline — неизменённый алгоритм `ranking.py` из `c5ac432`, сохранённый в `evaluation/baseline_c5ac432.py`. Отличается только путём импорта чистых типов `Tolerance` и `_angle`. Новая реализация сравнивается с ним на одном корпусе `evaluation/corpus.py`. + +Корпус **синтетический**, без пользовательских моделей. Метки заданы задачей: одинаковая длина/ось; второй пример; исключение; неразличимое исключение; U/T-контуры с одинаковыми площадью, периметром и числом сторон; перенос/поворот/отражение; смещение отверстия; последовательность аналог → своя стенка → стенка аналога; пустая полость; близкие размерные семейства. + +Команда: `python3 scripts/evaluate_selection.py --json artifacts/evaluation/results.json`. + +Измеряются: + +- Точное совпадение первого предложения с целевым набором. Для многошагового сценария стенки первый набор сравнивается с первым checkpoint, достижимость и шаги — с конечной целью. +- Precision/recall только добавленных кандидатов; явные примеры не дают бесплатных правильных ответов. При пустом правильном и предсказанном добавлении обе метрики равны 1. +- Достижимость целевого набора каким-либо вложенным диапазоном и минимальное число шагов PgUp/PgDown от автоматического диапазона. Недостижимость показывается явно, не заменяется числом действий. +- Отдельные промежуточные наборы сценария стенки. +- Стоимость уже заданной обратной связи: второй пример и Exclude считаются отдельными действиями. Это ручные сценарии; оптимальность стратегии пользователя не заявляется. +- Сохранение всех групп при преобразовании координат, отражении, перестановке примеров и замене идентификаторов. Камера в снимок не входит; UI-устойчивость проверяется отдельно. +- Медиана времени чистого ранжирования в Python. Чтение BRep, подсветка, задержка UI и Fusion здесь **не измеряются**. + +## Результаты + +Предварительный офлайн-прогон 25.10.2026 после интеграции контрактов `Descriptor.contours` и `BodySnapshot.wall_pairs`: + +| Корпус / алгоритм | Точный первый набор | Достижимость цели | Precision / recall дополнительных кандидатов | Инвариантность | +| --- | --- | --- | --- | --- | +| Разработка, baseline | 5/11 | 7/11 | 0.697 / 0.758 | 11/11 | +| Разработка, текущий | 11/11 | 11/11 | 1.000 / 1.000 | 11/11 | +| Дополнительные сложные задачи, baseline | 2/6 | 4/6 | 0.500 / 0.750 | 6/6 | +| Дополнительные сложные задачи, текущий | 5/6 | 6/6 | 1.000 / 0.917 | 6/6 | + +Дополнительные задачи (`holdout_tasks`) размечены после первичной интеграции и выводятся отдельно: поворот профиля на другую координатную плоскость, криволинейный отвлекающий элемент, неизвестный контур кандидата, неизвестный контур примера, исключение конгруэнтного аналога, два разных повторяющихся семейства с третьим исключённым профилем. Это ручные дополнительные примеры, не статистически независимая оценка рынка. + +В первом прогоне дополнительных задач обнаружены два ограничения. Отсутствие контура примера исправлено: автоматический режим сохраняет примеры и сообщает неоднозначность, вместо включения ложной формы по scalar tie. В последующей проверке нескольких пользовательских областей введено объединение проверенных семейств для несвязанных плоских примеров. Задача двух разных семейств теперь даёт точный первый набор; метка задачи сохранена. Итоговые числа нужно переснять после доработок и CAD-приёмки. + +Сценарий стенки в текущем алгоритме проходит три заданных набора в нужном порядке; от первого предложения до конечной цели требуется два PgUp. Baseline не может выразить промежуточную пару отдельно от других равных по scalar-признакам внутренних граней. Превышение бюджета контура (513 точек) отдельно проверено как контролируемый отказ без частичного ранжирования. + +После завершения геометрической интеграции итоговые количества не изменились. Сумма медиан чистого анализа по 11 маленьким задачам составила примерно 0.34 ms baseline и 2.54 ms текущего алгоритма (5 повторов на задачу). Это локальная микрооценка, не показатель задержки команды и не масштабируемости. Машинный отчёт с хэшами исходников сохраняется локально в ignored `artifacts/evaluation/results.json`. + +## Нативная проверка и практическая полезность + +На отдельной синтетической CAD-детали подтверждены первое предложение и оба дальнейших уровня пар стенки, реальные PgUp/PgDown, OK/Cancel, сохранность области, отсутствие остаточной графики и неизменность модели. Два примера стенки сразу дали обе соответствующие пары; два соседних примера — геометрически повторённые узлы. Полный протокол и воспроизводимая фикстура — [VALIDATION.md](VALIDATION.md). + +Разделённые времена первого запуска: чтение BRep 2.37 ms, топология 0.58 ms, отношения/материал 1.77 ms, чистый анализ 0.48 ms, графика 70.16 ms. Для повторяющегося узла — анализ 1.40 ms, графика 91.53 ms. Графика оказалась основной стоимостью этой малой детали. Изменение диапазона использует готовые данные, без повторного чтения BRep. + +Дополнительный read-only smoke на открытой детали из 39 граней: полное чтение 149.67 ms, анализ 9.22 ms, 6 диапазонов. Это подтверждение отсутствия регрессии области/чтения, а не разметка правильности предложения на пользовательской задаче. Точные пользовательские геометрические данные в корпус не сохранялись. + +При ревью обнаружено, что пять глубин точечных проб не доказывают непрерывность материала. Нативный эксперимент с узкой полостью между пробами воспроизвёл ложное подтверждение; добавленные BRep-ray пересечения всей контрольной трассы устранили его. Поперёк перекрытия остаются дискретные трассы — вся объёмная стенка не доказана. + +Повтор группы проверяется одной общей 3D-трансформацией. Ложный повтор с одинаковыми формами концов и толщиной, но иным тангенциальным смещением, отклоняется регрессионным тестом. При бюджете или неизвестных данных анализ явно неполон, применение частичного набора не выполняется. + +Польза относительно baseline подтверждена для узкого корпуса: правильная форма при равных скалярах и выражаемые тремя уровнями стенки. Пользовательское время на реальных рабочих задачах ещё не измерено. Нельзя переносить 11/11 на произвольные CAD-модели. + +## Ограничения и следующие проверки + +Области сборки и алиасы =/- внедрены отдельной итерацией. На нативной сборке из 10 видимых тел получены первые наборы 2 / 6 / 20 для This Body / This Component с дочерними компонентами / All Components. Мировая геометрия подсветки совпала с исходными proxy; OK сохранил точные сущности. На пользовательском проекте после устранения отказа по assemblyContext и оптимизации необязательных отношений полное чтение последнего снимка видимости заняло около 0.50 s для 338 граней, анализ — 0.074 s. Это отдельная проверка работоспособности, не новая метка точности корпуса. Подробности — в VALIDATION. + +Синтетический корпус мал и не позволяет оценивать распространённость пользовательских задач. Нужны размеченные реальные детали и STEP, повторяющиеся многогранные узлы, свободные поверхности, большие тела и Windows CAD. Дискретное нативное свидетельство материала не считается строгим объёмным доказательством стенки. Цели, не выражаемые диапазоном, остаются дефектами или ограничениями модели намерений, даже если precision первого набора выросла. + +После введения порядка плоскостей 25.10.2026 development остаётся 11/11, holdout — 4/6 точных первых наборов и 6/6 достижимых целей, инвариантность 6/6. Историческая метка `holdout-spatial-rotation` ожидала немедленное объединение одинаковых форм в разных плоскостях; новое требование намеренно разделяет их, поэтому эта цель теперь достигается за один шаг. Метка сохранена без подгонки. Десять отдельных тестов плоскостей проверяют новый контракт, включая размеры, исключения, несколько примеров, неизвестные данные и преобразование координат. Нативное подтверждение: This Component 4→8→10, All Components 4→8→20 круговых кромок; точный перенос результата по OK и очистка графики проверены отдельно, см. VALIDATION. + +После исправления нескольких областей development — 11/11, holdout — 5/6 первых наборов, 6/6 достижимых целей, precision/recall дополнительных кандидатов 1.000/0.917. `holdout-two-shape-families` теперь проходит сразу; пространственный поворот остаётся намеренно отдельным шагом по политике плоскостей. На локальном числовом снимке текущих двух фигурных граней пользовательской детали первый набор изменился с 26 до 6; анализ занял около 0.37 s. Снимок хранится только локально, в публичный корпус пользовательская геометрия не включена. + +Итерация криволинейных пазов 26.10.2026 не меняет старые метки: development 11/11, holdout 5/6 первых наборов и 6/6 достижимых. Дополнительно выполнены семь регрессий групп и нативная последовательность 12→18→12 на несохранённой копии выбранных пазов, с точным OK и неизменностью исходных тел. Старые числа корпуса не являются оценкой точности нового класса NURBS-групп. From 085fd4628952d862fb681457ee65db130b5c8385 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sun, 8 Nov 2026 11:04:06 +0300 Subject: [PATCH 14/14] docs: translate Fusion validation record --- docs/VALIDATION.md | 252 +++++++++++++++++++++--------------------- docs/VALIDATION.ru.md | 225 +++++++++++++++++++++++++++++++++++++ 2 files changed, 352 insertions(+), 125 deletions(-) create mode 100644 docs/VALIDATION.ru.md diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index 1278aaa..57c67ee 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -1,223 +1,225 @@ -# Проверка Selectra внутри Fusion +# Selectra validation in Fusion -Статус 25.10.2026: **частичная нативная приёмка выполнена** в Autodesk Fusion 2706.1.14 на macOS. Сначала разработка шла полностью офлайн; после разрешения пользователя тесты выполнялись на его открытой модели. Полная матрица ниже остаётся протоколом для следующих проверок. +English | [Русский](VALIDATION.ru.md) -Локально после геометрической итерации: 134 Python-теста — OK; compileall, metadata/SPDX/ссылки и ZIP/SHA-256 — OK. Эти проверки не заменяют CAD-приёмку. Историческая базовая приёмка ниже выполнялась при 64 тестах. +Status 10.25.2026: **partial native acceptance completed** in Autodesk Fusion 2706.1.14 on macOS. At first, development was completely offline; After the user's permission, tests were performed on his open model. The complete matrix below remains the protocol for the following checks. -## Геометрическая итерация 25.10.2026 +Locally after geometric iteration: 134 Python tests - OK; compileall, metadata/SPDX/links and ZIP/SHA-256 - OK. These checks do not replace CAD acceptance. The historical baseline acceptance below was performed with 64 tests. -### Исправление чтения внутренней грани +## Geometric iteration 10/25/2026 -После пользовательского сообщения воспроизведён дефект на выбранной внутренней грани текущего тела: вместо её противоположного внутреннего аналога первой шла наружная сторона исходной стенки. Площадь и периметр внутреннего аналога совпадали, но контур читался неверно. Для части BRep-рёбер направление параметризации evaluator противоположно направлению самого ребра; учитывался только coedge.isOpposedToEdge, без edge.isParamReversed. Между последовательными участками ошибочной границы появлялись большие скачки. +### Correcting internal face reading -Обе ориентации теперь компонуются через XOR, непрерывность и замыкание проверяются до передачи контура в ядро. Протокольный тест `tests/test_fusion_contours.py` воспроизвёл сбой на синтетическом контуре со смешанной параметризацией и прошёл после исправления. На исходной выбранной грани после исправления первый уровень снова содержит только противоположный внутренний аналог с объяснением shape; наружная пара переместилась на следующий уровень. Пользовательская геометрия не включается в регрессионный корпус. +After the user message, the defect on the selected internal face of the current body was reproduced: instead of its opposite internal analogue, the outer side of the original wall came first. The area and perimeter of the internal analogue were the same, but the contour was read incorrectly. For some BRep edges, the direction of the evaluator parameterization is opposite to the direction of the edge itself; Only coedge.isOpposedToEdge was taken into account, without edge.isParamReversed. Large jumps appeared between successive sections of the erroneous boundary. -### Основная приёмка итерации +Both orientations are now XORed, continuity and closure are checked before the outline is passed to the kernel. The `tests/test_fusion_contours.py` protocol test reproduced the failure on a synthetic circuit with mixed parameterization and passed after correction. On the original selected face, after correction, the first level again contains only the opposite internal analog with the shape explanation; the outer pair has moved to the next level. User geometry is not included in the regression corpus. -Для исправления ориентации повторно проверен именно зарегистрированный перезагруженный add-in в открытом пользовательском документе: начальный набор — исходная внутренняя грань и её противоположный внутренний аналог. Временная графика совпала с набором; следующие уровни — непосредственная наружная пара и пара аналога. Геометрия, ревизия, площадь, объём и число граней/рёбер остались прежними. После исправления проходят 135 Python-тестов; синтетический корпус сохраняет результаты 11/11 и 5/6. Исправленный предпросмотр оставлен открытым для пользователя. +### Basic iteration acceptance -Fusion 2706.1.14, macOS, зарегистрированный add-in текущей рабочей ветки. Основной координатор работал последовательно; субагенты выполняли только офлайн-задачи. +To correct the orientation, it is the registered reloaded add-in in the open user document that is re-checked: the initial set is the original internal face and its opposite internal analogue. The temporary graphics coincided with the set; the next levels are the direct outer pair and the analogue pair. Geometry, revision, area, volume and number of faces/edges remain the same. After the fix, 135 Python tests are passed; the synthetic corpus maintains results of 11/11 and 5/6. The corrected preview is left open to the user. -В отдельном несохранённом документе создано замкнутое тонкостенное тело: 12 граней, 24 ребра, внешний размер 10×6×2 cm и внутренняя полость 9.6×5.6×1.6 cm. Второе идентичное тело исключено из области поиска. Воспроизводимая фикстура — `tests/fusion_geometric_acceptance.py`; она использует вычисленные тела BaseFeature после finishEdit, а не ссылки на edit bodies. +Fusion 2706.1.14, macOS, registered add-in of the current working branch. The main coordinator worked consistently; subagents performed only offline tasks. -- Полный снимок содержит 12 граней и 6 локальных пар стенок. Первые три группы: внешний аналог → внутренняя сторона стенки примера → внутренняя сторона аналога. Проверены точные сущности и их родительское тело. -- PgUp: 2→3 грани, PgDown: 3→2. Последний уровень имеет отдельный контур; видимость и переиспользование графики проверены readback, заливка и контур просмотрены в UI. Непрозрачность обеих граней: API `(True, 0.349999994, True)`. -- Два предвыбранных примера противоположных сторон задают wall_sides: выбраны ровно 4 грани двух соответствующих стенок. После настоящего OK activeSelections точно совпал с предпросмотром; graphics groups = 0. -- Два связанных примера разных размеров задают repeated_region. Найдены ровно 4 внешние грани соответствующих узлов; начальный анализ около 1.4 ms, подсветка около 92 ms. -- Настоящий Cancel восстановил исходный пример; graphics groups = 0. После всех проверок fingerprint геометрии/таймлайна тестового и исходного документов совпал. Созданный документ закрыт без сохранения, исходный активирован; пользовательские документы не сохранялись и не закрывались. -- Отдельное тело 4×4×0.2 cm с узкой замкнутой полостью между глубинами проб показало ложность только пяти точечных проб. Проверка пересечений всей трассы отклонила эту пару; в снимке ложной связи нет. -- На проверенном ядре ray proximityTolerance 1e-7 cm возвращал пустые коллекции; 1e-6 cm дал согласованные hitPoints и сущности. Используется 1e-6 cm с обязательным подтверждением достижения противоположной грани. Пустой/несогласованный результат не считается доказательством материала. +In a separate unsaved document, a closed thin-walled body was created: 12 faces, 24 edges, external size 10 × 6 × 2 cm and internal cavity 9.6 × 5.6 × 1.6 cm. The second identical body is excluded from the search area. Reproducible fixture - `tests/fusion_geometric_acceptance.py`; it uses the calculated BaseFeature bodies after finishEdit, rather than references to edit bodies. -Первый обычный запуск фикстуры: BRep 2.37 ms, топология 0.58 ms, отношения 1.77 ms; суммарное чтение 4.86 ms, анализ 0.48 ms, графика 70.16 ms. Это малая синтетическая деталь; масштабируемость отсюда не следует. +- The full snapshot contains 12 faces and 6 local pairs of walls. The first three groups: external analogue → internal side of the example wall → internal side of the analogue. The exact entities and their parent body are verified. +- PgUp: 2→3 faces, PgDown: 3→2. The last level has a separate circuit; Visibility and reuse of graphics are checked by readback, fill and outline are checked in the UI. Opacity of both faces: API `(True, 0.349999994, True)`. +- Two preselected examples of opposite sides set wall_sides: exactly 4 faces of the two corresponding walls are selected. After this OK activeSelections exactly matched the preview; graphics groups = 0. +- Two related examples of different sizes define repeated_region. Exactly 4 external faces of the corresponding nodes are found; initial analysis about 1.4 ms, highlighting about 92 ms. +- This Cancel restored the original example; graphics groups = 0. After all the checks, the fingerprint of the geometry/timeline of the test and source documents matched. The created document is closed without saving, the original one is activated; User documents were not saved or closed. +- A separate body 4×4×0.2 cm with a narrow closed cavity between the sample depths showed the falsehood of only five point samples. An intersection check of the entire route rejected this pair; There is no false connection in the picture. +- On the tested core, ray proximityTolerance 1e-7 cm returned empty collections; 1e-6 cm gave consistent hitPoints and entities. 1e-6 cm is used with mandatory confirmation of reaching the opposite face. A blank/inconsistent result is not considered evidence of material. -После финальной перезагрузки add-in выполнен дополнительный read-only smoke текущего исходника на открытой пользовательской модели: 39 граней, полный scope, 11 связей с локальным свидетельством материала, 6 диапазонов для выбранной плоской грани. BRep 17.73 ms, топология 4.54 ms, отношения 127.00 ms, суммарное чтение 149.67 ms, анализ 9.22 ms. Геометрия, ревизия, видимость и таймлайн до/после совпали. Правильность каждого из 11 отношений вручную в этом smoke не оценивалась; новый UI-предпросмотр на пользовательской детали не запускался. +First normal fixture run: BRep 2.37 ms, topology 0.58 ms, relations 1.77 ms; total reading 4.86 ms, analysis 0.48 ms, graphics 70.16 ms. This is a small synthetic part; scalability does not follow from here. -Exclude в живом диалоге в этой итерации не принят: попытка внешнего тестового обработчика не добавила элемент в CommandInput, поэтому не засчитана как проверка. Чистое ядро и ограничения исключений покрыты тестами. Вращение камеры, полная матрица прерываний, реальные STEP и Windows для новой реализации ещё требуются. +After the final add-in reload, an additional read-only smoke of the current source was performed on the open user model: 39 faces, full scope, 11 connections with local material evidence, 6 ranges for the selected flat face. BRep 17.73 ms, topology 4.54 ms, relations 127.00 ms, total read 149.67 ms, analysis 9.22 ms. Geometry, revision, visibility and timeline before/after matched. The correctness of each of the 11 relationships in this smoke was not manually assessed; The new UI preview on the user part was not launched. -## Выполнено в Fusion +Exclude in the live dialog was not accepted in this iteration: the attempt by the external test handler did not add an element to the CommandInput, so it is not counted as a check. The pure core and exception restrictions are covered by tests. Camera rotation, a full interrupt matrix, real STEP and Windows are still required for the new implementation. -- Штатно подключён add-in из текущего checkout, Run on Startup выключен. Временный импорт MCP не используется как доказательство UI. -- В событии настоящего меню ПКМ подтверждено добавление Select Similar. -- Один root body: 97 рёбер, 39 граней. Read-only контракт проверил по 8 примеров каждого типа: ранжирование полное, диапазоны вложены, максимум охватывает все допустимые сущности этого тела. -- Рёбра: начальный ранжированный набор 4; PgUp дал 8; PgDown вернул 4. По реальному OK activeSelections точно совпал с зафиксированными ключами этих 4 рёбер. -- Грани: начальный набор 2; PgUp дал 3; PgDown вернул 2. Magenta-наложение видно на реальных поверхностях, в том числе через перекрывающую геометрию. -- После паузы графика оставалась видимой без нового кадра. После устранения двойного doExecutePreview на изменение диапазона приходится один обновлённый кадр. -- На пользовательском примере тонкой стенки воспроизведён ошибочный порядок: поперечная внутренняя грань шла раньше параллельной из-за направленной нормали. Исправленный Automatic проверен на полном неизменённом снимке тела: внешняя похожая → параллельная внутренняя → поперечная внутренняя. Отдельный регрессионный тест сохраняет этот порядок, а явный Orientation — направленную семантику. -- После перезагрузки текущего add-in на том же примере подтверждены стартовый уровень 1 с двумя гранями и порядок следующих групп. Нативный getOpacity вернул 0.35 с override для обеих графических граней; заливка визуально стала полупрозрачной. Значение хранится API с точностью float. -- Cancel вернул исходную грань. После OK и Cancel customGraphicsGroups = 0. -- В контрольной сессии сравнивались объём, площадь, число граней/рёбер, видимость, ревизии тел и таймлайн: изменений не было. Документ не сохранялся. +## Completed in Fusion -Офлайн-ядро дополнительно проверяет исключения, конфликт обратной связи, историю, одинаковые оценки, явные критерии, scope/revision и ограниченный поиск похожих регионов. Наличие этих тестов не означает, что все соответствующие UI-сценарии уже пройдены. +- The add-in from the current checkout is normally connected, Run on Startup is disabled. Temporary MCP imports are not used as proof of UI. +- Adding Select Similar has been confirmed in the current RMB menu event. +- One root body: 97 edges, 39 faces. The Read-only contract checked 8 examples of each type: the ranking is complete, the ranges are nested, the maximum covers all valid entities of this body. +- Edges: initial ranked set 4; PgUp gave 8; PgDown returned 4. In reality, OK activeSelections exactly matched the fixed keys of these 4 edges. +- Edges: initial set 2; PgUp gave 3; PgDown returned 2. Magenta overlay is visible on real surfaces, including through overlapping geometry. +- After a pause, the graphics remained visible without a new frame. After eliminating the double doExecutePreview, there is one updated frame per range change. +- On a user example of a thin wall, an erroneous order was reproduced: the transverse internal face came before the parallel one due to the directed normal. The corrected Automatic is tested on a full unaltered body shot: external similar → parallel internal → transverse internal. A separate regression test preserves this order, and an explicit Orientation preserves directional semantics. +- After reloading the current add-in using the same example, the starting level 1 with two faces and the order of the following groups were confirmed. Native getOpacity returned 0.35 with override for both graphic faces; the fill became visually translucent. The value is stored by the API with float precision. +- Cancel returned the original face. After OK and Cancel customGraphicsGroups = 0. +- In the control session, volume, area, number of faces/edges, visibility, body revisions and timeline were compared: there were no changes. The document was not saved. -## Приёмка областей сборки и клавиш =/- — 25.10.2026 +The offline kernel additionally checks for exceptions, feedback conflict, history, equal scores, explicit criteria, scope/revision, and limited similar region searches. The presence of these tests does not mean that all relevant UI scenarios have already been passed. -Внедрены This Body / This Component / All Components; начальный режим — This Component. Он включает тела выбранного экземпляра и его дочернюю иерархию. Для корневого компонента это вся сборка. Видимость и доступность для выбора учитываются при чтении. +## Acceptance of assembly areas and keys =/- - 10.25.2026 -На отдельном несохранённом документе `tests/fusion_scope_acceptance.py` построены тела корневого компонента, два экземпляра одного определения и ещё один вложенный экземпляр; затем добавлен дочерний компонент выбранного определения. Проверены повороты вокруг разных осей и переносы. +Implemented This Body / This Component / All Components; the initial mode is This Component. It includes the bodies of the selected instance and its child hierarchy. For the root component, this is the entire assembly. Visibility and selectability are taken into account when reading. -| Режим | Тела / грани области | Первый набор | +The bodies of the root component, two instances of one definition and another nested instance are built on a separate unsaved document `tests/fusion_scope_acceptance.py`; then the child component of the selected definition is added. Rotations around different axes and translations were tested. + +| Mode | Region bodies/faces | First set | | --- | --- | --- | | This Body | 1 / 6 | 2 | -| This Component с дочерним компонентом | 3 / 18 | 6 | +| This Component with child component | 3 / 18 | 6 | | All Components | 10 / 60 | 20 | -Режимы переключались настоящим нативным списком. Все ключи уникальны, временная BRep-заливка совпала с мировыми boundingBox граней с ошибкой менее 1e-6 cm; контуры — менее 1e-5 cm (координаты графики float32). После OK activeSelections содержал ровно ожидаемые 20 исходных proxy-граней; graphics groups = 0. Cancel также очищал графику и восстанавливал исходный выбор. +Modes were switched with a real native list. All keys are unique, the temporary BRep fill coincided with the world boundingBox faces with an error of less than 1e-6 cm; contours - less than 1e-5 cm (graphic coordinates float32). After OK, activeSelections contained exactly the expected 20 original proxy faces; graphics groups = 0. Cancel also cleared the graphics and restored the original selection. -Клавиши =, -, PgUp, PgDown на одном и том же диапазоне дали соответственно 18, 6, 18, 6 граней, уровни 2, 1, 2, 1. Учитывается Shift, который текущая раскладка передавала вместе с =; Ctrl/Alt/Meta эти алиасы не перехватывают. +The keys =, -, PgUp, PgDown on the same range gave respectively 18, 6, 18, 6 faces, levels 2, 1, 2, 1. Shift is taken into account, which the current layout transmitted along with =; Ctrl/Alt/Meta does not intercept these aliases. -Отдельно проверены: скрытый экземпляр с дочерним компонентом не попал в All Components; изменение transform2 сделало прежний scope guard невалидным; This Component для корневого тела охватил всю сборку. На тонком теле внутри повёрнутого экземпляра нативная проверка материала подтвердила пару стенок. Два начальных примера из разных тел одного компонента корректно получили разные пространства ключей и общий результат. +Separately checked: the hidden instance with a child component was not included in All Components; the change to transform2 made the previous scope guard invalid; This Component for the root body covered the entire assembly. On the thin body inside the rotated specimen, native material testing confirmed a pair of walls. Two initial examples from different bodies of the same component correctly obtained different key spaces and the overall result. -Пользовательский проект, ранее отклонявшийся из-за assemblyContext, прочитан без изменения геометрии. На последнем снимке видимости: This Body — 57 граней; This Component — 2 тела / 114 граней; All Components — 5 видимых тел / 338 граней. Суммарное чтение: 0.430 / 0.432 / 0.504 s, чистый анализ: 0.028 / 0.071 / 0.074 s. На более раннем снимке видимости All Components включал 14 тел / 428 граней; изменение видимости пользователем не считается регрессией. Отказ необязательного этапа стенок сообщает ограничение и целиком сбрасывает его пары; полное чтение сущностей и доступные доказательства формы сохраняются. +A user design previously rejected due to assemblyContext was read without changing the geometry. In the last visibility snapshot: This Body - 57 faces; This Component - 2 bodies / 114 faces; All Components - 5 visible bodies / 338 faces. Total reading: 0.430 / 0.432 / 0.504 s, pure analysis: 0.028 / 0.071 / 0.074 s. In an earlier visibility snapshot, All Components included 14 bodies/428 faces; changing user visibility is not considered a regression. Failure of the optional wall stage communicates the constraint and resets its pairs entirely; full entity readings and available form proofs are preserved. -В этой итерации проходят 140 Python-тестов; реальные Windows CAD и вся релизная матрица остаются открыты. Пользовательские документы не сохранялись и не закрывались, тестовые документы закрыты без сохранения. +This iteration runs 140 Python tests; real Windows CAD and the entire release matrix remain open. User documents were not saved or closed, test documents were closed without saving. -## Ещё требуется +## Still required -Полная ручная проверка Examples/Exclude и всех Match-режимов, разные пользовательские детали и STEP, бюджеты большой подсветки, прерывание другой командой/смена документа во всех фазах, применение полученного набора в штатной операции и Windows Fusion. Отдельные команды Native topology/Face Regions UI пока не подключены; автоматический повтор по связанным примерам проверен выше. +Full manual check of Examples/Exclude and all Match modes, various user parts and STEP, large highlighting budgets, interruption by another command/change of document in all phases, application of the resulting set in standard operation and Windows Fusion. Some Native topology/Face Regions UI commands are not yet enabled; automatic repetition on related examples is checked above. -Использовать отдельный несохранённый документ. Одна CAD-сессия; не закрывать и не менять пользовательские документы. Зафиксировать исходный активный документ, ОС, Fusion version, путь загруженного add-in и число тел/граней/рёбер. +Use a separate unsaved document. One CAD session; do not close or change user documents. Record the original active document, OS, Fusion version, path of the loaded add-in and the number of bodies/faces/edges. -## Корпус +## Corpus -Создать root body с рёбрами одинаковой длины разных направлений, параллельными рёбрами разных длин, круговыми кромками и цилиндрами нескольких радиусов. Добавить второе тело с идентичными признаками как отрицательный пример области. Отдельно — STEP с аналогичной геометрией, плоские грани равной площади с разным периметром, противоположно направленные плоскости, внутренний и наружный цилиндры одинакового радиуса. +Create a root body with edges of the same length in different directions, parallel edges of different lengths, circular edges and cylinders of several radii. Add a second body with identical features as a negative example of an area. Separately - STEP with similar geometry, flat faces of equal area with different perimeter, oppositely directed planes, inner and outer cylinders of the same radius. -## Матрица +## Matrix -| Проверка | Критерий | +| Check | Criterion | | --- | --- | -| ПКМ с выбранным ребром/гранью | Ровно один Select Similar, штатные пункты сохранены | -| ПКМ без выбора / mesh / смешанные типы | Команда не предлагается | -| Два примера одного тела | Ядро использует оба, порядок не влияет | -| Примеры разных тел | Явный отказ без расширения области | -| Поиск при одинаковом втором теле | Ноль результатов из второго тела | -| Component occurrence | В spike явный отказ; после этапа 4 — только выбранное тело выбранного экземпляра | -| Предпросмотр | Magenta постоянна, число соответствует ранжированному диапазону, поля Preview нет | -| Refine | Изменение примеров/исключений и критериев не перечитывает всё BRep; нет рекурсии | -| Нет совпадений | Примеры сохраняются, диапазон можно расширить, Cancel работает | -| OK | После закрытия выделение совпадает с Magenta-подсветкой, готово для штатной операции | -| Cancel / Esc | При том же документе и default Select восстановлены исходные примеры | -| Прерывание другой командой | Selectra не выполняется неявно и не перезаписывает выбор новой команды | -| Смена документа до idle | Отложенный перенос не меняет новый документ | -| Невалидная сущность | Контролируемый отказ, нет частично применённого набора | -| Stop / Run | Обработчики и команды не дублируются; отложенный callback после Stop не меняет выбор | -| Модель до/после | Тела, геометрия, таймлайн и состояние modified не изменены Selectra | -| Плотная перфорация | Отдельно замерены чтение, ранжирование и массовая подсветка; отказ по лимиту не выдаётся за полный результат | +| RMB with selected edge/face | Exactly one Select Similar, standard items saved | +| RMB without choice / mesh / mixed types | Command not offered | +| Two examples of one body | The kernel uses both, the order does not affect | +| Examples of different bodies | Explicit failure without scope expansion | +| Search with the same second body | Zero results from the second body | +| Component occurrence | There is a clear failure in spike; after step 4 - only the selected body of the selected instance | +| Preview | Magenta is constant, the number corresponds to the ranked range, there is no Preview field | +| Refine | Changing examples/exceptions and criteria does not re-read the entire BRep; no recursion | +| No matches | Examples are saved, the range can be expanded, Cancel works | +| OK | After closing, the selection matches the Magenta highlight, ready for normal operation | +| Cancel/Esc | With the same document and default Select, the original examples are restored | +| Abort by another command | Selectra is not executed implicitly and does not overwrite the selection of the new command | +| Change document to idle | Deferred migration does not change the new document | +| Invalid entity | Controlled failure, no partially applied set | +| Stop/Run | Handlers and commands are not duplicated; deferred callback after Stop does not change the choice | +| Model before/after | Bodies, geometry, timeline and modified state are not changed Selectra | +| Dense perforation | Reading, ranking and mass illumination were measured separately; refusal according to the limit is not given as a full result | -Проверить геометрическое соответствие каждого результата, а не только число элементов. На двух внешне одинаковых телах недостаточно проверить количество: проверить родительское тело всех выделенных объектов. +Check the geometric consistency of each result, not just the number of elements. On two externally identical bodies, it is not enough to check the quantity: check the parent body of all selected objects. -## Что сохранить в отчёте +## What to save in the report -Для сценария: параметры модели, исходные tempId в пределах неизменённого тела, выбранная гипотеза, ожидаемый/фактический набор, длительности и скриншот там, где нужен визуальный результат. Сравнивать entityToken как строки запрещено; долговременную идентичность разрешать через API. +For the scenario: model parameters, initial tempId within the unchanged body, selected hypothesis, expected/actual set, durations and a screenshot where a visual result is needed. Comparing entityTokens as strings is not allowed; Resolve long-term identity via API. -Локальные тесты проверяют вывод гипотез и числовые допуски. Static API definitions подтверждают существование методов, но не порядок событий, отрисовку или сохранение выбора. Только эта матрица на реальном Fusion закрывает техническую приёмку. +Local tests test hypotheses and numerical tolerances. Static API definitions validate the existence of methods, but not the order of events, drawing, or saving selections. Only this matrix on a real Fusion closes technical acceptance. -## Порядок плоскостей — нативная проверка 25.10.2026 +## Plane order - native check 10/25/2026 -На macOS в отдельном несохранённом DirectDesign выполнен сценарий `tests/fusion_plane_acceptance.py`: пластина с четырьмя сквозными отверстиями радиуса 0.2 cm и отдельный перпендикулярный цилиндр. Исходный экземпляр повёрнут на 0.35 rad вокруг Y; второй экземпляр определения повёрнут вокруг X и перенесён. Пользовательский документ не редактировался. +On macOS, in a separate unsaved DirectDesign, the `tests/fusion_plane_acceptance.py` scenario was executed: a plate with four through holes of radius 0.2 cm and a separate perpendicular cylinder. The original instance is rotated 0.35 rad around Y; the second instance of the definition is rotated around X and moved. The user document has not been edited. -В This Component реальные = и PgUp дали 4 → 8 → 10 круговых кромок: плоскость выбранного входа отверстия → параллельная обратная сторона → перпендикулярный цилиндр. В All Components получены 4 → 8 → 20: кромки другого повёрнутого экземпляра добавились только на третьем шаге. Проверены радиус каждой сущности, классы плоскостей и соответствие ключей renderer результату. После обновления графики все включённые рёбра имели видимый контур; первый уровень сохранял вес 1.5 px, новый — 3 px. Скриншот подтвердил сохранение Magenta на отверстиях при добавлении второго уровня. +In This Component real = and PgUp gave 4 → 8 → 10 circular edges: selected hole entry plane → parallel back → perpendicular cylinder. In All Components we got 4 → 8 → 20: the edges of the other rotated instance were added only in the third step. The radius of each entity, plane classes and the correspondence of the renderer keys to the result were checked. After updating the graphics, all included edges had a visible outline; the first level retained a weight of 1.5 px, the new one - 3 px. The screenshot confirmed that Magenta remained on the holes when adding a second level. -OK в All Components перенёс ровно 20 ожидаемых proxy-сущностей в activeSelections. Остаточных CustomGraphicsGroups нет. Тестовый документ закрыт без сохранения, исходный пользовательский документ и его выбор восстановлены. Это проверка воспроизводимой геометрии отверстий, не точное воспроизведение меняющегося выбора пользовательской детали и не Windows CAD-приёмка. +OK in All Components transferred exactly 20 expected proxy entities to activeSelections. There are no residual CustomGraphicsGroups. The test document is closed without saving, and the original user document and its selection are restored. This is a test of reproducible hole geometry, not an exact reproduction of a changing user part selection, and not a Windows CAD acceptance test. -## Несколько фигурных областей — проверка 25.10.2026 +## Multiple shaped regions - check 10/25/2026 -На текущем пользовательском выборе двух несвязанных плоских граней разных тел одного компонента воспроизведён дефект: первый набор из 26 граней содержал большие стенки, гипотеза — parallel_planes. Площади примеров около 1.08035 и 1.11800 cm². По отдельности поиск также терял аналоги из-за разных чисел точек дискретизации одинаковых кривых. +The current user selection of two unrelated planar faces of different bodies of the same component reproduced the defect: the first set of 26 faces contained large walls, the hypothesis is parallel_planes. The areas of the examples are about 1.08035 and 1.11800 cm². Separately, the search also lost analogues due to different numbers of sampling points for identical curves. -После исправления на том же неизменённом выборе живой preview дал 6 фигурных граней (по три из каждого семейства), гипотеза shape_families. Реальная клавиша = добавила ещё 6 аналогов в других плоскостях; - вернула первый набор из 6. Сверены конкретные session-local ключи, renderer.keys, отсутствие preview_error и визуальная Magenta-подсветка. Чистый анализ локального числового снимка занял около 0.37 s, построение нативной графики — 0.098 s. Перестановка двух примеров сохранила всё ранжирование. Preview оставлен пользователю на первом уровне; OK не нажимался, геометрия и таймлайн не менялись. Пользовательская геометрия не включена в публичный корпус. +After correction on the same unchanged choice, the live preview gave 6 shaped faces (three from each family), hypothesis shape_families. Real key = added 6 more analogues in other planes; - returned the first set of 6. Specific session-local keys, renderer.keys, absence of preview_error and visual Magenta highlighting were verified. Pure analysis of a local numerical image took about 0.37 s, construction of native graphics - 0.098 s. Rearranging the two examples preserved the entire ranking. Preview is left to the user at the first level; OK was not pressed, the geometry and timeline did not change. User geometry is not included in the public corpus. -Регрессии в ядре: несвязанные семейства вместо всех параллельных стенок; одинаковая криволинейная граница с разными числами точек, поворотом и отражением; общий transform внешней границы и отверстий при разных дискретизациях. Связанный повтор узла и пары стенок сохраняют существующие тесты. +Regressions in the core: unconnected families instead of all parallel walls; the same curvilinear border with different numbers of points, rotation and reflection; general transform of the outer boundary and holes at different sampling rates. Linked repeat node and wall pairs preserve existing tests. -## Внутренние стороны пазов — 26.10.2026 +## Inner sides of grooves - 10/26/2026 -На текущем выборе шести внутренних граней пользовательской детали воспроизведён seed-only результат: два несвязанных образца по три грани (цилиндр и две NURBS). После доработки живой preview показал 12 соответствующих граней в исходной плоскости; = добавил ещё 6 в других плоскостях. Промежуточной параллельной группы у этого снимка нет. Проверены точные ключи результата, renderer.keys, отсутствие preview_error и визуальная Magenta-подсветка. Чистый анализ — около 0.19 s. Пользовательская геометрия не менялась. +Using the current selection of six internal faces of a user part, the seed-only result is reproduced: two unrelated samples of three faces each (a cylinder and two NURBS). After finalization, the live preview showed 12 corresponding faces in the original plane; = added 6 more in other planes. This snapshot does not have an intermediate parallel group. The exact result keys, renderer.keys, absence of preview_error and visual Magenta highlighting were checked. Pure analysis - about 0.19 s. The user geometry did not change. -Полная нативная приёмка выполнена в той же CAD-сессии на отдельной несохранённой копии двух тел, созданной `tests/fusion_curved_acceptance.py`. Шесть исходных граней сопоставлены копии по типу, площади и мировым BRep-вершинам. Получена последовательность 12 → 18 → 12 по реальным =/-. OK перенёс ровно 12 ожидаемых ссылок, CustomGraphicsGroups очищены. Исходные body_stamp и isModified остались прежними. Копия закрыта без сохранения, исходные шесть примеров восстановлены. В пользовательском документе повторно открыт preview первого уровня без OK. Геометрия модели не включена в публичный корпус. +Full native acceptance was performed in the same CAD session on a separate unsaved copy of the two bodies created by `tests/fusion_curved_acceptance.py`. The six original faces are compared with copies by type, area, and world BRep vertices. The resulting sequence is 12 → 18 → 12 by real =/-. OK moved exactly 12 expected entity references, CustomGraphicsGroups cleared. The original body_stamp and isModified remain the same. The copy was closed without saving, the original six examples were restored. In the user document, the first-level preview is reopened without OK. The model geometry is not included in the public corpus. -Семь новых Python-регрессий проверяют целую группу, отдельные уровни та же/параллельная/другая плоскость, инвариантность порядка примеров, исключение всей группы, отклонение неверного взаимного расположения, выступа поверхности при совпадающих вершинах, неправильного направления нормалей, поворот/отражение, отсутствующие mesh-данные, бюджет и сериализацию. Это дискретное свидетельство поверхности, а не аналитическое доказательство равенства произвольных NURBS. Windows CAD не проверен. +Seven new Python regressions test whole group, individual levels same/parallel/different plane, example order invariance, whole group exclusion, misalignment rejection, surface overhang when vertices coincide, normal misdirection, rotation/reflection, missing mesh data, budget, and serialization. This is discrete evidence of a surface, not an analytical proof that arbitrary NURBS surfaces are equal. Windows CAD is not verified. ## Select Chain — 26.10.2026 -В одной нативной macOS CAD-сессии выполнен `tests/fusion_chain_acceptance.py`: отдельный несохранённый карман (внешний параллелепипед 6×5×3 cm, вырез 4×3 cm, четыре внутренние стенки) и второе идентичное тело рядом. Из одной внутренней стенки Select Chain дал ровно четыре ожидаемых стенки, без дна, обода и внешних граней. = расширил набор до шести граней; - вернул четыре. Screenshot подтвердил устойчивую Magenta-подсветку стенок. OK перенёс ровно четыре ожидаемые BRepFace, графика очищена. +In one native macOS CAD session, `tests/fusion_chain_acceptance.py` was executed: a separate unsaved pocket (outer parallelepiped 6x5x3 cm, cutout 4x3 cm, four inner walls) and a second identical body nearby. From one inner wall, Select Chain produced exactly four expected walls, without the bottom, rim or outer edges. = expanded the set to six faces; - returned four. Screenshot confirmed the stable Magenta highlighting of the walls. OK transferred exactly four expected BRepFaces, graphics cleaned up. -Из одного ребра внутреннего обода получены ровно четыре ребра исходной петли. Реальные PgUp/PgDown дали 4→7→4 ребра. Cancel восстановил единственное исходное ребро; повторный запуск и OK сохранили ровно ожидаемые четыре BRepEdge. На всех шагах проверено родительское тело каждого результата: в соседнем теле ничего не выделялось. +Exactly four edges of the original loop are obtained from one edge of the inner rim. Real PgUp/PgDown gave 4→7→4 edges. Cancel restored the single original edge; restart and OK retained exactly the expected four BRepEdge. At all steps, the parent body of each result was checked: nothing was selected in the neighboring body. -Нативное событие контекстного меню при одном выбранном ребре добавило обе команды без ошибок; регистрация и исполнение Select Chain проверены. Всплывающее меню не было доступно в скриншоте выбранного окна, поэтому визуальная позиция пункта этим прогоном не подтверждена. Тестовый документ закрыт без сохранения, исходный документ и выбор восстановлены. Python-тесты покрывают целые уровни, внутренний приоритет, дубли, равные доказательства, отсутствие цепочки и недостижимые контуры. Windows CAD и произвольные сложные стенки требуют отдельного корпуса. +The native context menu event with one edge selected added both commands without errors; Select Chain registration and execution verified. The popup menu was not available in the screenshot of the selected window, so the visual position of the item was not confirmed by this run. The test document is closed without saving, the original document and selection are restored. Python tests cover whole levels, internal priority, duplicates, equal proofs, unchaining, and unreachable loops. Windows CAD and arbitrary complex walls require a separate test corpus. -## Select Chain через точный контакт — 26.10.2026 +## Select Chain via precise contact - 10/26/2026 -На фактическом пользовательском выборе двух NURBS-рёбер разных половин тела (Body1/Body2 одного экземпляра) воспроизведён отказ старого однопримерного/однотелого режима. Полное совпадение общих граней подтверждено двусторонней пустой разностью BRep-поверхностей; solid intersection пусто. После временного union и обратного сопоставления ближайший контур содержит шесть исходных рёбер, включая оба примера. Анализ занимал около 0.9 s. По одной внутренней NURBS-грани этого же паза найдено шесть исходных стенок по кругу (около 1.1 s). Геометрия пользовательской детали в публичный корпус не сохранена. +The actual user selection of two NURBS edges of different body halves (Body1/Body2 of one instance) reproduced the failure of the old single-example/single-body mode. The complete coincidence of common faces is confirmed by the two-sided empty difference of BRep surfaces; solid intersection is empty. After a temporary union and reverse mapping, the closest contour contains the six original edges, including both examples. The analysis took about 0.9 s. Along one internal NURBS face of the same groove, six original walls in a circle were found (about 1.1 s). The geometry of the user part is not saved to the public body. -Отдельная несохранённая CAD-фикстура `tests/fusion_contact_chain_acceptance.py`: две половины пластины со сквозным отверстием в повёрнутом и перенесённом occurrence. Полный контакт принят; зазоры 1e-5, 1e-7 и 1e-8 cm, частичное соприкосновение, касание только ребром и перекрытие отклонены. Из двух исходных дуг при включённой Chain across contact построена замкнутая окружность, результат возвращён ровно на две исходные дуги. Выключение галочки сохранило примеры и отключило OK с явным сообщением об отсутствии общего контура; повторное включение вернуло его. +Separate unsaved CAD fixture `tests/fusion_contact_chain_acceptance.py`: two halves of a plate with a through hole in a rotated and transferred occurrence. Full contact accepted; gaps 1e-5, 1e-7 and 1e-8 cm, partial contact, edge contact only and overlap rejected. From two initial arcs, with Chain across contact enabled, a closed circle is constructed, the result was reduced back to exactly two original arcs. Unchecking the checkbox saved the examples and disabled OK with an explicit message about the lack of a common outline; turning it on again brought it back. -Для одной цилиндрической стенки включённая галочка дала две половины внутренней стенки на двух телах; выключенная ограничила результат исходным телом. При повторном включении и OK выделились ровно две ожидаемые исходные грани. Оба варианта OK проверены по ссылкам и отсутствию остаточной CustomGraphics-графики. Тестовый документ закрыт без сохранения, исходный выбор восстановлен. В пользовательском документе открыт preview шести рёбер через исходные два примера, OK не нажат. Ползунок и клавиши используют прежний общий жизненный цикл; нативная проверка Windows не выполнялась. +For one cylindrical wall, the enabled checkbox gave two halves of the inner wall on two bodies; turned off limited the result to the original body. When you turned it on again and OK, exactly two expected original faces were selected. Both options are OK, checked for links and absence of residual CustomGraphics. The test document is closed without saving, the original selection is restored. In the user document, a preview of six edges through the original two examples is open, OK is not pressed. The slider and keys use the same general lifecycle; Windows native scan was not performed. -Отдельная отрицательная проверка обнаружила, что ASM первоначально принимал частичный стык со сдвигом вдоль плоскости на 1e-8 cm. Воспроизводимый assert сначала падал. После добавления строгого двустороннего совпадения границ этот сдвиг отклоняется, истинный нулевой стык принимается, а исходные пользовательские половины по-прежнему соединяются за около 0.9 s. Проверка нормального зазора сама по себе была бы недостаточна. +A separate negative check found that the ASM initially accepted a partial joint with an in-plane offset of 1e-8 cm. The reproducible assert initially failed. After adding strict two-way edge matching, this shift is rejected, the true zero-gap contact is accepted, and the original user halves are still joined in about 0.9 s. Checking for normal clearance alone would not be sufficient. -## Плоскость контура и запуск по одному ребру — 26.10.2026 +## Contour plane and launch along one edge - 10.26.2026 -Пользователь указал ожидаемую плоскую петлю из шести рёбер паза двух соприкасающихся тел. При запуске по одному ребру старый режим выбирал другой, пространственный обход из шести рёбер. Диагностика показала две причины: приоритет периметра/соседства перед плоскостью и отсутствие нужной петли среди кандидатов. Одна дуга была ошибочно исключена из обратного сопоставления: её BRep-вершина лежит слегка вне собственной аналитической окружности в пределах допуска ASM. Кривая при этом полностью совпадает с исходной, что подтверждается двусторонней пустой разностью проводов. Для сопоставления теперь используются собственные точки кривой; строгая проверка контакта тел, включая BRep-вершины границы, сохранена. +The user specified the expected flat loop of six groove edges of two touching bodies. When running along one edge, the old mode chose another, spatial traversal of six edges. Diagnostics showed two reasons: the priority of the perimeter/neighborhood over the plane and the absence of the required loop among the candidates. One arc was mistakenly excluded from the reverse matching: its BRep vertex lies slightly outside its own analytical circle within the ASM tolerance. The curve completely coincides with the original one, which is confirmed by the two-sided empty difference of the wires. The curve's own points are now used for matching; strict check of contact of bodies, including BRep-vertices of the boundary, is preserved. -На том же пользовательском документе запуск по одному ребру дал на первом уровне ровно ожидаемые шесть ссылок BRepEdge, включая ранее терявшуюся дугу; статус In the example plane. Реальные =/- дали 6→12→6 рёбер, оба первых контура находятся в исходной плоскости. Screenshot подтвердил целую Magenta-петлю требуемого паза. +On the same user document, running one edge at a time gave exactly the expected six BRepEdge entities at the first level, including the previously lost arc; status In the example plane. Real =/- gave 6→12→6 edges, both first contours are in the original plane. Screenshot confirmed the entire Magenta loop of the required groove. -На отдельной несохранённой повёрнутой Split-фикстуре `tests/fusion_contact_chain_acceptance.py` запуск по одной дуге дал полный контур из двух исходных дуг двух тел. = и PgUp дали 2→8→10 рёбер: первая и вторая группы копланарны, третья — параллельная. PgDown/- вернули первый набор; OK сохранил ровно две ожидаемые ссылки, остаточной графики нет. Зазоры, частичный контакт, малый тангенциальный сдвиг и перекрытие по-прежнему отклоняются. Тестовый документ закрыт без сохранения. Пользовательский документ восстановлен; preview оставлен на первом контуре по одному ребру без OK. +On a separate unsaved rotated Split fixture `tests/fusion_contact_chain_acceptance.py`, launching along one arc gave a complete contour of two initial arcs of two bodies. = and PgUp gave 2→8→10 edges: the first and second groups are coplanar, the third is parallel. PgDown/- returned the first set; OK saved exactly two expected entity references, no residual graphics. Gaps, partial contact, small tangential shear and overlap are still rejected. The test document is closed without saving. The user document has been restored; preview is left on the first contour along one edge without OK. -Python-регрессии проверяют приоритет большой копланарной петли перед короткой пространственной, целые уровни та же/параллельная/остальная/неизвестная плоскость, порядок кандидатов, поворот/отражение/перенос и сохранение условия прохождения первого контура через пример. +Python regressions check the priority of a large coplanar loop over a short spatial one, integer levels of the same/parallel/remaining/unknown plane, candidate order, rotation/reflection/translation, and preserving the condition of passing the first loop through the example. -## Select Chain: обязательное прохождение через выбор на каждом шаге — 26.10.2026 +## Select Chain: mandatory passage through selection at every step - 10/26/2026 -Пользователь уточнил смысл операции: нужны только контуры, проходящие через выбранное ребро/грань, а не соседние петли в той же плоскости. Предыдущий отбор ограничивал этим условием только первый шаг, а остальные ранжировал по графовой близости; это было ошибкой спецификации. Графовое расширение удалено из ChainSelection. Теперь каждый кандидат до ранжирования содержит все примеры; плоскость, внутренняя петля и периметр упорядочивают только такие кандидаты. +The user clarified the meaning of the operation: only contours passing through the selected edge/face are needed, and not neighboring loops in the same plane. The previous selection limited only the first step to this condition, and ranked the rest by graph proximity; this was a specification error. The graph extension has been removed from ChainSelection. Now each candidate contains all examples before ranking; plane, inner loop, and perimeter are the only candidates that order. -Три исправленных/новых Python-проверки первоначально падали: соседняя копланарная петля попадала в расширение, на максимуме появлялись контуры без одного из двух примеров, а проверка прохождения была ограничена первым уровнем. После исправления все диапазоны исключают эти кандидаты. +Three fixed/new Python checks initially failed: an adjacent coplanar loop would fall into the expansion, contours would appear at maximum without one of the two examples, and the pass check would be limited to the first level. After correction, all ranges exclude these candidates. -На текущем пользовательском ребре получены ровно два допустимых контура, каждый содержит исходное ребро. Первый даёт нужную плоскую петлю из 6 рёбер. = добавляет альтернативный пространственный обход через то же ребро (суммарно 10 рёбер), повторное = на максимуме ничего не добавляет. - возвращает 6. Сверено полное множество всех включаемых рёбер с объединением только контуров через исходный пример; соседние отверстия не входят ни на одном уровне. +On the current user edge, exactly two valid contours are obtained, each containing the original edge. The first gives the desired flat loop of 6 edges. = adds an alternative spatial traversal through the same edge (10 edges in total), repeated = at maximum adds nothing. - returns 6. The complete set of all included edges is verified with the union of only contours through the original example; adjacent holes are not included at any level. -В отдельном несохранённом повёрнутом Split-примере запуск по одной дуге имеет только один допустимый замкнутый контур: две исходные дуги двух тел. Реальные PgUp/= не расширяют его посторонними петлями. Для одной стенки также остаётся только соответствующая замкнутая цепочка стенок. Оба OK дают ровно ожидаемые исходные ссылки; графика очищена. Тестовый документ закрыт без сохранения; пользовательский выбор восстановлен и preview оставлен на первом контуре. Это заменяет ошибочное ожидание расширения 2→8→10 из предыдущего протокола. +In a separate unsaved rotated Split example, a single arc run has only one valid closed loop: the two original arcs of the two bodies. Real PgUp/= do not extend it with extraneous loops. For one wall, only the corresponding closed chain of walls remains. Both OKs give exactly the expected source links; graphics have been cleaned up. The test document is closed without saving; the user selection is restored and preview is left on the first circuit. This replaces the erroneous expectation of extension 2→8→10 from the previous protocol. -## Select Chain: отдельные варианты и контур исходного тела — 26.10.2026 +## Select Chain: individual options and contour of the original body - 10.26.2026 -Пользователь показал пропущенную замкнутую петлю из 8 рёбер целиком на Body2, включая два ребра по границе разреза. Воспроизводимая проверка сначала падала: при Chain across contact контур отсутствовал в каталоге; при выключенном контакте он присутствовал. Причина — временный union удалял шов, а каталог строился только по виртуальному телу. Исправление сохраняет исходные петли каждого тела и добавляет сквозные. По одному ребру пользовательской детали получены четыре отдельных варианта: 6, 8, 4 и 6 рёбер; первые два копланарны. Второй вариант точно совпал со всеми восемью выделенными пользователем ссылками. +The user showed a missing closed loop of 8 edges in its entirety on Body2, including two edges along the cut boundary. The reproducible check initially failed: with Chain across contact, the contour was not in the catalog; when the contact was turned off, it was present. The reason is that the temporary union removed the seam, and the catalog was built only on the virtual body. The fix preserves the original loops of each body and adds end-to-end loops. For one edge of a user part, four separate options are obtained: 6, 8, 4 and 6 edges; the first two are coplanar. The second option exactly matched all eight entity references selected by the user. -По уточнённой семантике PgUp/= выбирают следующий полный контур вместо предыдущего, PgDown/- возвращают предыдущий. Накопления и слияния разных равных вариантов нет. Полный контур не исчезает из списка, даже если все его рёбра встречались в других вариантах. Каждый вариант на каждом шаге проходит через все примеры. Для Select Similar накопительный диапазон сохранён. Это заменяет ранее ошибочно принятое поведение расширения Select Chain. +According to the refined semantics, PgUp/= selects the next full contour instead of the previous one, PgDown/- returns the previous one. There is no accumulation and merging of different equal options. The full contour does not disappear from the list, even if all its edges were found in other options. Each option goes through all the examples at each step. For Select Similar, the cumulative range is preserved. This replaces the previously erroneous behavior of the Select Chain extension. -В пользовательском документе реальная = переключила 6→8 рёбер. Проверено точное совпадение второго варианта с показанным контуром и скрытие графики первого варианта, не входящей во второй; геометрия не менялась. +In the user document, real = switched 6→8 edges. The exact match of the second option with the shown outline was checked and the graphics of the first option that were not included in the second were hidden; the geometry did not change. -В одной отдельной несохранённой CAD-сессии на повёрнутых половинах пластины с отверстием выполнена фикстура `fusion_contact_chain_acceptance.py`. Полный стык принят, зазоры, малый тангенциальный сдвиг, частичный контакт и перекрытие отклонены. По одной дуге есть три варианта: сквозная окружность из 2 исходных дуг, родной контур половины тела из 6 рёбер и граница половины стенки из 4 рёбер. Реальные =/- дали 2→6→4→6 с заменой подсветки. На втором варианте все рёбра относятся только к первому телу; графика предыдущей сквозной петли скрыта. OK выделил ровно 6 ожидаемых исходных рёбер, CustomGraphics очищены. Тестовый документ закрыт без сохранения, пользовательский документ восстановлен. +In one separate unsaved CAD session, a `fusion_contact_chain_acceptance.py` fixture was made on the rotated halves of a plate with a hole. Full joint accepted, gaps, small tangential shift, partial contact and overlap rejected. There are three options for one arc: a through circle of 2 original arcs, the native contour of half the body of 6 edges, and the border of half a wall of 4 edges. Real =/- gave 2→6→4→6 with replacement of the highlighting. In the second option, all edges belong only to the first body; the graphics of the previous through loop are hidden. OK allocated exactly 6 expected source edges, CustomGraphics cleared. The test document was closed without saving, the user document was restored. -Python-регрессии проверяют строгую принадлежность всех вариантов исходным примерам, отсутствие накопления, отдельный перебор равных вариантов, сохранение контуров из ранее использованных рёбер и доступность исходной линии разреза наряду со сквозным контуром. +Python regressions check that all variants are strictly related to the original examples, the absence of accumulation, the separate search of equal variants, the preservation of contours from previously used edges, and the availability of the original cut line along with the end-to-end contour. -## Общая граница трёх плавных стенок — 26.10.2026 +## Common boundary of three smooth walls - 10.26.2026 -Пользователь показал ещё один отсутствующий контур из 8 рёбер на Body2: передний и задний профиль половины паза, соединённые двумя рёбрами по глубине у разреза. Ранее найденные четыре варианта и их порядок пользователь подтвердил. Проверка tangentiallyConnectedFaces выявила группу из цилиндрической и двух NURBS-стенок; её общая граница точно совпала с выделенными восемью ссылками. Старый каталог содержал границы отдельных граней, но не общую границу этой группы; проверка отсутствия воспроизводилась до исправления. +The user showed another missing 8-edge contour on Body2: the front and back profile of the groove half, connected by two depth edges at the cut. The user confirmed the previously found four options and their order. Checking tangentiallyConnectedFaces revealed a group of cylindrical and two NURBS walls; its general boundary coincided exactly with the highlighted eight links. The old catalog contained the boundaries of individual faces, but not the overall boundary of that group; the absence check was reproduced before correction. -После добавления границ плавных групп получены 6 вариантов; прежние четыре остались первыми в прежнем порядке. Новый показанный контур — пятый, замкнутый и неплоский. Полное совпадение с пользовательским выбором проверено по ссылкам. Перебор остаётся заменой одного варианта другим, каждый проходит через исходное ребро. Чтение/поиск на текущем примере заняли около 1.3 s. Геометрия пользовательского проекта не сохранялась в публичный корпус. +After adding the boundaries of smooth groups, 6 options were obtained; the previous four remained first in the same order. The new contour shown is the fifth one, closed and non-planar. Full match with user selection was checked using the links. Enumeration remains the replacement of one option with another, each passing through the original edge. Reading/searching in the current example took about 1.3 s. The geometry of the user project was not saved to the public corpus. -Нативная приёмка `tests/fusion_patch_chain_acceptance.py` проведена в отдельном несохранённом документе: пластина с капсульным пазом разделена пополам, обе половины размещены в повёрнутом occurrence. Нужный контур задан независимо по геометрии модели: три передних, три задних ребра и два торцевых, всего 8. По одному ребру найден четвёртый вариант — точная общая граница трёх касательных стенок. Проверены исходные ссылки, отсутствие накопления и скрытие графики других вариантов. OK перенёс ровно эти 8 рёбер, остаточной графики нет. Тестовый документ закрыт без сохранения, пользовательский документ и выбор восстановлены. +Native acceptance of `tests/fusion_patch_chain_acceptance.py` was carried out in a separate unsaved document: the plate with the capsular groove is divided in half, both halves are placed in a rotated occurrence. The required contour was specified independently according to the geometry of the model: three front, three rear edges and two end ones, 8 in total. Based on one edge, the fourth option was found - the exact common boundary of the three tangent walls. Checked the original entity references, no accumulation and hiding of graphics of other options. OK transferred exactly these 8 edges, there are no residual graphics. The test document is closed without saving, the user document and selection are restored. -Пять новых Python-регрессий проверяют исключение внутренних рёбер, общий обход трёх стенок, раздельные переднее/заднее кольца, периодический шов, круглую петлю, отказ для открытой/разветвлённой границы, неполных данных и превышения бюджета. +Five new Python regressions test for internal edge elimination, common three-wall traversal, split front/back rings, periodic seam, circular loop, open/branched border failure, incomplete data, and over budget. -## Промежуточные части плавного участка — 26.10.2026 +## Intermediate parts of the smooth section - 10.26.2026 -Два примера пользователя, рёбра 1470 и 1690 Body2, воспроизводимо давали ноль вариантов. Общая граница двух соседних граней 1695 и 1689 содержит оба примера и 10 рёбер. В полном плавном участке из девяти граней ребро 1690 становится внутренним и исключается; каталог отдельных граней и полного участка поэтому пропускал этот обход. +Two user examples, edges 1470 and 1690 Body2, reproducibly produced zero variations. The common boundary of two adjacent faces 1695 and 1689 contains both examples and 10 edges. In a full smooth section of nine faces, edge 1690 becomes internal and is eliminated; the catalog of individual faces and the complete section therefore skipped this walkthrough. -Добавлен перебор связных промежуточных частей плавных участков с доказательством замкнутости по точной вершинной топологии. Повторные границы исключаются до чтения плоскостей и длин, сведения о рёбрах кэшируются на участок. После исправления на текущем проекте найдены 42 разных контура через оба примера, ожидаемые 10 рёбер идут первыми; чтение заняло около 2.4 s. Прежние четыре варианта для одного ребра остались первыми в прежнем порядке. В живом preview проверены =/-: 10→12→10, оба примера во всех вариантах, видимая графика ровно текущего результата. Геометрия и таймлайн не менялись, OK не нажат. +Added enumeration of connected intermediate parts of smooth sections with proof of closure based on the exact vertex topology. Duplicate boundaries are excluded before planes and lengths are read, and edge information is cached per section. After correction on the current project, 42 different contours are found through both examples, the expected 10 edges come first; reading took about 2.4 s. The previous four options for one edge remained first in the same order. In the live preview, tested =/-: 10→12→10, both examples in all variants, visible graphics of exactly the current result. The geometry and timeline did not change, OK was not pressed. -179 Python-тестов включают регрессии промежуточного участка с исчезающим внутренним ребром, явного бюджета и сохранения приоритета старых вариантов. Эта проверка подтверждает описанный случай, а не полноту всех возможных пространственных циклов произвольного BRep. +The 179 Python tests include regressions of vanishing internal edge staging, explicit budgeting, and preserving legacy precedence. This check confirms the described case, and not the completeness of all possible spatial cycles of an arbitrary BRep. -## Stable 1.0.0 — проверка установки и демо, 26.10.2026 +## Stable 1.0.0 - installation check and demo, 10/26/2026 -В Fusion 2706.1.14 на macOS создан отдельный несохранённый документ: пластина с шестью отверстиями и капсульным пазом разделена на два точно соприкасающихся тела. Три реальные PNG из viewport (1800 × 1100) находятся в `docs/images`: Select Similar по стенке находит четыре одинаковые полные цилиндрические грани; Select Chain по ребру находит шесть рёбер замкнутого паза через два тела; по стенке — шесть граней всего обхода. Применение обоих контуров через OK дало ровно шесть исходных сущностей, временная графика очищена. +Fusion 2706.1.14 on macOS creates a separate unsaved document: a plate with six holes and a capsular groove is divided into two precisely touching bodies. Three real PNGs from the viewport (1800 × 1100) are in `docs/images`: Select Similar by wall finds four identical full cylindrical faces; Select Chain by Edge finds six edges of a closed groove through two bodies; along the wall - six faces of the entire loop. Applying both circuits via OK gave exactly six initial entities, the temporary graphics were cleared. -Локальный пакет 1.0.0 распакован в чистую папку и добавлен через GUI Scripts and Add-Ins → Script or add-in from device. В GUI отображены версия 1.0.0 и путь распакованной копии. Копия запущена; по фактическому пути загруженного модуля подтверждено выполнение из пакета. Select Similar дал четыре грани в preview и после OK, Select Chain — шесть рёбер через два тела в preview и после OK; остаточной графики нет. Тестовый документ закрыт без сохранения; исходный документ, выбор и рабочее дополнение восстановлены. После этого Fusion освобождён для других задач пользователя. +Local package 1.0.0 was unpacked into a clean folder and added via GUI Scripts and Add-Ins → Script or add-in from device. The GUI displays version 1.0.0 and the path of the unpacked copy. The copy is running; according to the actual path of the loaded module, execution from the package is confirmed. Select Similar gave four faces in preview and after OK, Select Chain - six edges through two bodies in preview and after OK; There are no residual graphics. The test document is closed without saving; the original document, selection and working addition have been restored. After this, Fusion is freed up for other user tasks. -182 Python-теста включают проверки release gate: версия тега и manifest, наличие пакетов всех трёх ОС, checksum и идентичность ZIP. Релизные ZIP и SHA-256 собираются и публикуются только GitHub Actions по тегу, локальный ZIP использован только для GUI-проверки установки. Нативная приёмка Windows Fusion не выполнялась. +182 Python tests include release gate checks: tag and manifest version, presence of packages for all three OSes, checksum and ZIP identity. Release ZIP and SHA-256 are collected and published only by GitHub Actions by tag, local ZIP is used only for GUI verification of the installation. Windows Fusion native acceptance was not performed. -## Замкнутая полоса граней — 28.10.2026 +## Closed strip of faces — 10/28/2026 -На текущей модели пользователя выполнено только чтение BRep: выбранный ожидаемый обод состоит из четырёх граней. До изменения его не было в каталоге; после изменения вызов обновлённого adapter с одной исходной гранью вернул этот набор первым из 18 вариантов. Проверка выполнена прямым вызовом adapter, без запуска диалога Select Chain, проверки подсветки или применения OK. Регрессионная фикстура содержит упрощённую топологию четырёх граней и условные размеры без координат и названий модели. +On the current user model, read-only BRep is performed: the selected expected rim consists of four faces. It was not in the catalog before the change; after the change, calling the updated adapter with one source face returned this set as the first of 18 options. The check is performed by calling adapter directly, without launching the Select Chain dialog, checking the highlight, or applying OK. The regression fixture contains a simplified topology of four faces and conditional dimensions without coordinates and model names. -185 Python-тестов прошли, включая приоритет обода для каждой из четырёх граней, сохранение прежних вариантов и отказ при превышении бюджета. Полная приёмка UI в отдельном несохранённом документе и проверка Windows ещё не проводились. +Passed 185 Python tests, including rim priority for each of the four faces, retention of previous options, and failure when exceeding budget. Full acceptance of the UI in a separate unsaved document and Windows testing have not yet been carried out. -Повторная проверка в Fusion 2706.1.14 на macOS: в отдельный несохранённый документ скопировано тело, а четыре грани сопоставлены по центроиду и площади. После штатной перезагрузки Selectra команда по одной исходной грани показала ожидаемые четыре грани первой из 18 вариантов; Magenta-подсветка проверена визуально и по ссылкам. Клавиши `=` и `-` переключили 1 → 2 → 1 без накопления. OK перенёс ровно четыре ожидаемые грани, временная графика очищена. Тестовый документ закрыт без сохранения, исходный документ и его прежнее выделение восстановлены. Windows не проверялась. +Rechecked in Fusion 2706.1.14 on macOS: the body was copied into a separate unsaved document, and the four faces were matched by centroid and area. After a normal restart of Selectra, the command showed the expected four faces of the first of 18 options, one by one; Magenta highlighting was checked visually and using links. The `=` and `-` keys switched 1 → 2 → 1 without accumulation. OK transferred exactly four expected faces, the temporary graphics were cleared. The test document is closed without saving, the original document and its previous selection are restored. Windows has not been tested. -Установочный ZIP 1.0.1 распакован и подключён через Scripts and Add-Ins. Проверены версия и путь загруженной копии, первый контур из четырёх граней на отдельной копии модели, OK и очистка графики. После проверки тестовая регистрация удалена, рабочая копия подключена и запущена; исходный документ и выделение восстановлены. Все 185 тестов также прошли из распакованного архива. +Installation ZIP 1.0.1 is unpacked and connected via Scripts and Add-Ins. Checked the version and path of the loaded copy, the first outline of four faces on a separate copy of the model, OK and cleared the graphics. After verification, the test registration is deleted, the working copy is connected and launched; the original document and selection are restored. All 185 tests were also passed from the unpacked archive. diff --git a/docs/VALIDATION.ru.md b/docs/VALIDATION.ru.md new file mode 100644 index 0000000..98d900b --- /dev/null +++ b/docs/VALIDATION.ru.md @@ -0,0 +1,225 @@ +# Проверка Selectra внутри Fusion + +[English](VALIDATION.md) | Русский + +Статус 25.10.2026: **частичная нативная приёмка выполнена** в Autodesk Fusion 2706.1.14 на macOS. Сначала разработка шла полностью офлайн; после разрешения пользователя тесты выполнялись на его открытой модели. Полная матрица ниже остаётся протоколом для следующих проверок. + +Локально после геометрической итерации: 134 Python-теста — OK; compileall, metadata/SPDX/ссылки и ZIP/SHA-256 — OK. Эти проверки не заменяют CAD-приёмку. Историческая базовая приёмка ниже выполнялась при 64 тестах. + +## Геометрическая итерация 25.10.2026 + +### Исправление чтения внутренней грани + +После пользовательского сообщения воспроизведён дефект на выбранной внутренней грани текущего тела: вместо её противоположного внутреннего аналога первой шла наружная сторона исходной стенки. Площадь и периметр внутреннего аналога совпадали, но контур читался неверно. Для части BRep-рёбер направление параметризации evaluator противоположно направлению самого ребра; учитывался только coedge.isOpposedToEdge, без edge.isParamReversed. Между последовательными участками ошибочной границы появлялись большие скачки. + +Обе ориентации теперь компонуются через XOR, непрерывность и замыкание проверяются до передачи контура в ядро. Протокольный тест `tests/test_fusion_contours.py` воспроизвёл сбой на синтетическом контуре со смешанной параметризацией и прошёл после исправления. На исходной выбранной грани после исправления первый уровень снова содержит только противоположный внутренний аналог с объяснением shape; наружная пара переместилась на следующий уровень. Пользовательская геометрия не включается в регрессионный корпус. + +### Основная приёмка итерации + +Для исправления ориентации повторно проверен именно зарегистрированный перезагруженный add-in в открытом пользовательском документе: начальный набор — исходная внутренняя грань и её противоположный внутренний аналог. Временная графика совпала с набором; следующие уровни — непосредственная наружная пара и пара аналога. Геометрия, ревизия, площадь, объём и число граней/рёбер остались прежними. После исправления проходят 135 Python-тестов; синтетический корпус сохраняет результаты 11/11 и 5/6. Исправленный предпросмотр оставлен открытым для пользователя. + +Fusion 2706.1.14, macOS, зарегистрированный add-in текущей рабочей ветки. Основной координатор работал последовательно; субагенты выполняли только офлайн-задачи. + +В отдельном несохранённом документе создано замкнутое тонкостенное тело: 12 граней, 24 ребра, внешний размер 10×6×2 cm и внутренняя полость 9.6×5.6×1.6 cm. Второе идентичное тело исключено из области поиска. Воспроизводимая фикстура — `tests/fusion_geometric_acceptance.py`; она использует вычисленные тела BaseFeature после finishEdit, а не ссылки на edit bodies. + +- Полный снимок содержит 12 граней и 6 локальных пар стенок. Первые три группы: внешний аналог → внутренняя сторона стенки примера → внутренняя сторона аналога. Проверены точные сущности и их родительское тело. +- PgUp: 2→3 грани, PgDown: 3→2. Последний уровень имеет отдельный контур; видимость и переиспользование графики проверены readback, заливка и контур просмотрены в UI. Непрозрачность обеих граней: API `(True, 0.349999994, True)`. +- Два предвыбранных примера противоположных сторон задают wall_sides: выбраны ровно 4 грани двух соответствующих стенок. После настоящего OK activeSelections точно совпал с предпросмотром; graphics groups = 0. +- Два связанных примера разных размеров задают repeated_region. Найдены ровно 4 внешние грани соответствующих узлов; начальный анализ около 1.4 ms, подсветка около 92 ms. +- Настоящий Cancel восстановил исходный пример; graphics groups = 0. После всех проверок fingerprint геометрии/таймлайна тестового и исходного документов совпал. Созданный документ закрыт без сохранения, исходный активирован; пользовательские документы не сохранялись и не закрывались. +- Отдельное тело 4×4×0.2 cm с узкой замкнутой полостью между глубинами проб показало ложность только пяти точечных проб. Проверка пересечений всей трассы отклонила эту пару; в снимке ложной связи нет. +- На проверенном ядре ray proximityTolerance 1e-7 cm возвращал пустые коллекции; 1e-6 cm дал согласованные hitPoints и сущности. Используется 1e-6 cm с обязательным подтверждением достижения противоположной грани. Пустой/несогласованный результат не считается доказательством материала. + +Первый обычный запуск фикстуры: BRep 2.37 ms, топология 0.58 ms, отношения 1.77 ms; суммарное чтение 4.86 ms, анализ 0.48 ms, графика 70.16 ms. Это малая синтетическая деталь; масштабируемость отсюда не следует. + +После финальной перезагрузки add-in выполнен дополнительный read-only smoke текущего исходника на открытой пользовательской модели: 39 граней, полный scope, 11 связей с локальным свидетельством материала, 6 диапазонов для выбранной плоской грани. BRep 17.73 ms, топология 4.54 ms, отношения 127.00 ms, суммарное чтение 149.67 ms, анализ 9.22 ms. Геометрия, ревизия, видимость и таймлайн до/после совпали. Правильность каждого из 11 отношений вручную в этом smoke не оценивалась; новый UI-предпросмотр на пользовательской детали не запускался. + +Exclude в живом диалоге в этой итерации не принят: попытка внешнего тестового обработчика не добавила элемент в CommandInput, поэтому не засчитана как проверка. Чистое ядро и ограничения исключений покрыты тестами. Вращение камеры, полная матрица прерываний, реальные STEP и Windows для новой реализации ещё требуются. + +## Выполнено в Fusion + +- Штатно подключён add-in из текущего checkout, Run on Startup выключен. Временный импорт MCP не используется как доказательство UI. +- В событии настоящего меню ПКМ подтверждено добавление Select Similar. +- Один root body: 97 рёбер, 39 граней. Read-only контракт проверил по 8 примеров каждого типа: ранжирование полное, диапазоны вложены, максимум охватывает все допустимые сущности этого тела. +- Рёбра: начальный ранжированный набор 4; PgUp дал 8; PgDown вернул 4. По реальному OK activeSelections точно совпал с зафиксированными ключами этих 4 рёбер. +- Грани: начальный набор 2; PgUp дал 3; PgDown вернул 2. Magenta-наложение видно на реальных поверхностях, в том числе через перекрывающую геометрию. +- После паузы графика оставалась видимой без нового кадра. После устранения двойного doExecutePreview на изменение диапазона приходится один обновлённый кадр. +- На пользовательском примере тонкой стенки воспроизведён ошибочный порядок: поперечная внутренняя грань шла раньше параллельной из-за направленной нормали. Исправленный Automatic проверен на полном неизменённом снимке тела: внешняя похожая → параллельная внутренняя → поперечная внутренняя. Отдельный регрессионный тест сохраняет этот порядок, а явный Orientation — направленную семантику. +- После перезагрузки текущего add-in на том же примере подтверждены стартовый уровень 1 с двумя гранями и порядок следующих групп. Нативный getOpacity вернул 0.35 с override для обеих графических граней; заливка визуально стала полупрозрачной. Значение хранится API с точностью float. +- Cancel вернул исходную грань. После OK и Cancel customGraphicsGroups = 0. +- В контрольной сессии сравнивались объём, площадь, число граней/рёбер, видимость, ревизии тел и таймлайн: изменений не было. Документ не сохранялся. + +Офлайн-ядро дополнительно проверяет исключения, конфликт обратной связи, историю, одинаковые оценки, явные критерии, scope/revision и ограниченный поиск похожих регионов. Наличие этих тестов не означает, что все соответствующие UI-сценарии уже пройдены. + +## Приёмка областей сборки и клавиш =/- — 25.10.2026 + +Внедрены This Body / This Component / All Components; начальный режим — This Component. Он включает тела выбранного экземпляра и его дочернюю иерархию. Для корневого компонента это вся сборка. Видимость и доступность для выбора учитываются при чтении. + +На отдельном несохранённом документе `tests/fusion_scope_acceptance.py` построены тела корневого компонента, два экземпляра одного определения и ещё один вложенный экземпляр; затем добавлен дочерний компонент выбранного определения. Проверены повороты вокруг разных осей и переносы. + +| Режим | Тела / грани области | Первый набор | +| --- | --- | --- | +| This Body | 1 / 6 | 2 | +| This Component с дочерним компонентом | 3 / 18 | 6 | +| All Components | 10 / 60 | 20 | + +Режимы переключались настоящим нативным списком. Все ключи уникальны, временная BRep-заливка совпала с мировыми boundingBox граней с ошибкой менее 1e-6 cm; контуры — менее 1e-5 cm (координаты графики float32). После OK activeSelections содержал ровно ожидаемые 20 исходных proxy-граней; graphics groups = 0. Cancel также очищал графику и восстанавливал исходный выбор. + +Клавиши =, -, PgUp, PgDown на одном и том же диапазоне дали соответственно 18, 6, 18, 6 граней, уровни 2, 1, 2, 1. Учитывается Shift, который текущая раскладка передавала вместе с =; Ctrl/Alt/Meta эти алиасы не перехватывают. + +Отдельно проверены: скрытый экземпляр с дочерним компонентом не попал в All Components; изменение transform2 сделало прежний scope guard невалидным; This Component для корневого тела охватил всю сборку. На тонком теле внутри повёрнутого экземпляра нативная проверка материала подтвердила пару стенок. Два начальных примера из разных тел одного компонента корректно получили разные пространства ключей и общий результат. + +Пользовательский проект, ранее отклонявшийся из-за assemblyContext, прочитан без изменения геометрии. На последнем снимке видимости: This Body — 57 граней; This Component — 2 тела / 114 граней; All Components — 5 видимых тел / 338 граней. Суммарное чтение: 0.430 / 0.432 / 0.504 s, чистый анализ: 0.028 / 0.071 / 0.074 s. На более раннем снимке видимости All Components включал 14 тел / 428 граней; изменение видимости пользователем не считается регрессией. Отказ необязательного этапа стенок сообщает ограничение и целиком сбрасывает его пары; полное чтение сущностей и доступные доказательства формы сохраняются. + +В этой итерации проходят 140 Python-тестов; реальные Windows CAD и вся релизная матрица остаются открыты. Пользовательские документы не сохранялись и не закрывались, тестовые документы закрыты без сохранения. + +## Ещё требуется + +Полная ручная проверка Examples/Exclude и всех Match-режимов, разные пользовательские детали и STEP, бюджеты большой подсветки, прерывание другой командой/смена документа во всех фазах, применение полученного набора в штатной операции и Windows Fusion. Отдельные команды Native topology/Face Regions UI пока не подключены; автоматический повтор по связанным примерам проверен выше. + +Использовать отдельный несохранённый документ. Одна CAD-сессия; не закрывать и не менять пользовательские документы. Зафиксировать исходный активный документ, ОС, Fusion version, путь загруженного add-in и число тел/граней/рёбер. + +## Корпус + +Создать root body с рёбрами одинаковой длины разных направлений, параллельными рёбрами разных длин, круговыми кромками и цилиндрами нескольких радиусов. Добавить второе тело с идентичными признаками как отрицательный пример области. Отдельно — STEP с аналогичной геометрией, плоские грани равной площади с разным периметром, противоположно направленные плоскости, внутренний и наружный цилиндры одинакового радиуса. + +## Матрица + +| Проверка | Критерий | +| --- | --- | +| ПКМ с выбранным ребром/гранью | Ровно один Select Similar, штатные пункты сохранены | +| ПКМ без выбора / mesh / смешанные типы | Команда не предлагается | +| Два примера одного тела | Ядро использует оба, порядок не влияет | +| Примеры разных тел | Явный отказ без расширения области | +| Поиск при одинаковом втором теле | Ноль результатов из второго тела | +| Component occurrence | В spike явный отказ; после этапа 4 — только выбранное тело выбранного экземпляра | +| Предпросмотр | Magenta постоянна, число соответствует ранжированному диапазону, поля Preview нет | +| Refine | Изменение примеров/исключений и критериев не перечитывает всё BRep; нет рекурсии | +| Нет совпадений | Примеры сохраняются, диапазон можно расширить, Cancel работает | +| OK | После закрытия выделение совпадает с Magenta-подсветкой, готово для штатной операции | +| Cancel / Esc | При том же документе и default Select восстановлены исходные примеры | +| Прерывание другой командой | Selectra не выполняется неявно и не перезаписывает выбор новой команды | +| Смена документа до idle | Отложенный перенос не меняет новый документ | +| Невалидная сущность | Контролируемый отказ, нет частично применённого набора | +| Stop / Run | Обработчики и команды не дублируются; отложенный callback после Stop не меняет выбор | +| Модель до/после | Тела, геометрия, таймлайн и состояние modified не изменены Selectra | +| Плотная перфорация | Отдельно замерены чтение, ранжирование и массовая подсветка; отказ по лимиту не выдаётся за полный результат | + +Проверить геометрическое соответствие каждого результата, а не только число элементов. На двух внешне одинаковых телах недостаточно проверить количество: проверить родительское тело всех выделенных объектов. + +## Что сохранить в отчёте + +Для сценария: параметры модели, исходные tempId в пределах неизменённого тела, выбранная гипотеза, ожидаемый/фактический набор, длительности и скриншот там, где нужен визуальный результат. Сравнивать entityToken как строки запрещено; долговременную идентичность разрешать через API. + +Локальные тесты проверяют вывод гипотез и числовые допуски. Static API definitions подтверждают существование методов, но не порядок событий, отрисовку или сохранение выбора. Только эта матрица на реальном Fusion закрывает техническую приёмку. + +## Порядок плоскостей — нативная проверка 25.10.2026 + +На macOS в отдельном несохранённом DirectDesign выполнен сценарий `tests/fusion_plane_acceptance.py`: пластина с четырьмя сквозными отверстиями радиуса 0.2 cm и отдельный перпендикулярный цилиндр. Исходный экземпляр повёрнут на 0.35 rad вокруг Y; второй экземпляр определения повёрнут вокруг X и перенесён. Пользовательский документ не редактировался. + +В This Component реальные = и PgUp дали 4 → 8 → 10 круговых кромок: плоскость выбранного входа отверстия → параллельная обратная сторона → перпендикулярный цилиндр. В All Components получены 4 → 8 → 20: кромки другого повёрнутого экземпляра добавились только на третьем шаге. Проверены радиус каждой сущности, классы плоскостей и соответствие ключей renderer результату. После обновления графики все включённые рёбра имели видимый контур; первый уровень сохранял вес 1.5 px, новый — 3 px. Скриншот подтвердил сохранение Magenta на отверстиях при добавлении второго уровня. + +OK в All Components перенёс ровно 20 ожидаемых proxy-сущностей в activeSelections. Остаточных CustomGraphicsGroups нет. Тестовый документ закрыт без сохранения, исходный пользовательский документ и его выбор восстановлены. Это проверка воспроизводимой геометрии отверстий, не точное воспроизведение меняющегося выбора пользовательской детали и не Windows CAD-приёмка. + +## Несколько фигурных областей — проверка 25.10.2026 + +На текущем пользовательском выборе двух несвязанных плоских граней разных тел одного компонента воспроизведён дефект: первый набор из 26 граней содержал большие стенки, гипотеза — parallel_planes. Площади примеров около 1.08035 и 1.11800 cm². По отдельности поиск также терял аналоги из-за разных чисел точек дискретизации одинаковых кривых. + +После исправления на том же неизменённом выборе живой preview дал 6 фигурных граней (по три из каждого семейства), гипотеза shape_families. Реальная клавиша = добавила ещё 6 аналогов в других плоскостях; - вернула первый набор из 6. Сверены конкретные session-local ключи, renderer.keys, отсутствие preview_error и визуальная Magenta-подсветка. Чистый анализ локального числового снимка занял около 0.37 s, построение нативной графики — 0.098 s. Перестановка двух примеров сохранила всё ранжирование. Preview оставлен пользователю на первом уровне; OK не нажимался, геометрия и таймлайн не менялись. Пользовательская геометрия не включена в публичный корпус. + +Регрессии в ядре: несвязанные семейства вместо всех параллельных стенок; одинаковая криволинейная граница с разными числами точек, поворотом и отражением; общий transform внешней границы и отверстий при разных дискретизациях. Связанный повтор узла и пары стенок сохраняют существующие тесты. + +## Внутренние стороны пазов — 26.10.2026 + +На текущем выборе шести внутренних граней пользовательской детали воспроизведён seed-only результат: два несвязанных образца по три грани (цилиндр и две NURBS). После доработки живой preview показал 12 соответствующих граней в исходной плоскости; = добавил ещё 6 в других плоскостях. Промежуточной параллельной группы у этого снимка нет. Проверены точные ключи результата, renderer.keys, отсутствие preview_error и визуальная Magenta-подсветка. Чистый анализ — около 0.19 s. Пользовательская геометрия не менялась. + +Полная нативная приёмка выполнена в той же CAD-сессии на отдельной несохранённой копии двух тел, созданной `tests/fusion_curved_acceptance.py`. Шесть исходных граней сопоставлены копии по типу, площади и мировым BRep-вершинам. Получена последовательность 12 → 18 → 12 по реальным =/-. OK перенёс ровно 12 ожидаемых ссылок, CustomGraphicsGroups очищены. Исходные body_stamp и isModified остались прежними. Копия закрыта без сохранения, исходные шесть примеров восстановлены. В пользовательском документе повторно открыт preview первого уровня без OK. Геометрия модели не включена в публичный корпус. + +Семь новых Python-регрессий проверяют целую группу, отдельные уровни та же/параллельная/другая плоскость, инвариантность порядка примеров, исключение всей группы, отклонение неверного взаимного расположения, выступа поверхности при совпадающих вершинах, неправильного направления нормалей, поворот/отражение, отсутствующие mesh-данные, бюджет и сериализацию. Это дискретное свидетельство поверхности, а не аналитическое доказательство равенства произвольных NURBS. Windows CAD не проверен. + +## Select Chain — 26.10.2026 + +В одной нативной macOS CAD-сессии выполнен `tests/fusion_chain_acceptance.py`: отдельный несохранённый карман (внешний параллелепипед 6×5×3 cm, вырез 4×3 cm, четыре внутренние стенки) и второе идентичное тело рядом. Из одной внутренней стенки Select Chain дал ровно четыре ожидаемых стенки, без дна, обода и внешних граней. = расширил набор до шести граней; - вернул четыре. Screenshot подтвердил устойчивую Magenta-подсветку стенок. OK перенёс ровно четыре ожидаемые BRepFace, графика очищена. + +Из одного ребра внутреннего обода получены ровно четыре ребра исходной петли. Реальные PgUp/PgDown дали 4→7→4 ребра. Cancel восстановил единственное исходное ребро; повторный запуск и OK сохранили ровно ожидаемые четыре BRepEdge. На всех шагах проверено родительское тело каждого результата: в соседнем теле ничего не выделялось. + +Нативное событие контекстного меню при одном выбранном ребре добавило обе команды без ошибок; регистрация и исполнение Select Chain проверены. Всплывающее меню не было доступно в скриншоте выбранного окна, поэтому визуальная позиция пункта этим прогоном не подтверждена. Тестовый документ закрыт без сохранения, исходный документ и выбор восстановлены. Python-тесты покрывают целые уровни, внутренний приоритет, дубли, равные доказательства, отсутствие цепочки и недостижимые контуры. Windows CAD и произвольные сложные стенки требуют отдельного корпуса. + +## Select Chain через точный контакт — 26.10.2026 + +На фактическом пользовательском выборе двух NURBS-рёбер разных половин тела (Body1/Body2 одного экземпляра) воспроизведён отказ старого однопримерного/однотелого режима. Полное совпадение общих граней подтверждено двусторонней пустой разностью BRep-поверхностей; solid intersection пусто. После временного union и обратного сопоставления ближайший контур содержит шесть исходных рёбер, включая оба примера. Анализ занимал около 0.9 s. По одной внутренней NURBS-грани этого же паза найдено шесть исходных стенок по кругу (около 1.1 s). Геометрия пользовательской детали в публичный корпус не сохранена. + +Отдельная несохранённая CAD-фикстура `tests/fusion_contact_chain_acceptance.py`: две половины пластины со сквозным отверстием в повёрнутом и перенесённом occurrence. Полный контакт принят; зазоры 1e-5, 1e-7 и 1e-8 cm, частичное соприкосновение, касание только ребром и перекрытие отклонены. Из двух исходных дуг при включённой Chain across contact построена замкнутая окружность, результат возвращён ровно на две исходные дуги. Выключение галочки сохранило примеры и отключило OK с явным сообщением об отсутствии общего контура; повторное включение вернуло его. + +Для одной цилиндрической стенки включённая галочка дала две половины внутренней стенки на двух телах; выключенная ограничила результат исходным телом. При повторном включении и OK выделились ровно две ожидаемые исходные грани. Оба варианта OK проверены по ссылкам и отсутствию остаточной CustomGraphics-графики. Тестовый документ закрыт без сохранения, исходный выбор восстановлен. В пользовательском документе открыт preview шести рёбер через исходные два примера, OK не нажат. Ползунок и клавиши используют прежний общий жизненный цикл; нативная проверка Windows не выполнялась. + +Отдельная отрицательная проверка обнаружила, что ASM первоначально принимал частичный стык со сдвигом вдоль плоскости на 1e-8 cm. Воспроизводимый assert сначала падал. После добавления строгого двустороннего совпадения границ этот сдвиг отклоняется, истинный нулевой стык принимается, а исходные пользовательские половины по-прежнему соединяются за около 0.9 s. Проверка нормального зазора сама по себе была бы недостаточна. + +## Плоскость контура и запуск по одному ребру — 26.10.2026 + +Пользователь указал ожидаемую плоскую петлю из шести рёбер паза двух соприкасающихся тел. При запуске по одному ребру старый режим выбирал другой, пространственный обход из шести рёбер. Диагностика показала две причины: приоритет периметра/соседства перед плоскостью и отсутствие нужной петли среди кандидатов. Одна дуга была ошибочно исключена из обратного сопоставления: её BRep-вершина лежит слегка вне собственной аналитической окружности в пределах допуска ASM. Кривая при этом полностью совпадает с исходной, что подтверждается двусторонней пустой разностью проводов. Для сопоставления теперь используются собственные точки кривой; строгая проверка контакта тел, включая BRep-вершины границы, сохранена. + +На том же пользовательском документе запуск по одному ребру дал на первом уровне ровно ожидаемые шесть ссылок BRepEdge, включая ранее терявшуюся дугу; статус In the example plane. Реальные =/- дали 6→12→6 рёбер, оба первых контура находятся в исходной плоскости. Screenshot подтвердил целую Magenta-петлю требуемого паза. + +На отдельной несохранённой повёрнутой Split-фикстуре `tests/fusion_contact_chain_acceptance.py` запуск по одной дуге дал полный контур из двух исходных дуг двух тел. = и PgUp дали 2→8→10 рёбер: первая и вторая группы копланарны, третья — параллельная. PgDown/- вернули первый набор; OK сохранил ровно две ожидаемые ссылки, остаточной графики нет. Зазоры, частичный контакт, малый тангенциальный сдвиг и перекрытие по-прежнему отклоняются. Тестовый документ закрыт без сохранения. Пользовательский документ восстановлен; preview оставлен на первом контуре по одному ребру без OK. + +Python-регрессии проверяют приоритет большой копланарной петли перед короткой пространственной, целые уровни та же/параллельная/остальная/неизвестная плоскость, порядок кандидатов, поворот/отражение/перенос и сохранение условия прохождения первого контура через пример. + +## Select Chain: обязательное прохождение через выбор на каждом шаге — 26.10.2026 + +Пользователь уточнил смысл операции: нужны только контуры, проходящие через выбранное ребро/грань, а не соседние петли в той же плоскости. Предыдущий отбор ограничивал этим условием только первый шаг, а остальные ранжировал по графовой близости; это было ошибкой спецификации. Графовое расширение удалено из ChainSelection. Теперь каждый кандидат до ранжирования содержит все примеры; плоскость, внутренняя петля и периметр упорядочивают только такие кандидаты. + +Три исправленных/новых Python-проверки первоначально падали: соседняя копланарная петля попадала в расширение, на максимуме появлялись контуры без одного из двух примеров, а проверка прохождения была ограничена первым уровнем. После исправления все диапазоны исключают эти кандидаты. + +На текущем пользовательском ребре получены ровно два допустимых контура, каждый содержит исходное ребро. Первый даёт нужную плоскую петлю из 6 рёбер. = добавляет альтернативный пространственный обход через то же ребро (суммарно 10 рёбер), повторное = на максимуме ничего не добавляет. - возвращает 6. Сверено полное множество всех включаемых рёбер с объединением только контуров через исходный пример; соседние отверстия не входят ни на одном уровне. + +В отдельном несохранённом повёрнутом Split-примере запуск по одной дуге имеет только один допустимый замкнутый контур: две исходные дуги двух тел. Реальные PgUp/= не расширяют его посторонними петлями. Для одной стенки также остаётся только соответствующая замкнутая цепочка стенок. Оба OK дают ровно ожидаемые исходные ссылки; графика очищена. Тестовый документ закрыт без сохранения; пользовательский выбор восстановлен и preview оставлен на первом контуре. Это заменяет ошибочное ожидание расширения 2→8→10 из предыдущего протокола. + +## Select Chain: отдельные варианты и контур исходного тела — 26.10.2026 + +Пользователь показал пропущенную замкнутую петлю из 8 рёбер целиком на Body2, включая два ребра по границе разреза. Воспроизводимая проверка сначала падала: при Chain across contact контур отсутствовал в каталоге; при выключенном контакте он присутствовал. Причина — временный union удалял шов, а каталог строился только по виртуальному телу. Исправление сохраняет исходные петли каждого тела и добавляет сквозные. По одному ребру пользовательской детали получены четыре отдельных варианта: 6, 8, 4 и 6 рёбер; первые два копланарны. Второй вариант точно совпал со всеми восемью выделенными пользователем ссылками. + +По уточнённой семантике PgUp/= выбирают следующий полный контур вместо предыдущего, PgDown/- возвращают предыдущий. Накопления и слияния разных равных вариантов нет. Полный контур не исчезает из списка, даже если все его рёбра встречались в других вариантах. Каждый вариант на каждом шаге проходит через все примеры. Для Select Similar накопительный диапазон сохранён. Это заменяет ранее ошибочно принятое поведение расширения Select Chain. + +В пользовательском документе реальная = переключила 6→8 рёбер. Проверено точное совпадение второго варианта с показанным контуром и скрытие графики первого варианта, не входящей во второй; геометрия не менялась. + +В одной отдельной несохранённой CAD-сессии на повёрнутых половинах пластины с отверстием выполнена фикстура `fusion_contact_chain_acceptance.py`. Полный стык принят, зазоры, малый тангенциальный сдвиг, частичный контакт и перекрытие отклонены. По одной дуге есть три варианта: сквозная окружность из 2 исходных дуг, родной контур половины тела из 6 рёбер и граница половины стенки из 4 рёбер. Реальные =/- дали 2→6→4→6 с заменой подсветки. На втором варианте все рёбра относятся только к первому телу; графика предыдущей сквозной петли скрыта. OK выделил ровно 6 ожидаемых исходных рёбер, CustomGraphics очищены. Тестовый документ закрыт без сохранения, пользовательский документ восстановлен. + +Python-регрессии проверяют строгую принадлежность всех вариантов исходным примерам, отсутствие накопления, отдельный перебор равных вариантов, сохранение контуров из ранее использованных рёбер и доступность исходной линии разреза наряду со сквозным контуром. + +## Общая граница трёх плавных стенок — 26.10.2026 + +Пользователь показал ещё один отсутствующий контур из 8 рёбер на Body2: передний и задний профиль половины паза, соединённые двумя рёбрами по глубине у разреза. Ранее найденные четыре варианта и их порядок пользователь подтвердил. Проверка tangentiallyConnectedFaces выявила группу из цилиндрической и двух NURBS-стенок; её общая граница точно совпала с выделенными восемью ссылками. Старый каталог содержал границы отдельных граней, но не общую границу этой группы; проверка отсутствия воспроизводилась до исправления. + +После добавления границ плавных групп получены 6 вариантов; прежние четыре остались первыми в прежнем порядке. Новый показанный контур — пятый, замкнутый и неплоский. Полное совпадение с пользовательским выбором проверено по ссылкам. Перебор остаётся заменой одного варианта другим, каждый проходит через исходное ребро. Чтение/поиск на текущем примере заняли около 1.3 s. Геометрия пользовательского проекта не сохранялась в публичный корпус. + +Нативная приёмка `tests/fusion_patch_chain_acceptance.py` проведена в отдельном несохранённом документе: пластина с капсульным пазом разделена пополам, обе половины размещены в повёрнутом occurrence. Нужный контур задан независимо по геометрии модели: три передних, три задних ребра и два торцевых, всего 8. По одному ребру найден четвёртый вариант — точная общая граница трёх касательных стенок. Проверены исходные ссылки, отсутствие накопления и скрытие графики других вариантов. OK перенёс ровно эти 8 рёбер, остаточной графики нет. Тестовый документ закрыт без сохранения, пользовательский документ и выбор восстановлены. + +Пять новых Python-регрессий проверяют исключение внутренних рёбер, общий обход трёх стенок, раздельные переднее/заднее кольца, периодический шов, круглую петлю, отказ для открытой/разветвлённой границы, неполных данных и превышения бюджета. + +## Промежуточные части плавного участка — 26.10.2026 + +Два примера пользователя, рёбра 1470 и 1690 Body2, воспроизводимо давали ноль вариантов. Общая граница двух соседних граней 1695 и 1689 содержит оба примера и 10 рёбер. В полном плавном участке из девяти граней ребро 1690 становится внутренним и исключается; каталог отдельных граней и полного участка поэтому пропускал этот обход. + +Добавлен перебор связных промежуточных частей плавных участков с доказательством замкнутости по точной вершинной топологии. Повторные границы исключаются до чтения плоскостей и длин, сведения о рёбрах кэшируются на участок. После исправления на текущем проекте найдены 42 разных контура через оба примера, ожидаемые 10 рёбер идут первыми; чтение заняло около 2.4 s. Прежние четыре варианта для одного ребра остались первыми в прежнем порядке. В живом preview проверены =/-: 10→12→10, оба примера во всех вариантах, видимая графика ровно текущего результата. Геометрия и таймлайн не менялись, OK не нажат. + +179 Python-тестов включают регрессии промежуточного участка с исчезающим внутренним ребром, явного бюджета и сохранения приоритета старых вариантов. Эта проверка подтверждает описанный случай, а не полноту всех возможных пространственных циклов произвольного BRep. + + +## Stable 1.0.0 — проверка установки и демо, 26.10.2026 + +В Fusion 2706.1.14 на macOS создан отдельный несохранённый документ: пластина с шестью отверстиями и капсульным пазом разделена на два точно соприкасающихся тела. Три реальные PNG из viewport (1800 × 1100) находятся в `docs/images`: Select Similar по стенке находит четыре одинаковые полные цилиндрические грани; Select Chain по ребру находит шесть рёбер замкнутого паза через два тела; по стенке — шесть граней всего обхода. Применение обоих контуров через OK дало ровно шесть исходных сущностей, временная графика очищена. + +Локальный пакет 1.0.0 распакован в чистую папку и добавлен через GUI Scripts and Add-Ins → Script or add-in from device. В GUI отображены версия 1.0.0 и путь распакованной копии. Копия запущена; по фактическому пути загруженного модуля подтверждено выполнение из пакета. Select Similar дал четыре грани в preview и после OK, Select Chain — шесть рёбер через два тела в preview и после OK; остаточной графики нет. Тестовый документ закрыт без сохранения; исходный документ, выбор и рабочее дополнение восстановлены. После этого Fusion освобождён для других задач пользователя. + +182 Python-теста включают проверки release gate: версия тега и manifest, наличие пакетов всех трёх ОС, checksum и идентичность ZIP. Релизные ZIP и SHA-256 собираются и публикуются только GitHub Actions по тегу, локальный ZIP использован только для GUI-проверки установки. Нативная приёмка Windows Fusion не выполнялась. + +## Замкнутая полоса граней — 28.10.2026 + +На текущей модели пользователя выполнено только чтение BRep: выбранный ожидаемый обод состоит из четырёх граней. До изменения его не было в каталоге; после изменения вызов обновлённого adapter с одной исходной гранью вернул этот набор первым из 18 вариантов. Проверка выполнена прямым вызовом adapter, без запуска диалога Select Chain, проверки подсветки или применения OK. Регрессионная фикстура содержит упрощённую топологию четырёх граней и условные размеры без координат и названий модели. + +185 Python-тестов прошли, включая приоритет обода для каждой из четырёх граней, сохранение прежних вариантов и отказ при превышении бюджета. Полная приёмка UI в отдельном несохранённом документе и проверка Windows ещё не проводились. + +Повторная проверка в Fusion 2706.1.14 на macOS: в отдельный несохранённый документ скопировано тело, а четыре грани сопоставлены по центроиду и площади. После штатной перезагрузки Selectra команда по одной исходной грани показала ожидаемые четыре грани первой из 18 вариантов; Magenta-подсветка проверена визуально и по ссылкам. Клавиши `=` и `-` переключили 1 → 2 → 1 без накопления. OK перенёс ровно четыре ожидаемые грани, временная графика очищена. Тестовый документ закрыт без сохранения, исходный документ и его прежнее выделение восстановлены. Windows не проверялась. + +Установочный ZIP 1.0.1 распакован и подключён через Scripts and Add-Ins. Проверены версия и путь загруженной копии, первый контур из четырёх граней на отдельной копии модели, OK и очистка графики. После проверки тестовая регистрация удалена, рабочая копия подключена и запущена; исходный документ и выделение восстановлены. Все 185 тестов также прошли из распакованного архива.