BAIZE AI RESOURCE

CAD 文档与网格生成

text-to-cad

text-to-cad 是 CAD 工具链,包含 Python 引擎、共享渲染运行时与本地 Viewer,可把 CAD 源码转为文档、网格及可视化结果。

text-to-cad

资源介绍

text-to-cad 是一个以代码为源头的 CAD 工具链仓库,核心是 PyPI 发行包 cadgen:它把 CAD 源码执行成文档,把文档编译成派生状态,再把派生状态渲染为像素与网格。仓库同时包含共享 JavaScript 渲染运行时 cadgen-js(负责把缓存几何变成画面、网格与运动),以及本地 CAD Viewer 应用——一个只服务单个目录的本地 HTTP 服务,用于浏览、测量、检查装配体、运动学与动画。设计上强调生成文件与源码完全解耦:STEP、DXF、STL、GLB 等产物连同 sidecar 文件可独立渲染,缓存中只保存可重建的派生结果,并保证字节级确定性。适合用代码方式建模、需要可复现导出与本地审阅 CAD 产物的工程师与开发者。

Skill 能力

源码驱动的 CAD 编译

以 Python 模型脚本为源头,执行后生成 STEP、DXF、STL、GLB、3MF 等产物及其 sidecar 描述文件。

产物与源码解耦

生成文件连同 sidecar 可独立渲染与检查,删除源码不影响已有产物的查看结果。

共享渲染运行时

cadgen-js 提供场景构建、网格加载、运动学与动画求值等能力,供 Viewer、文档站与快照渲染共用。

本地 CAD Viewer

本地 HTTP 服务,单目录实例,支持目录浏览、标签页、选择、位姿、动画、测量与主题设置。

字节级确定性

同一输入产生相同字节,STEP、网格与 DXF 导出均可复现,支撑内容寻址与缓存校验。

资源配置

适用平台

Claude CodeCodex

支持模型

模型无关

调用方式

命令调用

安装与调用

  1. 安装 cadgen 发行包,在模型脚本中声明几何与导出能力。

  2. 运行模型脚本生成 STEP、DXF、STL、GLB 等产物及对应 sidecar 文件。

  3. 在需要审阅的目录下启动 cadgen viewer,通过本地地址打开页面。

  4. 在 Viewer 中通过 ?file= 参数选择目录内的具体产物进行查看与测量。

  5. 开发模式下可分别启动 docs 站点与 viewer 客户端,并运行各自测试脚本。

使用案例

本地审阅 CAD 产物

使用场景设计创作

在包含生成产物的目录中启动 cadgen viewer,浏览目录、切换标签页并检查装配体与测量数据。

行星齿轮装配体展示

使用场景开发编程

文档站首页通过共享运行时在浏览器中渲染行星齿轮装配体的真实 CAD 模型与组件树。

运动学与动画验证

使用场景科研分析

利用 sidecar 中的运动学与动画数据,在 Viewer 中驱动位姿与动画播放,验证模型行为。

包含内容

text-to-cad-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt

常见问题

text-to-cad 与 cadgen 是什么关系?
text-to-cad 是仓库名称,cadgen 是其中发布的 PyPI 发行包,包含 Python 引擎、内置的 JavaScript 运行时以及 CAD Viewer 服务。
生成的 CAD 文件需要源码才能查看吗?
不需要。生成文件连同其 sidecar 可独立渲染与检查,删除源码不会改变已有产物的渲染结果。
CAD Viewer 是云端服务吗?
不是。它是本地 HTTP 服务,一个实例只服务一个目录,没有托管部署。
支持哪些导出格式?
仓库资料中提到的生成产物包括 STEP、DXF、STL、GLB 和 3MF。