用途:把已存在或新生成的 CAD、机器人描述与 DXF 文件在 CAD Viewer 中打开,并返回实时审阅链接。输入应为明确的一个或多个文件路径。它只是静态可视化工具,渲染已存在的产物,不运行生成脚本。
安装与启动:该技能属于 cadgen,需在 Python >= 3.11 环境安装其 requirements.txt:python -m pip install -r requirements.txt。用 cadgen doctor <此技能目录> 确认安装版本与发布版本一致。启动:cd /absolute/project/models && cadgen viewer --host 127.0.0.1 --json,命令始终输出可用 Viewer 的 URL。若同目录同 Viewer 代码已在运行则复用(action 为 reused),否则从 3245 起选空闲端口新建(action 为 started)。不要自行猜测端口,读取命令输出的 URL。每个实例只服务启动目录(cwd 即被服务目录),因此应有意识选择启动目录,通常为项目的 models/ 目录或待审文件最近的公共父目录,不要从技能目录启动。
URL 与文件选择:页面为裸源地址,file= 参数选择根目录内的文件,例如 http://127.0.0.1:3245/?file=gripper/STEP/gear_rack_gripper.step,file= 值相对被服务目录。查看器递归扫描该目录,文件浏览器列出其下所有模型,切换文件无需新链接。根目录属于服务器而非链接,同一链接在不同实例下指向不同文件。仅需目录审阅链接时返回不带 ?file= 的源地址。返回链接前先解析并确认 <directory>/<file> 存在,缺失则不上报链接并说明问题。每个请求的文件返回一个 Viewer URL;同一会话应只启动一次并固定一个工作区根目录,根目录之外的文件需要另起实例。
状态与限制:.step/.stp 在查看器中有四种状态:未编译(存储无对应树,打开时编译)、编译中 n/total、已渲染、失败(显示上次失败信息)。编译提交至 cadgen 构建池,进度与错误以数据形式返回。链接不起点击作用的问题不在查看器,端口冲突由启动器滚动到空闲端口解决;沙箱环境可能出现 EPERM/EACCES 本地绑定失败,需以相应权限重跑。cadgen viewer list 列出所有运行实例及其目录,cadgen viewer stop --port <n> 结束某个实例。用户未要求时不要停止已有服务器;启动失败则报告失败并继续使用所属技能的非 GUI 校验或产物。支持的文件类型、查看器控件及文件特定功能见 references/viewer-features.md。若需修改 CAD Viewer 源码本身,属于该仓库工作,不属于此技能。