尧图网页设计 
text-to-cad CAD Viewer使用完全指南URL构造、文件浏览器与显示设置【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cadtext-to-cad 是一个面向 AI 代理的 CAD 技能库其中的CAD Viewer技能可以在本地浏览器中预览 STEP、STL、URDF、SRDF 等各类 CAD 文件。本指南带你快速掌握 CAD Viewer 的三大核心能力URL 构造、文件浏览器和显示设置让你无需打开专业 CAD 软件就能在网页里检查、标注和导出任何模型。一、什么是 CAD Viewer本地浏览器里的 CAD 预览器CAD Viewer 是 text-to-cad 技能库中的一个独立技能位于 skills/cad-viewer/SKILL.md。它的工作方式非常简洁在本地启动一个**固定端口3245**的 Web 服务同时提供 Viewer 界面和 CAD APIURL 的路径部分直接指向一个绝对目录file参数指定目录中的某个模型文件一个 Viewer 实例可以服务任意文件夹无需针对某个目录重复启动 小知识默认端口3245其实就是十六进制0xCAD——CAD 的十六进制写法是不是很巧妙它支持的文件类型覆盖 CAD 和机器人描述的绝大部分场景完整列表见 skills/cad-viewer/references/viewer-features.md文件类型预览能力.step/.stp装配树、部件显隐、面/边/顶点选择、剖切面、参数动画.stl/.3mf/.glb网格查看、旋转/平移/缩放、截图、实体/线框显示.dxf只读 3D 展开图预览自动生成拉伸实体.implicit.js/.implicit.mjsGPU 光线步进实时渲染参数可交互调节.urdf机器人连杆/网格查看、关节滑杆、姿态复位.srdf规划组、组姿态预设、关节控制可选 MoveIt2 IK.sdf仿真模型/世界查看、元数据与警告、关节控制二、一键启动步骤3 条命令搞定环境准备启动 Viewer 只需一条命令在cad-viewer技能目录下执行npm --prefix scripts/viewer run start -- --host 127.0.0.1启动器会打印出生成的 URL形如http://127.0.0.1:3245/你的目录直接复制到浏览器打开即可。启动时的几个关键点端口固定为 3245。如果端口被占用启动器会直接报错退出不会自动换端口此时加上--port n指定一个空闲端口并使用它打印的新 URL机器可读输出加上--json参数后stdout 最后一行会输出{url: ..., port: ..., action: start}方便脚本解析启动失败不影响其他流程技能会回退到非 GUI 的校验方式启动逻辑的入口脚本是 skills/cad-viewer/scripts/viewer/start_viewer.pynpm 脚本定义见 skills/cad-viewer/scripts/viewer/package.json。三、URL构造CAD Viewer 最核心的技巧这是新手最容易踩坑的部分掌握后你会发现链接构造其实有严格的公式。URL 的标准形态http://127.0.0.1:3245/absolute/project/models?filemechanisms/lift_table.step.py可以拆解为三个部分主机 端口http://127.0.0.1:3245路径 绝对目录/absolute/project/models就像file://URL 里的目录file 参数 相对路径mechanisms/lift_table.step.py相对于上面那个目录三条黄金法则法则一路径必须用绝对目录。Viewer 运行时的工作目录是随机的通常是技能安装目录而不是你的模型目录相对路径会解析到错误位置务必使用绝对路径构造。法则二Windows 盘符放在 URL 首个斜杠之后用正斜杠。例如D:\project\models应写成http://127.0.0.1:3245/D:/project/models法则三路径是工作区而不是文件所在的文件夹。Viewer 会递归扫描该目录文件浏览器会列出下面所有模型你可以不换链接自由切换文件。推荐选择用户心目中的模型工作区——通常是项目的models/目录或待审文件的最近公共父目录。⚠️ 反例把路径指到.../models/step/mechanisms?filelift_table.step.py这种文件的深层目录虽然能打开同一个模型但会隐藏项目里的其他文件——几乎不是用户想要的结果。链接的返回规范按 SKILL.md 中的约定返回链接前必须确认目录/文件真实存在对于生成的模型传生成器源码如lift_table.step.py后端会按需构建渲染产物无需.step文件存在对于导入的STEP 则直接传.step/.stp文件。同一会话内的所有链接应共享同一个根目录保证共用一个可浏览的文件目录。四、文件浏览器不换链接切换任意模型URL 指到工作区目录后左侧的文件浏览器File Browser就是自由切换文件的入口搜索按文件名、ID 或路径搜索文件展开文件夹逐级浏览目录树面包屑菜单快速跳转到任意层级的目录侧边栏开关左侧 CAD Viewer 侧边栏可整体收起/展开保持视口干净配合路径即工作区的设计一个链接就够整个团队浏览整个项目的所有模型。五、显示设置模式、剖切面与爆炸图右侧的**文件面板File Sheet**的Display 标签页集中了所有单文件显示控制这也是查看模型细节最实用的区域。1. 显示模式Mode 下拉框提供 7 种模式一键切换solid实体默认外观rendered渲染带光影的真实感x-rayX 光透视查看内部结构hidden隐藏线去掉被遮挡的线条lines线条/flat平面/wire线框2. 剖切面Clip三个 X/Y/Z 方向的位置滑杆加Flip翻转和Reset重置按钮。偏移量为 0 即不切割——调一调滑杆就能切开模型看内部装配关系。3. 爆炸视图Exploded一个开关即可把装配体炸开Amount数量控制爆炸程度Automatic / Custom自动布局或手动微调每个部件的移动DirectionAuto / X / Y / Z / Radial 五种爆炸方向还有 Reverse、Spread、Detail、Order、爆炸线显示和 Reset 等精细控制4. 主题设置Theme导航栏的主题按钮打开主题侧边栏管理全局持久主题预设下拉框系统 内置预设、表面颜色、背景、地板/网格、光照和颜色模式。所有设置都保存在唯一的Custom槽位中——修改任何设置即写入 Custom重新选择某个预设即可重置无需手动保存。 注意区分Display 标签页管的是单个文件的视图状态模式、剖切、爆炸主题侧边栏管的是全局外观。两者互斥——文件面板和主题侧边栏同一时间只能打开一个。六、操作速查导航与浮动工具栏导航操作所有文件通用操作效果左键拖动旋转视角右键 / 中键拖动平移滚轮 / 双指捏合缩放方向键 / WASD旋转视角视图球快速切换上/下/前/后/左/右视图点击视图球中心回到默认等轴测视图浮动工具栏Select复制 STEP 拓扑引用复制出的#...参考可以粘贴到 AI 提示词中精确定位要修改的部件、Draw打开标注工具自由笔、直线、箭头、矩形、圆形、填充、擦除等、Select Pose机器人目标拾取、Open orbit preview自动旋转预览以及截图复制/下载按钮。首次使用小技巧第一次选中部件时会出现一次性提示解释复制的#...参考可以粘贴进提示词来编辑特定部件。如果提示消失了想重新看在 URL 后加?resetTips1即可恢复。七、进阶SRDF 文件搭配 MoveIt2 做逆运动学对于机器人描述文件CAD Viewer 还支持可选的 MoveIt2 集成打开.srdf文件后展开右侧MoveIt2面板即可完成目标姿态求解IK和路径规划——包括规划组选择、IK 超时/容差设置、规划管线与速度/加速度缩放等完整控制。配置流程在cad-viewer技能目录下依次执行npm --prefix scripts/viewer run moveit2:setup npm --prefix scripts/viewer run moveit2:check npm --prefix scripts/viewer run moveit2:serveMoveIt2 服务默认运行在ws://127.0.0.1:8765/ws详细参数说明见 skills/cad-viewer/references/moveit2-server.md。八、常见问题快速排查Q1端口 3245 被占用启动报错加--port n指定空闲端口使用新打印的 URL 即可。Q2链接打不开 / 文件找不到回到法则一确认 URL 路径是绝对目录且file值是相对于该目录的真实存在路径。注意 Windows 盘符要放在 URL 首个斜杠之后/D:/...。Q3为什么生成的模型链接是.step.py而不是.step这是刻意的生成器源码是目录catalog登记的格式后端会按需直接构建渲染产物且只有它携带params参数侧车文件。Q4如何一次查看整个项目的所有模型把 URL 路径指向项目的工作区根目录如models/不加file参数——递归扫描会让文件浏览器列出全部模型。总结CAD Viewer 的核心就是记住一句口诀——绝对目录进路径相对文件进 file。掌握这条 URL 构造规则再配合文件浏览器和 Display 标签页里的模式/剖切/爆炸三大显示设置你就能在浏览器里完成绝大多数 CAD 模型的检查与评审工作。更多细节可查阅 skills/cad-viewer/references/viewer-features.md 和 skills/cad-viewer/SKILL.md。【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 text-to-cad CAD Viewer使用完全指南：URL构造、文件浏览器与显示设置
text-to-cad CAD Viewer使用完全指南URL构造、文件浏览器与显示设置【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cadtext-to-cad 是一个面向 AI 代理的 CAD 技能库其中的CAD Viewer技能可以在本地浏览器中预览 STEP、STL、URDF、SRDF 等各类 CAD 文件。本指南带你快速掌握 CAD Viewer 的三大核心能力URL 构造、文件浏览器和显示设置让你无需打开专业 CAD 软件就能在网页里检查、标注和导出任何模型。一、什么是 CAD Viewer本地浏览器里的 CAD 预览器CAD Viewer 是 text-to-cad 技能库中的一个独立技能位于 skills/cad-viewer/SKILL.md。它的工作方式非常简洁在本地启动一个**固定端口3245**的 Web 服务同时提供 Viewer 界面和 CAD APIURL 的路径部分直接指向一个绝对目录file参数指定目录中的某个模型文件一个 Viewer 实例可以服务任意文件夹无需针对某个目录重复启动 小知识默认端口3245其实就是十六进制0xCAD——CAD 的十六进制写法是不是很巧妙它支持的文件类型覆盖 CAD 和机器人描述的绝大部分场景完整列表见 skills/cad-viewer/references/viewer-features.md文件类型预览能力.step/.stp装配树、部件显隐、面/边/顶点选择、剖切面、参数动画.stl/.3mf/.glb网格查看、旋转/平移/缩放、截图、实体/线框显示.dxf只读 3D 展开图预览自动生成拉伸实体.implicit.js/.implicit.mjsGPU 光线步进实时渲染参数可交互调节.urdf机器人连杆/网格查看、关节滑杆、姿态复位.srdf规划组、组姿态预设、关节控制可选 MoveIt2 IK.sdf仿真模型/世界查看、元数据与警告、关节控制二、一键启动步骤3 条命令搞定环境准备启动 Viewer 只需一条命令在cad-viewer技能目录下执行npm --prefix scripts/viewer run start -- --host 127.0.0.1启动器会打印出生成的 URL形如http://127.0.0.1:3245/你的目录直接复制到浏览器打开即可。启动时的几个关键点端口固定为 3245。如果端口被占用启动器会直接报错退出不会自动换端口此时加上--port n指定一个空闲端口并使用它打印的新 URL机器可读输出加上--json参数后stdout 最后一行会输出{url: ..., port: ..., action: start}方便脚本解析启动失败不影响其他流程技能会回退到非 GUI 的校验方式启动逻辑的入口脚本是 skills/cad-viewer/scripts/viewer/start_viewer.pynpm 脚本定义见 skills/cad-viewer/scripts/viewer/package.json。三、URL构造CAD Viewer 最核心的技巧这是新手最容易踩坑的部分掌握后你会发现链接构造其实有严格的公式。URL 的标准形态http://127.0.0.1:3245/absolute/project/models?filemechanisms/lift_table.step.py可以拆解为三个部分主机 端口http://127.0.0.1:3245路径 绝对目录/absolute/project/models就像file://URL 里的目录file 参数 相对路径mechanisms/lift_table.step.py相对于上面那个目录三条黄金法则法则一路径必须用绝对目录。Viewer 运行时的工作目录是随机的通常是技能安装目录而不是你的模型目录相对路径会解析到错误位置务必使用绝对路径构造。法则二Windows 盘符放在 URL 首个斜杠之后用正斜杠。例如D:\project\models应写成http://127.0.0.1:3245/D:/project/models法则三路径是工作区而不是文件所在的文件夹。Viewer 会递归扫描该目录文件浏览器会列出下面所有模型你可以不换链接自由切换文件。推荐选择用户心目中的模型工作区——通常是项目的models/目录或待审文件的最近公共父目录。⚠️ 反例把路径指到.../models/step/mechanisms?filelift_table.step.py这种文件的深层目录虽然能打开同一个模型但会隐藏项目里的其他文件——几乎不是用户想要的结果。链接的返回规范按 SKILL.md 中的约定返回链接前必须确认目录/文件真实存在对于生成的模型传生成器源码如lift_table.step.py后端会按需构建渲染产物无需.step文件存在对于导入的STEP 则直接传.step/.stp文件。同一会话内的所有链接应共享同一个根目录保证共用一个可浏览的文件目录。四、文件浏览器不换链接切换任意模型URL 指到工作区目录后左侧的文件浏览器File Browser就是自由切换文件的入口搜索按文件名、ID 或路径搜索文件展开文件夹逐级浏览目录树面包屑菜单快速跳转到任意层级的目录侧边栏开关左侧 CAD Viewer 侧边栏可整体收起/展开保持视口干净配合路径即工作区的设计一个链接就够整个团队浏览整个项目的所有模型。五、显示设置模式、剖切面与爆炸图右侧的**文件面板File Sheet**的Display 标签页集中了所有单文件显示控制这也是查看模型细节最实用的区域。1. 显示模式Mode 下拉框提供 7 种模式一键切换solid实体默认外观rendered渲染带光影的真实感x-rayX 光透视查看内部结构hidden隐藏线去掉被遮挡的线条lines线条/flat平面/wire线框2. 剖切面Clip三个 X/Y/Z 方向的位置滑杆加Flip翻转和Reset重置按钮。偏移量为 0 即不切割——调一调滑杆就能切开模型看内部装配关系。3. 爆炸视图Exploded一个开关即可把装配体炸开Amount数量控制爆炸程度Automatic / Custom自动布局或手动微调每个部件的移动DirectionAuto / X / Y / Z / Radial 五种爆炸方向还有 Reverse、Spread、Detail、Order、爆炸线显示和 Reset 等精细控制4. 主题设置Theme导航栏的主题按钮打开主题侧边栏管理全局持久主题预设下拉框系统 内置预设、表面颜色、背景、地板/网格、光照和颜色模式。所有设置都保存在唯一的Custom槽位中——修改任何设置即写入 Custom重新选择某个预设即可重置无需手动保存。 注意区分Display 标签页管的是单个文件的视图状态模式、剖切、爆炸主题侧边栏管的是全局外观。两者互斥——文件面板和主题侧边栏同一时间只能打开一个。六、操作速查导航与浮动工具栏导航操作所有文件通用操作效果左键拖动旋转视角右键 / 中键拖动平移滚轮 / 双指捏合缩放方向键 / WASD旋转视角视图球快速切换上/下/前/后/左/右视图点击视图球中心回到默认等轴测视图浮动工具栏Select复制 STEP 拓扑引用复制出的#...参考可以粘贴到 AI 提示词中精确定位要修改的部件、Draw打开标注工具自由笔、直线、箭头、矩形、圆形、填充、擦除等、Select Pose机器人目标拾取、Open orbit preview自动旋转预览以及截图复制/下载按钮。首次使用小技巧第一次选中部件时会出现一次性提示解释复制的#...参考可以粘贴进提示词来编辑特定部件。如果提示消失了想重新看在 URL 后加?resetTips1即可恢复。七、进阶SRDF 文件搭配 MoveIt2 做逆运动学对于机器人描述文件CAD Viewer 还支持可选的 MoveIt2 集成打开.srdf文件后展开右侧MoveIt2面板即可完成目标姿态求解IK和路径规划——包括规划组选择、IK 超时/容差设置、规划管线与速度/加速度缩放等完整控制。配置流程在cad-viewer技能目录下依次执行npm --prefix scripts/viewer run moveit2:setup npm --prefix scripts/viewer run moveit2:check npm --prefix scripts/viewer run moveit2:serveMoveIt2 服务默认运行在ws://127.0.0.1:8765/ws详细参数说明见 skills/cad-viewer/references/moveit2-server.md。八、常见问题快速排查Q1端口 3245 被占用启动报错加--port n指定空闲端口使用新打印的 URL 即可。Q2链接打不开 / 文件找不到回到法则一确认 URL 路径是绝对目录且file值是相对于该目录的真实存在路径。注意 Windows 盘符要放在 URL 首个斜杠之后/D:/...。Q3为什么生成的模型链接是.step.py而不是.step这是刻意的生成器源码是目录catalog登记的格式后端会按需直接构建渲染产物且只有它携带params参数侧车文件。Q4如何一次查看整个项目的所有模型把 URL 路径指向项目的工作区根目录如models/不加file参数——递归扫描会让文件浏览器列出全部模型。总结CAD Viewer 的核心就是记住一句口诀——绝对目录进路径相对文件进 file。掌握这条 URL 构造规则再配合文件浏览器和 Display 标签页里的模式/剖切/爆炸三大显示设置你就能在浏览器里完成绝大多数 CAD 模型的检查与评审工作。更多细节可查阅 skills/cad-viewer/references/viewer-features.md 和 skills/cad-viewer/SKILL.md。【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考