Modulor

Agent-native 的二维绘图 + 三维建模内核。没有 GUI，没有鼠标——JSON 进，几何出。

English: Modulor is an agent-native 2D drafting + 3D modeling kernel — the geometry layer for the agent era. No GUI: the entire tool is a self-describing JSON op protocol (77 ops, contract-tested) over a plain-JSON document format, callable via CLI, JSON-Lines pipe, MCP server or Python. Parametric recipes, architectural semantics, freeform surfaces, DXF/glTF interop, a built-in verification loop (measure / validate / render-and-see), and a conformance checker for the format. Agents read AGENT_GUIDE.md; the API contract lives in docs/API.md; the file format spec in docs/FORMAT.md. Named after Le Corbusier's Modulor — a universal measure for building, this time for machines.

传统 CAD软件 是为人类的眼睛和手设计的：菜单、视口、 捕捉、快捷键。Agent 调用它们时，要么模拟人类操作，要么穿过厚重的插件层。 Modulor 反过来：把 CAD 的几何核心保留下来，把交互层整个换成 Agent 的母语 ——结构化命令、结构化结果、结构化错误，外加一条"渲染成图、亲眼验证"的反馈回路。

                ┌─────────────────────────────────────────┐
   Agent ──────▶│  CLI batch │ CLI pipe │ MCP │ Python API │
                └──────────────────┬──────────────────────┘
                                   ▼
                       JSON 命令（自描述 op 协议）
                                   ▼
                ┌─────────────────────────────────────────┐
                │  几何内核：manifold3d (Clipper2 + Manifold) │
                │  2D/3D 布尔 · 偏移 · 拉伸 · 旋转体 · 切片    │
                └──────────────────┬──────────────────────┘
                                   ▼
        .json 文档 · SVG · DXF · PNG 渲染 · OBJ / STL / GLB

核心能力（77 个自描述操作，接口已冻结于 1.0-rc）

扩展生态：领域能力住扩展包——装上扩展即获得 mech.gear 渐开线齿轮（官方模板）； 三十行代码就能写出你自己的扩展，命名空间与 API 法律由机制强制， 见 docs/PLUGINS.md。

身份与治理：项目名/包名/CLI/格式标识已正式冻结； Standard（规格，供第三方实现）与 Core（参考实现，canonical 而非排他）的 边界、semver 与兼容政策、RFC 流程见 GOVERNANCE.md。

标准的两半都已成文并由测试看守：op 协议——docs/API.md （由注册表生成）+ 机器可读契约 docs/api.json，实现与契约 不一致时测试直接失败；文档格式——docs/FORMAT.md 规格

• docs/document.schema.json（JSON Schema）， 每份示例文档都在 CI 里对着 schema 验证。

与主流 CAD 的互操作是契约（docs/INTEROP.md）： DXF 导出为 R2000 原生对象（ELLIPSE/SPLINE/HATCH/关联 DIMENSION/ BLOCK+INSERT），在 AutoCAD 里直接可编辑；导入保留块结构；每个导出文件 在 CI 里由 ezdxf（DXF）与 ifcopenshell（IFC4）做语义级校验。

• 参数化（文档 = 数据 + 配方）：任何数值字段接受表达式 （"bay*3"、"level_top('L2')"、"grid_x('B')"）；recipe_set 把生成 命令存进文档作为设计意图，set_param + regenerate 一条命令全模型 联动重建——"柱距 4m 改 5m，其他保持联动"就是这两个调用

• 建筑语义：轴网 add_grid（平面出轴线+编号气泡，交点可在表达式中引用）、 标高 add_level、房间 add_room（平面自动标注名称+面积 m²）、 面积报告 program（按名称/标高/类型汇总）、坡屋顶 add_roof（平/单坡/双坡）、 楼梯 add_stair（自动按舒适度公式 2R+T=630 排踏步）、幕墙 add_facade

• 方案迭代：snapshot / restore 快照，diff 对比两个方案 （参数变更、实体增删改、体积面积增量），recipe 让设计意图跨方案继承

• 2D 制图：线 / 多段线 / 样条曲线 / 圆 / 弧 / 矩形 / 文字、 对齐·角度·半径标注（自动测量）、圆角 / 倒角、图层、2D 布尔、偏移

• 建筑墙体：中心线画墙（直线、闭合环、样条曲线墙），门窗洞口按 沿墙距离定位，平面图出双线+开启线，3D 自动成体

• 3D 建模：体块 / 圆柱 / 球 / 拉伸（扭转、收分）/ 旋转体 / 稳健 3D 布尔（Manifold 内核，不会产生破面）/ 切片 / 平面与立面投影 / 抽壳

• 自由形态（Agent 的主场）：断面放样 loft（纵向样条插值出流动曲面）、 沿空间路径扫掠 sweep、自由变形 deform（扭转/锥化/弯曲）、 隐式曲面 add_implicit（用数学表达式雕塑形体，smin/smax 平滑融合）、 网格平滑 smooth——Zaha 级别的异形语汇，全部走 JSON 命令

• 变换：移动 / 复制 / 旋转 / 缩放 / 镜像 / 网格与环形阵列，2D/3D 通吃

• 反馈回路：measure / validate / find 空间查询 / render labels=true 把实体 id 印在图上 / sna

... View full README on GitHub