kompas 0.4.0 (из f1ecc6ff5a923d524a7aa8dc7b97c538d9cf1bb3)

2026-10-15 03:15:33 +00:00
parent 94e044bd03
commit 0720fd7397
22 changed files with 208 additions and 106 deletions
@@ -13,12 +13,12 @@
   ГОСТ не выйдет; планируешь чертёж — строй эскизы так, чтобы главный вид попадал на плоскость
   с наибольшей информацией.
 2. **`drawing_set_sheet_format`** (формат до видов — иначе виды придётся двигать), при
-   необходимости `drawing_add_sheet` для второго листа.
+   необходимости `drawing_set_sheet_format(add=true)` для второго листа.
 3. **`drawing_create_standard_views(views=[…], mainOrientation=…, hiddenLines=…)`** — бери ровно те
   проекции, которые нужны: лишний вид — лишнее место и лишний повод ошибиться видом. **Главный вид
   входит в набор сам**: перечисленные коды — это проекции ОТНОСИТЕЛЬНО него, поэтому `views=["top"]`
   даёт ДВА вида (главный и сверху). Ответ возвращает НОМЕРА видов, и дальше всё адресуется ими.
-4. **Координаты — замером, а не формулой.** `drawing_get_view_info(viewNumber)` отдаёт паспорт вида
+4. **Координаты — замером, а не формулой.** `describe_drawing(sections=view, viewNumber)` отдаёт паспорт вида
   одним вызовом: положение на листе, масштаб, габарит и — главное — локальную СК: куда попадает
   начало координат модели и куда смотрят её оси +X/+Y/+Z в координатах вида (нулевой орт = ось
   проекции, вдоль неё вид смотрит). Этого хватает, чтобы пересчитывать точки модели в вид
@@ -34,7 +34,7 @@
 6. **Размеры**, `drawing_add_axis` (осевые и центровые), шероховатость, выноски, техтребования,
   штамп. **Осевые сначала посмотри, потом добивай**: ассоциативные виды приходят со СВОИМИ
   центровыми и осевыми, которые КОМПАС ставит сам, и `drawing_add_axis` вслепую даёт дубли поверх
-   существующих. Сначала `list_drawing_objects(kind="axis"|"centreMarker", viewNumber=…)`.
+   существующих. Сначала `describe_drawing(kind="axis"|"centreMarker", viewNumber=…)`.
 7. **`drawing_export_image`** — посмотреть глазами. Пока картинки не было, чертёж не сдан.

 ## Разрез
@@ -48,16 +48,16 @@
  стенка полой детали. Невидимые линии — только намёк на то, что уже показано где-то ещё; размер к
  штриховой линии не привязывают.
 - **Веди линию с запасом за габарит** (плита 60 мм → от −40 до +40): линия по самому краю режет не
-  всю деталь. Координаты — в ЛСК БАЗОВОГО вида, её даёт `drawing_get_view_info`.
+  всю деталь. Координаты — в ЛСК БАЗОВОГО вида, её даёт `describe_drawing(sections=view)`.
 - **Строй разрез, когда модель готова**: после правки детали перестраивается только ПЕРВЫЙ разрез
  базового вида. Модель всё же изменилась — снеси разрезы и построй заново.
 - Сам разрез дальше — обычный вид: размеры и обозначения ставятся на него по его номеру.

 **Промах простановки лечится, а не остаётся навсегда.** Отката (undo) у чертежа нет, но
-`list_drawing_objects` показывает обозначения с индексами, `drawing_delete_object` убирает одно, а
+`describe_drawing` показывает обозначения с индексами, `drawing_delete(target=object)` убирает одно, а
 `drawing_move_object` его СДВИГАЕТ — слипшиеся тексты соседних размеров лечат именно сдвигом, а не
 заменой размера на выноску. Так же правится и компоновка: `drawing_move_view` переставляет вид со
-всеми обозначениями, `drawing_add_view` доносит недостающую проекцию, `drawing_delete_view` убирает
+всеми обозначениями, `drawing_create_standard_views(views=[])` доносит недостающую проекцию, `drawing_delete(target=view)` убирает
 лишнюю. Пересоздавать документ ради компоновки не нужно. Подробности адресации и порядок удаления —
 `help(topic="drawing-fixing")`.

@@ -27,6 +27,12 @@
  `embodiment(action="set", target="L600", component=N)` и затем `rebuild`. Сопряжения при этом
  **сохраняются** — пересоздание вставки, наоборот, порвало бы их все. Какие исполнения есть у
  конкретного экземпляра, показывает `describe_model(sections="embodiments", component=N)`.
+- **Исполнения, отличающиеся одним размером, — это переменная, а не правка дерева.** Значение
+  переменной каждое исполнение (и вариант) хранит СВОЁ: `set_variable` после `embodiment(add)`
+  меняет только текущее, у наследников выражение становится ссылкой на родителя
+  (`VCM.001|fit_h`). Отсюда приём: построй базу на переменных, затем `add` → `set_variable` в
+  каждом исполнении. Убрать элемент в исполнении часто проще значением, чем `feature_delete`:
+  цековка с `cb_d = hole_d` уходит в уже вырезанное.
 - **Выгнать всю линейку на печать** — `export_model(embodiment="all")`: каждое исполнение в свой
  файл с суффиксом обозначения.
 - **После смены исполнения в собранном узле проверь сопряжения** (`sections="mates"`): если у нового
@@ -11,11 +11,15 @@
 - **`local`** — вставка, переиспользуемая только внутри этого документа.
 - **`explode`** — россыпь обычных примитивов: правится по одному, но связи с файлом уже нет.

+**Имя вставки общее у вставок одного файла одного вида.** Вторая копия того же файла получает имя
+первой, и `name` второго вызова не применяется. Ответ `fragment_place` называет фактическое имя
+и прямо говорит, если запрошенное не легло. Нужны разные имена — кладите разные файлы.
+
 `angle` (градусы), `scale` и `mirror` задают размещение; зеркалить можно только вставку — у россыпи
 отражать нечего. **Зеркало отражает относительно вертикали через точку вставки**, поэтому контур
 уходит в другую сторону от неё: вставка в x=220 после `mirror` занимает 160…220, а не 220…280.

-Проверять результат — `list_drawing_objects`: он показывает состав по типам, габарит и все вставки
+Проверять результат — `describe_drawing`: он показывает состав по типам, габарит и все вставки
 с их файлами. Вставка, чей файл потерялся, рисуется пустым местом — в списке она помечена
 недействительной, и это единственный способ отличить её от удавшейся, не глядя на экран.

@@ -38,7 +38,7 @@
   | «сдвинуть грань на N мм» | `move_face` | это он и есть |
   | «диаметр отверстия (бобышки) должен стать D» | **`resize_face`** | задаётся ДИАМЕТР, ось не двигается; `move_face` сдвинул бы стенку на (D−d)/2, и это пришлось бы считать самому |
   | «грань должна встать НА объект: на плоскость, на грань соседнего тела» | **`replace_face`** | расстояние считает КОМПАС; `move_face` требует вычислить его заранее |
-   | вставка N мм в призматическую ножку | `split_solid_by_plane` → `move_body` → `move_face` (мост) → `boolean_union` | цепочка проверена end-to-end: проставка 39.45 → 41.45 мм |
+   | вставка N мм в призматическую ножку | `split_solid_by_plane` → `move_body` → `move_face` (мост) → `boolean` | цепочка проверена end-to-end: проставка 39.45 → 41.45 мм |

   `resize_face` и `replace_face` требуют КОМПАС v25; на версиях старше они отвечают отказом с
   номером установленной версии, и тогда остаётся `move_face` с арифметикой.
@@ -15,10 +15,39 @@
  становится ведомым, внутреннее имя параметра («Расстояние 1») знать не нужно. Переменная должна
  существовать ДО операции — потому паспорт и заводят первым. Задним числом и для параметров,
  которых нет среди аргументов инструмента (углы уклона, второе направление), — `link_parameter`.
+- **Размер КОНТУРА — тоже выражением**, но не в координатах, а в `dimensions` у
+  `sketch_create`/`sketch_update`: ширина, длина отрезка, Ø/R, а с `to` — расстояние между точками
+  (шаг отверстий, отступ от края) и угол между отрезками. Координаты достаточно нарисовать
+  примерно — контур встанет по значению сразу.
+- **Эскиз определён полностью, только когда привязан к модели.** Форма — размерами, положение —
+  от начала координат и осей: `to:{ref:"origin"}` (расстояние от базовых плоскостей, угол или
+  центр в начало через `coincident`), `coincident` с `ref:"xAxis"|"yAxis"` (точка на оси),
+  `symmetric` с `axis` (деталь симметрична оси — ширина растёт в обе стороны). Порядок для
+  каждого эскиза: **(1) где он стоит** — привязка к началу координат/осям; **(2) форма** — все
+  длины, радиусы, углы; **(3) взаимное положение** элементов — от привязанного контура или от
+  оси. Симметричную деталь строй симметрично оси модели: тогда её плоскости симметрии совпадают с
+  базовыми, и следующие эскизы привязываются к тем же осям. Нужна симметрия на уровне грани —
+  ставь эскиз не на грань, а на базовую плоскость со смещением (`offset`): у грани осей модели нет.
+- **Читай хвост ответа.** «полностью определён» без строки «Закреплено там, где нарисовано» —
+  цель. Строка «Закреплено…» значит, что положение держит закреплённая сервером точка, а не
+  привязка: добавь `ref`. «⚠ НЕДООПРЕДЕЛЁН» — часть контура свободна и сдвинется при смене
+  переменной: допиши размер (чаще всего радиус дуги, угол наклонного отрезка или вторую ось
+  положения). Отказ «размер ЛИШНИЙ» — величина уже следует из других (касание, сшивка, симметрия)
+  — убери один. Поля, правила опоры и пример VESA — `help(topic="sketch-dimensions")`.
 - **Промахи сервер ловит сам:** ссылка на несуществующее имя — отказ с перечнем виновных (и в
-  выражениях операций, и в `set_variable`; регистр значим), функции в формулах — предупреждение
+  выражениях операций, и в `set_variable`), функции в формулах — предупреждение
  (тригонометрия в радианах, разделитель аргументов «;», непонятая запись = молчаливый 0).
-  Твоя часть — **сверить вычисленные значения из ответа со своей прикидкой**.
+  Имена: в ФОРМУЛЕ регистр значим (`aq` не найдёт `Aq`), а две переменные, различающиеся только
+  регистром, не уживаются — `spl_d` перезапишет `spl_D`. Константы π нет: заведи `dg =
+  0.017453292519943295` (градус в радианах) и пиши `sin(a*dg)`.
+- **Связь — ограничением, а не арифметикой.** Центр дуги на окружности — `coincident` с
+  `to.point: "curve"`; опора вне профиля (основная окружность, ось паза) — примитив с
+  `construction: true`; сторона «в 3.5 от оси под 22.5°» — `distance` до `origin` плюс `angle` к
+  оси. Так связь живёт в эскизе и переживает смену переменной; посчитанные числа — нет.
+- **Считает КОМПАС, а не ты:** связь — ограничением в эскизе, скругление — примитивом `fillet`,
+  точная начальная координата — выражением прямо в точке (`{"x": "rb*sin(phi*dg)"}`). Заводить
+  переменные-калькуляторы и переносить их значения в JSON не нужно. Твоя часть — **сверить
+  результат с прикидкой** (`sketch_describe`).
 - **`note` обязателен** и пишется по-русски, со смыслом и единицей; `(ТЗ)` в тексте по-прежнему
  полезен человеку, но для машины число из ТЗ метится ПРИЗНАКОМ:
  `set_variable([{name:"dish_r", expression:"90", note:"по ТЗ", information:true}])`. Комментарий
@@ -17,7 +17,7 @@ Zilla Slab): это порядок величины и форма зависим
 | **Пришла в CAD-формате**: файл от смежника | `import_drawing` (.dxf/.dwg) → фрагмент → `fragment_place` |

 **Обводка занимает сотни примитивов, и переписывать их в тело вызова незачем.** У `sketch_create`,
-`sketch_add` и `fragment_create` есть `entitiesFile` — путь к JSON того же формата, что `entities`;
+`sketch_update(mode=append)` и `fragment_create` есть `entitiesFile` — путь к JSON того же формата, что `entities`;
 сервер читает файл сам. Замер на эмблеме Volvo: SVG в 1.5 КБ даёт 96 примитивов (50 отрезков +
 46 дуг) и 9.5 КБ JSON; через `entitiesFile` это один вызов на одну строку аргументов, а эскиз
 строится за один заход. Оба параметра можно задать вместе — сначала `entities`, следом файл: