CADFLOW 0.1.0 · ALPHA
CadFlow
面向程序化建模与几何驱动智能体的 Python-first CAD 基础设施。
CadFlow 是面向程序化建模与几何驱动智能体的 Python-first CAD SDK。它通过公共 Python 前端驱动句柄式 C++17 运行时，把 OpenCascade 几何运算保留在原生层，同时提供可预测的操作、JSON-safe 诊断、检查工具和可移植产物。
CadFlow 不是 Text-to-3D 模型，也不是 LLM 应用。它是这些系统下方的确定性 CAD 层：程序或智能体描述建模意图，CadFlow 构建并测量几何，然后返回软件可以直接处理的证据。
第一次使用从源码安装，在十分钟内构建并验证第一个零件。阅读文档 →建模工作流掌握轮廓、特征、布尔运算、变换和可靠的导出路径。阅读文档 →面向智能体使用结构化诊断、预检、重放与渐进式 CAD Skills。阅读文档 →查阅 API按核心对象和领域模块找到稳定的公共入口。阅读文档 →
可以构建什么
| 领域 | 已包含的能力 |
|---|---|
| 实体建模 | 基本体、轮廓、拉伸、旋转、放样、扫掠、圆角、倒角、抽壳和精确布尔运算 |
| 曲线与曲面 | 直线、圆弧、样条、螺旋线、Bezier/B-spline 曲面、直纹/填充/Gordon 曲面和扭转扫掠 |
| 草图 | 不可变坐标系、工作平面、声明式草图、约束和 py-slvs 求解 |
| 柔性几何 | 控制网格 Panel、周期薄壳、多 Panel 组合和 OBJ/STL/JSON 导出 |
| 几何检查 | 质量属性、距离、包围盒、拓扑、法向、曲率、自由边界和 BREP 对比 |
| 产物交付 | STEP、STL、GLB 预览、Model JSON、严格重放和经过验证的 Scene 归档 |
| 产品结构 | 装配、连接器、约束、语义标签、来源映射、材料和标准件 |
选择合适的 API 层
CadFlow 有意同时提供精简的现代前端和更大的兼容功能面。
| 优先入口 | 适用场景 |
|---|---|
cadflow.Model 与 cadflow.Shape | 交互式构造、测量、验证和导出 |
cadflow.Graph | 通过一次原生调用执行紧凑的类型化操作批次 |
| 公共领域模块 | 草图、装配、检查、序列化、Scene 归档和标准件 |
cadflow.compat | 原生迁移期间需要完整兼容 API 的工作流 |
新的集成应从 Model 或 Graph 开始，并通过公共领域模块使用更高层工作流。应用代码不应依赖 cadflow._engine、OpenCascade 对象、私有句柄或直接加载 C++ 动态库。
Alpha 状态
CadFlow 0.1.0 仍处于 Alpha 阶段。完整 OCCT 源码构建目前在 Linux x86-64 上测试。公共几何路径正在按领域从内置兼容引擎迁移至原生 Session；在部署前请查看原生与兼容边界。