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 的开源 AI 智能体技能库,其中的CAD Viewer可以在本地浏览器里直接预览.step、.stl、.3mf、.glb、.dxf等工程文件,无需安装任何重型 CAD 软件。本文面向新手,带你掌握 CAD Viewer 的三大进阶技巧:爆炸视图、剖切平面与图纸标注,让模型审查效率翻倍。
一、30 秒启动 CAD Viewer:一键启动步骤
CAD Viewer 以"一个本地服务器 + 浏览器"的方式运行,默认端口是3245(0xCAD,即十六进制的 "CAD"),一个 Viewer 实例即可服务任意目录。
在 skills/cad-viewer/ 目录下执行:
npm --prefix scripts/viewer run start -- --host 127.0.0.1启动后访问形如http://127.0.0.1:3245/绝对目录路径?file=模型相对路径的地址。注意两点:
- 路径是工作区目录,不是单个文件:Viewer 会递归扫描该目录,左侧文件浏览器可自由切换模型;
- 端口被占用时,用
--port <n>指定一个空闲端口。
更多启动细节见 SKILL.md。
二、爆炸视图:一键拆解复杂装配体 💥
面对几十个零件的装配体,逐个"隐藏/显示"既慢又容易遗漏。CAD Viewer 内置了自动爆炸视图,思路与 SolidWorks、Autodesk 的主流 CAD 一致——按装配层级径向散开:
- 打开右侧文件面板,切换到Display页签,找到Exploded子区;
- 打开Exploded开关,拖动Amount滑杆,装配体像"充气"一样层层散开:子装配体先分离,再在内部继续展开;
- 按需用Direction(Auto / X / Y / Z / Radial)、Reverse、Spread、Detail、Order微调,开启explode-line显示分解引线;
- 切换Automatic / Custom可让某个零件按自定义方向单独移动;Reset一键还原。
几个值得知道的细节:
| 特性 | 说明 |
|---|---|
| 层级上限 | 最多展开 3 层,更深的零件跟随祖先刚体移动,避免"散架" |
| 同心件处理 | 轴套在壳体这类同心结构,最大件锚定为"核心",其余沿最长轴伸缩分离 |
| 防重叠 | 自动迭代推开仍相交的零件,保证任意两件之间有可视间隙 |
算法源码可参考 explodedView.js,参数命名非常直观。
三、剖切平面:透视零件内部结构 ✂️
想知道壳体壁厚、内腔结构或装配干涉在哪?不用重建模型,直接用剖切平面:
- 同样在Display页签的Clip子区(常显);
- 沿X / Y / Z位置滑杆移动切面——偏移为 0 表示不切;
- 点Flip翻转保留侧,Reset恢复原样。
剖切状态按文件独立保存(每个文件有自己的 Display 页签),在装配树上"隐藏某零件"与"一刀切开"配合使用,排查干涉问题时效率很高。实现逻辑见 clipPlane.js。
四、图纸标注:用 Draw 工具直接在模型上圈问题 📝
评审模型时最常见的诉求:"这个孔位偏了""这里要加倒角"。CAD Viewer 的Draw工具让你直接在 3D 视图上手绘批注,截图发给同事或 AI 都能直接看懂:
- 点击浮动工具栏的Draw,展开标注工具:
- 画笔(freehand):自由涂抹,快速圈出问题区域
- 直线 / 箭头:指示具体位置与方向
- 放大(expand):放大细节强调
- 矩形 / 圆形 / 填充:框选与高亮区域
- 擦除、撤销、重做、清空:完整编辑控制
- 标注完成后,工具栏的复制/下载按钮可一键截取带批注的截图。
标注工具的实现位于 drawingTools.js。
五、进阶组合技巧清单 📌
- 显示模式切换:Display 页签的 Mode 下拉提供
solid / rendered / x-ray / hidden / lines / flat / wire七种模式,x-ray(X 光)+ 剖切是排查内部干涉的黄金组合; - 复制 CAD 引用:浮动工具栏的Select可复制
#...形式的 STEP 拓扑引用(面/边/顶点/零件),粘贴回提示词即可精准修改某个零件——这是与生成类技能联动的关键入口; - 自动旋转预览:点击Open orbit preview开启自动环绕,快速给不了解结构的人"转一圈"展示;
- 标准视角切换:用视图球快速切到上/下/前/后/左/右,点中心回到默认等轴测视角。
六、参考资料与源码位置
| 资料 | 路径 |
|---|---|
| 技能说明(启动方式、URL 规则) | skills/cad-viewer/SKILL.md |
| 完整功能清单(支持的文件与控件) | skills/cad-viewer/references/viewer-features.md |
| 爆炸视图算法 | skills/cad-viewer/scripts/viewer/packages/cadjs/src/lib/viewer/explodedView.js |
| 剖切平面逻辑 | skills/cad-viewer/scripts/viewer/packages/cadjs/src/lib/viewer/clipPlane.js |
| 图纸标注工具 | skills/cad-viewer/scripts/viewer/packages/cadjs/src/lib/viewer/drawingTools.js |
💡 提示:Mesh 与 DXF 文件没有专属控制面板,右侧文件面板只显示文件状态与元数据;爆炸视图与剖切主要服务于带装配树的 STEP 文件。
掌握爆炸视图 → 剖切平面 → 图纸标注这条审查链路后,你在 CAD Viewer 中就能完成从"看结构"到"找问题"再到"提修改意见"的完整闭环。
【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考