# Дизайн: смещённая плоскость + операция по сечениям (loft)

**Дата:** 2026-05-26
**Статус:** на ревью (автономный режим; ревьюер — Codex)

## Цель

Два связанных инструмента:
1. **`sketch_create_on_offset_plane`** — эскиз на плоскости, смещённой от базовой на `offset` мм
   (вспомогательная геометрия; снимает ограничение «только 3 базовые плоскости»).
2. **`loft`** — операция по сечениям (несколько эскизов-сечений → сплошное тело). Сечения
   строятся на параллельных смещённых плоскостях, что и разблокирует первый инструмент.

## Сигнатуры COM (рефлексия interop)

```
Obj3dType.o3d_planeOffset = 14
ksPlaneOffsetDefinition:
    double  offset
    bool    direction
    bool    SetPlane(object basePlane)          // базовая плоскость (o3d_planeXOY/XOZ/YOZ)

Obj3dType.o3d_baseLoft = 30
ksBaseLoftDefinition:
    bool    SetLoftParam(bool closed, bool flipVertex, bool autoPath)
    bool    SetThinParam(bool thin, short thinType, double normal, double reverse)
    object  Sketchs()                            // ksEntityCollection эскизов-сечений
```

## Новые MCP-инструменты

| Инструмент | Параметры | Поведение |
|---|---|---|
| `sketch_create_on_offset_plane` | `basePlane: string (XOY/XOZ/YOZ)`, `offset: double`, `direction: bool = true` | Создать смещённую плоскость (`o3d_planeOffset`: база + offset мм + направление) и открыть на ней эскиз. Возвращает id эскиза (как `sketch_create`). |
| `loft` | `sketchIds: int[]`, `closed: bool = false` | Операция по сечениям: построить сплошное тело по ≥2 закрытым эскизам-сечениям (в порядке списка). `closed` — замкнуть в кольцо. Возвращает id операции. |

## Реализация

- **`OpenSketchOnOffsetPlaneAsync(BasePlane, double offset, bool direction, ct)`** в
  `PartModeler.Sketch.cs`: `NewEntity(o3d_planeOffset)` → `ksPlaneOffsetDefinition`
  (`SetPlane(GetDefaultEntity(базовая))`, `offset`, `direction`) → `Create()` → `CreateSketchOn(part, planeEntity)`.
  Валидация `double.IsFinite(offset)`.
- **`LoftAsync(IReadOnlyList<int> sketchIds, bool closed, ct)`** в `PartModeler.Features.cs`:
  закрыть все эскизы; `NewEntity(o3d_baseLoft)` → `ksBaseLoftDefinition` → `Sketchs()` (null-check)
  → `Add` каждого `sketch.Entity` в порядке списка → `SetLoftParam(closed, false, true)` →
  `SetThinParam(false, 0, 0, 0)` → `Create()`. Валидация: `sketchIds` не null, `Distinct` ≥ 2;
  каждый id есть в реестре (`RequireSketch`).
- Инструменты в `SketchTools.cs` (`sketch_create_on_offset_plane`) и `FeatureTools.cs` (`loft`).
- Транзитные RCW не освобождаются — консистентно (долг v2-2).

## Тестирование

**Integration** (`FeatureOpsTests`):
1. `OffsetPlane_sketch_extrudes_at_height`: эскиз на XOY+offset 20 → окружность R5 → extrude 10 →
   габарит по Z ≈ [20; 30] (`box.MinZ ≈ 20`), объём ≈ π·25·10.
2. `Loft_two_sections_makes_solid`: сечение 1 — квадрат 20×20 на XOY (offset 0, через
   `sketch_create_on_offset_plane` с offset 0 или базовый `sketch_create`); сечение 2 — квадрат
   20×20 на XOY+offset 40 → `loft([s1,s2])` → призма ~20×20×40, объём ≈ 16000 мм³
   (`InRange ±10%`, т.к. форма сечения сохраняется). Если loft капризничает на квадратах —
   проверить `volume > 0` и габарит Z ≈ 40.
