SuperAPI AI 工具集

render

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:将已生成或修改的 CAD 与机器人描述文件在 CAD Explorer 中打开,返回审阅链接,并为指定文件创建保存的快照。输入为一个或多个已存在的显式文件路径。支持 .step、.stp、.glb、.stl、.3mf、.dxf、.urdf、.srdf、.sdf。

主要能力:启动或复用 CAD Explorer 查看器;返回每个请求文件的 Explorer URL;通过快照 CLI 生成无头快照,用于生成审阅或视觉反馈;支持 view、orbit、section、list 渲染模式;支持自定义主题、选区、剖切、轨道设置、机器人关节值、STEP 模块参数、DXF 厚度/折弯选项及多输出快照;仅对 CAD STEP 模块参数动画审阅生成 GIF,其余使用静态快照。

使用方式:从技能目录运行 npm --prefix scripts/viewer run dev:ensure -- --file path/to/model.step 启动或复用查看器,使用其打印的 URL,不要假定固定端口。端口复用为强制要求:若 dev:ensure 报告 EPERM 或 EACCES 等本地绑定/探测拒绝,应以所需权限重跑同一命令,而非自行换端口。不要使用 npm run dev -- --port ...、原始 vite dev 或 vite preview 进行常规交接。快照使用 python3 scripts/snapshot --job path/to/render-job.json 或 --job -,也可用快捷参数 --input、--output、--mode、--theme、--camera、--view-labels;STEP 模块 sidecar 参数用 --params 提供。已知工作区根目录时显式传入 --workspace-root。

适用场景:CAD/URDF/SRDF/SDF 生成后的审阅与视觉反馈、机器人描述文件检查、需要交互式 IK 或路径规划控制时的 SRDF 审阅(需启动 MoveIt2 服务器,默认 ws://127.0.0.1:8765/ws)。

限制:快照 CLI 默认 --theme technical,面向视觉诊断而非演示;--params 针对 Explorer .step.js STEP 模块 sidecar 参数,不是 Python/build123d 重新生成参数;启动失败时应报告失败并让所属技能继续非 GUI 验证;除非用户要求,不要停止已有 Explorer 服务器。远程暴露需设置 EXPLORER_ALLOWED_HOSTS 并本地验证 Host 头返回 200 OK。其余细节暂未提供。