Repository navigation
Datum v0.4.6
Datum 0.4 — для тех, кто пробует
Datum — открытая CAD-система для инженеров-конструкторов: ядро многопоточное и детерминированное, модель — открытый JSON, ИИ-агент работает с моделью теми же командами, что и человек. Версия 0.4 — ранняя: в ней есть ядро, листовой металл, окно с моделью и вкладками, эскизы на любой плоскости, массивы, рабочие плоскости, библиотека наработок, исполнения деталей, развёртка и STEP для заказчиков. Нам важно, что мешает и чего не хватает в ежедневной работе.
Что нового в 0.4.6
Листовой металл из окна: лист по траектории, грань листа, вырезы, фланцы.
- Лист по траектории — E. Выберите правило листа в верхней панели («Лист 2 мм»), откройте эскиз с разомкнутой цепочкой и нажмите E: форма листа — ширина, «Симметрично», сторона материала. Толщина, радиус гиба и K-фактор — из правила. В цепочке могут быть дуги (вальцованные участки): дуга, касательная к соседям (связь «касательная», её ставит инструмент касательной дуги), — гладкий переход; под углом — гиб с радиусом правила.
- Грань листа — E на замкнутом контуре при листовом правиле: пластина толщиной из правила.
- Вырез листа — E на эскизе на грани листа: насквозь по толщине, как пробивка заготовки, сразу на развёртке. Работают: отверстие в стенке; через гиб (в DXF — одна окружность); паз через всю стенку и гибы, отверстие шире гиба; вырез на край — паз сбоку через гибы, уголок, полукруг с центром на кромке; вырез поверх прежнего — сливается с ним или накрывает его целиком. Всё то же — на грани листа (пластине).
- Предупреждение: вырез ближе 2t + R к линии гиба (или через гиб) строится, но в дереве у него ⚠ и подсказка: «отверстие исказится при гибке»; то же — в форме выреза и у агента (
warnings). - Фланец — по ребру, как в Inventor. E вне эскиза — щёлкните ребро листа (подсвечиваются годные; Shift или Ctrl — ещё), Enter: форма «Фланец» — высота (от наружной поверхности), угол, «⇄ Другая сторона». Ребро торца — фланец на конце листа; ребро стенки вдоль бока листа — фланец вдоль стенки, наружу, без разгрузки. То же — пункт меню «Фланец». На боковом фланце работают отверстие и вырез на его кромку.
- Рабочая плоскость через три точки. «Рабочая плоскость» → щёлкните три точки: вершины тел (видны, пока строите), точки эскизов (видны всегда), начало координат.
- Ноутбук без мыши. Вид → «Тачпад»: два пальца сдвигают вид, щипок масштабирует. Пробел с перетаскиванием сдвигает вид в любом режиме. Точка, поставленная числом за краем вида, не теряется: вид отдаляется.
- Развёртка — кнопкой на верхней панели рядом с E (активна, когда есть лист); при запуске и при закрытии модели панель развёртки закрыта.
- Для агента (MCP):
sheet(с дугами в пути),plate,extrudeсwall(вырез листа),flange(edges,height,angle,flip),planeсpoints; предупреждения — вinspectи в ответе каждой правки.
Пока нет (честный отказ с причиной): разгрузки у фланцев и фланцы, сходящиеся в углу; вырез, переходящий с листа на боковой фланец или через его гиб; вырез, делящий лист на две части; срез листа наклонной плоскостью (0.5–0.6).
Файлы 0.4.5 открываются как есть.
Что нового в 0.4.5
- Выдавливание из окна — E (кнопка в панели и пункт меню «Эскиз»). В открытом эскизе E выдавливает этот эскиз и выходит из него. В модели E берёт единственный эскиз, которым ещё ничто не пользуется, а если таких несколько, ждёт щелчка по эскизу в дереве (подсказка у курсора).
- Форма у курсора: глубина (число или формула, вводится сразу), «Симметрично» и режим тремя кнопками: «Новое тело», «Добавление», «Вырез». Режим подсказывается знаком глубины и тем, где лежит эскиз; после выбора режим не меняется. Тело видно до Enter, под полями написано, что выйдет (
режим · тело) или почему не выйдет. Enter — готово, Esc — отмена. - От грани тела: эскиз на грани — бобышка наружу (добавление) или карман внутрь (вырез на глубину). «Насквозь» (в режиме «Вырез») режет всё тело стенка за стенкой, как в Inventor: например, круг через обе стенки трубы. Карман глубже тела становится сквозным вырезом. Пока нельзя: бобышка заподлицо с краем грани, кольцевая бобышка (контур в контуре), карман на вальцованном листе, вырез с дугами поперёк отверстия.
- Контур эскиза-каркаса. В одном эскизе можно держать много контуров и цепочек, как в общем эскизе Inventor. В открытом эскизе щёлкните внутри контура (Shift добавляет) или выделите его кривую и нажмите E: выдавится только этот контур с его отверстиями (в форме — «Контур: …»). Если ничего не выделено, а контуров несколько, E попросит выбрать. Разомкнутые цепочки при выдавливании пропускаются: это пути будущих листовых деталей (0.4.6).
- Подписи в дереве: второй щелчок по выбранной строке или F2 — переименовать операцию на любом языке (Enter, Esc отменяет; пустая подпись возвращает ключ). Ключ операции (
extrude1) не меняется, он виден в подсказке. - Правило, материал и масса детали — для агента (MCP):
set_partсruleпривязывает к детали правило из библиотеки (у исполнения может быть своё),extrudeтоже берётrule;productотдаёт правило, материал и массу каждой детали (объём × плотность). В окне это появится в 0.4.6, значком правила в форме E. - Для агента (MCP): команда
extrudeс обязательным режимом (new,join,cut,intersect), глубиной (z0/z1,symmetric,through),profiles(имена кривых выбранных контуров) и необязательнымbody; ответ называет режим и тело.set_title— подпись операции. - Исправлено: открытая модель не показывалась, пока не сдвинешь вид, и не было сглаживания рёбер (DX12 на Radeon). Новый эскиз (S) не попадал на грань тела: выбиралась плоскость перед ней.
Файлы 0.4.3 открываются как есть. Старая операция cut читается как выдавливание в режиме «Вырез» насквозь. Файл с режимами выдавливания в 0.4.3 не откроется.
Что нового в 0.4.3
- Редактор таблиц — отдельное окно. Вид → «Таблица параметров», «Материалы», «Правила»: стрелки, Tab, Enter, F2, Del; диапазон из Excel вставляется и копируется обратно; новая строка внизу, строки удаляются правой кнопкой («Удалить строки») или Ctrl+−. Размер таблицы —
"table": {"zoom": 1.5}вsettings.json. - Дробь в ячейке — как на чертеже: текст над и под чертой. Кнопка «Дробь» вставляет её у курсора, щелчок по верху или низу правит эту часть. Так пишется обозначение материала по ГОСТ:
Лист [Б-ПН-{t} ГОСТ 19903-2015 | 08пс ГОСТ 16523-97]({t}— толщина детали). - Материалы — в библиотеке проекта (
library/material/, файл на материал): имя, обозначение, плотность, описание. Встроенных нет: сортамент у каждого предприятия свой. - Правила — тоже в библиотеке (
library/rule/): листовое (толщина, радиус гиба — числом или формулой от толщиныt, например1.5 * t) или для обычной детали; у правила всегда материал. Окно «Правила»: сверху список материалов, под ним правила выбранного. Переименованный материал уносит свои правила; материал с правилами не удаляется. Привязка правила к детали — со следующими операциями детали. - Комбинации элемента библиотеки — в таблице. В окне «В библиотеку» кнопка «Комбинации…»: строка — комбинация, столбцы — параметры, под шапкой «Свои значения» (их тоже можно править). Можно вставить из Excel.
- Новый порядок вставки элемента библиотеки: элемент висит у курсора (и после переноса из панели), щелчок — базовая точка, затем гнёзда щелчками (Enter пропускает), затем размеры у базовой точки — Tab по полям или, в режиме F4, комбинация из списка с поиском по набранному. Enter ставит элемент вместе со связями гнёзд — одним шагом отмены; Esc отменяет вставку. Элемент, поставленный по комбинации, — группа с её именем («Плита 200×200»): видно, что это за элемент.
- Измерения в эскизе — F3 (линейка в верхней панели): длины, радиусы, расстояния, углы, зазор между окружностями, чистая площадь области (минус отверстия и копии массива); привязка и к копиям массива. Числа — не больше трёх знаков. Эскиз не меняется.
- Светлая и тёмная тема: Вид → «Тема» (как в системе, светлая, тёмная) или
"theme": "light"вsettings.json. Надписи боковой панели теперь читаются на обеих; вид модели и эскиз остаются светлыми. - Русский язык — во всех окнах: «В библиотеку», рабочая плоскость, массив, подсказки инструментов, вставка элементов, куб вида, развёртка. Пока по-английски: сообщения об ошибках ядра и имена операций.
- Для агента (MCP): материалы и правила —
library,put_library,remove_libraryс уровнемmaterialилиrule; в описаниях команд — зачем и как их писать. - Исправлено: вид модели рисует копии массива эскиза, а не только его собственные кривые.
Файлы 0.4.2 открываются как есть: формат модели не менялся (материалы и правила — отдельные файлы библиотеки).
Что нового в 0.4.2
- Модель — многотельная деталь. Все тела строятся в одном дереве (корень, «Base»), как многотельная деталь Inventor; деталь — тело. Каркаса как отдельного уровня больше нет. В разделе «Parts» — детали (тела корня), у каждой список: «base» и её исполнения («+ New variant»). Файлы 0.4.0 и 0.4.1 с деталями-уровнями переводятся при открытии сами: операции детали переезжают в корень. Если у двух деталей была операция с одним именем, файл не откроется и скажет, что переименовать.
- Наборы изделия. В «Parts» строка «Set»: «Save as set…» сохраняет изделие как есть (исполнение каждой детали и скрытые детали) под именем, выбор набора в списке возвращает его сразу. Для агента:
save_set,apply_set,remove_set. - Русский интерфейс. Меню, действия, разделы боковой панели, вкладки, подписи и подсказки панелей деталей, параметров и операций переведены. Язык берётся из системы (русская Windows — по-русски); переключается в «View → Language» (выбор запоминается) или строкой
"language": "ru"вsettings.json. Горячие клавиши не зависят от языка и раскладки. Пока по-английски: формы и диалоги, четыре длинные подсказки раздела эскиза, сообщения об ошибках ядра, имена операций (sketch,sheet,extrude). - «View → Reset layout» возвращает всё: ширину боковой панели, плавающие вкладки и размер окна, как при первом запуске.
- Размеры в полях — с запятой:
0,5понимается как 0.5 (как раньше в размерах эскиза, теперь и в окне массива). Пока шаг массива неверный (например 0), эскиз остаётся на экране, а красная ошибка не появляется, пока вы печатаете в поле. - Вырез на грани: если профиль лежит вне грани эскиза, сообщение говорит об этом и называет, где грань в осях эскиза;
query_facesотдаёт для плоской граниsketch_axes(начало и оси) — для агента. - Исправлено: удаление операции стирало все параметры модели.
Что нового в 0.4.1
- Контур для массива — без группы. Выделите линии и дуги, которые смыкаются в контур (точки цеплять не нужно), и удержите правую кнопку: замкнутый контур — «Fill it» или «Along its outline», открытая цепочка из трёх кривых и больше — вдоль неё. Группа контура создаётся сама вместе с массивом. Одна или две линии — по-прежнему сетка вдоль них.
- Массив — кнопкой и клавишей A. Значок массива в ряду инструментов эскиза (тот же, что у массива на эскизе): подсказка перечисляет, какой массив получится при каком выделении; щелчок или A открывает меню сразу, у курсора, без удержания правой кнопки. У дуги клавиши больше нет (её можно назначить в настройках). G — группа из выделенного.
- Режимы эскиза на F-клавишах. F7 — выводить зависимости при черчении (выключено — линия идёт ровно туда, куда щёлкнули, без горизонтальности, параллельности и т. п.), F8 — значки зависимостей, F9 — имена, F10 — размеры (скрытые не мешают читать загруженный эскиз; инструмент «Dimension» их показывает). Режимы сохраняются для следующего эскиза. Вкладок в разделе эскиза больше нет: инструменты, зависимости и действия с выделением — друг под другом.
- Боковую панель можно перетащить вправо (и обратно): возьмите полосу значков у края окна и отпустите на другой половине окна. То же — правой кнопкой по полосе значков или View → «Side bar on the right».
- Исправлено: массив не строился, если в эскизе были незамкнутые линии («the profile is open or branches at point …»). Копии проверяются только против замкнутых контуров.
- Исправлено: значок «другое направление» в меню массива был квадратиком.
Файлы 0.4.0 открываются в 0.4.1 как есть, и наоборот: формат файла не менялся.
Что нового в 0.4.0
Чего пока нельзя. Деталь с нуля в окне собрать нельзя: выдавливания, выреза и фланцев в окне ещё нет (в JSON и у агента они есть). Что можно: смотреть и править примеры (models/wall_variants.json, models/pattern_path.json, листы models/sheet_panel.json), рисовать эскизы, делать массивы, пробовать исполнения и развёртку, пробовать само окно. Операции детали (выдавливание, фланцы) — следующий выпуск, 0.4.5.
- Массив в эскизе — из окна. То, что выделено первым, задаёт вид: точка или окружность — вокруг неё; линия — вдоль неё (две — сетка по ним); группа — вдоль траектории или заполнение замкнутой области; ничего — сетка по осям. Правая кнопка, удержанная полсекунды на месте, открывает меню: число, шаг, приращение шага (
grow: каждый шаг длиннее предыдущего на столько), угол, ⇄ — другое направление, «Turn with the path». «Select elements» — выберите, что копировать (щелчок, рамка, Shift или Ctrl), копии видны сразу; «Done» или Enter. Копии выбираются, как элементы: сдвинуть (вдоль и поперёк пути, градусы и наружу), оставить пропуск (Del), «Edit pattern…», «Delete pattern». У массива значок (квадраты рядами): щелчок выделяет копии, удержанная правая кнопка на нём — правка начальных данных. Траекторию рисуйте обычными линиями и дугами. - Shift или Ctrl — везде добавляют к выделению и снимают с него; рамка с Shift или Ctrl добавляет.
- Исполнения деталей наследованием. Один файл — каркас (общие эскизы, плоскости, параметры), детали на нём и исполнения деталей; в исполнении только отличия: другое значение параметра, добавленные в эскиз отверстия, выключенная операция. Правка каркаса или детали доходит до всех исполнений. В окне — раздел «Parts»: «+ Part», список исполнений у каждой детали («+ New variant»), точка у операции — изменена здесь, ↺ — вернуть как у родителя, «+» — своя; галочка у операции выключает её (в исполнении — без удаления). Выбранное исполнение каждой детали — это изделие: во «Frame» видно изделие целиком, в детали — она сама и остальные бледными рёбрами; галочка слева от детали скрывает её из изделия. Всё хранится в файле модели. Для агента:
levels,add_level,activate,choose,show,product, у остальных команд — необязательныйlevel. Из командной строки —--levelуbuild,dxf,snapshot. - Окно как в VS Code. Полоса значков у края и боковая панель с разделами друг под другом (Parts, Parameters, Features, под ними Sketch, пока эскиз открыт; в эскизе вкладки Draw, Constrain, Selection); щелчок по значку или Ctrl+B прячет панель; View → «Side bar on the right» переносит её вправо, «Reset layout» возвращает как было. Основные окна — вкладки (3D, Flat pattern, Library): перетащите вкладку к краю — окна встанут рядом; библиотека эскиза открывается с эскизом. Раскладка запоминается.
- Развёртка тела — без отдельной операции. View → Flat pattern: заготовка листа или плиты показывается рядом с 3D; тел несколько — список, он же переключается щелчком по телу в 3D. Сторон две: «Back side» — вид с другой стороны (зеркально); с лицевой стороны заготовка выглядит, как нарисованный эскиз. «DXF…» — для станка (R12, линий гиба нет); линии гиба на развёртке — штрихом. Из командной строки —
datum build модель.json --level деталь; для агента —flats,set_flat,export_dxf. - Исправлено: путь массива, нарисованный обычными линиями, не считается открытым контуром.
Файлы 0.3.1 открываются как есть. Файл 0.4 с исполнениями в 0.3.1 не откроется: в нём новые разделы.
Что нового в 0.3.1
Исправление: в 0.3.0 в новом документе не было видно плоскостей — ни XY, XZ, YZ при создании эскиза, ни рабочей плоскости после смещения.
- Плоскости и начало координат видны: в новом документе вид сразу показывает плоскости XY, XZ, YZ; пока в модели нет тела, они видны всё время — по ним понятно, куда смещена рабочая плоскость. Начало координат — точка и оси X (красная), Y (зелёная), Z (синяя). Смещение рабочей плоскости правится прямо в её строке в списке элементов (
plane1 · XZ + 10). - Плоскость, к которой камера подошла вплотную, обрезается краем вида, а не пропадает целиком.
Файлы 0.3.0 открываются как есть.
Что нового в 0.3.0
- Куб навигации в правом верхнем углу вида, как в Inventor: щелчок по грани, ребру или углу — вид оттуда (26 видов), перетаскивание по кубу вращает модель, домик над ним или F6 — изометрия с моделью целиком. Когда смотрите прямо на грань — треугольники к соседним граням и стрелки повернуть картинку на 90°. Вид поворачивается плавно.
- Эскиз на любой плоскости: S показывает плоскости XY, XZ, YZ — щелчок по плоскости или по плоской грани начинает эскиз; XY выбрана сразу, Enter или правый щелчок — эскиз на ней. Отдельной команды Sketch on face больше нет.
- Рабочие плоскости: команда Plane (
]) — щёлкнуть плоскость начала координат, другую рабочую плоскость или плоскую грань, ввести смещение (число или формула от параметров, напримерh/2), Enter. Плоскость видна в модели, на ней можно начать эскиз (S). В JSON и для агента — выдавливание до плоскости (плоскость вторым входом) и симметричное ("symmetric": true); в окне выдавливание пока не создаётся. - Look at (PageUp): щелчок по грани или плоскости — вид прямо на неё.
- Вращение без упора: модель вращается через верх и низ свободно, как в Inventor, а не упирается в «потолок».
Файлы 0.2.7 открываются как есть.
Что нового в 0.2.7
- STEP для заказчиков: File → Export STEP… — тела модели в STEP AP242 (мм), в папку
stepпроекта. Плоскости, цилиндры, отрезки, дуги и вырезы в вальцованном листе вдоль оси или по окружности пишутся точно. Круглые отверстия и косые вырезы в вальцованном листе в 3D — кривые, у которых в STEP нет точного типа: окно спросит, записать ли их сплайнами с отклонением не больше 0,0000001 мм. «Да» — рядом с файлом появится заметкадеталь.step.txtдля заказчика (что приближено и насколько), «Нет» — ничего не пишется. В файле — объём, площадь и центр масс: принимающая CAD (SolidWorks, Inventor, CATIA, NX) сверяет с ними то, что прочитала. Проверьте, пожалуйста, как открываются файлы у вас — особенно в Компасе. Из командной строки:datum build модель.json --out деталь.step(со сплайнами — добавьте--approximate). - Повтор команды мышью: правый щелчок, когда команда не выбрана, запускает последнюю команду заново, как Enter. Правый щелчок завершил отрезок — следующий правый щелчок снова его начинает.
- Горизонталь и вертикаль в эскизе точны — не «почти»: от этого зависят точные вырезы на вальцованном листе.
Файлы 0.2.5 открываются как есть.
Что нового в 0.2.5
- Меню и панель в одну строку: File, Edit, View, Sketch, Help — все команды окна с их клавишами; File → Open recent — последние файлы.
- Свои клавиши — в
settings.json, только отличия от стандартных (см. «Свои клавиши» ниже); что не удалось применить, окно покажет. - Проекты, как папка в VS Code: File → New project / Open project / Recent projects / Close project. Пока проект открыт, новые модели, экспорт и библиотека — в его папках; при запуске он откроется снова.
- Папки по правилу: детали в
part, DXF вdxf, элементы вlibrary; назвать папку иначе можно вdatum-project.json({"folders": {"part": "Детали"}}). - Размеры без лишних щелчков: линия — длина сразу, следующий щелчок по точке или параллельной линии — расстояние до неё, по другой линии — угол; начало и конец дуги — длина дуги, дуга дважды — её угол; H / V — горизонтальный / вертикальный размер наклонной линии. Перед числом — значок вида (⌒ ↔ ↕ ∠), а наведённый или выделенный размер подсвечивает, к чему относится.
- Мышью, без клавиатуры: правый щелчок или повторный щелчок по кнопке завершает команду; Enter запускает последнюю команду заново.
- Группы в эскизе — выделить → «Group», тянуть за значок; массивы (копии группы по сетке или заполнением области) — пока в JSON или агентом.
- Одна программа:
datum.exe— и окно, и командная строка, и MCP-сервер для агента (datum.exe mcp). - Исправлено: касательная дуга, подведённая к началу своей линии, вешала и закрывала окно; картинки без окна на Windows падали на Vulkan.
Файлы 0.2.1 открываются как есть.
Что нового в 0.2.1
Исправления по замечаниям тестеров (#57):
- Равенство окружностей («Equal» на двух окружностях) теперь работает: вторая берёт диаметр первой, свой размер у неё не показывается, двойной щелчок по ней меняет диаметр первой.
- Параметры: новый — строкой внизу таблицы (имя, значение или формула, Add), ✖ — удалить; имена можно писать по-русски (
диам,ширина_2), в том числе в формулах и размерах эскиза. - Клавиши: Ctrl+N — новая модель; Ctrl+W, Ctrl+S и клавиши эскиза больше не глохнут, когда фокус на кнопке.
- Окно запоминает размер и место на экране между запусками.
- Перетаскивание в эскизе, как в Inventor: линию, дугу, окружность можно тянуть целиком, а за выделенное — всё выделение.
Файлы 0.2.0 открываются как есть.
Что нового в 0.2
- Библиотека наработок эскиза. Выделили часть эскиза → «To library…»: сами выбираете точку вставки (и вторую — растянуть по осям или повернуть к ней), отмечаете, какие размеры спрашивать, и какие зависимости к соседним элементам дополнять при вставке. Вставка — из палитры справа двойным щелчком или перетаскиванием: поле у курсора спрашивает размеры (Tab — следующий, рядом — типовые комбинации), затем — щелчками — зависимости к соседям. Вставленное — обычная геометрия, без связи с библиотекой.
- Зависимости вручную: ряд «Constrain» — совпадение, горизонталь, вертикаль, параллельность, перпендикулярность, на одной прямой, равенство, касание, концентричность, середина, симметрия, закрепление.
- Файлы: детали открываются и сохраняются в папке
part(проекта или рядом с программой), Close (Ctrl+W), Ctrl+O; несохранённое не пропадает молча — программа спросит. Окно запоминает размер и место; в первый раз открывается на весь экран. - Агенту: можно показать свои действия (флажок «Record actions for an agent»), у него есть команды библиотеки.
- Надёжность: замена участка в середине контура рвёт только ссылки на удалённое, остальное держится; исправлено удаление линии вместе с её размером; значки кнопок больше не квадратики.
Переход с 0.1
- Эскиз, поставленный в 0.1 на торец выдавливания, сообщит «lost reference» — переставьте его на ту же грань заново (у торца сменился идентификатор).
- Свои шаблоны из
library/sketchesпереложите вlibrary/sketch, а геометрию в них оберните ключом"sketch"(как вrectangle.jsonв исходниках). Папкаlibraryв архив больше не входит: обновление программы её не трогает.
Как запустить
- Скачайте архив для своей системы со страницы Releases (не из Actions: там GitHub кладёт архив в свой архив) и распакуйте в любую папку — запуск прямо из архива не годится. Установка не нужна; удалить — удалить папку.
- Запустите
datum.exe(Windows) илиdatum(Linux). На Windows на миг мелькнёт окно консоли и закроется — так и задумано: из командной строки та же программа печатает в неё. Если окно не откроется, программа скажет почему и где журнал; то же покажет командная строка:datum.exe view models\symmetric_plate.json. Если окно закрывается молча, это драйвер видеокарты: в командной строке (cmd) выполнитеset WGPU_BACKEND=gl, затемdatum.exeи пришлитеdatum.log. - Windows может предупредить «Система Windows защитила ваш компьютер»: программа пока без цифровой подписи. Нажмите «Подробнее» → «Выполнить в любом случае».
Нужна видеокарта с Vulkan, DirectX 12 или Metal (подойдёт и встроенная).
Что попробовать
- Открыть модель: File → Open… (или Open recent — 10 последних) или перетащить
.jsonна окно. Примеры — в папкахexamplesиmodels. Параметры модели правятся слева, модель пересчитывается сразу; новый — строкой внизу таблицы (имя, значение или формула вродеw / 2 - gap, Add), ✖ — удалить. Имя параметра можно писать в размер эскиза. - Исполнения: откройте
models/wall_variants.json— раздел «Parts» слева: «Стенка верхняя» в исполнениях 1 м, 2 м, 2,5 м (у последнего ряд отверстий, у 1 м — вырез угла). Переключайте исполнение в списке; перейдите во «Frame», поправьтеWилиt— изменение дойдёт до всех исполнений. Создайте своё («+ New variant») и поправьте в нём эскиз или параметр. - Развёртка:
models/sheet_panel.jsonили исполнение стенки → View → Flat pattern; «Back side», «DXF…». - Эскиз: New sketch (S) — щёлкнуть плоскость начала координат (XY, XZ, YZ) или плоскую грань; XY выбрана сразу, Enter или правый щелчок — эскиз на ней. Карандаш у эскиза в списке операций — изменить.
- L — отрезок (цепочка; T или перетаскивание от конца — касательная дуга), C — окружность, P — точка, R — прямоугольник, D — размер, A — массив, G — группа, Esc — завершить команду. Мышью: правый щелчок (без перетаскивания) или повторный щелчок по кнопке команды. Enter или правый щелчок после этого запускает последнюю команду заново.
- Размер (D): щелчок по линии — длина сразу; затем щелчок по точке — расстояние от точки до линии, по параллельной линии — расстояние между ними, по другой линии — угол. Точка, затем линия — расстояние сразу. Начало и конец дуги — длина дуги; дуга, затем она же ещё раз — её угол. H / V (или кнопки в панели) — горизонтальный / вертикальный размер наклонной линии или двух точек: до выбора или сразу после, пока значение не начали печатать. Размер под курсором или выделенный подсвечивает, к чему относится (точки, линии, дугу); перед числом — значок вида: ⌒ длина дуги, ↔ горизонтальный, ↕ вертикальный, ∠ угол.
- При рисовании ограничения ставятся сами (горизонтально, вертикально, параллельно, касательно), Shift — без них. Наберите число — это длина (диаметр, радиус), Enter.
- Двойной щелчок по размеру — изменить; две точки (не концы дуги) — затем щелчок, где поставить: место выбирает горизонтальный, вертикальный или вдоль. Вместо числа можно выражение от параметров (
w - 2*gap). - Синие точки ещё свободны — их можно тянуть мышью; чёрное полностью задано. Линию, дугу, окружность тоже можно тянуть, а за выделенное — всё выделение сразу.
- Группы: выделите элементы → «Group». У группы значок (уголки рамки): навели — подсвечена вся группа, щелчок — выделена, потянуть за значок — переносится целиком. «Ungroup» — разгруппировать (элементы остаются).
- Ctrl+C / Ctrl+V — копировать часть эскиза с её ограничениями. Ctrl+Z / Ctrl+Y — отмена и повтор.
- Зависимости вручную: вкладка «Constrain» в разделе «Sketch» боковой панели — выберите вид (касательность, концентричность, параллельность…), затем щёлкните элементы; лишняя или противоречащая не добавляется, причина видна.
- Открыть, закрыть, сохранить — меню File: New (Ctrl+N), Open (Ctrl+O), Open recent, Save (Ctrl+S), Save as (Ctrl+Shift+S), Close (Ctrl+W), Exit; несохранённое не пропадает молча — программа спросит. Все команды окна с их клавишами — в меню; подсказка у пункта показывает имя команды.
- Проект: File → New project… — выбрать (или создать в диалоге) папку, она станет проектом; Open project… — открыть проект (папку без него предложит сделать проектом); Recent projects; Close project. Пока проект открыт, новая модель сохраняется в его
part, палитра берёт его библиотеку, имя проекта — в заголовке окна; при следующем запуске он откроется снова. Модель из другого проекта работает по правилам своего, а открытый проект не меняется. - Папки проекта: файл каждого вида — в своей папке рабочей папки (проекта или рядом с программой): детали в
part, DXF вdxf(экспорт предлагаетdxf/<имя модели>.dxf), элементы вlibrary. Назвать папку иначе можно вdatum-project.json:{"folders": {"part": "Детали", "dxf": "Развёртки"}}— только имя, без пути. - Свои клавиши: файл
settings.jsonрядом с программой (переносная копия уносит его с собой) или в папке пользователя (%APPDATA%\Datumна Windows,~/.config/datumна Linux; путь — в меню Help). В нём только отличия от стандартных:{"keys": [{"key": "Ctrl+Shift+Z", "action": "edit.redo"}, {"key": "Ctrl+Y", "action": null}]}— повтор на Ctrl+Shift+Z, Ctrl+Y снята. Клавиша пишется, как в меню. Читается при запуске; что не удалось применить — окно покажет, а клавишу, отнятую у другой команды, назовёт. Язык интерфейса: по системе (русская Windows — по-русски); переключается в меню View → Language (выбор запоминается) или строкой"language": "ru"("en","system") в том же файле — она действует, пока язык не выбран в меню. - Библиотека эскизов: палитра справа, пока редактируется эскиз; поиск, двойной щелчок — вставить, перетаскивание на эскиз — поставить там. R — первый элемент.
- Создать: выделите часть эскиза → «To library…». Точка вставки — «Pick» и щелчок по точке; вторая — для элементов на два щелчка (прямоугольник по углам, участок между двумя точками цепочки). Галочки у размеров — какие спрашивать (имя рядом), у зависимостей к внешним элементам — какие дополнить при вставке. «Save…» откроет папку библиотеки; имя файла станет именем элемента.
- Где лежат:
library/sketchрядом с программой (свои) и в папке проекта, где лежитdatum-project.json(проекта). Одно имя в нескольких местах — побеждает проект. Скопированный кусок эскиза (Ctrl+C) — тоже элемент, его можно положить туда файлом.
- ИИ-агент:
datum.exe mcp— MCP-сервер. Для Claude Desktop или Claude Code добавьте его как MCP-сервер с командойпуть\к\datum.exeи аргументомmcp: агент строит и правит модели, видит их картинкой. - Показать агенту, что вы делали: включите флажок «Record actions for an agent» (слева вверху): пока он включён, каждое действие в окне записывается строкой в
datum-actions.jsonlрядом сdatum.log(при запускеdatumиз консоли — ещё и в консоль). По умолчанию запись выключена. Дайте агенту этот файл: он видит последовательность операций и может её повторить.
Чего пока нет
Разгрузки и фланцев в углах, среза листа плоскостью (0.5–0.6), вращения (0.4.7), листового перехода (0.4.8), скруглений и фасок, сборок, чертежей и спецификаций. Это следующие этапы — см. ROADMAP.
Если что-то не так
Напишите в Issues или автору напрямую. Очень помогает:
- что делали и что ожидали;
- снимок экрана;
- модель (
.json, Save as…); - журнал
datum.log— путь к нему показан в окне слева вверху.
Обновления
Когда выйдет новая версия, в окне появится ссылка «Datum … is out». Обновиться — скачать и распаковать новый архив поверх старой папки (свои library и part архив не трогает) или в новую и перенести их. Отключить проверку: файл no-update-check рядом с программой или переменная окружения DATUM_NO_UPDATE_CHECK.