v2.17.2  ·  424 tests pass  ·  AGPL-3.0

让 LLM 看见
真实几何

手绘草图, 文字描述, 通过 调研→提问→计划→逐件建模 的 harness 流程, 生成工业级 .step 几何.

34 个公开 op  ·  100% 真实实现  ·  OpenCascade 内核
★ Star on GitHub 查看 44 个 op →
0%
SINGLE BOOLEAN ERROR
真实 OCC, 0 占位
多次累加 2-7% 边界精度损失
34公开 op
424测试全过
v2.17.23 端到端 demo
↓ SCROLL
Workflow

拟人化建模, 工程师的方式

不是"一次性预测". 模仿工程师: 看完想清楚, 边做边看, 错了就回退.

01

看 · Vision

手绘 PNG + 文字 → 结构化 JSON

part_type, dimensions
02

想 · Planner

JSON → op 序列

34 public ops, Few-shot
03

做 · MechKernel

每步立即反馈

StepResult {ok, geometry}
04

验 · Validate

几何 + 碰撞 + 渲染

8 kind assembly check
Capabilities

34 个公开 op, 从草图到装配

公开能力聚焦零件建模主线; 装配与参考系等 10 个 op 走 experimental 闸门 (默认不对 LLM 开放). v2.12 起新增 make_gear (真渐开线齿轮坯) 与 run_script (受控代码通道).

PUBLIC · 34 OP

草图 → 零件

草图 / 主体 / 细节 / pattern / query / I/O / 事务 / 重放 / 约束 / 渲染 / 验证, 全部真实 OCC 实现.

add_arc add_circle add_constraint add_line add_polyline add_rectangle boolean chamfer circular_pattern close_sketch create_workplane delete_feature export extrude fillet hole linear_pattern make_gear measure mirror new_sketch query rebuild redo render revolve select set_parameter shell solve_sketch sweep undo update_feature validate_geometry
v2.12 · 1 OP

真渐开线齿轮

make_gear 直接造齿轮坯 (ISO 21771 齿形), 参数化重放; 大齿数按阈值回退梯形. 紫色高亮.

make_gear
v2.13 · 1 通道

受控代码通道

run_script 让模型写脚本一次成型, 但命名空间只暴露内核门面 k + math; AST 白名单 + 检查点回滚 + 脚本 op 可重放.

run_script
v2.14 · 3 命令

装配场景

无状态装配命令: XCAF 具名装配 STEP 导出 / bbox 预过滤全对干涉 + 豁免表 / 分件着色四视角. 珊瑚高亮.

export_assembly assembly_interference render_assembly
v2.15 · 0 OP

渲染净化

证据图质量修复 (零 API 变更): OCP 角向细分封顶曲面刻面; 只画二面角 >30° 的特征边 — 平面扇形三角化的对角噪声全部消失; crease-aware 平滑法线抹平曲面色带; 边以朝视点细 quad 并入面片集合, 背面线被正面正确遮挡.

welded mesh feature edges smooth normals ribbon lines
v2.16 · 0 OP

可靠性硬门控

run_script 默认 abort：脚本内任一 op 失败即整体回滚 + SCRIPT_OP_FAILED + failed_op 结构（半成品绝不静默交付）；best_effort 收集失败但 success 恒 false；ScriptOpError 可被脚本 try/except 捕获做条件回退。

failure_policy failed_op SCRIPT_OP_FAILED
v2.17 · 几何语义

引用锚点 + 孔语义

select 发放带几何指纹，同串引用换代在结果里显式报 rebindings；fillet/chamfer/shell/workplane 支持 expected 锚点，不符即 TOPOLOGY_REFERENCE_REBOUND。query what=holes 用实体分类器判凹凸/贯通/深度/位置——外凸台绝不算孔。hole 盲孔深度修复：进入面沿钻轴实测（不再信全局 bbox）。

rebindings expected 锚点 query holes entry probing
EXPERIMENTAL · 10 OP

装配与参考系 (闸门后)

默认不进入 LLM 能力集; 上层装配流程经 v2.14 场景命令驱动, 不直接暴露这些 op.

assemble check_interference create_reference_plane query_assembly resolve_placement validate_assembly +4 more
Live demo

减速器箱座, 34 公开 op 全流程

demo 16: 单级减速器箱座 — 用 MechKernel 34 公开 op 全流程. 草图 → extrude → fillet → chamfer → hole → linear/circular_pattern → mirror → 选边选面 → 排油孔 → 油标 → 顶缘倒角.

Gearbox Housing demo 16
单级减速器箱座 200 × 130 × 72 mm

34 公开 op 全流程, 造 1 个箱座

demo 16: 减速器箱座 — 用 MechKernel 34 公开 op 全流程. 草图 → extrude → fillet → chamfer → hole → linear/circular_pattern → mirror → 选边选面 → 排油孔 → 油标 → 顶缘倒角.

  • Housing 200×130×72 mm, 4 mount + 端盖 + 油标 + 排油 + 顶缘倒角
  • Select 边 reference v2.14 闭环: 用 select 选面, 倒圆按边引用, 选面/边互联
  • Hole 任意面 direction 油标孔斜向, 排油孔带方向, 不只正交
  • 精确体积 425546 mm³, 参数化重放 + 边引用闭环 100% 测试覆盖
查看源码 →
Roadmap

9 个月, 从 18 op 到 44 op

当前 v2.17.2, 自评分 6.5/10, 距离工业生产 1.0 还需 2-3 人月.

v1.0
18 op
事务基础
v2.0
参数化
重放
v2.4
草图
约束
v2.5
专业
渲染
v2.6
验证 +
回滚
v2.7
参考
坐标系
v2.8
真实
齿轮
v2.9
碰撞
检查
v2.12
真齿轮 op
+ 逐件重置
v2.13
代码通道
run_script
v2.14
装配场景
STEP/干涉
v2.15
渲染净化
特征边+平滑
v2.16
脚本失败
即整体回滚
v2.17
引用锚点
孔语义
Numbers

用数字说话

44 op
真实实现, 0 placeholder
从草图到装配, 13 大类, LLM 可直接调用
424 / 424
测试 100% 通过
v1.0 → v2.17.2 全面覆盖, 含集成测试 + 几何验证
2-3 人月
距工业 1.0
真 CAD 工业级生产标准, 已 6.5/10
"看 → 想 → 做 → 验" 的拟人化范式, 让 LLM 不再是一次性预测, 而是边做边看, 错了就回退的工程师.
v2.17.2 自评 · 6.5/10 · 距离 1.0 还需 AABB + 装配诊断 + 集成 aicad

从手绘草图, 到真实装配

让 LLM 拥有工程师的双手.

★ Star on GitHub 查看文档