Agent Skills
返回列表
3D 模型查看器

3D 模型查看器

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ec1a4d28/3d-viewer。

技能介绍

面向本地 3D 模型检查的问题

传统浏览器查看器通常需要手动拖入文件,只能给出静态展示结果;当模型来自 STEP、STL、GLB、SCAD 等多类格式,或需要由自然语言描述生成立体零件时,缺少一条从文件路径到可交互视口的自动化链路。3D 模型查看器把本地文件、实时渲染和远程控制放在同一层:用户通过 ?url= 打开页面即可看到模型,Agent 可继续执行加载、查询、切主题、改相机、截屏和导出等操作。

技能如何工作

核心是本地 HTTP 服务与浏览器 SSE 桥。典型流程是:确认文件存在,把模型复制到服务目录,启动后台服务,打开带 ?url= 的模型链接,再通过运行时命令控制查看器。它支持 30+ 格式,覆盖 STEP/STP、STL、OBJ、FBX、GLB/GLTF、USDZ、PLY、SCAD、HDR、EXR 等;STEP/STP 会经 OCCT WASM 转换为 GLB,SCAD 会经 openscad-wasm 编译为 mesh。控制接口包括 loadModel、getModelInfo、exportModel、setTheme、setLanguage、setEnv、setPartMaterialByPreset、queryParts、动画命令、相机命令、选择、takeScreenshot 等。对于自然语言建模,技能会先解释建模理解,再编写 OpenSCAD 代码并保存为 .scad,最后由查看器编译渲染;若需要 STL,再用 exportModel 导出。

适用边界

该技能适合本地调试、模型审阅和 AI 驱动的几何生成,不适合没有浏览器的环境。远程控制依赖本地服务进程、SSE 客户端和端口监听;loadModel、exportModel 是异步结果,SSE 通道会等待完成,超时约 30 秒。首次编译 SCAD 需要下载约 13 MB 的 WASM 包,耗时可能较长。executeCode 用于注入实验性 UI,接口可能调整;若退回纯静态文件服务,则会失去 HTTP API 远程控制能力。

使用场景

  • 收到机械零件的 STEP 文件后,复制到服务目录并用 ?url 打开,直接核对零件结构。
  • 用自然语言描述齿轮或螺栓需求,先生成 OpenSCAD 代码,再在浏览器中编译查看形状。
  • 审阅 GLB 动画模型时,通过 API 播放、暂停、seek 动画并截屏记录关键帧。
  • 把当前可见场景导出为 GLB 或 STL,并保存回 models 目录供后续加载。

适合人员

  • 负责机械零件评审、需要快速打开 STEP 或 STL 并检查几何细节的设计工程师
  • 在本地验证 AI 生成的 OpenSCAD 模型、避免手写代码的算法或产品工程师
  • 需要把浏览器查看器纳入自动化流程、用 MCP 或 HTTP 控制主题的 AI 应用开发者
  • 要查看 GLB 动画、并导出 STL 或 GLB 供打印或下游使用的制造测试人员