text-to-cad CAD Viewer文件格式支持矩阵：每种文件的可用功能一览

text-to-cad CAD Viewer文件格式支持矩阵：每种文件的可用功能一览

【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad

text-to-cad 是一个面向 CAD、CAE 与 CAM 的 Agent 技能库，其中的 CAD Viewer 是一个运行在本地的浏览器 3D 预览工具：一条命令启动后，就能为 STEP、STL、3MF、GLB、DXF、URDF、SRDF、SDF 等文件提供带交互控件的实时预览链接。本文将 CAD Viewer 支持的文件格式与每种格式可用到的功能整理成一张完整的CAD Viewer 文件格式支持矩阵，帮你快速判断"我的文件能在 Viewer 里看到什么、操作什么"。

30 秒启动：获得 CAD Viewer 预览链接

CAD Viewer 通过固定端口3245（十六进制0xCAD，即"CAD"）提供服务，一个 Viewer 实例即可浏览任意目录下的所有模型文件：

npm --prefix scripts/viewer run start -- --host 127.0.0.1

启动后，URL 的路径就是项目目录，file=参数选中目录中的某个工件，例如：

http://127.0.0.1:3245/absolute/project/models?file=mechanisms/lift_table.step.py

几个使用要点：

• 路径必须是绝对目录——Viewer 会递归扫描该目录，左侧文件浏览器就能自由切换文件；
• 对生成的模型传生成器源码（<name>.step.py）即可，渲染工件按需构建，无需.step文件已存在；对导入的 STEP 则直接传.step/.stp；
• 若端口被占用，改用--port <n>指定空闲端口；
• 技能细节见 skills/cad-viewer/SKILL.md。

CAD Viewer 文件格式支持矩阵总览

下表汇总了 8 类受支持格式及其核心能力，功能细节完整出处见 skills/cad-viewer/references/viewer-features.md：

Viewer 后端为每种扩展名映射了严格的 MIME 类型（如.step→application/step、.urdf→application/xml），实现见 skills/cad-viewer/scripts/viewer/server_py/content_types.py。

STEP / STP：功能最完整的格式

STEP 是 text-to-cad 的主 CAD 工件，Viewer 为它提供了全格式中最丰富的交互：

• 装配树浏览：展开装配结构，对任意零件执行隐藏/显示；
• 检查与聚焦：点击零件自动聚焦查看；
• 拓扑选择：选择面、边、顶点或整个零件，并可一键复制#o1.2.f1这样的#...CAD 引用，直接粘贴进提示词来精确编辑特定部位；
• 显示模式：实体 / 渲染 / X 光 / 隐藏线 / 线框 / 平直 / 线 7 种模式；
• 裁剪面（Clip）：X/Y/Z 位置滑杆加 Flip 与 Reset，快速剖切查看内部结构；
• 爆炸视图：控制爆炸幅度、方向（Auto/X/Y/Z/径向）、反向、间距与逐零件自定义位移；
• 参数与动画：当模型带有 sidecar 模块时，STEP 模块参数与动画可直接在视口中调节。

网格格式：STL、3MF、GLB

这三种是典型的"看模型"格式，共同能力包括：

• 左键拖拽旋转、右键/中键平移、滚轮或双指缩放；
• 一键截图与下载；
• 主题控制（Display 页签中还有实体/线框等显示切换）。

注意：网格与 DXF 的文件面板没有专属参数控件，只展示文件状态与元数据。需要导出 STL/3MF/GLB 时，由 CAD 技能的scripts/export从同一生成器构建，保证几何一致，详见 skills/cad/references/supported-exports.md。

DXF：只读的 3D 平面展开预览

.dxf文件（无论是gen_dxf()生成的图纸还是外部导入）都以只读 3D 平面展开图方式呈现：拉伸后的图案在首次打开时烘焙进__cadgen__渲染包，与其余模型走同一条网格渲染路径。厚度与弯折状态属于生产方在烘焙时设定的参数，Viewer 中不提供实时调节。

隐式 CAD：.implicit.js / .implicit.mjs

实验性但体验独特的格式：模型由自带 GLSL 符号距离场在 GPU 上实时光线步进渲染，无需烘焙、缓存不会过期。视口中可实时调节：

• 模型参数与动画；
• 光线步进图形设置；
• 按需export --stl / --3mf / --glb输出网格文件用于交换。

机器人描述文件：URDF、SRDF、SDF

🤖 这三类格式让 CAD Viewer 成为机器人模型的"调试器"：

MoveIt2 IK 与规划控件依赖可选的 MoveIt2 服务，接入方式见 skills/cad-viewer/references/moveit2-server.md。

通用视口控件：所有格式共享

无论打开哪种文件，以下控件都可用：

• 导航：左键旋转、右键/中键平移、滚轮缩放、方向键或 WASD 转向；视球可切换顶/底/前/后/左/右视角，点击中心回到默认等轴测视图；
• 文件浏览器侧栏：搜索文件名/ID/路径、展开文件夹、面包屑菜单快速切换文件；
• 浮动工具栏：Select复制 STEP 拓扑引用、Draw打开注释工具、Select Pose拾取机器人目标位姿、Open orbit preview启动自动旋转预览、截图/下载按钮；
• 注释工具：自由手绘、直线、箭头、矩形、圆形、填充、擦除、撤销/重做、清空；
• 显示页签：7 种显示模式、裁剪（Clip）与爆炸视图（Exploded）控制；
• 主题侧栏：预设主题 + 唯一的自定义槽位，可设置表面颜色、背景、地板网格、光照与颜色模式。

如何按需求选格式：一张决策清单

• 要设计、装配、精确测量→ 用.step/.stp（功能最全，还能复制#...引用做局部修改）；
• 要3D 打印交换→.stl/.3mf/.glb网格浏览 + 导出；
• 要激光切割/2D 下料→.dxf（3D 展开预览，配合 SendCutSend 检查技能上传前校验）；
• 要程序化可再生成的数学曲面→.implicit.js/.implicit.mjs；
• 要机器人结构与规划调试→.urdf/.srdf（加 MoveIt2 可跑 IK/规划）；
• 要仿真器模型与世界→.sdf。

掌握这张 CAD Viewer 文件格式支持矩阵后，你只需一条npm run start，就能在浏览器里对 text-to-cad 生成的几乎所有工件进行可视化检查、注释与交互调试。

【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad