Repository navigation
Datum v0.5.3
Datum 0.5 — для тех, кто пробует
Datum — открытая CAD-система для инженеров-конструкторов: ядро многопоточное и детерминированное, модель — открытый JSON, ИИ-агент работает с моделью теми же командами, что и человек. Версия 0.5 — ранняя: в ней есть ядро, листовой металл (включая обечайки, конусы и врезку труб), окно с моделью и вкладками, эскизы на любой плоскости, массивы, рабочие плоскости, библиотека наработок, исполнения деталей, развёртка и STEP для заказчиков. Нам важно, что мешает и чего не хватает в ежедневной работе.
С чего начать. Справка → Уроки: окно ведёт по шагам, подсвечивает нужную кнопку и само засчитывает шаг, когда он сделан. Не понятно — «Показать»: окно само проделает шаг курсором и вернёт всё как было (Esc останавливает), а вы повторите. Застряли — «Сделать за меня». Начните с урока «Проект, материал и правило»: проект — ваше рабочее место в отдельной папке, он не пропадёт при выходе новой версии. Затем — «Новая деталь». Без открытой модели эскиз не начать: сначала «Файл → Создать» (Ctrl+N), затем материал и правило в верхней панели, затем S.
Что нового в 0.5.3
Листовая деталь теперь раскладывается как дерево: развёртка и вырезы считаются одним кодом, через любые ветви и любую глубину. Сложные фланцы строятся, а где материал ложится на материал, заготовка это показывает. Примеры для проверки: sheet_bmt, sheet_window, sheet_chain_cut, sheet_meeting и sheet_meeting_level в tests/models.
- Кромки всех стенок: на лотке выбираются все, в том числе несколько сразу. Обод — обычный фланец на фланце, по умолчанию все идут в одну сторону.
- Ус между ободьями: ободья, выбранные вместе, сходятся на ус с зазором из правила (фланец БМТ).
- Лапки на торце профиля: фланец с шириной на кромке стенки, с усом между лапками.
- Фланцы на кромках окна: щелчок по грани листа берёт весь контур её кромок, ближайший к точке щелчка.
- Наложение на заготовке: соседние фланцы строятся всегда. Где заготовка ложится сама на себя, красная рамка и предупреждение; разрешает это вырез на развёртке, он идёт через все слои.
- Рез по линии и по цепочке: открытая линия в эскизе на листе режет. Цепочка отрезков и дуг (отгибка под провод) — один рез. В детали зазор шириной реза, в развёртке и DXF сами кривые, один проход лазера. Ширина — новое поле правила «Ширина реза»: без него вырез откажет и попросит задать.
- Вырез на листе берёт всё из эскиза без выделения: контуры и линии. Что резать не надо, сделайте вспомогательным или положите в другой эскиз.
- Сходящиеся стенки разных углов: при стыке «На ус» новая стенка не доходит до внутренней грани прежней на зазор, а прежняя, более крутая, расширяется до наружной грани новой. Выше более низкой стенки высокая идёт прямо; флажок «Выровнять по высоте» поднимает низкую до верха высокой.
- Что использует операция видно при правке: пока открыта форма, всё, на чём стоит операция, подсвечено оранжевым. Shift или Ctrl и щелчок добавляет и убирает рёбра и контуры.
- Исправлено: неверная заготовка без ошибки на соседних стенках; ошибка «First use of widget ID» в списке деталей, когда от одного начала идут две ветки.
- Для агента (MCP): у
flangeновое полеlevel_walls, у правилаkerf.
Что изменится в старых файлах. Файлы 0.5.2 открываются, но форма может поменяться:
- Стык «На ус» рядом с более крутой стенкой, сделанной раньше: теперь меняется и прежняя стенка, и развёртка.
- Ободья: направление по умолчанию теперь одно на всех стенках, к лицевой стороне листа. Прежнее — «Другая сторона».
- Открытые линии в эскизе выреза на листе теперь режут. Раньше они не резали: проверьте такие эскизы.
Пока не работает (следующий выпуск):
- Поиск пересечений (F5) отложен. Стенки, идущие друг в друга, пока видны только глазами.
- Сходящиеся стенки — только если сначала построена более крутая. При обратном порядке прежняя стенка не меняется.
- Круглая разгрузка в углу между стенками разных операций ничего не делает, и форма об этом молчит. Нарисуйте окружность на развёртке и сделайте вырез.
- Рез по цепочке: цепочка, которая кончается дугой на кромке, — отказ, кончайте её отрезком. На обечайке рез по линии — отказ. Кривая кромки, входящая в зазор, до линии не продлевается.
- Заготовка может повернуться на 90° после выреза, если гибов в двух направлениях поровну. На заготовке с наложением отделённая вырезом часть отпадает без сообщения, даже большая.
- Линии гиба не вдоль осей заготовки в вырезе — отказ.
Что нового в 0.5.2
Фланец стал гибким инструментом: углы, разгрузка, ширина и границы стенки. Пример для проверки: лоток из пластины с четырьмя фланцами.
- Разгрузка в углу: квадратная или круглая (Ø из правила), прямо в 3D и на развёртке.
- Стык в углу: «Открыто», «На ус», «Перекрывает 1», «Перекрывает 2», с зазором из правила. Новая стенка дотягивается и до стенки сделанного раньше фланца, прежняя при этом не меняется. Рез всегда под прямым углом к стенке.
- Ширина фланца: «По ребру», «По центру», «Смещение», «Между отступами». Пока только для фланца на торце, не для фланца вдоль стенки.
- Разгрузка гиба у концов короткого фланца: нет, прямоугольная, скруглённая (размеры из правила).
- Место сгиба: «Снаружи» или «Заподлицо».
- Края стенки до плоскости: начало, конец и свободный край можно довести до рабочей плоскости с зазором. Стенка растёт или режется, гиб не меняется. Свободный край может быть скошен, высота тогда берётся от плоскости. Две детали стыкуются одной общей плоскостью и друг о друге не знают.
- Новые поля правила листа: K-фактор, зазор в углу, Ø разгрузки, ширина и глубина разгрузки гиба. Поля можно задавать через толщину
t. Если у вашего правила их нет, заполните: без них закрытый угол, круглая разгрузка и разгрузка гиба откажут и попросят значение. - Рабочая плоскость через линию эскиза, перпендикулярно плоскости или грани: выделите одну линию в открытом эскизе, нажмите «Рабочая плоскость» и щёлкните плоскость или грань. Линию можно щёлкнуть и в 3D. Так проще делать наклонные плоскости для стыков.
- Удаление операции из дерева: меню строки или Delete. Если операцию использует другая, будет отказ. Ctrl+Z возвращает.
- Исправлено — полосы и мерцание рабочих плоскостей при приближении и когда плоскость видна почти с торца.
- Для агента (MCP): у
flangeновые поляcorner,extent,bend_relief,bend_position,height_along,reliefиto; уplaneполеline.
Что изменится в старых файлах. Файлы 0.5.1 открываются, но два умолчания фланца другие, поэтому форма может поменяться:
- Высота теперь считается по перпендикуляру к листу до самой высокой точки фланца. У фланцев с углом не 90° размер изменится. Прежний отсчёт — флажок «Высота вдоль фланца».
- Фланец вдоль стенки теперь идёт внутрь, в ту же сторону, что соседние стенки. Прежнее направление — «Другая сторона».
Пока не работает (следующий выпуск):
- Кромки можно выбрать не у всех стенок: на лотке доступны две противоположные, у двух других нельзя. Поэтому рамку с отогнутым ободом по всем сторонам пока не сделать.
- Не хватает и другого: ус между ободьями, ширина у фланца вдоль стенки, лапки на торце профиля.
- Края стенки доводятся только до рабочей плоскости: грань своей детали и исходные плоскости XY, XZ и YZ выбрать нельзя.
- Где у стенки начало, а где конец, видно только по предпросмотру.
- Осторожно при работе через JSON или агента: фланцы на кромках соседних стенок могут дать неверную развёртку без ошибки. Из окна такой фланец не сделать.
Что нового в 0.5.1
Интерактивные уроки: окно само показывает, как работать.
- Уроки — меню «Справка → Уроки» или прямо из пустого окна. Карточка шага говорит, что сделать и зачем, называет клавишу, нужное место на экране пульсирует; шаг засчитывается сам, как бы вы его ни сделали: клавишей, через меню или кнопкой.
- «Показать» — окно само проделывает шаг курсором и подписывает нажатые клавиши, затем возвращает всё как было, а вы повторяете. Esc останавливает показ. «Сделать за меня» — то же, но результат остаётся. Где выбор идёт в диалоге Windows (папка проекта, файл), окно только покажет, где это.
- Три урока: «Проект, материал и правило» (с этого стоит начать), «Новая деталь», «Массив в эскизе».
- Уроки — файлы в папке
lessonsрядом с программой. Лежат в архиве выпуска; при обновлении программы переносите папку вместе с ней. - Без открытой модели S больше не создаёт эскиз: раньше появлялся эскиз в детали, которой нет, без правила и K-фактора. Сначала «Файл → Создать».
- В форме выдавливания появились OK и «Отмена»: раньше подтвердить можно было только клавишей Enter.
- Исправлено — материалы и правила не в той папке. При открытом проекте и новой несохранённой модели материал и правило записывались рядом с программой, а правила проекта не находились до первого сохранения. Теперь они идут в проект. Проверьте: если вы так заводили материалы, их файлы лежат в
libraryрядом с программой. Перенесите их вlibraryсвоего проекта, пока не заменили папку программы новой версией. - Отказавшая операция больше не опустошает вид: видно последнее удачное состояние, как в Inventor. Раньше при ошибке врезки исчезали обе трубы.
- Значки вместо символов шрифта: галочка, крестик, предупреждение и возврат к родителю в дереве и в сообщениях теперь нарисованы и не превращаются в квадраты. Стрелки убраны и из текстов.
- Для агента (MCP): у команды
newпоявилсяproject(папка проекта для модели без файла), новая командаset_project. У модели с файлом главным остаётся проект её файла.
Файлы 0.5.0 открываются как есть.
Что нового в 0.5.0
Врезка трубы в трубу: отверстие в основной обечайке и «рыбья пасть» на врезаемой — сразу в развёртке, как их режет лазер.
- Врезка трубы (меню «Эскиз» → «Врезка трубы»): щёлкните основную обечайку, затем врезаемую. В основной появляется отверстие под внутренний диаметр врезаемой (по наружной поверхности основной), конец врезаемой режется по её среднему диаметру так, чтобы она легла на наружную поверхность основной — внутри остаётся зазор под сварку. Стенки резов перпендикулярны листу. В дереве — две записи: отверстие у основной, конец у врезаемой; обе пересчитываются при изменении труб.
- Любой угол между трубами и смещение оси врезаемой (врезка не по центру) — если врезаемая целиком помещается в ширину основной. Окно откажет и скажет почему: трубы параллельны, врезаемая шире основной или выходит за её бок, отверстие задевает шов, торец или другой вырез.
- Труба под углом рисуется как обычно: ось наклонно, стенка «параллельно» ей — это обечайка, а не конус (раньше наклонная линия могла стать конусом с ничтожным наклоном, и врезка отказывала).
- Примеры:
examples/branch_angle.json(под углом ≈53°, отверстие на развёртке заметно овальное),examples/branch_offset.json(со смещением оси),examples/branch_angle_offset.json(и угол, и смещение). Развёртки — на панели «Развёртка», выберите тело. - Развёртка: отверстие и линия конца — на заготовках обеих труб. В DXF такие кривые идут ломаной (LWPOLYLINE) с отклонением не больше 0,001 мм — окно спрашивает согласие и пишет рядом заметку; в STEP — сплайн, тоже с согласия.
- Исправлено: щелчок по детали в 3D при открытой «Развёртке» снова показывает её развёртку; эскиз на развёртке больше не рисуется в 3D (его место — только на панели «Развёртка»).
- Для агента (MCP): команда
branch(main,branch,hole,saddle) добавляет обе операции разом или ни одной; в файле модели — операцииbranch_hole(входы: основная, врезаемая) иsaddle(входы: врезаемая, основная).
Пока нет: врезка в конус и врезка конуса, врезка «насквозь» (отверстие под наружный диаметр), врезка рядом со швом и в другой вырез. Это — следующие выпуски 0.5.x.
Файлы 0.4.9 открываются как есть.
Что нового в 0.4.9
Ассоциативная развёртка: на развёртке рисуют, режут и наращивают, и это сразу видно на детали.
- Эскиз на развёртке. На вкладке «Развёртка» — кнопка «Эскиз»: эскиз открывается прямо на заготовке, окно 3D остаётся моделью (вращайте её, пока рисуете). Контур заготовки и линии гибов уже в эскизе — вспомогательными: от них ставят размеры. Координаты — как в DXF: начало в углу заготовки. Закрыть вкладку — то же, что «Готово». В дереве такой эскиз помечен значком развёртки.
- E на эскизе листа: «Вырез» или «Наращивание». Вырез — как раньше, насквозь, через гибы тоже. Наращивание — контур снаружи заготовки, касающийся её края: стенка продолжается в своей плоскости (язычок, в том числе со скруглённым концом). На развёртке выбор делается сам по положению контура; переключается в форме. Язычок можно рисовать стороной прямо на кромке — так же и вырез. Пока наращивание — в пределах одной стенки; через линию гиба — позже (окно скажет).
- «Только в развёртке» — галочка в форме выреза: технический вырез (например, метка у линии гиба для гибщика). Он есть на развёртке и в DXF, но не в детали: не в 3D, не в STEP, не в массе. Правка из дерева переключает галочку.
- P на развёртке берёт в эскиз линии заготовки: прежние вырезы и отверстия, линии гибов (и контур, если он не взят целиком). Для размеров — сразу; в контур — Q.
- Вид 3D — ортогональный, как чертёж: длины не зависят от глубины. Перспектива — «Вид → Перспектива» (запоминается).
- K-фактор без K в правиле. Если в листовом правиле нет
k_factor, вырез через гиб берёт K развёртки (настройка развёртки, по умолчанию 0,5) — раньше он отказывал «нужен k_factor». Смена K развёртки пересобирает деталь. - Предупреждение об искажении у гиба — только о реальном: кромки поперёк линии гиба (паз, разгрузка через гиб) и торцы выреза, рядом с которыми гиб вырезан на всю ширину, не предупреждают; отверстие у гиба — предупреждает.
- Исправлено: вырез через гиб, нарисованный на второй стенке L-листа, отказывал или давал тело больше исходного.
- Для агента (MCP): у эскиза
flat: "front" | "back"(на развёртке тела-входа), проекцияblank: "outline" | "bends" | <имя линии>; у выдавливания листаmode: "join"(наращивание) иblank_only: true(только в развёртке).
Пока нет: «Показывать на развёртке» у эскиза на грани листа (линии соседней детали на заготовке); наращивание через линию гиба; эскиз на развёртке обечайки и конуса; рез в одну линию. Врезка трубы — в 0.5.0.
Файлы 0.4.8 открываются как есть.
Что нового в 0.4.8
Проецирование геометрии в эскиз: деталь по соседней детали и по скелетному эскизу.
- Эскиз: P — «Проецировать». Видно всё, что можно спроецировать из элементов до этого эскиза: рёбра и вершины тел (своей детали и соседних) и точки, отрезки, дуги, окружности других эскизов, в том числе скелета. Это видно бледно, под курсором — жирно, подпись — откуда (
two: ребро,skeleton: l1). Щелчок — проекция. Она следует за источником: правите скелет или соседнюю деталь — эскиз перестраивается. Esc заканчивает. - Проекция ребра или элемента — вспомогательная: к ней привязываются и от неё ставят размеры. Чтобы спроецированные рёбра или отрезки стали контуром (выдавить по форме соседа), выделите их и нажмите Q. Соседние рёбра сходятся в общей точке, контур замыкается.
- Грань целиком: в P наведите курсор внутрь грани (подальше от рёбер) — подсветится её контур, щелчок проецирует всю грань сразу контуром для выдавливания, с отверстиями. Отверстие, появившееся в грани потом, тоже попадёт в эскиз; размеры к рёбрам не съедут.
- Проецировать срез (меню «Эскиз»): сечение плоскостью эскиза каждого тела, построенного до эскиза, — контуром. Следует за телами. Отверстия и трубы: плоскость поперёк оси даёт окружность (срез детали с отверстиями выдавливается сразу с отверстиями), наклонная — эллипс (вспомогательный). Пока команда скажет, что не может: плоскость вдоль оси цилиндра, плоскость через торец цилиндра или через вершину, конус.
- Новый эскиз открывается так, что видно всё, что можно спроецировать (скелет, соседние детали), — приблизьте колесом. Двойной щелчок в эскизе вписывает и эскиз, и окружение.
- Точка — теперь «.» (была P).
- Без проекции «за спиной». Раньше привязка к ребру грани при черчении сама создавала проекцию. Теперь привязки к рёбрам грани нет: проецируйте явно, P.
- Ребро, видимое торцом, проецируется точкой. Дуга или окружность под углом к плоскости эскиза проецируется эллипсом (например, наклонное отверстие): к его центру и концам можно ставить размеры. Эллипс пока только вспомогательный: выдавить его нельзя, окно скажет об этом. Окружность, видимая строго торцом, пока не проецируется. Пример:
examples/tilted_hole.json— брусок с отверстием (диаметр — параметрd), над ним наклонная рабочая плоскость (через три вершины, отступ 40) и эскизslantedна ней: верхняя кромка отверстия уже спроецирована эллипсом; откройте эскиз, P — щёлкните нижнюю кромку; поменяйтеd— эллипсы следуют. - Правка любой операции — карандаш в дереве: выдавливание, лист, грань листа, вырез листа, фланец (как уже у вращения и среза). Открывается та же форма с текущими значениями: глубина, «Симметрично», режим (добавить ⇄ вырезать), ширина и сторона листа, высота и угол фланца; предпросмотр сразу, Enter — изменить. Новое тело остаётся новым телом.
- Длинная деталь больше не обрезается при приближении к одному её концу (ближняя и дальняя плоскости вида охватывают всю модель).
- Для агента (MCP): у проекции
from(имя элемента-источника),id(ребро или вершина тела),face(грань тела),section: true(срез) илиelement(имя в эскизе-источнике),construction. Входы эскизаedit_sketchведёт сам: добавил проекцию — источник стал входом.
Пока нет (честный отказ с причиной): эллипс в профиле (выдавить наклонную проекцию отверстия); связь «точка на эллипсе»; окружность, видимая строго торцом; срез вдоль оси цилиндра, через торец цилиндра, через вершину тела, срез конуса. Врезка трубы в обечайку и конус перенесена в 0.4.9.
Файлы 0.4.7 открываются как есть.
Что нового в 0.4.7
Вращение: тела вращения, обечайки и конусы из листа с развёрткой, срез обечайки плоскостью; привязки эскиза как в AutoCAD.
- Вращение — R (значок на верхней панели рядом с выдавливанием, пункт «Эскиз → Вращение»). Работает и из открытого эскиза: эскиз закрывается, открывается форма. Эскиз — как у E: открытый или единственный неиспользованный. Ось — линия эскиза: единственная вспомогательная, иначе отдельная линия со свободным концом; сменить — списком в форме.
- Тело вращения: замкнутый полупрофиль из отрезков. Отрезок вдоль оси даёт цилиндр, наклонный — конус, поперёк — диск или кольцо. Угол — 360 или меньше (сектор). Конус в STEP — точный.
- Вальцованный лист — R на эскизе с одной линией кроме оси. Сначала выберите на панели материал и правило листа (толщина и K-фактор — из правила; без него форма подскажет и не даст OK). Линия параллельно оси — обечайка, наклонная — конус; сторона материала — слева, справа, посередине. Угол 360 — целая обечайка с зазором на шве (мм, по нейтральному слою на большем диаметре, шов симметрично плоскости эскиза; зазор 0 нельзя — лист не развернётся). Угол меньше 360 — кусок (полуобечайка) от плоскости эскиза, без зазора.
- Развёртка: обечайка — прямоугольник (длина нейтрального слоя минус зазор), конус — точный сектор кольца (две дуги и два отрезка).
- Срез плоскостью — пункт «Срез плоскостью»: щёлкните рабочую плоскость; уходит часть со стороны стрелки плоскости, значок «Другая сторона» оставляет её; предпросмотр сразу. Линия среза — по нейтральному слою, стенка перпендикулярна листу. На развёртке линия — плавная кривая; в DXF она пишется ломаной (LWPOLYLINE, отклонение не больше 0,001 мм) только после «Да» в вопросе, рядом с файлом — заметка
.dxf.txt. Отверстия на обрезанной обечайке можно, если они не задевают полосу линии среза. Пример:examples/shell_trim.json— обечайка, срезанная наклонной плоскостью. - DXF — версии R2000.
- Правка из дерева: карандаш у строк вращения, вальцованного листа и среза открывает ту же форму с текущими значениями (ось, угол, зазор, сторона; сторона среза). Правило листа меняется на панели.
- Эскиз: Q — «Вспомогательная». Выбранные линии, дуги и окружности переключаются между обычной и вспомогательной геометрией; ничего не выбрано — включается или выключается черчение вспомогательными. Прямоугольник больше не на R — он в меню эскиза.
- Эскиз: отслеживание, как в AutoCAD. При черчении курсор прилипает к уровню X или Y любой точки эскиза (пунктир от точки), новая точка связывается «вертикально» или «горизонтально». Работает и вдоль наклона линии: касательно к дуге, параллельно, перпендикулярно. Shift — без привязок.
- Эскиз: автосовмещение. Конец, перетащенный к другой точке или к середине линии или дуги, прилипает; при отпускании — связь «совпадение» или «середина».
- Середина дуги — на биссектрисе, при любом угле дуги: привязка при черчении и перетаскивании, связь «Середина» принимает дугу. Габарит овала: вспомогательная ось через середины двух дуг и размер её длины — меняете размер, овал перестраивается без формул.
- Значки вместо символов в формах фланца, грани листа и среза.
- Для агента (MCP):
revolve(axis,angle),rolled(rule,axis,side,angle,gap),trim(тело и плоскость,flip);export_dxfсapproximate.
Пока нет (честный отказ с причиной): срез конуса и вырезы на конусе; срез плоскостью, выходящей через торец (срез угла), и плоскостью вдоль оси; отверстие на отрезаемой части или в полосе линии среза; дуги в профиле вращения (тор, сфера) и конус до точки; вращение с добавлением к телу или вырезом (пока только новое тело). Врезка трубы в обечайку и конус — следующий выпуск, 0.4.8.
Файлы 0.4.6 открываются как есть.
Что нового в 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.