RU docs sketch workplanes

Редактируемые рабочие плоскости эскизов — документ модели v12

Команда Agent API/MCP create_sketch, выполняемая с блокировкой, принимает параметр plane со значениями XY (по умолчанию), XZ, YZ, CUSTOM или FACE. set_sketch_workplane дополнительно требует sketch_id и те же поля размещения. Каждый элемент эскиза остаётся редактируемым в исходных локальных двумерных координатах; существующая система ограничений не меняется. Перестроение зависимых тел входит в существующую атомарную команду с проверкой ревизии. Браузер предназначен для наблюдения.

• Именованные плоскости. XY и XZ сохраняют прежнюю ориентацию и смещения сечений. У YZ локальная X направлена по глобальной Y, локальная Y — по глобальной Z, нормаль — по глобальной X. Для смещения именованной плоскости укажите соответствующие section_normal_axis (Z, Y и X соответственно) и конечный section_offset в мм.

• CUSTOM. Форма параметров:

  {"plane":"CUSTOM","frame":{"origin":[x,y,z],"normal":[nx,ny,nz],"x_axis":[ux,uy,uz]}}

  Ненулевые непараллельные оси нормализуются при вводе и сохраняются как единичные ортогональные векторы. Локальная Y равна векторному произведению нормали на локальную X. Нулевые или параллельные векторы, некорректные числа и неортогональные сохранённые системы координат отклоняются.

• FACE. Форма параметров:

  {"plane":"FACE","attachment":{"body_id":"body:…","face_key":"…","x_axis":[ux,uy,uz]}}

  Сначала получите semantic_key актуальной плоской грани инспекцией топологии. Отсутствующий или неоднозначный ключ приводит к ошибке — система не выбирает грань наугад. Начало координат берётся в центре грани, нормаль соответствует её направлению, а заданная X проецируется на касательную плоскость. При перестроении исходного тела сначала используется прежний неизменившийся уникальный ключ. Если он изменился, повторная привязка допускается, только если ровно одна плоская грань имеет предыдущую нормаль. При развороте нормали или нескольких подходящих гранях перестроение завершается ошибкой, а не меняет эскиз молча. Ключ топологии относится к ревизии и не является постоянным идентификатором топологии.

Рабочая плоскость влияет на отображение эскиза, результат OCCT-выдавливания эскиза и sweep круглого профиля трубой, в том числе после редактирования локальных точек и перестроения параметров. Площадки, рёбра и карманы строят булев инструмент в той же системе координат. Это точные жёсткие преобразования B-rep OCCT, не приближения сеткой.

Операция revolve_sketch по-прежнему требует XZ; loft_sketches сохраняет контракт сечений, выровненных по XY/XZ. Отдельно, команды сечений сканов create_scan_sections и create_sketch_from_scan_section принимают только оси нормали Y/Z, хотя общие эскизы могут находиться на YZ. Контракт нарезки сетки автоматически не расширен до станций с нормалью X. Неподдерживаемые сочетания отклоняются с явной ошибкой валидации.

Миграция документа v11→v12 сохраняет прежние записи эскизов XY/XZ, смещения сечений и геометрию, не меняя координаты. Блокировка Core, проверка expected_revision, механизм остановки и атомарное сохранение остаются обязательными. Ссылки FACE на отсутствующие тела и некорректные системы координат не проходят проверку. Регрессионные тесты добавлены в исходный код; локально они не запускались.